@chankov/agent-fleet 0.0.2 → 0.0.4
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/doctor-agent-fleet.md +1 -1
- package/.claude/commands/setup-agent-fleet.md +5 -5
- package/.opencode/commands/af-doctor-agent-fleet.md +2 -0
- package/.opencode/commands/af-setup-agent-fleet.md +1 -1
- package/.pi/agents/peers.yaml +4 -0
- package/.pi/agents/teams.yaml +2 -2
- package/.pi/harnesses/agent-hub/README.md +254 -18
- package/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.pi/harnesses/agent-hub/delegate.ts +32 -9
- package/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.pi/harnesses/agent-hub/helpers.ts +49 -0
- package/.pi/harnesses/agent-hub/index.ts +1269 -322
- package/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.pi/harnesses/agent-hub/package.json +5 -4
- package/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.pi/harnesses/agent-hub/spawn.ts +161 -94
- package/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.pi/harnesses/ask-user-remote/README.md +2 -0
- package/.pi/harnesses/coms/README.md +21 -0
- package/.pi/harnesses/coms/index.ts +2 -0
- package/.pi/harnesses/coms/package.json +5 -4
- package/.pi/harnesses/coms/version.ts +18 -0
- package/.pi/harnesses/damage-control-continue/README.md +32 -31
- package/.pi/harnesses/damage-control-continue/index.ts +23 -9
- package/.pi/harnesses/damage-control-continue/package.json +5 -4
- package/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.pi/harnesses/{damage-control/shared.ts → lib/damage-control-shared.ts} +20 -6
- package/.pi/prompts/doctor-agent-fleet.md +1 -1
- package/.pi/prompts/setup-agent-fleet.md +5 -5
- package/.versions/0.0.4/.claude/commands/build.md +44 -0
- package/.versions/0.0.4/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.4/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.4/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.4/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.4/.claude/commands/plan.md +16 -0
- package/.versions/0.0.4/.claude/commands/prime.md +22 -0
- package/.versions/0.0.4/.claude/commands/review.md +16 -0
- package/.versions/0.0.4/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.4/.claude/commands/ship.md +72 -0
- package/.versions/0.0.4/.claude/commands/spec.md +15 -0
- package/.versions/0.0.4/.claude/commands/test.md +19 -0
- package/.versions/0.0.4/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.4/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.4/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.4/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.4/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.4/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.4/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.4/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.4/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.4/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.4/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.4/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.4/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.4/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/{.pi/harnesses/damage-control → .versions/0.0.4/.pi/extensions/agent-fleet-update-check}/package.json +1 -1
- package/.versions/0.0.4/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.4/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.4/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.4/.pi/extensions/package.json +9 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/README.md +18 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/index.ts +293 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.4/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.4/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.4/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.4/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.4/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.4/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.4/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.4/.pi/prompts/build.md +24 -0
- package/.versions/0.0.4/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.4/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.4/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.4/.pi/prompts/review.md +16 -0
- package/.versions/0.0.4/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.4/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.4/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.4/.pi/prompts/test.md +19 -0
- package/.versions/0.0.4/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.4/.version +1 -0
- package/.versions/0.0.4/agents/architect.md +23 -0
- package/.versions/0.0.4/agents/bowser.md +26 -0
- package/.versions/0.0.4/agents/builder.md +53 -0
- package/.versions/0.0.4/agents/code-reviewer.md +205 -0
- package/.versions/0.0.4/agents/deep-researcher.md +31 -0
- package/.versions/0.0.4/agents/documenter.md +18 -0
- package/.versions/0.0.4/agents/orchestrator.md +54 -0
- package/.versions/0.0.4/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.4/agents/planner.md +69 -0
- package/.versions/0.0.4/agents/releaser.md +24 -0
- package/.versions/0.0.4/agents/researcher.md +28 -0
- package/.versions/0.0.4/agents/security-auditor.md +166 -0
- package/.versions/0.0.4/agents/test-engineer.md +151 -0
- package/.versions/0.0.4/agents/web-debugger.md +42 -0
- package/.versions/0.0.4/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.4/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.4/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.4/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.4/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.4/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.4/docs/coms-hermes-bridge.md +121 -0
- package/.versions/0.0.4/docs/getting-started.md +183 -0
- package/.versions/0.0.4/docs/npm-install.md +337 -0
- package/.versions/0.0.4/docs/opencode-setup.md +248 -0
- package/.versions/0.0.4/docs/pi-extensions.md +288 -0
- package/.versions/0.0.4/docs/pi-setup.md +463 -0
- package/.versions/0.0.4/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.4/hermes/README.md +228 -0
- package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/.versions/0.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.4/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.4/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.4/hooks/hooks.json +14 -0
- package/.versions/0.0.4/hooks/session-start.sh +74 -0
- package/.versions/0.0.4/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.4/justfile +256 -0
- package/.versions/0.0.4/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.4/references/definition-of-done.md +67 -0
- package/.versions/0.0.4/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.4/references/observability-checklist.md +91 -0
- package/.versions/0.0.4/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.4/references/performance-checklist.md +153 -0
- package/.versions/0.0.4/references/prompting-patterns.md +380 -0
- package/.versions/0.0.4/references/security-checklist.md +179 -0
- package/.versions/0.0.4/references/testing-patterns.md +236 -0
- package/.versions/0.0.4/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.4/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.4/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.4/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.4/scripts/coms-hermes-bridge.ts +403 -0
- package/.versions/0.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.4/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.4/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.4/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.4/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.4/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.4/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.4/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.4/scripts/lib/hermes-bridge-core.ts +238 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.4/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.4/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.4/scripts/lib/team-project.ts +184 -0
- package/.versions/0.0.4/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.4/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.4/scripts/team-snapshot.ts +238 -0
- package/.versions/0.0.4/scripts/team-up.ts +333 -0
- package/.versions/0.0.4/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.4/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.4/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.4/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.4/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.4/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +535 -0
- package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +33 -0
- package/.versions/0.0.4/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.4/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.4/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.4/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.4/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.4/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.4/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.4/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.4/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.4/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.4/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.4/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.4/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +53 -0
- package/README.md +103 -541
- package/agents/architect.md +1 -1
- package/agents/builder.md +1 -1
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +3 -3
- package/agents/orchestrator.md +20 -11
- package/agents/plan-reviewer.md +3 -3
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +11 -4
- package/bin/lib/validate-overrides.js +19 -0
- package/bin/snapshot-version.js +17 -1
- package/bin/sync-harness-versions.js +94 -0
- package/codex/CONDUCTOR.md +148 -0
- package/docs/ARCHITECTURE.md +210 -0
- package/docs/agent-fleet-setup.md +11 -0
- package/docs/claude-code-coms-bridge.md +10 -0
- package/docs/codex-remote-conductor.md +170 -0
- package/docs/coms-hermes-bridge.md +121 -0
- package/docs/getting-started.md +14 -0
- package/docs/npm-install.md +2 -0
- package/docs/pi-extensions.md +49 -14
- package/docs/pi-setup.md +12 -4
- package/hermes/README.md +228 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/justfile +106 -23
- package/package.json +17 -5
- package/scripts/codex-conductor.ts +41 -0
- package/scripts/codex-remote-control.ts +167 -0
- package/scripts/coms-cli.ts +311 -199
- package/scripts/coms-hermes-bridge.ts +2 -2
- package/scripts/lib/codex-conductor.ts +88 -0
- package/scripts/lib/codex-remote-control.ts +480 -0
- package/scripts/lib/coms-envelope.ts +51 -6
- package/scripts/lib/fake-herdr-server.ts +88 -0
- package/scripts/lib/herdr-layout.ts +18 -3
- package/scripts/lib/hermes-bridge-core.ts +4 -4
- package/scripts/lib/hermes-monitor-herdr.ts +28 -0
- package/scripts/lib/hermes-monitor-model.ts +9 -0
- package/scripts/lib/hermes-monitor-registry.ts +6 -0
- package/scripts/lib/hermes-monitor-socket.ts +118 -0
- package/scripts/lib/hermes-monitor-store.ts +31 -0
- package/scripts/lib/team-project.ts +85 -1
- package/scripts/team-up.ts +77 -18
- package/skills/designing-agents/SKILL.md +2 -2
- package/skills/designing-agents/pi-harness-authoring.md +26 -13
- package/skills/guided-workspace-setup/SKILL.md +131 -102
- package/skills/guided-workspace-setup/companion-manifest.json +33 -0
- package/skills/peer-coms/SKILL.md +9 -0
- package/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.pi/harnesses/damage-control/README.md +0 -65
- package/.pi/harnesses/damage-control/index.ts +0 -250
package/README.md
CHANGED
|
@@ -6,669 +6,231 @@
|
|
|
6
6
|
|
|
7
7
|
**Operate a coding-agent *fleet* — not just one chat session.**
|
|
8
8
|
|
|
9
|
-
Agent Fleet is a **
|
|
9
|
+
Agent Fleet is a **multi-agent orchestration system for AI coding agents**, built pi-first: a thin dispatcher routes work to specialist agents under a Verification Contract, whole teams spawn as tiled workspaces you can snapshot and resume, agents message each other over a shared coms plane — and a library of **29 production-grade lifecycle skills** and **15 personas** keeps every agent disciplined. Runs on **pi** (primary runtime), **Claude Code**, and **OpenCode**.
|
|
10
|
+
|
|
11
|
+

