<!-- Conductor Framework Context (auto-injected) -->
# Aperant framework — slash-skills dispatchable in sub-terminals

Dispatch via `sendToTerminal(terminalId, '/<skill> <args>\\r', ...)`.

## Skills

| Skill | When to dispatch |
|-------|------------------|
| `/apt:author-skill` | Author a new Aperant skill (test-first stub). |
| `/apt:bootstrap` | Generate / refresh PROJECT.md. |
| `/apt:close-task` | Post-merge: confirm PR merged, flip phase, GC state. |
| `/apt:create-docs` | Persona-first product docs from PROJECT.md + features. |
| `/apt:debug` | Systematic debugging with persistent state. |
| `/apt:design` | DESIGN.md + wireframe + critique. Hands off to apt:plan. |
| `/apt:diagram` | .excalidraw / MCP-canvas diagrams. |
| `/apt:discuss` | Brainstorm vision or lock ambiguous decisions. |
| `/apt:docs` | Generate / update documentation verified against code. |
| `/apt:execute` | Execute an implementation plan — build code from subtasks. |
| `/apt:improve` | Proactive refactor via DEEPENING / INTERFACE / LANGUAGE lenses. |
| `/apt:mockup` | HTML+Tailwind mockup loop with parallel variants. |
| `/apt:pause` | Human-initiated session handoff. |
| `/apt:personas` | Discover 3-5 personas grounded in code + PROJECT.md. |
| `/apt:plan` | Create an implementation plan from a task description. |
| `/apt:pr-review` | Multi-agent PR review (6 specialists, validator, fixer). |
| `/apt:prototype` | Question-driven throwaway prototyping. |
| `/apt:quick` | Fast task execution — skip planning. |
| `/apt:release-notes` | Persona-aware user-facing release notes. |
| `/apt:resume` | Restore context from paused session / crash. |
| `/apt:review` | Task-level code review (6-pass fix-all pipeline). |
| `/apt:roadmap` | Manage per-scope roadmaps (milestones, phases). |
| `/apt:roundtable` | 10-agent structured debate w/ supermajority vote. |
| `/apt:run` | Full pipeline — plan/execute/verify/review. |
| `/apt:scan` | Build/refresh the .aperant/features/ registry. |
| `/apt:setup` | Configure Aperant preferences. |
| `/apt:ship` | Open PR with QA scores + decision traceability. |
| `/apt:spar` | Adversarial sparring loop between two CLIs (max 3 rounds). |
| `/apt:stress-test` | Scenario simulation to catch plan gaps. |
| `/apt:terminal` | Spawn a sibling Aperant terminal w/ its own worktree. |
| `/apt:triage` | Move a task through the 5-state triage machine. |
| `/apt:update` | Refresh installed skills/agents/hooks across runtimes. |
| `/apt:verify` | Validate implementation against spec (QA review loop). |
| `/apt:verify-proof` | Visual proof-of-work verification (screenshots, BETA). |
| `/apt:watch-ci` | Post-ship CI watcher (poll, auto-fix red, push). |
| `/apt:zoom-out` | Orient yourself in an unfamiliar area — one-page summary. |

## Dispatch recipe

Spawn a Claude Code CLI in a fresh terminal, then send the slash:

```
spawnTerminal({ projectPath, cwd, cliCommand: 'claude --dangerously-skip-permissions', ... })
sendToTerminal(terminalId, '/apt:plan <terse task description>\r', ...)
```

Codex / Gemini / OpenCode ports exist — swap `cliCommand` accordingly.
Skill semantics are identical across CLIs.

## Observe-then-act

Read what a sub-terminal produced via `readFromTerminal(terminalId,
{tailBytes?})`. Use AFTER a write to confirm the skill took. NEVER assume
the write landed — observe.
