@chankov/agent-fleet 0.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/.claude/commands/build.md +44 -0
- package/.claude/commands/code-simplify.md +22 -0
- package/.claude/commands/design-agent.md +14 -0
- package/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.claude/commands/orchestrate.md +112 -0
- package/.claude/commands/plan.md +16 -0
- package/.claude/commands/prime.md +22 -0
- package/.claude/commands/review.md +16 -0
- package/.claude/commands/setup-agent-fleet.md +25 -0
- package/.claude/commands/ship.md +72 -0
- package/.claude/commands/spec.md +15 -0
- package/.claude/commands/test.md +19 -0
- package/.claude/commands/webperf.md +32 -0
- package/.claude/orchestrate-teams.yaml +24 -0
- package/.opencode/commands/af-build.md +17 -0
- package/.opencode/commands/af-code-simplify.md +16 -0
- package/.opencode/commands/af-compound.md +16 -0
- package/.opencode/commands/af-design-agent.md +15 -0
- package/.opencode/commands/af-doctor-agent-fleet.md +15 -0
- package/.opencode/commands/af-orchestrate.md +112 -0
- package/.opencode/commands/af-plan.md +16 -0
- package/.opencode/commands/af-prime.md +22 -0
- package/.opencode/commands/af-review.md +15 -0
- package/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.opencode/commands/af-ship.md +16 -0
- package/.opencode/commands/af-spec.md +16 -0
- package/.opencode/commands/af-test.md +21 -0
- package/.opencode/commands/af-webperf.md +32 -0
- package/.opencode/orchestrate-teams.yaml +24 -0
- package/.pi/agents/dispatch-policy.yaml +32 -0
- package/.pi/agents/model-profiles.yaml +20 -0
- package/.pi/agents/peers.yaml +142 -0
- package/.pi/agents/teams.yaml +39 -0
- package/.pi/damage-control-rules.yaml +297 -0
- package/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.pi/extensions/btw/README.md +118 -0
- package/.pi/extensions/btw/index.ts +917 -0
- package/.pi/extensions/btw/package.json +6 -0
- package/.pi/extensions/btw/state.js +179 -0
- package/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.pi/extensions/package-lock.json +1143 -0
- package/.pi/extensions/package.json +9 -0
- package/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.pi/harnesses/agent-hub/README.md +562 -0
- package/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.pi/harnesses/agent-hub/delegate.ts +363 -0
- package/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.pi/harnesses/agent-hub/helpers.ts +165 -0
- package/.pi/harnesses/agent-hub/index.ts +7098 -0
- package/.pi/harnesses/agent-hub/package.json +6 -0
- package/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.pi/harnesses/agent-hub/spawn.ts +179 -0
- package/.pi/harnesses/ask-user-remote/README.md +10 -0
- package/.pi/harnesses/ask-user-remote/index.ts +253 -0
- package/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.pi/harnesses/coms/README.md +71 -0
- package/.pi/harnesses/coms/index.ts +1743 -0
- package/.pi/harnesses/coms/package.json +6 -0
- package/.pi/harnesses/damage-control/README.md +65 -0
- package/.pi/harnesses/damage-control/index.ts +250 -0
- package/.pi/harnesses/damage-control/package.json +6 -0
- package/.pi/harnesses/damage-control/shared.ts +183 -0
- package/.pi/harnesses/damage-control-continue/README.md +116 -0
- package/.pi/harnesses/damage-control-continue/index.ts +522 -0
- package/.pi/harnesses/damage-control-continue/package.json +6 -0
- package/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.pi/harnesses/package-lock.json +35 -0
- package/.pi/harnesses/package.json +9 -0
- package/.pi/prompts/build.md +24 -0
- package/.pi/prompts/code-simplify.md +22 -0
- package/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.pi/prompts/plan.md +16 -0
- package/.pi/prompts/review.md +16 -0
- package/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.pi/prompts/ship.md +17 -0
- package/.pi/prompts/spec.md +15 -0
- package/.pi/prompts/test.md +19 -0
- package/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.1/.claude/commands/build.md +44 -0
- package/.versions/0.0.1/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.1/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.1/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.1/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.1/.claude/commands/plan.md +16 -0
- package/.versions/0.0.1/.claude/commands/prime.md +22 -0
- package/.versions/0.0.1/.claude/commands/review.md +16 -0
- package/.versions/0.0.1/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.1/.claude/commands/ship.md +72 -0
- package/.versions/0.0.1/.claude/commands/spec.md +15 -0
- package/.versions/0.0.1/.claude/commands/test.md +19 -0
- package/.versions/0.0.1/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.1/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.1/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.1/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.1/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.1/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.1/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.1/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.1/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.1/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.1/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.1/.pi/extensions/package.json +9 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/README.md +562 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/delegate.ts +363 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/helpers.ts +165 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/index.ts +7098 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/spawn.ts +179 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/README.md +10 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/index.ts +253 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.1/.pi/harnesses/coms/README.md +71 -0
- package/.versions/0.0.1/.pi/harnesses/coms/index.ts +1743 -0
- package/.versions/0.0.1/.pi/harnesses/coms/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/README.md +65 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/index.ts +250 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/shared.ts +183 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/README.md +116 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/index.ts +522 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.1/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.1/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.1/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.1/.pi/prompts/build.md +24 -0
- package/.versions/0.0.1/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.1/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.1/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.1/.pi/prompts/review.md +16 -0
- package/.versions/0.0.1/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.1/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.1/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.1/.pi/prompts/test.md +19 -0
- package/.versions/0.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.1/.version +1 -0
- package/.versions/0.0.1/agents/architect.md +21 -0
- package/.versions/0.0.1/agents/bowser.md +25 -0
- package/.versions/0.0.1/agents/builder.md +52 -0
- package/.versions/0.0.1/agents/code-reviewer.md +205 -0
- package/.versions/0.0.1/agents/deep-researcher.md +31 -0
- package/.versions/0.0.1/agents/documenter.md +16 -0
- package/.versions/0.0.1/agents/orchestrator.md +43 -0
- package/.versions/0.0.1/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.1/agents/planner.md +69 -0
- package/.versions/0.0.1/agents/releaser.md +22 -0
- package/.versions/0.0.1/agents/researcher.md +28 -0
- package/.versions/0.0.1/agents/security-auditor.md +166 -0
- package/.versions/0.0.1/agents/test-engineer.md +144 -0
- package/.versions/0.0.1/agents/web-debugger.md +42 -0
- package/.versions/0.0.1/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.1/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.1/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.1/hooks/hooks.json +14 -0
- package/.versions/0.0.1/hooks/session-start.sh +74 -0
- package/.versions/0.0.1/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.1/justfile +143 -0
- package/.versions/0.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.1/references/definition-of-done.md +67 -0
- package/.versions/0.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.1/references/observability-checklist.md +91 -0
- package/.versions/0.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.1/references/performance-checklist.md +153 -0
- package/.versions/0.0.1/references/prompting-patterns.md +380 -0
- package/.versions/0.0.1/references/security-checklist.md +179 -0
- package/.versions/0.0.1/references/testing-patterns.md +236 -0
- package/.versions/0.0.1/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.1/scripts/coms-cli.ts +372 -0
- package/.versions/0.0.1/scripts/coms-hermes-bridge.ts +399 -0
- package/.versions/0.0.1/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.1/scripts/lib/coms-envelope.ts +494 -0
- package/.versions/0.0.1/scripts/lib/herdr-layout.ts +235 -0
- package/.versions/0.0.1/scripts/lib/hermes-bridge-core.ts +238 -0
- package/.versions/0.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.1/scripts/lib/team-project.ts +75 -0
- package/.versions/0.0.1/scripts/lib/team-snapshot.ts +146 -0
- package/.versions/0.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.1/scripts/team-snapshot.ts +221 -0
- package/.versions/0.0.1/scripts/team-up.ts +245 -0
- package/.versions/0.0.1/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.1/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.1/skills/designing-agents/pi-harness-authoring.md +209 -0
- package/.versions/0.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +506 -0
- package/.versions/0.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.1/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.1/skills/peer-coms/SKILL.md +81 -0
- package/.versions/0.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.1/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.1/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.1/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +65 -0
- package/LICENSE +21 -0
- package/README.md +458 -0
- package/agents/architect.md +21 -0
- package/agents/bowser.md +25 -0
- package/agents/builder.md +52 -0
- package/agents/code-reviewer.md +205 -0
- package/agents/deep-researcher.md +31 -0
- package/agents/documenter.md +16 -0
- package/agents/orchestrator.md +43 -0
- package/agents/plan-reviewer.md +60 -0
- package/agents/planner.md +69 -0
- package/agents/releaser.md +22 -0
- package/agents/researcher.md +28 -0
- package/agents/security-auditor.md +166 -0
- package/agents/test-engineer.md +144 -0
- package/agents/web-debugger.md +42 -0
- package/agents/web-performance-auditor.md +192 -0
- package/bin/cli.js +633 -0
- package/bin/force-patch-changesets.js +44 -0
- package/bin/lib/bootstrap.js +323 -0
- package/bin/lib/detect-agent.js +49 -0
- package/bin/lib/doctor.js +302 -0
- package/bin/lib/transform-persona.js +180 -0
- package/bin/lib/update-notifier.js +195 -0
- package/bin/lib/validate-overrides.js +229 -0
- package/bin/snapshot-version.js +91 -0
- package/docs/agent-fleet-setup.md +355 -0
- package/docs/claude-code-coms-bridge.md +93 -0
- package/docs/getting-started.md +169 -0
- package/docs/npm-install.md +335 -0
- package/docs/opencode-setup.md +248 -0
- package/docs/pi-extensions.md +237 -0
- package/docs/pi-setup.md +455 -0
- package/docs/skill-anatomy.md +150 -0
- package/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/hooks/coms-stop-hook.mjs +73 -0
- package/hooks/hooks.json +14 -0
- package/hooks/session-start.sh +74 -0
- package/hooks/simplify-ignore.sh +302 -0
- package/justfile +143 -0
- package/node_modules/pi-ask-user/LICENSE +21 -0
- package/node_modules/pi-ask-user/README.md +156 -0
- package/node_modules/pi-ask-user/index.ts +1795 -0
- package/node_modules/pi-ask-user/package.json +51 -0
- package/node_modules/pi-ask-user/single-select-layout.ts +203 -0
- package/node_modules/pi-ask-user/skills/ask-user/SKILL.md +162 -0
- package/node_modules/pi-ask-user/skills/ask-user/references/ask-user-skill-extension-spec.md +96 -0
- package/package.json +121 -0
- package/references/accessibility-checklist.md +160 -0
- package/references/definition-of-done.md +67 -0
- package/references/fleet-coordination-patterns.md +151 -0
- package/references/observability-checklist.md +91 -0
- package/references/orchestration-patterns.md +370 -0
- package/references/performance-checklist.md +153 -0
- package/references/prompting-patterns.md +380 -0
- package/references/security-checklist.md +179 -0
- package/references/testing-patterns.md +236 -0
- package/scripts/coms-claude-bridge.ts +286 -0
- package/scripts/coms-cli.ts +372 -0
- package/scripts/coms-hermes-bridge.ts +399 -0
- package/scripts/lib/claude-bridge-core.ts +100 -0
- package/scripts/lib/coms-envelope.ts +494 -0
- package/scripts/lib/herdr-layout.ts +235 -0
- package/scripts/lib/hermes-bridge-core.ts +238 -0
- package/scripts/lib/persona-banner.ts +62 -0
- package/scripts/lib/team-project.ts +75 -0
- package/scripts/lib/team-snapshot.ts +146 -0
- package/scripts/peer-banner.ts +40 -0
- package/scripts/team-snapshot.ts +221 -0
- package/scripts/team-up.ts +245 -0
- package/skills/_internal/grilling.md +11 -0
- package/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/skills/code-review-and-quality/SKILL.md +381 -0
- package/skills/compound-learning/SKILL.md +137 -0
- package/skills/context-engineering/SKILL.md +291 -0
- package/skills/deprecation-and-migration/SKILL.md +206 -0
- package/skills/designing-agents/SKILL.md +394 -0
- package/skills/designing-agents/pi-harness-authoring.md +209 -0
- package/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/skills/guided-workspace-setup/SKILL.md +506 -0
- package/skills/idea-refine/SKILL.md +182 -0
- package/skills/idea-refine/examples.md +238 -0
- package/skills/idea-refine/frameworks.md +99 -0
- package/skills/idea-refine/refinement-criteria.md +113 -0
- package/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/skills/incremental-implementation/SKILL.md +287 -0
- package/skills/interview-me/SKILL.md +226 -0
- package/skills/orchestration-verification/SKILL.md +181 -0
- package/skills/peer-coms/SKILL.md +81 -0
- package/skills/performance-optimization/SKILL.md +350 -0
- package/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/skills/security-and-hardening/SKILL.md +461 -0
- package/skills/spec-driven-development/SKILL.md +245 -0
- package/skills/using-agent-skills/SKILL.md +199 -0
- package/vendor/agent-skills-upstream/LICENSE +21 -0
- package/vendor/agent-skills-upstream/README.md +11 -0
- package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# simplify-ignore.sh — Hook for Read (PreToolUse), Edit|Write (PostToolUse), Stop
|
|
3
|
+
#
|
|
4
|
+
# PreToolUse Read → backs up file, replaces blocks with BLOCK_<hash> in-place
|
|
5
|
+
# PostToolUse Edit → expands placeholders, re-filters so file stays hidden
|
|
6
|
+
# PostToolUse Write → expands placeholders, re-filters so file stays hidden
|
|
7
|
+
# Stop → restores real file content from backup
|
|
8
|
+
#
|
|
9
|
+
# The file on disk ALWAYS has placeholders while the session is active.
|
|
10
|
+
# The real content (with model's changes applied) lives in the backup.
|
|
11
|
+
#
|
|
12
|
+
# Dependencies: jq, shasum or sha1sum (auto-detected)
|
|
13
|
+
|
|
14
|
+
set -euo pipefail
|
|
15
|
+
|
|
16
|
+
if ! command -v jq >/dev/null 2>&1; then
|
|
17
|
+
printf '%s\n' "error: missing jq" >&2; exit 1
|
|
18
|
+
fi
|
|
19
|
+
|
|
20
|
+
CACHE="${CLAUDE_PROJECT_DIR:-.}/.claude/.simplify-ignore-cache"
|
|
21
|
+
if [ -t 0 ]; then INPUT="{}"; else INPUT=$(cat); fi
|
|
22
|
+
|
|
23
|
+
# Parse hook input — trap errors explicitly so set -e doesn't cause
|
|
24
|
+
# a silent exit on malformed JSON, and surface a useful diagnostic.
|
|
25
|
+
parse_error=""
|
|
26
|
+
TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null) || {
|
|
27
|
+
parse_error="failed to parse .tool_name from hook input"
|
|
28
|
+
TOOL_NAME=""
|
|
29
|
+
}
|
|
30
|
+
FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null) || {
|
|
31
|
+
parse_error="failed to parse .tool_input.file_path from hook input"
|
|
32
|
+
FILE_PATH=""
|
|
33
|
+
}
|
|
34
|
+
if [ -n "$parse_error" ]; then
|
|
35
|
+
printf 'Warning: %s (input: %.120s)\n' "$parse_error" "$INPUT" >&2
|
|
36
|
+
fi
|
|
37
|
+
|
|
38
|
+
hash_cmd() {
|
|
39
|
+
if command -v shasum >/dev/null 2>&1; then shasum
|
|
40
|
+
elif command -v sha1sum >/dev/null 2>&1; then sha1sum
|
|
41
|
+
else printf '%s\n' "error: missing shasum or sha1sum" >&2; exit 1; fi
|
|
42
|
+
}
|
|
43
|
+
file_id() { printf '%s' "$1" | hash_cmd | cut -c1-16; }
|
|
44
|
+
block_hash() { printf '%s' "$1" | hash_cmd | cut -c1-8; }
|
|
45
|
+
# Escape glob metacharacters so ${var/pattern/repl} treats pattern as literal.
|
|
46
|
+
# Needed for Bash 3.2 (macOS) where quotes don't suppress globbing in PE patterns.
|
|
47
|
+
escape_glob() {
|
|
48
|
+
local s="$1"
|
|
49
|
+
s="${s//\\/\\\\}"
|
|
50
|
+
s="${s//\*/\\*}"
|
|
51
|
+
s="${s//\?/\\?}"
|
|
52
|
+
s="${s//\[/\\[}"
|
|
53
|
+
printf '%s' "$s"
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
# ── filter_file: replace simplify-ignore blocks with BLOCK_<hash> placeholders ─
|
|
57
|
+
# Reads $1 (source), writes filtered version to $2 (dest), saves blocks to cache.
|
|
58
|
+
# Returns 0 if blocks were found, 1 if none.
|
|
59
|
+
filter_file() {
|
|
60
|
+
local src="$1" dest="$2" fid="$3"
|
|
61
|
+
: > "$dest"
|
|
62
|
+
rm -f "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
|
|
63
|
+
|
|
64
|
+
local count=0 in_block=0 buf="" reason="" prefix="" suffix=""
|
|
65
|
+
|
|
66
|
+
while IFS= read -r line || [ -n "$line" ]; do
|
|
67
|
+
# Check for start marker (no fork — uses bash case)
|
|
68
|
+
if [ $in_block -eq 0 ]; then
|
|
69
|
+
case "$line" in *simplify-ignore-start*)
|
|
70
|
+
in_block=1
|
|
71
|
+
buf="$line"
|
|
72
|
+
# Extract comment prefix/suffix to preserve language-appropriate syntax
|
|
73
|
+
prefix="${line%%simplify-ignore-start*}"
|
|
74
|
+
suffix=""
|
|
75
|
+
case "$line" in *'*/'*) suffix=" */" ;; *'-->'*) suffix=" -->" ;; esac
|
|
76
|
+
reason=$(printf '%s' "$line" | sed -n 's/.*simplify-ignore-start:[[:space:]]*//p' \
|
|
77
|
+
| sed 's/[[:space:]]*\*\/.*$//' | sed 's/[[:space:]]*-->.*$//' | sed 's/[[:space:]]*$//')
|
|
78
|
+
# Handle single-line block (start + end on same line)
|
|
79
|
+
case "$line" in *simplify-ignore-end*)
|
|
80
|
+
in_block=0
|
|
81
|
+
# Write single-line block immediately and skip to next line
|
|
82
|
+
# to avoid the end-marker check below firing again
|
|
83
|
+
local h; h=$(block_hash "$buf")
|
|
84
|
+
count=$((count + 1))
|
|
85
|
+
printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
|
|
86
|
+
[ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
|
|
87
|
+
printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
|
|
88
|
+
printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
|
|
89
|
+
if [ -n "$reason" ]; then
|
|
90
|
+
printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
|
|
91
|
+
else
|
|
92
|
+
printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
|
|
93
|
+
fi
|
|
94
|
+
buf=""; reason=""; prefix=""; suffix=""
|
|
95
|
+
continue
|
|
96
|
+
;; *)
|
|
97
|
+
continue
|
|
98
|
+
;;
|
|
99
|
+
esac
|
|
100
|
+
;; esac
|
|
101
|
+
fi
|
|
102
|
+
# Accumulate block content
|
|
103
|
+
if [ $in_block -eq 1 ]; then
|
|
104
|
+
buf="${buf}
|
|
105
|
+
${line}"
|
|
106
|
+
fi
|
|
107
|
+
# Check for end marker
|
|
108
|
+
case "$line" in *simplify-ignore-end*)
|
|
109
|
+
if [ $in_block -eq 1 ]; then
|
|
110
|
+
local h; h=$(block_hash "$buf")
|
|
111
|
+
count=$((count + 1))
|
|
112
|
+
printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
|
|
113
|
+
[ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
|
|
114
|
+
printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
|
|
115
|
+
printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
|
|
116
|
+
if [ -n "$reason" ]; then
|
|
117
|
+
printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
|
|
118
|
+
else
|
|
119
|
+
printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
|
|
120
|
+
fi
|
|
121
|
+
in_block=0; buf=""; reason=""; prefix=""; suffix=""
|
|
122
|
+
continue
|
|
123
|
+
fi
|
|
124
|
+
;;
|
|
125
|
+
esac
|
|
126
|
+
[ $in_block -eq 0 ] && printf '%s\n' "$line" >> "$dest"
|
|
127
|
+
done < "$src"
|
|
128
|
+
|
|
129
|
+
# Unclosed block → flush as-is
|
|
130
|
+
if [ $in_block -eq 1 ] && [ -n "$buf" ]; then
|
|
131
|
+
printf 'Warning: unclosed simplify-ignore-start in %s (block not hidden)\n' "$src" >&2
|
|
132
|
+
printf '%s\n' "$buf" >> "$dest"
|
|
133
|
+
fi
|
|
134
|
+
|
|
135
|
+
# Preserve trailing newline status of source
|
|
136
|
+
if [ -s "$dest" ] && [ -s "$src" ] && [ -n "$(tail -c 1 "$src")" ]; then
|
|
137
|
+
perl -pe 'chomp if eof' "$dest" > "${dest}.nnl" && \
|
|
138
|
+
cat "${dest}.nnl" > "$dest" && rm -f "${dest}.nnl"
|
|
139
|
+
fi
|
|
140
|
+
|
|
141
|
+
[ $count -gt 0 ] && return 0 || return 1
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
# ── Stop: restore all files from backup ───────────────────────────────────────
|
|
145
|
+
if [ -z "$TOOL_NAME" ]; then
|
|
146
|
+
[ -d "$CACHE" ] || exit 0
|
|
147
|
+
for bak in "$CACHE"/*.bak; do
|
|
148
|
+
[ -f "$bak" ] || continue
|
|
149
|
+
fid="${bak##*/}"; fid="${fid%.bak}"
|
|
150
|
+
pathfile="$CACHE/${fid}.path"
|
|
151
|
+
[ -f "$pathfile" ] || { rm -f "$bak"; continue; }
|
|
152
|
+
orig=$(cat "$pathfile")
|
|
153
|
+
if [ -f "$orig" ]; then
|
|
154
|
+
cat "$bak" > "$orig"
|
|
155
|
+
rm -f "$bak" "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
|
|
156
|
+
rmdir "$CACHE/${fid}.lock" 2>/dev/null
|
|
157
|
+
else
|
|
158
|
+
# File was moved/deleted — save backup as .recovered, don't destroy it
|
|
159
|
+
mkdir -p "$(dirname "${orig}.recovered")"
|
|
160
|
+
mv "$bak" "${orig}.recovered"
|
|
161
|
+
rm -f "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
|
|
162
|
+
rmdir "$CACHE/${fid}.lock" 2>/dev/null
|
|
163
|
+
printf 'Warning: %s was moved/deleted. Recovered original to %s.recovered\n' "$orig" "$orig" >&2
|
|
164
|
+
fi
|
|
165
|
+
done
|
|
166
|
+
# Clean orphan locks (created but crash before backup)
|
|
167
|
+
for lockdir in "$CACHE"/*.lock; do
|
|
168
|
+
[ -d "$lockdir" ] || continue
|
|
169
|
+
rmdir "$lockdir" 2>/dev/null
|
|
170
|
+
done
|
|
171
|
+
exit 0
|
|
172
|
+
fi
|
|
173
|
+
|
|
174
|
+
[ -z "$FILE_PATH" ] && exit 0
|
|
175
|
+
|
|
176
|
+
# ── PreToolUse Read: filter in-place ──────────────────────────────────────────
|
|
177
|
+
if [ "$TOOL_NAME" = "Read" ]; then
|
|
178
|
+
[ -f "$FILE_PATH" ] || exit 0
|
|
179
|
+
case "$(basename "$FILE_PATH")" in simplify-ignore*|SIMPLIFY-IGNORE*) exit 0 ;; esac
|
|
180
|
+
|
|
181
|
+
mkdir -p "$CACHE"
|
|
182
|
+
ID=$(file_id "$FILE_PATH")
|
|
183
|
+
|
|
184
|
+
# If backup exists, file is already filtered — skip
|
|
185
|
+
[ -f "$CACHE/${ID}.bak" ] && exit 0
|
|
186
|
+
|
|
187
|
+
grep -q 'simplify-ignore-start' -- "$FILE_PATH" || exit 0
|
|
188
|
+
|
|
189
|
+
# Atomic lock: mkdir fails if another session races us
|
|
190
|
+
if ! mkdir "$CACHE/${ID}.lock" 2>/dev/null; then
|
|
191
|
+
# Lock exists — reclaim only if stale (>60s old, no backup = crash leftover)
|
|
192
|
+
if [ ! -f "$CACHE/${ID}.bak" ] && \
|
|
193
|
+
[ -n "$(find "$CACHE/${ID}.lock" -maxdepth 0 -mmin +1 2>/dev/null)" ]; then
|
|
194
|
+
rmdir "$CACHE/${ID}.lock" 2>/dev/null || true
|
|
195
|
+
mkdir "$CACHE/${ID}.lock" 2>/dev/null || exit 0
|
|
196
|
+
else
|
|
197
|
+
exit 0
|
|
198
|
+
fi
|
|
199
|
+
fi
|
|
200
|
+
|
|
201
|
+
# Back up the original (preserve trailing newline status)
|
|
202
|
+
cp -p "$FILE_PATH" "$CACHE/${ID}.bak" 2>/dev/null || cp "$FILE_PATH" "$CACHE/${ID}.bak"
|
|
203
|
+
printf '%s' "$FILE_PATH" > "$CACHE/${ID}.path"
|
|
204
|
+
|
|
205
|
+
# Filter in-place (cat > preserves inode and permissions)
|
|
206
|
+
FILTERED="$CACHE/${ID}.$$.tmp"
|
|
207
|
+
rm -f "$FILTERED"
|
|
208
|
+
if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
|
|
209
|
+
cat "$FILTERED" > "$FILE_PATH"
|
|
210
|
+
rm -f "$FILTERED"
|
|
211
|
+
else
|
|
212
|
+
rm -f "$FILTERED" "$CACHE/${ID}.bak" "$CACHE/${ID}.path"
|
|
213
|
+
rmdir "$CACHE/${ID}.lock" 2>/dev/null
|
|
214
|
+
fi
|
|
215
|
+
exit 0
|
|
216
|
+
fi
|
|
217
|
+
|
|
218
|
+
# ── PostToolUse Edit|Write: expand, then re-filter ────────────────────────────
|
|
219
|
+
if [ "$TOOL_NAME" = "Edit" ] || [ "$TOOL_NAME" = "Write" ]; then
|
|
220
|
+
ID=$(file_id "$FILE_PATH")
|
|
221
|
+
[ -f "$CACHE/${ID}.bak" ] || exit 0
|
|
222
|
+
ls "$CACHE/${ID}".block.* >/dev/null 2>&1 || exit 0
|
|
223
|
+
|
|
224
|
+
# Expand placeholders, preserving any inline code the model added around them
|
|
225
|
+
EXPANDED="$CACHE/${ID}.$$.expanded"
|
|
226
|
+
rm -f "$EXPANDED"
|
|
227
|
+
while IFS= read -r line || [ -n "$line" ]; do
|
|
228
|
+
case "$line" in *BLOCK_*)
|
|
229
|
+
# Expand all placeholders on this line (supports multiple per line)
|
|
230
|
+
for bf in "$CACHE/${ID}".block.*; do
|
|
231
|
+
[ -f "$bf" ] || continue
|
|
232
|
+
h="${bf##*.}"
|
|
233
|
+
case "$line" in *"BLOCK_${h}"*)
|
|
234
|
+
# Reconstruct the exact placeholder pattern
|
|
235
|
+
bp=""; bs=""; br=""
|
|
236
|
+
[ -f "$CACHE/${ID}.prefix.${h}" ] && bp=$(cat "$CACHE/${ID}.prefix.${h}")
|
|
237
|
+
[ -f "$CACHE/${ID}.suffix.${h}" ] && bs=$(cat "$CACHE/${ID}.suffix.${h}")
|
|
238
|
+
[ -f "$CACHE/${ID}.reason.${h}" ] && br=$(cat "$CACHE/${ID}.reason.${h}")
|
|
239
|
+
if [ -n "$br" ]; then
|
|
240
|
+
placeholder="${bp}BLOCK_${h}: ${br}${bs}"
|
|
241
|
+
else
|
|
242
|
+
placeholder="${bp}BLOCK_${h}${bs}"
|
|
243
|
+
fi
|
|
244
|
+
block_content=$(cat "$bf"; printf x); block_content="${block_content%x}"
|
|
245
|
+
# Escape glob metacharacters (* ? [ \) in the pattern
|
|
246
|
+
esc_placeholder=$(escape_glob "$placeholder")
|
|
247
|
+
# Bash native substitution (// = global replace): replace placeholder, keep surrounding code
|
|
248
|
+
line="${line//$esc_placeholder/$block_content}"
|
|
249
|
+
# Fallback: if model altered the reason text, try without reason
|
|
250
|
+
# (only trigger if BLOCK_hash is still present AND wasn't in the original block content)
|
|
251
|
+
case "$block_content" in *"BLOCK_${h}"*) ;; *)
|
|
252
|
+
case "$line" in *"BLOCK_${h}"*)
|
|
253
|
+
printf 'Warning: placeholder BLOCK_%s was modified by model, using fuzzy match\n' "$h" >&2
|
|
254
|
+
esc_fuzzy=$(escape_glob "${bp}BLOCK_${h}${bs}")
|
|
255
|
+
line="${line//$esc_fuzzy/$block_content}"
|
|
256
|
+
# Last resort: match just the hash token
|
|
257
|
+
case "$line" in *"BLOCK_${h}"*)
|
|
258
|
+
line="${line//BLOCK_${h}/$block_content}"
|
|
259
|
+
;; esac
|
|
260
|
+
;; esac
|
|
261
|
+
;; esac
|
|
262
|
+
;; esac
|
|
263
|
+
done
|
|
264
|
+
;; esac
|
|
265
|
+
printf '%s\n' "$line" >> "$EXPANDED"
|
|
266
|
+
done < "$FILE_PATH"
|
|
267
|
+
# Preserve trailing newline status
|
|
268
|
+
if [ -s "$EXPANDED" ] && [ -s "$FILE_PATH" ] && [ -n "$(tail -c 1 "$FILE_PATH")" ]; then
|
|
269
|
+
perl -pe 'chomp if eof' "$EXPANDED" > "${EXPANDED}.nnl" && \
|
|
270
|
+
cat "${EXPANDED}.nnl" > "$EXPANDED" && rm -f "${EXPANDED}.nnl"
|
|
271
|
+
fi
|
|
272
|
+
# Warn if model deleted a protected block entirely
|
|
273
|
+
for bf in "$CACHE/${ID}".block.*; do
|
|
274
|
+
[ -f "$bf" ] || continue
|
|
275
|
+
bh="${bf##*.}"
|
|
276
|
+
# After expansion, blocks appear as original code (simplify-ignore-start).
|
|
277
|
+
# If neither the expanded code nor the placeholder is in EXPANDED, it was deleted.
|
|
278
|
+
if ! grep -qF "BLOCK_${bh}" "$EXPANDED" 2>/dev/null; then
|
|
279
|
+
# Get first line of block to check if it was expanded back
|
|
280
|
+
first_line=$(head -1 "$bf")
|
|
281
|
+
if ! grep -qF "$first_line" "$EXPANDED" 2>/dev/null; then
|
|
282
|
+
printf 'Warning: protected block BLOCK_%s was deleted by model\n' "$bh" >&2
|
|
283
|
+
fi
|
|
284
|
+
fi
|
|
285
|
+
done
|
|
286
|
+
# Preserve inode and permissions
|
|
287
|
+
cat "$EXPANDED" > "$FILE_PATH"
|
|
288
|
+
rm -f "$EXPANDED"
|
|
289
|
+
|
|
290
|
+
# Save expanded version as new backup (this is the "real" file with model's changes)
|
|
291
|
+
cp "$FILE_PATH" "$CACHE/${ID}.bak"
|
|
292
|
+
|
|
293
|
+
# Re-filter in-place so the file on disk stays with placeholders
|
|
294
|
+
FILTERED="$CACHE/${ID}.$$.tmp"
|
|
295
|
+
rm -f "$FILTERED"
|
|
296
|
+
if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
|
|
297
|
+
cat "$FILTERED" > "$FILE_PATH"
|
|
298
|
+
rm -f "$FILTERED"
|
|
299
|
+
fi
|
|
300
|
+
|
|
301
|
+
exit 0
|
|
302
|
+
fi
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
# Justfile — pi extension harnesses
|
|
2
|
+
#
|
|
3
|
+
# Recipes to launch pi with the harness extensions under .pi/harnesses/.
|
|
4
|
+
# Ported and adapted from disler/pi-vs-claude-code (MIT) — https://github.com/disler/pi-vs-claude-code
|
|
5
|
+
# See docs/pi-extensions.md for the full catalog and the selective-load model.
|
|
6
|
+
#
|
|
7
|
+
# Why .pi/harnesses/ and not .pi/extensions/: pi auto-discovers EVERY directory
|
|
8
|
+
# under .pi/extensions/, so anything placed there loads on every plain `pi` run.
|
|
9
|
+
# Most harnesses are mutually exclusive — they live in .pi/harnesses/ (which pi
|
|
10
|
+
# does NOT auto-discover) and are loaded via `pi -e` below. The supported stack
|
|
11
|
+
# is a damage-control variant before agent-hub (damage-control-continue for the main
|
|
12
|
+
# session), so the hub recipes run with guardrails by default.
|
|
13
|
+
#
|
|
14
|
+
# Everything between the two `agent-fleet:harnesses` sentinels below is a
|
|
15
|
+
# MANAGED REGION: guided-workspace-setup regenerates it from the installed
|
|
16
|
+
# package whenever pi harnesses are installed, refreshed, or retired — so edits
|
|
17
|
+
# inside it are overwritten on upgrade. Put your own recipes OUTSIDE the
|
|
18
|
+
# sentinels (above the opening marker or below the closing one) to keep them.
|
|
19
|
+
|
|
20
|
+
# >>> agent-fleet:harnesses — managed region (regenerated on upgrade; edits inside are overwritten) >>>
|
|
21
|
+
set dotenv-load := true
|
|
22
|
+
|
|
23
|
+
# List all recipes
|
|
24
|
+
default:
|
|
25
|
+
@just --list
|
|
26
|
+
|
|
27
|
+
# ---------------------------------------------------------------- setup
|
|
28
|
+
|
|
29
|
+
# Install the shared runtime dependencies for the pi extensions + harnesses
|
|
30
|
+
install:
|
|
31
|
+
npm install --prefix .pi/extensions
|
|
32
|
+
npm install --prefix .pi/harnesses
|
|
33
|
+
|
|
34
|
+
# Default pi — only the always-on utilities auto-load, no harness
|
|
35
|
+
pi:
|
|
36
|
+
pi
|
|
37
|
+
|
|
38
|
+
# ---------------------------------------------------------------- safety
|
|
39
|
+
|
|
40
|
+
# Damage-control: block destructive tool calls (aborts the turn)
|
|
41
|
+
ext-damage-control:
|
|
42
|
+
pi -e .pi/harnesses/damage-control/index.ts
|
|
43
|
+
|
|
44
|
+
# Damage-control (continue): same rules, but blocks deliver feedback so the agent adapts
|
|
45
|
+
# and keeps working instead of aborting the turn. Default guardrail for the hub main agent.
|
|
46
|
+
ext-damage-control-continue:
|
|
47
|
+
pi -e .pi/harnesses/damage-control-continue/index.ts
|
|
48
|
+
|
|
49
|
+
# ---------------------------------------------------------------- orchestration
|
|
50
|
+
|
|
51
|
+
# Accepts coms identity flags: --name --purpose --project --color --explicit.
|
|
52
|
+
# Loads the orchestrator persona by default (the Verification-Contract dispatcher that owns
|
|
53
|
+
# the acceptance assertions — see skills/orchestration-verification); it is appended only if
|
|
54
|
+
# agents/orchestrator.md is installed, so the hub still launches when it is absent. Override
|
|
55
|
+
# with your own --system-prompt <persona>.md passed after `just hub`.
|
|
56
|
+
# Guarded agent hub: damage-control-continue + remote-capable ask_user + dispatcher grid + research helpers + embedded coms + orchestrator.
|
|
57
|
+
# The main session loads the CONTINUE guardrail (blocks feed back so the dispatcher adapts and keeps going);
|
|
58
|
+
# spawned specialists still inherit the hard-stop damage-control variant (research helpers inherit continue).
|
|
59
|
+
hub *args:
|
|
60
|
+
persona=""; if [ -f agents/orchestrator.md ]; then persona="--append-system-prompt agents/orchestrator.md"; fi; pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts $persona {{args}}
|
|
61
|
+
|
|
62
|
+
# Agent hub (solo): guarded hub without the coms layer — fixed specialists + research only.
|
|
63
|
+
# Same orchestrator-persona default, remote-capable ask_user, and continue-guardrail main session as `just hub`.
|
|
64
|
+
hub-solo *args:
|
|
65
|
+
persona=""; if [ -f agents/orchestrator.md ]; then persona="--append-system-prompt agents/orchestrator.md"; fi; pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts --solo $persona {{args}}
|
|
66
|
+
|
|
67
|
+
# Internal helper for team-up: launch a reusable coms peer (coms + compact-and-continue + a persona).
|
|
68
|
+
# Prints a colored identity banner (peer name + persona purpose) before pi starts,
|
|
69
|
+
# so every pane announces who lives in it — works in any terminal, herdr or not.
|
|
70
|
+
# Hidden from `just --list` because recipes prefixed with `_` are private.
|
|
71
|
+
_peer persona name="" model="" session="" project="default":
|
|
72
|
+
node --experimental-strip-types scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
|
|
73
|
+
|
|
74
|
+
# Like _peer, but also loads extra always-on extensions (comma-separated names under
|
|
75
|
+
# .pi/extensions/) into the peer process — e.g. a chrome-devtools-mcp browser-debug peer
|
|
76
|
+
# whose `chrome_devtools__*` tools a normal --no-extensions subagent could not get.
|
|
77
|
+
_peer-plus extensions persona name="" model="" session="" project="default":
|
|
78
|
+
node --experimental-strip-types scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; extra=""; old_ifs="$IFS"; IFS=','; for x in {{extensions}}; do x="$(echo "$x" | xargs)"; if [ -n "$x" ]; then extra="$extra -e .pi/extensions/$x/index.ts"; fi; done; IFS="$old_ifs"; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts $extra --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
|
|
79
|
+
|
|
80
|
+
# Internal helper for team-up: a `runner: claude-code` peer — interactive
|
|
81
|
+
# Claude Code plus its coms bridge (scripts/coms-claude-bridge.ts) in ONE pane.
|
|
82
|
+
# The bridge registers the pane as coms peer <name>; the trailing session
|
|
83
|
+
# positional maps to `claude --resume <id>` for team-resume.
|
|
84
|
+
_claude-peer name model="" session="" project="default":
|
|
85
|
+
node --experimental-strip-types scripts/coms-claude-bridge.ts --name {{name}} --project {{project}} & bridge_pid=$!; trap 'kill $bridge_pid 2>/dev/null' EXIT; claude {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--resume " + session } else { "" } }}
|
|
86
|
+
|
|
87
|
+
# Team up: spawn every peer of a team from .pi/agents/peers.yaml into a herdr
|
|
88
|
+
# workspace (one tiled pane per peer). Requires a running herdr server.
|
|
89
|
+
# Positional arg: team (defaults to "full"). e.g. just team-up full
|
|
90
|
+
team-up team="full" *args:
|
|
91
|
+
node --experimental-strip-types scripts/team-up.ts --team {{team}} {{args}}
|
|
92
|
+
|
|
93
|
+
# Team up (dry run): print the resolved layout + per-peer commands without touching herdr.
|
|
94
|
+
# e.g. just team-up-dry team="full"
|
|
95
|
+
team-up-dry team="full" *args:
|
|
96
|
+
node --experimental-strip-types scripts/team-up.ts --team {{team}} --dry-run {{args}}
|
|
97
|
+
|
|
98
|
+
# Hub + team in ONE herdr workspace: the guarded hub (`just hub`) in a larger
|
|
99
|
+
# main pane, the team's peers tiled beside it. e.g. just hub-team docs
|
|
100
|
+
hub-team team="full" *args:
|
|
101
|
+
node --experimental-strip-types scripts/team-up.ts --team {{team}} --hub {{args}}
|
|
102
|
+
|
|
103
|
+
# Hub + team (dry run): print the combined layout without touching herdr.
|
|
104
|
+
hub-team-dry team="full" *args:
|
|
105
|
+
node --experimental-strip-types scripts/team-up.ts --team {{team}} --hub --dry-run {{args}}
|
|
106
|
+
|
|
107
|
+
# Hermes conductor + team in ONE herdr workspace: Hermes dev profile in a conductor pane,
|
|
108
|
+
# the team's peers tiled beside it. Hermes delegates via coms-cli and never drives herdr.
|
|
109
|
+
conductor team="full" *args:
|
|
110
|
+
node --experimental-strip-types scripts/team-up.ts --team {{team}} --conductor {{args}}
|
|
111
|
+
|
|
112
|
+
# Hermes conductor + team (dry run): print the combined layout without touching herdr.
|
|
113
|
+
conductor-dry team="full" *args:
|
|
114
|
+
node --experimental-strip-types scripts/team-up.ts --team {{team}} --conductor --dry-run {{args}}
|
|
115
|
+
|
|
116
|
+
# Snapshot a RUNNING team's session refs to ~/.pi/team-snapshots/<team>.json
|
|
117
|
+
# (team keeps running — take one proactively so a crash is resumable).
|
|
118
|
+
team-snapshot team="full" *args:
|
|
119
|
+
node --experimental-strip-types scripts/team-snapshot.ts snapshot {{team}} {{args}}
|
|
120
|
+
|
|
121
|
+
# Snapshot, then close the team workspace cleanly (peers get SIGTERM).
|
|
122
|
+
team-down team="full" *args:
|
|
123
|
+
node --experimental-strip-types scripts/team-snapshot.ts down {{team}} {{args}}
|
|
124
|
+
|
|
125
|
+
# Rebuild a team from its snapshot — each pi peer resumes its previous
|
|
126
|
+
# conversation (`pi --session <ref>`); peers whose ref is gone start fresh.
|
|
127
|
+
team-resume team="full" *args:
|
|
128
|
+
node --experimental-strip-types scripts/team-snapshot.ts resume {{team}} {{args}}
|
|
129
|
+
|
|
130
|
+
# ---------------------------------------------------------------- coms (Pi-to-Pi messaging)
|
|
131
|
+
|
|
132
|
+
# Safe coms: a FULL pi (all auto-discovered local .pi/extensions/ + global extensions and
|
|
133
|
+
# commands) plus damage-control-continue guardrails and the coms peer layer, under a chosen name.
|
|
134
|
+
# Unlike `just hub`, this does NOT pass --no-extensions, so every local-only extension (MCP
|
|
135
|
+
# bridges like chrome-devtools-mcp, project-specific extensions, …) loads into THIS process.
|
|
136
|
+
# Use it as the agent-hub dispatcher/orchestrator peer that needs those local tools: spawned
|
|
137
|
+
# specialists run --no-extensions, so the tools stay scoped here and never leak into subagents.
|
|
138
|
+
# The required `name` becomes this peer's coms identity (--name), so it is discoverable
|
|
139
|
+
# under exactly that name to other coms peers in the project pool.
|
|
140
|
+
# e.g. just safe-coms orchestrator --project proj
|
|
141
|
+
safe-coms name *args:
|
|
142
|
+
pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/coms/index.ts --name {{name}} {{args}}
|
|
143
|
+
# <<< agent-fleet:harnesses <<<
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
# Accessibility Checklist
|
|
2
|
+
|
|
3
|
+
Quick reference for WCAG 2.1 AA compliance. Use alongside the `frontend-ui-engineering` skill.
|
|
4
|
+
|
|
5
|
+
## Table of Contents
|
|
6
|
+
|
|
7
|
+
- [Essential Checks](#essential-checks)
|
|
8
|
+
- [Common HTML Patterns](#common-html-patterns)
|
|
9
|
+
- [Testing Tools](#testing-tools)
|
|
10
|
+
- [Quick Reference: ARIA Live Regions](#quick-reference-aria-live-regions)
|
|
11
|
+
- [Common Anti-Patterns](#common-anti-patterns)
|
|
12
|
+
|
|
13
|
+
## Essential Checks
|
|
14
|
+
|
|
15
|
+
### Keyboard Navigation
|
|
16
|
+
- [ ] All interactive elements focusable via Tab key
|
|
17
|
+
- [ ] Focus order follows visual/logical order
|
|
18
|
+
- [ ] Focus is visible (outline/ring on focused elements)
|
|
19
|
+
- [ ] Custom widgets have keyboard support (Enter to activate, Escape to close)
|
|
20
|
+
- [ ] No keyboard traps (user can always Tab away from a component)
|
|
21
|
+
- [ ] Skip-to-content link at top of page - visible (at least) on keyboard focus
|
|
22
|
+
- [ ] Modals trap focus while open, return focus on close
|
|
23
|
+
|
|
24
|
+
### Screen Readers
|
|
25
|
+
- [ ] All images have `alt` text (or `alt=""` for decorative images)
|
|
26
|
+
- [ ] All form inputs have associated labels (`<label>` or `aria-label`)
|
|
27
|
+
- [ ] Buttons and links have descriptive text (not "Click here")
|
|
28
|
+
- [ ] Icon-only buttons have `aria-label`
|
|
29
|
+
- [ ] Page has one `<h1>` and headings don't skip levels
|
|
30
|
+
- [ ] Dynamic content changes announced (`aria-live` regions)
|
|
31
|
+
- [ ] Tables have `<th>` headers with scope
|
|
32
|
+
|
|
33
|
+
### Visual
|
|
34
|
+
- [ ] Text contrast ≥ 4.5:1 (normal text) or ≥ 3:1 (large text, 18px+)
|
|
35
|
+
- [ ] UI components contrast ≥ 3:1 against background
|
|
36
|
+
- [ ] Color is not the only way to convey information
|
|
37
|
+
- [ ] Text resizable to 200% without breaking layout
|
|
38
|
+
- [ ] No content that flashes more than 3 times per second
|
|
39
|
+
|
|
40
|
+
### Forms
|
|
41
|
+
- [ ] Every input has a visible label
|
|
42
|
+
- [ ] Required fields indicated (not by color alone)
|
|
43
|
+
- [ ] Error messages specific and associated with the field
|
|
44
|
+
- [ ] Error state visible by more than color (icon, text, border)
|
|
45
|
+
- [ ] Form submission errors summarized and focusable
|
|
46
|
+
- [ ] Known fields use autocomplete (for example `type="email" autocomplete="email"`)
|
|
47
|
+
|
|
48
|
+
### Content
|
|
49
|
+
- [ ] Language declared (`<html lang="en">`)
|
|
50
|
+
- [ ] Page has a descriptive `<title>`
|
|
51
|
+
- [ ] Links distinguish from surrounding text (not by color alone)
|
|
52
|
+
- [ ] Touch targets ≥ 44x44px on mobile
|
|
53
|
+
- [ ] Meaningful empty states (not blank screens)
|
|
54
|
+
|
|
55
|
+
## Common HTML Patterns
|
|
56
|
+
|
|
57
|
+
### Buttons vs. Links
|
|
58
|
+
|
|
59
|
+
```html
|
|
60
|
+
<!-- Use <button> for actions -->
|
|
61
|
+
<button onClick={handleDelete}>Delete Task</button>
|
|
62
|
+
|
|
63
|
+
<!-- Use <a> for navigation -->
|
|
64
|
+
<a href="/tasks/123">View Task</a>
|
|
65
|
+
|
|
66
|
+
<!-- NEVER use div/span as buttons -->
|
|
67
|
+
<div onClick={handleDelete}>Delete</div> <!-- BAD -->
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### Form Labels
|
|
71
|
+
|
|
72
|
+
```html
|
|
73
|
+
<!-- Explicit label association -->
|
|
74
|
+
<label htmlFor="email">Email address</label>
|
|
75
|
+
<input id="email" type="email" required />
|
|
76
|
+
|
|
77
|
+
<!-- Implicit wrapping -->
|
|
78
|
+
<label>
|
|
79
|
+
Email address
|
|
80
|
+
<input type="email" required />
|
|
81
|
+
</label>
|
|
82
|
+
|
|
83
|
+
<!-- Hidden label (visible label preferred) -->
|
|
84
|
+
<input type="search" aria-label="Search tasks" />
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### ARIA Roles
|
|
88
|
+
|
|
89
|
+
```html
|
|
90
|
+
<!-- Navigation -->
|
|
91
|
+
<nav aria-label="Main navigation">...</nav>
|
|
92
|
+
<nav aria-label="Footer links">...</nav>
|
|
93
|
+
|
|
94
|
+
<!-- Status messages -->
|
|
95
|
+
<div role="status" aria-live="polite">Task saved</div>
|
|
96
|
+
|
|
97
|
+
<!-- Alert messages -->
|
|
98
|
+
<div role="alert">Error: Title is required</div>
|
|
99
|
+
|
|
100
|
+
<!-- Modal dialogs -->
|
|
101
|
+
<dialog aria-modal="true" aria-labelledby="dialog-title">
|
|
102
|
+
<h2 id="dialog-title">Confirm Delete</h2>
|
|
103
|
+
...
|
|
104
|
+
</dialog>
|
|
105
|
+
|
|
106
|
+
<!-- Loading states -->
|
|
107
|
+
<div aria-busy="true" aria-label="Loading tasks">
|
|
108
|
+
<Spinner />
|
|
109
|
+
</div>
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Accessible Lists
|
|
113
|
+
|
|
114
|
+
```html
|
|
115
|
+
<ul role="list" aria-label="Tasks">
|
|
116
|
+
<li>
|
|
117
|
+
<input type="checkbox" id="task-1" aria-label="Complete: Buy groceries" />
|
|
118
|
+
<label htmlFor="task-1">Buy groceries</label>
|
|
119
|
+
</li>
|
|
120
|
+
</ul>
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
## Testing Tools
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
# Automated audit
|
|
127
|
+
npx axe-core # Programmatic accessibility testing
|
|
128
|
+
npx pa11y # CLI accessibility checker
|
|
129
|
+
|
|
130
|
+
# In browser
|
|
131
|
+
# Chrome DevTools → Lighthouse → Accessibility
|
|
132
|
+
# Chrome DevTools → Elements → Accessibility tree
|
|
133
|
+
|
|
134
|
+
# Screen reader testing
|
|
135
|
+
# macOS: VoiceOver (Cmd + F5)
|
|
136
|
+
# Windows: NVDA (free) or JAWS
|
|
137
|
+
# Linux: Orca
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
## Quick Reference: ARIA Live Regions
|
|
141
|
+
|
|
142
|
+
| Value | Behavior | Use For |
|
|
143
|
+
|-------|----------|---------|
|
|
144
|
+
| `aria-live="polite"` | Announced at next pause | Status updates, saved confirmations |
|
|
145
|
+
| `aria-live="assertive"` | Announced immediately | Errors, time-sensitive alerts |
|
|
146
|
+
| `role="status"` | Same as `polite` | Status messages |
|
|
147
|
+
| `role="alert"` | Same as `assertive` | Error messages |
|
|
148
|
+
|
|
149
|
+
## Common Anti-Patterns
|
|
150
|
+
|
|
151
|
+
| Anti-Pattern | Problem | Fix |
|
|
152
|
+
|---|---|---|
|
|
153
|
+
| `div` as button | Not focusable, no keyboard support | Use `<button>` |
|
|
154
|
+
| Missing `alt` text | Images invisible to screen readers | Add descriptive `alt` |
|
|
155
|
+
| Color-only states | Invisible to color-blind users | Add icons, text, or patterns |
|
|
156
|
+
| Autoplaying media | Disorienting, can't be stopped | Add controls, don't autoplay |
|
|
157
|
+
| Custom dropdown with no ARIA | Unusable by keyboard/screen reader | Use native `<select>` or proper ARIA listbox |
|
|
158
|
+
| Removing focus outlines | Users can't see where they are | Style outlines, don't remove them |
|
|
159
|
+
| Empty links/buttons | "Link" announced with no description | Add text or `aria-label` |
|
|
160
|
+
| `tabindex > 0` | Breaks natural tab order | Use `tabindex="0"` or `-1` only |
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Definition of Done
|
|
2
|
+
|
|
3
|
+
A standing, project-wide bar that every change must clear before it counts as done. Unlike acceptance criteria, which vary per task and answer "did we build the right thing?", the Definition of Done is the same every time and answers "is this finished to our standard?". Use it as the final gate in `planning-and-task-breakdown`, `incremental-implementation`, and `shipping-and-launch`.
|
|
4
|
+
|
|
5
|
+
## Definition of Done vs. Acceptance Criteria
|
|
6
|
+
|
|
7
|
+
| | Acceptance Criteria | Definition of Done |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| Scope | Specific to one task or spec | Applies to every increment |
|
|
10
|
+
| Changes | Different for each item | Fixed and reused |
|
|
11
|
+
| Answers | "Did we build *this thing*?" | "Is it *ready*?" |
|
|
12
|
+
| Owner | Defined when planning the task | Defined once for the project |
|
|
13
|
+
| Example | "User can reset password via email link" | "Tests pass, no regressions, docs updated" |
|
|
14
|
+
|
|
15
|
+
The two are complementary. A task is done only when **its** acceptance criteria are met **and** the standing Definition of Done is satisfied. Skipping either leaves work that looks finished but is not.
|
|
16
|
+
|
|
17
|
+
## The Standing Checklist
|
|
18
|
+
|
|
19
|
+
Apply this to every change before declaring it done.
|
|
20
|
+
|
|
21
|
+
### Correctness
|
|
22
|
+
- [ ] All acceptance criteria for the task are met
|
|
23
|
+
- [ ] Code runs and behaves as intended, verified at runtime, not just compiled or typechecked
|
|
24
|
+
- [ ] New behavior is covered by tests that fail without the change and pass with it
|
|
25
|
+
- [ ] Existing tests still pass; no regressions introduced
|
|
26
|
+
- [ ] Edge cases and error paths are handled, not just the happy path
|
|
27
|
+
|
|
28
|
+
### Quality
|
|
29
|
+
- [ ] Code reveals intent through naming and structure; no comments needed to explain *what* it does
|
|
30
|
+
- [ ] No duplicated business logic
|
|
31
|
+
- [ ] No dead code, debug output, or commented-out blocks left behind
|
|
32
|
+
- [ ] Changes are scoped to the task; no unrelated refactors snuck in
|
|
33
|
+
- [ ] Linting and formatting pass
|
|
34
|
+
|
|
35
|
+
The depth behind these items lives in `code-review-and-quality` (the five-axis review) and `code-simplification` (reducing complexity without changing behavior).
|
|
36
|
+
|
|
37
|
+
### Integration
|
|
38
|
+
- [ ] Change works with the rest of the system, not just in isolation
|
|
39
|
+
- [ ] Database migrations, config changes, and feature flags are accounted for
|
|
40
|
+
- [ ] Backward compatibility considered for any public interface or API change
|
|
41
|
+
|
|
42
|
+
### Documentation
|
|
43
|
+
- [ ] Public interfaces, APIs, and user-facing behavior are documented
|
|
44
|
+
- [ ] Architectural decisions worth preserving are recorded (see `documentation-and-adrs`)
|
|
45
|
+
- [ ] Documentation describes the current state in timeless language, not the change history
|
|
46
|
+
|
|
47
|
+
### Ship-readiness
|
|
48
|
+
- [ ] Security implications reviewed for any untrusted input, auth, or data handling (see `security-and-hardening`)
|
|
49
|
+
- [ ] Observability in place for new critical paths (logs, metrics, traces) (see `observability-and-instrumentation`)
|
|
50
|
+
- [ ] Rollback path exists for anything risky (see `shipping-and-launch`)
|
|
51
|
+
- [ ] The human has reviewed and approved before merge or deploy
|
|
52
|
+
|
|
53
|
+
## How to Apply
|
|
54
|
+
|
|
55
|
+
- **Per task**: confirm the Correctness and Quality sections before checking the task off.
|
|
56
|
+
- **Per feature**: confirm Integration and Documentation before considering the feature complete.
|
|
57
|
+
- **Per release**: the full checklist is the floor; `shipping-and-launch` adds the deploy-specific gates on top.
|
|
58
|
+
|
|
59
|
+
Tailor the list to the project once, then reuse it unchanged. A Definition of Done that is renegotiated every sprint is not a Definition of Done.
|
|
60
|
+
|
|
61
|
+
## Red Flags
|
|
62
|
+
|
|
63
|
+
- "It's done, I just haven't run it yet": unverified work is not done.
|
|
64
|
+
- "Tests pass" used as a synonym for done while docs, regressions, or runtime verification are skipped.
|
|
65
|
+
- A different bar applied depending on deadline pressure.
|
|
66
|
+
- Acceptance criteria treated as the whole bar, with no standing quality floor.
|
|
67
|
+
- "Done" declared before human review on changes that need it.
|