docs: streamline and split into components

examples/README.md

@@ -20,7 +20,7 @@ composer install
 #### Configuration
 
 Depending on the examples you want to run, you may need to configure the needed API keys. Therefore, you need to create a
-`.env.local` file in the root of the examples directory. This file should contain the environment variables for the
+`.env.local` file in the root of the examples' directory. This file should contain the environment variables for the
 corresponding example you want to run.
 
 _Now you can run examples standalone or via the example runner._

src/agent/README.md

@@ -0,0 +1,25 @@
+# Symfony AI - Agent Component
+
+The Agent component provides a framework for building AI agents that, sits on top of the Platform and Store components,
+allowing you to create agents that can interact with users, perform tasks, and manage workflows.
+
+**This Component is experimental**.
+[Experimental features](https://symfony.com/doc/current/contributing/code/experimental.html)
+are not covered by Symfony's
+[Backward Compatibility Promise](https://symfony.com/doc/current/contributing/code/bc.html).
+
+## Installation
+
+```bash
+composer require symfony/ai-agent
+```
+
+**This repository is a READ-ONLY sub-tree split**. See
+https://github.com/symfony/ai to create issues or submit pull requests.
+
+## Resources
+
+- [Documentation](doc/index.rst)
+- [Report issues](https://github.com/symfony/ai/issues) and
+  [send Pull Requests](https://github.com/symfony/ai/pulls)
+  in the [main Symfony AI repository](https://github.com/symfony/ai)