docs: update AGENTS guidance
This commit is contained in:
+15
-15
@@ -1,10 +1,10 @@
|
||||
# src/ — Plugin Source
|
||||
|
||||
**Generated:** 2026-05-15
|
||||
**Generated:** 2026-05-18
|
||||
|
||||
## OVERVIEW
|
||||
|
||||
Entry `index.ts` orchestrates a 7-step initialization. Total: 1340 source files + 701 tests across the directories below. Cross-cutting helpers live in `shared/`; module boundaries are established by 122 barrel `index.ts` files.
|
||||
Entry `index.ts` orchestrates a 7-step initialization. Total: 1351 source files + 722 tests across the directories below. Cross-cutting helpers live in `shared/`; module boundaries are established by 122 barrel `index.ts` files.
|
||||
|
||||
## KEY FILES
|
||||
|
||||
@@ -88,19 +88,19 @@ Total: 54 base, 61 with team-mode. Each tier produces an object whose values are
|
||||
|
||||
| Subdir | Files (.ts) | LOC | Purpose | Has AGENTS.md |
|
||||
|--------|-------------|-----|---------|---------------|
|
||||
| `agents/` | 102 | 19,660 | 11 agent factories + dynamic prompt builder | yes |
|
||||
| `hooks/` | 581 | 78,030 | ~52 lifecycle hooks across 58 dirs | yes |
|
||||
| `tools/` | 314 | 44,768 | 16 tool dirs producing 20–39 tools | yes |
|
||||
| `features/` | 400 | 70,934 | 20 feature modules (team-mode, background-agent, boulder-state, etc.) | yes |
|
||||
| `shared/` | 278 | 32,847 | Cross-cutting utilities, barrel-exported | yes |
|
||||
| `cli/` | 158 | 17,812 | Commander.js CLI: install, run, doctor, mcp-oauth, boulder | yes |
|
||||
| `plugin/` | 56 | 12,390 | 10 OpenCode hook handlers + hook composition | yes |
|
||||
| `config/` | 41 | 2,340 | 30 Zod v4 schema files | yes |
|
||||
| `plugin-handlers/` | 27 | 5,841 | 6-phase config loading pipeline | yes |
|
||||
| `openclaw/` | 26 | 3,293 | Bidirectional Discord/Telegram/HTTP integration | yes |
|
||||
| `__tests__/` | 22 | 275 | Plugin-level integration tests + perf fixtures | — |
|
||||
| `mcp/` | 7 | 205 | 3 built-in remote MCPs | yes |
|
||||
| `testing/` | 2 | 225 | Test utilities | — |
|
||||
| `agents/` | 104 | ~20k | 11 agent factories + dynamic prompt builder | yes (+ atlas, hephaestus, prometheus, sisyphus, sisyphus-junior, builtin-agents) |
|
||||
| `hooks/` | 596 | ~78k | ~52 lifecycle hooks across 58 dirs | yes (+ atlas, anthropic-context-window-limit-recovery, auto-update-checker, claude-code-hooks, comment-checker, compaction-context-injector, keyword-detector, ralph-loop, rules-injector, runtime-fallback, session-recovery, todo-continuation-enforcer) |
|
||||
| `tools/` | 317 | ~45k | 16 tool dirs producing 20–39 tools | yes (+ ast-grep, background-task, call-omo-agent, delegate-task, hashline-edit, look-at, lsp, skill) |
|
||||
| `features/` | 404 | ~71k | 20 feature modules (team-mode, background-agent, boulder-state, etc.) | yes (+ 11 sub-AGENTS.md including builtin-skills, team-mode, background-agent, claude-code-*) |
|
||||
| `shared/` | 290 | ~33k | Cross-cutting utilities, barrel-exported | yes |
|
||||
| `cli/` | 158 | ~18k | Commander.js CLI: install, run, doctor, mcp-oauth, boulder | yes (+ config-manager, doctor, run) |
|
||||
| `plugin/` | 58 | ~12k | 10 OpenCode hook handlers + hook composition | yes |
|
||||
| `config/` | 41 | ~2k | 30 Zod v4 schema files | yes |
|
||||
| `plugin-handlers/` | 27 | ~6k | 6-phase config loading pipeline | yes |
|
||||
| `openclaw/` | 26 | ~3k | Bidirectional Discord/Telegram/HTTP integration | yes |
|
||||
| `__tests__/` | 22 | ~300 | Plugin-level integration tests + perf fixtures | — |
|
||||
| `mcp/` | 7 | ~200 | 3 built-in remote MCPs | yes |
|
||||
| `testing/` | 3 | ~225 | Test utilities | — |
|
||||
|
||||
## NOTES
|
||||
|
||||
|
||||
Reference in New Issue
Block a user