chore: Optimize token context consumption

AGENTS.md

@@ -0,0 +1,37 @@
+# Go! AOP Framework
+goaop/framework | NS: Go\ | PHP: ^8.4.0
+AOP via source transformation at load time (stream filter, no PECL, no eval).
+
+## Agent gate
+- PHP 8.4+ required. If PHP 8.3 or less → STOP, report can't run tests/phpstan.
+- Gate: `./vendor/bin/phpstan analyze --memory-limit=512M` before commit (level 10).
+
+## Commands
+| Action    | Command                                                               |
+|-----------|-----------------------------------------------------------------------|
+| install   | `composer install`                                                    |
+| test:all  | `./vendor/bin/phpunit`                                                |
+| test:file | `./vendor/bin/phpunit tests/Core/ContainerTest.php`                   |
+| test:one  | `./vendor/bin/phpunit --filter testName tests/Core/ContainerTest.php` |
+| analyze   | `./vendor/bin/phpstan analyze --memory-limit=512M`                    |
+
+## Architecture overview
+Intercepts PHP class loading pipeline: source stream filter transforms source → injects interception hooks → caches result.
+- Init: AspectKernel::init() → stream filter → transformers → configureAop()
+- Main transformer: WeavingTransformer (class→trait, proxy class re-inherits parent+interfaces)
+- Proxy dispatch: per-method static $__joinPoint → InterceptorInjector → advisor chain
+
+## Directory → AGENTS.md map
+| Directory         | Sub-AGENTS.md              | Covers                                                        |
+|-------------------|----------------------------|---------------------------------------------------------------|
+| `src/Instrument/` | `src/Instrument/AGENTS.md` | Init flow, transformers, trait engine, line numbers, Override |
+| `src/Proxy/`      | `src/Proxy/AGENTS.md`      | Proxy generators, code-gen, readonly, hooks, enums            |
+| `src/Aop/`        | `src/Aop/AGENTS.md`        | Interfaces, generics, implementations, pointcuts, attributes  |
+| `src/Core/`       | `src/Core/AGENTS.md`       | Container, aspect loading, advice matching, bridge            |
+| `tests/`          | `tests/AGENTS.md`          | Test conventions, fixtures, PHPUnit, PHPStan                  |
+
+## Rules
+- Skip explanations unless asked. Show changes, not commentary.
+- Use targeted edits (Edit tool) over full-file rewrites.
+- No filler words ("let me", "carefully", "I'll now").
+- Before commit: phpunit and phpstan must pass. Fix errors before offering to commit.