@chankov/agent-fleet 0.0.10 → 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 +29 -27
- package/.pi/extensions/btw/index.ts +80 -83
- package/.pi/extensions/pi-voice-stt/README.md +7 -3
- package/.pi/extensions/pi-voice-stt/config.ts +1 -1
- package/.pi/harnesses/agent-hub/README.md +109 -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/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.11/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/0.0.11/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.11/.pi/agents/teams.yaml +41 -0
- package/.versions/0.0.11/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/btw/README.md +119 -0
- package/.versions/0.0.11/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.11/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.11/.pi/extensions/package.json +9 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/README.md +1004 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/footer.ts +31 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/index.ts +9111 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/run-budget.js +479 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +477 -0
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.11/.pi/harnesses/coms/README.md +100 -0
- package/.versions/0.0.11/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.11/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.11/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/0.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/0.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/0.0.11/.pi/harnesses/package-lock.json +2046 -0
- package/.versions/0.0.11/.pi/harnesses/package.json +10 -0
- package/.versions/0.0.11/.pi/prompts/af-build.md +24 -0
- package/{.claude/commands/code-simplify.md → .versions/0.0.11/.pi/prompts/af-code-simplify.md} +3 -3
- package/{.claude/commands/plan.md → .versions/0.0.11/.pi/prompts/af-plan.md} +1 -1
- package/{.claude/commands/review.md → .versions/0.0.11/.pi/prompts/af-review.md} +3 -3
- package/.versions/0.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.11/.pi/prompts/af-ship.md +17 -0
- package/{.claude/commands/spec.md → .versions/0.0.11/.pi/prompts/af-spec.md} +1 -1
- package/{.claude/commands/test.md → .versions/0.0.11/.pi/prompts/af-test.md} +2 -2
- package/.versions/0.0.11/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.11/.version +1 -0
- package/.versions/0.0.11/agents/architect.md +24 -0
- package/.versions/0.0.11/agents/bowser.md +27 -0
- package/.versions/0.0.11/agents/builder.md +54 -0
- package/.versions/0.0.11/agents/code-reviewer.md +208 -0
- package/.versions/0.0.11/agents/deep-researcher.md +32 -0
- package/.versions/0.0.11/agents/documenter.md +18 -0
- package/.versions/0.0.11/agents/orchestrator.md +72 -0
- package/.versions/0.0.11/agents/plan-reviewer.md +83 -0
- package/.versions/0.0.11/agents/planner.md +70 -0
- package/.versions/0.0.11/agents/releaser.md +24 -0
- package/.versions/0.0.11/agents/researcher.md +28 -0
- package/.versions/0.0.11/agents/security-auditor.md +167 -0
- package/.versions/0.0.11/agents/test-engineer.md +153 -0
- package/.versions/0.0.11/agents/web-debugger.md +43 -0
- package/.versions/0.0.11/agents/web-performance-auditor.md +193 -0
- package/.versions/0.0.11/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.11/docs/ARCHITECTURE.md +301 -0
- package/.versions/0.0.11/docs/agent-fleet-setup.md +351 -0
- package/.versions/0.0.11/docs/claude-code-coms-bridge.md +127 -0
- package/.versions/0.0.11/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.11/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.11/docs/getting-started.md +43 -0
- package/.versions/0.0.11/docs/npm-install.md +96 -0
- package/.versions/0.0.11/docs/pi-extensions.md +368 -0
- package/.versions/0.0.11/docs/pi-setup.md +57 -0
- package/.versions/0.0.11/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.11/hermes/README.md +347 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.11/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.11/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.11/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.11/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.11/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.11/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.11/install-manifest.json +2743 -0
- package/.versions/0.0.11/justfile +261 -0
- package/.versions/0.0.11/manifest-meta.json +881 -0
- package/.versions/0.0.11/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.11/references/definition-of-done.md +67 -0
- package/.versions/0.0.11/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.11/references/observability-checklist.md +91 -0
- package/.versions/0.0.11/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.11/references/performance-checklist.md +153 -0
- package/.versions/0.0.11/references/prompting-patterns.md +380 -0
- package/.versions/0.0.11/references/security-checklist.md +179 -0
- package/.versions/0.0.11/references/testing-patterns.md +236 -0
- package/.versions/0.0.11/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.11/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.11/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.11/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.11/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.11/scripts/fleet.ts +168 -0
- package/.versions/0.0.11/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.11/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.11/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.11/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.11/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.11/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.11/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.11/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.11/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.11/scripts/lib/fleet-command.ts +119 -0
- package/.versions/0.0.11/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/0.0.11/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.11/scripts/lib/monitor-env.ts +146 -0
- package/.versions/0.0.11/scripts/lib/peer-launch.ts +314 -0
- package/.versions/0.0.11/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.11/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.11/scripts/lib/team-project.ts +193 -0
- package/.versions/0.0.11/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.11/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.11/scripts/peer-launch.ts +259 -0
- package/.versions/0.0.11/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.11/scripts/team-up.ts +360 -0
- package/.versions/0.0.11/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/0.0.11/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.11/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.11/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.11/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.11/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.11/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.11/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.11/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.11/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.11/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.11/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.11/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.11/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.11/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.11/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/0.0.11/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.11/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/0.0.11/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.11/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- 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/.versions/1.0.0/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.0/.pi/prompts/af-plan.md +16 -0
- package/.versions/1.0.0/.pi/prompts/af-review.md +16 -0
- 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/1.0.0/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.0/.pi/prompts/af-test.md +19 -0
- 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 +149 -0
- package/README.md +117 -79
- package/agents/orchestrator.md +1 -1
- package/{.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +2 -0
- 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 +90 -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 +27 -1
- 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/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/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.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.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/{.opencode/commands → .versions/0.0.11/.pi/prompts}/af-set-hermes-telegram.md +0 -0
- /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 0.0.11/bin/catalog/harness-runtime-closure.json} +0 -0
- /package/{.claude/commands/set-hermes-telegram.md → .versions/1.0.0/.pi/prompts/af-set-hermes-telegram.md} +0 -0
- /package/{skills/guided-workspace-setup/companion-manifest.json → .versions/1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
package/docs/opencode-setup.md
DELETED
|
@@ -1,281 +0,0 @@
|
|
|
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
|
-
### Recommended — the `agent-fleet` CLI (project-scoped)
|
|
31
|
-
|
|
32
|
-
The CLI writes OpenCode's targets directly: `.opencode/skills/`, `.opencode/commands/`,
|
|
33
|
-
and `.opencode/agent/` (personas transformed to `mode: subagent` on the way in).
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
cd /path/to/your-project
|
|
37
|
-
|
|
38
|
-
# Guided: bootstraps the installer command, then run /af-setup-agent-fleet in OpenCode
|
|
39
|
-
npx @chankov/agent-fleet init --agent opencode
|
|
40
|
-
|
|
41
|
-
# Or straight to it — no agent, no model, no prompts:
|
|
42
|
-
npx @chankov/agent-fleet install --agent opencode --profile recommended --yes
|
|
43
|
-
npx @chankov/agent-fleet verify --agent opencode
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
Refresh after a package update with `npx @chankov/agent-fleet upgrade` — it
|
|
47
|
-
three-way merges against the version recorded in `.ai/agent-fleet-state.json`,
|
|
48
|
-
so your local edits survive and a genuine conflict lands beside your file as
|
|
49
|
-
`<file>.new` (exit `3`) instead of overwriting it. Artifacts install as **copies**;
|
|
50
|
-
`agent-fleet doctor --fix` repairs anything that goes missing or dangling.
|
|
51
|
-
|
|
52
|
-
Profiles: `minimal`, `recommended`, `full`. Narrow it with
|
|
53
|
-
`--items skill:code-review-and-quality,command:review,persona:code-reviewer`, and
|
|
54
|
-
preview any verb with `--dry-run`. Full reference: [npm-install.md](npm-install.md).
|
|
55
|
-
|
|
56
|
-
### Manual global install (advanced)
|
|
57
|
-
|
|
58
|
-
Use this only when you want the skills available in **every** OpenCode session on
|
|
59
|
-
the machine regardless of project — the CLI installs per workspace and does not
|
|
60
|
-
write to `~/.config/opencode/`.
|
|
61
|
-
|
|
62
|
-
1. Clone the repository:
|
|
63
|
-
|
|
64
|
-
```bash
|
|
65
|
-
git clone https://github.com/chankov/agent-fleet.git
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
2. Install the global OpenCode configuration.
|
|
69
|
-
|
|
70
|
-
Set `AGENT_SKILLS_DIR` to wherever you cloned the repo (used in the snippets below):
|
|
71
|
-
|
|
72
|
-
```bash
|
|
73
|
-
export AGENT_SKILLS_DIR="/path/to/agent-fleet"
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
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):
|
|
77
|
-
|
|
78
|
-
```json
|
|
79
|
-
{
|
|
80
|
-
"instructions": [
|
|
81
|
-
"/path/to/agent-fleet/AGENTS.md"
|
|
82
|
-
],
|
|
83
|
-
"permission": {
|
|
84
|
-
"skill": {
|
|
85
|
-
"*": "allow"
|
|
86
|
-
}
|
|
87
|
-
}
|
|
88
|
-
}
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
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:
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
mkdir -p ~/.config/opencode/skills ~/.config/opencode/commands
|
|
95
|
-
|
|
96
|
-
# Skills: link each skill directory individually.
|
|
97
|
-
for d in "$AGENT_SKILLS_DIR"/skills/*/; do
|
|
98
|
-
ln -s "$d" "$HOME/.config/opencode/skills/$(basename "$d")"
|
|
99
|
-
done
|
|
100
|
-
|
|
101
|
-
# Commands: link each command file individually.
|
|
102
|
-
for f in "$AGENT_SKILLS_DIR"/.opencode/commands/*.md; do
|
|
103
|
-
ln -s "$f" "$HOME/.config/opencode/commands/$(basename "$f")"
|
|
104
|
-
done
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
> ⚠️ 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.
|
|
108
|
-
|
|
109
|
-
3. Restart OpenCode.
|
|
110
|
-
|
|
111
|
-
4. Open any project in OpenCode.
|
|
112
|
-
|
|
113
|
-
5. The following Agent Fleet assets are now available globally:
|
|
114
|
-
|
|
115
|
-
- `AGENTS.md` instructions from the repo root
|
|
116
|
-
- All skills from `skills/`
|
|
117
|
-
- Optional prefixed slash commands from `.opencode/commands/`
|
|
118
|
-
|
|
119
|
-
### Optional Slash Commands
|
|
120
|
-
|
|
121
|
-
This repo ships OpenCode-native commands with an `af-` prefix so they are easy to distinguish from other commands:
|
|
122
|
-
|
|
123
|
-
- `/af-spec`
|
|
124
|
-
- `/af-plan`
|
|
125
|
-
- `/af-build`
|
|
126
|
-
- `/af-test`
|
|
127
|
-
- `/af-review`
|
|
128
|
-
- `/af-code-simplify`
|
|
129
|
-
- `/af-ship`
|
|
130
|
-
- `/af-webperf`
|
|
131
|
-
- `/af-design-agent`
|
|
132
|
-
- `/af-orchestrate`
|
|
133
|
-
- `/af-prime`
|
|
134
|
-
- `/af-setup-agent-fleet`
|
|
135
|
-
- `/af-doctor-agent-fleet`
|
|
136
|
-
- `/af-set-hermes-telegram install|status|on|off …` — profile-aware Hermes liaison setup and bridge control
|
|
137
|
-
|
|
138
|
-
These commands are optional shortcuts. The agent can still invoke the correct skills automatically from plain natural-language requests.
|
|
139
|
-
|
|
140
|
-
---
|
|
141
|
-
|
|
142
|
-
## How It Works
|
|
143
|
-
|
|
144
|
-
### 1. Skill Discovery
|
|
145
|
-
|
|
146
|
-
All skills live in:
|
|
147
|
-
|
|
148
|
-
```
|
|
149
|
-
skills/<skill-name>/SKILL.md
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
OpenCode agents are instructed (via `AGENTS.md`) to:
|
|
153
|
-
|
|
154
|
-
- Detect when a skill applies
|
|
155
|
-
- Invoke the `skill` tool
|
|
156
|
-
- Follow the skill exactly
|
|
157
|
-
|
|
158
|
-
### 2. Automatic Skill Invocation
|
|
159
|
-
|
|
160
|
-
The agent evaluates every request and maps it to the appropriate skill.
|
|
161
|
-
|
|
162
|
-
Examples:
|
|
163
|
-
|
|
164
|
-
- "build a feature" → `incremental-implementation` + `test-driven-development`
|
|
165
|
-
- "design a system" → `spec-driven-development`
|
|
166
|
-
- "fix a bug" → `debugging-and-error-recovery`
|
|
167
|
-
- "review this code" → `code-review-and-quality`
|
|
168
|
-
|
|
169
|
-
The user does **not** need to explicitly request skills.
|
|
170
|
-
|
|
171
|
-
### 3. Lifecycle Mapping
|
|
172
|
-
|
|
173
|
-
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:
|
|
174
|
-
|
|
175
|
-
| Lifecycle phase | Claude Code command | OpenCode command | Underlying skill(s) |
|
|
176
|
-
| --------------- | ------------------- | ------------------ | ------------------------------------------------------------- |
|
|
177
|
-
| DEFINE | `/spec` | `/af-spec` | `spec-driven-development` |
|
|
178
|
-
| PLAN | `/plan` | `/af-plan` | `planning-and-task-breakdown` |
|
|
179
|
-
| BUILD | `/build` | `/af-build` | `incremental-implementation` + `test-driven-development` |
|
|
180
|
-
| TEST | `/test` | `/af-test` | `test-driven-development` |
|
|
181
|
-
| VERIFY | — | — | `debugging-and-error-recovery` (implicit on failure) |
|
|
182
|
-
| REVIEW | `/review` | `/af-review` | `code-review-and-quality` |
|
|
183
|
-
| SIMPLIFY | `/code-simplify` | `/af-code-simplify`| `code-simplification` |
|
|
184
|
-
| SHIP | `/ship` | `/af-ship` | `shipping-and-launch` |
|
|
185
|
-
| WEBPERF | `/webperf` | `/af-webperf` | `web-performance-auditor` persona (`performance-optimization`) |
|
|
186
|
-
| AUTHOR | `/design-agent` | `/af-design-agent` | `designing-agents` |
|
|
187
|
-
| ORCHESTRATE | `/orchestrate` | `/af-orchestrate` | `orchestration-verification` |
|
|
188
|
-
|
|
189
|
-
---
|
|
190
|
-
|
|
191
|
-
## Usage Examples
|
|
192
|
-
|
|
193
|
-
### Example 1: Feature Development
|
|
194
|
-
|
|
195
|
-
User:
|
|
196
|
-
```
|
|
197
|
-
Add authentication to this app
|
|
198
|
-
```
|
|
199
|
-
|
|
200
|
-
Agent behavior:
|
|
201
|
-
- Detects feature work
|
|
202
|
-
- Invokes `spec-driven-development`
|
|
203
|
-
- Produces a spec before writing code
|
|
204
|
-
- Moves to planning and implementation skills
|
|
205
|
-
|
|
206
|
-
---
|
|
207
|
-
|
|
208
|
-
### Example 2: Bug Fix
|
|
209
|
-
|
|
210
|
-
User:
|
|
211
|
-
```
|
|
212
|
-
This endpoint is returning 500 errors
|
|
213
|
-
```
|
|
214
|
-
|
|
215
|
-
Agent behavior:
|
|
216
|
-
- Invokes `debugging-and-error-recovery`
|
|
217
|
-
- Reproduces → localizes → fixes → adds guards
|
|
218
|
-
|
|
219
|
-
---
|
|
220
|
-
|
|
221
|
-
### Example 3: Code Review
|
|
222
|
-
|
|
223
|
-
User:
|
|
224
|
-
```
|
|
225
|
-
Review this PR
|
|
226
|
-
```
|
|
227
|
-
|
|
228
|
-
Agent behavior:
|
|
229
|
-
- Invokes `code-review-and-quality`
|
|
230
|
-
- Applies structured review (correctness, design, readability, etc.)
|
|
231
|
-
|
|
232
|
-
---
|
|
233
|
-
|
|
234
|
-
## Agent Expectations (Critical)
|
|
235
|
-
|
|
236
|
-
For OpenCode to work correctly, the agent must follow these rules:
|
|
237
|
-
|
|
238
|
-
- Always check if a skill applies before acting
|
|
239
|
-
- If a skill applies, it MUST be used
|
|
240
|
-
- Never skip required workflows (spec, plan, test, etc.)
|
|
241
|
-
- Do not jump directly to implementation
|
|
242
|
-
|
|
243
|
-
These rules are enforced via `AGENTS.md`.
|
|
244
|
-
|
|
245
|
-
---
|
|
246
|
-
|
|
247
|
-
## Limitations
|
|
248
|
-
|
|
249
|
-
- No plugin system (handled via prompt + structure)
|
|
250
|
-
- Skill invocation depends on model compliance
|
|
251
|
-
|
|
252
|
-
Despite these, the workflow closely matches Claude Code in practice.
|
|
253
|
-
|
|
254
|
-
---
|
|
255
|
-
|
|
256
|
-
## Recommended Workflow
|
|
257
|
-
|
|
258
|
-
Just use natural language:
|
|
259
|
-
|
|
260
|
-
- "Design a feature"
|
|
261
|
-
- "Plan this change"
|
|
262
|
-
- "Implement this"
|
|
263
|
-
- "Fix this bug"
|
|
264
|
-
- "Review this"
|
|
265
|
-
|
|
266
|
-
The agent will automatically select and execute the correct skills.
|
|
267
|
-
|
|
268
|
-
If you prefer explicit entry points, use the shipped slash commands such as `/af-spec`, `/af-plan`, or `/af-review`.
|
|
269
|
-
|
|
270
|
-
---
|
|
271
|
-
|
|
272
|
-
## Summary
|
|
273
|
-
|
|
274
|
-
OpenCode integration works by combining:
|
|
275
|
-
|
|
276
|
-
- Structured skills (this repo)
|
|
277
|
-
- Strong agent rules (`AGENTS.md`)
|
|
278
|
-
- Automatic skill invocation via reasoning
|
|
279
|
-
- Optional `af-` prefixed slash commands for explicit lifecycle entry points
|
|
280
|
-
|
|
281
|
-
This results in a **production-grade engineering workflow** that works both as an agent-driven system and as an explicit command-driven workflow.
|
package/hooks/SIMPLIFY-IGNORE.md
DELETED
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
# simplify-ignore hook
|
|
2
|
-
|
|
3
|
-
Block-level protection for `/code-simplify`. Mark code that should never be simplified — the model won't see it.
|
|
4
|
-
|
|
5
|
-
## Setup
|
|
6
|
-
|
|
7
|
-
1. Annotate blocks you want to protect:
|
|
8
|
-
|
|
9
|
-
```js
|
|
10
|
-
/* simplify-ignore-start: perf-critical */
|
|
11
|
-
// manually unrolled XOR — 3x faster than a loop
|
|
12
|
-
result[0] = buf[0] ^ key[0];
|
|
13
|
-
result[1] = buf[1] ^ key[1];
|
|
14
|
-
result[2] = buf[2] ^ key[2];
|
|
15
|
-
result[3] = buf[3] ^ key[3];
|
|
16
|
-
/* simplify-ignore-end */
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
2. Add hooks to `.claude/settings.json`:
|
|
20
|
-
|
|
21
|
-
```json
|
|
22
|
-
{
|
|
23
|
-
"hooks": {
|
|
24
|
-
"PreToolUse": [
|
|
25
|
-
{
|
|
26
|
-
"matcher": "Read",
|
|
27
|
-
"hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
|
|
28
|
-
}
|
|
29
|
-
],
|
|
30
|
-
"PostToolUse": [
|
|
31
|
-
{
|
|
32
|
-
"matcher": "Edit|Write",
|
|
33
|
-
"hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
|
|
34
|
-
}
|
|
35
|
-
],
|
|
36
|
-
"Stop": [
|
|
37
|
-
{
|
|
38
|
-
"hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
|
|
39
|
-
}
|
|
40
|
-
]
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
3. Run `/code-simplify` — protected blocks become `/* BLOCK_de115a1d: perf-critical */` placeholders. The model reasons about surrounding code without seeing the protected implementation.
|
|
46
|
-
|
|
47
|
-
> **Note:** The hook stores temporary backups in `.claude/.simplify-ignore-cache/`. Make sure this path is in your `.gitignore`.
|
|
48
|
-
|
|
49
|
-
## How it works
|
|
50
|
-
|
|
51
|
-
One script, three hook events:
|
|
52
|
-
|
|
53
|
-
| Event | Action |
|
|
54
|
-
|---|---|
|
|
55
|
-
| `PreToolUse Read` | Backs up file, replaces blocks with `BLOCK_<hash>` placeholders in-place |
|
|
56
|
-
| `PostToolUse Edit\|Write` | Expands placeholders back to real code, saves model's changes, re-filters |
|
|
57
|
-
| `Stop` | Restores all files from backup when session ends |
|
|
58
|
-
|
|
59
|
-
Each block is content-hashed (8 hex chars via `shasum`/`sha1sum`) so the round-trip is unambiguous even if the model duplicates or reorders placeholders. Cache is project-scoped to prevent cross-session interference.
|
|
60
|
-
|
|
61
|
-
## Annotation syntax
|
|
62
|
-
|
|
63
|
-
```js
|
|
64
|
-
/* simplify-ignore-start */ // basic — hides the block
|
|
65
|
-
/* simplify-ignore-start: reason */ // with reason — appears in placeholder
|
|
66
|
-
/* simplify-ignore-end */
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
Any comment style works (`//`, `/*`, `#`, `<!--`). Multiple blocks per file and single-line blocks supported. Placeholders preserve the original comment syntax (e.g. `# BLOCK_xxx` for Python, `<!-- BLOCK_xxx -->` for HTML).
|
|
70
|
-
|
|
71
|
-
## Crash recovery
|
|
72
|
-
|
|
73
|
-
If Claude Code crashes without triggering the Stop hook, files on disk may still have `BLOCK_<hash>` placeholders. To restore manually:
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
echo '{}' | bash hooks/simplify-ignore.sh
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
Backups are stored in `.claude/.simplify-ignore-cache/` within your project directory.
|
|
80
|
-
|
|
81
|
-
## Known limitations
|
|
82
|
-
|
|
83
|
-
- **Single-line blocks hide the entire line.** If `simplify-ignore-start` and `simplify-ignore-end` appear on the same line as other code, the whole line is hidden from the model, not just the annotated portion. Use dedicated lines for annotations.
|
|
84
|
-
- **Comment suffix detection covers `*/` and `-->` only.** Template engines with non-standard comment closers (ERB `%>`, Blade `--}}`) may produce unbalanced placeholders. Use `#` or `//` style comments instead.
|
|
85
|
-
- **Fallback expansion is progressive, not exact.** If the model alters a placeholder's formatting (e.g. changes the reason text), the hook tries progressively simpler matches: full placeholder → prefix+hash+suffix → hash-only. The hash-only fallback may leave cosmetic debris (e.g. stray `:` or reason text). A warning is printed to stderr when this happens.
|
|
86
|
-
- **File renaming leaves placeholders.** If the model renames or moves a file via a shell command, the new file will retain `BLOCK_<hash>` placeholders. The original code is saved as `<old-filename>.recovered` when the session stops. You must manually restore the recovered code into the new file.
|
|
87
|
-
|
|
88
|
-
## Requirements
|
|
89
|
-
|
|
90
|
-
- `jq`, `shasum` or `sha1sum` (auto-detected), Bash 3.2+
|
package/hooks/hooks.json
DELETED
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"hooks": {
|
|
3
|
-
"SessionStart": [
|
|
4
|
-
{
|
|
5
|
-
"hooks": [
|
|
6
|
-
{
|
|
7
|
-
"type": "command",
|
|
8
|
-
"command": "SCRIPT=\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh\"; [ -f \"$SCRIPT\" ] || SCRIPT=\"${CLAUDE_PROJECT_DIR}/.claude/hooks/session-start.sh\"; [ -f \"$SCRIPT\" ]&& bash \"$SCRIPT\" || true"
|
|
9
|
-
}
|
|
10
|
-
]
|
|
11
|
-
}
|
|
12
|
-
]
|
|
13
|
-
}
|
|
14
|
-
}
|
package/hooks/session-start.sh
DELETED
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
#!/bin/bash
|
|
2
|
-
# agent-fleet session start hook (Claude Code).
|
|
3
|
-
#
|
|
4
|
-
# Two responsibilities:
|
|
5
|
-
# 1. Inject the using-agent-skills meta-skill into the session context so
|
|
6
|
-
# Claude can route tasks to the right skill.
|
|
7
|
-
# 2. Surface a one-line "update available" banner when the installed
|
|
8
|
-
# package is behind the published version on npm.
|
|
9
|
-
#
|
|
10
|
-
# Both are best-effort. Network errors, missing files, and missing tools
|
|
11
|
-
# never block session start — the hook always exits 0 and prints a valid
|
|
12
|
-
# JSON object on stdout.
|
|
13
|
-
|
|
14
|
-
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
|
15
|
-
PACKAGE_ROOT="$(dirname "$SCRIPT_DIR")"
|
|
16
|
-
SKILLS_DIR="$PACKAGE_ROOT/skills"
|
|
17
|
-
META_SKILL="$SKILLS_DIR/using-agent-skills/SKILL.md"
|
|
18
|
-
CHECK_SCRIPT="$PACKAGE_ROOT/bin/cli.js"
|
|
19
|
-
|
|
20
|
-
# ── 1. Meta-skill content ────────────────────────────────────────────────
|
|
21
|
-
if [ -f "$META_SKILL" ]; then
|
|
22
|
-
META_CONTENT=$(cat "$META_SKILL")
|
|
23
|
-
PRIORITY="IMPORTANT"
|
|
24
|
-
BASE_MESSAGE="agent-fleet loaded. Use the skill discovery flowchart to find the right skill for your task."
|
|
25
|
-
else
|
|
26
|
-
META_CONTENT=""
|
|
27
|
-
PRIORITY="INFO"
|
|
28
|
-
BASE_MESSAGE="agent-fleet: using-agent-skills meta-skill not found. Skills may still be available individually."
|
|
29
|
-
fi
|
|
30
|
-
|
|
31
|
-
# ── 2. Update banner (silent on any error) ───────────────────────────────
|
|
32
|
-
UPDATE_BANNER=""
|
|
33
|
-
if [ "$AGENT_SKILLS_NO_UPDATE_CHECK" != "1" ] \
|
|
34
|
-
&& [ "$NO_UPDATE_NOTIFIER" != "1" ] \
|
|
35
|
-
&& [ "$CI" != "true" ] \
|
|
36
|
-
&& command -v node >/dev/null 2>&1 \
|
|
37
|
-
&& [ -f "$CHECK_SCRIPT" ]; then
|
|
38
|
-
# Run with a 3-second wall-clock cap so a hung registry never stalls the
|
|
39
|
-
# session. The check-update subcommand emits the banner on stdout when an
|
|
40
|
-
# upgrade is available, nothing otherwise. Errors go to /dev/null.
|
|
41
|
-
if command -v timeout >/dev/null 2>&1; then
|
|
42
|
-
UPDATE_BANNER=$(timeout 3 node "$CHECK_SCRIPT" check-update 2>/dev/null || true)
|
|
43
|
-
else
|
|
44
|
-
UPDATE_BANNER=$(node "$CHECK_SCRIPT" check-update 2>/dev/null || true)
|
|
45
|
-
fi
|
|
46
|
-
fi
|
|
47
|
-
|
|
48
|
-
# ── Compose the message ──────────────────────────────────────────────────
|
|
49
|
-
FULL_MESSAGE="$BASE_MESSAGE"
|
|
50
|
-
if [ -n "$UPDATE_BANNER" ]; then
|
|
51
|
-
FULL_MESSAGE=$(printf '%s\n\n%s' "$FULL_MESSAGE" "$UPDATE_BANNER")
|
|
52
|
-
fi
|
|
53
|
-
if [ -n "$META_CONTENT" ]; then
|
|
54
|
-
FULL_MESSAGE=$(printf '%s\n\n%s' "$FULL_MESSAGE" "$META_CONTENT")
|
|
55
|
-
fi
|
|
56
|
-
|
|
57
|
-
# ── Emit JSON (node handles escaping correctly) ──────────────────────────
|
|
58
|
-
if command -v node >/dev/null 2>&1; then
|
|
59
|
-
printf '%s' "$FULL_MESSAGE" | node -e '
|
|
60
|
-
let msg = "";
|
|
61
|
-
process.stdin.setEncoding("utf8");
|
|
62
|
-
process.stdin.on("data", c => { msg += c; });
|
|
63
|
-
process.stdin.on("end", () => {
|
|
64
|
-
process.stdout.write(JSON.stringify({
|
|
65
|
-
priority: process.env.PRIORITY || "INFO",
|
|
66
|
-
message: msg,
|
|
67
|
-
}) + "\n");
|
|
68
|
-
});
|
|
69
|
-
'
|
|
70
|
-
else
|
|
71
|
-
# Fallback: ship just the base message with minimal escaping.
|
|
72
|
-
SAFE_MSG=$(printf '%s' "$BASE_MESSAGE" | sed 's/\\/\\\\/g; s/"/\\"/g')
|
|
73
|
-
printf '{"priority": "%s", "message": "%s"}\n' "$PRIORITY" "$SAFE_MSG"
|
|
74
|
-
fi
|