@chankov/agent-fleet 0.0.11 → 1.0.0
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 +26 -25
- package/.pi/extensions/btw/index.ts +80 -83
- package/.pi/extensions/pi-voice-stt/README.md +4 -3
- package/.pi/extensions/pi-voice-stt/config.ts +1 -1
- package/.pi/harnesses/agent-hub/README.md +106 -54
- package/.pi/harnesses/agent-hub/backend-policy.js +25 -4
- package/.pi/harnesses/agent-hub/footer.ts +4 -0
- package/.pi/harnesses/agent-hub/helpers.ts +18 -0
- package/.pi/harnesses/agent-hub/index.ts +537 -369
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.pi/harnesses/ask-user-remote/README.md +37 -3
- package/.pi/harnesses/ask-user-remote/index.ts +173 -17
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.pi/harnesses/package-lock.json +2011 -0
- package/.pi/harnesses/package.json +1 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +4 -3
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +1 -1
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +37 -3
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +173 -17
- package/.versions/0.0.11/.pi/harnesses/package-lock.json +2011 -0
- package/.versions/0.0.11/.pi/harnesses/package.json +1 -0
- package/.versions/0.0.11/docs/ARCHITECTURE.md +6 -8
- package/.versions/0.0.11/docs/agent-fleet-setup.md +17 -43
- package/.versions/0.0.11/docs/claude-code-coms-bridge.md +20 -2
- package/.versions/0.0.11/docs/coms-hermes-bridge.md +1 -1
- package/.versions/0.0.11/docs/getting-started.md +26 -237
- package/.versions/0.0.11/docs/npm-install.md +60 -478
- package/.versions/0.0.11/docs/pi-extensions.md +4 -4
- package/.versions/0.0.11/docs/pi-setup.md +37 -551
- package/.versions/0.0.11/hermes/README.md +1 -1
- package/.versions/0.0.11/install-manifest.json +375 -1247
- package/.versions/0.0.11/justfile +13 -6
- package/.versions/0.0.11/manifest-meta.json +543 -134
- package/.versions/0.0.11/scripts/lib/fleet-command.ts +8 -0
- package/.versions/0.0.11/scripts/lib/monitor-env.ts +18 -6
- package/.versions/0.0.11/skills/designing-agents/SKILL.md +1 -1
- package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +1 -1
- package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
- package/.versions/1.0.0/.pi/extensions/package.json +9 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
- package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
- package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
- package/{.claude/commands/code-simplify.md → .versions/1.0.0/.pi/prompts/af-code-simplify.md} +3 -3
- package/{.claude/commands/plan.md → .versions/1.0.0/.pi/prompts/af-plan.md} +1 -1
- package/.versions/{0.0.11/.claude/commands/review.md → 1.0.0/.pi/prompts/af-review.md} +3 -3
- package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
- package/.versions/{0.0.11/.claude/commands/spec.md → 1.0.0/.pi/prompts/af-spec.md} +1 -1
- package/.versions/{0.0.11/.claude/commands/test.md → 1.0.0/.pi/prompts/af-test.md} +2 -2
- package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.0/.version +1 -0
- package/.versions/1.0.0/agents/architect.md +24 -0
- package/.versions/1.0.0/agents/bowser.md +27 -0
- package/.versions/1.0.0/agents/builder.md +54 -0
- package/.versions/1.0.0/agents/code-reviewer.md +208 -0
- package/.versions/1.0.0/agents/deep-researcher.md +32 -0
- package/.versions/1.0.0/agents/documenter.md +18 -0
- package/.versions/1.0.0/agents/orchestrator.md +72 -0
- package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.0/agents/planner.md +70 -0
- package/.versions/1.0.0/agents/releaser.md +24 -0
- package/.versions/1.0.0/agents/researcher.md +28 -0
- package/.versions/1.0.0/agents/security-auditor.md +167 -0
- package/.versions/1.0.0/agents/test-engineer.md +153 -0
- package/.versions/1.0.0/agents/web-debugger.md +43 -0
- package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
- package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
- package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.0/docs/getting-started.md +98 -0
- package/.versions/1.0.0/docs/npm-install.md +292 -0
- package/.versions/1.0.0/docs/pi-extensions.md +412 -0
- package/.versions/1.0.0/docs/pi-setup.md +74 -0
- package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.0/hermes/README.md +347 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.0/install-manifest.json +2745 -0
- package/.versions/1.0.0/justfile +272 -0
- package/.versions/1.0.0/manifest-meta.json +882 -0
- package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.0/references/definition-of-done.md +67 -0
- package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.0/references/observability-checklist.md +91 -0
- package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.0/references/performance-checklist.md +153 -0
- package/.versions/1.0.0/references/prompting-patterns.md +380 -0
- package/.versions/1.0.0/references/security-checklist.md +179 -0
- package/.versions/1.0.0/references/testing-patterns.md +236 -0
- package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.0/scripts/fleet.ts +185 -0
- package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.0/scripts/team-up.ts +406 -0
- package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +142 -0
- package/README.md +117 -79
- package/agents/orchestrator.md +1 -1
- package/bin/cli.js +289 -359
- package/bin/force-patch-changesets.js +18 -2
- package/bin/lib/apply.js +86 -32
- package/bin/lib/desired.js +87 -0
- package/bin/lib/detect-agent.js +22 -38
- package/bin/lib/doctor.js +283 -33
- package/bin/lib/features.js +78 -0
- package/bin/lib/manifest.js +127 -48
- package/bin/lib/overrides.js +35 -0
- package/bin/lib/personas.js +37 -0
- package/bin/lib/plan.js +18 -9
- package/bin/lib/purge.js +11 -0
- package/bin/lib/reconcile.js +68 -0
- package/bin/lib/scan.js +24 -0
- package/bin/lib/state.js +25 -1
- package/bin/lib/stt-wizard.js +33 -0
- package/bin/lib/transaction.js +149 -0
- package/bin/lib/tui.js +71 -0
- package/bin/lib/verify.js +9 -26
- package/bin/snapshot-version.js +3 -6
- package/docs/ARCHITECTURE.md +55 -21
- package/docs/MIGRATION-agent-fleet.md +222 -0
- package/docs/agent-fleet-setup.md +124 -64
- package/docs/claude-code-coms-bridge.md +21 -2
- package/docs/coms-hermes-bridge.md +1 -1
- package/docs/getting-started.md +61 -217
- package/docs/npm-install.md +207 -429
- package/docs/pi-extensions.md +85 -41
- package/docs/pi-setup.md +48 -545
- package/hermes/README.md +1 -1
- package/install-manifest.json +385 -1255
- package/justfile +45 -27
- package/manifest-meta.json +544 -134
- package/node_modules/pi-ask-user/README.md +43 -5
- package/node_modules/pi-ask-user/index.ts +630 -75
- package/node_modules/pi-ask-user/package.json +1 -1
- package/package.json +5 -11
- package/scripts/coms-claude-bridge.ts +10 -0
- package/scripts/fleet.ts +107 -90
- package/scripts/lib/claude-bridge-core.ts +45 -0
- package/scripts/lib/fleet-command.ts +170 -15
- package/scripts/lib/monitor-env.ts +18 -6
- package/scripts/lib/peer-launch.ts +6 -2
- package/scripts/lib/team-project.ts +24 -4
- package/scripts/team-up.ts +57 -11
- package/skills/designing-agents/SKILL.md +1 -1
- package/skills/designing-agents/pi-harness-authoring.md +3 -3
- package/.claude/commands/build.md +0 -44
- package/.claude/commands/design-agent.md +0 -14
- package/.claude/commands/doctor-agent-fleet.md +0 -22
- package/.claude/commands/orchestrate.md +0 -112
- package/.claude/commands/prime.md +0 -22
- package/.claude/commands/review.md +0 -16
- package/.claude/commands/set-hermes-telegram.md +0 -15
- package/.claude/commands/set-hermes-watchdog.md +0 -6
- package/.claude/commands/setup-agent-fleet.md +0 -17
- package/.claude/commands/ship.md +0 -72
- package/.claude/commands/spec.md +0 -15
- package/.claude/commands/test.md +0 -19
- package/.claude/commands/webperf.md +0 -32
- package/.claude/orchestrate-teams.yaml +0 -24
- package/.opencode/commands/af-build.md +0 -17
- package/.opencode/commands/af-code-simplify.md +0 -16
- package/.opencode/commands/af-compound.md +0 -16
- package/.opencode/commands/af-design-agent.md +0 -15
- package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
- package/.opencode/commands/af-orchestrate.md +0 -112
- package/.opencode/commands/af-plan.md +0 -16
- package/.opencode/commands/af-prime.md +0 -22
- package/.opencode/commands/af-review.md +0 -15
- package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
- package/.opencode/commands/af-setup-agent-fleet.md +0 -17
- package/.opencode/commands/af-ship.md +0 -16
- package/.opencode/commands/af-spec.md +0 -16
- package/.opencode/commands/af-test.md +0 -21
- package/.opencode/commands/af-webperf.md +0 -32
- package/.opencode/orchestrate-teams.yaml +0 -24
- package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
- package/.pi/prompts/af-setup-agent-fleet.md +0 -19
- package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
- package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
- package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
- package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
- package/.versions/0.0.11/.claude/commands/build.md +0 -44
- package/.versions/0.0.11/.claude/commands/code-simplify.md +0 -22
- package/.versions/0.0.11/.claude/commands/design-agent.md +0 -14
- package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +0 -22
- package/.versions/0.0.11/.claude/commands/orchestrate.md +0 -112
- package/.versions/0.0.11/.claude/commands/plan.md +0 -16
- package/.versions/0.0.11/.claude/commands/prime.md +0 -22
- package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +0 -15
- package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +0 -6
- package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +0 -17
- package/.versions/0.0.11/.claude/commands/ship.md +0 -72
- package/.versions/0.0.11/.claude/commands/webperf.md +0 -32
- package/.versions/0.0.11/.claude/orchestrate-teams.yaml +0 -24
- package/.versions/0.0.11/.opencode/commands/af-build.md +0 -17
- package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-compound.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-design-agent.md +0 -15
- package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +0 -112
- package/.versions/0.0.11/.opencode/commands/af-plan.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-prime.md +0 -22
- package/.versions/0.0.11/.opencode/commands/af-review.md +0 -15
- package/.versions/0.0.11/.opencode/commands/af-set-hermes-telegram.md +0 -15
- package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +0 -6
- package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +0 -17
- package/.versions/0.0.11/.opencode/commands/af-ship.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-spec.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-test.md +0 -21
- package/.versions/0.0.11/.opencode/commands/af-webperf.md +0 -32
- package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +0 -24
- package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +0 -19
- package/.versions/0.0.11/docs/opencode-setup.md +0 -281
- package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +0 -90
- package/.versions/0.0.11/hooks/hooks.json +0 -14
- package/.versions/0.0.11/hooks/session-start.sh +0 -74
- package/.versions/0.0.11/hooks/simplify-ignore.sh +0 -302
- package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +0 -226
- package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
- package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
- package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
- package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
- package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
- package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +0 -36
- package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
- package/bin/lib/bootstrap.js +0 -323
- package/bin/lib/transform-persona.js +0 -180
- package/docs/opencode-setup.md +0 -281
- package/hooks/SIMPLIFY-IGNORE.md +0 -90
- package/hooks/hooks.json +0 -14
- package/hooks/session-start.sh +0 -74
- package/hooks/simplify-ignore.sh +0 -302
- package/skills/guided-workspace-setup/SKILL.md +0 -226
- /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
- /package/.versions/0.0.11/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
- /package/{.opencode/commands → .versions/1.0.0/.pi/prompts}/af-set-hermes-telegram.md +0 -0
- /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
- /package/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
|
@@ -1,571 +1,57 @@
|
|
|
1
|
-
# pi
|
|
1
|
+
# pi setup
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Agent Fleet is pi-first. Its deterministic lifecycle writes copied workspace
|
|
4
|
+
artifacts; the package-native path exposes skills/prompts directly.
|
|
4
5
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
The specialist **personas** in `agents/` — including `web-performance-auditor` — are available to pi as well and are invoked directly as subagents. Note that `/webperf` on Claude Code (`/af-webperf` on OpenCode) does not have a Pi `.pi/prompts` equivalent; on pi you run the same audit by invoking the `web-performance-auditor` persona.
|
|
8
|
-
|
|
9
|
-
## Overview
|
|
10
|
-
|
|
11
|
-
pi natively supports:
|
|
12
|
-
|
|
13
|
-
- `AGENTS.md` / `CLAUDE.md` context files (auto-loaded from cwd, parent dirs, and global config)
|
|
14
|
-
- Skill discovery from well-known directories (`.agents/skills/`, `.pi/skills/`, `~/.pi/agent/skills/`)
|
|
15
|
-
- Explicit skill invocation via `/skill:<name>`
|
|
16
|
-
- Automatic skill loading by the model when intent matches
|
|
17
|
-
- Prompt-template slash commands from `.pi/prompts/*.md`
|
|
18
|
-
|
|
19
|
-
This means you get near-parity with Claude Code:
|
|
20
|
-
|
|
21
|
-
- Skills are selected automatically based on intent
|
|
22
|
-
- Workflows are enforced via `AGENTS.md`
|
|
23
|
-
- Users can explicitly trigger any skill with `/skill:<name>`
|
|
24
|
-
- Users can start lifecycle workflows with `/af-spec`, `/af-plan`, `/af-build`, `/af-test`, `/af-review`, `/af-code-simplify`, and `/af-ship`
|
|
25
|
-
|
|
26
|
-
No plugin, wrapper, or custom system prompt is required for the core workflow.
|
|
27
|
-
|
|
28
|
-
### Slash-command namespace
|
|
29
|
-
|
|
30
|
-
Agent Fleet owns the lowercase `/af-*` namespace on Pi. This keeps its prompt-template and harness commands distinct from Pi built-ins such as `/model` and `/settings`, skill invocations under `/skill:<name>`, and commands contributed by other installed packages. Examples: `/af-spec`, `/af-agents-list`, and `/af-allow`.
|
|
31
|
-
|
|
32
|
-
**Recommended companion packages:** [`pi-ask-user`](https://github.com/edlsh/pi-ask-user) adds an interactive `ask_user` tool and bundles an `ask-user` skill. It is bundled automatically when you install `@chankov/agent-fleet` as a pi package; clone setups should install it separately. `pi-codex-image-gen` is an optional suggested npm/pi extension for image generation; guided setup can offer it when package installation is available, but it is not bundled or required.
|
|
33
|
-
|
|
34
|
-
**Experimental phone conductor:** Linux users may pair Codex CLI `0.144.x` with ChatGPT Android to perform human-confirmed outbound delegation to live coms peers. Guided setup installs the repository assets when pi harnesses are selected, but deliberately never changes systemd, Codex auth/config, pairing, or service state. Host setup remains an explicit operator flow; see [Codex Remote-Control Conductor](codex-remote-conductor.md).
|
|
35
|
-
|
|
36
|
-
---
|
|
37
|
-
|
|
38
|
-
## Installation
|
|
39
|
-
|
|
40
|
-
There are three pi paths: the CLI installer (everything, per workspace), the
|
|
41
|
-
first-class pi package (skills + prompts, package-native), and a clone for
|
|
42
|
-
contributors. They compose — most pi users run the first two together.
|
|
43
|
-
|
|
44
|
-
### The `agent-fleet` CLI (recommended — this is what installs the fleet)
|
|
45
|
-
|
|
46
|
-
The CLI is the whole installer: it decides the paths, computes per-item state,
|
|
47
|
-
does the three-way merge, and performs every write. A complete install needs no
|
|
48
|
-
coding agent and no model.
|
|
49
|
-
|
|
50
|
-
```bash
|
|
51
|
-
cd /path/to/your-project
|
|
52
|
-
|
|
53
|
-
# Guided: bootstraps the installer command, then run /af-setup-agent-fleet in pi
|
|
54
|
-
npx @chankov/agent-fleet init --agent pi
|
|
55
|
-
|
|
56
|
-
# Or straight to it — no agent, no model, no prompts:
|
|
57
|
-
npx @chankov/agent-fleet install --agent pi --profile recommended --yes
|
|
58
|
-
npx @chankov/agent-fleet install --agent pi --profile pi-fleet-core --yes # the harness stack
|
|
59
|
-
npx @chankov/agent-fleet verify --agent pi
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
Where it writes, for pi:
|
|
63
|
-
|
|
64
|
-
| Artifact | Target | Item id prefix |
|
|
65
|
-
|---|---|---|
|
|
66
|
-
| Skills | `.pi/skills/<name>/` | `skill:` |
|
|
67
|
-
| Lifecycle prompts | `.pi/prompts/af-<name>.md` | `command:` |
|
|
68
|
-
| Personas | `agents/<name>.md` (canonical, copied unchanged) | `persona:` |
|
|
69
|
-
| pi runtime skills | `.pi/skills/<name>/` | `pi-runtime-skill:` |
|
|
70
|
-
| Utility extensions | `.pi/extensions/<name>/` | `pi-extension:` |
|
|
71
|
-
| Session harnesses | `.pi/harnesses/<name>/` + the `justfile` managed region | `pi-harness:` |
|
|
72
|
-
|
|
73
|
-
Profiles: `minimal`, `recommended`, `full`, `pi-fleet-core` (`agent-hub`,
|
|
74
|
-
`damage-control-continue`, `ask-user-remote`, `coms`, plus the utilities the hub
|
|
75
|
-
expects), `hermes-plugins` and `codex-bridge` (both **operator-applied** — the plan
|
|
76
|
-
prints the exact commands for a human and the engine touches nothing outside the
|
|
77
|
-
workspace). Narrow any of them with `--items pi-harness:agent-hub,pi-extension:btw`,
|
|
78
|
-
and preview with `--dry-run`.
|
|
79
|
-
|
|
80
|
-
**Artifacts install as copies.** Keep them current with `agent-fleet upgrade`: it
|
|
81
|
-
three-way merges the version recorded in `.ai/agent-fleet-state.json` against the
|
|
82
|
-
installed copy and the current package, so a file you edited is preserved, and a
|
|
83
|
-
file that moved on both sides is a conflict — the incoming version is written as
|
|
84
|
-
`<file>.new`, yours is untouched, and the run exits `3`. `agent-fleet doctor --fix`
|
|
85
|
-
repairs missing or dangling items through the same write path a fresh install uses.
|
|
86
|
-
|
|
87
|
-
Removing a harness or extension is `agent-fleet uninstall --items pi-harness:coms`;
|
|
88
|
-
it refuses to strip something another installed item depends on (you cannot remove
|
|
89
|
-
`damage-control-continue` while `agent-hub` is installed), and removing the last pi
|
|
90
|
-
harness also strips the `agent-fleet:harnesses` region from the `justfile`.
|
|
91
|
-
|
|
92
|
-
Full CLI reference — every flag, every exit code, CI usage: [npm-install.md](npm-install.md).
|
|
93
|
-
|
|
94
|
-
### First-class pi package (skills and prompts, package-native)
|
|
95
|
-
|
|
96
|
-
Install this package directly with pi:
|
|
97
|
-
|
|
98
|
-
```bash
|
|
99
|
-
# Project-scoped (recommended for repositories)
|
|
100
|
-
pi install -l npm:@chankov/agent-fleet
|
|
101
|
-
|
|
102
|
-
# Or global, if you want it in every pi session
|
|
103
|
-
pi install npm:@chankov/agent-fleet
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
The npm pi package includes this repo's core skills, pi runtime skills, lifecycle prompts, and the bundled `pi-ask-user` package. That means `ask_user` and the `ask-user` skill are available from the same install; do not install `pi-ask-user` a second time unless you intentionally want a separate user/project package entry.
|
|
107
|
-
|
|
108
|
-
This package's pi manifest is intentionally conservative: it exposes skills, `.pi/skills`, `.pi/prompts`, and bundled `pi-ask-user` resources. It does **not** auto-expose this repo's `.pi/extensions` or harnesses, because those have their own runtime dependency setup and should still be installed explicitly through guided setup or the manual extension steps below. It also does **not** bundle or require `pi-codex-image-gen`; guided setup may suggest installing that external package with `pi install -l npm:pi-codex-image-gen` only when package installation is available and the user selects it.
|
|
109
|
-
|
|
110
|
-
### Clone setup (for contributors)
|
|
111
|
-
|
|
112
|
-
Clone when you want to **edit** the skills, personas, prompts, and harnesses
|
|
113
|
-
themselves. The clone is both the working tree and the install source: run its
|
|
114
|
-
own CLI and it installs from that checkout instead of from a published tarball.
|
|
115
|
-
|
|
116
|
-
1. Clone the repository somewhere stable and install its runtime deps:
|
|
6
|
+
## Lifecycle install
|
|
117
7
|
|
|
118
8
|
```bash
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
9
|
+
npx @chankov/agent-fleet@latest setup
|
|
10
|
+
npx @chankov/agent-fleet@1.0.0 setup --preset default --features none --yes
|
|
11
|
+
npx @chankov/agent-fleet@1.0.0 setup --preset full --features none --yes
|
|
122
12
|
```
|
|
123
13
|
|
|
124
|
-
|
|
125
|
-
|
|
14
|
+
Default is launchable Fleet Core and does not create `.claude/` or voice
|
|
15
|
+
configuration. Full selects stable, platform-applicable roots and may add the
|
|
16
|
+
recorded Claude Code coms bridge. Feature flags are named additions over a
|
|
17
|
+
preset; they are not an arbitrary package picker. Flags do not rewrite an
|
|
18
|
+
existing desired file unless `--save-desired` is explicit.
|
|
126
19
|
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
20
|
+
The installer owns only paths in `.ai/agent-fleet-state.json`. Normal uninstall
|
|
21
|
+
preserves `.ai/agent-fleet.json`, `.ai/agent-fleet-overrides.md`, `.ai/stt.json`,
|
|
22
|
+
and environment files. See [npm-install.md](npm-install.md) for `--migrate`,
|
|
23
|
+
`--purge-config`, doctor exits, and self-uninstall recovery.
|
|
131
24
|
|
|
132
|
-
|
|
25
|
+
## Runtime closure
|
|
133
26
|
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
**Inside the clone itself**, `--method symlink` is available — that is the one
|
|
139
|
-
workspace where editing an installed artifact is *meant* to edit the source.
|
|
140
|
-
Everywhere else it is refused: a link target can never move again, an npx cache
|
|
141
|
-
clean breaks every link at once, a `git pull` silently rewrites artifacts the
|
|
142
|
-
project never agreed to change, and Windows needs Developer Mode. A workspace
|
|
143
|
-
that recorded symlinks before this restriction is re-materialised as real files
|
|
144
|
-
on its next `install` or `upgrade`.
|
|
145
|
-
|
|
146
|
-
Whichever way you install, the prompts land in `.pi/prompts/` and expose:
|
|
147
|
-
|
|
148
|
-
```text
|
|
149
|
-
/af-spec
|
|
150
|
-
/af-plan
|
|
151
|
-
/af-build
|
|
152
|
-
/af-test
|
|
153
|
-
/af-review
|
|
154
|
-
/af-code-simplify
|
|
155
|
-
/af-ship
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
An existing `.pi/prompts/` directory is not a problem — the installer writes one
|
|
159
|
-
file per selected command and never replaces the directory. Anything it did not
|
|
160
|
-
write is not recorded, and therefore never removed or overwritten.
|
|
161
|
-
|
|
162
|
-
4. Install the recommended `pi-ask-user` pi package separately (clone setup only):
|
|
27
|
+
`just fleet` is the guarded Fleet Core launcher. It explicitly loads
|
|
28
|
+
`damage-control-continue`, `ask-user-remote`, compact-and-continue, BTW, and
|
|
29
|
+
the update checker. Voice is not a Default Core dependency. `just fleet hub`
|
|
30
|
+
adds agent-hub; `just fleet peer` adds coms; `just fleet team` uses Herdr.
|
|
163
31
|
|
|
164
32
|
```bash
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
# Or global, if your pi setup is global
|
|
169
|
-
pi install npm:pi-ask-user
|
|
33
|
+
just fleet help
|
|
34
|
+
just fleet doctor
|
|
35
|
+
just fleet uninstall --yes
|
|
170
36
|
```
|
|
171
37
|
|
|
172
|
-
|
|
38
|
+
Self-uninstall removes the managed justfile region and dispatcher scripts last,
|
|
39
|
+
so its report completes. Restore it only through `npx @chankov/agent-fleet
|
|
40
|
+
setup ...`; then `just fleet doctor` is available again.
|
|
173
41
|
|
|
174
|
-
|
|
42
|
+
## Package-native skills and prompts
|
|
175
43
|
|
|
176
44
|
```bash
|
|
177
|
-
pi install -l npm
|
|
178
|
-
```
|
|
179
|
-
|
|
180
|
-
This package is not bundled by `@chankov/agent-fleet` and is not needed for minimal setup.
|
|
181
|
-
|
|
182
|
-
5. Verify pi can see everything:
|
|
183
|
-
|
|
184
|
-
```bash
|
|
185
|
-
pi
|
|
186
|
-
# then type:
|
|
187
|
-
/skill:
|
|
188
|
-
# pi should autocomplete the full list of agent-fleet, plus ask-user if pi packages are enabled
|
|
189
|
-
|
|
190
|
-
# then type:
|
|
191
|
-
/
|
|
192
|
-
# pi should autocomplete /af-spec, /af-plan, /af-build, /af-test, /af-review, /af-code-simplify, and /af-ship
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
That's it. `AGENTS.md` is already at the repo root and is auto-loaded when pi starts.
|
|
196
|
-
|
|
197
|
-
### Optional: pi extensions
|
|
198
|
-
|
|
199
|
-
This repo also ships pi **extensions** under `.pi/extensions/`. Extensions are TypeScript modules that register tools and commands directly with pi. They come in two kinds: **always-on utilities** that layer onto any session, and selectable **harnesses** that reshape a whole session.
|
|
200
|
-
|
|
201
|
-
The always-on utilities:
|
|
202
|
-
|
|
203
|
-
- `mcp-bridge/` — a reusable factory that turns any stdio MCP server into a pi extension. This is a library consumed by wrapper extensions; it is installed alongside the wrappers so relative imports resolve, and when pi discovers it directly it intentionally registers no tools or commands by itself.
|
|
204
|
-
- `chrome-devtools-mcp/` — bridges the [`chrome-devtools-mcp`](https://www.npmjs.com/package/chrome-devtools-mcp) server into pi as native tools, unlocking the `browser-testing-with-devtools` skill on pi.
|
|
205
|
-
- `compact-and-continue/` — registers the `request_compaction` tool that queues pi context compaction to run after the current agent turn ends, optionally resuming work from a self-contained continuation prompt. Used by `/af-build` to offer a "Compact & continue" option at slice-approval time.
|
|
206
|
-
- `agent-fleet-update-check/` — surfaces an "update available" banner once per session when `@chankov/agent-fleet` has a newer published version than the one recorded in `.ai/agent-fleet-setup.md`. Never blocks startup (soft 3s check); honors `AGENT_SKILLS_NO_UPDATE_CHECK` / `NO_UPDATE_NOTIFIER` / `CI` opt-outs.
|
|
207
|
-
- `btw/` — adds the `/af-btw <task>` prompt command (and `Alt+'` shortcut): forks the current session into an in-process sub-session that inherits the full conversation as context, runs in the same cwd, and streams into a live modal with a follow-up composer. A compact result card lands in the main transcript at idle (kept out of the main agent's LLM context). See [.pi/extensions/btw/README.md](../.pi/extensions/btw/README.md).
|
|
208
|
-
|
|
209
|
-
Install them with the CLI — each is one item id:
|
|
210
|
-
|
|
211
|
-
```bash
|
|
212
|
-
npx @chankov/agent-fleet install --agent pi --allow-exec --yes \
|
|
213
|
-
--items pi-extension:mcp-bridge,pi-extension:chrome-devtools-mcp,pi-extension:compact-and-continue,pi-extension:btw,pi-extension:agent-fleet-update-check
|
|
214
|
-
```
|
|
215
|
-
|
|
216
|
-
The extensions are copied into the project's own `.pi/extensions/`. Select
|
|
217
|
-
`mcp-bridge` explicitly whenever you take `chrome-devtools-mcp` — the wrapper
|
|
218
|
-
imports it by relative path, so the bridge has to sit beside it. A companion
|
|
219
|
-
carries the runtime dependencies: `.pi/extensions/package.json` +
|
|
220
|
-
`package-lock.json` are copied in, and `npm ci --prefix .pi/extensions` is run —
|
|
221
|
-
but only with **`--allow-exec`**, because running a command is a separate consent
|
|
222
|
-
class from writing files. Without that flag the plan lists the `npm ci` step and
|
|
223
|
-
skips it; run it yourself afterwards:
|
|
224
|
-
|
|
225
|
-
```bash
|
|
226
|
-
npm ci --prefix .pi/extensions
|
|
227
|
-
```
|
|
228
|
-
|
|
229
|
-
Each project gets its own copy and its own `node_modules`, so a `git pull` in some
|
|
230
|
-
other checkout can no longer change what this project loads.
|
|
231
|
-
|
|
232
|
-
Verify by starting `pi` and running `/af-chrome_devtools-status` — expect `Chrome DevTools MCP connected. Registered N tool(s).`
|
|
233
|
-
|
|
234
|
-
#### Extension harnesses — orchestration, safety, messaging
|
|
235
|
-
|
|
236
|
-
This repo ships **3 supported session harnesses** ported or consolidated from [disler](https://github.com/disler)'s [`pi-vs-claude-code`](https://github.com/disler/pi-vs-claude-code) project (MIT):
|
|
237
|
-
|
|
238
|
-
- **Orchestration** — `agent-hub` (dispatcher grid, specialist delegation, research helpers, persona gate, embedded coms)
|
|
239
|
-
- **Safety** — `damage-control-continue` (fail-closed blocks feed back so the agent can report or safely adapt)
|
|
240
|
-
- **Pi-to-Pi messaging** — `coms` (launched guarded via `just fleet peer <name>`, and embedded in `just fleet hub`)
|
|
241
|
-
|
|
242
|
-
Unlike the utilities above, each harness reshapes the entire pi session, and most are loaded one per session rather than all at once. The supported stack loads `damage-control-continue` and `ask-user-remote` before `agent-hub`; the hub then re-loads continue into every native specialist, research helper, and nested delegate. Protected-path blocks can escalate for explicit approval, while dangerous command patterns remain non-exemptible. Missing child safety refuses dispatch. pi auto-discovers and loads *everything* under `.pi/extensions/`, so the harnesses deliberately live in a separate directory — **`.pi/harnesses/`** — which pi does *not* auto-discover. **Never copy or symlink a harness into `.pi/extensions/`**: that would load it on every plain `pi` run, and stacking all harnesses aborts startup (harnesses that register the same CLI flags clash). The installer already places them correctly:
|
|
243
|
-
|
|
244
|
-
```bash
|
|
245
|
-
npx @chankov/agent-fleet install --agent pi --profile pi-fleet-core --allow-exec --yes
|
|
246
|
-
```
|
|
247
|
-
|
|
248
|
-
That one profile pulls in `agent-hub`, its required `damage-control-continue` and
|
|
249
|
-
`ask-user-remote`, `coms`, and the utilities the hub expects — plus the
|
|
250
|
-
`agent-fleet:harnesses` region in the workspace `justfile` and the `.pi/agents/`
|
|
251
|
-
configs (`teams.yaml`, `peers.yaml`, `dispatch-policy.yaml`). Recipes you wrote
|
|
252
|
-
outside those sentinels are never touched. The one thing it does *not* do for you
|
|
253
|
-
is `pi-voice-stt`'s configuration: the extension is installed, and the plan prints
|
|
254
|
-
the operator steps (write `.ai/stt.json`, put the key in a gitignored `.env`) for
|
|
255
|
-
you to perform. Then load a harness explicitly:
|
|
256
|
-
|
|
257
|
-
```bash
|
|
258
|
-
# from the agent-fleet clone, via the bundled justfile
|
|
259
|
-
just fleet help # unified runtime grammar
|
|
260
|
-
just fleet # guarded Pi + STT and core utilities
|
|
261
|
-
just fleet hub # guarded consolidated multi-agent hub
|
|
262
|
-
just fleet team docs # hub + guarded Herdr peer team
|
|
263
|
-
just --list # confirms the single public Fleet entry point
|
|
264
|
-
|
|
265
|
-
# or directly, from anywhere — point pi -e at the guarded harness stack
|
|
266
|
-
# Advanced/manual equivalent of only the harness part; `just fleet hub` also
|
|
267
|
-
# loads STT, Compact & Continue, BTW, and update-check as Fleet Core utilities.
|
|
268
|
-
pi -e /path/to/agent-fleet/.pi/harnesses/damage-control-continue/index.ts -e /path/to/agent-fleet/.pi/harnesses/ask-user-remote/index.ts -e /path/to/agent-fleet/.pi/harnesses/agent-hub/index.ts
|
|
269
|
-
```
|
|
270
|
-
|
|
271
|
-
**Upgrading from the retired hard-stop harness:** `.pi/harnesses/damage-control/` and
|
|
272
|
-
the old standalone damage-control recipes are no longer shipped. Run
|
|
273
|
-
`npx @chankov/agent-fleet upgrade` (or re-run guided setup, which calls it): only an
|
|
274
|
-
unchanged, recorded copy is removed and the managed `justfile` region is refreshed —
|
|
275
|
-
user-modified and unowned copies are preserved. Use `just fleet` for a standalone
|
|
276
|
-
guarded session.
|
|
277
|
-
|
|
278
|
-
The harnesses have their own runtime dependencies (`yaml`, `@sinclair/typebox`) declared in `.pi/harnesses/package.json` — separate from the extension deps above. `--allow-exec` runs `npm ci --prefix .pi/harnesses` for you as part of the install; without it, run that yourself (or `just install` from a clone, which does both roots). The [pi extension catalog](pi-extensions.md) has the full list, per-extension `README.md` pointers, required environment variables (for `chrome-devtools-mcp`), and what changed from upstream.
|
|
279
|
-
|
|
280
|
-
Each extension — utility or harness — has its own `README.md` describing what it provides.
|
|
281
|
-
|
|
282
|
-
> Why a generic `mcp-bridge` exists: pi does not yet have first-class MCP infrastructure. The bridge is a stopgap that lets pi consume MCP servers today; it will be deprecated once pi gains native MCP support.
|
|
283
|
-
|
|
284
|
-
### Keeping skills up to date
|
|
285
|
-
|
|
286
|
-
Everything the CLI installs is a copy, so refreshing is a command rather than a
|
|
287
|
-
`git pull` side effect:
|
|
288
|
-
|
|
289
|
-
```bash
|
|
290
|
-
npx @chankov/agent-fleet upgrade --dry-run # what would change
|
|
291
|
-
npx @chankov/agent-fleet upgrade --yes
|
|
292
|
-
```
|
|
293
|
-
|
|
294
|
-
`upgrade` acts only on what the workspace already has — it never widens the
|
|
295
|
-
install. A newly catalogued skill or harness shows up as *available* in `verify`
|
|
296
|
-
and is added only by an explicit `install`. It also never eats a local edit: if
|
|
297
|
-
only the source moved you get a clean refresh, if only your copy moved it is
|
|
298
|
-
kept, and if both moved the incoming version lands as `<file>.new` and the run
|
|
299
|
-
exits `3` for you to resolve. Resolve non-interactively with `--accept-theirs`
|
|
300
|
-
or `--accept-ours`.
|
|
301
|
-
|
|
302
|
-
From a clone, the same thing with the clone as source root:
|
|
303
|
-
|
|
304
|
-
```bash
|
|
305
|
-
node /path/to/agent-fleet/bin/cli.js upgrade --workspace /path/to/your-project
|
|
306
|
-
```
|
|
307
|
-
|
|
308
|
-
### Alternative scopes
|
|
309
|
-
|
|
310
|
-
- **pi package, global** — `pi install npm:@chankov/agent-fleet` exposes the skills, `.pi/skills`, and lifecycle prompts to every pi session on the machine, regardless of cwd. This is the supported global path; the CLI installer is deliberately per-workspace and writes nothing to `~/.pi/`.
|
|
311
|
-
- **Global context file** — copy `AGENTS.md` to `~/.pi/agent/AGENTS.md` for machine-wide workflow context. pi concatenates context files, so this is additive to each project's own.
|
|
312
|
-
|
|
313
|
-
### Recommended companion packages
|
|
314
|
-
|
|
315
|
-
If you use clone setup, install `pi-ask-user` with `pi install -l npm:pi-ask-user` unless `pi list` already shows it. If you installed `@chankov/agent-fleet` as a pi package, `pi-ask-user` is already bundled and exposed by this package. In both cases, pi discovers its bundled `ask-user` skill from a pi package, not from vendored files in this repo. This is a strong complement to `agent-fleet` because it gives the agent a structured way to stop and ask for an explicit decision before:
|
|
316
|
-
|
|
317
|
-
- architectural or API trade-offs
|
|
318
|
-
- destructive or costly-to-reverse changes
|
|
319
|
-
- ambiguous requirements
|
|
320
|
-
- preference-dependent implementation choices
|
|
321
|
-
|
|
322
|
-
That matches the repo's current pi setup, where `ask-user` is available as a recommended decision-gating skill.
|
|
323
|
-
|
|
324
|
-
`pi-codex-image-gen` is a separate optional suggested npm/pi extension for image-generation tasks. It is not shipped, bundled, or required by `@chankov/agent-fleet`; choose it during guided setup's External pi packages group (when package installation is available), or install it manually:
|
|
325
|
-
|
|
326
|
-
```bash
|
|
327
|
-
pi install -l npm:pi-codex-image-gen
|
|
328
|
-
```
|
|
329
|
-
|
|
330
|
-
Credit: <https://github.com/jvm/pi-mono>.
|
|
331
|
-
|
|
332
|
-
---
|
|
333
|
-
|
|
334
|
-
## How It Works
|
|
335
|
-
|
|
336
|
-
### 1. Skill Discovery
|
|
337
|
-
|
|
338
|
-
pi searches these locations for skills (all are merged):
|
|
339
|
-
|
|
340
|
-
```
|
|
341
|
-
.agents/skills/ ← this install (walked upward from cwd)
|
|
342
|
-
.pi/skills/ ← project scope
|
|
343
|
-
~/.agents/skills/ ← global convention
|
|
344
|
-
~/.pi/agent/skills/ ← pi global config
|
|
345
|
-
<pi packages> ← bundled/installed pi packages (e.g. `pi-ask-user`, optional `pi-codex-image-gen`)
|
|
346
|
-
```
|
|
347
|
-
|
|
348
|
-
Each skill lives in:
|
|
349
|
-
|
|
350
|
-
```
|
|
351
|
-
skills/<skill-name>/SKILL.md
|
|
352
|
-
```
|
|
353
|
-
|
|
354
|
-
### 2. Context Files
|
|
355
|
-
|
|
356
|
-
`AGENTS.md` (and `CLAUDE.md`) are auto-loaded and concatenated from:
|
|
357
|
-
|
|
358
|
-
- `~/.pi/agent/AGENTS.md` (global)
|
|
359
|
-
- Every parent directory walking up from cwd
|
|
360
|
-
- The current directory
|
|
361
|
-
|
|
362
|
-
The repo's `AGENTS.md` encodes the intent-to-skill mapping and workflow rules that make skill selection behave like Claude Code.
|
|
363
|
-
|
|
364
|
-
### 3. Prompt Templates
|
|
365
|
-
|
|
366
|
-
pi also searches for prompt templates in:
|
|
367
|
-
|
|
368
|
-
```
|
|
369
|
-
.pi/prompts/*.md ← this command install (walked upward from cwd)
|
|
370
|
-
~/.pi/agent/prompts/*.md ← pi global command config
|
|
371
|
-
<pi packages> ← bundled/installed pi packages
|
|
372
|
-
```
|
|
373
|
-
|
|
374
|
-
Each Markdown file becomes a slash command by filename. For example:
|
|
375
|
-
|
|
376
|
-
```
|
|
377
|
-
.pi/prompts/af-spec.md → /af-spec
|
|
378
|
-
.pi/prompts/af-code-simplify.md → /af-code-simplify
|
|
379
|
-
```
|
|
380
|
-
|
|
381
|
-
These lifecycle commands are not replacements for skills. They are workflow entry points that add orchestration and tell the agent which skills to load and follow for the current phase.
|
|
382
|
-
|
|
383
|
-
### 4. Invocation
|
|
384
|
-
|
|
385
|
-
Three ways to trigger the workflow:
|
|
386
|
-
|
|
387
|
-
- **Explicit skill:** type `/skill:<name>` (e.g. `/skill:spec-driven-development`)
|
|
388
|
-
- **Lifecycle command:** type `/af-spec`, `/af-plan`, `/af-build`, `/af-test`, `/af-review`, `/af-code-simplify`, or `/af-ship`
|
|
389
|
-
- **Automatic:** describe intent in natural language — the model reads `AGENTS.md` and loads the matching skill
|
|
390
|
-
|
|
391
|
-
### 5. Lifecycle Mapping
|
|
392
|
-
|
|
393
|
-
The development lifecycle is encoded in both `AGENTS.md` and the pi prompt templates:
|
|
394
|
-
|
|
395
|
-
- DEFINE → `/af-spec` → `spec-driven-development`
|
|
396
|
-
- PLAN → `/af-plan` → `planning-and-task-breakdown`
|
|
397
|
-
- BUILD → `/af-build` → `incremental-implementation` + `test-driven-development`
|
|
398
|
-
- VERIFY → `/af-test` → `test-driven-development`; use `debugging-and-error-recovery` when tests or builds fail
|
|
399
|
-
- REVIEW → `/af-review` → `code-review-and-quality`
|
|
400
|
-
- SIMPLIFY → `/af-code-simplify` → `code-simplification`
|
|
401
|
-
- SHIP → `/af-ship` → `shipping-and-launch`
|
|
402
|
-
|
|
403
|
-
---
|
|
404
|
-
|
|
405
|
-
## Usage Examples
|
|
406
|
-
|
|
407
|
-
### Example 1: Feature Development
|
|
408
|
-
|
|
409
|
-
User:
|
|
410
|
-
```
|
|
411
|
-
Add authentication to this app
|
|
412
|
-
```
|
|
413
|
-
|
|
414
|
-
pi behavior:
|
|
415
|
-
- Reads `AGENTS.md`, detects feature work
|
|
416
|
-
- Auto-loads `spec-driven-development`
|
|
417
|
-
- Produces a spec before writing code
|
|
418
|
-
- Progresses to `planning-and-task-breakdown` and implementation skills
|
|
419
|
-
|
|
420
|
-
Equivalent explicit forms:
|
|
421
|
-
```
|
|
422
|
-
/af-spec Add authentication to this app
|
|
423
|
-
/skill:spec-driven-development
|
|
424
|
-
```
|
|
425
|
-
|
|
426
|
-
---
|
|
427
|
-
|
|
428
|
-
### Example 2: Bug Fix
|
|
429
|
-
|
|
430
|
-
User:
|
|
431
|
-
```
|
|
432
|
-
This endpoint is returning 500 errors
|
|
433
|
-
```
|
|
434
|
-
|
|
435
|
-
pi behavior:
|
|
436
|
-
- Auto-loads `debugging-and-error-recovery`
|
|
437
|
-
- Reproduces → localizes → fixes → adds guards
|
|
438
|
-
|
|
439
|
-
Equivalent explicit forms:
|
|
440
|
-
```
|
|
441
|
-
/af-test This endpoint is returning 500 errors
|
|
442
|
-
/skill:debugging-and-error-recovery
|
|
443
|
-
```
|
|
444
|
-
|
|
445
|
-
---
|
|
446
|
-
|
|
447
|
-
### Example 3: Code Review
|
|
448
|
-
|
|
449
|
-
User:
|
|
450
|
-
```
|
|
451
|
-
Review this PR
|
|
452
|
-
```
|
|
453
|
-
|
|
454
|
-
pi behavior:
|
|
455
|
-
- Auto-loads `code-review-and-quality`
|
|
456
|
-
- Applies structured review (correctness, design, readability, security, tests)
|
|
457
|
-
|
|
458
|
-
Equivalent explicit forms:
|
|
459
|
-
```
|
|
460
|
-
/af-review
|
|
461
|
-
/skill:code-review-and-quality
|
|
462
|
-
```
|
|
463
|
-
|
|
464
|
-
---
|
|
465
|
-
|
|
466
|
-
## Agent Expectations (Critical)
|
|
467
|
-
|
|
468
|
-
For the skill system to deliver its value, the agent must:
|
|
469
|
-
|
|
470
|
-
- Check whether a skill applies before acting
|
|
471
|
-
- Invoke the matching skill when one applies
|
|
472
|
-
- Never skip required workflows (spec, plan, test, etc.)
|
|
473
|
-
- Not jump directly to implementation on non-trivial work
|
|
474
|
-
|
|
475
|
-
These rules are enforced by `AGENTS.md`, which pi auto-loads.
|
|
476
|
-
|
|
477
|
-
---
|
|
478
|
-
|
|
479
|
-
## Verification
|
|
480
|
-
|
|
481
|
-
After installing, confirm the integration works:
|
|
482
|
-
|
|
483
|
-
1. Run `pi` from inside the repo (or any subdirectory).
|
|
484
|
-
2. Type `/skill:` and confirm the skill list autocompletes with entries like `spec-driven-development`, `incremental-implementation`, `code-review-and-quality`, and `ask-user`.
|
|
485
|
-
3. Type `/` and confirm the lifecycle commands autocomplete: `/af-spec`, `/af-plan`, `/af-build`, `/af-test`, `/af-review`, `/af-code-simplify`, and `/af-ship`.
|
|
486
|
-
4. Run `/af-spec design a new feature for X` — confirm pi expands the command and invokes `spec-driven-development`.
|
|
487
|
-
5. Ask: *"fix this bug"* — confirm pi invokes `debugging-and-error-recovery`, or run `/af-test` to start a TDD/debugging workflow explicitly.
|
|
488
|
-
6. Give pi an ambiguous or high-stakes request and confirm it can use the `ask_user` tool / `ask-user` skill to request an explicit decision.
|
|
489
|
-
|
|
490
|
-
Start any diagnosis with the installer's own read-only report — it compares what
|
|
491
|
-
is recorded, what is on disk, and what the package ships, and exits `2` when
|
|
492
|
-
something is broken:
|
|
493
|
-
|
|
494
|
-
```bash
|
|
495
|
-
npx @chankov/agent-fleet verify --agent pi
|
|
496
|
-
npx @chankov/agent-fleet doctor --fix # repair missing/dangling items
|
|
497
|
-
```
|
|
498
|
-
|
|
499
|
-
If skill autocomplete is empty, check that `.pi/skills/` contains `<skill-name>/SKILL.md` directories and that pi was not started with `--no-skills`.
|
|
500
|
-
|
|
501
|
-
If lifecycle command autocomplete is empty, check that `.pi/prompts/` contains the command Markdown files and run `/reload` or restart pi.
|
|
502
|
-
|
|
503
|
-
If `/af-chrome_devtools-status` reports `Cannot find module '@modelcontextprotocol/sdk/client/index.js'`, the MCP extension loaded but its runtime initialization failed. An `[Extensions]` startup entry alone does not prove its tools registered.
|
|
504
|
-
|
|
505
|
-
The fix is the dependency install that `--allow-exec` would have run:
|
|
506
|
-
|
|
507
|
-
```bash
|
|
508
|
-
npm ci --prefix .pi/extensions
|
|
45
|
+
pi install -l npm:@chankov/agent-fleet
|
|
509
46
|
```
|
|
510
47
|
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
Then run `/reload` or restart pi.
|
|
516
|
-
|
|
517
|
-
---
|
|
518
|
-
|
|
519
|
-
## Limitations
|
|
520
|
-
|
|
521
|
-
- Automatic skill loading depends on the underlying model's compliance with `AGENTS.md` rules.
|
|
522
|
-
- Prompt-template commands expand into instructions; they do not mechanically execute `/skill:<name>`. The pi-specific prompt templates therefore explicitly tell the agent which skills to load and follow.
|
|
523
|
-
- The CLI installs per workspace only; a machine-wide install means the pi package (`pi install npm:@chankov/agent-fleet`), which carries skills and prompts but not the extensions or harnesses.
|
|
524
|
-
- Global `AGENTS.md` applies to every project when using the global-install alternative; pi concatenates context files, so this is usually additive, not destructive, but be aware of it.
|
|
525
|
-
|
|
526
|
-
---
|
|
527
|
-
|
|
528
|
-
## Recommended Workflow
|
|
529
|
-
|
|
530
|
-
Just use natural language:
|
|
531
|
-
|
|
532
|
-
- "Design a feature"
|
|
533
|
-
- "Plan this change"
|
|
534
|
-
- "Implement this"
|
|
535
|
-
- "Fix this bug"
|
|
536
|
-
- "Review this"
|
|
537
|
-
|
|
538
|
-
Or invoke lifecycle commands when you want the full workflow prompt:
|
|
539
|
-
|
|
540
|
-
- `/af-spec`
|
|
541
|
-
- `/af-plan`
|
|
542
|
-
- `/af-build`
|
|
543
|
-
- `/af-test`
|
|
544
|
-
- `/af-review`
|
|
545
|
-
- `/af-code-simplify`
|
|
546
|
-
- `/af-ship`
|
|
547
|
-
|
|
548
|
-
Or invoke individual skills directly when you want precise control:
|
|
549
|
-
|
|
550
|
-
- `/skill:spec-driven-development`
|
|
551
|
-
- `/skill:planning-and-task-breakdown`
|
|
552
|
-
- `/skill:incremental-implementation`
|
|
553
|
-
- `/skill:debugging-and-error-recovery`
|
|
554
|
-
- `/skill:code-review-and-quality`
|
|
555
|
-
|
|
556
|
-
---
|
|
557
|
-
|
|
558
|
-
## Summary
|
|
559
|
-
|
|
560
|
-
pi integration works by leveraging pi's **native** Agent Fleet and prompt-template support:
|
|
561
|
-
|
|
562
|
-
- `npx @chankov/agent-fleet install --agent pi --profile recommended --yes` writes the skills to `.pi/skills/` and the lifecycle commands to `.pi/prompts/`
|
|
563
|
-
- add `--profile pi-fleet-core --allow-exec` for the harness stack, its `justfile` region, and its runtime dependencies
|
|
564
|
-
- install `@chankov/agent-fleet` as a pi package for bundled `ask_user`, or install `pi-ask-user` separately for clone setup
|
|
565
|
-
- let pi auto-load `AGENTS.md` from the repo root
|
|
566
|
-
- use `/skill:<name>`, lifecycle commands like `/af-spec`, or natural language to trigger workflows
|
|
567
|
-
- keep it current with `agent-fleet upgrade`, check it with `agent-fleet verify`, repair it with `agent-fleet doctor --fix`
|
|
48
|
+
Do not also copy the same skills/prompts into `.pi/`; that creates collisions.
|
|
49
|
+
Harness-only composition (package-native skills/prompts plus copied harnesses)
|
|
50
|
+
is supported. The package bundles `pi-ask-user`; copied plain-pi installations
|
|
51
|
+
need their own compatible `pi-ask-user` source.
|
|
568
52
|
|
|
569
|
-
|
|
53
|
+
## Project-owned configuration
|
|
570
54
|
|
|
571
|
-
|
|
55
|
+
`.ai/agent-fleet-overrides.md` is minimal committed project configuration;
|
|
56
|
+
`.ai/stt.json` contains provider names and environment-variable names, never
|
|
57
|
+
secret values. The root environment file is human-owned and append-only.
|
|
@@ -75,7 +75,7 @@ agent-fleet set-hermes-telegram install --profile default --force
|
|
|
75
75
|
agent-fleet set-hermes-telegram install --profile default --force --restart
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
|
|
78
|
+
The command is `/af-set-hermes-telegram`. The installer resolves the real profile path via `hermes profile show`, refuses drift without `--force`, backs up forced replacements, copies atomically, and verifies skill/tool/gateway readiness. It never sends a test Telegram message and never starts a stopped gateway. See [the bridge runbook](../docs/coms-hermes-bridge.md#telegram-bridge-control-command).
|
|
79
79
|
|
|
80
80
|
The current `hermes skills install` CLI documents registry identifiers and direct HTTP(S) `SKILL.md` URLs, not local directories, so `hermes skills install hermes/skills/hub-liaison` is not the supported local installation path.
|
|
81
81
|
|