@cluesmith/codev 3.0.0-rc.9 → 3.0.1

package/skeleton/resources/commands/consult.md

@@ -1,6 +1,6 @@
 # consult - AI Consultation CLI
 
-The `consult` command provides a unified interface for AI consultation with external models (Gemini, Codex, Claude). It operates in three modes: general (ad-hoc prompts), protocol-based (structured reviews), and stats.
+The `consult` command provides a unified interface for AI consultation with external models (Gemini, Codex, Claude, Hermes). It operates in three modes: general (ad-hoc prompts), protocol-based (structured reviews), and stats.
 
 ## Synopsis
 
@@ -22,6 +22,7 @@ consult stats [options]
 | `gemini` | `pro` | gemini-cli | File access via --yolo, fast |
 | `codex` | `gpt` | @openai/codex | Read-only sandbox, thorough |
 | `claude` | `opus` | Claude Agent SDK | Balanced analysis with tool use |
+| `hermes` | - | hermes CLI (`hermes chat -q`) | Uses Hermes agent as consult backend |
 
 ## Modes
 
@@ -45,7 +46,7 @@ Cannot combine `--prompt` with `--prompt-file` or `--type`.
 
 ### Protocol Mode
 
-Run structured reviews tied to a development protocol (SPIR, TICK, bugfix, maintain).
+Run structured reviews tied to a development protocol (SPIR, ASPIR, AIR, bugfix, maintain).
 
 ```bash
 # Review a spec (auto-detects project context in builder worktrees)
@@ -68,7 +69,7 @@ consult -m gemini --type integration
 ```
 
 **Options:**
-- `--protocol <name>` — Protocol: spir, bugfix, tick, maintain
+- `--protocol <name>` — Protocol: spir, aspir, air, bugfix, maintain
 - `-t, --type <type>` — Review type: spec, plan, impl, pr, phase, integration
 - `--issue <number>` — Issue number (required from architect context)
 
@@ -108,16 +109,21 @@ These flags are used by porch (the protocol orchestrator) when generating consul
 --project-id <id>       Project ID for metrics
 ```
 
-## Parallel Consultation (3-Way Reviews)
+## Parallel Consultation (Multi-Model Reviews)
+
+Default project configuration uses a 3-model set (`gemini`, `codex`, `claude`).
 
 For thorough reviews, run multiple models in parallel:
 
 ```bash
-# 3-way spec review
+# Default 3-way spec review
 consult -m gemini --protocol spir --type spec &
 consult -m codex --protocol spir --type spec &
 consult -m claude --protocol spir --type spec &
 wait
+
+# Optional: include Hermes as a 4th reviewer
+consult -m hermes --protocol spir --type spec
 ```
 
 ## Performance
@@ -183,12 +189,15 @@ consult -m codex --protocol spir --type pr --issue 42
 # Protocol: implementation review with bugfix protocol
 consult -m claude --protocol bugfix --type impl
 
-# 3-way parallel review
+# Default 3-way parallel review
 consult -m gemini --protocol spir --type spec &
 consult -m codex --protocol spir --type spec &
 consult -m claude --protocol spir --type spec &
 wait
 
+# Optional: include Hermes as an additional reviewer
+consult -m hermes --protocol spir --type spec
+
 # Stats
 consult stats --days 7 --json
 ```

package/skeleton/resources/commands/overview.md

@@ -91,6 +91,5 @@ Agent Farm is configured via `.codev/config.json` at the project root. Created d
 ## Related Documentation
 
 - [SPIR Protocol](../protocols/spir/protocol.md) - Multi-phase development workflow
-- [TICK Protocol](../protocols/tick/protocol.md) - Fast amendment workflow
 - [Architect Role](../roles/architect.md) - Architect responsibilities
 - [Builder Role](../roles/builder.md) - Builder responsibilities

package/skeleton/roles/architect.md

@@ -29,7 +29,7 @@ Builders work autonomously in isolated git worktrees. The Architect:
 
 1. **`git status`** — Ensure worktree is clean (no uncommitted changes)
 2. **Commit if needed** — Builders branch from HEAD; uncommitted specs/plans are invisible
