docs(agents): add AGENTS.md documentation for prometheus, hephaestus, sisyphus variants, and builtin-skills

- src/agents/prometheus/: Strategic planner documentation
- src/agents/hephaestus/: GPT-5.4 autonomous worker documentation
- src/agents/sisyphus/: Model-specific orchestrator variants documentation
- src/features/builtin-skills/: 8 built-in skills catalog

🤖 Generated with OhMyOpenCode assistance

src/agents/hephaestus/AGENTS.md

@@ -0,0 +1,34 @@
+# src/agents/hephaestus/ -- Autonomous Deep Worker
+
+**Generated:** 2026-04-11
+
+## OVERVIEW
+
+6 files. Hephaestus agent -- autonomous deep worker powered by GPT-5.4. Goal-oriented: give it objectives, not step-by-step instructions. "The Legitimate Craftsman."
+
+## FILES
+
+| File | Purpose |
+|------|---------|
+| `agent.ts` | `createHephaestusAgent()` factory, model-variant routing |
+| `gpt.ts` | Base GPT prompt: discipline rules, delegation, verification |
+| `gpt-5-4.ts` | GPT-5.4-native prompt with XML-tagged blocks, entropy-reduced |
+| `gpt-5-3-codex.ts` | GPT-5.3 Codex variant with task discipline sections |
+| `index.ts` | Barrel exports |
+
+## KEY BEHAVIORS
+
+- Mode: `primary` (respects UI model selection)
+- Requires OpenAI-compatible provider (no fallback chain)
+- NEVER trusts subagent self-reports -- always verifies
+- NEVER uses `background_cancel(all=true)`
+- Delegates exploration to background agents, never sequential
+- Uses `run_in_background=true` for explore/librarian
+
+## MODEL VARIANTS
+
+| Model | Prompt Source | Optimizations |
+|-------|-------------|---------------|
+| gpt-5.4 | `gpt-5-4.ts` | XML-tagged blocks, 8 sections |
+| gpt-5.3-codex | `gpt-5-3-codex.ts` | Task discipline, 549 LOC prompt |
+| Other GPT | `gpt.ts` | Base prompt, 507 LOC |

src/agents/prometheus/AGENTS.md

@@ -0,0 +1,37 @@
+# src/agents/prometheus/ -- Strategic Planner
+
+**Generated:** 2026-04-11
+
+## OVERVIEW
+
+11 files. Prometheus agent -- interview-mode strategic planner. Reads codebase, questions user, builds detailed work plan before any code is written. Markdown-only output (enforced by `prometheus-md-only` hook).
+
+## FILES
+
+| File | Purpose |
+|------|---------|
+| `system-prompt.ts` | Composes full system prompt from sections |
+| `identity-constraints.ts` | FORBIDDEN actions, .md-only enforcement, path restrictions |
+| `interview-mode.ts` | Interview flow: gather requirements, clarify scope |
+| `plan-generation.ts` | Plan output structure and validation |
+| `plan-template.ts` | YAML plan template with task graph, dependencies, waves |
+| `behavioral-summary.ts` | Behavioral guidelines section |
+| `high-accuracy-mode.ts` | Enhanced accuracy mode for complex plans |
+| `gemini.ts` | Gemini-optimized prompt variant |
+| `gpt.ts` | GPT-optimized prompt variant |
+| `index.ts` | Barrel exports |
+
+## KEY CONSTRAINTS
+
+- May ONLY create/edit `.md` files (enforced by hook)
+- FORBIDDEN paths: `src/`, `package.json`, config files
+- Must explore codebase before planning (NEVER plan blind)
+- Plans saved to `.sisyphus/plans/`
+- Acceptance criteria requiring "user manually tests" are FORBIDDEN
+
+## PLAN OUTPUT FORMAT
+
+Plans use YAML with parallel task graph:
+- Waves (parallel execution groups)
+- Tasks with dependencies, category, skills
+- Each task has atomic scope + verification criteria

src/agents/sisyphus/AGENTS.md

@@ -0,0 +1,29 @@
+# src/agents/sisyphus/ -- Orchestrator Variants
+
+**Generated:** 2026-04-11
+
+## OVERVIEW
+
+4 files. Model-specific prompt variants for the Sisyphus main orchestrator. Parent `sisyphus.ts` routes to the correct variant based on active model.
+
+## FILES
+
+| File | Purpose |
+|------|---------|
+| `default.ts` | Base/Claude variant: task management, delegation guides, 542 LOC |
+| `gemini.ts` | Gemini-optimized: stricter tool-usage rules, 5 NEVER rules |
+| `gpt-5-4.ts` | GPT-5.4-native: 8-block architecture, entropy-reduced, 449 LOC |
+| `index.ts` | Barrel exports |
+
+## VARIANT SELECTION
+
+Parent `sisyphus.ts` selects variant by model name:
+- Contains "gemini" -> `gemini.ts`
+- Contains "gpt-5.4" -> `gpt-5-4.ts`
+- Default -> `default.ts` (Claude, Kimi, GLM, etc.)
+
+## KEY EXPORTS
+
+Each variant exports:
+- `buildTaskManagementSection()` -- todo/task management prompt
+- `buildSisyphusPrompt()` or equivalent -- full prompt builder