@chankov/agent-fleet 0.0.5 → 0.0.6
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/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.pi/extensions/btw/README.md +10 -10
- package/.pi/extensions/btw/index.ts +11 -11
- package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
- package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/extensions/pi-voice-stt/README.md +7 -7
- package/.pi/extensions/pi-voice-stt/index.ts +4 -4
- package/.pi/harnesses/agent-hub/README.md +58 -58
- package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
- package/.pi/harnesses/agent-hub/delegate.ts +3 -3
- package/.pi/harnesses/agent-hub/drift-watchdog.js +1 -1
- package/.pi/harnesses/agent-hub/index.ts +248 -248
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/run-budget.js +1 -1
- package/.pi/harnesses/coms/README.md +2 -2
- package/.pi/harnesses/coms/index.ts +13 -13
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +9 -9
- package/.pi/harnesses/damage-control-continue/index.ts +11 -11
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
- package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
- package/.versions/0.0.6/.claude/commands/build.md +44 -0
- package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.6/.claude/commands/plan.md +16 -0
- package/.versions/0.0.6/.claude/commands/prime.md +22 -0
- package/.versions/0.0.6/.claude/commands/review.md +16 -0
- package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.6/.claude/commands/ship.md +72 -0
- package/.versions/0.0.6/.claude/commands/spec.md +15 -0
- package/.versions/0.0.6/.claude/commands/test.md +19 -0
- package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.6/.pi/extensions/package.json +9 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.6/.version +1 -0
- package/.versions/0.0.6/agents/architect.md +23 -0
- package/.versions/0.0.6/agents/bowser.md +26 -0
- package/.versions/0.0.6/agents/builder.md +53 -0
- package/.versions/0.0.6/agents/code-reviewer.md +205 -0
- package/.versions/0.0.6/agents/deep-researcher.md +31 -0
- package/.versions/0.0.6/agents/documenter.md +18 -0
- package/.versions/0.0.6/agents/orchestrator.md +54 -0
- package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.6/agents/planner.md +69 -0
- package/.versions/0.0.6/agents/releaser.md +24 -0
- package/.versions/0.0.6/agents/researcher.md +28 -0
- package/.versions/0.0.6/agents/security-auditor.md +166 -0
- package/.versions/0.0.6/agents/test-engineer.md +151 -0
- package/.versions/0.0.6/agents/web-debugger.md +42 -0
- package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.6/docs/getting-started.md +183 -0
- package/.versions/0.0.6/docs/npm-install.md +337 -0
- package/.versions/0.0.6/docs/opencode-setup.md +249 -0
- package/.versions/0.0.6/docs/pi-extensions.md +293 -0
- package/.versions/0.0.6/docs/pi-setup.md +476 -0
- package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.6/hermes/README.md +231 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.6/hooks/hooks.json +14 -0
- package/.versions/0.0.6/hooks/session-start.sh +74 -0
- package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.6/justfile +245 -0
- package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.6/references/definition-of-done.md +67 -0
- package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.6/references/observability-checklist.md +91 -0
- package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.6/references/performance-checklist.md +153 -0
- package/.versions/0.0.6/references/prompting-patterns.md +380 -0
- package/.versions/0.0.6/references/security-checklist.md +179 -0
- package/.versions/0.0.6/references/testing-patterns.md +236 -0
- package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.6/scripts/fleet.ts +141 -0
- package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.6/scripts/team-up.ts +351 -0
- package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +6 -0
- package/README.md +24 -23
- package/agents/documenter.md +1 -1
- package/agents/releaser.md +1 -1
- package/bin/cli.js +20 -20
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/docs/ARCHITECTURE.md +4 -4
- package/docs/agent-fleet-setup.md +11 -11
- package/docs/coms-hermes-bridge.md +8 -8
- package/docs/npm-install.md +21 -21
- package/docs/pi-extensions.md +7 -7
- package/docs/pi-setup.md +51 -47
- package/hermes/README.md +1 -1
- package/package.json +1 -1
- package/references/fleet-coordination-patterns.md +2 -2
- package/skills/browser-testing-with-devtools/SKILL.md +1 -1
- package/skills/compound-learning/SKILL.md +3 -3
- package/skills/guided-workspace-setup/SKILL.md +16 -14
- /package/.pi/prompts/{build.md → af-build.md} +0 -0
- /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
- /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
- /package/.pi/prompts/{review.md → af-review.md} +0 -0
- /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
- /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
- /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
- /package/.pi/prompts/{test.md → af-test.md} +0 -0
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: using-agent-skills
|
|
3
|
+
description: Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Using Agent Skills
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
|
|
11
|
+
|
|
12
|
+
## Skill Discovery
|
|
13
|
+
|
|
14
|
+
When a task arrives, identify the development phase and apply the corresponding skill:
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
Task arrives
|
|
18
|
+
│
|
|
19
|
+
├── Don't know what you want yet? ──────→ interview-me
|
|
20
|
+
├── Have a rough concept, need variants? → idea-refine
|
|
21
|
+
├── New project/feature/change? ──→ spec-driven-development
|
|
22
|
+
├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
|
|
23
|
+
├── Implementing code? ────────────→ incremental-implementation
|
|
24
|
+
│ ├── UI work? ─────────────────→ frontend-ui-engineering
|
|
25
|
+
│ ├── API work? ────────────────→ api-and-interface-design
|
|
26
|
+
│ ├── Need better context? ─────→ context-engineering
|
|
27
|
+
│ ├── Need doc-verified code? ───→ source-driven-development
|
|
28
|
+
│ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
|
|
29
|
+
├── Writing/running tests? ────────→ test-driven-development
|
|
30
|
+
│ └── Browser-based? ───────────→ browser-testing-with-devtools
|
|
31
|
+
├── Something broke? ──────────────→ debugging-and-error-recovery
|
|
32
|
+
├── Reviewing code? ───────────────→ code-review-and-quality
|
|
33
|
+
│ ├── Too complex? ─────────────→ code-simplification
|
|
34
|
+
│ ├── Security concerns? ───────→ security-and-hardening
|
|
35
|
+
│ └── Performance concerns? ────→ performance-optimization
|
|
36
|
+
├── Committing/branching? ─────────→ git-workflow-and-versioning
|
|
37
|
+
├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
|
|
38
|
+
├── Deprecating/migrating? ────────→ deprecation-and-migration
|
|
39
|
+
├── Writing docs/ADRs? ───────────→ documentation-and-adrs
|
|
40
|
+
├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
|
|
41
|
+
└── Deploying/launching? ─────────→ shipping-and-launch
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Core Operating Behaviors
|
|
45
|
+
|
|
46
|
+
These behaviors apply at all times, across all skills. They are non-negotiable.
|
|
47
|
+
|
|
48
|
+
### 1. Surface Assumptions
|
|
49
|
+
|
|
50
|
+
Before implementing anything non-trivial, explicitly state your assumptions:
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
ASSUMPTIONS I'M MAKING:
|
|
54
|
+
1. [assumption about requirements]
|
|
55
|
+
2. [assumption about architecture]
|
|
56
|
+
3. [assumption about scope]
|
|
57
|
+
→ Correct me now or I'll proceed with these.
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
|
|
61
|
+
|
|
62
|
+
### 2. Manage Confusion Actively
|
|
63
|
+
|
|
64
|
+
When you encounter inconsistencies, conflicting requirements, or unclear specifications:
|
|
65
|
+
|
|
66
|
+
1. **STOP.** Do not proceed with a guess.
|
|
67
|
+
2. Name the specific confusion.
|
|
68
|
+
3. Present the tradeoff or ask the clarifying question.
|
|
69
|
+
4. Wait for resolution before continuing.
|
|
70
|
+
|
|
71
|
+
**Bad:** Silently picking one interpretation and hoping it's right.
|
|
72
|
+
**Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
|
|
73
|
+
|
|
74
|
+
### 3. Push Back When Warranted
|
|
75
|
+
|
|
76
|
+
You are not a yes-machine. When an approach has clear problems:
|
|
77
|
+
|
|
78
|
+
- Point out the issue directly
|
|
79
|
+
- Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
|
|
80
|
+
- Propose an alternative
|
|
81
|
+
- Accept the human's decision if they override with full information
|
|
82
|
+
|
|
83
|
+
Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
|
|
84
|
+
|
|
85
|
+
### 4. Enforce Simplicity
|
|
86
|
+
|
|
87
|
+
Your natural tendency is to overcomplicate. Actively resist it.
|
|
88
|
+
|
|
89
|
+
Before finishing any implementation, ask:
|
|
90
|
+
- Can this be done in fewer lines?
|
|
91
|
+
- Are these abstractions earning their complexity?
|
|
92
|
+
- Would a staff engineer look at this and say "why didn't you just..."?
|
|
93
|
+
|
|
94
|
+
If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
|
|
95
|
+
|
|
96
|
+
### 5. Maintain Scope Discipline
|
|
97
|
+
|
|
98
|
+
Touch only what you're asked to touch.
|
|
99
|
+
|
|
100
|
+
Do NOT:
|
|
101
|
+
- Remove comments you don't understand
|
|
102
|
+
- "Clean up" code orthogonal to the task
|
|
103
|
+
- Refactor adjacent systems as a side effect
|
|
104
|
+
- Delete code that seems unused without explicit approval
|
|
105
|
+
- Add features not in the spec because they "seem useful"
|
|
106
|
+
|
|
107
|
+
Your job is surgical precision, not unsolicited renovation.
|
|
108
|
+
|
|
109
|
+
### 6. Verify, Don't Assume
|
|
110
|
+
|
|
111
|
+
Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
|
|
112
|
+
|
|
113
|
+
Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
|
|
114
|
+
|
|
115
|
+
## Failure Modes to Avoid
|
|
116
|
+
|
|
117
|
+
These are the subtle errors that look like productivity but create problems:
|
|
118
|
+
|
|
119
|
+
1. Making wrong assumptions without checking
|
|
120
|
+
2. Not managing your own confusion — plowing ahead when lost
|
|
121
|
+
3. Not surfacing inconsistencies you notice
|
|
122
|
+
4. Not presenting tradeoffs on non-obvious decisions
|
|
123
|
+
5. Being sycophantic ("Of course!") to approaches with clear problems
|
|
124
|
+
6. Overcomplicating code and APIs
|
|
125
|
+
7. Modifying code or comments orthogonal to the task
|
|
126
|
+
8. Removing things you don't fully understand
|
|
127
|
+
9. Building without a spec because "it's obvious"
|
|
128
|
+
10. Skipping verification because "it looks right"
|
|
129
|
+
|
|
130
|
+
## Skill Rules
|
|
131
|
+
|
|
132
|
+
1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
|
|
133
|
+
|
|
134
|
+
2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
|
|
135
|
+
|
|
136
|
+
3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
|
|
137
|
+
|
|
138
|
+
4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
|
|
139
|
+
|
|
140
|
+
## Lifecycle Sequence
|
|
141
|
+
|
|
142
|
+
For a complete feature, the typical skill sequence is:
|
|
143
|
+
|
|
144
|
+
```
|
|
145
|
+
1. interview-me → Extract what the user actually wants
|
|
146
|
+
2. idea-refine → Refine vague ideas
|
|
147
|
+
3. spec-driven-development → Define what we're building
|
|
148
|
+
4. planning-and-task-breakdown → Break into verifiable chunks
|
|
149
|
+
5. context-engineering → Load the right context
|
|
150
|
+
6. source-driven-development → Verify against official docs
|
|
151
|
+
7. incremental-implementation → Build slice by slice
|
|
152
|
+
8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
|
|
153
|
+
9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
|
|
154
|
+
10. test-driven-development → Prove each slice works
|
|
155
|
+
11. code-review-and-quality → Review before merge
|
|
156
|
+
12. code-simplification → Reduce unnecessary complexity while preserving behavior
|
|
157
|
+
13. git-workflow-and-versioning → Clean commit history
|
|
158
|
+
14. documentation-and-adrs → Document decisions
|
|
159
|
+
15. deprecation-and-migration → Retire old systems and move users safely when needed
|
|
160
|
+
16. shipping-and-launch → Deploy safely
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
|
|
164
|
+
|
|
165
|
+
## Quick Reference
|
|
166
|
+
|
|
167
|
+
| Phase | Skill | One-Line Summary |
|
|
168
|
+
|-------|-------|-----------------|
|
|
169
|
+
| Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
|
|
170
|
+
| Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
|
|
171
|
+
| Define | spec-driven-development | Requirements and acceptance criteria before code |
|
|
172
|
+
| Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
|
|
173
|
+
| Build | incremental-implementation | Thin vertical slices, test each before expanding |
|
|
174
|
+
| Build | source-driven-development | Verify against official docs before implementing |
|
|
175
|
+
| Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
|
|
176
|
+
| Build | context-engineering | Right context at the right time |
|
|
177
|
+
| Build | frontend-ui-engineering | Production-quality UI with accessibility |
|
|
178
|
+
| Build | api-and-interface-design | Stable interfaces with clear contracts |
|
|
179
|
+
| Verify | test-driven-development | Failing test first, then make it pass |
|
|
180
|
+
| Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
|
|
181
|
+
| Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
|
|
182
|
+
| Review | code-review-and-quality | Five-axis review with quality gates |
|
|
183
|
+
| Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
|
|
184
|
+
| Review | security-and-hardening | OWASP prevention, input validation, least privilege |
|
|
185
|
+
| Review | performance-optimization | Measure first, optimize only what matters |
|
|
186
|
+
| Ship | git-workflow-and-versioning | Atomic commits, clean history |
|
|
187
|
+
| Ship | ci-cd-and-automation | Automated quality gates on every change |
|
|
188
|
+
| Ship | deprecation-and-migration | Remove old systems and migrate users safely |
|
|
189
|
+
| Ship | documentation-and-adrs | Document the why, not just the what |
|
|
190
|
+
| Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
|
|
191
|
+
| Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Agent Fleet changelog
|
|
2
2
|
|
|
3
|
+
## 0.0.6
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 9b81430: Namespace every Agent Fleet Pi slash command under `/af-*`, including lifecycle prompt templates, harness controls, utility-extension commands, and installer entrypoints. Pi bootstrap and guided setup migrate owned legacy prompt targets while preserving modified or unowned files.
|
|
8
|
+
|
|
3
9
|
## 0.0.5
|
|
4
10
|
|
|
5
11
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -37,7 +37,7 @@ Agent Fleet is a **multi-agent orchestration system for AI coding agents**, buil
|
|
|
37
37
|
```bash
|
|
38
38
|
pi install -l npm:@chankov/agent-fleet # project-scoped package: skills, prompts, ask-user
|
|
39
39
|
# then, inside pi:
|
|
40
|
-
# /setup-agent-fleet
|
|
40
|
+
# /af-setup-agent-fleet # guided install of harnesses, personas, extensions
|
|
41
41
|
# and once set up:
|
|
42
42
|
just fleet # guarded Pi + STT and core utilities
|
|
43
43
|
just fleet hub # guarded multi-agent dispatcher
|
|
@@ -48,17 +48,18 @@ just fleet team docs # hub + guarded peers in one tiled herdr workspace
|
|
|
48
48
|
|
|
49
49
|
```bash
|
|
50
50
|
npx @chankov/agent-fleet init
|
|
51
|
-
# then open your coding agent in this directory and run:
|
|
52
|
-
# /setup-agent-fleet
|
|
51
|
+
# then open your coding agent in this directory and run the command it prints:
|
|
52
|
+
# Claude Code: /setup-agent-fleet
|
|
53
|
+
# OpenCode: /af-setup-agent-fleet
|
|
53
54
|
```
|
|
54
55
|
|
|
55
|
-
The CLI detects your coding agent and
|
|
56
|
+
The CLI detects your coding agent and prints the correct setup command. It runs the full guided install — analysing the workspace, showing grouped menus, and confirming everything before writing a single file.
|
|
56
57
|
|
|
57
58
|
| CLI command | What it does |
|
|
58
59
|
|---|---|
|
|
59
|
-
| `npx @chankov/agent-fleet init` | Materialize the package + hand off to
|
|
60
|
+
| `npx @chankov/agent-fleet init` | Materialize the package + hand off to the runtime's setup command |
|
|
60
61
|
| `npx @chankov/agent-fleet doctor` | Scan for broken symlinks and stale persona refs |
|
|
61
|
-
| `npx @chankov/agent-fleet update` | Surface the version delta + hand off to
|
|
62
|
+
| `npx @chankov/agent-fleet update` | Surface the version delta + hand off to the runtime's setup command for the per-artifact diff |
|
|
62
63
|
| `npx @chankov/agent-fleet transform-persona` | Generate per-agent subagent files from the canonical personas |
|
|
63
64
|
|
|
64
65
|
<details>
|
|
@@ -121,7 +122,7 @@ What makes it different is what it **doesn't** put in front of the dispatcher LL
|
|
|
121
122
|
|
|
122
123
|