-3. **`afx spawn N --protocol <name>`** — `--protocol` is **REQUIRED** (spir, bugfix, tick, etc.)
+3. **`afx spawn N --protocol <name>`** — `--protocol` is **REQUIRED** (spir, aspir, air, bugfix, etc.)
 
 The spawn command will refuse if the worktree is dirty (override with `--force`, but your builder won't see uncommitted files).
 

package/skeleton/roles/builder.md

@@ -85,12 +85,13 @@ cat codev/protocols/spir/protocol.md
 # Start implementing
 ```
 
-### The SPIR Protocol (Specify → Plan → Implement → Review)
+### The SPIR Protocol (Specify → Plan → Implement → Review (→ Verify))
 
 1. **Specify**: Read or create the spec at `codev/specs/XXXX-name.md`
 2. **Plan**: Read or create the plan at `codev/plans/XXXX-name.md`
 3. **Implement**: Write code following the plan phases
 4. **Review**: Write lessons learned and create PR
+5. **Verify** (optional): After PR merge, verify the feature works in the integrated codebase
 
 ### Consultations
 
@@ -147,9 +148,9 @@ afx status         # All builders
 |------|-------------|
 | **Gate reached** | `afx send architect "Project XXXX: <gate-name> ready for approval"` |
 | **PR ready** | `afx send architect "PR #N ready for review"` |
-| **PR merged** | `afx send architect "Project XXXX complete. PR merged. Ready for cleanup."` |
+| **PR merged** | `afx send architect "Project XXXX complete. PR merged. Entering verify phase."` |
 | **Blocked/stuck** | `afx send architect "Blocked on X — need guidance"` |
-| **Escalation needed** | `afx send architect "Issue too complex — recommend escalating to SPIR/TICK"` |
+| **Escalation needed** | `afx send architect "Issue too complex — recommend escalating to SPIR"` |
 
 The architect may be working on other tasks and won't know you need attention unless you send a message. **Don't assume they're watching** — always notify explicitly.
 
@@ -171,6 +172,13 @@ Can't find the auth helper mentioned in spec. Options:
 Waiting for Architect guidance.
 ```
 
+## Multi-PR Workflow
+
+Builders may submit multiple sequential PRs within a single worktree session. The worktree persists across PRs -- it is not cleaned up automatically after merge. This allows builders to do follow-up work (e.g., addressing review feedback in a second PR, or splitting large features across checkpoint PRs).
+
+- **Worktree cleanup is architect-driven** -- the architect decides when to run `afx cleanup`, not the builder
+- If a builder session is interrupted, use `afx spawn XXXX --resume` to reconnect to the existing worktree
+
 ## Constraints
 
 - **Stay in scope** - Only implement what's in the spec

package/skeleton/templates/AGENTS.md

@@ -10,9 +10,11 @@ This project uses **Codev** for AI-assisted development.
 
 - **SPIR**: Multi-phase development with consultation (`codev/protocols/spir/protocol.md`)
 - **ASPIR**: Autonomous SPIR — no human gates on spec/plan (`codev/protocols/aspir/protocol.md`)
-- **TICK**: Fast autonomous implementation (`codev/protocols/tick/protocol.md`)
+- **AIR**: Autonomous Implement & Review for small features (`codev/protocols/air/protocol.md`)
+- **BUGFIX**: Bug fixes from GitHub issues (`codev/protocols/bugfix/protocol.md`)
 - **EXPERIMENT**: Disciplined experimentation (`codev/protocols/experiment/protocol.md`)
 - **MAINTAIN**: Codebase maintenance (`codev/protocols/maintain/protocol.md`)
+- **RESEARCH**: Multi-agent research with 3-way investigation, synthesis, and critique (`codev/protocols/research/protocol.md`)
 
 ## Key Locations
 

package/skeleton/templates/CLAUDE.md

@@ -8,9 +8,11 @@ This project uses **Codev** for AI-assisted development.
 
 - **SPIR**: Multi-phase development with consultation (`codev/protocols/spir/protocol.md`)
 - **ASPIR**: Autonomous SPIR — no human gates on spec/plan (`codev/protocols/aspir/protocol.md`)
-- **TICK**: Fast autonomous implementation (`codev/protocols/tick/protocol.md`)
+- **AIR**: Autonomous Implement & Review for small features (`codev/protocols/air/protocol.md`)
+- **BUGFIX**: Bug fixes from GitHub issues (`codev/protocols/bugfix/protocol.md`)
 - **EXPERIMENT**: Disciplined experimentation (`codev/protocols/experiment/protocol.md`)
 - **MAINTAIN**: Codebase maintenance (`codev/protocols/maintain/protocol.md`)
+- **RESEARCH**: Multi-agent research with 3-way investigation, synthesis, and critique (`codev/protocols/research/protocol.md`)
 
 ## Key Locations
 

package/skeleton/templates/cheatsheet.md

@@ -41,7 +41,7 @@ Just like structuring a human team—clear roles, defined processes, explicit ha
 
 | Component | Purpose |
 |-----------|---------|
-| Protocols | Define HOW work happens (SPIR, TICK, etc.) |
+| Protocols | Define HOW work happens (SPIR, ASPIR, etc.) |
 | Roles | Define WHO does what (Architect, Builder, Consultant) |
 | Parallelism | Scale by running multiple builders simultaneously |
 
@@ -61,9 +61,9 @@ A **protocol** is a structured workflow that defines how work progresses from id
 | Protocol | Use For | Phases |
 |----------|---------|--------|
 | **SPIR** | New features | Specify → Plan → Implement → Review |
-| **TICK** | Amendments to existing specs | Task Identification → Coding → Kickout |
 | **MAINTAIN** | Codebase hygiene | Dead code removal, documentation sync |
 | **EXPERIMENT** | Research & prototyping | Hypothesis → Experiment → Conclude |
+| **RESEARCH** | Multi-agent research | Scope → Investigate (3-way) → Synthesize → Critique (3-way) |
 
 ### Roles