Forge Refresh Docs

Count everything: agents, skills, hooks, MCP tools, lib modules. You'll state these counts in the docs.

Step 3 — Regenerate FORGE-REFERENCE.md

Follow the recipe's Part 2 exactly:

1. Read the current docs/FORGE-REFERENCE.md (required before overwriting)
2. Write a complete new docs/FORGE-REFERENCE.md with all 15 sections per the recipe
3. Verify: no stale references to Electron, Svelte, IPC, src/main/, src/renderer/, .claude/agents/

The 15 sections in order:

1. Pipeline Architecture & Modes
2. The Gate System
3. Wave Execution
4. Every Agent — Roles and Models
5. The Signal Protocol
6. How a Pipeline Run Executes (step-by-step walkthroughs, data flow diagram, self-improvement loop)
7. Hook Technical Protocol (stdin/stdout format, exit codes, worked examples)
8. Skills (User Commands)
9. Hook Inventory
10. MCP Server & Tools (with registration pattern, transport)
11. Model Routing (4-priority fallback chain, budget modes)
12. Project Configuration
13. Module Map
14. Key Files Reference
15. Documentation Structure

Step 4 — Update FORGE-OVERVIEW.md

Follow the recipe's Part 1. Only update data-driven sections:

1. "What's planned next" — regenerate from board.json open items, grouped by theme
2. Comparison tables — update if new capabilities shipped or new research exists
3. "What Is FORGE?" — update counts (agents, skills, hooks, MCP tools) if they changed
4. "Why Use FORGE" — update if onboarding experience changed

Do NOT:

• Add a new Era (that requires human editorial judgment — tell the user if one seems warranted)
• Touch the Glass Wall section
• Touch existing Era narratives
• Add reference data that belongs in FORGE-REFERENCE.md

If a new Era seems warranted based on CHANGELOG entries since the last Era, tell the user: "A new Era may be warranted — [reason]. Want me to draft it?"

Step 5 — Verify

1. Check line counts: FORGE-REFERENCE.md should be 700+ lines, FORGE-OVERVIEW.md should be 600+ lines
2. Grep both files for stale references: Electron|Svelte|IPC|ipcMain|ipcRenderer|contextBridge|src/main/|src/renderer/|src/preload/ — only allowed in historical Era narratives in the overview
3. Report: what changed, counts verified, any issues found

Output

After completion, report:

• Files updated (with line counts)
• Counts: agents, skills, hooks, MCP tools, lib modules
• Whether a new Era seems warranted
• Any stale references or issues found