minor #23 docs: streamline and split into components (chr-hertel)

This PR was merged into the main branch.

Discussion
----------

docs: streamline and split into components

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | no
| Docs?         | yes
| Issues        |
| License       | MIT

Splitting large README into component specific ones.

- [x] examples
- [x] agent
- [x] ai-bundle
- [x] mcp-bundle
- [x] platform
- [x] store

Also solves #25

Commits
-------

dd38482 docs: split into components

Author: chr-hertel

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._

examples/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)