@chankov/agent-fleet 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/build.md +44 -0
- package/.claude/commands/code-simplify.md +22 -0
- package/.claude/commands/design-agent.md +14 -0
- package/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.claude/commands/orchestrate.md +112 -0
- package/.claude/commands/plan.md +16 -0
- package/.claude/commands/prime.md +22 -0
- package/.claude/commands/review.md +16 -0
- package/.claude/commands/setup-agent-fleet.md +25 -0
- package/.claude/commands/ship.md +72 -0
- package/.claude/commands/spec.md +15 -0
- package/.claude/commands/test.md +19 -0
- package/.claude/commands/webperf.md +32 -0
- package/.claude/orchestrate-teams.yaml +24 -0
- package/.opencode/commands/af-build.md +17 -0
- package/.opencode/commands/af-code-simplify.md +16 -0
- package/.opencode/commands/af-compound.md +16 -0
- package/.opencode/commands/af-design-agent.md +15 -0
- package/.opencode/commands/af-doctor-agent-fleet.md +15 -0
- package/.opencode/commands/af-orchestrate.md +112 -0
- package/.opencode/commands/af-plan.md +16 -0
- package/.opencode/commands/af-prime.md +22 -0
- package/.opencode/commands/af-review.md +15 -0
- package/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.opencode/commands/af-ship.md +16 -0
- package/.opencode/commands/af-spec.md +16 -0
- package/.opencode/commands/af-test.md +21 -0
- package/.opencode/commands/af-webperf.md +32 -0
- package/.opencode/orchestrate-teams.yaml +24 -0
- package/.pi/agents/dispatch-policy.yaml +32 -0
- package/.pi/agents/model-profiles.yaml +20 -0
- package/.pi/agents/peers.yaml +142 -0
- package/.pi/agents/teams.yaml +39 -0
- package/.pi/damage-control-rules.yaml +297 -0
- package/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.pi/extensions/btw/README.md +118 -0
- package/.pi/extensions/btw/index.ts +917 -0
- package/.pi/extensions/btw/package.json +6 -0
- package/.pi/extensions/btw/state.js +179 -0
- package/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.pi/extensions/package-lock.json +1143 -0
- package/.pi/extensions/package.json +9 -0
- package/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.pi/harnesses/agent-hub/README.md +562 -0
- package/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.pi/harnesses/agent-hub/delegate.ts +363 -0
- package/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.pi/harnesses/agent-hub/helpers.ts +165 -0
- package/.pi/harnesses/agent-hub/index.ts +7098 -0
- package/.pi/harnesses/agent-hub/package.json +6 -0
- package/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.pi/harnesses/agent-hub/spawn.ts +179 -0
- package/.pi/harnesses/ask-user-remote/README.md +10 -0
- package/.pi/harnesses/ask-user-remote/index.ts +253 -0
- package/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.pi/harnesses/coms/README.md +71 -0
- package/.pi/harnesses/coms/index.ts +1743 -0
- package/.pi/harnesses/coms/package.json +6 -0
- package/.pi/harnesses/damage-control/README.md +65 -0
- package/.pi/harnesses/damage-control/index.ts +250 -0
- package/.pi/harnesses/damage-control/package.json +6 -0
- package/.pi/harnesses/damage-control/shared.ts +183 -0
- package/.pi/harnesses/damage-control-continue/README.md +116 -0
- package/.pi/harnesses/damage-control-continue/index.ts +522 -0
- package/.pi/harnesses/damage-control-continue/package.json +6 -0
- package/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.pi/harnesses/package-lock.json +35 -0
- package/.pi/harnesses/package.json +9 -0
- package/.pi/prompts/build.md +24 -0
- package/.pi/prompts/code-simplify.md +22 -0
- package/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.pi/prompts/plan.md +16 -0
- package/.pi/prompts/review.md +16 -0
- package/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.pi/prompts/ship.md +17 -0
- package/.pi/prompts/spec.md +15 -0
- package/.pi/prompts/test.md +19 -0
- package/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.1/.claude/commands/build.md +44 -0
- package/.versions/0.0.1/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.1/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.1/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.1/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.1/.claude/commands/plan.md +16 -0
- package/.versions/0.0.1/.claude/commands/prime.md +22 -0
- package/.versions/0.0.1/.claude/commands/review.md +16 -0
- package/.versions/0.0.1/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.1/.claude/commands/ship.md +72 -0
- package/.versions/0.0.1/.claude/commands/spec.md +15 -0
- package/.versions/0.0.1/.claude/commands/test.md +19 -0
- package/.versions/0.0.1/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.1/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.1/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.1/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.1/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.1/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.1/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.1/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.1/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.1/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.1/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.1/.pi/extensions/package.json +9 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/README.md +562 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/delegate.ts +363 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/helpers.ts +165 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/index.ts +7098 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/spawn.ts +179 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/README.md +10 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/index.ts +253 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.1/.pi/harnesses/coms/README.md +71 -0
- package/.versions/0.0.1/.pi/harnesses/coms/index.ts +1743 -0
- package/.versions/0.0.1/.pi/harnesses/coms/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/README.md +65 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/index.ts +250 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/shared.ts +183 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/README.md +116 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/index.ts +522 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.1/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.1/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.1/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.1/.pi/prompts/build.md +24 -0
- package/.versions/0.0.1/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.1/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.1/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.1/.pi/prompts/review.md +16 -0
- package/.versions/0.0.1/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.1/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.1/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.1/.pi/prompts/test.md +19 -0
- package/.versions/0.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.1/.version +1 -0
- package/.versions/0.0.1/agents/architect.md +21 -0
- package/.versions/0.0.1/agents/bowser.md +25 -0
- package/.versions/0.0.1/agents/builder.md +52 -0
- package/.versions/0.0.1/agents/code-reviewer.md +205 -0
- package/.versions/0.0.1/agents/deep-researcher.md +31 -0
- package/.versions/0.0.1/agents/documenter.md +16 -0
- package/.versions/0.0.1/agents/orchestrator.md +43 -0
- package/.versions/0.0.1/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.1/agents/planner.md +69 -0
- package/.versions/0.0.1/agents/releaser.md +22 -0
- package/.versions/0.0.1/agents/researcher.md +28 -0
- package/.versions/0.0.1/agents/security-auditor.md +166 -0
- package/.versions/0.0.1/agents/test-engineer.md +144 -0
- package/.versions/0.0.1/agents/web-debugger.md +42 -0
- package/.versions/0.0.1/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.1/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.1/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.1/hooks/hooks.json +14 -0
- package/.versions/0.0.1/hooks/session-start.sh +74 -0
- package/.versions/0.0.1/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.1/justfile +143 -0
- package/.versions/0.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.1/references/definition-of-done.md +67 -0
- package/.versions/0.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.1/references/observability-checklist.md +91 -0
- package/.versions/0.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.1/references/performance-checklist.md +153 -0
- package/.versions/0.0.1/references/prompting-patterns.md +380 -0
- package/.versions/0.0.1/references/security-checklist.md +179 -0
- package/.versions/0.0.1/references/testing-patterns.md +236 -0
- package/.versions/0.0.1/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.1/scripts/coms-cli.ts +372 -0
- package/.versions/0.0.1/scripts/coms-hermes-bridge.ts +399 -0
- package/.versions/0.0.1/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.1/scripts/lib/coms-envelope.ts +494 -0
- package/.versions/0.0.1/scripts/lib/herdr-layout.ts +235 -0
- package/.versions/0.0.1/scripts/lib/hermes-bridge-core.ts +238 -0
- package/.versions/0.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.1/scripts/lib/team-project.ts +75 -0
- package/.versions/0.0.1/scripts/lib/team-snapshot.ts +146 -0
- package/.versions/0.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.1/scripts/team-snapshot.ts +221 -0
- package/.versions/0.0.1/scripts/team-up.ts +245 -0
- package/.versions/0.0.1/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.1/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.1/skills/designing-agents/pi-harness-authoring.md +209 -0
- package/.versions/0.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +506 -0
- package/.versions/0.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.1/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.1/skills/peer-coms/SKILL.md +81 -0
- package/.versions/0.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.1/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.1/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.1/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +65 -0
- package/LICENSE +21 -0
- package/README.md +458 -0
- package/agents/architect.md +21 -0
- package/agents/bowser.md +25 -0
- package/agents/builder.md +52 -0
- package/agents/code-reviewer.md +205 -0
- package/agents/deep-researcher.md +31 -0
- package/agents/documenter.md +16 -0
- package/agents/orchestrator.md +43 -0
- package/agents/plan-reviewer.md +60 -0
- package/agents/planner.md +69 -0
- package/agents/releaser.md +22 -0
- package/agents/researcher.md +28 -0
- package/agents/security-auditor.md +166 -0
- package/agents/test-engineer.md +144 -0
- package/agents/web-debugger.md +42 -0
- package/agents/web-performance-auditor.md +192 -0
- package/bin/cli.js +633 -0
- package/bin/force-patch-changesets.js +44 -0
- package/bin/lib/bootstrap.js +323 -0
- package/bin/lib/detect-agent.js +49 -0
- package/bin/lib/doctor.js +302 -0
- package/bin/lib/transform-persona.js +180 -0
- package/bin/lib/update-notifier.js +195 -0
- package/bin/lib/validate-overrides.js +229 -0
- package/bin/snapshot-version.js +91 -0
- package/docs/agent-fleet-setup.md +355 -0
- package/docs/claude-code-coms-bridge.md +93 -0
- package/docs/getting-started.md +169 -0
- package/docs/npm-install.md +335 -0
- package/docs/opencode-setup.md +248 -0
- package/docs/pi-extensions.md +237 -0
- package/docs/pi-setup.md +455 -0
- package/docs/skill-anatomy.md +150 -0
- package/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/hooks/coms-stop-hook.mjs +73 -0
- package/hooks/hooks.json +14 -0
- package/hooks/session-start.sh +74 -0
- package/hooks/simplify-ignore.sh +302 -0
- package/justfile +143 -0
- package/node_modules/pi-ask-user/LICENSE +21 -0
- package/node_modules/pi-ask-user/README.md +156 -0
- package/node_modules/pi-ask-user/index.ts +1795 -0
- package/node_modules/pi-ask-user/package.json +51 -0
- package/node_modules/pi-ask-user/single-select-layout.ts +203 -0
- package/node_modules/pi-ask-user/skills/ask-user/SKILL.md +162 -0
- package/node_modules/pi-ask-user/skills/ask-user/references/ask-user-skill-extension-spec.md +96 -0
- package/package.json +121 -0
- package/references/accessibility-checklist.md +160 -0
- package/references/definition-of-done.md +67 -0
- package/references/fleet-coordination-patterns.md +151 -0
- package/references/observability-checklist.md +91 -0
- package/references/orchestration-patterns.md +370 -0
- package/references/performance-checklist.md +153 -0
- package/references/prompting-patterns.md +380 -0
- package/references/security-checklist.md +179 -0
- package/references/testing-patterns.md +236 -0
- package/scripts/coms-claude-bridge.ts +286 -0
- package/scripts/coms-cli.ts +372 -0
- package/scripts/coms-hermes-bridge.ts +399 -0
- package/scripts/lib/claude-bridge-core.ts +100 -0
- package/scripts/lib/coms-envelope.ts +494 -0
- package/scripts/lib/herdr-layout.ts +235 -0
- package/scripts/lib/hermes-bridge-core.ts +238 -0
- package/scripts/lib/persona-banner.ts +62 -0
- package/scripts/lib/team-project.ts +75 -0
- package/scripts/lib/team-snapshot.ts +146 -0
- package/scripts/peer-banner.ts +40 -0
- package/scripts/team-snapshot.ts +221 -0
- package/scripts/team-up.ts +245 -0
- package/skills/_internal/grilling.md +11 -0
- package/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/skills/code-review-and-quality/SKILL.md +381 -0
- package/skills/compound-learning/SKILL.md +137 -0
- package/skills/context-engineering/SKILL.md +291 -0
- package/skills/deprecation-and-migration/SKILL.md +206 -0
- package/skills/designing-agents/SKILL.md +394 -0
- package/skills/designing-agents/pi-harness-authoring.md +209 -0
- package/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/skills/guided-workspace-setup/SKILL.md +506 -0
- package/skills/idea-refine/SKILL.md +182 -0
- package/skills/idea-refine/examples.md +238 -0
- package/skills/idea-refine/frameworks.md +99 -0
- package/skills/idea-refine/refinement-criteria.md +113 -0
- package/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/skills/incremental-implementation/SKILL.md +287 -0
- package/skills/interview-me/SKILL.md +226 -0
- package/skills/orchestration-verification/SKILL.md +181 -0
- package/skills/peer-coms/SKILL.md +81 -0
- package/skills/performance-optimization/SKILL.md +350 -0
- package/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/skills/security-and-hardening/SKILL.md +461 -0
- package/skills/spec-driven-development/SKILL.md +245 -0
- package/skills/using-agent-skills/SKILL.md +199 -0
- package/vendor/agent-skills-upstream/LICENSE +21 -0
- package/vendor/agent-skills-upstream/README.md +11 -0
- package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
|
@@ -0,0 +1,248 @@
|
|
|
1
|
+
# OpenCode Setup
|
|
2
|
+
|
|
3
|
+
This guide explains how to use Agent Fleet with OpenCode in a way that closely mirrors the Claude Code experience (automatic skill selection, lifecycle-driven workflows, and strict process enforcement).
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
OpenCode supports custom `/commands`, but does not have a native plugin system or automatic skill routing like Claude Code.
|
|
8
|
+
|
|
9
|
+
Instead, we achieve parity through:
|
|
10
|
+
|
|
11
|
+
- A strong system prompt (`AGENTS.md`)
|
|
12
|
+
- The built-in `skill` tool
|
|
13
|
+
- Consistent skill discovery from the `/skills` directory
|
|
14
|
+
- Optional prefixed slash commands from `.opencode/commands/`
|
|
15
|
+
|
|
16
|
+
This creates an **agent-driven workflow** where skills are selected and executed automatically, with optional explicit lifecycle commands when you want them.
|
|
17
|
+
|
|
18
|
+
This integration defaults to an agent-driven approach:
|
|
19
|
+
|
|
20
|
+
- Skills are selected automatically based on intent
|
|
21
|
+
- Workflows are enforced via `AGENTS.md`
|
|
22
|
+
- Manual command invocation is optional, not required
|
|
23
|
+
|
|
24
|
+
This more closely matches how Claude Code behaves in practice, while still allowing explicit OpenCode slash commands.
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## Installation
|
|
29
|
+
|
|
30
|
+
1. Clone the repository:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
git clone https://github.com/chankov/agent-fleet.git
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
2. Install the global OpenCode configuration.
|
|
37
|
+
|
|
38
|
+
Set `AGENT_SKILLS_DIR` to wherever you cloned the repo (used in the snippets below):
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
export AGENT_SKILLS_DIR="/path/to/agent-fleet"
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Add the repo's `AGENTS.md` to your global `~/.config/opencode/opencode.json` instructions list (replace `/path/to/agent-fleet` with the absolute path on your machine — `~` is not expanded inside JSON):
|
|
45
|
+
|
|
46
|
+
```json
|
|
47
|
+
{
|
|
48
|
+
"instructions": [
|
|
49
|
+
"/path/to/agent-fleet/AGENTS.md"
|
|
50
|
+
],
|
|
51
|
+
"permission": {
|
|
52
|
+
"skill": {
|
|
53
|
+
"*": "allow"
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Link the skills and commands into your global OpenCode config directory. Symlinking individual files (rather than the whole directory) avoids replacing skills or commands you may already have installed from other sources:
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
mkdir -p ~/.config/opencode/skills ~/.config/opencode/commands
|
|
63
|
+
|
|
64
|
+
# Skills: link each skill directory individually.
|
|
65
|
+
for d in "$AGENT_SKILLS_DIR"/skills/*/; do
|
|
66
|
+
ln -s "$d" "$HOME/.config/opencode/skills/$(basename "$d")"
|
|
67
|
+
done
|
|
68
|
+
|
|
69
|
+
# Commands: link each command file individually.
|
|
70
|
+
for f in "$AGENT_SKILLS_DIR"/.opencode/commands/*.md; do
|
|
71
|
+
ln -s "$f" "$HOME/.config/opencode/commands/$(basename "$f")"
|
|
72
|
+
done
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
> ⚠️ If you already have `~/.config/opencode/skills` or `~/.config/opencode/commands` populated from other sources, do **not** replace the whole directory — use the per-file symlink approach above. The previous `ln -sfn <dir>` shortcut would silently overwrite the existing directory.
|
|
76
|
+
|
|
77
|
+
3. Restart OpenCode.
|
|
78
|
+
|
|
79
|
+
4. Open any project in OpenCode.
|
|
80
|
+
|
|
81
|
+
5. The following Agent Fleet assets are now available globally:
|
|
82
|
+
|
|
83
|
+
- `AGENTS.md` instructions from the repo root
|
|
84
|
+
- All skills from `skills/`
|
|
85
|
+
- Optional prefixed slash commands from `.opencode/commands/`
|
|
86
|
+
|
|
87
|
+
### Optional Slash Commands
|
|
88
|
+
|
|
89
|
+
This repo ships OpenCode-native commands with an `af-` prefix so they are easy to distinguish from other commands:
|
|
90
|
+
|
|
91
|
+
- `/af-spec`
|
|
92
|
+
- `/af-plan`
|
|
93
|
+
- `/af-build`
|
|
94
|
+
- `/af-test`
|
|
95
|
+
- `/af-review`
|
|
96
|
+
- `/af-code-simplify`
|
|
97
|
+
- `/af-ship`
|
|
98
|
+
- `/af-webperf`
|
|
99
|
+
- `/af-design-agent`
|
|
100
|
+
- `/af-orchestrate`
|
|
101
|
+
- `/af-prime`
|
|
102
|
+
- `/af-setup-agent-fleet`
|
|
103
|
+
- `/af-doctor-agent-fleet`
|
|
104
|
+
|
|
105
|
+
These commands are optional shortcuts. The agent can still invoke the correct skills automatically from plain natural-language requests.
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## How It Works
|
|
110
|
+
|
|
111
|
+
### 1. Skill Discovery
|
|
112
|
+
|
|
113
|
+
All skills live in:
|
|
114
|
+
|
|
115
|
+
```
|
|
116
|
+
skills/<skill-name>/SKILL.md
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
OpenCode agents are instructed (via `AGENTS.md`) to:
|
|
120
|
+
|
|
121
|
+
- Detect when a skill applies
|
|
122
|
+
- Invoke the `skill` tool
|
|
123
|
+
- Follow the skill exactly
|
|
124
|
+
|
|
125
|
+
### 2. Automatic Skill Invocation
|
|
126
|
+
|
|
127
|
+
The agent evaluates every request and maps it to the appropriate skill.
|
|
128
|
+
|
|
129
|
+
Examples:
|
|
130
|
+
|
|
131
|
+
- "build a feature" → `incremental-implementation` + `test-driven-development`
|
|
132
|
+
- "design a system" → `spec-driven-development`
|
|
133
|
+
- "fix a bug" → `debugging-and-error-recovery`
|
|
134
|
+
- "review this code" → `code-review-and-quality`
|
|
135
|
+
|
|
136
|
+
The user does **not** need to explicitly request skills.
|
|
137
|
+
|
|
138
|
+
### 3. Lifecycle Mapping
|
|
139
|
+
|
|
140
|
+
The development lifecycle is encoded implicitly via `AGENTS.md` and is also exposed through optional prefixed slash commands. Both routes invoke the same underlying skills:
|
|
141
|
+
|
|
142
|
+
| Lifecycle phase | Claude Code command | OpenCode command | Underlying skill(s) |
|
|
143
|
+
| --------------- | ------------------- | ------------------ | ------------------------------------------------------------- |
|
|
144
|
+
| DEFINE | `/spec` | `/af-spec` | `spec-driven-development` |
|
|
145
|
+
| PLAN | `/plan` | `/af-plan` | `planning-and-task-breakdown` |
|
|
146
|
+
| BUILD | `/build` | `/af-build` | `incremental-implementation` + `test-driven-development` |
|
|
147
|
+
| TEST | `/test` | `/af-test` | `test-driven-development` |
|
|
148
|
+
| VERIFY | — | — | `debugging-and-error-recovery` (implicit on failure) |
|
|
149
|
+
| REVIEW | `/review` | `/af-review` | `code-review-and-quality` |
|
|
150
|
+
| SIMPLIFY | `/code-simplify` | `/af-code-simplify`| `code-simplification` |
|
|
151
|
+
| SHIP | `/ship` | `/af-ship` | `shipping-and-launch` |
|
|
152
|
+
| WEBPERF | `/webperf` | `/af-webperf` | `web-performance-auditor` persona (`performance-optimization`) |
|
|
153
|
+
| AUTHOR | `/design-agent` | `/af-design-agent` | `designing-agents` |
|
|
154
|
+
| ORCHESTRATE | `/orchestrate` | `/af-orchestrate` | `orchestration-verification` |
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## Usage Examples
|
|
159
|
+
|
|
160
|
+
### Example 1: Feature Development
|
|
161
|
+
|
|
162
|
+
User:
|
|
163
|
+
```
|
|
164
|
+
Add authentication to this app
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
Agent behavior:
|
|
168
|
+
- Detects feature work
|
|
169
|
+
- Invokes `spec-driven-development`
|
|
170
|
+
- Produces a spec before writing code
|
|
171
|
+
- Moves to planning and implementation skills
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
### Example 2: Bug Fix
|
|
176
|
+
|
|
177
|
+
User:
|
|
178
|
+
```
|
|
179
|
+
This endpoint is returning 500 errors
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
Agent behavior:
|
|
183
|
+
- Invokes `debugging-and-error-recovery`
|
|
184
|
+
- Reproduces → localizes → fixes → adds guards
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
188
|
+
### Example 3: Code Review
|
|
189
|
+
|
|
190
|
+
User:
|
|
191
|
+
```
|
|
192
|
+
Review this PR
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
Agent behavior:
|
|
196
|
+
- Invokes `code-review-and-quality`
|
|
197
|
+
- Applies structured review (correctness, design, readability, etc.)
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## Agent Expectations (Critical)
|
|
202
|
+
|
|
203
|
+
For OpenCode to work correctly, the agent must follow these rules:
|
|
204
|
+
|
|
205
|
+
- Always check if a skill applies before acting
|
|
206
|
+
- If a skill applies, it MUST be used
|
|
207
|
+
- Never skip required workflows (spec, plan, test, etc.)
|
|
208
|
+
- Do not jump directly to implementation
|
|
209
|
+
|
|
210
|
+
These rules are enforced via `AGENTS.md`.
|
|
211
|
+
|
|
212
|
+
---
|
|
213
|
+
|
|
214
|
+
## Limitations
|
|
215
|
+
|
|
216
|
+
- No plugin system (handled via prompt + structure)
|
|
217
|
+
- Skill invocation depends on model compliance
|
|
218
|
+
|
|
219
|
+
Despite these, the workflow closely matches Claude Code in practice.
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## Recommended Workflow
|
|
224
|
+
|
|
225
|
+
Just use natural language:
|
|
226
|
+
|
|
227
|
+
- "Design a feature"
|
|
228
|
+
- "Plan this change"
|
|
229
|
+
- "Implement this"
|
|
230
|
+
- "Fix this bug"
|
|
231
|
+
- "Review this"
|
|
232
|
+
|
|
233
|
+
The agent will automatically select and execute the correct skills.
|
|
234
|
+
|
|
235
|
+
If you prefer explicit entry points, use the shipped slash commands such as `/af-spec`, `/af-plan`, or `/af-review`.
|
|
236
|
+
|
|
237
|
+
---
|
|
238
|
+
|
|
239
|
+
## Summary
|
|
240
|
+
|
|
241
|
+
OpenCode integration works by combining:
|
|
242
|
+
|
|
243
|
+
- Structured skills (this repo)
|
|
244
|
+
- Strong agent rules (`AGENTS.md`)
|
|
245
|
+
- Automatic skill invocation via reasoning
|
|
246
|
+
- Optional `af-` prefixed slash commands for explicit lifecycle entry points
|
|
247
|
+
|
|
248
|
+
This results in a **production-grade engineering workflow** that works both as an agent-driven system and as an explicit command-driven workflow.
|
|
@@ -0,0 +1,237 @@
|
|
|
1
|
+
# pi Extensions
|
|
2
|
+
|
|
3
|
+
A catalog of the pi extensions in this repo — what each one does, how to run it, the
|
|
4
|
+
supporting data it needs, and how the ported set differs from upstream.
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Attribution
|
|
9
|
+
|
|
10
|
+
The session harnesses documented here — together with their supporting agent
|
|
11
|
+
definitions, design specs, and the `justfile` — are ported
|
|
12
|
+
from the **`pi-vs-claude-code`** project:
|
|
13
|
+
|
|
14
|
+
- **Author:** [disler](https://github.com/disler) (IndyDevDan)
|
|
15
|
+
- **Source:** <https://github.com/disler/pi-vs-claude-code>
|
|
16
|
+
- **License:** MIT — Copyright (c) 2026 IndyDevDan
|
|
17
|
+
|
|
18
|
+
Ported files retain their original authorship; this repo adapts them to its layout and
|
|
19
|
+
conventions. Runtime design specs for the imported harnesses live in `docs/pi-specs/`.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## What these extensions are
|
|
24
|
+
|
|
25
|
+
`.pi/extensions/` ships always-on **utility** extensions — `mcp-bridge`,
|
|
26
|
+
`chrome-devtools-mcp`, `compact-and-continue`, `agent-fleet-update-check`, `btw`, and
|
|
27
|
+
`pi-voice-stt`. pi
|
|
28
|
+
auto-discovers that directory, so they layer onto every session. `btw` adds a
|
|
29
|
+
`/btw <task>` prompt command (plus an `Alt+'` shortcut) that forks the current session
|
|
30
|
+
into an in-process sub-session and opens a live modal over it — full context, same
|
|
31
|
+
cwd, follow-up composer, with a compact result card landing in the main transcript at
|
|
32
|
+
idle. See [.pi/extensions/btw/README.md](../.pi/extensions/btw/README.md).
|
|
33
|
+
|
|
34
|
+
`pi-voice-stt` adds **Alt+S** push-to-talk dictation: it records the mic to a temp WAV via
|
|
35
|
+
`ffmpeg` and transcribes through one of three backends — a generic OpenAI-compatible endpoint,
|
|
36
|
+
Azure Speech (REST short-audio, with optional per-phrase language identification), or Azure
|
|
37
|
+
OpenAI Whisper (Azure AI Foundry). Alt+S toggles record→insert; Enter-while-recording
|
|
38
|
+
transcribes and sends; Esc cancels. It is **gated**: the hotkey binds only once a provider is
|
|
39
|
+
configured (project-local `.ai/stt.json`, the global `~/.pi/agent/stt.json`, or `PI_STT_CONFIG`),
|
|
40
|
+
so an unconfigured session is a no-op. `/stt doctor`
|
|
41
|
+
checks the setup. A simplified port of [`cgarrot/pi-voice-stt`](https://github.com/cgarrot/pi-voice-stt);
|
|
42
|
+
see [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
|
|
43
|
+
|
|
44
|
+
The documented harnesses below are different: each is a **session harness**. They
|
|
45
|
+
reshape the whole pi session — some remove every codebase tool and leave only an
|
|
46
|
+
orchestration tool, some set UI surfaces, some gate every tool call. Most are loaded
|
|
47
|
+
one per session; the supported stack is `damage-control-continue` + `ask-user-remote`
|
|
48
|
+
before `agent-hub`, which the `just hub` recipes use by default. They live in
|
|
49
|
+
**`.pi/harnesses/`** — a directory pi does *not* auto-discover — so a plain `pi`
|
|
50
|
+
run never loads them.
|
|
51
|
+
|
|
52
|
+
### Selective loading — read this first
|
|
53
|
+
|
|
54
|
+
pi auto-discovers every extension directory under a project's `.pi/extensions/` and loads
|
|
55
|
+
all of them. If the harnesses lived there, a plain `pi` run would load them all at once
|
|
56
|
+
— UI surfaces would fight, orchestrators would collide, and harnesses that register the
|
|
57
|
+
same CLI flags would abort startup with duplicate registrations. So the harnesses live in
|
|
58
|
+
`.pi/harnesses/` instead, and you load the desired recipe explicitly:
|
|
59
|
+
|
|
60
|
+
- through the `justfile` — `just hub`, `just ext-damage-control`, `just safe-coms`, …
|
|
61
|
+
- or directly — `pi -e .pi/harnesses/<name>/index.ts`
|
|
62
|
+
|
|
63
|
+
When you consume this repo from another project, point `pi -e` at the harness file you
|
|
64
|
+
want, or symlink that one directory into *its* `.pi/harnesses/` — never drop the harnesses
|
|
65
|
+
into `.pi/extensions/`, and never load all of them at once. The supported multi-harness
|
|
66
|
+
exception is loading a damage-control variant before `agent-hub` for a guarded hub session (see
|
|
67
|
+
[pi-setup.md](pi-setup.md#optional-pi-extensions)).
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Setup
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
just install # one-time — installs runtime deps for extensions + harnesses
|
|
75
|
+
just hub # launch the supported multi-agent hub with damage-control guardrails
|
|
76
|
+
just --list # see every recipe
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
`just install` runs `npm install` for both dependency roots: `.pi/extensions/` for the
|
|
80
|
+
utilities (`@modelcontextprotocol/sdk`, `typebox`) and `.pi/harnesses/` for the harnesses
|
|
81
|
+
(`@sinclair/typebox`, `yaml`). The `@mariozechner/pi-*` packages are provided by the pi
|
|
82
|
+
runtime itself.
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Catalog
|
|
87
|
+
|
|
88
|
+
| Extension | Category | What it does | Run |
|
|
89
|
+
|-----------|----------|--------------|-----|
|
|
90
|
+
| [agent-hub](../.pi/harnesses/agent-hub/README.md) | Orchestration | Supported multi-agent hub: damage-control guardrails by default via `just hub`, dispatcher grid, specialist delegation, research helpers, persona gate, embedded coms, `/handoff`, peer-as-subagent — plus, inside a [herdr](https://herdr.dev) pane, fleet tools (`herdr_spawn_peer` / `herdr_read_pane` / `herdr_close_pane` with human confirmation / `herdr_notify`) | `just hub` |
|
|
91
|
+
| [ask-user-remote](../.pi/harnesses/ask-user-remote/README.md) | Orchestration | Captures stock `pi-ask-user` and registers the default `ask_user`; with `user-remote` live it races local UI against the Hermes bridge, otherwise it is stock local behavior | loaded by `just hub` / `hub-solo` |
|
|
92
|
+
| [damage-control](../.pi/harnesses/damage-control/README.md) | Safety | Blocks destructive tool calls and aborts the turn; loaded into spawned specialists by `agent-hub`; honors pre-granted exemptions from the hub's shared exemptions file | `just ext-damage-control` |
|
|
93
|
+
| [damage-control-continue](../.pi/harnesses/damage-control-continue/README.md) | Safety | Same rules, but blocks deliver feedback so the agent adapts and keeps working (no abort); default guardrail for the `just hub` main session + research helpers. Supports path exemptions: `/allow`/`/allowed`/`/revoke`, a block-time approval dialog, and escalation from headless children to the hub dispatcher | `just ext-damage-control-continue` |
|
|
94
|
+
| [coms](../.pi/harnesses/coms/README.md) | Messaging | Peer-to-peer messaging between pi agents on one machine; launches damage-control-continue-guarded under a chosen name | `just safe-coms <name>` |
|
|
95
|
+
|
|
96
|
+
Each extension directory has its own `README.md` with the full description, command/tool
|
|
97
|
+
surface, requirements, and per-extension upstream changes.
|
|
98
|
+
|
|
99
|
+
### `agent-hub` components
|
|
100
|
+
|
|
101
|
+
`agent-hub` is the consolidated orchestration harness. It replaces the retired standalone
|
|
102
|
+
`agent-team` recipe and absorbs the day-to-day pieces that previously required separate
|
|
103
|
+
harnesses:
|
|
104
|
+
|
|
105
|
+
- **Dispatcher grid** — fixed specialists from `.pi/agents/teams.yaml`, shown in a live dashboard
|
|
106
|
+
with compact/full view toggling.
|
|
107
|
+
- **Specialist delegation** — `dispatch_agent` for writable child-agent work and
|
|
108
|
+
`spawn_research` / `/research` for read-only investigation.
|
|
109
|
+
- **Verification Contract** — the dispatcher owns a ledger of checkable acceptance assertions
|
|
110
|
+
built before any builder runs, via the `set_assertions` / `update_assertion` tools. Each
|
|
111
|
+
assertion is tagged (`test` | `runtime-ui` | `code-grep` | `manual`) and advanced only on
|
|
112
|
+
*proven with evidence*; the ledger persists to `.pi/agent-sessions/assertions.json` (wiped at
|
|
113
|
+
session start like `findings/`) and shows a one-line status, keeping the contract out of the
|
|
114
|
+
dispatcher LLM context. It kills the parity failure (exemplar shipped, siblings missed) by
|
|
115
|
+
requiring a parity/touchpoint inventory for "behave like" requests and runtime proof for UI
|
|
116
|
+
assertions — see the [`orchestration-verification`](../skills/orchestration-verification/SKILL.md)
|
|
117
|
+
skill, which the `orchestrator` persona drives. Advisory in this phase (surfaced, not a hard
|
|
118
|
+
dispatch refusal).
|
|
119
|
+
- **Persona gate** — requires an orchestrator persona at startup unless disabled in the local
|
|
120
|
+
override file; the chosen persona also feeds the coms purpose when no explicit `--purpose` is set.
|
|
121
|
+
- **Operator controls** — `/zoom` timeline inspection plus child-agent kill/restart controls.
|
|
122
|
+
- **Damage-control + ask_user by default** — `just hub` / `just hub-solo` load the
|
|
123
|
+
`damage-control-continue` safety harness and `ask-user-remote` before `agent-hub`, so the
|
|
124
|
+
dispatcher's tool calls are checked against the rules file and the `askUserAvailable` probe sees
|
|
125
|
+
`ask_user`. A blocked call feeds back and the turn keeps going rather than aborting. `agent-hub` also
|
|
126
|
+
re-loads a guardrail into every spawned subagent (via an explicit `-e` that survives their
|
|
127
|
+
`--no-extensions`): research helpers (`researcher` / `deep-researcher`) get the same continue
|
|
128
|
+
variant, while other specialists (builder, test-engineer, …) get the hard-stop `damage-control`
|
|
129
|
+
that aborts on a violation. Protected-path access can be granted at runtime: `/allow <pattern>
|
|
130
|
+
[turn|session]` in the hub pre-authorizes (session grants reach every spawned child via a shared
|
|
131
|
+
session-scoped exemptions file), a block in the hub's own session opens an approval dialog, and a
|
|
132
|
+
block inside a headless child escalates an `access_request` to the hub's coms socket so the user
|
|
133
|
+
decides — deny / once / this agent / all agents. Destructive bash patterns are never exemptible.
|
|
134
|
+
- **Embedded coms** — peer discovery, `coms_list` / `coms_send` / `coms_get` / `coms_await`,
|
|
135
|
+
`/handoff`, and peer-as-subagent flows.
|
|
136
|
+
- **Solo mode** — `just hub-solo` keeps the dispatcher grid, delegation, research helpers, persona
|
|
137
|
+
gate, and controls, but starts without the embedded coms layer.
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## Two browser stacks — when to use which
|
|
142
|
+
|
|
143
|
+
This repo ships **two** ways to drive a browser from a pi agent. They are complementary, not redundant — the axis that separates them is the **tool model** (and where they can run), not just headless-vs-headful, since both can do either:
|
|
144
|
+
|
|
145
|
+
| | `bowser` / `playwright-cli` | `web-debugger` / `chrome-devtools-mcp` |
|
|
146
|
+
|---|---|---|
|
|
147
|
+
| Tool model | CLI over **Bash** (no tool schemas in context) | live `chrome_devtools__*` MCP tools |
|
|
148
|
+
| Strength | headless, parallel named sessions, background automation, scraping, token-efficient | interactive headful debugging, live DOM/console/network, performance traces |
|
|
149
|
+
| Where it runs | **dispatched subagent** (survives `--no-extensions`), peer, or main session | main session or **coms peer** (the extension must be loaded into the process) |
|
|
150
|
+
| Persona | `bowser` | `web-debugger` |
|
|
151
|
+
| Skill | `.pi/skills/bowser/` | `skills/browser-testing-with-devtools/` |
|
|
152
|
+
|
|
153
|
+
**Policy:**
|
|
154
|
+
|
|
155
|
+
- **Automated / CI / background / parallel runtime-UI evidence** → `bowser` (headless `playwright-cli`). This is what the `orchestrator` delegates as a subagent to close `runtime-ui` acceptance assertions.
|
|
156
|
+
- **Interactive debugging of a running dev app** → `web-debugger` (headful `chrome-devtools-mcp`), reached as a coms peer or run on the main session.
|
|
157
|
+
- **Manual visual inspection / login flows** → `web-debugger` headful, or attach to an existing Chrome.
|
|
158
|
+
- **Always require runtime evidence** — snapshot + console + network before/after a critical interaction; a screenshot only for visual/layout confirmation.
|
|
159
|
+
|
|
160
|
+
Why `web-debugger` is a coms peer and not a dispatchable subagent: its `chrome_devtools__*` tools come from the always-on `chrome-devtools-mcp` extension, and agent-hub spawns subagents with `--no-extensions`, so a dispatched child would not have those tools. A coms peer is its own pi process that loads the extension explicitly (via the `extensions:` field in `.pi/agents/peers.yaml`, routed through the `_peer-plus` recipe), and a long-lived peer maps naturally onto one persistent live browser. `bowser` has no such constraint because it only needs Bash + the `playwright-cli` binary on PATH.
|
|
161
|
+
|
|
162
|
+
## Environment variables
|
|
163
|
+
|
|
164
|
+
The `justfile` sets `dotenv-load`, so a `.env` file at the repo root is auto-loaded
|
|
165
|
+
(`.env` is gitignored). Only a few extensions need keys:
|
|
166
|
+
|
|
167
|
+
| Variable | Needed by | Purpose |
|
|
168
|
+
|----------|-----------|---------|
|
|
169
|
+
| `PI_CHROME_DEVTOOLS_MODE` | `chrome-devtools-mcp` | `headless` runs Chrome with no UI; anything else (default) is headed |
|
|
170
|
+
| `PI_CHROME_DEVTOOLS_BROWSER_URL` | `chrome-devtools-mcp` | Attach to a running Chrome (e.g. `http://127.0.0.1:9222`) instead of launching one |
|
|
171
|
+
| `PI_CHROME_DEVTOOLS_USER_DATA_DIR` | `chrome-devtools-mcp` | Persistent Chrome profile path (else the default ephemeral `--isolated` profile) |
|
|
172
|
+
| `OPENAI_API_KEY` | `pi-voice-stt` (openai backend) | API key for the OpenAI-compatible transcription endpoint (var name overridable via `provider.apiKeyEnv`) |
|
|
173
|
+
| `AZURE_SPEECH_KEY` | `pi-voice-stt` (azure backend) | Azure Speech resource key |
|
|
174
|
+
| `AZURE_SPEECH_ENDPOINT` | `pi-voice-stt` (azure backend) | Azure resource endpoint, used when `provider.endpoint` is unset |
|
|
175
|
+
| `PI_STT_CONFIG` / `PI_STT_KEYBIND` | `pi-voice-stt` | Override config (inline JSON or path) / the record hotkey (default `alt+s`) |
|
|
176
|
+
|
|
177
|
+
The `chrome-devtools-mcp` server starts once at extension load, so changing its vars needs a pi
|
|
178
|
+
restart / `/reload` to take effect.
|
|
179
|
+
|
|
180
|
+
---
|
|
181
|
+
|
|
182
|
+
## Supporting data
|
|
183
|
+
|
|
184
|
+
These ported files are runtime dependencies of the extensions above:
|
|
185
|
+
|
|
186
|
+
- **`agents/`** — canonical persona Markdown files for shared and pi-specific agents.
|
|
187
|
+
Read by `agent-hub`.
|
|
188
|
+
- **`.pi/agents/`** — pi YAML configs only (`teams.yaml`, `peers.yaml`).
|
|
189
|
+
The earlier `reviewer` and `red-team` personas were folded into `code-reviewer` and
|
|
190
|
+
`security-auditor`; the remaining team/peer configs already reference the canonical names.
|
|
191
|
+
A peer entry may carry an optional `extensions:` field (comma-separated names under
|
|
192
|
+
`.pi/extensions/`) — `team-up` then routes it through the `_peer-plus` recipe so those
|
|
193
|
+
extensions load into the peer process. The `web-debugger` peer uses this to get
|
|
194
|
+
`chrome-devtools-mcp`'s `chrome_devtools__*` tools (see the two-browser-stacks section above).
|
|
195
|
+
- **`.pi/damage-control-rules.yaml`** — the destructive-command / protected-path rule set
|
|
196
|
+
for `damage-control`.
|
|
197
|
+
- **`.pi/skills/bowser/`** — a pi-runtime skill for headless Playwright browser
|
|
198
|
+
automation, used by the `bowser` agent persona. Kept separate from the core
|
|
199
|
+
engineering `skills/`. It drives the external **Playwright Agent CLI**
|
|
200
|
+
(`playwright-cli`), which is **not** bundled — install it once with
|
|
201
|
+
`npm install -g @playwright/cli@latest` (the guided setup checks for it when
|
|
202
|
+
`bowser` is selected). Docs: <https://playwright.dev/agent-cli/installation>.
|
|
203
|
+
- **`docs/pi-specs/`** — the original design specifications: `agent-forge` (now consolidated
|
|
204
|
+
into `agent-hub`), `agent-workflow` (retired `agent-chain`), and `damage-control`.
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
## Upstream changes
|
|
209
|
+
|
|
210
|
+
What changed relative to `disler/pi-vs-claude-code`:
|
|
211
|
+
|
|
212
|
+
- **Theme code removed.** Every ported harness imported `applyExtensionDefaults` from a
|
|
213
|
+
shared `themeMap.ts`. That import and its `session_start` call site were stripped from
|
|
214
|
+
the ported files; `themeMap.ts` and the 11 `.pi/themes/*.json` palettes are not ported.
|
|
215
|
+
Extensions render against pi's active theme.
|
|
216
|
+
- **Layout converted.** Flat `extensions/<name>.ts` files became
|
|
217
|
+
`.pi/harnesses/<name>/index.ts` directories, each with its own `package.json` and
|
|
218
|
+
`README.md`. They live under `.pi/harnesses/` — *not* `.pi/extensions/` — because pi
|
|
219
|
+
auto-discovers and loads everything in `.pi/extensions/`, while harnesses must be loaded
|
|
220
|
+
explicitly through recipes (with `damage-control-continue` + `ask-user-remote` before
|
|
221
|
+
`agent-hub` as the supported stack).
|
|
222
|
+
- **Tooling switched to npm.** `bun` / `bun.lock` are not used; the `justfile` recipes
|
|
223
|
+
point at the new paths and use npm.
|
|
224
|
+
|
|
225
|
+
### Not ported
|
|
226
|
+
|
|
227
|
+
- The `pure-focus`, `theme-cycler`, and `cross-agent` extensions.
|
|
228
|
+
- `themeMap.ts` and all 11 `.pi/themes/*.json` theme palettes.
|
|
229
|
+
- The Claude Code `statusLine` config and `status_lines/status_line.py`, and the
|
|
230
|
+
`plan_w_team.md` command (it depended on team-agent files absent from the source).
|
|
231
|
+
|
|
232
|
+
### A note on `.pi/settings.json`
|
|
233
|
+
|
|
234
|
+
Upstream shipped a `.pi/settings.json` that only set the (now-stripped) theme and
|
|
235
|
+
registered a prompt directory. This repo already keeps pi prompts in the standard
|
|
236
|
+
`.pi/prompts/` location, so no `.pi/settings.json` is shipped — it would carry nothing
|
|
237
|
+
useful.
|