@chankov/agent-fleet 2.0.0 → 2.0.1
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/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.1/.pi/extensions/package.json +9 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
- package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.1/.version +1 -0
- package/.versions/2.0.1/agents/architect.md +25 -0
- package/.versions/2.0.1/agents/bowser.md +28 -0
- package/.versions/2.0.1/agents/builder.md +56 -0
- package/.versions/2.0.1/agents/code-reviewer.md +210 -0
- package/.versions/2.0.1/agents/deep-researcher.md +33 -0
- package/.versions/2.0.1/agents/documenter.md +22 -0
- package/.versions/2.0.1/agents/orchestrator.md +23 -0
- package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.1/agents/planner.md +73 -0
- package/.versions/2.0.1/agents/releaser.md +25 -0
- package/.versions/2.0.1/agents/researcher.md +31 -0
- package/.versions/2.0.1/agents/security-auditor.md +168 -0
- package/.versions/2.0.1/agents/test-engineer.md +154 -0
- package/.versions/2.0.1/agents/web-debugger.md +44 -0
- package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
- package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
- package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
- package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
- package/.versions/2.0.1/docs/getting-started.md +119 -0
- package/.versions/2.0.1/docs/npm-install.md +292 -0
- package/.versions/2.0.1/docs/pi-extensions.md +439 -0
- package/.versions/2.0.1/docs/pi-setup.md +74 -0
- package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.1/hermes/README.md +347 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.1/install-manifest.json +2830 -0
- package/.versions/2.0.1/justfile +286 -0
- package/.versions/2.0.1/manifest-meta.json +913 -0
- package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.1/references/definition-of-done.md +67 -0
- package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/2.0.1/references/observability-checklist.md +91 -0
- package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.1/references/performance-checklist.md +153 -0
- package/.versions/2.0.1/references/prompting-patterns.md +380 -0
- package/.versions/2.0.1/references/security-checklist.md +179 -0
- package/.versions/2.0.1/references/testing-patterns.md +236 -0
- package/.versions/2.0.1/references/workflow-authoring.md +304 -0
- package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
- package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
- package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
- package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.1/scripts/fleet.ts +198 -0
- package/.versions/2.0.1/scripts/flow.ts +121 -0
- package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
- package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
- package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
- package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
- package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.1/scripts/team-up.ts +406 -0
- package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
- package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
- package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
- package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
- package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
- package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +7 -0
- package/README.md +21 -0
- package/agents/code-reviewer.md +1 -0
- package/agents/documenter.md +3 -0
- package/agents/planner.md +2 -0
- package/agents/researcher.md +2 -0
- package/docs/ARCHITECTURE.md +3 -0
- package/docs/getting-started.md +21 -0
- package/docs/workflows.md +136 -0
- package/install-manifest.json +86 -1
- package/justfile +14 -0
- package/manifest-meta.json +32 -1
- package/package.json +10 -3
- package/references/workflow-authoring.md +304 -0
- package/scripts/fleet.ts +13 -0
- package/scripts/flow.ts +121 -0
- package/scripts/lib/flow-command.ts +77 -0
- package/scripts/lib/flow-maintenance.ts +230 -0
- package/scripts/workflows/lib/agent-phase.ts +118 -0
- package/scripts/workflows/lib/changes.ts +61 -0
- package/scripts/workflows/lib/env.ts +34 -0
- package/scripts/workflows/lib/envelopes.ts +141 -0
- package/scripts/workflows/lib/gates.ts +81 -0
- package/scripts/workflows/lib/git.ts +96 -0
- package/scripts/workflows/lib/permissions.ts +130 -0
- package/scripts/workflows/lib/personas.ts +44 -0
- package/scripts/workflows/lib/quality.ts +64 -0
- package/scripts/workflows/lib/run.ts +106 -0
- package/scripts/workflows/lib/trace.ts +34 -0
- package/scripts/workflows/tsconfig.json +22 -0
- package/scripts/workflows/wf-build-test.ts +61 -0
- package/scripts/workflows/wf-document.ts +50 -0
- package/scripts/workflows/wf-quality.ts +20 -0
- package/scripts/workflows/wf-scout.ts +38 -0
- package/skills/drafting-workflows/SKILL.md +143 -0
- package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: using-agent-skills
|
|
3
|
+
description: Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Using Agent Skills
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
|
|
11
|
+
|
|
12
|
+
## Skill Discovery
|
|
13
|
+
|
|
14
|
+
When a task arrives, identify the development phase and apply the corresponding skill:
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
Task arrives
|
|
18
|
+
│
|
|
19
|
+
├── Don't know what you want yet? ──────→ interview-me
|
|
20
|
+
├── Have a rough concept, need variants? → idea-refine
|
|
21
|
+
├── New project/feature/change? ──→ spec-driven-development
|
|
22
|
+
├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
|
|
23
|
+
├── Implementing code? ────────────→ incremental-implementation
|
|
24
|
+
│ ├── UI work? ─────────────────→ frontend-ui-engineering
|
|
25
|
+
│ ├── API work? ────────────────→ api-and-interface-design
|
|
26
|
+
│ ├── Need better context? ─────→ context-engineering
|
|
27
|
+
│ ├── Need doc-verified code? ───→ source-driven-development
|
|
28
|
+
│ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
|
|
29
|
+
├── Writing/running tests? ────────→ test-driven-development
|
|
30
|
+
│ └── Browser-based? ───────────→ browser-testing-with-devtools
|
|
31
|
+
├── Something broke? ──────────────→ debugging-and-error-recovery
|
|
32
|
+
├── Reviewing code? ───────────────→ code-review-and-quality
|
|
33
|
+
│ ├── Too complex? ─────────────→ code-simplification
|
|
34
|
+
│ ├── Security concerns? ───────→ security-and-hardening
|
|
35
|
+
│ └── Performance concerns? ────→ performance-optimization
|
|
36
|
+
├── Committing/branching? ─────────→ git-workflow-and-versioning
|
|
37
|
+
├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
|
|
38
|
+
├── Deprecating/migrating? ────────→ deprecation-and-migration
|
|
39
|
+
├── Writing docs/ADRs? ───────────→ documentation-and-adrs
|
|
40
|
+
├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
|
|
41
|
+
└── Deploying/launching? ─────────→ shipping-and-launch
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Core Operating Behaviors
|
|
45
|
+
|
|
46
|
+
These behaviors apply at all times, across all skills. They are non-negotiable.
|
|
47
|
+
|
|
48
|
+
### 1. Surface Assumptions
|
|
49
|
+
|
|
50
|
+
Before implementing anything non-trivial, explicitly state your assumptions:
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
ASSUMPTIONS I'M MAKING:
|
|
54
|
+
1. [assumption about requirements]
|
|
55
|
+
2. [assumption about architecture]
|
|
56
|
+
3. [assumption about scope]
|
|
57
|
+
→ Correct me now or I'll proceed with these.
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
|
|
61
|
+
|
|
62
|
+
### 2. Manage Confusion Actively
|
|
63
|
+
|
|
64
|
+
When you encounter inconsistencies, conflicting requirements, or unclear specifications:
|
|
65
|
+
|
|
66
|
+
1. **STOP.** Do not proceed with a guess.
|
|
67
|
+
2. Name the specific confusion.
|
|
68
|
+
3. Present the tradeoff or ask the clarifying question.
|
|
69
|
+
4. Wait for resolution before continuing.
|
|
70
|
+
|
|
71
|
+
**Bad:** Silently picking one interpretation and hoping it's right.
|
|
72
|
+
**Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
|
|
73
|
+
|
|
74
|
+
### 3. Push Back When Warranted
|
|
75
|
+
|
|
76
|
+
You are not a yes-machine. When an approach has clear problems:
|
|
77
|
+
|
|
78
|
+
- Point out the issue directly
|
|
79
|
+
- Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
|
|
80
|
+
- Propose an alternative
|
|
81
|
+
- Accept the human's decision if they override with full information
|
|
82
|
+
|
|
83
|
+
Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
|
|
84
|
+
|
|
85
|
+
### 4. Enforce Simplicity
|
|
86
|
+
|
|
87
|
+
Your natural tendency is to overcomplicate. Actively resist it.
|
|
88
|
+
|
|
89
|
+
Before finishing any implementation, ask:
|
|
90
|
+
- Can this be done in fewer lines?
|
|
91
|
+
- Are these abstractions earning their complexity?
|
|
92
|
+
- Would a staff engineer look at this and say "why didn't you just..."?
|
|
93
|
+
|
|
94
|
+
If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
|
|
95
|
+
|
|
96
|
+
### 5. Maintain Scope Discipline
|
|
97
|
+
|
|
98
|
+
Touch only what you're asked to touch.
|
|
99
|
+
|
|
100
|
+
Do NOT:
|
|
101
|
+
- Remove comments you don't understand
|
|
102
|
+
- "Clean up" code orthogonal to the task
|
|
103
|
+
- Refactor adjacent systems as a side effect
|
|
104
|
+
- Delete code that seems unused without explicit approval
|
|
105
|
+
- Add features not in the spec because they "seem useful"
|
|
106
|
+
|
|
107
|
+
Your job is surgical precision, not unsolicited renovation.
|
|
108
|
+
|
|
109
|
+
### 6. Verify, Don't Assume
|
|
110
|
+
|
|
111
|
+
Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
|
|
112
|
+
|
|
113
|
+
Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
|
|
114
|
+
|
|
115
|
+
## Failure Modes to Avoid
|
|
116
|
+
|
|
117
|
+
These are the subtle errors that look like productivity but create problems:
|
|
118
|
+
|
|
119
|
+
1. Making wrong assumptions without checking
|
|
120
|
+
2. Not managing your own confusion — plowing ahead when lost
|
|
121
|
+
3. Not surfacing inconsistencies you notice
|
|
122
|
+
4. Not presenting tradeoffs on non-obvious decisions
|
|
123
|
+
5. Being sycophantic ("Of course!") to approaches with clear problems
|
|
124
|
+
6. Overcomplicating code and APIs
|
|
125
|
+
7. Modifying code or comments orthogonal to the task
|
|
126
|
+
8. Removing things you don't fully understand
|
|
127
|
+
9. Building without a spec because "it's obvious"
|
|
128
|
+
10. Skipping verification because "it looks right"
|
|
129
|
+
|
|
130
|
+
## Skill Rules
|
|
131
|
+
|
|
132
|
+
1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
|
|
133
|
+
|
|
134
|
+
2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
|
|
135
|
+
|
|
136
|
+
3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
|
|
137
|
+
|
|
138
|
+
4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
|
|
139
|
+
|
|
140
|
+
## Lifecycle Sequence
|
|
141
|
+
|
|
142
|
+
For a complete feature, the typical skill sequence is:
|
|
143
|
+
|
|
144
|
+
```
|
|
145
|
+
1. interview-me → Extract what the user actually wants
|
|
146
|
+
2. idea-refine → Refine vague ideas
|
|
147
|
+
3. spec-driven-development → Define what we're building
|
|
148
|
+
4. planning-and-task-breakdown → Break into verifiable chunks
|
|
149
|
+
5. context-engineering → Load the right context
|
|
150
|
+
6. source-driven-development → Verify against official docs
|
|
151
|
+
7. incremental-implementation → Build slice by slice
|
|
152
|
+
8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
|
|
153
|
+
9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
|
|
154
|
+
10. test-driven-development → Prove each slice works
|
|
155
|
+
11. code-review-and-quality → Review before merge
|
|
156
|
+
12. code-simplification → Reduce unnecessary complexity while preserving behavior
|
|
157
|
+
13. git-workflow-and-versioning → Clean commit history
|
|
158
|
+
14. documentation-and-adrs → Document decisions
|
|
159
|
+
15. deprecation-and-migration → Retire old systems and move users safely when needed
|
|
160
|
+
16. shipping-and-launch → Deploy safely
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
|
|
164
|
+
|
|
165
|
+
## Quick Reference
|
|
166
|
+
|
|
167
|
+
| Phase | Skill | One-Line Summary |
|
|
168
|
+
|-------|-------|-----------------|
|
|
169
|
+
| Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
|
|
170
|
+
| Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
|
|
171
|
+
| Define | spec-driven-development | Requirements and acceptance criteria before code |
|
|
172
|
+
| Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
|
|
173
|
+
| Build | incremental-implementation | Thin vertical slices, test each before expanding |
|
|
174
|
+
| Build | source-driven-development | Verify against official docs before implementing |
|
|
175
|
+
| Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
|
|
176
|
+
| Build | context-engineering | Right context at the right time |
|
|
177
|
+
| Build | frontend-ui-engineering | Production-quality UI with accessibility |
|
|
178
|
+
| Build | api-and-interface-design | Stable interfaces with clear contracts |
|
|
179
|
+
| Verify | test-driven-development | Failing test first, then make it pass |
|
|
180
|
+
| Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
|
|
181
|
+
| Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
|
|
182
|
+
| Review | code-review-and-quality | Five-axis review with quality gates |
|
|
183
|
+
| Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
|
|
184
|
+
| Review | security-and-hardening | OWASP prevention, input validation, least privilege |
|
|
185
|
+
| Review | performance-optimization | Measure first, optimize only what matters |
|
|
186
|
+
| Ship | git-workflow-and-versioning | Atomic commits, clean history |
|
|
187
|
+
| Ship | ci-cd-and-automation | Automated quality gates on every change |
|
|
188
|
+
| Ship | deprecation-and-migration | Remove old systems and migrate users safely |
|
|
189
|
+
| Ship | documentation-and-adrs | Document the why, not just the what |
|
|
190
|
+
| Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
|
|
191
|
+
| Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Agent Fleet changelog
|
|
2
2
|
|
|
3
|
+
## 2.0.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 8f36484: Add the headless deterministic workflow runtime, workflow drafting skill and generator, scoped TypeScript authoring gate, executable workflow documentation, and installer/package wiring.
|
|
8
|
+
- e007380: Add numbered `just flow cleanup` and `just flow merge` branch maintenance, persisted source/result metadata, safe Worktrunk removal, and accepted-run squash merging back to the originating branch.
|
|
9
|
+
|
|
3
10
|
## 2.0.0
|
|
4
11
|
|
|
5
12
|
### Major Changes
|
package/README.md
CHANGED
|
@@ -107,6 +107,27 @@ just fleet --agents frontend --peers frontend --project af
|
|
|
107
107
|
# same Hub + standing peers in Herdr
|
|
108
108
|
```
|
|
109
109
|
|
|
110
|
+
### Deterministic flows and branch maintenance
|
|
111
|
+
|
|
112
|
+
The optional workflow runtime runs code-owned, headless graphs separately from the interactive Hub. Each run starts a `flow/<name>-<runId>` branch and records where it should merge back:
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
just flow scout "where is authentication configured?"
|
|
116
|
+
just flow quality
|
|
117
|
+
just flow build-test "add the validated endpoint"
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
Completed branches have a numbered Worktrunk-backed selector:
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
just flow cleanup # show branches and prompt for a number
|
|
124
|
+
just flow cleanup 1 # safely remove empty or integrated selection 1
|
|
125
|
+
just flow merge # show branches and prompt for a number
|
|
126
|
+
just flow merge 2 # squash-merge accepted selection 2, then remove it
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
Dirty worktrees and rejected runs are not merged. See the [workflow guide](docs/workflows.md#clean-up-and-merge-flow-branches) for full branch selectors, `--target`, explicit `--discard`, and non-interactive `--yes`.
|
|
130
|
+
|
|
110
131
|
### Updating
|
|
111
132
|
|
|
112
133
|
A pi session prints a banner when a newer version is published. Your preset and
|
package/agents/code-reviewer.md
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: code-reviewer
|
|
3
3
|
description: Senior code reviewer that evaluates changes across five dimensions — correctness, readability, architecture, security, and performance. Use for thorough code review before merge.
|
|
4
4
|
tools: read,bash,grep,find,ls
|
|
5
|
+
writes: []
|
|
5
6
|
model: xai/grok-4.6
|
|
6
7
|
models:
|
|
7
8
|
- openai-codex/gpt-5.6-terra
|
package/agents/documenter.md
CHANGED
package/agents/planner.md
CHANGED
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
name: planner
|
|
3
3
|
description: Architecture and implementation planning — produces a written PLAN file with dependency-ordered tasks and acceptance criteria. Use when work spans multiple files or needs a task breakdown before building.
|
|
4
4
|
tools: read,grep,find,ls,bash,write
|
|
5
|
+
writes:
|
|
6
|
+
- docs/plans/
|
|
5
7
|
model: openai-codex/gpt-5.6-sol
|
|
6
8
|
models:
|
|
7
9
|
- github-copilot/claude-fable-5
|
package/agents/researcher.md
CHANGED
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -9,6 +9,7 @@ the runtime responsibilities and where each module lives in the repository.
|
|
|
9
9
|
| --- | --- | --- |
|
|
10
10
|
| **Pi Coding Agent** | Primary local runtime — runs the dispatcher and specialist subagents | `.pi/harnesses/`, `.pi/extensions/`, `.pi/agents/`, `.pi/prompts/` |
|
|
11
11
|
| **agent-hub** | Thin-context multi-agent harness: dispatcher + specialists + research helpers + Verification Contract | `.pi/harnesses/agent-hub/` |
|
|
12
|
+
| **Workflows** | Headless, code-owned phase order, retries, gates, writes enforcement, and acceptance through `just flow` | `scripts/flow.ts`, `scripts/workflows/` — see [workflows.md](workflows.md) |
|
|
12
13
|
| **Herdr** | Fleet/workspace control plane — spawns peer teams as tiled workspaces, presence via push events, snapshot/resume | [herdr.dev](https://herdr.dev); client in `.pi/harnesses/lib/herdr-client.ts`, layout in `scripts/lib/herdr-layout.ts` |
|
|
13
14
|
| **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | Shared peer lifecycle in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; Pi registrations in `.pi/harnesses/coms/` and `agent-hub/`; wire helpers in `scripts/lib/coms-envelope.ts` and `scripts/coms-cli.ts` |
|
|
14
15
|
| **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `scripts/coms-claude-bridge.ts`, `hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
|
|
@@ -299,6 +300,7 @@ Cross-harness coms lifecycle remains shared in `.pi/harnesses/lib/coms-core.ts`
|
|
|
299
300
|
skills/ # Agent Fleet-native skills (shadow vendored names)
|
|
300
301
|
agents/ # Personas/subagents used by Agent Fleet
|
|
301
302
|
scripts/ # CLI helpers, bridges, team + one-off peer launchers (pure logic in scripts/lib/)
|
|
303
|
+
scripts/workflows/ # deterministic flow graphs + phase/gate/permission/quality runtime
|
|
302
304
|
hermes/ # Hermes-facing skills/integration assets
|
|
303
305
|
codex/ # Canonical Codex conductor contract (runtime copy lives outside checkout)
|
|
304
306
|
systemd/user/ # Owned user-unit template for Codex remote control
|
|
@@ -320,6 +322,7 @@ packages/hermes-bridge/ # future Hermes integration package
|
|
|
320
322
|
|
|
321
323
|
## Design rules
|
|
322
324
|
|
|
325
|
+
- **Workflows are isolated from the Hub.** `just flow` owns deterministic phase order, retries, executable gates, post-hoc writes enforcement, and one acceptance decision. It uses the clean spawn/context seams but never routes through hub dispatch; flow traces live under `.pi/flow-sessions/`. Flow branches retain source/result metadata, while the reserved `cleanup` and `merge` maintenance subcommands delegate safe removal and squash integration to Worktrunk. A future `run_flow` hub tool is design-only and would call the dispatcher module directly, never shell through `just`.
|
|
323
326
|
- **Thin dispatcher context.** Nothing lands persistently in the dispatcher's
|
|
324
327
|
context if it can live on disk or in a one-line status. Research findings,
|
|
325
328
|
the Verification Contract ledger, and team snapshots are all disk-first.
|
package/docs/getting-started.md
CHANGED
|
@@ -47,6 +47,27 @@ just fleet --agents default --peers docs --project af
|
|
|
47
47
|
# Hub + standing Herdr peers
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## Run and maintain deterministic flows
|
|
51
|
+
|
|
52
|
+
When the workflow runtime is selected, `just flow` runs code-owned workflows outside the interactive hub:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
just flow scout "where is authentication configured?"
|
|
56
|
+
just flow quality
|
|
57
|
+
just flow build-test "add the validated endpoint"
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Each run creates a `flow/<name>-<runId>` branch. Use the numbered maintenance selector to remove an empty/integrated branch or squash-merge an accepted result back to the branch from which it started:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
just flow cleanup # list flow branches and prompt for a number
|
|
64
|
+
just flow cleanup 1 # safely remove selection 1 through Worktrunk
|
|
65
|
+
just flow merge # list flow branches and prompt for a number
|
|
66
|
+
just flow merge 2 # squash-merge selection 2 through Worktrunk
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Maintenance requires [Worktrunk](https://worktrunk.dev). It refuses dirty worktrees, rejected runs, and unknown merge targets. See [workflows.md](workflows.md#clean-up-and-merge-flow-branches) for `--discard`, `--target`, full branch selectors, non-interactive `--yes`, and safety details.
|
|
70
|
+
|
|
50
71
|
## Update an existing install
|
|
51
72
|
|
|
52
73
|
A pi session tells you when a newer version is published. To act on it:
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
# Deterministic Workflows
|
|
2
|
+
|
|
3
|
+
Agent Fleet provides a code-owned, headless workflow layer beside the interactive `agent-hub`. Workflow code fixes phase order, bounded retries, executable gates, permissions, and acceptance; agents are used only for phases that require judgment. Nothing in this layer changes `just fleet`.
|
|
4
|
+
|
|
5
|
+
## Run a flow
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
just flow quality
|
|
9
|
+
just flow scout "where is authentication configured?"
|
|
10
|
+
just flow build-test "add the validated endpoint"
|
|
11
|
+
just flow document
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
The raw entry point is equivalent and loads `.env` itself:
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
node --experimental-strip-types scripts/flow.ts quality
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Options:
|
|
21
|
+
|
|
22
|
+
- `--dry-run` executes the full graph with valid stub agent envelopes and no model calls.
|
|
23
|
+
- `--run-id <id>` assigns a trace id.
|
|
24
|
+
- `--allow-dirty` explicitly bypasses the normal clean-tree refusal.
|
|
25
|
+
|
|
26
|
+
Exit codes are `0` accepted, `1` failed/unaccepted, `2` invalid arguments or unknown flow, and `3` startup refusal. SIGINT/SIGTERM finalize the run trace and return `128 + signal`.
|
|
27
|
+
|
|
28
|
+
## Clean up and merge flow branches
|
|
29
|
+
|
|
30
|
+
Every run records its source branch and commit before creating `flow/<name>-<runId>`, then records whether the run was accepted or rejected. The reserved `cleanup` and `merge` subcommands use that metadata and [Worktrunk](https://worktrunk.dev) to manage completed branches.
|
|
31
|
+
|
|
32
|
+
List branches and open the numbered prompt in a terminal:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
just flow cleanup
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Example output:
|
|
39
|
+
|
|
40
|
+
```text
|
|
41
|
+
Flow branches:
|
|
42
|
+
1. flow/scout-scout-demo accepted clean ↑0 ↓0 target: main
|
|
43
|
+
2. flow/build-test-api-42 accepted clean ↑1 ↓0 target: feature/api
|
|
44
|
+
|
|
45
|
+
Select with a number or full branch name.
|
|
46
|
+
Clean up which flow branch?
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Select by the displayed number or by its stable full name:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
just flow cleanup 1
|
|
53
|
+
just flow cleanup flow/scout-scout-demo
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Normal cleanup calls `wt remove` without force. Worktrunk removes only clean work that is empty or already integrated; otherwise the command fails and keeps the branch. To intentionally discard a clean but unmerged branch, make that destructive intent explicit:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
just flow cleanup 2 --discard
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
The wrapper never passes Worktrunk's worktree `--force` flag: a dirty worktree must be committed or stashed manually. In non-interactive automation, listing without a selector only prints options; a selected mutation also requires `--yes`:
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
just flow cleanup flow/scout-scout-demo --yes
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Merge presents the same selector:
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
just flow merge
|
|
72
|
+
just flow merge 2
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Only an accepted run with a clean worktree can merge. The command invokes Worktrunk's standard `wt merge <target>` pipeline: squash to one commit, rebase onto the recorded source branch when necessary, run configured hooks, fast-forward the target, then remove the flow worktree and branch. If a selected branch is not checked out, Worktrunk first materializes its worktree. Old flow branches without source metadata require an explicit local target rather than a guess:
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
just flow merge flow/build-test-api-42 --target feature/api
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
Maintenance does not fetch remotes and does not delete `.pi/flow-sessions/<runId>`; traces remain as local execution evidence. `cleanup` and `merge` are reserved maintenance names and cannot be generated as workflow names.
|
|
82
|
+
|
|
83
|
+
## Shipped flows
|
|
84
|
+
|
|
85
|
+
| Flow | Shape | Purpose |
|
|
86
|
+
| --- | --- | --- |
|
|
87
|
+
| `quality` | `engineer(request) → code(quality)` | Run configured quality evidence without an agent. |
|
|
88
|
+
| `scout` | `engineer(request) → agent(scout)` | Read-only repository reconnaissance. |
|
|
89
|
+
| `build-test` | `engineer(request) → agent(builder) → code(test) → agent(builder-fix, bounded) → code(commit)` | Build, deterministically test, repair within a bound, then commit once. |
|
|
90
|
+
| `document` | `code(changes) → agent(documenter) → code(commit)` | Capture changes deterministically, document them, gate files, then commit. |
|
|
91
|
+
|
|
92
|
+
## Quality configuration
|
|
93
|
+
|
|
94
|
+
Quality blocks require a non-empty `quality:` command in `## workflows` in `.ai/agent-fleet-overrides.md`; there is **no implicit `npm test` fallback**. A missing override, missing `## workflows` section, or empty `quality:` value is a startup refusal (exit `3`), rather than a fake green command. The value is split into argv using simple shell-style quotes, inherits the operator environment, and runs without a shell.
|
|
95
|
+
|
|
96
|
+
```markdown
|
|
97
|
+
## workflows
|
|
98
|
+
quality: npm test
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
The runtime currently uses its 1,800-second default timeout; `timeout-seconds:` and JSON-array values are not workflow configuration keys. Command output is stored in `.pi/flow-sessions/<runId>/command.log`. A missing executable produces exit `127` and its actual diagnostic.
|
|
102
|
+
|
|
103
|
+
## Safety and evidence
|
|
104
|
+
|
|
105
|
+
Normal runs require a clean tree and create `flow/<name>-<runId>`. The branch stores its source branch, source commit, flow name, run id, and final acceptance as local Git metadata so maintenance can merge back without guessing. Every agent phase must receive an explicit writes policy from persona frontmatter or its call site; a missing policy is refused before spawn rather than silently treated as unrestricted. `writes: []` is repository read-only, and a non-empty list is an allowlist. Agent writes are checked after each phase against that policy and workflow `protectedGlobs`. `protectedGlobs` reject a path only when no `writes` glob matches it, so `writes: ["**"]` also permits a protected path. `*` stays within one path segment; `**` crosses directories. Out-of-policy changes introduced by the agent are rolled back and terminate the phase. Runtime reports remain writable even for repository-read-only agents. This enforcement exists only in flows; hub behavior is unchanged.
|
|
106
|
+
|
|
107
|
+
Every run writes JSONL under `.pi/flow-sessions/<runId>/trace.jsonl`; this directory is gitignored and separate from hub sessions. Phase success and work acceptance are separate. `run.finish()` produces the exit code, final trace status, and banner from one decision so they cannot disagree.
|
|
108
|
+
|
|
109
|
+
Agent reports use TypeBox envelopes built on the existing return-contract vocabulary. Invalid reports are corrected in the same Pi session with exact field errors. Executable gates inspect artifacts, sizes, JSON, changed-file claims, real test commands, and review-verdict consistency. Permission breaches are terminal rather than correctable.
|
|
110
|
+
|
|
111
|
+
## Author a workflow
|
|
112
|
+
|
|
113
|
+
Invoke the `drafting-workflows` skill. It first reads this map, lists available `wf-*.ts` shapes one per line, and waits. After the operator supplies intent, use the deterministic generator:
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
|
|
117
|
+
plan-build-review 'agent(plan) → agent(build) → agent(review)'
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
The generator copies the nearest complete workflow, preserves commas inside parenthesized phase annotations, replaces its phase docstring block, and renames the workflow and optional preflight symbols to the unique camel-cased identity derived from the new filename (for example, `planBuildReviewWorkflow`). Built-in flows are listed in `scripts/flow.ts`; a non-built-in `wf-<name>.ts` is resolved on demand by that same export convention, making a generated draft reachable through `just flow <name>` without editing the built-in map. TODOs remain only for gate, retry, and acceptance judgments. The generator refuses to return a draft unless both of these pass:
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
npx tsc -p scripts/workflows/tsconfig.json --noEmit
|
|
124
|
+
node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
|
|
125
|
+
--verify-draft scripts/workflows/wf-plan-build-review.ts
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
The scoped TypeScript project checks workflow production sources only; the dry-run resolves the same exact export convention as `just flow`; workflow imports cross into hub seams through typed dynamic imports, so neither check makes `.pi/harnesses/**` part of the typecheck. See [workflow-authoring.md](../references/workflow-authoring.md) for envelopes, correction, gates, permissions, quality, change capture, dry-run, and packaging contracts.
|
|
129
|
+
|
|
130
|
+
## Architecture boundary
|
|
131
|
+
|
|
132
|
+
`just flow` directly composes `scripts/workflows/lib/` with the clean `spawnPiAgent` and context seams. It does not call `dispatch-native.ts`, use the hub ledger as acceptance, or change hub scope semantics. `just fleet`, coms peers, Herdr, Hermes, budgets, and the Fleet Dashboard continue to operate as before.
|
|
133
|
+
|
|
134
|
+
## Future `run_flow` tool (D8, design only)
|
|
135
|
+
|
|
136
|
+
A future hub tool may call the exported flow dispatcher module directly with validated arguments. It must never shell through `just`, and it must preserve clean-tree checks, cancellation, trace finalization, permission enforcement, and exact acceptance semantics. This release intentionally registers no `run_flow` tool and modifies no hub implementation; budgeting and cancellation ownership require a separate design/implementation cycle.
|
package/install-manifest.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 2,
|
|
3
|
-
"packageVersion": "2.0.
|
|
3
|
+
"packageVersion": "2.0.1",
|
|
4
4
|
"groups": [
|
|
5
5
|
{
|
|
6
6
|
"id": "skills",
|
|
@@ -650,6 +650,9 @@
|
|
|
650
650
|
"strategy": "managed-region"
|
|
651
651
|
}
|
|
652
652
|
},
|
|
653
|
+
"companions": [
|
|
654
|
+
"companion:workflow-runtime"
|
|
655
|
+
],
|
|
653
656
|
"parents": [
|
|
654
657
|
"pi-harness:agent-hub",
|
|
655
658
|
"pi-harness:ask-user-remote",
|
|
@@ -899,6 +902,37 @@
|
|
|
899
902
|
"pi-extension:pi-voice-stt"
|
|
900
903
|
]
|
|
901
904
|
},
|
|
905
|
+
{
|
|
906
|
+
"id": "companion:workflow-runtime",
|
|
907
|
+
"kind": "companion",
|
|
908
|
+
"group": "companions",
|
|
909
|
+
"subcategory": null,
|
|
910
|
+
"title": "Deterministic workflow runtime",
|
|
911
|
+
"summary": "Headless flow dispatcher, workflow graphs, scoped configuration, and operations guide",
|
|
912
|
+
"recommended": false,
|
|
913
|
+
"stability": "stable",
|
|
914
|
+
"consent": "file",
|
|
915
|
+
"platform": "any",
|
|
916
|
+
"agents": {
|
|
917
|
+
"pi": {
|
|
918
|
+
"source": [
|
|
919
|
+
"scripts/flow.ts",
|
|
920
|
+
"scripts/lib/flow-command.ts",
|
|
921
|
+
"scripts/lib/flow-maintenance.ts",
|
|
922
|
+
"scripts/workflows",
|
|
923
|
+
"docs/workflows.md"
|
|
924
|
+
],
|
|
925
|
+
"sourceMode": "all",
|
|
926
|
+
"target": null,
|
|
927
|
+
"strategy": "copy-tree",
|
|
928
|
+
"preserveLayout": true
|
|
929
|
+
}
|
|
930
|
+
},
|
|
931
|
+
"parents": [
|
|
932
|
+
"companion:justfile-region",
|
|
933
|
+
"skill:drafting-workflows"
|
|
934
|
+
]
|
|
935
|
+
},
|
|
902
936
|
{
|
|
903
937
|
"id": "external:pi-ask-user",
|
|
904
938
|
"kind": "external-package",
|
|
@@ -2045,6 +2079,31 @@
|
|
|
2045
2079
|
"skill:test-driven-development"
|
|
2046
2080
|
]
|
|
2047
2081
|
},
|
|
2082
|
+
{
|
|
2083
|
+
"id": "reference:workflow-authoring",
|
|
2084
|
+
"kind": "reference",
|
|
2085
|
+
"group": "references",
|
|
2086
|
+
"subcategory": null,
|
|
2087
|
+
"title": "workflow-authoring",
|
|
2088
|
+
"summary": "",
|
|
2089
|
+
"recommended": false,
|
|
2090
|
+
"stability": "stable",
|
|
2091
|
+
"consent": "file",
|
|
2092
|
+
"platform": "any",
|
|
2093
|
+
"agents": {
|
|
2094
|
+
"pi": {
|
|
2095
|
+
"source": [
|
|
2096
|
+
"references/workflow-authoring.md"
|
|
2097
|
+
],
|
|
2098
|
+
"sourceMode": "first",
|
|
2099
|
+
"target": ".pi/references/workflow-authoring.md",
|
|
2100
|
+
"strategy": "copy-file"
|
|
2101
|
+
}
|
|
2102
|
+
},
|
|
2103
|
+
"parents": [
|
|
2104
|
+
"skill:drafting-workflows"
|
|
2105
|
+
]
|
|
2106
|
+
},
|
|
2048
2107
|
{
|
|
2049
2108
|
"id": "skill:api-and-interface-design",
|
|
2050
2109
|
"kind": "skill",
|
|
@@ -2330,6 +2389,32 @@
|
|
|
2330
2389
|
"reference:orchestration-patterns"
|
|
2331
2390
|
]
|
|
2332
2391
|
},
|
|
2392
|
+
{
|
|
2393
|
+
"id": "skill:drafting-workflows",
|
|
2394
|
+
"kind": "skill",
|
|
2395
|
+
"group": "skills",
|
|
2396
|
+
"subcategory": "meta",
|
|
2397
|
+
"title": "drafting-workflows",
|
|
2398
|
+
"summary": "Drafts deterministic Agent Fleet workflows by adapting the nearest existing flow and proving the draft compiles and d…",
|
|
2399
|
+
"recommended": false,
|
|
2400
|
+
"stability": "stable",
|
|
2401
|
+
"consent": "file",
|
|
2402
|
+
"platform": "any",
|
|
2403
|
+
"agents": {
|
|
2404
|
+
"pi": {
|
|
2405
|
+
"source": [
|
|
2406
|
+
"skills/drafting-workflows"
|
|
2407
|
+
],
|
|
2408
|
+
"sourceMode": "first",
|
|
2409
|
+
"target": ".pi/skills/drafting-workflows",
|
|
2410
|
+
"strategy": "copy-tree"
|
|
2411
|
+
}
|
|
2412
|
+
},
|
|
2413
|
+
"companions": [
|
|
2414
|
+
"companion:workflow-runtime",
|
|
2415
|
+
"reference:workflow-authoring"
|
|
2416
|
+
]
|
|
2417
|
+
},
|
|
2333
2418
|
{
|
|
2334
2419
|
"id": "skill:frontend-ui-engineering",
|
|
2335
2420
|
"kind": "skill",
|
package/justfile
CHANGED
|
@@ -76,6 +76,15 @@ default:
|
|
|
76
76
|
# just fleet team frontend --project af # use canonical --agents/--peers flags
|
|
77
77
|
# just fleet team frontend --no-hub # legacy peers-only topology
|
|
78
78
|
#
|
|
79
|
+
# DETERMINISTIC FLOWS AND BRANCH MAINTENANCE
|
|
80
|
+
# just flow scout "where is authentication configured?"
|
|
81
|
+
# just flow quality
|
|
82
|
+
# just flow build-test "add the validated endpoint"
|
|
83
|
+
# just flow cleanup # numbered selector
|
|
84
|
+
# just flow cleanup 2 # safe Worktrunk removal
|
|
85
|
+
# just flow merge # numbered selector
|
|
86
|
+
# just flow merge 2 # Worktrunk squash merge to recorded source
|
|
87
|
+
#
|
|
79
88
|
# TEAM LIFECYCLE
|
|
80
89
|
# just fleet snapshot frontend --project af
|
|
81
90
|
# just fleet down frontend --project af
|
|
@@ -107,6 +116,11 @@ default:
|
|
|
107
116
|
fleet *args:
|
|
108
117
|
@{{node_ts}} scripts/fleet.ts {{args}}
|
|
109
118
|
|
|
119
|
+
# Headless workflows plus `flow cleanup` / `flow merge` Worktrunk branch maintenance.
|
|
120
|
+
# Exits 0 accepted/success; 1 rejected/failed; 2 invalid/unknown; 3 refused start.
|
|
121
|
+
flow *args:
|
|
122
|
+
@{{node_ts}} scripts/flow.ts {{args}}
|
|
123
|
+
|
|
110
124
|
# Hidden Fleet Core launcher. Positional booleans are emitted only by fleet.ts.
|
|
111
125
|
_fleet-core browser="false" voice="false" all_extensions="false" *args:
|
|
112
126
|
discovery="--no-extensions"; if [ "{{all_extensions}}" = "true" ]; then discovery=""; fi; browser_ext=""; if [ "{{browser}}" = "true" ]; then browser_ext="{{fleet_browser_extension}}"; fi; voice_ext=""; if [ "{{voice}}" = "true" ]; then voice_ext="{{fleet_voice_extension}}"; fi; pi $discovery {{fleet_core_extensions}} $browser_ext $voice_ext {{args}}
|