|
|
123
124
|
|
|
124
|
-
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.
|
|
125
|
+
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 (`/af-agent-model`) or fleet-wide (`/af-models <profile>`). `plan-reviewer` and `code-reviewer` can run as **Claude Code peers** for cross-model review.
|
|
125
126
|
|
|
126
127
|
```bash
|
|
127
128
|
just fleet hub # guarded dispatcher + research + coms + orchestrator persona
|
|
@@ -146,23 +147,23 @@ Deep dive: [agent-hub harness README](.pi/harnesses/agent-hub/README.md) (the fu
|
|
|
146
147
|
│ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │
|
|
147
148
|
│Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │
|
|
148
149
|
└──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
|
|
149
|
-
|
|
150
|
+
spec plan build test review ship
|
|
150
151
|
```
|
|
151
152
|
|
|
152
|
-
10 slash commands map to the development lifecycle; each activates the right skills automatically
|
|
153
|
-
|
|
154
|
-
| What you're doing |
|
|
155
|
-
|
|
156
|
-
| Define what to build | `/spec` | Spec before code |
|
|
157
|
-
| Plan how to build it | `/plan` | Small, atomic tasks |
|
|
158
|
-
| Build incrementally | `/build` | One slice at a time (
|
|
159
|
-
| Prove it works | `/test` | Tests are proof |
|
|
160
|
-
| Review before merge | `/review` | Improve code health |
|
|
161
|
-
| Audit web performance | `/webperf` | Measure before you optimize |
|
|
162
|
-
| Simplify the code | `/code-simplify` | Clarity over cleverness |
|
|
163
|
-
| Ship to production | `/ship` | Faster is safer |
|
|
164
|
-
| Orchestrate a team | `/orchestrate` | Main session drives a config-defined
|
|
165
|
-
| Capture session lessons | `/compound` | Every session improves the next
|
|
153
|
+
10 slash commands map to the development lifecycle; each activates the right skills automatically. **Claude Code uses the unprefixed form; Pi and OpenCode use `/af-*`.**
|
|
154
|
+
|
|
155
|
+
| What you're doing | Claude Code | Pi / OpenCode | Key principle |
|
|
156
|
+
|-------------------|-------------|---------------|---------------|
|
|
157
|
+
| Define what to build | `/spec` | `/af-spec` | Spec before code |
|
|
158
|
+
| Plan how to build it | `/plan` | `/af-plan` | Small, atomic tasks |
|
|
159
|
+
| Build incrementally | `/build` | `/af-build` | One slice at a time (`auto` runs the whole plan in one approved pass) |
|
|
160
|
+
| Prove it works | `/test` | `/af-test` | Tests are proof |
|
|
161
|
+
| Review before merge | `/review` | `/af-review` | Improve code health |
|
|
162
|
+
| Audit web performance | `/webperf` | `/af-webperf` *(OpenCode)* | Measure before you optimize |
|
|
163
|
+
| Simplify the code | `/code-simplify` | `/af-code-simplify` | Clarity over cleverness |
|
|
164
|
+
| Ship to production | `/ship` | `/af-ship` | Faster is safer |
|
|
165
|
+
| Orchestrate a team | `/orchestrate` | `/af-orchestrate` *(OpenCode; Pi uses agent-hub)* | Main session drives a config-defined roster |
|
|
166
|
+
| Capture session lessons | `/compound` | `/af-compound` | Every session improves the next |
|
|
166
167
|
|
|
167
168
|
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`.
|
|
168
169
|
|
|
@@ -183,7 +184,7 @@ Full catalog with descriptions and triggers: **[docs/skills-catalog.md](docs/ski
|
|
|
183
184
|
|
|
184
185
|
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`.
|
|
185
186
|
|
|
186
|
-
Each persona is one Markdown file; the canonical format is pi-flavored and
|
|
187
|
+
Each persona is one Markdown file; the canonical format is pi-flavored and the runtime's Agent Fleet setup command 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`.
|
|
187
188
|
|
|
188
189
|
Full roster, skill hooks, install matrix, and team composition: **[docs/agents.md](docs/agents.md)**.
|
|
189
190
|
|
package/agents/documenter.md
CHANGED
|
@@ -14,5 +14,5 @@ You are a documentation agent. Write clear, concise documentation. Update README
|
|
|
14
14
|
|
|
15
15
|
- Project docs: read `.ai/agent-fleet-overrides.md` if it exists; in its `## agent-hub` (legacy `## agent-team`) section a `docs:` entry (comma-separated repo-relative files or folders) names the project's canonical documentation entry points. Treat those files and the trees they link to as the documentation you maintain: prefer updating existing files over creating new ones, keep indexes and cross-links current, and check the project's `rules:` folders for docs-maintenance rules that govern documentation work before writing.
|
|
16
16
|
- If `skills/documentation-and-adrs/SKILL.md` exists in the repo, read it before starting and follow its process — including when a decision deserves an ADR and the doc formats it defines.
|
|
17
|
-
- If the dispatch is a **compound task** (end-of-session lessons capture into the project's rules/docs — a `/compound` dispatch or any task asking you to turn session findings into durable rules), read `skills/compound-learning/SKILL.md` first and follow it exactly: treat the dispatch brief as candidate lessons rather than conclusions, dedupe against the existing rule tree index-first, land minimal diffs on existing files, and respect its caps and approval gate.
|
|
17
|
+
- If the dispatch is a **compound task** (end-of-session lessons capture into the project's rules/docs — a `/compound` or `/af-compound` dispatch or any task asking you to turn session findings into durable rules), read `skills/compound-learning/SKILL.md` first and follow it exactly: treat the dispatch brief as candidate lessons rather than conclusions, dedupe against the existing rule tree index-first, land minimal diffs on existing files, and respect its caps and approval gate.
|
|
18
18
|
- If you lack information your own tools cannot answer, do not guess — pause per the research protocol with `NEEDS_RESEARCH: <one specific, self-contained question>` lines (nothing after them); you will be resumed in the same session with findings file paths to read.
|
package/agents/releaser.md
CHANGED
|
@@ -13,7 +13,7 @@ thinking: low
|
|
|
13
13
|
|
|
14
14
|
# Releaser (coms peer)
|
|
15
15
|
|
|
16
|
-
You are the release-owner peer, reached over coms and via `/handoff`. When a main agent hands off
|
|
16
|
+
You are the release-owner peer, reached over coms and via Pi's `/af-handoff`. When a main agent hands off
|
|
17
17
|
a finished change, you take it from "implemented" to "published".
|
|
18
18
|
|
|
19
19
|
- **Run the ship flow.** Add the changeset (correct bump per `CONTRIBUTING.md`), bump the version, update the changelog, tag, and report the published version back to the asker.
|
package/bin/cli.js
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
// agent-fleet — thin dispatcher into the LLM-driven guided setup.
|
|
3
3
|
//
|
|
4
4
|
// Main commands:
|
|
5
|
-
// init materialize the package, detect the coding agent, hand off to
|
|
5
|
+
// init materialize the package, detect the coding agent, hand off to its setup command
|
|
6
6
|
// doctor deterministic preflight scan (broken symlinks, stale persona refs)
|
|
7
|
-
// update refresh the package, then hand off to
|
|
7
|
+
// update refresh the package, then hand off to the setup workflow for the version-diff
|
|
8
8
|
// transform-persona generate per-agent subagent files from the canonical agents/*.md
|
|
9
9
|
// set-hermes-telegram install/inspect the liaison and start/stop its bridge
|
|
10
10
|
//
|
|
@@ -165,10 +165,9 @@ async function cmdInit() {
|
|
|
165
165
|
}
|
|
166
166
|
|
|
167
167
|
// Bootstrap the installer artifacts (setup + doctor + the skill they invoke).
|
|
168
|
-
// Without this, the agent has no
|
|
169
|
-
//
|
|
170
|
-
//
|
|
171
|
-
// the agent; we only drop the plumbing it needs to exist.
|
|
168
|
+
// Without this, the agent has no setup command to hand off to. The command itself
|
|
169
|
+
// is one of the files this writes; the rest of the catalogue (skills, personas,
|
|
170
|
+
// etc.) is the setup workflow's job inside the agent.
|
|
172
171
|
printSection("Bootstrap installer");
|
|
173
172
|
const { written, skipped, removed, warnings } = bootstrap({
|
|
174
173
|
agent,
|
|
@@ -256,7 +255,7 @@ async function cmdDoctor() {
|
|
|
256
255
|
`\n✓ Doctor finished — repaired ${repaired}, deleted ${deleted}, skipped ${skipped}.`,
|
|
257
256
|
);
|
|
258
257
|
console.log(
|
|
259
|
-
"Re-run
|
|
258
|
+
"Re-run Agent Fleet's setup command inside your coding agent if you also want to add or remove artifacts.",
|
|
260
259
|
);
|
|
261
260
|
}
|
|
262
261
|
|
|
@@ -269,7 +268,7 @@ async function cmdUpdate() {
|
|
|
269
268
|
|
|
270
269
|
// npm itself does the package upgrade. The CLI's job here is to read the
|
|
271
270
|
// workspace's install record, surface the version delta, re-install the
|
|
272
|
-
//
|
|
271
|
+
// setup command, and hand off to the skill for the diff-aware
|
|
273
272
|
// refresh.
|
|
274
273
|
const recordPath = join(workspace, ".ai", "agent-fleet-setup.md");
|
|
275
274
|
if (!existsSync(recordPath)) {
|
|
@@ -285,11 +284,11 @@ async function cmdUpdate() {
|
|
|
285
284
|
console.log(`Installed package: v${current}`);
|
|
286
285
|
console.log();
|
|
287
286
|
|
|
288
|
-
// Re-bootstrap the installer artifacts so
|
|
287
|
+
// Re-bootstrap the installer artifacts so the runtime's setup command is present
|
|
289
288
|
// after the update. guided-workspace-setup removes these at the end of a
|
|
290
289
|
// run by default (Step 10b / cleanupInstaller), so a workspace that has
|
|
291
290
|
// completed setup once no longer has the command — and `update` used to
|
|
292
|
-
// only print
|
|
291
|
+
// only print a stale setup instruction while pointing at a command that no
|
|
293
292
|
// longer existed. The marker recovers the agent/method from init time; if
|
|
294
293
|
// it was cleaned up too, fall back to detection (and prompt if ambiguous).
|
|
295
294
|
const marker = readBootstrapMarker(workspace);
|
|
@@ -324,7 +323,7 @@ async function cmdUpdate() {
|
|
|
324
323
|
console.log(` ✗ skipped: ${relative(workspace, f.dest)} — ${f.error}`);
|
|
325
324
|
}
|
|
326
325
|
|
|
327
|
-
const setupCmd = agent === "
|
|
326
|
+
const setupCmd = agent === "claude-code" ? "/setup-agent-fleet" : "/af-setup-agent-fleet";
|
|
328
327
|
|
|
329
328
|
printSection("Next step");
|
|
330
329
|
if (recorded === current) {
|
|
@@ -470,7 +469,7 @@ async function chooseAgent(supplied) {
|
|
|
470
469
|
function printHandoff({ agent, method, workspace, source, version }) {
|
|
471
470
|
const rel = relative(process.cwd(), workspace) || ".";
|
|
472
471
|
const setupCmd =
|
|
473
|
-
agent === "
|
|
472
|
+
agent === "claude-code" ? "/setup-agent-fleet" : "/af-setup-agent-fleet";
|
|
474
473
|
const lines = [
|
|
475
474
|
`agent-fleet v${version} is ready.`,
|
|
476
475
|
"",
|
|
@@ -517,7 +516,8 @@ function tryLaunch(agent, cwd) {
|
|
|
517
516
|
const r = spawnSync(cmd, [], { cwd, stdio: "inherit" });
|
|
518
517
|
if (r.error) {
|
|
519
518
|
console.log(`(could not launch ${cmd}: ${r.error.message})`);
|
|
520
|
-
|
|
519
|
+
const setupCmd = agent === "claude-code" ? "/setup-agent-fleet" : "/af-setup-agent-fleet";
|
|
520
|
+
console.log(`Open ${cmd} manually and run ${setupCmd}.`);
|
|
521
521
|
}
|
|
522
522
|
}
|
|
523
523
|
|
|
@@ -582,7 +582,7 @@ function printHelp(sub) {
|
|
|
582
582
|
if (sub === "init") {
|
|
583
583
|
console.log(`agent-fleet init [options]
|
|
584
584
|
|
|
585
|
-
Materialize the package and hand off to the
|
|
585
|
+
Materialize the package and hand off to the runtime's Agent Fleet setup command.
|
|
586
586
|
|
|
587
587
|
Options:
|
|
588
588
|
--agent <claude-code|opencode|pi> Skip the agent auto-detection
|
|
@@ -660,10 +660,10 @@ Examples:
|
|
|
660
660
|
if (sub === "update") {
|
|
661
661
|
console.log(`agent-fleet update [options]
|
|
662
662
|
|
|
663
|
-
Surface the version delta and re-install the
|
|
664
|
-
it is always present after an update (guided-workspace-setup
|
|
665
|
-
the end of a run by default). The actual diff-aware refresh
|
|
666
|
-
your coding agent via
|
|
663
|
+
Surface the version delta and re-install the runtime's Agent Fleet setup
|
|
664
|
+
command so it is always present after an update (guided-workspace-setup
|
|
665
|
+
removes it at the end of a run by default). The actual diff-aware refresh
|
|
666
|
+
then runs inside your coding agent via that command.
|
|
667
667
|
|
|
668
668
|
Options:
|
|
669
669
|
--agent <claude-code|opencode|pi> Override the agent (default: marker → auto-detect)
|
|
@@ -684,9 +684,9 @@ Usage:
|
|
|
684
684
|
npx agent-fleet <command> [options]
|
|
685
685
|
|
|
686
686
|
Commands:
|
|
687
|
-
init Bootstrap installer files + hand off to
|
|
687
|
+
init Bootstrap installer files + hand off to the setup workflow
|
|
688
688
|
doctor Scan for broken symlinks and stale persona references
|
|
689
|
-
update Surface the version delta + hand off to
|
|
689
|
+
update Surface the version delta + hand off to the setup workflow
|
|
690
690
|
check-update One-line registry check (used by session hooks; safe to script)
|
|
691
691
|
cleanup-installer Remove the installer slash commands from a workspace (used
|
|
692
692
|
by the skill at end of setup; safe to run by hand)
|
package/bin/lib/bootstrap.js
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
// bootstrap.js — drop the minimum installer artifacts a coding agent needs
|
|
2
|
-
// to recognize
|
|
2
|
+
// to recognize Agent Fleet's setup and doctor slash commands.
|
|
3
3
|
//
|
|
4
4
|
// The CLI's `init` calls this before the handoff message. Without it, a
|
|
5
|
-
// fresh workspace has no `.claude/commands/setup-agent-fleet.md`,
|
|
6
|
-
// etc., so the agent has no
|
|
7
|
-
// breaks silently.
|
|
5
|
+
// fresh workspace has no `.claude/commands/setup-agent-fleet.md`,
|
|
6
|
+
// `.pi/prompts/af-setup-agent-fleet.md`, etc., so the agent has no setup
|
|
7
|
+
// entrypoint and the whole hand-off breaks silently.
|
|
8
8
|
//
|
|
9
9
|
// What we bootstrap (per agent):
|
|
10
10
|
// - The `setup` slash command (so the user can invoke it)
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
// What we do NOT bootstrap:
|
|
17
17
|
// - Any of the user-facing skills (spec-driven-development,
|
|
18
18
|
// test-driven-development, …). Those are picked by the user inside
|
|
19
|
-
//
|
|
19
|
+
// through the runtime's setup command, by design. The CLI never decides the workspace's catalogue
|
|
20
20
|
// for the user.
|
|
21
21
|
//
|
|
22
22
|
// Method:
|
|
@@ -93,10 +93,10 @@ function plan({ agent, sourceRoot, workspace }) {
|
|
|
93
93
|
|
|
94
94
|
case "pi":
|
|
95
95
|
return [
|
|
96
|
-
{ kind: "prompt", src: join(sourceRoot, ".pi/prompts/setup-agent-fleet.md"),
|
|
97
|
-
dest: join(workspace, ".pi/prompts/setup-agent-fleet.md") },
|
|
98
|
-
{ kind: "prompt", src: join(sourceRoot, ".pi/prompts/doctor-agent-fleet.md"),
|
|
99
|
-
dest: join(workspace, ".pi/prompts/doctor-agent-fleet.md") },
|
|
96
|
+
{ kind: "prompt", src: join(sourceRoot, ".pi/prompts/af-setup-agent-fleet.md"),
|
|
97
|
+
dest: join(workspace, ".pi/prompts/af-setup-agent-fleet.md") },
|
|
98
|
+
{ kind: "prompt", src: join(sourceRoot, ".pi/prompts/af-doctor-agent-fleet.md"),
|
|
99
|
+
dest: join(workspace, ".pi/prompts/af-doctor-agent-fleet.md") },
|
|
100
100
|
// pi auto-discovers skills from .pi/skills/ and .agents/skills/ —
|
|
101
101
|
// we use .pi/skills/ to avoid polluting a shared .agents/ dir if
|
|
102
102
|
// the user has other tools there.
|
|
@@ -124,9 +124,8 @@ function plan({ agent, sourceRoot, workspace }) {
|
|
|
124
124
|
}
|
|
125
125
|
}
|
|
126
126
|
|
|
127
|
-
//
|
|
128
|
-
//
|
|
129
|
-
// up with both the old and new slash commands.
|
|
127
|
+
// Previous bootstrap targets. Removed during bootstrap so upgrades do not
|
|
128
|
+
// leave both unprefixed and current slash commands in the workspace.
|
|
130
129
|
function legacyPaths({ agent, workspace }) {
|
|
131
130
|
switch (agent) {
|
|
132
131
|
case "claude-code":
|
|
@@ -138,6 +137,8 @@ function legacyPaths({ agent, workspace }) {
|
|
|
138
137
|
return [
|
|
139
138
|
join(workspace, ".pi/prompts/setup.md"),
|
|
140
139
|
join(workspace, ".pi/prompts/doctor.md"),
|
|
140
|
+
join(workspace, ".pi/prompts/setup-agent-fleet.md"),
|
|
141
|
+
join(workspace, ".pi/prompts/doctor-agent-fleet.md"),
|
|
141
142
|
];
|
|
142
143
|
case "opencode":
|
|
143
144
|
return [
|
|
@@ -173,8 +174,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
|
|
|
173
174
|
);
|
|
174
175
|
}
|
|
175
176
|
|
|
176
|
-
// Clean up
|
|
177
|
-
// *-agent-fleet so they don't collide with other slash commands.
|
|
177
|
+
// Clean up superseded file names so old and current commands never coexist.
|
|
178
178
|
for (const oldPath of legacyPaths({ agent, workspace })) {
|
|
179
179
|
if (!existsSync(oldPath) && !isSymlink(oldPath)) continue;
|
|
180
180
|
if (dryRun) {
|
|
@@ -205,7 +205,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
|
|
|
205
205
|
|
|
206
206
|
// Always replace — the bootstrap is installer scaffolding, not user
|
|
207
207
|
// data. If we left it stale, an upgraded package would still hand off
|
|
208
|
-
// to
|
|
208
|
+
// to an old setup command. Step 6 of guided-workspace-setup explicitly
|
|
209
209
|
// never offers these files in the install menu, so we are the only
|
|
210
210
|
// mechanism that refreshes them.
|
|
211
211
|
if (existsSync(item.dest) || isSymlink(item.dest)) {
|
|
@@ -248,7 +248,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
|
|
|
248
248
|
* Remove every bootstrap artifact this module knows how to write. Called
|
|
249
249
|
* by guided-workspace-setup at the end of Step 10 unless the user chose
|
|
250
250
|
* to keep the installer commands. After cleanup, the only way back to
|
|
251
|
-
*
|
|
251
|
+
* the setup command is to re-run `npx @chankov/agent-fleet init`.
|
|
252
252
|
*
|
|
253
253
|
* The same `agent` value must be supplied that was used at bootstrap time —
|
|
254
254
|
* we don't have a tracking file, so we delete based on the plan map.
|
package/bin/lib/doctor.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// Doctor scan — deterministic preflight extracted from
|
|
2
2
|
// guided-workspace-setup Step 5. Both `agent-fleet doctor` (CLI) and the
|
|
3
|
-
//
|
|
3
|
+
// Runtime-specific Agent Fleet doctor slash commands call into this so behaviour cannot drift.
|
|
4
4
|
//
|
|
5
5
|
// Three classes of findings:
|
|
6
6
|
// 1. Broken symlinks — links whose source has been moved, renamed, or deleted
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -101,7 +101,7 @@ sessions are recycled (fresh spawn instead of `-c` resume) after `session-recycl
|
|
|
101
101
|
or ≥60% measured context — resumed sessions otherwise re-bill their accumulated context on
|
|
102
102
|
every model call. Configured under `## agent-hub` (`mode`, `max-dispatches-per-turn`,
|
|
103
103
|
`max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`);
|
|
104
|
-
switched live with `/hub-mode`.
|
|
104
|
+
switched live with `/af-hub-mode`.
|
|
105
105
|
|
|
106
106
|
On top of the mode sit three qualitative guardrails. **Task triage**: the dispatcher
|
|
107
107
|
classifies each turn via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
|
|
@@ -111,10 +111,10 @@ observed in-flight from the JSON event stream — deterministic rules (out-of-sc
|
|
|
111
111
|
against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
|
|
112
112
|
escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
|
|
113
113
|
`drift_stop` (exit 125, partial output preserved); enabled per hub/agent/dispatch
|
|
114
|
-
(`watchdog` key, `/watchdog`, `watchdog` param). **Dynamic teams**: `/agents-add`,
|
|
115
|
-
`/agents-drop`, `/agents-save` restructure the roster live (the system prompt rebuilds
|
|
114
|
+
(`watchdog` key, `/af-watchdog`, `watchdog` param). **Dynamic teams**: `/af-agents-add`,
|
|
115
|
+
`/af-agents-drop`, `/af-agents-save` restructure the roster live (the system prompt rebuilds
|
|
116
116
|
every turn), and the gated `team_adjust` tool lets the dispatcher itself adjust the roster
|
|
117
|
-
outside fast mode, with user notification. `/hub-report` accounts each turn's dispatches,
|
|
117
|
+
outside fast mode, with user notification. `/af-hub-report` accounts each turn's dispatches,
|
|
118
118
|
tokens (billed = input + cacheRead + cacheWrite), recycles, drift stops, and refusals.
|
|
119
119
|
|
|
120
120
|
## Runtime stack (tools the fleet sits on)
|