Homelab/pi-extensions
6
0
Fork 0
Code Issues Pull requests 4 Projects Releases Packages Wiki Activity Actions

Workflow front-end v1 — thin orchestrator, scouts, design gate #6

Merged
aaron merged 12 commits from workflow/front-end-v1 into main 2026-07-08 06:06:02 +00:00
Conversation 0 Commits 12 Files changed 18 +2396
aaron commented 2026-07-08 05:59:30 +00:00
Owner
Copy link

Implements pi-swarm-suite/docs/2026-07-07-workflow-front-end-design.md per plan docs/plans/2026-07-07-workflow-front-end.md.

What shipped

  • /workflow mode — injects the thin-orchestrator discipline (interview one question at a time, delegate ALL research to scouts, context-economy hard rules) via before_agent_start, reusing SwarmModeState.
  • Durable run state — .pi/workflow/<run-id>/run.json: gates (pending→open→complete→approved), deliverable pointers, findings ledger; atomic tmp+rename writes; run-id validation (path-traversal guard); stray-entry-tolerant listIds().
  • workflow / workflow_status tools — bookkeeping only (start, propose_gates, record_finding, complete_gate, approve_gate); errors as isError results; run_id defaults to latest.
  • Charters — scout-codebase, scout-web, design-writer with bounded result_schema contracts (summary maxLength 1200/1500, findings_path/deliverable_path required) enforcing the context-economy invariant mechanically.
  • Integration smoke test + README section.

Verification

  • 348/348 tests (316 baseline + 32 new), tsc --noEmit clean.
  • Subagent-driven build: fresh implementer + independent reviewer per task; final whole-branch review (opus): Ready to merge — 0 Critical, 0 Important; its 3 pre-smoke polish recommendations applied (prompt param/ordering clarity, unique gate ids).

Known limitations (documented in README)

  • /swarm and /workflow modes must not be ON simultaneously (both replace the system prompt; last handler wins).
  • Charters are repo templates — install via cp agents/scout-*.md agents/design-writer.md ~/.pi/agent/agents/ (or per-repo .pi/agents/).
  • Scout read-only-ness is prompt-enforced (they hold bash+write for findings files) — revisit at AD-6.

Next (design doc §7)

Live smoke on ApexDirector (the empirical crux), then AD-6 circuit breaker before any autonomous gates.

🤖 Generated with Claude Code

https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7

Implements `pi-swarm-suite/docs/2026-07-07-workflow-front-end-design.md` per plan `docs/plans/2026-07-07-workflow-front-end.md`. ## What shipped - **`/workflow` mode** — injects the thin-orchestrator discipline (interview one question at a time, delegate ALL research to scouts, context-economy hard rules) via `before_agent_start`, reusing `SwarmModeState`. - **Durable run state** — `.pi/workflow/<run-id>/run.json`: gates (pending→open→complete→approved), deliverable pointers, findings ledger; atomic tmp+rename writes; run-id validation (path-traversal guard); stray-entry-tolerant `listIds()`. - **`workflow` / `workflow_status` tools** — bookkeeping only (start, propose_gates, record_finding, complete_gate, approve_gate); errors as isError results; run_id defaults to latest. - **Charters** — `scout-codebase`, `scout-web`, `design-writer` with bounded `result_schema` contracts (summary maxLength 1200/1500, findings_path/deliverable_path required) enforcing the context-economy invariant mechanically. - Integration smoke test + README section. ## Verification - 348/348 tests (316 baseline + 32 new), `tsc --noEmit` clean. - Subagent-driven build: fresh implementer + independent reviewer per task; final whole-branch review (opus): **Ready to merge — 0 Critical, 0 Important**; its 3 pre-smoke polish recommendations applied (prompt param/ordering clarity, unique gate ids). ## Known limitations (documented in README) - `/swarm` and `/workflow` modes must not be ON simultaneously (both replace the system prompt; last handler wins). - Charters are repo templates — install via `cp agents/scout-*.md agents/design-writer.md ~/.pi/agent/agents/` (or per-repo `.pi/agents/`). - Scout read-only-ness is prompt-enforced (they hold bash+write for findings files) — revisit at AD-6. ## Next (design doc §7) Live smoke on ApexDirector (the empirical crux), then AD-6 circuit breaker before any autonomous gates. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Approved design for the swarm-workflow first slice: conversational
orchestrator discipline (/workflow mode), bounded-contract research
scouts, design-writer specialist, durable run state. Includes the
path-to-full-vision roadmap (§7) so remaining work isn't lost.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015SGbF5oMAc2nVR4W7XD6E7
aaron merged commit 6432063fe7 into main 2026-07-08 06:06:02 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Homelab/pi-extensions!6
No description provided.