@chankov/agent-fleet 0.0.4 → 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/.claude/commands/set-hermes-telegram.md +15 -0
- package/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.pi/agents/dispatch-policy.yaml +1 -1
- package/.pi/agents/peers.yaml +4 -4
- 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 +3 -3
- package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/extensions/mcp-bridge/README.md +1 -1
- 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 +84 -84
- 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 +254 -254
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
- package/.pi/harnesses/agent-hub/monitor-publisher.ts +3 -3
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +1 -1
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/run-budget.js +1 -1
- package/.pi/harnesses/ask-user-remote/README.md +1 -0
- package/.pi/harnesses/ask-user-remote/index.ts +36 -8
- package/.pi/harnesses/coms/README.md +7 -7
- package/.pi/harnesses/coms/index.ts +13 -13
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +16 -16
- package/.pi/harnesses/damage-control-continue/index.ts +11 -11
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.5/.claude/commands/build.md +44 -0
- package/.versions/0.0.5/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.5/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.5/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.5/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.5/.claude/commands/plan.md +16 -0
- package/.versions/0.0.5/.claude/commands/prime.md +22 -0
- package/.versions/0.0.5/.claude/commands/review.md +16 -0
- package/.versions/0.0.5/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.5/.claude/commands/ship.md +72 -0
- package/.versions/0.0.5/.claude/commands/spec.md +15 -0
- package/.versions/0.0.5/.claude/commands/test.md +19 -0
- package/.versions/0.0.5/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.5/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.5/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.5/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.5/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.5/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.5/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.5/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.5/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.5/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.5/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.5/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.5/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.5/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.5/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.5/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.5/.pi/extensions/package.json +9 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.5/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.5/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.5/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.5/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.5/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.5/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.5/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.5/.pi/prompts/build.md +24 -0
- package/.versions/0.0.5/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.5/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.5/.pi/prompts/review.md +16 -0
- package/.versions/0.0.5/.pi/prompts/set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.5/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.5/.pi/prompts/test.md +19 -0
- package/.versions/0.0.5/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.5/.version +1 -0
- package/.versions/0.0.5/agents/architect.md +23 -0
- package/.versions/0.0.5/agents/bowser.md +26 -0
- package/.versions/0.0.5/agents/builder.md +53 -0
- package/.versions/0.0.5/agents/code-reviewer.md +205 -0
- package/.versions/0.0.5/agents/deep-researcher.md +31 -0
- package/.versions/0.0.5/agents/documenter.md +18 -0
- package/.versions/0.0.5/agents/orchestrator.md +54 -0
- package/.versions/0.0.5/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.5/agents/planner.md +69 -0
- package/.versions/0.0.5/agents/releaser.md +24 -0
- package/.versions/0.0.5/agents/researcher.md +28 -0
- package/.versions/0.0.5/agents/security-auditor.md +166 -0
- package/.versions/0.0.5/agents/test-engineer.md +151 -0
- package/.versions/0.0.5/agents/web-debugger.md +42 -0
- package/.versions/0.0.5/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.5/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.5/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.5/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.5/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.5/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.5/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.5/docs/getting-started.md +183 -0
- package/.versions/0.0.5/docs/npm-install.md +337 -0
- package/.versions/0.0.5/docs/opencode-setup.md +249 -0
- package/.versions/0.0.5/docs/pi-extensions.md +293 -0
- package/.versions/0.0.5/docs/pi-setup.md +472 -0
- package/.versions/0.0.5/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.5/hermes/README.md +231 -0
- package/.versions/0.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.5/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.5/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.5/hooks/hooks.json +14 -0
- package/.versions/0.0.5/hooks/session-start.sh +74 -0
- package/.versions/0.0.5/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.5/justfile +245 -0
- package/.versions/0.0.5/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.5/references/definition-of-done.md +67 -0
- package/.versions/0.0.5/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.5/references/observability-checklist.md +91 -0
- package/.versions/0.0.5/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.5/references/performance-checklist.md +153 -0
- package/.versions/0.0.5/references/prompting-patterns.md +380 -0
- package/.versions/0.0.5/references/security-checklist.md +179 -0
- package/.versions/0.0.5/references/testing-patterns.md +236 -0
- package/.versions/0.0.5/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.5/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.5/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.5/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.5/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.5/scripts/fleet.ts +141 -0
- package/.versions/0.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.5/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.5/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.5/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.5/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.5/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.5/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.5/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.5/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.5/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.5/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.5/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.5/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.5/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.5/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.5/scripts/team-up.ts +351 -0
- package/.versions/0.0.5/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.5/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.5/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.5/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.5/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.5/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +542 -0
- package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.5/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.5/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.5/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.5/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.5/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.5/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.5/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.5/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.5/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.5/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.5/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.5/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.5/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- 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 +15 -0
- package/README.md +38 -36
- package/agents/documenter.md +1 -1
- package/agents/releaser.md +1 -1
- package/bin/cli.js +103 -21
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/set-hermes-telegram.js +323 -0
- package/docs/ARCHITECTURE.md +8 -8
- package/docs/agent-fleet-setup.md +12 -12
- package/docs/claude-code-coms-bridge.md +4 -4
- package/docs/codex-remote-conductor.md +12 -12
- package/docs/coms-hermes-bridge.md +62 -4
- package/docs/getting-started.md +4 -4
- package/docs/npm-install.md +21 -21
- package/docs/opencode-setup.md +1 -0
- package/docs/pi-extensions.md +36 -31
- package/docs/pi-setup.md +66 -53
- package/hermes/README.md +14 -11
- package/justfile +141 -152
- package/package.json +6 -3
- package/references/fleet-coordination-patterns.md +3 -3
- package/scripts/coms-hermes-bridge.ts +18 -8
- package/scripts/fleet.ts +141 -0
- package/scripts/lib/fleet-command.ts +109 -0
- package/scripts/lib/hermes-bridge-core.ts +5 -2
- package/scripts/lib/hermes-monitor-herdr.ts +2 -28
- package/scripts/lib/hermes-monitor-model.ts +3 -9
- package/scripts/lib/hermes-monitor-registry.ts +2 -6
- package/scripts/lib/hermes-monitor-socket.ts +2 -118
- package/scripts/lib/hermes-monitor-store.ts +2 -31
- package/scripts/lib/team-project.ts +10 -3
- package/scripts/team-snapshot.ts +4 -5
- package/scripts/team-up.ts +24 -6
- 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 +27 -18
- package/skills/guided-workspace-setup/companion-manifest.json +3 -1
- package/skills/peer-coms/SKILL.md +1 -1
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -10
- /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/{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
- /package/{.pi → .versions/0.0.5/.pi}/prompts/doctor-agent-fleet.md +0 -0
- /package/{.pi → .versions/0.0.5/.pi}/prompts/setup-agent-fleet.md +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -0
|
@@ -0,0 +1,337 @@
|
|
|
1
|
+
# npm install path
|
|
2
|
+
|
|
3
|
+
The `@chankov/agent-fleet` package ships every skill, persona, slash command,
|
|
4
|
+
and pi extension as installable content, plus a thin CLI that hands off to the
|
|
5
|
+
LLM-driven `guided-workspace-setup` skill. The CLI never writes installable
|
|
6
|
+
artifacts on its own — that decision (and the conversation around it) belongs
|
|
7
|
+
to the coding agent.
|
|
8
|
+
|
|
9
|
+
## Package name vs CLI name
|
|
10
|
+
|
|
11
|
+
| | Name |
|
|
12
|
+
|---|---|
|
|
13
|
+
| **npm package** (use this for `npm install` and the first `npx`) | `@chankov/agent-fleet` |
|
|
14
|
+
| **CLI binary** (the command the package ships) | `agent-fleet` |
|
|
15
|
+
|
|
16
|
+
The package is published under the `@chankov` npm scope to guarantee identity —
|
|
17
|
+
only [Nikolay Chankov](https://www.npmjs.com/~chankov) can publish to that
|
|
18
|
+
scope. The CLI binary stays the short name `agent-fleet` because that's what
|
|
19
|
+
goes on `PATH` after install.
|
|
20
|
+
|
|
21
|
+
So:
|
|
22
|
+
|
|
23
|
+
- First time / one-shot: `npx @chankov/agent-fleet <cmd>` — npx resolves the
|
|
24
|
+
scoped package and runs its bin.
|
|
25
|
+
- After a project / global install: `npx agent-fleet <cmd>` works too,
|
|
26
|
+
because the bin is named `agent-fleet`.
|
|
27
|
+
|
|
28
|
+
## Quick start
|
|
29
|
+
|
|
30
|
+
### Guided workspace setup
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# In the workspace you want to configure:
|
|
34
|
+
npx @chankov/agent-fleet init
|
|
35
|
+
# Then open your coding agent in this directory and run the command it prints:
|
|
36
|
+
# Claude Code: /setup-agent-fleet
|
|
37
|
+
# Pi/OpenCode: /af-setup-agent-fleet
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
That's it. `npx` fetches the package, the CLI detects your coding agent and
|
|
41
|
+
prints the runtime-appropriate command, which runs the full guided install
|
|
42
|
+
inside your agent.
|
|
43
|
+
|
|
44
|
+
### First-class pi package
|
|
45
|
+
|
|
46
|
+
For pi users who want package-native loading instead of copied/symlinked setup artifacts:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# Project-scoped; writes .pi/settings.json
|
|
50
|
+
pi install -l npm:@chankov/agent-fleet
|
|
51
|
+
|
|
52
|
+
# Or global for every pi session
|
|
53
|
+
pi install npm:@chankov/agent-fleet
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
The pi package manifest exposes this repo's skills, pi runtime skills, lifecycle prompts, and bundled `pi-ask-user` resources. The bundled companion provides the `ask_user` tool and `ask-user` skill without a separate `pi-ask-user` install.
|
|
57
|
+
|
|
58
|
+
It intentionally does not auto-expose this repo's own `.pi/extensions` or harness directories; install those through guided setup or the pi setup docs so their runtime dependencies are handled explicitly. `pi-codex-image-gen` is also not bundled or required; guided setup may offer it as an optional suggested external npm/pi package when package installation is available, and installs it only if selected (`pi install -l npm:pi-codex-image-gen`). Minimal setup works without it.
|
|
59
|
+
|
|
60
|
+
The package also ships assets for the **experimental Linux Codex Remote-Control conductor** (`codex/`, `systemd/`, lifecycle/wrapper scripts, recipes, and runbook). Guided setup copies or links those assets with selected pi harnesses but never enables systemd, edits Codex config, starts a service, or pairs a phone. Those remain explicit operator actions and support only Codex CLI `0.144.x`; see [codex-remote-conductor.md](codex-remote-conductor.md). Its managed runtime contract is created later under `$HOME/.local/state/agent-fleet/codex-conductor/`, not inside the npm package or target checkout.
|
|
61
|
+
|
|
62
|
+
## Commands
|
|
63
|
+
|
|
64
|
+
### `npx @chankov/agent-fleet init`
|
|
65
|
+
|
|
66
|
+
Materializes the package, **bootstraps the installer artifacts** into the
|
|
67
|
+
workspace, and hands off to the runtime's Agent Fleet setup command. Claude Code
|
|
68
|
+
uses unprefixed installer commands; Pi and OpenCode use `/af-setup-agent-fleet`
|
|
69
|
+
and `/af-doctor-agent-fleet`.
|
|
70
|
+
|
|
71
|
+
What `init` writes per agent:
|
|
72
|
+
|
|
73
|
+
| Agent | Files written to the workspace |
|
|
74
|
+
|---|---|
|
|
75
|
+
| `claude-code` | `.claude/commands/setup-agent-fleet.md`, `.claude/commands/doctor-agent-fleet.md`, `.claude/skills/guided-workspace-setup/SKILL.md` |
|
|
76
|
+
| `pi` | `.pi/prompts/af-setup-agent-fleet.md`, `.pi/prompts/af-doctor-agent-fleet.md`, `.pi/skills/guided-workspace-setup/SKILL.md` |
|
|
77
|
+
| `opencode` | `.opencode/commands/af-setup-agent-fleet.md`, `.opencode/commands/af-doctor-agent-fleet.md`, `.opencode/skills/guided-workspace-setup/SKILL.md` |
|
|
78
|
+
|
|
79
|
+
These are **just the plumbing** — the slash commands, plus the skill they
|
|
80
|
+
invoke. The actual catalogue (spec-driven-development, code-reviewer,
|
|
81
|
+
test-engineer, pi extensions, …) is picked by you inside the setup workflow. Re-run
|
|
82
|
+
`init` to refresh the plumbing after a package upgrade; bootstrap files
|
|
83
|
+
are always overwritten because they're scaffolding, not user data.
|
|
84
|
+
|
|
85
|
+
After the setup workflow finishes its install pass, **the bootstrap files
|
|
86
|
+
are removed by default** so they don't clutter your agent's slash-command
|
|
87
|
+
list. Re-run `npx @chankov/agent-fleet init` whenever you want the runtime's
|
|
88
|
+
setup command back. To keep them in place across runs, reply `keep`
|
|
89
|
+
to the Step 9 confirmation prompt — the skill will record
|
|
90
|
+
`keep-installer: true` in `.ai/agent-fleet-setup.md`.
|
|
91
|
+
|
|
92
|
+
### How the skill finds the source package
|
|
93
|
+
|
|
94
|
+
`init` writes one extra file alongside the bootstrap: `.ai/.agent-fleet-bootstrap.json`.
|
|
95
|
+
This is the **authoritative** record of where the npm package lives:
|
|
96
|
+
|
|
97
|
+
```json
|
|
98
|
+
{
|
|
99
|
+
"sourceRoot": "/home/you/.npm/_npx/<hash>/node_modules/@chankov/agent-fleet",
|
|
100
|
+
"version": "0.3.0",
|
|
101
|
+
"agent": "pi",
|
|
102
|
+
"method": "copy",
|
|
103
|
+
"bootstrappedAt": "2026-05-24T..."
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
When the Agent Fleet setup command runs inside your agent, it reads this marker
|
|
108
|
+
*first* to find the source package. This matters on dev machines where you
|
|
109
|
+
may also have a git clone of `agent-fleet` elsewhere — the marker prevents
|
|
110
|
+
the skill from accidentally using that clone instead of the version the
|
|
111
|
+
user just installed via npm.
|
|
112
|
+
|
|
113
|
+
If the marker is missing or its `sourceRoot` no longer exists (e.g. npx
|
|
114
|
+
cleaned its cache), the skill **asks you explicitly** for the path. It
|
|
115
|
+
never scans your filesystem for other agent-fleet repos — that would
|
|
116
|
+
silently pick up forks, stale checkouts, or dev clones that aren't what
|
|
117
|
+
you installed.
|
|
118
|
+
|
|
119
|
+
The marker is removed by the same Step 10b cleanup that removes the
|
|
120
|
+
slash commands.
|
|
121
|
+
|
|
122
|
+
| Flag | Default | Purpose |
|
|
123
|
+
|------|---------|---------|
|
|
124
|
+
| `--agent <claude-code\|opencode\|pi>` | auto-detect | Skip the agent prompt |
|
|
125
|
+
| `--method <copy\|symlink>` | `copy` | Default install method passed to the skill |
|
|
126
|
+
| `--workspace <path>` | `cwd` | Target workspace |
|
|
127
|
+
| `--launch` | off | Shell into the coding agent after init (best effort) |
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
npx @chankov/agent-fleet init --agent claude-code
|
|
131
|
+
npx @chankov/agent-fleet init --workspace ~/projects/foo --method symlink
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
### `npx @chankov/agent-fleet doctor`
|
|
135
|
+
|
|
136
|
+
Deterministic preflight scan — walks every install-target directory, lists
|
|
137
|
+
broken symlinks and stale persona references, and offers fixes. Same scan
|
|
138
|
+
that the runtime's Agent Fleet doctor command runs inside the agent.
|
|
139
|
+
|
|
140
|
+
| Flag | Default | Purpose |
|
|
141
|
+
|------|---------|---------|
|
|
142
|
+
| `--workspace <path>` | `cwd` | Target workspace |
|
|
143
|
+
| `--dry-run` | off | Show findings; do not apply |
|
|
144
|
+
| `--yes` / `-y` | off | Apply all suggested fixes without prompting |
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
npx @chankov/agent-fleet doctor --workspace ~/projects/foo --dry-run
|
|
148
|
+
npx @chankov/agent-fleet doctor -y
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
### `npx @chankov/agent-fleet update`
|
|
152
|
+
|
|
153
|
+
Reads the workspace's `.ai/agent-fleet-setup.md`, compares the recorded
|
|
154
|
+
package version against the installed package version, and **re-installs the
|
|
155
|
+
runtime's setup command** so it is always available after an update.
|
|
156
|
+
`guided-workspace-setup` removes the installer command at the end of a run by
|
|
157
|
+
default (Step 10b), so a workspace that has completed setup once would
|
|
158
|
+
otherwise have no command to hand off to. The actual diff-aware refresh then
|
|
159
|
+
runs inside the coding agent via that command.
|
|
160
|
+
|
|
161
|
+
The agent and install method are recovered from the bootstrap marker written
|
|
162
|
+
at init time; if that marker was cleaned up too, `update` auto-detects the
|
|
163
|
+
agent (and prompts only when the workspace has more than one agent dir).
|
|
164
|
+
Override with `--agent` / `--method`, or preview with `--dry-run`.
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
# Upgrade the package itself first, then check the delta:
|
|
168
|
+
npm install -g @chankov/agent-fleet@latest
|
|
169
|
+
npx agent-fleet update --workspace .
|
|
170
|
+
# The setup command is now back — run the command printed by update to review diffs.
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
### `npx @chankov/agent-fleet transform-persona`
|
|
174
|
+
|
|
175
|
+
Generates per-agent subagent definitions from the canonical personas in
|
|
176
|
+
`agents/*.md`. `pi` gets the canonical file unchanged; `claude-code` and
|
|
177
|
+
`opencode` get a transformed copy — `tools`/`model` translated to the target's
|
|
178
|
+
vocabulary (`read→Read`, `find/ls→Glob`, `claude-opus-*→opus`, …; `mode:
|
|
179
|
+
subagent` + tool denials for OpenCode), agent-hub-only frontmatter dropped,
|
|
180
|
+
body untouched. pi-only personas (`bowser`, `orchestrator`) are refused for
|
|
181
|
+
other agents. This is what the Agent Fleet setup workflow runs during apply; transformed installs are always
|
|
182
|
+
copies (never symlinks), recorded with `transformed: true`.
|
|
183
|
+
|
|
184
|
+
| Flag | Default | Purpose |
|
|
185
|
+
|------|---------|---------|
|
|
186
|
+
| `--agent <claude-code\|opencode\|pi>` | — (required) | Target agent |
|
|
187
|
+
| `--list` | off | Print the availability matrix (persona → target path) |
|
|
188
|
+
| `--all` | off | Transform every available persona |
|
|
189
|
+
| `--workspace <path>` | — | Write into `<path>`; omit to print to stdout |
|
|
190
|
+
| `--dry-run` | off | With `--workspace`: show what would be written |
|
|
191
|
+
|
|
192
|
+
```bash
|
|
193
|
+
npx @chankov/agent-fleet transform-persona --list --agent claude-code
|
|
194
|
+
npx @chankov/agent-fleet transform-persona --agent claude-code code-reviewer
|
|
195
|
+
npx @chankov/agent-fleet transform-persona --agent opencode --all --workspace .
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
## Versioning
|
|
199
|
+
|
|
200
|
+
The package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html):
|
|
201
|
+
|
|
202
|
+
| Change | Bump |
|
|
203
|
+
|---|---|
|
|
204
|
+
| Skill removed, renamed, or its documented workflow changes; persona retired; command removed; install-record schema breakage | **major** |
|
|
205
|
+
| New skill, new persona, new command, new option in an existing skill | **minor** |
|
|
206
|
+
| Wording fix, doctor scan improvement, CLI bug fix | **patch** |
|
|
207
|
+
|
|
208
|
+
### Pinning
|
|
209
|
+
|
|
210
|
+
To pin a workspace to a specific version, install the package as a project
|
|
211
|
+
dependency instead of using `npx`:
|
|
212
|
+
|
|
213
|
+
```bash
|
|
214
|
+
npm install --save-dev @chankov/agent-fleet@0.0.1
|
|
215
|
+
npx agent-fleet init # resolves to the pinned 0.0.1
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
Or pin globally:
|
|
219
|
+
|
|
220
|
+
```bash
|
|
221
|
+
npm install -g @chankov/agent-fleet@0.0.1
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
### What "update" actually changes
|
|
225
|
+
|
|
226
|
+
The package update is just `npm`'s usual upgrade. The interesting part runs
|
|
227
|
+
inside the agent: `guided-workspace-setup` reads the `version:` line from
|
|
228
|
+
`.ai/agent-fleet-setup.md`, computes the delta against the current package
|
|
229
|
+
version, and surfaces per-artifact `Status` based on a three-way diff:
|
|
230
|
+
|
|
231
|
+
| Status | Means |
|
|
232
|
+
|---|---|
|
|
233
|
+
| `installed · upgrade available` | Source changed upstream; user copy still matches the old source → clean refresh |
|
|
234
|
+
| `installed · conflicting upgrade` | Source changed upstream AND user modified the copy → three-way diff shown, write requires explicit consent |
|
|
235
|
+
| `installed · removed upstream` | Artifact gone in the new version → proposed for deletion (subject to the removal-scope rule) |
|
|
236
|
+
| `not installed · new in this version` | New artifact added in the new version → offered, marked `★` if recommended |
|
|
237
|
+
|
|
238
|
+
The diff is sourced from `.versions/<recorded-version>/` inside the package —
|
|
239
|
+
a snapshot the release pipeline writes for every published version.
|
|
240
|
+
|
|
241
|
+
## Other install paths
|
|
242
|
+
|
|
243
|
+
npm is the recommended path for most users. The other two stay supported:
|
|
244
|
+
|
|
245
|
+
- **[Claude Code plugin marketplace](../README.md#quick-start)** — best UX
|
|
246
|
+
inside Claude Code. Same skills, marketplace-managed updates.
|
|
247
|
+
- **Git clone + symlinks** — best for skill authors and contributors. Clone
|
|
248
|
+
the repo, run the setup command for your runtime, and choose `symlink` in Step 8. Updates
|
|
249
|
+
flow through `git pull`. Symlinks need Developer Mode on Windows.
|
|
250
|
+
|
|
251
|
+
All three paths converge on the same `guided-workspace-setup` skill — the
|
|
252
|
+
difference is only in how the source files reach the workspace.
|
|
253
|
+
|
|
254
|
+
## CI usage
|
|
255
|
+
|
|
256
|
+
`npx @chankov/agent-fleet init` is interactive by default (it prompts for
|
|
257
|
+
the agent when detection is ambiguous). For CI, pass `--agent` explicitly:
|
|
258
|
+
|
|
259
|
+
```bash
|
|
260
|
+
npx --yes @chankov/agent-fleet@latest init --agent claude-code --method copy --workspace .
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
`doctor` accepts `--yes` for non-interactive repair. Note that the
|
|
264
|
+
LLM-driven setup flow is not CI-runnable by design — confirmation gates
|
|
265
|
+
exist precisely so a human approves every write.
|
|
266
|
+
|
|
267
|
+
## Receiving update notifications
|
|
268
|
+
|
|
269
|
+
Three independent mechanisms surface "a new version is published" without
|
|
270
|
+
you having to remember to check. All three share a single cache at
|
|
271
|
+
`$XDG_CACHE_HOME/agent-fleet/latest-version.json` (24h TTL) so the
|
|
272
|
+
registry is hit at most once per day.
|
|
273
|
+
|
|
274
|
+
### 1. CLI update-notifier (always on)
|
|
275
|
+
|
|
276
|
+
Every `npx @chankov/agent-fleet <cmd>` invocation runs a fast cache read
|
|
277
|
+
on entry. If the cached latest version exceeds the running CLI version, a
|
|
278
|
+
banner prints to stderr before the command output:
|
|
279
|
+
|
|
280
|
+
```
|
|
281
|
+
┌──────────────────────────────────────────────────────────────┐
|
|
282
|
+
│ agent-fleet update available: 0.1.0 → 0.2.0 │
|
|
283
|
+
│ Run: npx @chankov/agent-fleet@latest update │
|
|
284
|
+
│ Releases: https://github.com/chankov/agent-fleet/releases │
|
|
285
|
+
└──────────────────────────────────────────────────────────────┘
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
If the cache is stale, a detached background process refreshes it for the
|
|
289
|
+
*next* invocation — the current run is never blocked.
|
|
290
|
+
|
|
291
|
+
### 2. Claude Code session-start hook
|
|
292
|
+
|
|
293
|
+
When `hooks/session-start.sh` is installed (offered in Group 18 of `/setup-agent-fleet`),
|
|
294
|
+
every new Claude Code session runs the check with a 3-second wall-clock cap.
|
|
295
|
+
If an upgrade is available, the banner is injected into the session context
|
|
296
|
+
so Claude can mention it on its first turn — e.g. *"Note: agent-fleet 0.2.0
|
|
297
|
+
is available; want me to apply it via `/setup-agent-fleet`?"*
|
|
298
|
+
|
|
299
|
+
### 3. pi extension (`agent-fleet-update-check`)
|
|
300
|
+
|
|
301
|
+
When installed from the Pi setup flow, the extension fires on the
|
|
302
|
+
first `agent_start` event of each pi session and emits a `ctx.ui.notify`
|
|
303
|
+
message in the pi UI if a newer version is published. Reads the same cache
|
|
304
|
+
as the CLI — no double-fetching.
|
|
305
|
+
|
|
306
|
+
### Opting out
|
|
307
|
+
|
|
308
|
+
Any of these environment variables disables all three:
|
|
309
|
+
|
|
310
|
+
```bash
|
|
311
|
+
export AGENT_SKILLS_NO_UPDATE_CHECK=1 # agent-fleet-specific
|
|
312
|
+
export NO_UPDATE_NOTIFIER=1 # conventional, also honoured
|
|
313
|
+
# CI=true is auto-detected — banners never appear in CI logs
|
|
314
|
+
```
|
|
315
|
+
|
|
316
|
+
### Forcing a manual check
|
|
317
|
+
|
|
318
|
+
```bash
|
|
319
|
+
# Block on a single registry fetch; print the banner if outdated
|
|
320
|
+
npx @chankov/agent-fleet check-update
|
|
321
|
+
|
|
322
|
+
# Bypass the cache entirely
|
|
323
|
+
rm ~/.cache/agent-fleet/latest-version.json
|
|
324
|
+
npx @chankov/agent-fleet check-update
|
|
325
|
+
```
|
|
326
|
+
|
|
327
|
+
## Troubleshooting
|
|
328
|
+
|
|
329
|
+
- **"Could not auto-detect your coding agent."** Pass `--agent` or run
|
|
330
|
+
`init` from a workspace that already has one of `.claude/`, `.opencode/`,
|
|
331
|
+
or `.pi/`.
|
|
332
|
+
- **`update` says "no install record".** Run `init` once first; the install
|
|
333
|
+
record is what `update` reads.
|
|
334
|
+
- **The version-aware menu shows `(snapshot missing)`.** The recorded version
|
|
335
|
+
is older than the snapshot retention in this package. The skill falls back
|
|
336
|
+
to "treat installed copy as canonical" — refresh manually if you want to
|
|
337
|
+
reset the baseline.
|
|
@@ -0,0 +1,249 @@
|
|
|
1
|
+
# OpenCode Setup
|
|
2
|
+
|
|
3
|
+
This guide explains how to use Agent Fleet with OpenCode in a way that closely mirrors the Claude Code experience (automatic skill selection, lifecycle-driven workflows, and strict process enforcement).
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
OpenCode supports custom `/commands`, but does not have a native plugin system or automatic skill routing like Claude Code.
|
|
8
|
+
|
|
9
|
+
Instead, we achieve parity through:
|
|
10
|
+
|
|
11
|
+
- A strong system prompt (`AGENTS.md`)
|
|
12
|
+
- The built-in `skill` tool
|
|
13
|
+
- Consistent skill discovery from the `/skills` directory
|
|
14
|
+
- Optional prefixed slash commands from `.opencode/commands/`
|
|
15
|
+
|
|
16
|
+
This creates an **agent-driven workflow** where skills are selected and executed automatically, with optional explicit lifecycle commands when you want them.
|
|
17
|
+
|
|
18
|
+
This integration defaults to an agent-driven approach:
|
|
19
|
+
|
|
20
|
+
- Skills are selected automatically based on intent
|
|
21
|
+
- Workflows are enforced via `AGENTS.md`
|
|
22
|
+
- Manual command invocation is optional, not required
|
|
23
|
+
|
|
24
|
+
This more closely matches how Claude Code behaves in practice, while still allowing explicit OpenCode slash commands.
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## Installation
|
|
29
|
+
|
|
30
|
+
1. Clone the repository:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
git clone https://github.com/chankov/agent-fleet.git
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
2. Install the global OpenCode configuration.
|
|
37
|
+
|
|
38
|
+
Set `AGENT_SKILLS_DIR` to wherever you cloned the repo (used in the snippets below):
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
export AGENT_SKILLS_DIR="/path/to/agent-fleet"
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Add the repo's `AGENTS.md` to your global `~/.config/opencode/opencode.json` instructions list (replace `/path/to/agent-fleet` with the absolute path on your machine — `~` is not expanded inside JSON):
|
|
45
|
+
|
|
46
|
+
```json
|
|
47
|
+
{
|
|
48
|
+
"instructions": [
|
|
49
|
+
"/path/to/agent-fleet/AGENTS.md"
|
|
50
|
+
],
|
|
51
|
+
"permission": {
|
|
52
|
+
"skill": {
|
|
53
|
+
"*": "allow"
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Link the skills and commands into your global OpenCode config directory. Symlinking individual files (rather than the whole directory) avoids replacing skills or commands you may already have installed from other sources:
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
mkdir -p ~/.config/opencode/skills ~/.config/opencode/commands
|
|
63
|
+
|
|
64
|
+
# Skills: link each skill directory individually.
|
|
65
|
+
for d in "$AGENT_SKILLS_DIR"/skills/*/; do
|
|
66
|
+
ln -s "$d" "$HOME/.config/opencode/skills/$(basename "$d")"
|
|
67
|
+
done
|
|
68
|
+
|
|
69
|
+
# Commands: link each command file individually.
|
|
70
|
+
for f in "$AGENT_SKILLS_DIR"/.opencode/commands/*.md; do
|
|
71
|
+
ln -s "$f" "$HOME/.config/opencode/commands/$(basename "$f")"
|
|
72
|
+
done
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
> ⚠️ If you already have `~/.config/opencode/skills` or `~/.config/opencode/commands` populated from other sources, do **not** replace the whole directory — use the per-file symlink approach above. The previous `ln -sfn <dir>` shortcut would silently overwrite the existing directory.
|
|
76
|
+
|
|
77
|
+
3. Restart OpenCode.
|
|
78
|
+
|
|
79
|
+
4. Open any project in OpenCode.
|
|
80
|
+
|
|
81
|
+
5. The following Agent Fleet assets are now available globally:
|
|
82
|
+
|
|
83
|
+
- `AGENTS.md` instructions from the repo root
|
|
84
|
+
- All skills from `skills/`
|
|
85
|
+
- Optional prefixed slash commands from `.opencode/commands/`
|
|
86
|
+
|
|
87
|
+
### Optional Slash Commands
|
|
88
|
+
|
|
89
|
+
This repo ships OpenCode-native commands with an `af-` prefix so they are easy to distinguish from other commands:
|
|
90
|
+
|
|
91
|
+
- `/af-spec`
|
|
92
|
+
- `/af-plan`
|
|
93
|
+
- `/af-build`
|
|
94
|
+
- `/af-test`
|
|
95
|
+
- `/af-review`
|
|
96
|
+
- `/af-code-simplify`
|
|
97
|
+
- `/af-ship`
|
|
98
|
+
- `/af-webperf`
|
|
99
|
+
- `/af-design-agent`
|
|
100
|
+
- `/af-orchestrate`
|
|
101
|
+
- `/af-prime`
|
|
102
|
+
- `/af-setup-agent-fleet`
|
|
103
|
+
- `/af-doctor-agent-fleet`
|
|
104
|
+
- `/af-set-hermes-telegram install|status|on|off …` — profile-aware Hermes liaison setup and bridge control
|
|
105
|
+
|
|
106
|
+
These commands are optional shortcuts. The agent can still invoke the correct skills automatically from plain natural-language requests.
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
## How It Works
|
|
111
|
+
|
|
112
|
+
### 1. Skill Discovery
|
|
113
|
+
|
|
114
|
+
All skills live in:
|
|
115
|
+
|
|
116
|
+
```
|
|
117
|
+
skills/<skill-name>/SKILL.md
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
OpenCode agents are instructed (via `AGENTS.md`) to:
|
|
121
|
+
|
|
122
|
+
- Detect when a skill applies
|
|
123
|
+
- Invoke the `skill` tool
|
|
124
|
+
- Follow the skill exactly
|
|
125
|
+
|
|
126
|
+
### 2. Automatic Skill Invocation
|
|
127
|
+
|
|
128
|
+
The agent evaluates every request and maps it to the appropriate skill.
|
|
129
|
+
|
|
130
|
+
Examples:
|
|
131
|
+
|
|
132
|
+
- "build a feature" → `incremental-implementation` + `test-driven-development`
|
|
133
|
+
- "design a system" → `spec-driven-development`
|
|
134
|
+
- "fix a bug" → `debugging-and-error-recovery`
|
|
135
|
+
- "review this code" → `code-review-and-quality`
|
|
136
|
+
|
|
137
|
+
The user does **not** need to explicitly request skills.
|
|
138
|
+
|
|
139
|
+
### 3. Lifecycle Mapping
|
|
140
|
+
|
|
141
|
+
The development lifecycle is encoded implicitly via `AGENTS.md` and is also exposed through optional prefixed slash commands. Both routes invoke the same underlying skills:
|
|
142
|
+
|
|
143
|
+
| Lifecycle phase | Claude Code command | OpenCode command | Underlying skill(s) |
|
|
144
|
+
| --------------- | ------------------- | ------------------ | ------------------------------------------------------------- |
|
|
145
|
+
| DEFINE | `/spec` | `/af-spec` | `spec-driven-development` |
|
|
146
|
+
| PLAN | `/plan` | `/af-plan` | `planning-and-task-breakdown` |
|
|
147
|
+
| BUILD | `/build` | `/af-build` | `incremental-implementation` + `test-driven-development` |
|
|
148
|
+
| TEST | `/test` | `/af-test` | `test-driven-development` |
|
|
149
|
+
| VERIFY | — | — | `debugging-and-error-recovery` (implicit on failure) |
|
|
150
|
+
| REVIEW | `/review` | `/af-review` | `code-review-and-quality` |
|
|
151
|
+
| SIMPLIFY | `/code-simplify` | `/af-code-simplify`| `code-simplification` |
|
|
152
|
+
| SHIP | `/ship` | `/af-ship` | `shipping-and-launch` |
|
|
153
|
+
| WEBPERF | `/webperf` | `/af-webperf` | `web-performance-auditor` persona (`performance-optimization`) |
|
|
154
|
+
| AUTHOR | `/design-agent` | `/af-design-agent` | `designing-agents` |
|
|
155
|
+
| ORCHESTRATE | `/orchestrate` | `/af-orchestrate` | `orchestration-verification` |
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## Usage Examples
|
|
160
|
+
|
|
161
|
+
### Example 1: Feature Development
|
|
162
|
+
|
|
163
|
+
User:
|
|
164
|
+
```
|
|
165
|
+
Add authentication to this app
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
Agent behavior:
|
|
169
|
+
- Detects feature work
|
|
170
|
+
- Invokes `spec-driven-development`
|
|
171
|
+
- Produces a spec before writing code
|
|
172
|
+
- Moves to planning and implementation skills
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
### Example 2: Bug Fix
|
|
177
|
+
|
|
178
|
+
User:
|
|
179
|
+
```
|
|
180
|
+
This endpoint is returning 500 errors
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
Agent behavior:
|
|
184
|
+
- Invokes `debugging-and-error-recovery`
|
|
185
|
+
- Reproduces → localizes → fixes → adds guards
|
|
186
|
+
|
|
187
|
+
---
|
|
188
|
+
|
|
189
|
+
### Example 3: Code Review
|
|
190
|
+
|
|
191
|
+
User:
|
|
192
|
+
```
|
|
193
|
+
Review this PR
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
Agent behavior:
|
|
197
|
+
- Invokes `code-review-and-quality`
|
|
198
|
+
- Applies structured review (correctness, design, readability, etc.)
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
## Agent Expectations (Critical)
|
|
203
|
+
|
|
204
|
+
For OpenCode to work correctly, the agent must follow these rules:
|
|
205
|
+
|
|
206
|
+
- Always check if a skill applies before acting
|
|
207
|
+
- If a skill applies, it MUST be used
|
|
208
|
+
- Never skip required workflows (spec, plan, test, etc.)
|
|
209
|
+
- Do not jump directly to implementation
|
|
210
|
+
|
|
211
|
+
These rules are enforced via `AGENTS.md`.
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
## Limitations
|
|
216
|
+
|
|
217
|
+
- No plugin system (handled via prompt + structure)
|
|
218
|
+
- Skill invocation depends on model compliance
|
|
219
|
+
|
|
220
|
+
Despite these, the workflow closely matches Claude Code in practice.
|
|
221
|
+
|
|
222
|
+
---
|
|
223
|
+
|
|
224
|
+
## Recommended Workflow
|
|
225
|
+
|
|
226
|
+
Just use natural language:
|
|
227
|
+
|
|
228
|
+
- "Design a feature"
|
|
229
|
+
- "Plan this change"
|
|
230
|
+
- "Implement this"
|
|
231
|
+
- "Fix this bug"
|
|
232
|
+
- "Review this"
|
|
233
|
+
|
|
234
|
+
The agent will automatically select and execute the correct skills.
|
|
235
|
+
|
|
236
|
+
If you prefer explicit entry points, use the shipped slash commands such as `/af-spec`, `/af-plan`, or `/af-review`.
|
|
237
|
+
|
|
238
|
+
---
|
|
239
|
+
|
|
240
|
+
## Summary
|
|
241
|
+
|
|
242
|
+
OpenCode integration works by combining:
|
|
243
|
+
|
|
244
|
+
- Structured skills (this repo)
|
|
245
|
+
- Strong agent rules (`AGENTS.md`)
|
|
246
|
+
- Automatic skill invocation via reasoning
|
|
247
|
+
- Optional `af-` prefixed slash commands for explicit lifecycle entry points
|
|
248
|
+
|
|
249
|
+
This results in a **production-grade engineering workflow** that works both as an agent-driven system and as an explicit command-driven workflow.
|