|
|
10
12
|
|
|
11
13
|
```text
|
|
12
14
|
You ──▶ Hub (dispatcher) ──▶ Team agents ──▶ Sub-agents
|
|
13
15
|
│ │
|
|
14
16
|
├── herdr (workspace) ├── skills (how to work)
|
|
15
17
|
├── coms (messages) └── Verification Contract
|
|
16
|
-
|
|
18
|
+
├── Hermes (phone · inbound ask_user)
|
|
19
|
+
└── Codex Remote Control (phone · outbound delegation, experimental)
|
|
17
20
|
```
|
|
18
21
|
|
|
19
|
-
**What you get:**
|
|
20
|
-
|
|
21
22
|
| Layer | Job |
|
|
22
23
|
| --- | --- |
|
|
23
|
-
| **[agent-hub](#agent-hub-a-
|
|
24
|
+
| **[agent-hub](#agent-hub-a-thin-context-dispatcher-for-pi)** | Thin-context dispatcher on **pi** — drives specialists under a Verification Contract |
|
|
24
25
|
| **[herdr](https://herdr.dev)** | Fleet control plane — tiled peer workspaces, presence, snapshot/resume |
|
|
25
26
|
| **coms** | Peer data plane — bidirectional messaging between agents (including Claude Code panes) |
|
|
26
27
|
| **Hermes** | Remote human control — relay hub questions to your phone |
|
|
27
|
-
| **
|
|
28
|
-
|
|
29
|
-
Supported coding agents: **pi** (primary runtime), **Claude Code**, and **OpenCode**.
|
|
30
|
-
|
|
31
|
-
```
|
|
32
|
-
DEFINE PLAN BUILD VERIFY REVIEW SHIP
|
|
33
|
-
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
|
|
34
|
-
│ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │
|
|
35
|
-
│Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │
|
|
36
|
-
└──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
|
|
37
|
-
/spec /plan /build /test /review /ship
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
<details>
|
|
41
|
-
<summary><b>Table of contents</b></summary>
|
|
42
|
-
|
|
43
|
-
- [Origins: from skill library to fleet](#origins-from-skill-library-to-fleet)
|
|
44
|
-
- [Fleet hierarchy](#fleet-hierarchy)
|
|
45
|
-
- [Quick Start](#quick-start)
|
|
46
|
-
- [agent-hub: a multi-agent harness for pi](#agent-hub-a-multi-agent-harness-for-pi)
|
|
47
|
-
- [Commands](#commands)
|
|
48
|
-
- [All 29 Skills](#all-29-skills)
|
|
49
|
-
- [Agent Personas](#agent-personas)
|
|
50
|
-
- [Reference Checklists](#reference-checklists)
|
|
51
|
-
- [How Skills Work](#how-skills-work)
|
|
52
|
-
- [Per-Project Overrides](#per-project-overrides)
|
|
53
|
-
- [Project Structure](#project-structure)
|
|
54
|
-
- [Why Agent Fleet?](#why-agent-fleet)
|
|
55
|
-
- [How it compares](#how-it-compares)
|
|
56
|
-
- [Credits & inspiration](#credits--inspiration)
|
|
57
|
-
- [Built on (dependencies & tools)](#built-on-dependencies--tools)
|
|
58
|
-
- [Contributing](#contributing)
|
|
59
|
-
|
|
60
|
-
</details>
|
|
28
|
+
| **Codex conductor (experimental)** | Android-initiated, approval-gated delegation to live coms peers through a user-systemd service |
|
|
29
|
+
| **[Skills](docs/skills-catalog.md) + [personas](docs/agents.md)** | Lifecycle discipline — how to spec, plan, build, verify, review, and ship |
|
|
61
30
|
|
|
62
31
|
---
|
|
63
32
|
|
|
64
|
-
##
|
|
65
|
-
|
|
66
|
-
Agent Fleet started life as a customized fork of [Addy Osmani](https://github.com/addyosmani)'s [`agent-skills`](https://github.com/addyosmani/agent-skills) — a library of production-grade lifecycle skills — with pi session-harness patterns from [IndyDevDan](https://github.com/disler)'s [`pi-vs-claude-code`](https://github.com/disler/pi-vs-claude-code) growing alongside it. As the orchestration layer became the center of gravity, the project **split from the fork lineage and rebranded as Agent Fleet**, and the aim inverted:
|
|
67
|
-
|
|
68
|
-
- **Then:** a skill library you install into one coding agent, with orchestration as an add-on.
|
|
69
|
-
- **Now:** an *operable multi-agent fleet* — dispatcher (`agent-hub`), control plane (herdr), messaging plane (coms), remote control (Hermes) — with the skill library as its **discipline layer**.
|
|
70
|
-
|
|
71
|
-
The split kept the upstream relationship honest instead of severing it: Addy's library is vendored **pristine at a pinned SHA** under [`vendor/agent-skills-upstream/`](vendor/agent-skills-upstream/) and updated deliberately (policy: [docs/UPSTREAM-SKILLS.md](docs/UPSTREAM-SKILLS.md)), while Agent Fleet-native and customized skills in [`skills/`](skills/) shadow same-named vendored ones. The one-time split record lives in [docs/MIGRATION-agent-fleet.md](docs/MIGRATION-agent-fleet.md); full attribution in [Credits](#credits--inspiration).
|
|
72
|
-
|
|
73
|
-
---
|
|
74
|
-
|
|
75
|
-
## Fleet hierarchy
|
|
76
|
-
|
|
77
|
-
Agent Fleet is layered on purpose. Work flows **down** (delegate); evidence and status flow **up** — as compact structured returns, never raw dumps.
|
|
78
|
-
|
|
79
|
-
### Hub → team → agents → sub-agents
|
|
80
|
-
|
|
81
|
-
```mermaid
|
|
82
|
-
flowchart TD
|
|
83
|
-
You(["You · + Hermes relay on your phone"])
|
|
84
|
-
|
|
85
|
-
subgraph HUBL["HUB — thin dispatcher (just hub · just hub-team)"]
|
|
86
|
-
Hub["agent-hub harness + orchestrator persona<br/>routes tasks · owns the Verification Contract on disk<br/>never swallows research dumps into its own context"]
|
|
87
|
-
end
|
|
88
|
-
|
|
89
|
-
subgraph TEAML["TEAM — named roster (.pi/agents/teams.yaml)"]
|
|
90
|
-
Team["default: planner · plan-reviewer · builder · test-engineer · code-reviewer · documenter<br/>also: debug · frontend · security · hotfix · release · info"]
|
|
91
|
-
end
|
|
92
|
-
|
|
93
|
-
subgraph RESL["RESEARCH HELPERS — read-only, always available"]
|
|
94
|
-
Research["researcher (fast tier — simple reads)<br/>deep-researcher (deep tier — hard, cross-cutting questions)"]
|
|
95
|
-
end
|
|
96
|
-
|
|
97
|
-
subgraph SUBL["SUB-AGENTS — focused children, narrow tools + models"]
|
|
98
|
-
Subs["planner → scout · rules · risk<br/>plan-reviewer → feasibility · deps<br/>builder → recon · verifier<br/>test-engineer → coverage-scout · conventions<br/>code-reviewer → preflight · quality · perf · docs<br/>security-auditor → recon · input-sweep · secrets-sweep"]
|
|
99
|
-
end
|
|
100
|
-
|
|
101
|
-
You -->|task| Hub
|
|
102
|
-
Hub -->|"dispatch_agent — one persona = one specialist session"| Team
|
|
103
|
-
Hub -->|"spawn_research"| Research
|
|
104
|
-
Research -.->|"findings written to disk — hub gets paths, not dumps"| Hub
|
|
105
|
-
Team -->|"subagents: block (delegate_depth ≥ 1)"| Subs
|
|
106
|
-
Subs -.->|"results return to the parent agent only"| Team
|
|
107
|
-
Team -.->|"structured return + evidence"| Hub
|
|
108
|
-
Hub -.->|"one status line: Assertions: 2✓ 1○ 1✗"| You
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
Every specialist session is one persona from [`agents/`](agents/) — *skills* tell each agent **how** to work; *personas* define **who** they are.
|
|
112
|
-
|
|
113
|
-
### Same idea as a tree
|
|
114
|
-
|
|
115
|
-
```text
|
|
116
|
-
hub (orchestrator)
|
|
117
|
-
├── team: default
|
|
118
|
-
│ ├── planner
|
|
119
|
-
│ │ ├── scout
|
|
120
|
-
│ │ ├── rules
|
|
121
|
-
│ │ └── risk
|
|
122
|
-
│ ├── plan-reviewer
|
|
123
|
-
│ │ ├── feasibility
|
|
124
|
-
│ │ └── deps
|
|
125
|
-
│ ├── builder
|
|
126
|
-
│ │ ├── recon
|
|
127
|
-
│ │ └── verifier
|
|
128
|
-
│ ├── test-engineer
|
|
129
|
-
│ │ ├── coverage-scout
|
|
130
|
-
│ │ └── conventions
|
|
131
|
-
│ ├── code-reviewer
|
|
132
|
-
│ │ ├── preflight
|
|
133
|
-
│ │ ├── quality
|
|
134
|
-
│ │ ├── perf
|
|
135
|
-
│ │ └── docs
|
|
136
|
-
│ └── documenter
|
|
137
|
-
├── research helpers (spawn_research, any time)
|
|
138
|
-
│ ├── researcher
|
|
139
|
-
│ └── deep-researcher
|
|
140
|
-
└── optional fleet peers (herdr + coms)
|
|
141
|
-
├── architect / releaser / web-debugger panes
|
|
142
|
-
├── Claude Code peer (coms bridge)
|
|
143
|
-
└── Hermes (phone human)
|
|
144
|
-
```
|
|
33
|
+
## Quick Start
|
|
145
34
|
|
|
146
|
-
###
|
|
35
|
+
### pi (primary runtime)
|
|
147
36
|
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
AF -->|remote human| HERMES["<b>Hermes</b><br/>hub questions relayed<br/>to your phone (Telegram)"]
|
|
37
|
+
```bash
|
|
38
|
+
pi install -l npm:@chankov/agent-fleet # project-scoped package: skills, prompts, ask-user
|
|
39
|
+
# then, inside pi:
|
|
40
|
+
# /setup-agent-fleet # guided install of harnesses, personas, extensions
|
|
41
|
+
# and once set up:
|
|
42
|
+
just hub # guarded multi-agent dispatcher
|
|
43
|
+
just hub-team docs # hub + a whole peer team in one tiled herdr workspace
|
|
156
44
|
```
|
|
157
45
|
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
---
|
|
161
|
-
|
|
162
|
-
## Quick Start
|
|
46
|
+
### Claude Code / OpenCode
|
|
163
47
|
|
|
164
48
|
```bash
|
|
165
|
-
# In the workspace you want to configure:
|
|
166
49
|
npx @chankov/agent-fleet init
|
|
167
|
-
#
|
|
50
|
+
# then open your coding agent in this directory and run:
|
|
168
51
|
# /setup-agent-fleet
|
|
169
52
|
```
|
|
170
53
|
|
|
171
|
-
|
|
172
|
-
(Claude Code, OpenCode, or pi), and `/setup-agent-fleet` runs the full guided install —
|
|
173
|
-
analysing the workspace, showing grouped menus, and confirming everything
|
|
174
|
-
before writing a single file.
|
|
175
|
-
|
|
176
|
-
Main CLI commands:
|
|
54
|
+
The CLI detects your coding agent and `/setup-agent-fleet` runs the full guided install — analysing the workspace, showing grouped menus, and confirming everything before writing a single file.
|
|
177
55
|
|
|
178
|
-
|
|
|
56
|
+
| CLI command | What it does |
|
|
179
57
|
|---|---|
|
|
180
58
|
| `npx @chankov/agent-fleet init` | Materialize the package + hand off to `/setup-agent-fleet` |
|
|
181
59
|
| `npx @chankov/agent-fleet doctor` | Scan for broken symlinks and stale persona refs |
|
|
182
60
|
| `npx @chankov/agent-fleet update` | Surface the version delta + hand off to `/setup-agent-fleet` for the per-artifact diff |
|
|
183
|
-
| `npx @chankov/agent-fleet transform-persona` | Generate per-agent subagent files from the canonical personas
|
|
184
|
-
|
|
185
|
-
Versioned with [semver](https://semver.org); changelog in
|
|
186
|
-
[CHANGELOG.md](CHANGELOG.md); full docs in [docs/npm-install.md](docs/npm-install.md).
|
|
187
|
-
|
|
188
|
-
### Other install paths
|
|
61
|
+
| `npx @chankov/agent-fleet transform-persona` | Generate per-agent subagent files from the canonical personas |
|
|
189
62
|
|
|
190
63
|
<details>
|
|
191
|
-
<summary><b>
|
|
64
|
+
<summary><b>Other install paths</b> — Claude Code marketplace, git clone + symlinks, OpenCode details</summary>
|
|
65
|
+
|
|
66
|
+
**Claude Code plugin marketplace** — best UX inside Claude Code:
|
|
192
67
|
|
|
193
68
|
```
|
|
194
69
|
/plugin marketplace add chankov/agent-fleet
|
|
195
70
|
/plugin install agent-fleet@nc-agent-fleet
|
|
196
71
|
```
|
|
197
72
|
|
|
198
|
-
> **SSH errors?** The marketplace clones
|
|
199
|
-
> ```bash
|
|
200
|
-
> /plugin marketplace add https://github.com/chankov/agent-fleet.git
|
|
201
|
-
> /plugin install agent-fleet@nc-agent-fleet
|
|
202
|
-
> ```
|
|
73
|
+
> **SSH errors?** The marketplace clones via SSH; use the HTTPS URL instead: `/plugin marketplace add https://github.com/chankov/agent-fleet.git`
|
|
203
74
|
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
<details>
|
|
207
|
-
<summary><b>Git clone + symlinks</b> — best for skill authors and contributors</summary>
|
|
75
|
+
**Git clone + symlinks** — best for skill authors and contributors:
|
|
208
76
|
|
|
209
77
|
```bash
|
|
210
|
-
git clone https://github.com/chankov/agent-fleet.git
|
|
211
|
-
|
|
212
|
-
#
|
|
213
|
-
claude --plugin-dir .
|
|
214
|
-
# Then run /setup-agent-fleet in your target workspace and pick "symlink" in Step 8.
|
|
78
|
+
git clone https://github.com/chankov/agent-fleet.git && cd agent-fleet
|
|
79
|
+
claude --plugin-dir . # in Claude Code
|
|
80
|
+
# then run /setup-agent-fleet in your target workspace and pick "symlink"
|
|
215
81
|
```
|
|
216
82
|
|
|
217
83
|
Updates flow through `git pull`. Symlinks need Developer Mode on Windows.
|
|
218
84
|
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
<details>
|
|
222
|
-
<summary><b>OpenCode</b></summary>
|
|
223
|
-
|
|
224
|
-
Uses agent-driven skill execution via `AGENTS.md` and the `skill` tool.
|
|
85
|
+
**OpenCode** — agent-driven skill execution via `AGENTS.md` + the `skill` tool, plus optional `af-*` slash commands (`/af-spec` … `/af-ship`, `/af-orchestrate`, `/af-compound`). See [docs/opencode-setup.md](docs/opencode-setup.md).
|
|
225
86
|
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
- `/af-spec`
|
|
229
|
-
- `/af-plan`
|
|
230
|
-
- `/af-build`
|
|
231
|
-
- `/af-test`
|
|
232
|
-
- `/af-review`
|
|
233
|
-
- `/af-orchestrate`
|
|
234
|
-
- `/af-code-simplify`
|
|
235
|
-
- `/af-ship`
|
|
236
|
-
- `/af-design-agent`
|
|
237
|
-
|
|
238
|
-
See [docs/opencode-setup.md](docs/opencode-setup.md).
|
|
87
|
+
**pi details** — the package bundles `pi-ask-user` (interactive `ask_user` + skill); lifecycle commands load from `.pi/prompts/`, always-on utility extensions from `.pi/extensions/` (mcp-bridge, chrome-devtools-mcp, compact-and-continue, pi-voice-stt push-to-talk dictation), and the selectable harnesses live under `.pi/harnesses/` (loaded via the `justfile`). See [docs/pi-setup.md](docs/pi-setup.md) and the [pi extension catalog](docs/pi-extensions.md).
|
|
239
88
|
|
|
240
89
|
</details>
|
|
241
90
|
|
|
242
|
-
|
|
243
|
-
<summary><b>pi</b></summary>
|
|
91
|
+
### Experimental: delegate to live peers from ChatGPT Android
|
|
244
92
|
|
|
245
|
-
|
|
93
|
+
The optional Codex Remote-Control conductor is verified on Linux with Codex CLI `0.144.x`. Hermes remains the inbound `ask_user` route; Codex is outbound-only and delegates one confirmed task at a time to peers already visible in the same coms project.
|
|
246
94
|
|
|
247
95
|
```bash
|
|
248
|
-
|
|
96
|
+
cd /path/to/agent-fleet
|
|
97
|
+
just conductor-codex-setup docs --project af # once per configured context
|
|
98
|
+
just conductor-codex-pair # interactive; never capture the code
|
|
99
|
+
just conductor-codex-start
|
|
100
|
+
just hub-team docs --project af # hub + peers Codex can reach
|
|
249
101
|
```
|
|
250
102
|
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
Optional suggested npm/pi extension package: `pi-codex-image-gen` adds image-generation support and can be selected during guided setup when pi package installation is available, or installed manually with `pi install -l npm:pi-codex-image-gen`. It is not bundled or required; minimal setup works without it. Upstream: <https://github.com/jvm/pi-mono>.
|
|
103
|
+
In ChatGPT Android, open the paired Remote Control host and use the managed external workspace at `$HOME/.local/state/agent-fleet/codex-conductor/workspace`. Do not start a local `codex` process for the Android flow, and do not also launch `conductor-codex docs` when `hub-team docs` already owns the same peers.
|
|
254
104
|
|
|
255
|
-
|
|
105
|
+
Lifecycle, approval flow, examples, recovery, and security boundaries: **[Codex Remote-Control conductor runbook](docs/codex-remote-conductor.md)**.
|
|
256
106
|
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
</details>
|
|
107
|
+
Versioned with [semver](https://semver.org) — [CHANGELOG.md](CHANGELOG.md) · [docs/npm-install.md](docs/npm-install.md).
|
|
260
108
|
|
|
261
109
|
---
|
|
262
110
|
|
|
263
|
-
## agent-hub: a
|
|
264
|
-
|
|
265
|
-
`agent-hub` turns a single **pi** session into a **dispatcher that drives a live team of specialist subagents** — planner, builder, reviewer, test-engineer, documenter — with read-only research helpers fanning out beneath them, peer-to-peer `coms` messaging embedded, and a `damage-control` guardrail on every tool call.
|
|
266
|
-
|
|
267
|
-

|
|
268
|
-
|
|
269
|
-
What makes it different is what it **doesn't** put in front of the dispatcher LLM.
|
|
111
|
+
## agent-hub: a thin-context dispatcher for pi
|
|
270
112
|
|
|
271
|
-
|
|
113
|
+
`agent-hub` turns a single **pi** session into a **dispatcher that drives a live team of specialist subagents** — planner, builder, reviewer, test-engineer, documenter — with read-only research helpers fanning out beneath them, peer-to-peer `coms` messaging embedded, and a `damage-control-continue` guardrail on every tool call.
|
|
272
114
|
|
|
273
|
-
Multi-agent setups usually drown the orchestrator: every subagent's output, every research dump
|
|
115
|
+
What makes it different is what it **doesn't** put in front of the dispatcher LLM. Multi-agent setups usually drown the orchestrator: every subagent's output, every research dump flows back into one context window until it compacts and forgets. `agent-hub` is built the other way around:
|
|
274
116
|
|
|
275
|
-
- **Research never enters the dispatcher context.**
|
|
276
|
-
- **The Verification Contract lives on disk.**
|
|
117
|
+
- **Research never enters the dispatcher context.** Specialists end their turn with `NEEDS_RESEARCH:` lines; the hub fans out read-only helpers, writes findings to disk, and resumes the specialist with file paths. The dispatcher sees a one-line notice — never the raw findings. Each local-disk research tool call has a parent-side 120-second watchdog (configurable as `recon-search-timeout-s` in `.ai/agent-fleet-overrides.md`), not a whole-agent deadline.
|
|
118
|
+
- **The Verification Contract lives on disk.** A ledger of checkable acceptance assertions, built from the request *before* any builder runs, rendered as one status line (`Assertions: 2✓ 1○ 1✗ · open: A4`). A stated requirement is never silently dropped, and the contract survives compaction.
|
|
277
119
|
- **Specialists run `--no-extensions`.** Tools and credentials stay scoped to the subagent that needs them instead of leaking up into the dispatcher.
|
|
278
120
|
|
|
279
|
-
The whole loop, end to end:
|
|
280
|
-
|
|
281
|
-
```mermaid
|
|
282
|
-
sequenceDiagram
|
|
283
|
-
autonumber
|
|
284
|
-
actor U as You
|
|
285
|
-
participant H as Hub (dispatcher)
|
|
286
|
-
participant S as Specialist (e.g. builder)
|
|
287
|
-
participant R as Research helper
|
|
288
|
-
participant D as Disk (.pi/agent-sessions/)
|
|
289
|
-
|
|
290
|
-
U->>H: task
|
|
291
|
-
H->>D: set_assertions — Verification Contract persisted
|
|
292
|
-
H->>S: dispatch_agent (task + advisory scope)
|
|
293
|
-
S-->>H: NEEDS_RESEARCH: how does X work?
|
|
294
|
-
H->>R: spawn_research (researcher / deep-researcher)
|
|
295
|
-
R->>D: write findings file
|
|
296
|
-
R-->>H: one-line notice + path
|
|
297
|
-
H->>S: resume with file paths — never raw findings
|
|
298
|
-
S-->>H: structured return + named evidence
|
|
299
|
-
H->>D: update_assertion
|
|
300
|
-
H-->>U: Assertions: 2✓ 1○ 1✗ · open: A4
|
|
301
|
-
```
|
|
302
|
-
|
|
303
|
-
Every borrowed idea from another harness passes one test before it lands: *does this persistently enter the dispatcher context?* If yes, it goes to disk or a one-line status instead.
|
|
304
|
-
|
|
305
|
-
### What's in the box
|
|
306
|
-
|
|
307
|
-
- **Dispatcher grid** — a live dashboard of the fixed specialist team from `.pi/agents/teams.yaml`; `Alt+A` toggles the full dashboard and the compact view.
|
|
308
|
-
- **Specialist delegation** — `dispatch_agent` sends writable tasks to configured specialists; `/zoom` inspects a live timeline, and kill/restart manage running children.
|
|
309
|
-
- **Research helpers** — `spawn_research` / `/research` launch read-only recon: `researcher` on the fast tier for simple reads, `deep-researcher` on the deep-reasoning tier for hard, cross-cutting questions.
|
|
310
|
-
- **Verification Contract** — `set_assertions` / `update_assertion` / `get_assertions`, driven by the [`orchestrator`](agents/orchestrator.md) persona per the [orchestration-verification](skills/orchestration-verification/SKILL.md) skill.
|
|
311
|
-
- **Multi-model, multi-provider** — per-agent `model:` plus a `models:` switch list (`/agent-model <persona>`), with named fleet-wide profiles (`/models <profile>`). See [Model tiers](#model-tiers) below.
|
|
312
|
-
- **Peer-to-peer coms** — the dispatcher is itself a `coms` node: hand a session off to another main agent, or use a peer as a subagent.
|
|
313
|
-
- **herdr fleet layer** — [herdr](https://herdr.dev) is the fleet control plane: `just team-up` / `just hub-team` boot whole peer teams as tiled herdr workspaces, coms presence rides herdr's push events (no ping loops), `just team-down` / `team-resume` snapshot and restore teams **with their conversations**, and inside a herdr pane the dispatcher gets fleet tools (`herdr_spawn_peer` / `herdr_read_pane` / `herdr_close_pane` with human confirmation / `herdr_notify`) — all destructive fleet verbs are damage-control-blocked for specialists.
|
|
314
|
-
- **Claude Code as a peer** — the [coms bridge](docs/claude-code-coms-bridge.md) makes an interactive Claude Code pane a first-class bidirectional coms peer: pi agents reach it via `coms_send`, and Claude Code asks pi peers questions mid-task via `coms-cli` (`runner: claude-code` in peers.yaml spawns Claude + bridge with one command).
|
|
315
|
-
|
|
316
121
|

|
|
317
122
|
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
Personas don't hardcode one frontier model. Each declares a default `model:` plus a `models:` switch list, and the defaults follow a **three-tier policy** (current lineup: the OpenAI Codex `gpt-5.6` line, with Ollama cloud models in every switch list as local fallbacks):
|
|
321
|
-
|
|
322
|
-
| Tier | Current default | Used for | Default personas |
|
|
323
|
-
|---|---|---|---|
|
|
324
|
-
| **Deep reasoning** | `gpt-5.6-sol` | planning, architecture, security, hard recon | planner, plan-reviewer, architect, security-auditor, orchestrator, deep-researcher |
|
|
325
|
-
| **Workhorse** | `gpt-5.6-terra` | building, testing, review, docs, release, web audits | builder, test-engineer, code-reviewer, documenter, releaser, web-debugger, web-performance-auditor |
|
|
326
|
-
| **Fast recon** | `gpt-5.6-luna` | light read-only sweeps | researcher, bowser, most delegate sub-agents (scout, preflight, …) |
|
|
327
|
-
|
|
328
|
-
Switch per persona at runtime with `/agent-model <persona>[.<role>]`, or re-point the whole core team in one command with `/models <profile>` — the named profiles live in [.pi/agents/model-profiles.yaml](.pi/agents/model-profiles.yaml) (`max` → core team on the deep-reasoning tier, `budget` → core team on the workhorse tier). Herdr-spawned peers pin the same tiers in [.pi/agents/peers.yaml](.pi/agents/peers.yaml), where `plan-reviewer` and `code-reviewer` run as **Claude Code peers** (`runner: claude-code`) for cross-model review.
|
|
329
|
-
|
|
330
|
-
### Run it
|
|
123
|
+
Personas don't hardcode one frontier model — each declares a default plus a switch list on a three-tier policy (deep reasoning / workhorse / fast recon), switchable at runtime per persona (`/agent-model`) or fleet-wide (`/models <profile>`). `plan-reviewer` and `code-reviewer` can run as **Claude Code peers** for cross-model review.
|
|
331
124
|
|
|
332
125
|
```bash
|
|
333
|
-
just hub
|
|
334
|
-
just hub-solo
|
|
126
|
+
just hub # guarded dispatcher + research + coms + orchestrator persona
|
|
127
|
+
just hub-solo # same, without the coms layer
|
|
335
128
|
|
|
336
129
|
# fleet recipes (need a running herdr server — https://herdr.dev)
|
|
337
130
|
just team-up full # spawn addressable peers into a tiled herdr workspace
|
|
338
|
-
just hub-team docs # hub + a whole team in ONE workspace
|
|
339
|
-
just team-
|
|
340
|
-
just team-
|
|
341
|
-
just team-resume docs # rebuild the grid; pi peers continue their conversations
|
|
342
|
-
|
|
343
|
-
# scope a team to its own coms pool (isolates it from teams in other repos);
|
|
344
|
-
# the flag form matters: `project=af` is a just variable override and is IGNORED
|
|
345
|
-
just hub-team review --project af
|
|
346
|
-
just team-down review --project af
|
|
131
|
+
just hub-team docs # hub + a whole team in ONE workspace
|
|
132
|
+
just team-down docs # snapshot + close cleanly
|
|
133
|
+
just team-resume docs # rebuild the grid; pi peers continue their conversations
|
|
347
134
|
```
|
|
348
135
|
|
|
349
|
-
|
|
136
|
+
Deep dive: [agent-hub harness README](.pi/harnesses/agent-hub/README.md) (the full dispatch loop, coms layer, configuration) · [fleet hierarchy](docs/ARCHITECTURE.md#fleet-hierarchy) · [pi extension catalog](docs/pi-extensions.md) · [Claude Code coms bridge](docs/claude-code-coms-bridge.md) · [Hermes bridge](docs/coms-hermes-bridge.md) · [Hermes integration screenshots](hermes/README.md#integration-in-action).
|
|
350
137
|
|
|
351
138
|
---
|
|
352
139
|
|
|
353
|
-
##
|
|
140
|
+
## The lifecycle: commands and skills
|
|
354
141
|
|
|
355
|
-
|
|
142
|
+
```
|
|
143
|
+
DEFINE PLAN BUILD VERIFY REVIEW SHIP
|
|
144
|
+
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
|
|
145
|
+
│ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │
|
|
146
|
+
│Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │
|
|
147
|
+
└──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
|
|
148
|
+
/spec /plan /build /test /review /ship
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
10 slash commands map to the development lifecycle; each activates the right skills automatically:
|
|
356
152
|
|
|
357
153
|
| What you're doing | Command | Key principle |
|
|
358
154
|
|-------------------|---------|---------------|
|
|
359
155
|
| Define what to build | `/spec` | Spec before code |
|
|
360
156
|
| Plan how to build it | `/plan` | Small, atomic tasks |
|
|
361
|
-
| Build incrementally | `/build` | One slice at a time |
|
|
157
|
+
| Build incrementally | `/build` | One slice at a time (`/build auto` runs the whole plan in one approved pass) |
|
|
362
158
|
| Prove it works | `/test` | Tests are proof |
|
|
363
159
|
| Review before merge | `/review` | Improve code health |
|
|
364
160
|
| Audit web performance | `/webperf` | Measure before you optimize |
|
|
365
161
|
| Simplify the code | `/code-simplify` | Clarity over cleverness |
|
|
366
162
|
| Ship to production | `/ship` | Faster is safer |
|
|
367
|
-
| Orchestrate a team | `/orchestrate` | Main session drives
|
|
368
|
-
| Capture session lessons | `/compound` | Every session improves the next |
|
|
369
|
-
|
|
370
|
-
`/orchestrate` turns the main session into an **orchestrator** that drives a config-defined team of subagents (default `planner` + `builder`, no reviewer), routing them as a runtime roster and handling the `NEEDS_RESEARCH` / `PLAN_FILE` handoffs. The named teams live in `.claude/orchestrate-teams.yaml` (mirroring pi's `.pi/agents/teams.yaml`) and are switchable at runtime: `/orchestrate <team> "<task>"`. It ships for **claude-code** and **opencode** (`/af-orchestrate`); pi orchestrates via the `agent-hub` harness instead.
|
|
371
|
-
|
|
372
|
-
`/compound` is the **compound-engineering step**: at the end of a session it extracts the lessons worth keeping (corrections, recurring review findings, root causes), dedupes them against the project's own rule tree, and lands them as minimal diffs on the `rules:`/`docs:` targets declared in `.ai/agent-fleet-overrides.md` — so each session makes the next one better. It ships for **claude-code** and **opencode** (`/af-compound`); on pi the `agent-hub` harness provides its own `/compound` command, which gates the lesson list on the user and dispatches the `documenter` persona to apply it. The process is defined by [compound-learning](skills/compound-learning/SKILL.md).
|
|
373
|
-
|
|
374
|
-
Want fewer manual steps once the spec exists? **`/build auto`** generates the plan and implements every task in a single approved pass — you approve the plan once, then it runs autonomously. It removes the human stepping *between* tasks, not the verification: every task is still test-driven and committed individually, and it pauses on failures or risky steps.
|
|
375
|
-
|
|
376
|
-
Skills also activate automatically based on what you're doing — designing an API triggers `api-and-interface-design`, building UI triggers `frontend-ui-engineering`, and so on.
|
|
377
|
-
|
|
378
|
-
---
|
|
379
|
-
|
|
380
|
-
## All 29 Skills
|
|
381
|
-
|
|
382
|
-
The commands above are the entry points. Under the hood, they activate these 29 skills — each one a structured workflow with steps, verification gates, and anti-rationalization tables. You can also reference any skill directly.
|
|
383
|
-
|
|
384
|
-
Skills live in **two roots**: fleet-native and customized skills in [`skills/`](skills/), and the pristine upstream import in [`vendor/agent-skills-upstream/skills/`](vendor/agent-skills-upstream/). When a name exists in both, the native copy wins — see [docs/UPSTREAM-SKILLS.md](docs/UPSTREAM-SKILLS.md).
|
|
385
|
-
|
|
386
|
-
### Meta - Discover which skill applies
|
|
387
|
-
|
|
388
|
-
| Skill | What It Does | Use When |
|
|
389
|
-
|-------|-------------|----------|
|
|
390
|
-
| [using-agent-skills](skills/using-agent-skills/SKILL.md) | Maps incoming work to the right skill workflow and defines shared operating rules | Starting a session or deciding which skill applies |
|
|
391
|
-
|
|
392
|
-
### Define - Clarify what to build
|
|
393
|
-
|
|
394
|
-
| Skill | What It Does | Use When |
|
|
395
|
-
|-------|-------------|----------|
|
|
396
|
-
| [interview-me](skills/interview-me/SKILL.md) | One-question-at-a-time interview that extracts what the user actually wants instead of what they think they should want, until ~95% confidence | The ask is underspecified, or the user invokes "interview me" / "grill me" |
|
|
397
|
-
| [idea-refine](skills/idea-refine/SKILL.md) | Structured divergent/convergent thinking to turn vague ideas into concrete proposals | You have a rough concept that needs exploration |
|
|
398
|
-
| [spec-driven-development](skills/spec-driven-development/SKILL.md) | Write a PRD covering objectives, commands, structure, code style, testing, and boundaries before any code | Starting a new project, feature, or significant change |
|
|
399
|
-
|
|
400
|
-
### Plan - Break it down
|
|
401
|
-
|
|
402
|
-
| Skill | What It Does | Use When |
|
|
403
|
-
|-------|-------------|----------|
|
|
404
|
-
| [planning-and-task-breakdown](skills/planning-and-task-breakdown/SKILL.md) | Decompose specs into small, verifiable tasks with acceptance criteria and dependency ordering | You have a spec and need implementable units |
|
|
405
|
-
|
|
406
|
-
### Build - Write the code
|
|
407
|
-
|
|
408
|
-
| Skill | What It Does | Use When |
|
|
409
|
-
|-------|-------------|----------|
|
|
410
|
-
| [incremental-implementation](skills/incremental-implementation/SKILL.md) | Thin vertical slices - implement, test, verify, commit. Feature flags, safe defaults, rollback-friendly changes | Any change touching more than one file |
|
|
411
|
-
| [test-driven-development](vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md) | Red-Green-Refactor, test pyramid (80/15/5), test sizes, DAMP over DRY, Beyonce Rule, browser testing | Implementing logic, fixing bugs, or changing behavior |
|
|
412
|
-
| [context-engineering](skills/context-engineering/SKILL.md) | Feed agents the right information at the right time - rules files, context packing, MCP integrations | Starting a session, switching tasks, or when output quality drops |
|
|
413
|
-
| [source-driven-development](vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md) | Ground every framework decision in official documentation - verify, cite sources, flag what's unverified | You want authoritative, source-cited code for any framework or library |
|
|
414
|
-
| [doubt-driven-development](vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md) | Adversarial fresh-context review of every non-trivial decision in-flight - CLAIM → EXTRACT → DOUBT → RECONCILE → STOP, with optional user-authorized cross-model escalation | Stakes are high (production, security, irreversible), working in unfamiliar code, or a confident output is cheaper to verify now than to debug later |
|
|
415
|
-
| [frontend-ui-engineering](skills/frontend-ui-engineering/SKILL.md) | Component architecture, design systems, state management, responsive design, WCAG 2.1 AA accessibility | Building or modifying user-facing interfaces |
|
|
416
|
-
| [api-and-interface-design](vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md) | Contract-first design, Hyrum's Law, One-Version Rule, error semantics, boundary validation | Designing APIs, module boundaries, or public interfaces |
|
|
417
|
-
|
|
418
|
-
### Verify - Prove it works
|
|
419
|
-
|
|
420
|
-
| Skill | What It Does | Use When |
|
|
421
|
-
|-------|-------------|----------|
|
|
422
|
-
| [browser-testing-with-devtools](skills/browser-testing-with-devtools/SKILL.md) | Chrome DevTools MCP for live runtime data - DOM inspection, console logs, network traces, performance profiling | Building or debugging anything that runs in a browser |
|
|
423
|
-
| [debugging-and-error-recovery](vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md) | Five-step triage: reproduce, localize, reduce, fix, guard. Stop-the-line rule, safe fallbacks | Tests fail, builds break, or behavior is unexpected |
|
|
424
|
-
|
|
425
|
-
### Review - Quality gates before merge
|
|
426
|
-
|
|
427
|
-
| Skill | What It Does | Use When |
|
|
428
|
-
|-------|-------------|----------|
|
|
429
|
-
| [code-review-and-quality](skills/code-review-and-quality/SKILL.md) | Five-axis review, change sizing (~100 lines), severity labels (Nit/Optional/FYI), review speed norms, splitting strategies | Before merging any change |
|
|
430
|
-
| [code-simplification](vendor/agent-skills-upstream/skills/code-simplification/SKILL.md) | Chesterton's Fence, Rule of 500, reduce complexity while preserving exact behavior | Code works but is harder to read or maintain than it should be |
|
|
431
|
-
| [security-and-hardening](skills/security-and-hardening/SKILL.md) | OWASP Top 10 prevention, auth patterns, secrets management, dependency auditing, three-tier boundary system | Handling user input, auth, data storage, or external integrations |
|
|
432
|
-
| [performance-optimization](skills/performance-optimization/SKILL.md) | Measure-first approach - Core Web Vitals targets, profiling workflows, bundle analysis, anti-pattern detection | Performance requirements exist or you suspect regressions |
|
|
433
|
-
|
|
434
|
-
### Ship - Deploy with confidence
|
|
435
|
-
|
|
436
|
-
| Skill | What It Does | Use When |
|
|
437
|
-
|-------|-------------|----------|
|
|
438
|
-
| [git-workflow-and-versioning](skills/git-workflow-and-versioning/SKILL.md) | Trunk-based development, atomic commits, change sizing (~100 lines), the commit-as-save-point pattern | Making any code change (always) |
|
|
439
|
-
| [ci-cd-and-automation](vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md) | Shift Left, Faster is Safer, feature flags, quality gate pipelines, failure feedback loops | Setting up or modifying build and deploy pipelines |
|
|
440
|
-
| [deprecation-and-migration](skills/deprecation-and-migration/SKILL.md) | Code-as-liability mindset, compulsory vs advisory deprecation, migration patterns, zombie code removal | Removing old systems, migrating users, or sunsetting features |
|
|
441
|
-
| [documentation-and-adrs](vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md) | Architecture Decision Records, API docs, inline documentation standards - document the *why* | Making architectural decisions, changing APIs, or shipping features |
|
|
442
|
-
| [observability-and-instrumentation](vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md) | Structured logging, RED metrics, OpenTelemetry tracing, symptom-based alerting - instrument as you build | Adding telemetry, or shipping anything that runs in production |
|
|
443
|
-
| [shipping-and-launch](vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md) | Pre-launch checklists, feature flag lifecycle, staged rollouts, rollback procedures, monitoring setup | Preparing to deploy to production |
|
|
444
|
-
|
|
445
|
-
### Orchestrate - Keep multi-agent runs honest
|
|
446
|
-
|
|
447
|
-
| Skill | What It Does | Use When |
|
|
448
|
-
|-------|-------------|----------|
|
|
449
|
-
| [orchestration-verification](skills/orchestration-verification/SKILL.md) | The Verification Contract — dispatcher-owned acceptance assertions, a parity/touchpoint inventory for "behave like X" requests, structured upward returns with named evidence, and a requirement-regression reset | Orchestrating specialists through a dispatcher (the `agent-hub` harness / `orchestrator` persona), a "make X behave like existing Y" change, or a requirement that keeps coming back wrong |
|
|
450
|
-
| [peer-coms](skills/peer-coms/SKILL.md) | Makes Claude Code a first-class peer in the local coms pool — discover pi colleagues with `coms-cli list`, ask/delegate with `send --await`, answer inbound peer questions, never drive panes itself | Claude Code runs in a bridged herdr pane (see the [coms bridge](docs/claude-code-coms-bridge.md)), or an inbound `[coms message from …]` arrives |
|
|
451
|
-
|
|
452
|
-
This skill is the single canonical source for the four Verification-Contract artifacts. It is referenced — never restated — by the [`orchestrator`](agents/orchestrator.md) persona (which drives the [agent-hub harness](.pi/harnesses/agent-hub/), loaded by default via `just hub`), and conditionally by the [`builder`](agents/builder.md), [`test-engineer`](agents/test-engineer.md), and [`code-reviewer`](agents/code-reviewer.md) personas, whose structured returns report assertion status with evidence when the skill is installed.
|
|
453
|
-
|
|
454
|
-
### Learn - Compound the session's lessons
|
|
455
|
-
|
|
456
|
-
| Skill | What It Does | Use When |
|
|
457
|
-
|-------|-------------|----------|
|
|
458
|
-
| [compound-learning](skills/compound-learning/SKILL.md) | End-of-session compound pass — extracts lessons from session evidence (corrections, recurring findings, root causes), dedupes them index-first against the project's rule tree, and lands them as minimal, capped diffs on existing rules/docs files | A session ends with something worth keeping, the user says "compound", or the `documenter` persona receives a `/compound` dispatch |
|
|
459
|
-
|
|
460
|
-
This is the compound-engineering loop: the `/compound` command (claude-code, opencode, and the agent-hub harness on pi) runs this skill against the `rules:`/`docs:` targets from `.ai/agent-fleet-overrides.md`, with an approval gate and hard caps so the rule tree gets sharper instead of longer.
|
|
461
|
-
|
|
462
|
-
---
|
|
463
|
-
|
|
464
|
-
## Agent Personas
|
|
465
|
-
|
|
466
|
-
15 pre-configured specialist personas live in [agents/](agents/) — reusable subagent definitions your coding agent can delegate work to. Each persona is one Markdown file with YAML frontmatter; the canonical format is pi-flavored, and the setup commands transform it per target agent on install (see [Installing personas](#installing-personas)).
|
|
163
|
+
| Orchestrate a team | `/orchestrate` | Main session drives a config-defined subagent roster (claude-code/opencode; pi uses agent-hub) |
|
|
164
|
+
| Capture session lessons | `/compound` | Every session improves the next — lessons land as minimal diffs on your rule tree |
|
|
467
165
|
|
|
468
|
-
|
|
469
|
-
|---|---|---|---|---|
|
|
470
|
-
| [planner](agents/planner.md) | Architect — writes dependency-ordered PLAN files with acceptance criteria | rw (plan file only) | [planning-and-task-breakdown](skills/planning-and-task-breakdown/SKILL.md) | all |
|
|
471
|
-
| [plan-reviewer](agents/plan-reviewer.md) | Plan critic — stress-tests plans for gaps, ordering, feasibility | read-only | [planning-and-task-breakdown](skills/planning-and-task-breakdown/SKILL.md) | all |
|
|
472
|
-
| [builder](agents/builder.md) | Implementer — lands changes in small verifiable increments | rw | [incremental-implementation](skills/incremental-implementation/SKILL.md) | all |
|
|
473
|
-
| [code-reviewer](agents/code-reviewer.md) | Senior staff engineer — five-axis review before merge | read-only | [code-review-and-quality](skills/code-review-and-quality/SKILL.md) | all |
|
|
474
|
-
| [test-engineer](agents/test-engineer.md) | QA — test strategy, coverage analysis, the Prove-It pattern | rw | [test-driven-development](vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md) | all |
|
|
475
|
-
| [security-auditor](agents/security-auditor.md) | Security engineer — vulnerability detection, threat modeling, OWASP | read-only | [security-and-hardening](skills/security-and-hardening/SKILL.md) | all |
|
|
476
|
-
| [web-performance-auditor](agents/web-performance-auditor.md) | Web performance engineer — Core Web Vitals, loading, rendering, network audits (via `/webperf`) | read-only | [performance-optimization](skills/performance-optimization/SKILL.md) | all |
|
|
477
|
-
| [documenter](agents/documenter.md) | Tech writer — READMEs, inline docs, usage examples | rw | [documentation-and-adrs](vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md) | all |
|
|
478
|
-
| [architect](agents/architect.md) | System architect — design decisions and migration strategy | rw | [api-and-interface-design](vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md) | all |
|
|
479
|
-
| [releaser](agents/releaser.md) | Release owner — changeset → version-bump → tag flow | rw | [git-workflow-and-versioning](skills/git-workflow-and-versioning/SKILL.md), [shipping-and-launch](vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md) | all |
|
|
480
|
-
| [researcher](agents/researcher.md) | Fast read-only recon — reports findings with file:line citations | read-only | — | all |
|
|
481
|
-
| [deep-researcher](agents/deep-researcher.md) | Deep recon for hard, cross-cutting questions | read-only | — | all |
|
|
482
|
-
| [bowser](agents/bowser.md) | Headless browser automation via Playwright CLI | rw | — | pi only |
|
|
483
|
-
| [web-debugger](agents/web-debugger.md) | Interactive headful Chrome debugging via Chrome DevTools MCP (coms peer) | rw | [browser-testing-with-devtools](skills/browser-testing-with-devtools/SKILL.md) | pi only |
|
|
484
|
-
| [orchestrator](agents/orchestrator.md) | Verification-Contract agent-hub dispatcher — owns acceptance assertions, parity inventory, runtime-proof gate | — | [orchestration-verification](skills/orchestration-verification/SKILL.md) | pi only |
|
|
166
|
+
Under the hood are **29 skills** — each a structured workflow with steps, verification gates, and anti-rationalization tables (never vague advice). Skills also activate automatically from what you're doing: designing an API triggers `api-and-interface-design`, building UI triggers `frontend-ui-engineering`.
|
|
485
167
|
|
|
486
|
-
|
|
168
|
+
- **Define:** [interview-me](skills/interview-me/SKILL.md) · [idea-refine](skills/idea-refine/SKILL.md) · [spec-driven-development](skills/spec-driven-development/SKILL.md)
|
|
169
|
+
- **Plan:** [planning-and-task-breakdown](skills/planning-and-task-breakdown/SKILL.md)
|
|
170
|
+
- **Build:** [incremental-implementation](skills/incremental-implementation/SKILL.md) · [test-driven-development](vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md) · [context-engineering](skills/context-engineering/SKILL.md) · [source-driven-development](vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md) · [doubt-driven-development](vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md) · [frontend-ui-engineering](skills/frontend-ui-engineering/SKILL.md) · [api-and-interface-design](vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md)
|
|
171
|
+
- **Verify:** [browser-testing-with-devtools](skills/browser-testing-with-devtools/SKILL.md) · [debugging-and-error-recovery](vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md)
|
|
172
|
+
- **Review:** [code-review-and-quality](skills/code-review-and-quality/SKILL.md) · [code-simplification](vendor/agent-skills-upstream/skills/code-simplification/SKILL.md) · [security-and-hardening](skills/security-and-hardening/SKILL.md) · [performance-optimization](skills/performance-optimization/SKILL.md)
|
|
173
|
+
- **Ship:** [git-workflow-and-versioning](skills/git-workflow-and-versioning/SKILL.md) · [ci-cd-and-automation](vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md) · [deprecation-and-migration](skills/deprecation-and-migration/SKILL.md) · [documentation-and-adrs](vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md) · [observability-and-instrumentation](vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md) · [shipping-and-launch](vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md)
|
|
174
|
+
- **Orchestrate:** [orchestration-verification](skills/orchestration-verification/SKILL.md) · [peer-coms](skills/peer-coms/SKILL.md)
|
|
175
|
+
- **Learn:** [compound-learning](skills/compound-learning/SKILL.md) · **Onboard:** [guided-workspace-setup](skills/guided-workspace-setup/SKILL.md) · **Meta:** [using-agent-skills](skills/using-agent-skills/SKILL.md) · [designing-agents](skills/designing-agents/SKILL.md)
|
|
487
176
|
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
### Installing personas
|
|
491
|
-
|
|
492
|
-
`/setup-agent-fleet` offers every persona available for the chosen agent and installs it to the right place, transforming the frontmatter deterministically (via `npx @chankov/agent-fleet transform-persona`):
|
|
493
|
-
|
|
494
|
-
| Agent | Installed to | Transformation |
|
|
495
|
-
|---|---|---|
|
|
496
|
-
| Claude Code | `.claude/agents/<name>.md` | tools renamed (`read→Read`, `find/ls→Glob`, …), model mapped to `opus`/`sonnet`/`haiku`, agent-hub keys dropped |
|
|
497
|
-
| OpenCode | `.opencode/agent/<name>.md` | `mode: subagent` added, write-capable tools denied per persona, agent-hub keys dropped |
|
|
498
|
-
| pi | `agents/<name>.md` | none — the canonical format is the pi format |
|
|
499
|
-
|
|
500
|
-
When this repo is installed as a Claude Code plugin, the `agents/` directory is auto-discovered — every non-pi-only persona is immediately available as a subagent without a separate install.
|
|
501
|
-
|
|
502
|
-
### Teams of subagents
|
|
503
|
-
|
|
504
|
-
The personas are designed to be composed, not used one at a time. For the full hub → team → agent → sub-agent picture, see [Fleet hierarchy](#fleet-hierarchy).
|
|
505
|
-
|
|
506
|
-
- **pi (agent-hub harness)** — the dispatcher spawns personas as specialist agents on a named team from [.pi/agents/teams.yaml](.pi/agents/teams.yaml): `default` (plan → build → review → document), `debug`, `frontend`, `security`, `hotfix`, `release`, `info`. `just team-up <name>` instead spawns [peers.yaml](.pi/agents/peers.yaml) personas (e.g. `architect`, `releaser`) as standalone, addressable peers in a tiled [herdr](https://herdr.dev) workspace (requires a running herdr server). Personas with a `subagents:` block (e.g. `code-reviewer`'s `preflight`/`quality`/`perf`/`docs`) additionally delegate slices of their own job to pre-configured children.
|
|
507
|
-
- **Claude Code** — installed personas are native subagents: the main agent delegates to them automatically based on their `description`, or you invoke one explicitly ("use the code-reviewer subagent on this diff"). Chain them along the lifecycle: `/plan` work goes to `planner`, then `plan-reviewer` critiques, `builder` implements, and `code-reviewer` + `security-auditor` gate the merge. `/orchestrate` runs a config-defined roster (see `.claude/orchestrate-teams.yaml`).
|
|
508
|
-
- **OpenCode** — installed personas are subagents (`mode: subagent`): mention one with `@<name>` to invoke it directly, or let the primary agent delegate to it by description. `/af-orchestrate` mirrors the Claude Code roster pattern.
|
|
509
|
-
|
|
510
|
-
---
|
|
511
|
-
|
|
512
|
-
## Reference Checklists
|
|
513
|
-
|
|
514
|
-
Quick-reference material that skills pull in when needed:
|
|
515
|
-
|
|
516
|
-
| Reference | Covers |
|
|
517
|
-
|-----------|--------|
|
|
518
|
-
| [definition-of-done.md](references/definition-of-done.md) | Project-wide standing bar every change clears, contrasted with per-task acceptance criteria |
|
|
519
|
-
| [testing-patterns.md](references/testing-patterns.md) | Test structure, naming, mocking, React/API/E2E examples, anti-patterns |
|
|
520
|
-
| [security-checklist.md](references/security-checklist.md) | Pre-commit checks, auth, input validation, headers, CORS, OWASP Top 10 |
|
|
521
|
-
| [performance-checklist.md](references/performance-checklist.md) | Core Web Vitals targets, frontend/backend checklists, measurement commands |
|
|
522
|
-
| [accessibility-checklist.md](references/accessibility-checklist.md) | Keyboard nav, screen readers, visual design, ARIA, testing tools |
|
|
523
|
-
| [observability-checklist.md](references/observability-checklist.md) | On-call questions, structured logging, RED/USE metrics, tracing, symptom-based alerting, pre-launch gate |
|
|
524
|
-
| [orchestration-patterns.md](references/orchestration-patterns.md) | Endorsed multi-persona orchestration patterns, anti-patterns, and the "personas don't invoke personas" rule |
|
|
525
|
-
| [fleet-coordination-patterns.md](references/fleet-coordination-patterns.md) | Runtime coordination protocols between running agents: sentinels, push over polling, barriers, fan-out/fan-in digests, racing with cancellation |
|
|
526
|
-
| [prompting-patterns.md](references/prompting-patterns.md) | Prompt-engineering best practices for authoring personas, commands, skills, pi harnesses, and rule files (Anthropic/OpenAI sourced) |
|
|
527
|
-
|
|
528
|
-
---
|
|
529
|
-
|
|
530
|
-
## How Skills Work
|
|
531
|
-
|
|
532
|
-
Every skill follows a consistent anatomy:
|
|
533
|
-
|
|
534
|
-
```
|
|
535
|
-
┌─────────────────────────────────────────────────┐
|
|
536
|
-
│ SKILL.md │
|
|
537
|
-
│ │
|
|
538
|
-
│ ┌─ Frontmatter ─────────────────────────────┐ │
|
|
539
|
-
│ │ name: lowercase-hyphen-name │ │
|
|
540
|
-
│ │ description: Guides agents through [task].│ │
|
|
541
|
-
│ │ Use when… │ │
|
|
542
|
-
│ └───────────────────────────────────────────┘ │
|
|
543
|
-
│ Overview → What this skill does │
|
|
544
|
-
│ When to Use → Triggering conditions │
|
|
545
|
-
│ Process → Step-by-step workflow │
|
|
546
|
-
│ Rationalizations → Excuses + rebuttals │
|
|
547
|
-
│ Red Flags → Signs something's wrong │
|
|
548
|
-
│ Verification → Evidence requirements │
|
|
549
|
-
└─────────────────────────────────────────────────┘
|
|
550
|
-
```
|
|
551
|
-
|
|
552
|
-
**Key design choices:**
|
|
553
|
-
|
|
554
|
-
- **Process, not prose.** Skills are workflows agents follow, not reference docs they read. Each has steps, checkpoints, and exit criteria.
|
|
555
|
-
- **Anti-rationalization.** Every skill includes a table of common excuses agents use to skip steps (e.g., "I'll add tests later") with documented counter-arguments.
|
|
556
|
-
- **Verification is non-negotiable.** Every skill ends with evidence requirements - tests passing, build output, runtime data. "Seems right" is never sufficient.
|
|
557
|
-
- **Progressive disclosure.** The `SKILL.md` is the entry point. Supporting references load only when needed, keeping token usage minimal.
|
|
177
|
+
Full catalog with descriptions and triggers: **[docs/skills-catalog.md](docs/skills-catalog.md)**. Format spec: [docs/skill-anatomy.md](docs/skill-anatomy.md).
|
|
558
178
|
|
|
559
179
|
---
|
|
560
180
|
|
|
561
|
-
##
|
|
562
|
-
|
|
563
|
-
A few skills and the pi `agent-hub` harness need project-specific facts — where specs and plans are saved, how to start a dev server, whether the agent may create branches, or which user-facing language the dispatcher should use. Sensible defaults are built in, but any project can override them with a single file at `.ai/agent-fleet-overrides.md`:
|
|
564
|
-
|
|
565
|
-
| Reader | What you can override |
|
|
566
|
-
|--------|----------------------|
|
|
567
|
-
| `spec-driven-development` | Spec output directory and naming |
|
|
568
|
-
| `planning-and-task-breakdown` | Plan output directory, naming, embedded vs separate todo |
|
|
569
|
-
| `browser-testing-with-devtools` | Dev-server command, base URL, auth flow and roles (required — no default) |
|
|
570
|
-
| `git-workflow-and-versioning` | Whether the agent may create branches (default: never) |
|
|
571
|
-
| `agent-hub` (legacy alias: `## agent-team`) | Dispatcher user-facing language (default: English), per-persona models/thinking/delegation, project `rules:` folders (HOW — resolved index-first) and `docs:` entry points (WHAT/WHY orientation) |
|
|
572
|
-
| `agent-fleet doctor` (`## env`) | Env-var **names** the project expects; the doctor warns when one is unset |
|
|
573
|
-
|
|
574
|
-
See [docs/agent-fleet-setup.md](docs/agent-fleet-setup.md) for the file format and a copy-paste template. `agent-fleet doctor` also validates the whole file (unknown sections/keys, invalid values, missing `rules:` folders and `docs:` entry points) as advisory warnings — typos otherwise fall back to defaults silently.
|
|
181
|
+
## Agent personas
|
|
575
182
|
|
|
576
|
-
|
|
183
|
+
15 pre-configured specialist personas live in [`agents/`](agents/) — reusable subagent definitions your coding agent delegates work to: `planner`, `plan-reviewer`, `builder`, `code-reviewer`, `test-engineer`, `security-auditor`, `web-performance-auditor`, `documenter`, `architect`, `releaser`, `researcher`, `deep-researcher`, plus the pi-only `bowser`, `web-debugger`, and `orchestrator`.
|
|
577
184
|
|
|
578
|
-
|
|
185
|
+
Each persona is one Markdown file; the canonical format is pi-flavored and `/setup-agent-fleet` transforms it per target agent on install (Claude Code subagents, OpenCode `mode: subagent`, pi as-is). Personas are the *who*, skills are the *how* — each carries a conditional hook to its primary skill, and they compose into teams under the hub or via `/orchestrate`.
|
|
579
186
|
|
|
580
|
-
|
|
581
|
-
agent-fleet/
|
|
582
|
-
├── skills/ # 19 Agent Fleet-native + customized skills (SKILL.md per directory)
|
|
583
|
-
│ ├── orchestration-verification/ # Orchestrate: the Verification Contract
|
|
584
|
-
│ ├── peer-coms/ # Orchestrate: Claude Code as a coms peer
|
|
585
|
-
│ ├── compound-learning/ # Learn: land session lessons on the rule tree
|
|
586
|
-
│ ├── guided-workspace-setup/ # Onboard: the LLM-driven installer
|
|
587
|
-
│ ├── designing-agents/ # Meta: author skills/personas/harnesses
|
|
588
|
-
│ ├── spec-driven-development/ # … + 14 upstream-derived skills customized for
|
|
589
|
-
│ ├── git-workflow-and-versioning/ # Agent Fleet (agent operating rules, review
|
|
590
|
-
│ └── … # gates); these shadow their vendored originals
|
|
591
|
-
├── vendor/agent-skills-upstream/ # Pristine upstream import (24 skills + LICENSE)
|
|
592
|
-
│ # at a pinned SHA — see docs/UPSTREAM-SKILLS.md
|
|
593
|
-
├── agents/ # 15 reusable agent personas
|
|
594
|
-
├── references/ # 9 supplementary checklists
|
|
595
|
-
├── hooks/ # Session lifecycle hooks + the coms Stop hook
|
|
596
|
-
├── scripts/ # Fleet tooling: team-up, hub-team, team-snapshot/resume,
|
|
597
|
-
│ # coms-cli, coms-claude-bridge, coms-hermes-bridge
|
|
598
|
-
│ # (+ pure modules in scripts/lib/)
|
|
599
|
-
├── hermes/ # Hermes-facing skills (hub-conductor, hub-liaison)
|
|
600
|
-
├── .claude/commands/ # 12 Claude slash commands
|
|
601
|
-
├── .pi/prompts/ # 7 pi prompt-template commands
|
|
602
|
-
├── .pi/agents/ # teams.yaml · peers.yaml · model-profiles.yaml ·
|
|
603
|
-
│ # chains + dispatch policy for the orchestration harnesses
|
|
604
|
-
├── .pi/harnesses/ # Selectable pi session harnesses (agent-hub, coms,
|
|
605
|
-
│ # damage-control, ask-user-remote)
|
|
606
|
-
│ # + the shared herdr client/presence lib (.pi/harnesses/lib/)
|
|
607
|
-
└── docs/ # Architecture, setup guides, coms/Hermes bridges,
|
|
608
|
-
# upstream vendoring policy
|
|
609
|
-
```
|
|
187
|
+
Full roster, skill hooks, install matrix, and team composition: **[docs/agents.md](docs/agents.md)**.
|
|
610
188
|
|
|
611
189
|
---
|
|
612
190
|
|
|
613
191
|
## Why Agent Fleet?
|
|
614
192
|
|
|
615
|
-
|
|
193
|
+
One coding agent is an assistant; a *fleet* is a team you operate. Agent Fleet exists for the moment a single session stops being enough — when you want a dispatcher driving specialists under a Verification Contract, whole peer teams you can snapshot and resume, Claude Code panes that answer pi agents mid-task, and a phone-reachable human in the loop.
|
|
616
194
|
|
|
617
|
-
|
|
195
|
+
Discipline is the other half. AI coding agents default to the shortest path — skipping specs, tests, and security reviews. The skill library gives every agent in the fleet the same discipline senior engineers bring to production code, baking in practices from [Software Engineering at Google](https://abseil.io/resources/swe-book) and Google's [engineering practices guide](https://google.github.io/eng-practices/): Hyrum's Law in API design, the test pyramid and Beyonce Rule in testing, change sizing in review, Chesterton's Fence in simplification, trunk-based development in git workflow.
|
|
618
196
|
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
Skills bake in best practices from Google's engineering culture — including concepts from [Software Engineering at Google](https://abseil.io/resources/swe-book) and Google's [engineering practices guide](https://google.github.io/eng-practices/). You'll find Hyrum's Law in API design, the Beyonce Rule and test pyramid in testing, change sizing and review speed norms in code review, Chesterton's Fence in simplification, trunk-based development in git workflow, Shift Left and feature flags in CI/CD, and a dedicated deprecation skill treating code as a liability. These aren't abstract principles — they're embedded directly into the step-by-step workflows agents follow.
|
|
197
|
+
**How it compares:** wondering how this stacks up against [Superpowers](https://github.com/obra/superpowers) or [Matt Pocock's skills](https://github.com/mattpocock/skills)? See **[docs/comparison.md](docs/comparison.md)** — an honest, side-by-side look, including a controlled [head-to-head experiment](https://www.linkedin.com/pulse/superpowers-vs-agent-skills-faster-shipping-safer-reasoning-om-mishra-dzakf/).
|
|
622
198
|
|
|
623
199
|
---
|
|
624
200
|
|
|
625
|
-
##
|
|
201
|
+
## Documentation
|
|
626
202
|
|
|
627
|
-
|
|
203
|
+
| Doc | Covers |
|
|
204
|
+
|---|---|
|
|
205
|
+
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Runtime layers, fleet hierarchy, module map, external dependencies |
|
|
206
|
+
| [docs/getting-started.md](docs/getting-started.md) | First session walkthrough |
|
|
207
|
+
| [docs/skills-catalog.md](docs/skills-catalog.md) | All 29 skills with descriptions and triggers |
|
|
208
|
+
| [docs/agents.md](docs/agents.md) | All 15 personas: roster, skill hooks, install matrix, teams |
|
|
209
|
+
| [docs/pi-setup.md](docs/pi-setup.md) · [docs/pi-extensions.md](docs/pi-extensions.md) | pi install paths, harnesses, and utility extensions |
|
|
210
|
+
| [docs/opencode-setup.md](docs/opencode-setup.md) | OpenCode setup and `af-*` commands |
|
|
211
|
+
| [docs/agent-fleet-setup.md](docs/agent-fleet-setup.md) | Per-project overrides (`.ai/agent-fleet-overrides.md`) — spec/plan paths, dev server, branch policy, dispatcher language, rules/docs targets |
|
|
212
|
+
| [docs/claude-code-coms-bridge.md](docs/claude-code-coms-bridge.md) · [docs/coms-hermes-bridge.md](docs/coms-hermes-bridge.md) · [docs/codex-remote-conductor.md](docs/codex-remote-conductor.md) | Claude Code as a coms peer · phone relay · experimental Codex remote-control operator runbook |
|
|
213
|
+
| [docs/npm-install.md](docs/npm-install.md) | CLI reference, versioning, update flow |
|
|
214
|
+
| [references/](references/) | 9 checklists skills pull in: testing, security, performance, accessibility, observability, orchestration + fleet-coordination + prompting patterns |
|
|
628
215
|
|
|
629
216
|
---
|
|
630
217
|
|
|
631
|
-
## Credits &
|
|
218
|
+
## Credits & origins
|
|
632
219
|
|
|
633
|
-
Agent Fleet
|
|
220
|
+
Agent Fleet started as a customized fork of [Addy Osmani](https://github.com/addyosmani)'s [`agent-skills`](https://github.com/addyosmani/agent-skills) library, with pi session-harness patterns from [IndyDevDan](https://github.com/disler)'s [`pi-vs-claude-code`](https://github.com/disler/pi-vs-claude-code) (MIT) growing alongside it. As orchestration became the center of gravity, it split into a standalone project — with the upstream relationship kept honest: Addy's library is vendored **pristine at a pinned SHA** under [`vendor/agent-skills-upstream/`](vendor/agent-skills-upstream/) ([policy](docs/UPSTREAM-SKILLS.md)), and the ported harnesses credit their origin in [docs/pi-extensions.md](docs/pi-extensions.md). Split record: [docs/MIGRATION-agent-fleet.md](docs/MIGRATION-agent-fleet.md).
|
|
634
221
|
|
|
635
222
|
| Person | Handle | What we draw from |
|
|
636
223
|
| --- | --- | --- |
|
|
637
|
-
| **IndyDevDan** | [@disler](https://github.com/disler) | Pi session harness patterns
|
|
638
|
-
| **Addy Osmani** | [@addyosmani](https://github.com/addyosmani) | Production-grade lifecycle skills
|
|
224
|
+
| **IndyDevDan** | [@disler](https://github.com/disler) | Pi session harness patterns — foundation for `agent-hub`, `coms`, `damage-control` |
|
|
225
|
+
| **Addy Osmani** | [@addyosmani](https://github.com/addyosmani) | Production-grade lifecycle skills — the vendored upstream skill library |
|
|
639
226
|
|
|
640
227
|
Thank you both for the inspiration and for shipping work others can build on.
|
|
641
228
|
|
|
642
229
|
---
|
|
643
230
|
|
|
644
|
-
## Built on (dependencies & tools)
|
|
645
|
-
|
|
646
|
-
These are the external systems Agent Fleet assumes or integrates with — not npm packages, but the **runtime stack** the fleet operates on top of.
|
|
647
|
-
|
|
648
|
-
| Dependency | Role | Required? |
|
|
649
|
-
| --- | --- | --- |
|
|
650
|
-
| **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for full fleet mode (`just hub`) |
|
|
651
|
-
| **[herdr](https://herdr.dev)** | Workspace control plane: tiled peer panes, presence push events, team snapshot/resume | Yes for fleet recipes (`just team-up`, `just hub-team`, …); optional for solo hub |
|
|
652
|
-
| **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | First-class peer via the [coms bridge](docs/claude-code-coms-bridge.md); also a supported install target for skills/personas | Optional peer / alternate harness |
|
|
653
|
-
| **[OpenCode](https://opencode.ai)** | Skill-driven execution target (`AGENTS.md` + `skill` tool); `af-*` slash commands | Optional alternate harness |
|
|
654
|
-
| **Hermes** | Remote human-in-the-loop (Telegram relay for hub questions) — [coms-hermes-bridge](docs/coms-hermes-bridge.md) | Optional |
|
|
655
|
-
| **[addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)** | Upstream skill library (manually vendored) | Bundled (vendored) |
|
|
656
|
-
| **[disler/pi-vs-claude-code](https://github.com/disler/pi-vs-claude-code)** | Source inspiration / MIT port origin for pi harnesses | Design lineage (ported in-repo) |
|
|
657
|
-
| **LLM providers** | Models per persona (`model:` / `models:` in agent frontmatter) — e.g. OpenAI Codex, GitHub Copilot, Ollama, … | Yes (at least one provider your agents can call) |
|
|
658
|
-
| **Chrome DevTools MCP** / **Playwright Agent CLI** | Browser verify (`browser-testing-with-devtools`) and headless automation (`bowser`) | Optional, feature-specific |
|
|
659
|
-
| **Node.js + npm** | CLI (`npx @chankov/agent-fleet`), package install, `just` recipes | Yes for install & tooling |
|
|
660
|
-
|
|
661
|
-
Architecture map: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
|
|
662
|
-
|
|
663
|
-
---
|
|
664
|
-
|
|
665
231
|
## Contributing
|
|
666
232
|
|
|
667
|
-
Skills should be **specific** (actionable steps
|
|
668
|
-
|
|
669
|
-
See [docs/skill-anatomy.md](docs/skill-anatomy.md) for the format specification and [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
|
670
|
-
|
|
671
|
-
---
|
|
233
|
+
Skills should be **specific** (actionable steps), **verifiable** (clear exit criteria with evidence), **battle-tested** (based on real workflows), and **minimal** (only what's needed to guide the agent). See [docs/skill-anatomy.md](docs/skill-anatomy.md) and [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
672
234
|
|
|
673
235
|
## License
|
|
674
236
|
|