@cbartens/bkit 5.2.3 → 5.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +29 -12
- package/.bkit/core/.agents/context.md +1 -1
- package/.bkit/core/.agents/docs.md +1 -1
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +1 -1
- package/.bkit/core/.agents/rules.md +11 -0
- package/.bkit/core/.bkit/README.md +28 -11
- package/.bkit/core/.bkit/cloud.md +9 -8
- package/.bkit/core/.bkit/comparison.md +68 -345
- package/.bkit/core/.bkit/install.md +15 -9
- package/.bkit/core/.bkit/lite.md +73 -0
- package/.bkit/core/.bkit/pipeline.md +345 -0
- package/.bkit/core/.bkit/prompts.md +88 -73
- package/.bkit/core/.bkit/providers.md +41 -22
- package/.bkit/core/.bkit/templates.md +125 -18
- package/.bkit/core/.bkit/trackers.md +47 -1
- package/.bkit/core/.bkit/workflows.md +51 -45
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +1 -1
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +7 -4
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +8 -5
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +10 -2
- package/.bkit/core/docs/templates/bkit-audit-agents.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +10 -2
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-config.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-cost.md +10 -2
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-database.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +22 -10
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-failures.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +10 -2
- package/.bkit/core/docs/templates/bkit-audit-gates.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-issues.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-llm.md +29 -15
- package/.bkit/core/docs/templates/bkit-audit-logs.md +10 -2
- package/.bkit/core/docs/templates/bkit-audit-models.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +11 -3
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +19 -9
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-repo.md +10 -2
- package/.bkit/core/docs/templates/bkit-audit-security.md +13 -5
- package/.bkit/core/docs/templates/bkit-audit-slop.md +9 -1
- package/.bkit/core/docs/templates/bkit-audit-testing.md +14 -5
- package/.bkit/core/docs/templates/bkit-audit-usability.md +9 -1
- package/.bkit/core/docs/templates/bkit-plan.md +8 -6
- package/.bkit/core/engine/checks/after/auth.ts +9 -9
- package/.bkit/core/engine/checks/after/ci-yml.ts +14 -12
- package/.bkit/core/engine/checks/after/github.ts +29 -120
- package/.bkit/core/engine/checks/after/index.ts +2 -2
- package/.bkit/core/engine/checks/after/managed.ts +8 -28
- package/.bkit/core/engine/checks/after/tools.ts +3 -15
- package/.bkit/core/engine/checks/before/context-fetch.ts +1 -21
- package/.bkit/core/engine/checks/before/index.ts +7 -43
- package/.bkit/core/engine/checks/before/mcp.ts +17 -8
- package/.bkit/core/engine/checks/before/repo.ts +9 -12
- package/.bkit/core/engine/checks/status-holes.ts +4 -5
- package/.bkit/core/engine/checks/tips/catalogue.ts +70 -24
- package/.bkit/core/engine/checks/tips/detect.ts +45 -2
- package/.bkit/core/engine/checks/tips/index.ts +37 -8
- package/.bkit/core/engine/cli.ts +39 -16
- package/.bkit/core/engine/commands/analysis.ts +36 -26
- package/.bkit/core/engine/commands/comply.ts +17 -16
- package/.bkit/core/engine/commands/harvest.ts +12 -12
- package/.bkit/core/engine/commands/install/doctor.ts +57 -28
- package/.bkit/core/engine/commands/install/install.ts +62 -126
- package/.bkit/core/engine/commands/install/uninstall.ts +191 -33
- package/.bkit/core/engine/commands/install/upgrade.ts +58 -53
- package/.bkit/core/engine/commands/lib.ts +35 -10
- package/.bkit/core/engine/commands/tips.ts +8 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +65 -11
- package/.bkit/core/engine/commands/workflow/counters.ts +21 -12
- package/.bkit/core/engine/commands/workflow/fids.ts +46 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +3 -1
- package/.bkit/core/engine/commands/workflow/prs.ts +4 -2
- package/.bkit/core/engine/commands/workflow/repo.ts +18 -4
- package/.bkit/core/engine/commands/workflow/roadmap.ts +4 -3
- package/.bkit/core/engine/commands/workflow/runs.ts +8 -7
- package/.bkit/core/engine/commands/workflow/steps.ts +1 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +17 -5
- package/.bkit/core/engine/commands/workflow/workflows.ts +19 -17
- package/.bkit/core/engine/commands/workflow/workstreams.ts +2 -1
- package/.bkit/core/engine/commands/workflow/worktrees.ts +13 -5
- package/.bkit/core/engine/install/cloud-env.ts +10 -31
- package/.bkit/core/engine/install/manifest.ts +14 -7
- package/.bkit/core/engine/install/modules/antigravity.ts +15 -26
- package/.bkit/core/engine/install/modules/claude.ts +20 -28
- package/.bkit/core/engine/install/modules/cloud.ts +5 -2
- package/.bkit/core/engine/install/modules/codex.ts +15 -29
- package/.bkit/core/engine/install/modules/core.ts +91 -70
- package/.bkit/core/engine/install/modules/cursor.ts +6 -20
- package/.bkit/core/engine/install/modules/index.ts +7 -1
- package/.bkit/core/engine/install/modules/opencode.ts +48 -70
- package/.bkit/core/engine/install/network-allowlist.ts +73 -0
- package/.bkit/core/engine/install/placeholders.ts +3 -18
- package/.bkit/core/engine/install/write.ts +59 -12
- package/.bkit/core/engine/ledgers/telemetry.ts +6 -4
- package/.bkit/core/engine/render/hosts.ts +47 -67
- package/.bkit/core/engine/render/models.ts +29 -11
- package/.bkit/core/engine/shared/bkit-latest.ts +164 -0
- package/.bkit/core/engine/shared/branches.ts +13 -0
- package/.bkit/core/engine/shared/egress.ts +3 -3
- package/.bkit/core/engine/shared/json.ts +18 -1
- package/.bkit/core/engine/shared/package-json.ts +63 -0
- package/.bkit/core/engine/shared/package-roots.ts +0 -10
- package/.bkit/core/engine/shared/protected-paths.ts +5 -130
- package/.bkit/core/engine/shared/settings.ts +36 -0
- package/.bkit/core/engine/shared/timeouts.ts +6 -0
- package/.bkit/core/hooks/antigravity-hook.js +1 -0
- package/.bkit/core/hooks/guardrails-shell.js +186 -40
- package/.bkit/core/hooks/guardrails-tiers.js +5 -78
- package/.bkit/core/prompts/bkit-audit-generate.md +65 -10
- package/.bkit/core/prompts/bkit-build-challenge-1.md +1 -1
- package/.bkit/core/prompts/bkit-build-challenge-2.md +1 -1
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +1 -1
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +1 -1
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +1 -1
- package/.bkit/core/prompts/bkit-build-install-skills.md +1 -1
- package/.bkit/core/prompts/bkit-build-plan-current.md +1 -1
- package/.bkit/core/prompts/bkit-build-plan-execute.md +4 -4
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +1 -1
- package/.bkit/core/prompts/bkit-build-plan-verify.md +2 -2
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +1 -1
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +1 -1
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +1 -1
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +78 -0
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +1 -1
- package/.bkit/core/prompts/bkit-debug-summary.md +3 -3
- package/.bkit/core/prompts/bkit-design-spike.md +1 -1
- package/.bkit/core/prompts/bkit-design-summary.md +2 -2
- package/.bkit/core/prompts/bkit-design-update.md +1 -1
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +1 -1
- package/.bkit/core/prompts/bkit-plan-generate.md +1 -1
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +1 -1
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +1 -1
- package/.bkit/core/prompts/bkit-plan-summary.md +1 -1
- package/.bkit/core/prompts/bkit-plan-update.md +1 -1
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +1 -1
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +1 -1
- package/.bkit/core/prompts/bkit-ship-update-docs.md +1 -1
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +9 -2
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +9 -2
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +2 -1
- package/.bkit/core/prompts/bkit-utility-update-failures.md +9 -2
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +9 -2
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +11 -4
- package/.bkit/core/workflows/bkit-build.md +4 -4
- package/.bkit/core/workflows/bkit-debug.md +70 -34
- package/.bkit/core/workflows/bkit-design.md +3 -3
- package/.bkit/core/workflows/bkit-plan.md +12 -5
- package/.bkit/core/workflows/bkit-ship.md +6 -6
- package/.bkit/shared/.claude/bkit-cloud.md +46 -13
- package/.bkit/shared/.claude/settings.json +18 -0
- package/.bkit/shared/.cursor/mcp.json +2 -1
- package/.bkit/shared/.opencode/opencode.json +19 -1
- package/.bkit/shared/docs/deployments.md +20 -4
- package/.bkit/shared/docs/security.md +8 -6
- package/.bkit/shared/docs/testing.md +9 -5
- package/.bkit/templates/.cursor/Dockerfile +30 -16
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +78 -0
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +91 -0
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +56 -0
- package/.bkit/templates/.github/renovate.json5 +91 -12
- package/.bkit/templates/.github/workflows/bkit-ci.yml +66 -53
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +3 -1
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +8 -1
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +67 -0
- package/.bkit/templates/.husky/pre-push +15 -3
- package/.bkit/templates/.oxlintrc.json +21 -0
- package/.bkit/templates/docs/capabilities.md +1 -1
- package/.bkit/templates/scripts/ci/check-capstone.mjs +176 -0
- package/.bkit/templates/scripts/ci/check-capstone.test.mjs +311 -0
- package/.bkit/templates/scripts/cleanup/bkit-tmp-prune.mjs +115 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +43 -20
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +33 -11
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -2
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +5 -5
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +79 -19
- package/CHANGELOG.md +67 -3
- package/README.md +258 -129
- package/dist/checks/after/auth.js +10 -11
- package/dist/checks/after/ci-yml.js +11 -14
- package/dist/checks/after/github.js +32 -125
- package/dist/checks/after/index.js +3 -2
- package/dist/checks/after/managed.js +8 -24
- package/dist/checks/after/tools.js +3 -16
- package/dist/checks/before/context-fetch.js +1 -21
- package/dist/checks/before/index.js +6 -42
- package/dist/checks/before/mcp.js +14 -9
- package/dist/checks/before/repo.js +8 -11
- package/dist/checks/status-holes.js +5 -6
- package/dist/checks/tips/catalogue.js +60 -18
- package/dist/checks/tips/detect.js +41 -2
- package/dist/checks/tips/index.js +25 -5
- package/dist/cli.js +34 -14
- package/dist/commands/analysis.js +21 -5
- package/dist/commands/comply.js +20 -18
- package/dist/commands/harvest.js +12 -13
- package/dist/commands/install/doctor.js +55 -23
- package/dist/commands/install/install.js +62 -118
- package/dist/commands/install/uninstall.js +165 -31
- package/dist/commands/install/upgrade.js +55 -49
- package/dist/commands/lib.js +32 -10
- package/dist/commands/tips.js +6 -3
- package/dist/commands/workflow/branches.js +57 -13
- package/dist/commands/workflow/counters.js +17 -7
- package/dist/commands/workflow/fids.js +39 -0
- package/dist/commands/workflow/ledgers.js +3 -1
- package/dist/commands/workflow/prs.js +3 -3
- package/dist/commands/workflow/repo.js +16 -4
- package/dist/commands/workflow/roadmap.js +4 -4
- package/dist/commands/workflow/runs.js +5 -5
- package/dist/commands/workflow/steps.js +1 -0
- package/dist/commands/workflow/tests.js +16 -3
- package/dist/commands/workflow/workflows.js +19 -18
- package/dist/commands/workflow/workstreams.js +2 -1
- package/dist/commands/workflow/worktrees.js +4 -5
- package/dist/install/cloud-env.js +10 -23
- package/dist/install/manifest.js +14 -7
- package/dist/install/modules/antigravity.js +15 -26
- package/dist/install/modules/claude.js +17 -21
- package/dist/install/modules/cloud.js +6 -2
- package/dist/install/modules/codex.js +15 -29
- package/dist/install/modules/core.js +82 -63
- package/dist/install/modules/cursor.js +6 -9
- package/dist/install/modules/index.js +6 -1
- package/dist/install/modules/opencode.js +41 -72
- package/dist/install/network-allowlist.js +62 -0
- package/dist/install/placeholders.js +3 -16
- package/dist/install/write.js +55 -15
- package/dist/ledgers/telemetry.js +5 -4
- package/dist/render/hosts.js +30 -55
- package/dist/render/models.js +20 -9
- package/dist/shared/bkit-latest.js +150 -0
- package/dist/shared/branches.js +11 -0
- package/dist/shared/egress.js +0 -2
- package/dist/shared/json.js +14 -0
- package/dist/shared/package-json.js +61 -0
- package/dist/shared/package-roots.js +0 -8
- package/dist/shared/protected-paths.js +5 -122
- package/dist/shared/settings.js +18 -1
- package/dist/shared/timeouts.js +6 -0
- package/package.json +21 -17
- package/.bkit/core/.agents/shortcuts.md +0 -73
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
- **Banned shapes:** a parenthetical explaining why a clause exists, an inline comment justifying behaviour, a note on what a previous version did.
|
|
42
42
|
- **Cross-prompt alignment:** Check for shared instructions and change in all prompts using them. Rules binding every agent live once in `.agents/rules.md` § `Universal Rules` — reached via the `**Rules:**` EXECUTION PROTOCOL bullet, never copied per prompt.
|
|
43
43
|
- **Shared wording:** sentences shared by 5+ prompts live in `.bkit/wording.md`; change them there, move the old wording to the clause's `retired` block, run `pnpm wording:sync`. never hand-edit one copy.
|
|
44
|
-
- **Self-contained:** every prompt must stand alone; inline all instructions; no file references. Exceptions: `.agents/rules.md`, `.agents/docs.md`, `.
|
|
44
|
+
- **Self-contained:** every prompt must stand alone; inline all instructions; no file references. Exceptions: `.agents/rules.md`, `.agents/docs.md`, `.bkit/lite.md`, `*.jsonl` ledgers, supplied templates (plan, audit) — those carry their own rules.
|
|
45
45
|
- **Template owns its rules:** prompt filling or auditing a supplied template names the section + ONLY what template lacks (input handling, carry-forward, ledger writes, severity it assigns); never restate template rules. Agent that does not read the template → inline.
|
|
46
46
|
- **Removal = delete:** drop instruction outright; never leave removal explanations.
|
|
47
47
|
- **Enforced elsewhere:** step numbers by `.bkit/core/engine/audits/repo/shipped-docs-refs.test.ts`, the managed-version marker by `.bkit/core/engine/audits/workflows/prompt-notation.test.ts`, shared sentences, the `**Rules:**` bullet, and the `.agents/rules.md` group headings by `.bkit/core/engine/tools/wording.test.ts` — the GateGuard advisory omits them because a test is the gate.
|
|
@@ -124,7 +124,7 @@ Pinning `model:` locks agent model regardless of orchestrator session. Without p
|
|
|
124
124
|
| `model` | Explicit Claude model pin per the effort mapping table above. Locks the model independent of the orchestrator's session default — without it, subagents inherit user's Claude Code default and `xhigh` thinking depth + 1M context disappear if the user runs Sonnet. | Brittle by version (must update on every model rev), but explicit and discoverable. Never use family alias (`opus` / `sonnet`) — they don't lock context-window variant. |
|
|
125
125
|
| `tools` | Minimum capability sandbox. Enforced on Claude (native). Cursor: `bkit install` T3 transform passes the field through verbatim, but Cursor CLI 2026.10.01 does not enforce it (measured: a `tools: [Read]` subagent still has `Shell`, `Write`, `StrReplace`, and every MCP tool via `CallDynamicTool`). Removing `Edit`/`Bash` makes an agent provably non-mutating on Claude only. | Add `WebFetch`/`WebSearch` only for genuine ecosystem research (`bkit-design-review-1/2`) or to pin a probe against vendor docs before running it (`bkit-design-spike`). |
|
|
126
126
|
| `permissionMode: acceptEdits` | End-to-end runs of `/design`/`/plan`/`/build`/`/debug`/`/ship` would break if mid-workflow prompt blocked an agent. Bash auto-approve surface lives in `.claude/settings.json` (`workflows.md` § Permissions) | Never deviate inside the pipeline; one-off ad-hoc invocations may use stricter modes. |
|
|
127
|
-
| `maxTurns` | Pure runaway-loop safety cap, not a workload budget. 4 tiers (S=50 / M=100 / L=
|
|
127
|
+
| `maxTurns` | Pure runaway-loop safety cap, not a workload budget. 4 tiers (S=50 / M=100 / L=200 / XL=400). Hitting the cap means the agent is definitely stuck (tight retry loop, infinite re-read pattern, etc.), not "tight on a complex run." | Cap by **tier** (see § `maxTurns` calibration). Per-agent assignment in § Models. |
|
|
128
128
|
|
|
129
129
|
### Effort tiers
|
|
130
130
|
|
|
@@ -133,7 +133,7 @@ Pinning `model:` locks agent model regardless of orchestrator session. Without p
|
|
|
133
133
|
| --- | --- | --- |
|
|
134
134
|
| `low` | Pure synthesis with no verdict riding on it. | (none currently) |
|
|
135
135
|
| `medium` | Single-shot writers, scope audits, skill curators, fix executors with clear input. Some `medium`-effort agents pin opus (depth-sensitive lens) — see Models table footnote. | `bkit-debug-abort-handover`, `bkit-plan-complexity-check`, `bkit-plan-scope-check-1`, `bkit-plan-scope-check-2`, `bkit-plan-review-2`, `bkit-design-brainstorm-ideate-2`, `bkit-design-review-2`, `bkit-build-install-skills`, `bkit-utility-compress-markdown`, `bkit-utility-update-documentation` |
|
|
136
|
-
| `high` | Adversarial review, parallel-fan-out high-effort slots, observability instrumentation, feasibility research, ledger / roadmap judgement against the codebase. Also phase-verdict summaries (`*-summary`, haiku model) and source modifiers with test loops (sonnet model). | `*-summary`, `bkit-build-plan-execute`, `bkit-build-plan-gaps-remediate`, `bkit-build-challenge-remediate`, `bkit-build-challenge-tests`, `bkit-debug-failure-remediate`, `bkit-ship-conflict-resolve`, `bkit-build-plan-verify`, `bkit-build-plan-current`, `bkit-build-challenge-1`, `bkit-build-challenge-2`, `bkit-design-brainstorm-ideate-1`, `bkit-design-brainstorm-ideate-3`, `bkit-design-organise`, `bkit-design-review-1`, `bkit-design-spike`, `bkit-plan-review-1`, `bkit-plan-review-3`, `bkit-plan-complexity-split`, `bkit-ship-update-docs`, `bkit-ship-deferred-sweep`, `bkit-utility-update-deferrals`, `bkit-utility-update-failures`, `bkit-utility-update-decisions`, `bkit-utility-update-knowledge`, `bkit-utility-update-roadmap` |
|
|
136
|
+
| `high` | Adversarial review, parallel-fan-out high-effort slots, observability instrumentation, feasibility research, ledger / roadmap judgement against the codebase. Also phase-verdict summaries (`*-summary`, haiku model) and source modifiers with test loops (sonnet model). | `*-summary`, `bkit-build-plan-execute`, `bkit-build-plan-gaps-remediate`, `bkit-build-challenge-remediate`, `bkit-build-challenge-tests`, `bkit-debug-failure-reproduce`, `bkit-debug-failure-remediate`, `bkit-ship-conflict-resolve`, `bkit-build-plan-verify`, `bkit-build-plan-current`, `bkit-build-challenge-1`, `bkit-build-challenge-2`, `bkit-design-brainstorm-ideate-1`, `bkit-design-brainstorm-ideate-3`, `bkit-design-organise`, `bkit-design-review-1`, `bkit-design-spike`, `bkit-plan-review-1`, `bkit-plan-review-3`, `bkit-plan-complexity-split`, `bkit-ship-update-docs`, `bkit-ship-deferred-sweep`, `bkit-utility-update-deferrals`, `bkit-utility-update-failures`, `bkit-utility-update-decisions`, `bkit-utility-update-knowledge`, `bkit-utility-update-roadmap` |
|
|
137
137
|
| `xhigh` | Top-of-pipeline synthesizers and highest-leverage adversarial / diagnostic agents — depth here compounds downstream. Model-gated (Opus-only on current models); pin `model: opus` if dispatched from a Sonnet orchestrator. | `bkit-design-generate`, `bkit-plan-generate`, `bkit-plan-update`, `bkit-design-update`, `bkit-audit-generate`, `bkit-build-challenge-reconcile`, `bkit-debug-failure-diagnose`, `bkit-debug-failure-soak` |
|
|
138
138
|
| `max` | Reserved — only if `xhigh` proves insufficient on a recurring failure mode. Costliest tier; one-shot orchestrator-level work only. Lazy-escalate from `xhigh` based on observed truncation, never preemptively. | (none currently) |
|
|
139
139
|
|
|
@@ -148,7 +148,7 @@ Pinning `model:` locks agent model regardless of orchestrator session. Without p
|
|
|
148
148
|
| Stub-replace + log-append reviewer | `Read, Grep, Glob, Write, Edit, Bash` | `bkit-build-challenge-1`, `bkit-build-challenge-2`, `bkit-build-plan-verify`, `bkit-build-plan-current`, `bkit-ship-deferred-sweep` |
|
|
149
149
|
| Doc rewriter (cp + Edit) | `Read, Grep, Glob, Edit, Bash` | `bkit-design-update`, `bkit-plan-update`, `bkit-build-challenge-reconcile` |
|
|
150
150
|
| Doc writer (with shell) | `Read, Grep, Glob, Write, Edit, Bash` | `bkit-design-organise`, `bkit-ship-update-docs` |
|
|
151
|
-
| Source modifier (with test gate) | `Read, Grep, Glob, Write, Edit, Bash` | `bkit-build-plan-execute`, `bkit-build-plan-gaps-remediate`, `bkit-build-challenge-remediate`, `bkit-build-challenge-tests`, `bkit-debug-failure-remediate`, `bkit-ship-conflict-resolve` |
|
|
151
|
+
| Source modifier (with test gate) | `Read, Grep, Glob, Write, Edit, Bash` | `bkit-build-plan-execute`, `bkit-build-plan-gaps-remediate`, `bkit-build-challenge-remediate`, `bkit-build-challenge-tests`, `bkit-debug-failure-reproduce`, `bkit-debug-failure-remediate`, `bkit-ship-conflict-resolve` |
|
|
152
152
|
| Skill-installer / Bash-only utility | `Read, Grep, Glob, Bash` | `bkit-build-install-skills` |
|
|
153
153
|
| Tracker reader (read-only MCP) | `Read, Grep, Glob, Write, Edit, Bash` + per tracker: github `mcp__github__list_issues, mcp__github__issue_read`; linear `mcp__linear__list_issues, mcp__linear__get_issue`; none — | `bkit-utility-update-roadmap` |
|
|
154
154
|
| Ledger updater | `Read, Grep, Glob, Write, Edit, Bash` | `bkit-utility-update-decisions`, `bkit-utility-update-deferrals`, `bkit-utility-update-failures`, `bkit-utility-update-knowledge` |
|
|
@@ -162,15 +162,15 @@ Pinning `model:` locks agent model regardless of orchestrator session. Without p
|
|
|
162
162
|
|
|
163
163
|
`maxTurns` = max **agent turns** (assistant messages); each turn may emit multiple parallel tool calls. **Runaway-loop safety cap, not workload budget.** Runtime bounded by universal 3600s step timeout (`workflows.md` § Execution Protocol).
|
|
164
164
|
|
|
165
|
-
**Same philosophy as timeout:** 3600s ~2x typical 30 min runtime — hit means something wrong. `maxTurns` tiers are S=50 / M=100 / L=
|
|
165
|
+
**Same philosophy as timeout:** 3600s ~2x typical 30 min runtime — hit means something wrong. `maxTurns` tiers are S=50 / M=100 / L=200 / XL=400, per-agent in § Models:
|
|
166
166
|
|
|
167
167
|
<!-- prettier-ignore -->
|
|
168
168
|
| Tier | Cap | Typical work | Use for | Examples |
|
|
169
169
|
| --- | --- | --- | --- | --- |
|
|
170
|
-
| **S** | **50** | 3-10 turns | Pure synthesizers
|
|
171
|
-
| **M** | **100** | 5-25 turns | Reviewers
|
|
172
|
-
| **L** | **
|
|
173
|
-
| **XL** | **
|
|
170
|
+
| **S** | **50** | 3-10 turns | Pure synthesizers reading 1-3 run artifacts and writing one verdict. | `*-summary` |
|
|
171
|
+
| **M** | **100** | 5-25 turns | Reviewers and generators reading a few docs and writing one, scope / complexity checks, single-pass utilities, install, handover writers. | `bkit-design-brainstorm-ideate-*`, `bkit-design-review-*`, `bkit-design-generate`, `bkit-design-organise`, `bkit-plan-review-*`, `bkit-plan-complexity-check`, `bkit-plan-complexity-split`, `bkit-plan-scope-check-*`, `bkit-build-install-skills`, `bkit-debug-abort-handover`, `bkit-utility-compress-markdown` |
|
|
172
|
+
| **L** | **200** | 30-60 turns | Source modifiers with test loops, plan executor — iterative edit→`pnpm bkit:gate:static-unit`→edit cycles; probe-code runners; investigators sweeping a diff, its callers or the codebase; whole-doc rewriters; per-cycle doc sync. | `bkit-build-plan-execute`, `bkit-build-plan-gaps-remediate`, `bkit-build-challenge-remediate`, `bkit-debug-failure-remediate`, `bkit-debug-failure-soak`, `bkit-ship-conflict-resolve`, `bkit-design-spike`, `bkit-build-challenge-1`, `bkit-build-challenge-2`, `bkit-build-challenge-reconcile`, `bkit-build-challenge-tests`, `bkit-build-plan-verify`, `bkit-build-plan-current`, `bkit-debug-failure-reproduce`, `bkit-debug-failure-diagnose`, `bkit-ship-deferred-sweep`, `bkit-plan-generate`, `bkit-plan-update`, `bkit-design-update`, `bkit-ship-update-docs` |
|
|
173
|
+
| **XL** | **400** | 60-180 turns | Whole-surface sweeps: every probe step of one audit template against repo and live systems; every row of a jsonl ledger, the roadmap board or the doc catalog re-checked against code, docs and tracker. | `bkit-audit-generate`, `bkit-utility-update-*` |
|
|
174
174
|
|
|
175
175
|
**Tier assignment is canonical** — per-agent rows in § Models. Cap hit at any tier → agent stuck (retry loop, infinite re-read) — orchestrator verdict-validation retry handles partial recovery.
|
|
176
176
|
|
|
@@ -178,7 +178,7 @@ Pinning `model:` locks agent model regardless of orchestrator session. Without p
|
|
|
178
178
|
|
|
179
179
|
Canonical per-agent metadata — **single source of truth for model per agent**. **Keyed on PROVIDER, not host** — a model ID belongs to the gateway serving it → shared provider = one column, never two; table never grows as hosts x providers. Columns: `Anthropic` (Claude Code's pinned provider — locked ID, session-independent), `Cursor` (Cursor's pinned provider; cross-family diversity), `OpenAI` (Codex), `Google` (Antigravity), one per opencode provider (`OpenRouter`, `Ollama`, …). `bkit install --opencode=<provider>` reads the matching column; every allowlisted provider ships one.
|
|
180
180
|
|
|
181
|
-
**Cells = BARE provider-scoped model ID** (`
|
|
181
|
+
**Cells = BARE provider-scoped model ID** (`deepseek-v4.1-flash`, `moonshotai/kimi-k3`) — never a provider prefix. Host-format prefixes are added at render by `formatModelPin`, which also maps key `opencode-zen` → opencode's own id `opencode`. A prefixed cell (`opencode/deepseek-v4.1-flash`) double-prefixes.
|
|
182
182
|
|
|
183
183
|
> **`OpenAI` column — PROVISIONAL, not parity-proven.** Every other gateway column = live catalog probe + per-model tool-calling smoke. `OpenAI` cells mapped from documented role only (`gpt-6-astra` deep reasoning, `gpt-5.6-terra` balanced default). Haiku cells are board-picked: `gpt-6-luna` (LiveBench 51.2; `gpt-5.6-luna` measures 48.4), 2026-10-09, existence via models.dev only — no OpenAI key to probe. Re-pin from a real probe before relying on them. `gpt-5.4` / `gpt-5.4-mini` retired 2026-08-31.
|
|
184
184
|
|
|
@@ -186,63 +186,64 @@ Canonical per-agent metadata — **single source of truth for model per agent**.
|
|
|
186
186
|
|
|
187
187
|
> **Context-window note:** Claude Code `model:` is the API ID. `claude-opus-5-5` and `claude-sonnet-5-5` are 1M context. Haiku pins `claude-haiku-5-5` (1M context). xhigh agents pin `claude-opus-5-5`.
|
|
188
188
|
>
|
|
189
|
-
> **opencode model IDs:** Per-provider column; full provider-prefixed ID (`<provider>/<model-id>`, e.g. `openrouter/moonshotai/kimi-k3`, `ollama/
|
|
189
|
+
> **opencode model IDs:** Per-provider column; full provider-prefixed ID (`<provider>/<model-id>`, e.g. `openrouter/moonshotai/kimi-k3`, `ollama/deepseek-v4.1-flash`). `bkit install --opencode=<provider>` installs column verbatim. Allowlisted: `openrouter`, `ollama`, `opencode-zen` + `opencode-go` (both `BKIT_OPENCODE_API_KEY`). **All four ship curated columns below.** Zen: models.dev id `opencode/<id>`; Go: `opencode-go/<id>`. Both gateways = built-ins (apiKey only). **`/zen/v1/models` REST probe cannot see Go-only models — models.dev is source of truth.** See `.bkit/providers.md` § Models.
|
|
190
190
|
>
|
|
191
191
|
> **Columns target scores, not tiers.** opencode columns do **not** mirror the Claude ladder: each cell is the cheapest model reaching that tier's target on the parity board (`providers.md` § Selecting pins); chain-of-thought reasoner for convergent agents (risk / diagnosis lens). Per-row columns; any cell re-pinnable.
|
|
192
192
|
>
|
|
193
|
-
> **Per-tier quality targets; cheapest sufficient pin.** Tier cells are not the same rung of each provider's ladder — each is the **cheapest model that reaches that tier's Claude score** on LiveBench Agentic Coding (opus target **65.2**, sonnet target **59.4**, haiku target **~51** — `claude-haiku-5-5` 51.4 at `xhigh`, run at `high`; opus and sonnet targets stay the `claude-opus-5` / `claude-sonnet-5` scores because LiveBench's 5.5 rows land level (opus) or don't read cleanly (sonnet) — `providers.md` § Agentic-coding parity board; process in § Selecting pins). Two consequences pull opposite ways: a provider whose ceiling sits under the sonnet target **collapses opus+sonnet onto that ceiling** (spreading them buys nothing and costs quality on the sonnet half), while **haiku cells stay cheap** because a low-cost model already clears the haiku bar. **Claude is never a pin on an opencode column** — those columns exist to carry work when the Claude quota is spent, so a Claude model there defeats the purpose regardless of score. **opus** → `openrouter` `deepseek-v4.1-flash` (77.3); `ollama` `
|
|
193
|
+
> **Per-tier quality targets; cheapest sufficient pin.** Tier cells are not the same rung of each provider's ladder — each is the **cheapest model that reaches that tier's Claude score** on LiveBench Agentic Coding (opus target **65.2**, sonnet target **59.4**, haiku target **~51** — `claude-haiku-5-5` 51.4 at `xhigh`, run at `high`; opus and sonnet targets stay the `claude-opus-5` / `claude-sonnet-5` scores because LiveBench's 5.5 rows land level (opus) or don't read cleanly (sonnet) — `providers.md` § Agentic-coding parity board; process in § Selecting pins). Two consequences pull opposite ways: a provider whose ceiling sits under the sonnet target **collapses opus+sonnet onto that ceiling** (spreading them buys nothing and costs quality on the sonnet half), while **haiku cells stay cheap** because a low-cost model already clears the haiku bar. **Claude is never a pin on an opencode column** — those columns exist to carry work when the Claude quota is spent, so a Claude model there defeats the purpose regardless of score. **opus** → `openrouter` `deepseek-v4.1-flash` (77.3); `ollama` `deepseek-v4.1-flash` (77.3); `opencode-zen` `deepseek-v4.1-flash` (77.3 — re-pinned from `kimi-k2.7-code` because 2.0 rejects a `variant:` the model does not expose, and `kimi-k2.7-code` exposes none; Zen bills V4.1 Flash at $0.30/$1.20, so this cell costs more than the old one); `opencode-go` `deepseek-v4.1-flash` (77.3). **sonnet** → same `deepseek-v4.1-flash` on every opencode column (clears 59.4). **haiku** → `openrouter` + `opencode-zen` `glm-5.3-flash` (56.8); `ollama` + `opencode-go` `deepseek-v4.1-flash` (77.3 — cheaper than GLM on those two); `OpenAI` `gpt-6-luna` (51.2). **convergent** → `kimi-k3` (62.2) on every opencode column; on both gateways it bills $3/$15 per Mtok, the column's most expensive pin. **gpt-oss pinned nowhere** — `gpt-oss-120b` measures **~10 est**, below every tier target including haiku. **`ollama` subscription:** every tier needs a **paid plan** (`deepseek-v4.1-flash` / `kimi-k3`); the free `qwen3.5:397b` / `gpt-oss:20b` are unmeasured or far below target — free-tier users re-pin in § Model Overrides and accept unverified quality. **`opencode-go`** carries no `gemini-*` (it lists `gpt-6-luna`, `gpt-5.6-luna` and `claude-haiku-5-5`; Claude is still never pinned); its DeepSeek models need the workspace privacy setting on "Global regions"; prefer Go 5h window pins. Re-pin via § Model Overrides or models.dev / provider `/v1/models` (`providers.md`).
|
|
194
194
|
|
|
195
195
|
<!-- prettier-ignore -->
|
|
196
196
|
| Prompt | Anthropic | Cursor | OpenRouter | Ollama | OpenCode Zen | OpenCode Go | OpenAI | Google | Effort | Max Turns | Role |
|
|
197
197
|
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
|
|
198
|
-
| `bkit-design-brainstorm-ideate-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
199
|
-
| `bkit-design-brainstorm-ideate-2` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
200
|
-
| `bkit-design-brainstorm-ideate-3` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `moonshotai/kimi-k3` | `
|
|
201
|
-
| `bkit-design-review-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
202
|
-
| `bkit-design-review-2` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
203
|
-
| `bkit-design-spike` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
204
|
-
| `bkit-design-update` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
205
|
-
| `bkit-design-organise` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
198
|
+
| `bkit-design-brainstorm-ideate-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 100 | parallel slot 1 (pragmatic lens) |
|
|
199
|
+
| `bkit-design-brainstorm-ideate-2` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `medium` | 100 | parallel slot 2 (optimal-tradeoff lens; Composer vs Grok siblings on Cursor; cross-tier on Claude) |
|
|
200
|
+
| `bkit-design-brainstorm-ideate-3` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `moonshotai/kimi-k3` | `kimi-k3` | `kimi-k3` | `kimi-k3` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 100 | parallel slot 3 (risk-premortem lens) |
|
|
201
|
+
| `bkit-design-review-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 100 | design review slot 1 (web search + feasibility analysis) |
|
|
202
|
+
| `bkit-design-review-2` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `medium` | 100 | design review slot 2 (Composer vs Grok sibling on Cursor; cross-tier on Claude) |
|
|
203
|
+
| `bkit-design-spike` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 200 | settle review-named unknowns with throwaway probe code (conditional step) |
|
|
204
|
+
| `bkit-design-update` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `xhigh` | 200 | merge review critiques into design (whole-doc rewrite — needs depth) |
|
|
205
|
+
| `bkit-design-organise` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 100 | decompose reviewed design into dependency-annotated workstreams; coverage self-verify + DAG cycle detection |
|
|
206
206
|
| `bkit-design-summary` | `claude-haiku-5-5` | `composer-2.5` | `z-ai/glm-5.3-flash` | `deepseek-v4.1-flash` | `glm-5.3-flash` | `deepseek-v4.1-flash` | `gpt-6-luna` | `gemini-3.8-flash` | `high` | 50 | summary writer |
|
|
207
|
-
| `bkit-design-generate` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
208
|
-
| `bkit-plan-complexity-check` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
209
|
-
| `bkit-plan-generate` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
210
|
-
| `bkit-audit-generate` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
211
|
-
| `bkit-plan-review-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
212
|
-
| `bkit-plan-review-2` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
213
|
-
| `bkit-plan-review-3` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `moonshotai/kimi-k3` | `
|
|
214
|
-
| `bkit-plan-scope-check-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
215
|
-
| `bkit-plan-scope-check-2` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
216
|
-
| `bkit-plan-complexity-split` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
207
|
+
| `bkit-design-generate` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `xhigh` | 100 | generate design from brainstorms (top-of-pipeline synthesizer; whole-doc rewrite) |
|
|
208
|
+
| `bkit-plan-complexity-check` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `medium` | 100 | complexity check |
|
|
209
|
+
| `bkit-plan-generate` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `xhigh` | 200 | plan draft generator (top-of-pipeline synthesizer) |
|
|
210
|
+
| `bkit-audit-generate` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `xhigh` | 400 | audit report from one template (top-of-pipeline synthesizer) |
|
|
211
|
+
| `bkit-plan-review-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 100 | review slot 1 (tightness + design-coverage) |
|
|
212
|
+
| `bkit-plan-review-2` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `medium` | 100 | review slot 2 (dependency-correctness + design-coverage; depth-sensitive lens — both opus) |
|
|
213
|
+
| `bkit-plan-review-3` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `moonshotai/kimi-k3` | `kimi-k3` | `kimi-k3` | `kimi-k3` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 100 | review slot 3 (regression-risk + design-coverage) |
|
|
214
|
+
| `bkit-plan-scope-check-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `medium` | 100 | scope audit slot 1 (mechanical audit — medium effort) |
|
|
215
|
+
| `bkit-plan-scope-check-2` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `medium` | 100 | scope audit slot 2 (Composer vs Grok sibling on Cursor) |
|
|
216
|
+
| `bkit-plan-complexity-split` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 100 | split large plan |
|
|
217
217
|
| `bkit-plan-summary` | `claude-haiku-5-5` | `composer-2.5` | `z-ai/glm-5.3-flash` | `deepseek-v4.1-flash` | `glm-5.3-flash` | `deepseek-v4.1-flash` | `gpt-6-luna` | `gemini-3.8-flash` | `high` | 50 | summary writer |
|
|
218
|
-
| `bkit-plan-update` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
219
|
-
| `bkit-build-install-skills` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
220
|
-
| `bkit-build-challenge-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
221
|
-
| `bkit-build-challenge-2` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `moonshotai/kimi-k3` | `
|
|
222
|
-
| `bkit-build-challenge-reconcile` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
223
|
-
| `bkit-build-challenge-tests` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
224
|
-
| `bkit-build-plan-execute` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
225
|
-
| `bkit-build-challenge-remediate` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
226
|
-
| `bkit-build-plan-gaps-remediate` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
218
|
+
| `bkit-plan-update` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `xhigh` | 200 | merge review + scope critiques into plan (whole-doc rewrite — needs depth) |
|
|
219
|
+
| `bkit-build-install-skills` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `medium` | 100 | skill identifier |
|
|
220
|
+
| `bkit-build-challenge-1` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 200 | parallel slot 1 (bug-hunting lens) |
|
|
221
|
+
| `bkit-build-challenge-2` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `moonshotai/kimi-k3` | `kimi-k3` | `kimi-k3` | `kimi-k3` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 200 | parallel slot 2 (security lens; depth-sensitive — both opus) |
|
|
222
|
+
| `bkit-build-challenge-reconcile` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `xhigh` | 200 | merge parallel challenge findings (whole-doc rewrite) |
|
|
223
|
+
| `bkit-build-challenge-tests` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `high` | 200 | test generator (source modifier, no test loop) |
|
|
224
|
+
| `bkit-build-plan-execute` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `high` | 200 | task executor (source modifier with test loop; ceiling — split if exceeded) |
|
|
225
|
+
| `bkit-build-challenge-remediate` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `high` | 200 | fix challenge findings (source modifier with test loop) |
|
|
226
|
+
| `bkit-build-plan-gaps-remediate` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `high` | 200 | fix verification gaps (source modifier with test loop) |
|
|
227
227
|
| `bkit-build-summary` | `claude-haiku-5-5` | `composer-2.5` | `z-ai/glm-5.3-flash` | `deepseek-v4.1-flash` | `glm-5.3-flash` | `deepseek-v4.1-flash` | `gpt-6-luna` | `gemini-3.8-flash` | `high` | 50 | summary writer |
|
|
228
|
-
| `bkit-build-plan-verify` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
229
|
-
| `bkit-build-plan-current` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
230
|
-
| `bkit-debug-abort-handover` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
231
|
-
| `bkit-debug-failure-
|
|
232
|
-
| `bkit-debug-failure-
|
|
233
|
-
| `bkit-debug-failure-
|
|
228
|
+
| `bkit-build-plan-verify` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 200 | verify impl vs plan |
|
|
229
|
+
| `bkit-build-plan-current` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 200 | judge plan vs changes landed since its base commit |
|
|
230
|
+
| `bkit-debug-abort-handover` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `medium` | 100 | handover writer |
|
|
231
|
+
| `bkit-debug-failure-reproduce` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 200 | failing tests from a bug report, no fix; opus over the sonnet test-writer tier — an off-symptom test sends the fix loop after the wrong bug |
|
|
232
|
+
| `bkit-debug-failure-diagnose` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `moonshotai/kimi-k3` | `kimi-k3` | `kimi-k3` | `kimi-k3` | `gpt-6-astra` | `gemini-3.8-pro` | `xhigh` | 200 | failure diagnosis (Final-strategy attempts especially benefit from depth before human handover) |
|
|
233
|
+
| `bkit-debug-failure-remediate` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `high` | 200 | implement diagnosis fixes (source modifier with test loop) |
|
|
234
|
+
| `bkit-debug-failure-soak` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `moonshotai/kimi-k3` | `kimi-k3` | `kimi-k3` | `kimi-k3` | `gpt-6-astra` | `gemini-3.8-pro` | `xhigh` | 200 | soak fix — one accumulating-context instrument-or-fix step per iteration against the live boundary (orchestrator re-runs tests + loops) |
|
|
234
235
|
| `bkit-debug-summary` | `claude-haiku-5-5` | `composer-2.5` | `z-ai/glm-5.3-flash` | `deepseek-v4.1-flash` | `glm-5.3-flash` | `deepseek-v4.1-flash` | `gpt-6-luna` | `gemini-3.8-flash` | `high` | 50 | summary writer |
|
|
235
236
|
| `bkit-ship-summary` | `claude-haiku-5-5` | `composer-2.5` | `z-ai/glm-5.3-flash` | `deepseek-v4.1-flash` | `glm-5.3-flash` | `deepseek-v4.1-flash` | `gpt-6-luna` | `gemini-3.8-flash` | `high` | 50 | summary writer |
|
|
236
|
-
| `bkit-ship-update-docs` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
237
|
-
| `bkit-ship-conflict-resolve` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
238
|
-
| `bkit-ship-deferred-sweep` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
239
|
-
| `bkit-utility-update-deferrals` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
240
|
-
| `bkit-utility-update-failures` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
241
|
-
| `bkit-utility-update-decisions` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
242
|
-
| `bkit-utility-update-knowledge` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
243
|
-
| `bkit-utility-update-roadmap` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
244
|
-
| `bkit-utility-compress-markdown` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
245
|
-
| `bkit-utility-update-documentation` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
237
|
+
| `bkit-ship-update-docs` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 200 | sync cataloged docs (multi-doc writer) |
|
|
238
|
+
| `bkit-ship-conflict-resolve` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `high` | 200 | mechanical rebase-conflict resolver (source modifier with test loop) |
|
|
239
|
+
| `bkit-ship-deferred-sweep` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 200 | pre-merge completeness gate — intended-vs-actual + declared-deferral resurface |
|
|
240
|
+
| `bkit-utility-update-deferrals` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 400 | deferrals update |
|
|
241
|
+
| `bkit-utility-update-failures` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 400 | failures update |
|
|
242
|
+
| `bkit-utility-update-decisions` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 400 | decisions update |
|
|
243
|
+
| `bkit-utility-update-knowledge` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 400 | knowledge update |
|
|
244
|
+
| `bkit-utility-update-roadmap` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | `high` | 400 | roadmap analysis |
|
|
245
|
+
| `bkit-utility-compress-markdown` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `medium` | 100 | token-optimize markdown |
|
|
246
|
+
| `bkit-utility-update-documentation` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | `medium` | 400 | doc sync (multi-doc writer) |
|
|
246
247
|
|
|
247
248
|
**Effort vs maxTurns vs model — three independent knobs:**
|
|
248
249
|
|
|
@@ -255,7 +256,7 @@ Canonical per-agent metadata — **single source of truth for model per agent**.
|
|
|
255
256
|
|
|
256
257
|
### Live model-ID verification
|
|
257
258
|
|
|
258
|
-
> **Verified against live provider APIs** (`providers.md` § Per-provider live model lookup). Last verification: 2026-10-09 (Claude; haiku cells of every column — existence only, no tool-call smoke: Ollama needs a paid plan, Zen balance zero, no Go subscription, no OpenAI key); 2026-10-06 (Cursor); 2026-09-16 (OpenRouter column); 2026-07-25 (remaining columns).
|
|
259
|
+
> **Verified against live provider APIs** (`providers.md` § Per-provider live model lookup). Last verification: 2026-10-19 (Ollama column — existence via `/api/tags`, no tool-call smoke: no Ollama key; OpenCode Zen + Go opus/sonnet/convergent — existence via models.dev); 2026-10-09 (Claude; haiku cells of every column — existence only, no tool-call smoke: Ollama needs a paid plan, Zen balance zero, no Go subscription, no OpenAI key); 2026-10-06 (Cursor); 2026-09-16 (OpenRouter column); 2026-07-25 (remaining columns).
|
|
259
260
|
>
|
|
260
261
|
> - **Claude** (`/v1/models`) — pins `claude-opus-5-5` / `claude-sonnet-5-5` / `claude-haiku-5-5`. Opus 5, Sonnet 5 and Haiku 4.5 remain listed; not pinned.
|
|
261
262
|
> - **Cursor** (`/v0/models`) — **defaults = first-party pool only:** `cursor-grok-4.5-high` (depth / synthesizers / parallel diversity) + `composer-2.5` (volume / build+ship orchestrators). Catalog has **no** `cursor-grok-4.7` and **no** Opus 5.5 / Sonnet 5.5 IDs. API-pool IDs present and **not pinned**: `claude-opus-5-thinking-high`, `claude-sonnet-5-thinking-high`/`-xhigh`, `gpt-5.6-*`, `claude-fable-5-thinking-high`/`-xhigh`. Opt in via § Model Overrides.
|
|
@@ -264,12 +265,12 @@ Canonical per-agent metadata — **single source of truth for model per agent**.
|
|
|
264
265
|
> **OpenAI-compatible providers curated + tool-call-smoked** (`tools:` chat / completions round-trip per pin, confirming `tool_calls` — `/models` existence ≠ tool-calls):
|
|
265
266
|
>
|
|
266
267
|
> - **OpenRouter** (`/api/v1/models`, public) — `deepseek/deepseek-v4.1-flash` (opus+sonnet, 77.3, 16+ endpoints), `z-ai/glm-5.3-flash` (haiku, 56.8, 27 endpoints), `moonshotai/kimi-k3` (convergent, 62.2, 17 endpoints). All three auto-cache — `providers.md` § Selecting pins. (Tool-call smoke 403 `Key limit exceeded` — existence-verified; smoke deferred.)
|
|
267
|
-
> - **Ollama** (`/v1/models`) — `
|
|
268
|
+
> - **Ollama** (`/v1/models`) — `deepseek-v4.1-flash` (opus+sonnet+haiku, 77.3), `kimi-k3` (convergent, 62.2). Every tier needs a paid plan. (Existence-verified via `/api/tags` 2026-10-19; smoke deferred.)
|
|
268
269
|
>
|
|
269
270
|
> **opencode gateways — TWO providers; catalogs from models.dev (not `/zen/v1/models`).** `/zen/v1/models` = Zen only; CANNOT see Go-only models — models.dev source of truth (`opencode` = Zen, `opencode-go` = Go).
|
|
270
271
|
>
|
|
271
|
-
> - **`opencode-zen`** (`https://opencode.ai/zen/v1`) — full gateway; `
|
|
272
|
-
> - **`opencode-go`** (`https://opencode.ai/zen/**go**/v1` — nested under `/zen/`) — open-weight budget plan. `deepseek-v4-
|
|
272
|
+
> - **`opencode-zen`** (`https://opencode.ai/zen/v1`) — full gateway; `deepseek-v4.1-flash` (opus+sonnet), `glm-5.3-flash` (haiku), `kimi-k3` (convergent, 62.2). `kimi-k2.7-code` / `qwen3.6-plus` not pinned — dominated by V4.1 Flash (77.3 at $0.06/task vs 45.7 at $0.39 / 41.4 at $1.55). models.dev validated (Zen balance zero; smoke on Go).
|
|
273
|
+
> - **`opencode-go`** (`https://opencode.ai/zen/**go**/v1` — nested under `/zen/`) — open-weight budget plan. `deepseek-v4.1-flash` (opus+sonnet+haiku, 77.3), `kimi-k3` (convergent, 62.2 — $3/$15 per Mtok, the heaviest draw on the Go 5h window). `minimax-m3` / `qwen3.7-plus` not pinned — both score under V4.1 Flash at higher cost (40.7 at $0.42 for `minimax-m3`; `qwen3.7-plus` unmeasured). Prefer Go 5h window pins. No `gemini-*`; never pin its `gpt-*` / `claude-*`.
|
|
273
274
|
|
|
274
275
|
### Orchestrators (slash commands)
|
|
275
276
|
|
|
@@ -278,11 +279,11 @@ Canonical per-agent metadata — **single source of truth for model per agent**.
|
|
|
278
279
|
<!-- prettier-ignore -->
|
|
279
280
|
| Orchestrator | Anthropic | Cursor | OpenRouter | Ollama | OpenCode Zen | OpenCode Go | OpenAI | Google | Role |
|
|
280
281
|
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
|
|
281
|
-
| `/design` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
282
|
-
| `/plan` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
283
|
-
| `/debug` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `
|
|
284
|
-
| `/build` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
285
|
-
| `/ship` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `
|
|
282
|
+
| `/design` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | Synthesizes conflicting brainstorms; resolves design ambiguity. |
|
|
283
|
+
| `/plan` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | Decides single vs split; merges review (triplet) + scope-check (pair) critiques. |
|
|
284
|
+
| `/debug` | `claude-opus-5-5` | `cursor-grok-4.5-high` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-6-astra` | `gemini-3.8-pro` | Picks remediation path under uncertainty; Standard / Pivot / Final escalation. |
|
|
285
|
+
| `/build` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | Fixed pipeline: dispatch → verify → challenge → tests → summary. Subagents own the heavy reasoning (`bkit-build-challenge-1`/`-2`/`-reconcile`, `bkit-build-plan-verify` are `high`/`medium`/`xhigh` effort). |
|
|
286
|
+
| `/ship` | `claude-sonnet-5-5` | `composer-2.5` | `deepseek/deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `deepseek-v4.1-flash` | `gpt-5.6-terra` | `gemini-3.8-pro` | Mostly mechanical: merge + archive + parallel docs / summary. |
|
|
286
287
|
|
|
287
288
|
**Rule:** Opus where orchestrator resolves ambiguity; Sonnet for defined sequence. **If** Sonnet orchestrator skips Failure Path branches or mis-routes verify gaps → escalate Opus.
|
|
288
289
|
|
|
@@ -304,14 +305,14 @@ Canonical per-agent metadata — **single source of truth for model per agent**.
|
|
|
304
305
|
| `bkit-design-spike` | Conditional — runs only when `bkit-design-review-1` sets `Spike` = TRUE. Restates each unknown as a falsifiable claim, writes the smallest probe that could disprove it under `docs/plans/{YYYYMM}/logs/{FID}/spike/`, runs it, records captured output verbatim. Settles claims by evidence only — never infers a result from source reading, never simulates an unavailable service. PASS / CONCERNS / FAIL where FAIL = a design assumption is disproven (Step 8 revises against it) and CONCERNS = unsettleable this run (assumption carried forward unproven); per-claim `SETTLED` / `DISPROVEN` / `BLOCKED` stays in the body. Disproof needs evidence that an honest attempt failed — "could not get it working" is `BLOCKED`, never `DISPROVEN`, and no claim may be weakened or stubbed to make a probe pass. Probe code is throwaway and confined to the artifact tree; never touches tracked source or a repo manifest. |
|
|
305
306
|
| `bkit-design-update` | Apply CRITICAL items and OPTIONAL items judged on merit from both reviews; whole-doc rewrite of design. Open questions a finding adds or rewords carry options, `Recommended` and `Default if unanswered`; untouched regions stay verbatim. |
|
|
306
307
|
| `bkit-design-organise` | Decompose `design-v2-reviewed.md` into dependency-annotated workstreams (`WS-1`, `WS-2`, …); inline `Requires` per workstream; FAIL if cycles detected. `## Suggested Workstreams` is the suggestion. Workflow Step 11 posts that list on the parent issue. It never creates tracker issues. |
|
|
307
|
-
| `bkit-design-summary` | Read-only verdict on design doc + spike. `Outstanding Questions` surfaces each open question with its options, `Recommended` and `Default if unanswered` verbatim from the artifact — never generated here, since a summary-only recommendation is discarded the moment `bkit-plan-generate` reads the artifact. Which option is right stays verdict-neutral; a question still left bare is a CONCERNS-level content issue — the backstop for a bare-question finding `bkit-design-update` skipped on merit. Unchecked human-confirmation gates never downgrade the verdict and land in `Action Items` on every verdict — gating that section on CONCERNS / FAIL left a PASS note nowhere to go. |
|
|
308
|
+
| `bkit-design-summary` | Read-only verdict on design doc + spike. `Outstanding Questions` surfaces each open question with its options, `Recommended` and `Default if unanswered` verbatim from the artifact — never generated here, since a summary-only recommendation is discarded the moment `bkit-plan-generate` reads the artifact. Which option is right stays verdict-neutral; a question still left bare is a CONCERNS-level content issue — the backstop for a bare-question finding `bkit-design-update` skipped on merit. Unchecked human-confirmation gates never downgrade the verdict and land in `Action Items` on every verdict — gating that section on CONCERNS / FAIL left a PASS note nowhere to go. With 2+ suggested workstreams it asks whether to file one issue each (shape per `.bkit/trackers.md` § Issue shapes, filed in `Requires` order so blocker numbers exist) and points `/bkit-plan` at the first root workstream's new issue, not the design issue, so each workstream gets its own smaller plan. |
|
|
308
309
|
|
|
309
310
|
## Plan Phase
|
|
310
311
|
|
|
311
312
|
<!-- prettier-ignore -->
|
|
312
313
|
| Agent | Scope |
|
|
313
314
|
| --- | --- |
|
|
314
|
-
| `bkit-plan-generate` | Read design and / or audit reports + template + docs → write new plan draft. Design absent and audits present is valid. Audit contract: if input includes audit-scope directives, plan covers only those findings; the rest of each report is context only, not backlog. Workstream contract: if input includes `**Workstream:**` directive, plan covers only that workstream's `## Scope` content unless stated otherwise; surface `**Requires:**` at top of plan. Process = one step per major template section in **dependency (authoring) order, not template document order** — derived sections (Breaking Changes, Supersession, Security, Docs, Rollback) follow Architecture rather than preceding it: Context → Acceptance Scenario → Derived Test Matrix → Open Questions → Pre-Flight → Alternatives → Data Schema → Reuse Inventory → Architecture (+ `decisions.jsonl`) → Breaking Changes → Supersession → Security → Docs → Rollback → Out of Scope → Suggested Scope Expansion → Agent Execution Runbook (pick tests from matrix only; each row → exactly one task; every task has `**Done when:**`) → Verification. Human-confirmation checkboxes stay unchecked at generate. Every `Open Questions & Assumptions` question carries 2-3 concrete options with trade-offs, a `Recommended` option and a `Default if unanswered` (design's answer carried forward where it has one); a bare question is not acceptable output. `Out of Scope` entries must be `Exempt` (genuinely-additive), else a runbook task. `Suggested Scope Expansion` filled per template (candidates, not tasks); no tracker / ledger scan here — surface overlaps come from the orchestrator Fetch Context step via `bkit-plan-review-1`. |
|
|
315
|
+
| `bkit-plan-generate` | Read design and / or audit reports + template + docs → write new plan draft. Design absent and audits present is valid. Neither present → the issue is the source: a change-shape issue's `Narrative`, `Success Criteria`, `Edge Cases`, matrix rows and tasks carry over verbatim (template § `Spec`). Audit contract: if input includes audit-scope directives, plan covers only those findings; the rest of each report is context only, not backlog. Workstream contract: if input includes `**Workstream:**` directive, plan covers only that workstream's `## Scope` content unless stated otherwise; surface `**Requires:**` at top of plan. Process = one step per major template section in **dependency (authoring) order, not template document order** — derived sections (Breaking Changes, Supersession, Security, Docs, Rollback) follow Architecture rather than preceding it: Context → Acceptance Scenario → Derived Test Matrix → Open Questions → Pre-Flight → Alternatives → Data Schema → Reuse Inventory → Architecture (+ `decisions.jsonl`) → Breaking Changes → Supersession → Security → Docs → Rollback → Out of Scope → Suggested Scope Expansion → Agent Execution Runbook (pick tests from matrix only; each row → exactly one task; every task has `**Done when:**`) → Verification. Human-confirmation checkboxes stay unchecked at generate. Every `Open Questions & Assumptions` question carries 2-3 concrete options with trade-offs, a `Recommended` option and a `Default if unanswered` (design's answer carried forward where it has one); a bare question is not acceptable output. `Out of Scope` entries must be `Exempt` (genuinely-additive), else a runbook task. `Suggested Scope Expansion` filled per template (candidates, not tasks); no tracker / ledger scan here — surface overlaps come from the orchestrator Fetch Context step via `bkit-plan-review-1`. |
|
|
315
316
|
| `bkit-plan-review-1` | Read-only critique — tightness lens; effort slot 1 (`high`). Parallel with `-2` and `-3`. Missing or vague `**Done when:**` on any task → CRITICAL. `Blocking` out-of-scope deferral (in-scope work parked in `Out of Scope`) → CRITICAL. Audits `Open Questions & Assumptions` format — question missing options, `Recommended` or `Default if unanswered` → OPTIONAL (mirrors `bkit-design-review-2` on the design side). Surfaces `Suggested Scope Expansion` candidates from the `related-*.md` context. FAIL only for broken template structure (sections missing / reordered) — content gaps, drift included, are CRITICAL → CONCERNS so `bkit-plan-update` repairs them; `-2` shares the mapping. |
|
|
316
317
|
| `bkit-plan-review-2` | Same scope — dependency-correctness lens; effort slot 2 (`medium` effort, opus model — depth-sensitive lens). Plans carry no dependency fields, so the graph is derived: what each task produces and consumes, read against runbook order (template: build order). A consumer before its producer, or a prerequisite no task produces and the repo lacks, is CRITICAL. Reading declared `Requires:` / `After:` fields instead found no edges on every real plan and passed unchecked. |
|
|
317
318
|
| `bkit-plan-review-3` | Same scope — regression-risk lens; effort slot 3 (`high`). |
|
|
@@ -329,8 +330,8 @@ Canonical per-agent metadata — **single source of truth for model per agent**.
|
|
|
329
330
|
| --- | --- |
|
|
330
331
|
| `bkit-build-plan-current` | Judge whether changes landed on `origin/dev` since the plan's `bkit:anchor` `baseSha` leave its tasks executable. Derives its own changed-path list from `BASE_SHA` (orchestrator-supplied via Context), intersects it against the paths each task depends on, and reads per-path diffs for the intersection only — no whole-range diff, no path outside it. Same output shape as `bkit-build-challenge-*`: header count + one append-only findings section. `Executable` tasks are not findings and are not logged; `Reword` / `Broken` are, and `Affected` = their count. PASS = no affected task; CONCERNS = any `Reword`; FAIL = any `Broken`. All three are advisory — build proceeds on every verdict and `@bkit-build-plan-execute` reads the findings as its currency input. Judges the plan against the codebase — the design doc is not an input and a superseded design is not a finding. Commit distance and elapsed time never carry the verdict. Does not revise the plan: remediation is a `/bkit-plan` re-run, never `bkit-plan-update` from build. |
|
|
331
332
|
| `bkit-build-install-skills` | Identify and install relevant skills via `npx skills find`/`add`: quality-hurdle the source (official publisher, or 1000+ installs / 100+ stars), install one named skill per gap, report provenance. |
|
|
332
|
-
| `bkit-build-plan-execute` | Execute plan tasks sequentially; per task naming `Test first` tests: tests + stubs first, then the red command the orchestrator supplies in Context (`bkit tests red`) once per test — never the task's code before every red is recorded; skipped for tasks logged `DONE — already landed`; refused as `passed` → `BLOCKED` (never undo code to force a red); other refusals → fix test / stub and re-run; `bkit:test:file` not declared → `red not enforced`; could not run → `BLOCKED` (`.bkit/workflows.md` § Test-first). Branches on the outcome the command prints, not its exit code; honours plan `Reuse Inventory` at the only point the decision can still be quietly discarded — `EXTEND` row modifies named artifact, never a parallel file; reusable artifact found mid-build folds in, never forks; reads each task's `**Done when:**` line as the completion criterion to satisfy; modify source; write stub artifact first then incremental `## Task Log` entries. No plan file → `build-input-*.md` is the plan; tasks = its requested outcomes; outcome as worded is the bar. Reads `build-plan-current.md` when present: findings are fact, plan is intent — `Reword` tasks build at the paths the report names as current, `Broken` tasks whose work already landed log `DONE — already landed`, the rest build the intent against current code. Never edits the plan file; tasks absent from the findings follow plan wording verbatim. Does not tick plan checkboxes (verify owns that). Does not write `docs/deferrals.jsonl` — a blocked task is a `BLOCKED` log line for verify to catch, not a deferral. |
|
|
333
|
-
| `bkit-build-plan-verify` | Verify implementation vs plan; writes Plan Verification log. Ticks plan `[ ]`→`[x]` only when the task's `**Done when:**` criterion is satisfied in the codebase and the orchestrator's test-first audit report (`bkit tests green`) shows no gap for it — `not-green` fixable; `test-changed` / `red-mismatch` judged from the diff; `red-mismatch` for a planned test renamed or moved and passing now → no gap; `no-red` on an already-landed task (plan-currency `Broken` + execute `DONE — already landed`) → no gap; other `no-red` and the plan-defect kinds not fixable — a `BLOCKED` log line or a deferral row never discharges a task, so unfinished work routes to `@bkit-build-plan-gaps-remediate` in-loop instead of surfacing at ship. Missing `**Done when:**` on any plan-file task → FAIL (template structure broken; remediation cannot recover). No plan file → `build-input-*.md` is the plan, never created or ticked; outcome as worded is the bar, so missing `Done when` alone is not FAIL (the request was never reviewed). |
|
|
333
|
+
| `bkit-build-plan-execute` | Execute plan tasks sequentially; per task naming `Test first` tests: tests + stubs first, then the red command the orchestrator supplies in Context (`bkit tests red`) once per test — never the task's code before every red is recorded; skipped for tasks logged `DONE — already landed`; refused as `passed` → `BLOCKED` (never undo code to force a red); other refusals → fix test / stub and re-run; `bkit:test:file` not declared → `red not enforced`; could not run → `BLOCKED` (`.bkit/workflows.md` § Test-first). Branches on the outcome the command prints, not its exit code; honours plan `Reuse Inventory` at the only point the decision can still be quietly discarded — `EXTEND` row modifies named artifact, never a parallel file; reusable artifact found mid-build folds in, never forks; reads each task's `**Done when:**` line as the completion criterion to satisfy; modify source; write stub artifact first then incremental `## Task Log` entries. No plan file → `build-input-*.md` is the plan; tasks = its `**Task N:**` lines when present (reds recorded as for a plan, numbers kept), else its requested outcomes; outcome as worded is the bar when no `Done when` is written. Reads `build-plan-current.md` when present: findings are fact, plan is intent — `Reword` tasks build at the paths the report names as current, `Broken` tasks whose work already landed log `DONE — already landed`, the rest build the intent against current code. Never edits the plan file; tasks absent from the findings follow plan wording verbatim. Does not tick plan checkboxes (verify owns that). Does not write `docs/deferrals.jsonl` — a blocked task is a `BLOCKED` log line for verify to catch, not a deferral. |
|
|
334
|
+
| `bkit-build-plan-verify` | Verify implementation vs plan; writes Plan Verification log. Ticks plan `[ ]`→`[x]` only when the task's `**Done when:**` criterion is satisfied in the codebase and the orchestrator's test-first audit report (`bkit tests green`) shows no gap for it — `not-green` fixable; `test-changed` / `red-mismatch` judged from the diff; `red-mismatch` for a planned test renamed or moved and passing now → no gap; `no-red` on an already-landed task (plan-currency `Broken` + execute `DONE — already landed`) → no gap; other `no-red` and the plan-defect kinds not fixable — a `BLOCKED` log line or a deferral row never discharges a task, so unfinished work routes to `@bkit-build-plan-gaps-remediate` in-loop instead of surfacing at ship. Missing `**Done when:**` on any plan-file task → FAIL (template structure broken; remediation cannot recover). No plan file → `build-input-*.md` is the plan, never created or ticked; its `**Task N:**` lines, when present, are the tasks and `tests green --brief=` audits their reds; outcome as worded is the bar when no `Done when` is written, so missing `Done when` alone is not FAIL (the request was never reviewed). |
|
|
334
335
|
| `bkit-build-plan-gaps-remediate` | Fix specific gaps from latest verify log + boundary gate log failures (red sub-plan boundary; that gate MUST pass too); Standard / Pivot / Final escalation. |
|
|
335
336
|
| `bkit-build-challenge-1` | Adversarial review of `git diff origin/dev..HEAD` — bug-hunting lens; effort slot 1 (`high`). Parallel with `-2`. Writes findings, each tagged `class: mechanical\|architectural`. Never references sibling output (circular reasoning guard). |
|
|
336
337
|
| `bkit-build-challenge-2` | Same as `-1` — security lens; effort slot 2 (`high` on Claude / opus — depth-sensitive; Grok on Cursor — first-party depth, same native pool as `-1`). |
|
|
@@ -346,9 +347,10 @@ Canonical per-agent metadata — **single source of truth for model per agent**.
|
|
|
346
347
|
<!-- prettier-ignore -->
|
|
347
348
|
| Agent | Scope |
|
|
348
349
|
| --- | --- |
|
|
350
|
+
| `bkit-debug-failure-reproduce` | Bug report, no failing test → co-located tests failing on the reported symptoms, lowest tier reaching it; no implementation changes. Max 3 rewrites / 3 paths; not reproduced → test changes removed, `Reproduced: NO`. `Mode: SOAK` → tests repeat the scenario until they fail reliably. Wired into `/bkit-debug` § Failure Reproduce on `[repro]` + first-attempt PASS; `YES` → Run Tests records the red, or passes with no fix → Summary (`CONCERNS`: `Reproduced: YES` with no remediate / soak log); `NO` → Summary. |
|
|
349
351
|
| `bkit-debug-failure-diagnose` | Investigate test / CI failure → diagnosis log; no fixes. Standard / Pivot / Final by attempt. Folds `docs/knowledge.jsonl` by `key`, highest `ts` wins → reads only winning rows where `status` is `ACTIVE` or absent → cites matching entries in `## Prior Knowledge` → uses them to seed hypotheses. Output uses append-only ReAct `Hypothesis {N}` blocks; refuted hypotheses must remain. |
|
|
350
352
|
| `bkit-debug-failure-remediate` | Apply diagnosis fix; lint / typecheck / test gate; may append `knowledge.jsonl`/`decisions.jsonl`. |
|
|
351
|
-
| `bkit-debug-failure-soak` | One accumulating context across iterations (reads its prior `debug-failure-soak-*-log.md`); applies the single next instrument-or-fix step against the failing boundary; refuses to theorise; adds `[DEBUG-OBSERVE]` scaffolding and strips every marker before declaring a fix (no-leak). Wired into `/bkit-debug` §
|
|
353
|
+
| `bkit-debug-failure-soak` | One accumulating context across iterations (reads its prior `debug-failure-soak-*-log.md`); applies the single next instrument-or-fix step against the failing boundary; refuses to theorise; adds `[DEBUG-OBSERVE]` scaffolding and strips every marker before declaring a fix (no-leak). Wired into `/bkit-debug` § Failure Remediate Soak (`DEBUG_MODE` = SOAK); the orchestrator re-runs the tests and loops it within `SOAK_ATTEMPT` (`MAX_SOAK_ATTEMPT`, reset to 0 on each SOAK entry). Flat append-only `DONE`/`BLOCKED` log. |
|
|
352
354
|
| `bkit-debug-abort-handover` | Read all prior diagnose / remediate / verify logs → handover doc + `deferrals.jsonl` append. Called from build / debug / ship Failure Paths. |
|
|
353
355
|
| `bkit-debug-summary` | Read-only verdict on debug loop outcome. |
|
|
354
356
|
|
|
@@ -367,7 +369,7 @@ Canonical per-agent metadata — **single source of truth for model per agent**.
|
|
|
367
369
|
<!-- prettier-ignore -->
|
|
368
370
|
| Agent | Scope |
|
|
369
371
|
| --- | --- |
|
|
370
|
-
| `bkit-audit-generate` | Read one `docs/templates/bkit-audit-*.md` and run its probe steps against the repo. Write the filled template to `docs/audits/{YYYYMM}/{slug}.md` (`{slug}` = template basename without `bkit-audit-`). **If** that month already has this slug → `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Report = template up to `bkit:end`. Right after creating the stub it runs `bkit branches anchor-stamp --base-sha=<HEAD> --base-ref=<branch>`, so the audited commit
|
|
372
|
+
| `bkit-audit-generate` | Read one `docs/templates/bkit-audit-*.md` and run its probe steps against the repo. Write the filled template to `docs/audits/{YYYYMM}/{slug}.md` (`{slug}` = template basename without `bkit-audit-`). **If** that month already has this slug → `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Report = template up to `bkit:end`. Right after creating the stub it runs `bkit branches anchor-stamp --base-sha=<HEAD> --base-ref=<branch>`, so the audited commit and the bkit release the report came from sit in the same `bkit:anchor` block design and plan docs carry (`.bkit/workflows.md` § Anchor Block) — top of file, machine-readable, the next run reads it as the previous report's commit; an outdated release also gets a visible `Outdated bkit` line under the block, written by the stamp. The agent runs the stamp itself because audits have no orchestrator; the block is still tool-written, never hand-written. Writes only the report, `docs/failures.jsonl` rows (`workflow: "audit"`, `step: "audit-{slug}"`; one per `MEDIUM`+ finding, reusing any open row's `key` for the same problem whichever workflow wrote it, closing only open `audit-{slug}-` rows a rerun no longer finds; skipped by templates that audit the ledgers themselves, `.bkit/jsonl.md`), and the template's consumer-owned `Project Instructions` (below `bkit:end`), which it reads first and refines each run — exact commands, paths, tool gaps, corrections — so the next run starts from what this one learned; edits listed under the report's `Process Improvements` → `Project`, universal step changes proposed under `Universal`. Never results there (reports hold the series) and never text from external input (an injected directive would persist into every later run). The report's `Suggested Issues` groups findings into tracker-sized changes — one row per change landed in one go, every `MEDIUM`+ finding in exactly one row — and names each row's next step: `/bkit-design|/bkit-plan|/bkit-build|/bkit-debug` by the § When to Run rules of `.bkit/workflows.md` (restated inline, prompts are self-contained), the `.bkit/lite.md` lite workflow (`lite:build|lite:debug`) when its § When to use allows, or `manual` for a change outside the repo. The agent proposes and never files: it has no tracker access, so a person files from the table and each full workflow's related-issues scan catches an issue already open. Bash is limited to that stamp and the probes the template or its `Project Instructions` name; throwaway worktrees / remote targets removed before the report finishes. Web tools serve each template's Standards step. Pre-Flight `Permissions` probes each tool once before `Probe Steps`; a blocked call (there or in any step) never stops the run: the agent records it with its narrow allow rule, runs every step the remaining tools allow, and lists the work it could not do under `Not Checked`. Blocked calls persist in `Project Instructions` `Permissions`; the next run probes them first. `XL` tier: the longest templates run ~20 probe steps of several queries each against the repo and live systems. A missing surface is an explicit skip, not a clean finding. The final message is a fixed block shown verbatim, so the caller never paraphrases it: a machine-readable header (`Status` `COMPLETE` or `STOPPED`, report path, per-severity counts) above `<!-- verdict:end -->`, then the `Suggested Issues` table copied verbatim — rewording a row loses the grouping a person files from — plus `Not Checked`, ledger rows, `Process Improvements` and embedded directives. Every early STOP still returns that header with a `Stopped` reason. `Recommended Next Step` names which rows to file as issues (every `MEDIUM`+ row; the batched `LOW` row optional) and the highest-severity row's next step; each body follows `.bkit/trackers.md` § Issue shapes and carries an `**Audit reports:**` line with the row's finding IDs, so `/bkit-plan` reads the report; plain issues, not sub-issues, since an audit run has no parent issue; shown whether or not a tracker is wired. |
|
|
371
373
|
|
|
372
374
|
Every template under `docs/templates/bkit-audit-*.md`:
|
|
373
375
|
|
|
@@ -390,14 +392,14 @@ Every template under `docs/templates/bkit-audit-*.md`:
|
|
|
390
392
|
| `bkit-audit-database` | Database Audit | Privileges, access coverage, migrations, integrity, capacity, restore. |
|
|
391
393
|
| `bkit-audit-dead-code` | Dead Code Audit | Reachability — code, config, routes, events, schema, assets that look live and never run. |
|
|
392
394
|
| `bkit-audit-deferrals` | Deferrals Triage | Open deferral → done / superseded / tracked / parked / in-scope unfinished. |
|
|
393
|
-
| `bkit-audit-dependencies` | Dependency Triage | Dep-update PRs → one verified batch; supply-chain settings, advisories, licences, EOL. |
|
|
395
|
+
| `bkit-audit-dependencies` | Dependency Triage | Dep-update PRs → one verified batch; supply-chain settings, advisories, licences, EOL, off-manifest CLIs. |
|
|
394
396
|
| `bkit-audit-documentation` | Documentation Audit | Claim matches code, pointer lands, agent-relied fact is written down. |
|
|
395
397
|
| `bkit-audit-duplication` | Duplication Audit | One behaviour, >1 implementation — inline rules, competing mechanisms, restated types, paired decisions, bad merges. |
|
|
396
398
|
| `bkit-audit-failures` | Failures Triage | Open failure → reachable / already fixed / mis-framed / unconfirmed / repeat of a known defect. |
|
|
397
399
|
| `bkit-audit-flakes` | Flake Triage | Pass-on-retry or fail-on-one-surface; the change that removes each. |
|
|
398
400
|
| `bkit-audit-gates` | Gate Candidates | Detective sweeps → preventive gates, order, which stay audits. |
|
|
399
401
|
| `bkit-audit-issues` | Issue Prioritisation | Size + priority per open tracker issue; two rules a later run re-applies identically; board membership, parent, milestone, blocked-by links. |
|
|
400
|
-
| `bkit-audit-llm` | LLM Audit | Per model call — effect, stop on hostile input: prompts, tool bounds, output checks, limits, evals. |
|
|
402
|
+
| `bkit-audit-llm` | LLM Audit | Per model call — effect, stop on hostile input: prompts, tool bounds, output checks, job scope, limits, evals. |
|
|
401
403
|
| `bkit-audit-logs` | Log Triage | Error-tracker stream + logs it misses — real issue, wrong level, failure that never arrived. |
|
|
402
404
|
| `bkit-audit-models` | Model Audit | Call site = latest capable fit; model + fallbacks still live; one registry. |
|
|
403
405
|
| `bkit-audit-privacy` | Privacy Audit | Personal data — held, where it goes, retention, deletion removes the person, disclosure matches code. |
|
|
@@ -419,10 +421,23 @@ Every template under `docs/templates/bkit-audit-*.md`:
|
|
|
419
421
|
| `bkit-utility-update-failures` | Same over `docs/failures.jsonl`, judged on whether the bug still reproduces from the code. A flaky row closes only on a landed determinism fix, never a green run. Same `TRIAGED` promotion on an open tracker issue; a `failure` carries no `reason` field, so its `TRIAGED` rows only ever mean issue-promotion, unlike `deferral` where `bkit-ship-deferred-sweep` also writes `TRIAGED` alongside `reason` = `unjustified`. Same locator append. Ensure agent memories (`MEMORY.md` / `memory/*.md`) do not duplicate content and only contain pointers (path, section, one-line hook) to relevant `docs/*.md` sections / `docs/*.jsonl` entries. **If** memory contains duplicate / stale content → update memory. Final message is the output format verbatim. |
|
|
420
422
|
| `bkit-utility-update-decisions` | Fold `docs/decisions.jsonl` by `key`, highest `ts` wins → read only winning rows where `status` is `ACTIVE` or absent. Classify `HOLDS` / `CONTRADICTED` / `OBSOLETE` / `AMBIGUOUS` against `docs/` and the codebase. `CONTRADICTED` with one unambiguous replacement appends the corrected decision `ACTIVE`; `OBSOLETE` (nothing replaced it) appends `SUPERSEDED`. An unambiguous stale locator is folded into the same append and does not reclassify. One append per `key` per run. `AMBIGUOUS` and unresolved locators are left. Doc sentences that restate a corrected row are edited to match; implementation code is not. Ensure agent memories (`MEMORY.md` / `memory/*.md`) do not duplicate content and only contain pointers (path, section, one-line hook) to relevant `docs/*.md` sections / `docs/*.jsonl` entries. **If** memory contains duplicate / stale content → update memory. Final message is the output format verbatim. |
|
|
421
423
|
| `bkit-utility-update-knowledge` | Fold `docs/knowledge.jsonl` by `key`, highest `ts` wins → read only winning rows where `status` is `ACTIVE` or absent. Classify `HOLDS` / `CONTRADICTED` / `OBSOLETE` / `AMBIGUOUS`. An entry about upstream behaviour is never retracted from absence of local evidence. `OBSOLETE` appends same-`key` `SUPERSEDED`; `CONTRADICTED` appends the corrected lesson `ACTIVE`. Same locator append. Same doc-sentence edit; implementation code is not. Ensure agent memories (`MEMORY.md` / `memory/*.md`) do not duplicate content and only contain pointers (path, section, one-line hook) to relevant `docs/*.md` sections / `docs/*.jsonl` entries. **If** memory contains duplicate / stale content → update memory. Final message is the output format verbatim. |
|
|
422
|
-
| `bkit-utility-update-roadmap` | Rank next best steps from the board, both `## Notes` blocks, `.bkit/issues.jsonl` and open deferrals / failures. When a tracker is wired, always names the next milestone and the next distinct umbrella; a child is included only when open, unblocked, and able to start now. Those containers stay visible and enter the list only by priority, one row each, action = those children. List length is `package.json` `bkit.roadmapNext` (positive integer; absent or invalid → 25). Due audits compete by priority (risk covered first, then how overdue) for at most 3 rows. The length hint sits in the generated `roadmap-status` header. The full workflow is the default recommendation; names the `.
|
|
424
|
+
| `bkit-utility-update-roadmap` | Rank next best steps from the board, both `## Notes` blocks, `.bkit/issues.jsonl` and open deferrals / failures. When a tracker is wired, always names the next milestone and the next distinct umbrella; a child is included only when open, unblocked, and able to start now. Those containers stay visible and enter the list only by priority, one row each, action = those children. List length is `package.json` `bkit.roadmapNext` (positive integer; absent or invalid → 25). Due audits compete by priority (risk covered first, then how overdue) for at most 3 rows. The length hint sits in the generated `roadmap-status` header. The full workflow is the default recommendation; names the `.bkit/lite.md` lite workflow (`lite:<phase>`) only where it is clearly enough. An item with no tracker issue (ledger row, due audit) gets a file-an-issue-first recommendation, shaped per `.bkit/trackers.md` § Issue shapes, when a tracker is wired. Rewrites ONLY the `roadmap-analysis` block. |
|
|
423
425
|
| `bkit-utility-compress-markdown` | Token-optimize a single markdown file; preserve 100 % load-bearing tokens. **Destructive** (overwrites target). |
|
|
424
426
|
| `bkit-utility-update-documentation` | Sync every doc in `.agents/docs.md` with system state — drift cleanup across multiple plans. Ensure agent memories (`MEMORY.md` / `memory/*.md`) do not duplicate content and only contain pointers (path, section, one-line hook) to relevant `docs/*.md` sections / `docs/*.jsonl` entries. **If** memory contains duplicate / stale content → update memory. |
|
|
425
427
|
|
|
428
|
+
## Hook-injected text
|
|
429
|
+
|
|
430
|
+
Text hooks add to an agent's context mid-run — every agent and subagent, no frontmatter opt-out. Canonical wording lives in the engine file; per-host delivery → `.bkit/providers.md` § Guardrails, § GateGuard, § ReadGuard.
|
|
431
|
+
|
|
432
|
+
<!-- prettier-ignore -->
|
|
433
|
+
| Hook | Fires on | Injects | Hosts | Canonical text |
|
|
434
|
+
| --- | --- | --- | --- | --- |
|
|
435
|
+
| GateGuard | First edit per (session, agent, file) | First touch → investigation checklist (file read, callers, symbols, contracts, conventions, instructions quoted); new file → reuse-over-duplicate checklist; gate-config path → fix-code-not-gate advisory; `docs/**.md` (not `docs/plans/`) → density advisory appended | All five | `.bkit/core/hooks/gateguard-engine.js` |
|
|
436
|
+
| ReadGuard | Repeat read of an unchanged line range, same agent | Use-earlier-output note; re-read only if the output left context | All five | `.bkit/core/hooks/readguard-engine.js` |
|
|
437
|
+
| Guardrails | Shell edit (`sed -i`, redirect into a source file); unlisted `curl` / `wget` host on Claude, Codex; Codex ask tier | Advisory naming the bypassed gate; command still runs | Claude, Cursor, Codex, Antigravity | `.bkit/core/hooks/guardrails-shell.js`, `.bkit/core/hooks/guardrails-tiers.js` |
|
|
438
|
+
|
|
439
|
+
- **Never a must-do:** hook text is advisory and fail-open; it never fires on an untrusted Codex `.codex/` layer and arrives after the edit on opencode. A prompt instruction that must hold stays in the prompt.
|
|
440
|
+
|
|
426
441
|
## Special Behaviors (frontmatter-adjacent contracts)
|
|
427
442
|
|
|
428
443
|
<!-- prettier-ignore -->
|