@cbartens/bkit 6.0.0 → 6.1.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 +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +282 -176
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
<p align="center">
|
|
2
2
|
<picture>
|
|
3
3
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-hero-dark.svg">
|
|
4
|
-
<img alt="bkit
|
|
4
|
+
<img alt="bkit: not just another agent framework. Most frameworks have some of these, bkit is the only one with all of them: reviewers who didn’t write it, your sign-off, “done” checked by code, lessons the next run reads, audits that find the gaps and CI that keeps agents honest." src=".github/assets/bkit-hero-light.svg" width="100%">
|
|
5
5
|
</picture>
|
|
6
6
|
</p>
|
|
7
7
|
|
|
@@ -10,18 +10,21 @@
|
|
|
10
10
|
<a href="https://www.npmjs.com/package/@cbartens/bkit"><img alt="npm version" src="https://img.shields.io/npm/v/@cbartens/bkit"></a>
|
|
11
11
|
<a href="#license"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-blue"></a>
|
|
12
12
|
<img alt="Node 24+" src="https://img.shields.io/badge/node-%E2%89%A524-339933">
|
|
13
|
-
<img alt="Works with Claude
|
|
13
|
+
<img alt="Works with Claude, Codex, Antigravity, Cursor and OpenCode" src="https://img.shields.io/badge/works%20with-Claude%20%C2%B7%20Codex%20%C2%B7%20Antigravity%20%C2%B7%20Cursor%20%C2%B7%20OpenCode-8250df">
|
|
14
14
|
</p>
|
|
15
15
|
|
|
16
16
|
<p align="center">
|
|
17
|
+
<a href="#quick-start">Quick start</a> ·
|
|
17
18
|
<a href="#how-it-works">How it works</a> ·
|
|
19
|
+
<a href="#models">Models</a> ·
|
|
18
20
|
<a href="#why-its-different">Why it's different</a> ·
|
|
19
|
-
<a href="#
|
|
21
|
+
<a href="#engine">Engine</a> ·
|
|
22
|
+
<a href="#knowledge">Knowledge store</a> ·
|
|
20
23
|
<a href="#audits">Audits</a> ·
|
|
21
24
|
<a href="#templates">Templates</a> ·
|
|
22
25
|
<a href="#token-costs">Token costs</a> ·
|
|
23
|
-
<a href="#
|
|
24
|
-
<a href="#
|
|
26
|
+
<a href="#measurements">Measurements</a> ·
|
|
27
|
+
<a href="#faq">FAQ</a>
|
|
25
28
|
</p>
|
|
26
29
|
|
|
27
30
|
<p align="center">
|
|
@@ -45,12 +48,14 @@ AI agents design it, plan it, build it, have it reviewed by agents that didn't w
|
|
|
45
48
|
|
|
46
49
|
**It ships what other frameworks leave to you:** a full CI pipeline for your project (none of the frameworks in [our comparison](.bkit/comparison.md#frameworks) has one), and 35 [audits](#audits) that find the bugs passing tests miss.
|
|
47
50
|
|
|
48
|
-
**Researched and battle-tested, not a weekend prompt pack.** bkit is built with bkit: months of research into how agentic engineering works best, refined over **
|
|
51
|
+
**Researched and battle-tested, not a weekend prompt pack.** bkit is built with bkit: months of research into how agentic engineering works best, refined over **2,000+ commits, 300+ issues and 100+ merged pull requests** run through its own pipeline. Along the way it recorded **300+ lessons and 600+ decisions**. They shaped the rules and prompts you install, and your own repo starts its own record from the first feature.
|
|
52
|
+
|
|
53
|
+
**Every file bkit gives your agents to read follows Anthropic's, OpenAI's and Google's own prompting advice:** prompts, workflows, rules and project docs are all written to one set of [writing rules](.bkit/authoring.md), [matched practice by practice](.bkit/authoring.md#who-says-what) against each maker's current guide, so the same text works on Claude, GPT and Gemini. The [prompt audit](.bkit/pipeline.md#audits) checks every one of those files against it, and every one passes.
|
|
49
54
|
|
|
50
55
|
<p align="center">
|
|
51
56
|
<picture>
|
|
52
57
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-features-dark.svg">
|
|
53
|
-
<img alt="What ships with bkit
|
|
58
|
+
<img alt="What ships with bkit: four features for each phase (design, plan, build, debug, ship) and four that apply to every phase." src=".github/assets/bkit-features-light.svg" width="100%">
|
|
54
59
|
</picture>
|
|
55
60
|
</p>
|
|
56
61
|
|
|
@@ -63,15 +68,16 @@ Everything a senior team would otherwise write down over years, in files you can
|
|
|
63
68
|
<!-- prettier-ignore -->
|
|
64
69
|
| What | How many | What it does for you |
|
|
65
70
|
| --- | --- | --- |
|
|
66
|
-
| [Agents](.bkit/prompts.md) | 40
|
|
71
|
+
| [Agents](.bkit/prompts.md) | 40 | Single-job specialists, each with its own model, thinking depth and tool list. A reviewer can read code but can't change it. |
|
|
67
72
|
| [Workflows](.bkit/workflows.md) | 6 | The five phases plus a cloud router. Every step ends in a checklist and a mechanical check before the next one starts. |
|
|
68
73
|
| [Agent rules](.agents/rules.md) | 70+ | One rulebook every agent follows: read before editing, never defer silently, report honestly, never rewrite history. |
|
|
74
|
+
| [Writing rules](.bkit/authoring.md) | 50+ | How every prompt, workflow, rule and doc is worded, [matched practice by practice](.bkit/authoring.md#who-says-what) against Anthropic's, OpenAI's and Google's prompting guides, so one text works on every model. |
|
|
69
75
|
| [Guardrails](.bkit/providers.md#guardrails) | 10+ hook files | Block dangerous commands and secret reads, and make agents investigate before they edit, on all five AI tools. |
|
|
70
76
|
| [Audits](.bkit/pipeline.md#audits) | 35 | Security, privacy, accessibility, performance, reliability, database, LLM usage, cost and more. Findings feed straight into a plan. |
|
|
71
77
|
| [Project docs](.bkit/shared/docs/) | 10 + [index](.agents/docs.md) | Architecture, data schema, deployments, testing, security, monitoring, design system, tech stack, setup, and an index telling each agent what to read at each step. |
|
|
72
|
-
| [Templates](.bkit/templates.md) | 60+ | A full CI pipeline, cloud agents, git hooks, linters, dependency updates, secrets sync, code search, and 10+ ready-made connectors for your platforms. |
|
|
78
|
+
| [Templates](.bkit/templates.md) | 60+ | A full CI pipeline, cloud agents, git hooks, linters, dependency updates, secrets sync, code search, a map of your code that marks likely problems, and 10+ ready-made connectors for your platforms. |
|
|
73
79
|
|
|
74
|
-
**These are the files your agents read, so they're written for agents
|
|
80
|
+
**These are the files your agents read, so they're written for agents,** to the writing rules above: short, dense, tables over prose. For day-to-day use, start with [`.bkit/README.md`](.bkit/README.md); for every agent in the order it runs, see the [pipeline reference](.bkit/pipeline.md).
|
|
75
81
|
|
|
76
82
|
<a id="how-it-works"></a>
|
|
77
83
|
|
|
@@ -80,7 +86,7 @@ Everything a senior team would otherwise write down over years, in files you can
|
|
|
80
86
|
<p align="center">
|
|
81
87
|
<picture>
|
|
82
88
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-pipeline-dark.svg">
|
|
83
|
-
<img alt="The bkit pipeline: design, plan, build and ship, with debug fixing failed tests.
|
|
89
|
+
<img alt="The bkit pipeline: design, plan, build and ship, with debug fixing failed tests. 30 agents across the five phases, and your sign-off after design, after plan and before merge." src=".github/assets/bkit-pipeline-light.svg" width="100%">
|
|
84
90
|
</picture>
|
|
85
91
|
</p>
|
|
86
92
|
|
|
@@ -92,11 +98,20 @@ Everything a senior team would otherwise write down over years, in files you can
|
|
|
92
98
|
| Work out how to build it | [`/bkit-design`](.bkit/pipeline.md#bkit-design) | Reads related issues and past decisions. Three agents propose different approaches, two critique them, and throwaway code tests any risky unknown the reviewers flag. **You approve one design.** |
|
|
93
99
|
| Plan the work | [`/bkit-plan`](.bkit/pipeline.md#bkit-plan) | A plan of small, self-contained tasks, each naming the code it touches and the test that proves it's done. Two reviewers and a scope check go over it in one round, with past bugs and postponed work in view. **You approve it.** |
|
|
94
100
|
| Build it | [`/bkit-build`](.bkit/pipeline.md#bkit-build) | Checks the plan still matches the code, then builds it one group of tasks at a time, each with a fresh agent: tests first, then code, then an independent check. Hunts for bugs and security holes (only security holes on a small change), fixes what it finds as more tasks, and opens a pull request. |
|
|
101
|
+
| Build it, hold the push | `/bkit-build #N publish=false` | The same build, stopped before the push: no pull request, no CI, the worktree and branch kept. `/bkit-ship <ref>` lands it later. |
|
|
95
102
|
| Fix what broke | [`/bkit-debug`](.bkit/pipeline.md#bkit-debug) | Pulls evidence from CI and your platforms, fixes the root cause, re-tests and records the lesson. Hard runtime bugs get their own mode; if it can't fix something, it stops and writes you a clear handover. |
|
|
96
103
|
| Ship it | [`/bkit-ship`](.bkit/pipeline.md#bkit-ship) | Checks nothing planned was quietly dropped, waits for every test lane to pass, merges into `dev` and updates the docs. |
|
|
97
|
-
| Small, clearly safe change | [`*:lite`](.bkit/lite.md) | One prompt to paste per phase (`design:lite` to `ship:lite`). The agent keeps only the steps and reviewers the change needs and works on the current branch: no separate repo copy, pull request, CI or sign-off stops. Never for schema changes, public APIs, dependencies, secrets, auth or large refactors. |
|
|
98
104
|
| Health check | [35 audits](#audits) | One specialist checklist per area. Findings feed straight into `/bkit-plan`. |
|
|
99
|
-
| Housekeeping |
|
|
105
|
+
| Housekeeping | 8 utility agents | Keep docs, decisions, lessons and known bugs current, and rank what to work on next. |
|
|
106
|
+
|
|
107
|
+
**Build now, publish later.** `/bkit-build #N` builds and publishes: it pushes `feat/{FID}`, opens the pull request and starts CI. `/bkit-build #N publish=false` builds locally and holds. The same plan, tests-first checks and bug hunt run, but nothing is pushed, no pull request is opened and no CI starts. The worktree and branch stay, the lock is released, the issue moves to `In review` with a "built locally, not published" comment, and the summary reads `Publish: held` and `Docs: not synced`. `/bkit-ship <ref>` later lands a held build end to end. To make holding the default on your machine, set `bkit.workflows.build.publish.local` to `false` in `package.json`. Cloud runs always publish: `publish.remote` accepts only `true`, and `publish=false` on a cloud run is turned back into `true` with a warning.
|
|
108
|
+
|
|
109
|
+
<a id="batch-recipe"></a>
|
|
110
|
+
|
|
111
|
+
**Batch recipe (manual).** To land several held builds in one go, build each with `publish=false`, then land them yourself with `git`: merge the held `feat/{FID}` branches into one branch off `dev`, push it, open one pull request and let CI run. bkit has no batch command, and you own the push, the PR, the CI gate, the sweep and the docs sync, because `/bkit-ship` does none of them for a batch. Two limits apply:
|
|
112
|
+
|
|
113
|
+
- One head commit: post-merge auto-debug sees only the last FID, so a failure from an earlier build in the batch is not routed to its own issue.
|
|
114
|
+
- Never batch migrations: a batch applies them together, and one bad migration blocks every build in it.
|
|
100
115
|
|
|
101
116
|
Every agent in each phase, in the order it runs and what it checks: [pipeline reference](.bkit/pipeline.md#pipeline-map). Every step, verdict and contract: [`.bkit/workflows.md`](.bkit/workflows.md).
|
|
102
117
|
|
|
@@ -104,39 +119,40 @@ Every agent in each phase, in the order it runs and what it checks: [pipeline re
|
|
|
104
119
|
|
|
105
120
|
## Which model does each job
|
|
106
121
|
|
|
107
|
-
**
|
|
122
|
+
**Spend the subscriptions you already pay for first; when their weekly usage runs out, OpenCode on OpenRouter carries the work.** Inside a subscription — Claude, Codex, Antigravity, Cursor — each agent gets the model from that vendor that gets the most work out of the usage you have paid for. On OpenCode, which bills per token, Claude sets the bar: each agent gets the cheapest model that comes closest to it, under a weekly cap. You don't pick: install sets each agent's model.
|
|
108
123
|
|
|
109
124
|
<p align="center">
|
|
110
125
|
<picture>
|
|
111
126
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-models-dark.svg">
|
|
112
|
-
<img alt="
|
|
127
|
+
<img alt="The Claude model and effort behind each bkit agent: Opus 5.5 for /bkit-design, /bkit-plan, /bkit-debug and 27 agents; Sonnet 5.5 for /bkit-build, /bkit-ship and 12 agents. Pick the model at launch and leave the effort alone." src=".github/assets/bkit-models-light.svg" width="100%">
|
|
113
128
|
</picture>
|
|
114
129
|
</p>
|
|
115
130
|
|
|
116
|
-
**How the picks are made.**
|
|
131
|
+
**How the picks are made.** Two different questions, one table. **Subscription tools** — Claude, Codex, Antigravity, Cursor — are paid for up front, so each agent gets the best model that vendor's plan includes for its job: depth where the reasoning is, cheaper rungs where the work is volume, spending the included usage where it buys most. They are never imitations of another vendor. **OpenCode gateways** — OpenRouter, Ollama, OpenCode Zen, OpenCode Go — bill per token, so Claude is the yardstick there: each agent gets the cheapest model that comes closest to the Claude model it would run on, within budget. OpenRouter is the overflow for when the subscription's weekly usage is spent. Its default runs almost everything on DeepSeek and puts `gpt-6.1-sol` on the four checks where a miss would ship unnoticed. Covering a two-day gap that way costs about **US$52**, roughly a quarter of a US$200-a-month Claude Max plan, or about one week's share of it. Option 2 in [Model Presets](.bkit/prompts.md#model-presets) doubles the weekly budget to about US$100 for work that matters more than the cost. Every score is from the public LiveBench 2.0 benchmark, **Long Agentic** category, release 2026-10-25, so rows stay comparable; v1's Agentic Coding category is retired and does not convert.
|
|
117
132
|
|
|
118
133
|
<!-- prettier-ignore -->
|
|
119
134
|
| Tool | Hardest jobs: design, plans, reviews, security, audits | Everyday jobs: writing code and docs, the second model in each review pair |
|
|
120
135
|
| --- | --- | --- |
|
|
121
|
-
| Claude
|
|
122
|
-
|
|
|
123
|
-
|
|
|
124
|
-
|
|
|
125
|
-
|
|
|
126
|
-
|
|
|
127
|
-
|
|
|
128
|
-
|
|
|
136
|
+
| Claude | `claude-opus-5-5` · bar **72.8** | `claude-sonnet-5-5` · bar **63.4** |
|
|
137
|
+
| Codex | `gpt-6-astra` · 77.5; `gpt-6.1-sol` · 68.7 for the builders | `gpt-6.1-sol` · 68.7 |
|
|
138
|
+
| Antigravity | `gemini-4-argon` · 61.2 | `gemini-4-argon` · 61.2 |
|
|
139
|
+
| Cursor | `cursor-grok-4.5-high` · not measured | `composer-2.5` · not measured |
|
|
140
|
+
| OpenCode + OpenRouter | `deepseek/deepseek-v4.1-flash-1017` · 40.9; `openai/gpt-6.1-sol` · 68.7 for the four key gates | `deepseek/deepseek-v4.1-flash-1017` · 40.9 |
|
|
141
|
+
| OpenCode + Ollama | `deepseek-v4.1-flash:1017` · 40.9 | `deepseek-v4.1-flash:1017` · 40.9 |
|
|
142
|
+
| OpenCode + OpenCode Zen | `deepseek-v4.1-flash` · not measured; `gpt-6.1-sol` · 68.7 for the four key gates | `deepseek-v4.1-flash` · not measured |
|
|
143
|
+
| OpenCode + OpenCode Go | `deepseek-v4.1-flash` · not measured; `gemini-4-argon` · 61.2 for the four key gates | `deepseek-v4.1-flash` · not measured |
|
|
129
144
|
|
|
130
145
|
**Reading the table:**
|
|
131
146
|
|
|
132
|
-
- **
|
|
133
|
-
- **
|
|
134
|
-
- **
|
|
135
|
-
- **
|
|
136
|
-
- **
|
|
137
|
-
- **
|
|
147
|
+
- **Every score comes from the same benchmark.** `claude-opus-5-5` scores **72.8** and `claude-sonnet-5-5` **63.4** on Long Agentic: the bars every OpenCode pick is measured against.
|
|
148
|
+
- **Four key gates get the strongest model the budget carries.** These are the checks where a miss reaches the merge unnoticed: `bkit-build-plan-verify` (decides a build is done), `bkit-ship-deferred-sweep` (last check before merge), `bkit-debug-failure-diagnose` (picks the root cause the fix chases) and `bkit-build-challenge-2` (the security review). On OpenCode that is `gpt-6.1-sol` on OpenRouter and Zen, `gemini-4-argon` on Go, which has no Sol, and DeepSeek on Ollama, which has nothing stronger.
|
|
149
|
+
- **DeepSeek thinks at its maximum on every OpenCode agent**, because it sits under the Claude bar. `gpt-6.1-sol` already sits near the bar, so it keeps the agent's own Claude effort: effort only goes as high as it takes to get close to Claude, never past it.
|
|
150
|
+
- **On Cursor, bkit pins Cursor's own models**, the ones its plan includes: `cursor-grok-4.5-high` and `composer-2.5`. Neither is measured on LiveBench 2.0 — the catalogue offers no Grok 4.6/4.7 and no Opus 5.5 / Sonnet 5.5, re-probed 2026-10-28. Claude and GPT models in Cursor spend paid API credits, so they're opt-in through [Model Overrides](.bkit/prompts.md#model-overrides).
|
|
151
|
+
- **"Not measured" means LiveBench 2.0 hasn't scored that model.** Those Cursor picks follow each vendor's own description of the model. Check them before you rely on them.
|
|
152
|
+
- **Ollama needs a paid plan for every column.** The free models are not scored.
|
|
153
|
+
- **Want a different model for one agent?** On Cursor and OpenCode, add a row to [Model Overrides](.bkit/prompts.md#model-overrides) and run `bkit install` again. Every agent with its model and thinking depth: [`.bkit/prompts.md` § Models](.bkit/prompts.md#models).
|
|
138
154
|
|
|
139
|
-
**On Claude
|
|
155
|
+
**On Claude, each agent also sets its own effort**, so the effort you leave your session on never changes theirs. Start each `/bkit-*` command on the model the picture above shows and leave effort at the default. Session setup in full: [`.bkit/prompts.md` § Orchestrators](.bkit/prompts.md#orchestrators-slash-commands).
|
|
140
156
|
|
|
141
157
|
<a id="why-its-different"></a>
|
|
142
158
|
|
|
@@ -145,7 +161,7 @@ Every agent in each phase, in the order it runs and what it checks: [pipeline re
|
|
|
145
161
|
<p align="center">
|
|
146
162
|
<picture>
|
|
147
163
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-fences-dark.svg">
|
|
148
|
-
<img alt="
|
|
164
|
+
<img alt="AI agents start out scattered and are funnelled phase by phase into production-grade code, fenced in first by reviewer agents and then by automated checks, with your sign-off at three points." src=".github/assets/bkit-fences-light.svg" width="100%">
|
|
149
165
|
</picture>
|
|
150
166
|
</p>
|
|
151
167
|
|
|
@@ -158,7 +174,7 @@ Every agent in each phase, in the order it runs and what it checks: [pipeline re
|
|
|
158
174
|
<p align="center">
|
|
159
175
|
<picture>
|
|
160
176
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-fences-details-dark.svg">
|
|
161
|
-
<img alt="
|
|
177
|
+
<img alt="The six checks every change passes, nearest first: code search, agent hooks, step gates, the pre-commit hook, the pre-push hook and CI, and where each workflow meets them." src=".github/assets/bkit-fences-details-light.svg" width="100%">
|
|
162
178
|
</picture>
|
|
163
179
|
</p>
|
|
164
180
|
|
|
@@ -184,12 +200,12 @@ The agent hooks come with install. Serena, graphify and the git hooks are [templ
|
|
|
184
200
|
|
|
185
201
|
### The CI pipeline
|
|
186
202
|
|
|
187
|
-
**
|
|
203
|
+
**bkit ships a full test pipeline for your project, ready to adopt:**
|
|
188
204
|
|
|
189
205
|
<p align="center">
|
|
190
206
|
<picture>
|
|
191
207
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-ci-dark.svg">
|
|
192
|
-
<img alt="bkit
|
|
208
|
+
<img alt="bkit’s CI pipeline, from planning the run to tidying up. Every lane feeds one final check, which fails if any lane failed, was skipped or ran no tests." src=".github/assets/bkit-ci-light.svg" width="100%">
|
|
193
209
|
</picture>
|
|
194
210
|
</p>
|
|
195
211
|
|
|
@@ -201,24 +217,70 @@ The agent hooks come with install. Serena, graphify and the git hooks are [templ
|
|
|
201
217
|
|
|
202
218
|
How the lanes join into the one final check, and what happens on green or red: [CI test scaffold](.bkit/pipeline.md#ci-scaffold).
|
|
203
219
|
|
|
220
|
+
<a id="engine"></a>
|
|
221
|
+
|
|
222
|
+
## Code keeps every run on track
|
|
223
|
+
|
|
224
|
+
<p align="center">
|
|
225
|
+
<picture>
|
|
226
|
+
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-engine-dark.svg">
|
|
227
|
+
<img alt="One /bkit-build run in three layers: agents make the judgement calls, bkit commands do the bookkeeping, and your repo holds the plain files both read and write." src=".github/assets/bkit-engine-light.svg" width="100%">
|
|
228
|
+
</picture>
|
|
229
|
+
</p>
|
|
230
|
+
|
|
231
|
+
**CI checks the code agents write; the engine checks the run itself.** Agents are good at judgement, not bookkeeping. Ask a model to count fix rounds, confirm a test failed before its code existed, or remember where a stopped run left off, and it can get it wrong, and differently on each tool. bkit doesn't ask. Anything with one right answer is a `bkit` command, plain TypeScript covered by 5,800+ tests, and the agents keep only the calls that need judgement.
|
|
232
|
+
|
|
233
|
+
- **Steps that can't be faked.** A step can't finish until `bkit steps gate` finds its verdict and files, whatever the agent reports. A test counts as written first only once `bkit tests red` has seen it fail before its code existed.
|
|
234
|
+
- **Limits no answer can raise.** `bkit counters route` counts fix rounds and stops at the limit set under `bkit.workflows` in `package.json` (2 attempts by default), however sure the agent is.
|
|
235
|
+
- **The same answer on every tool.** Where a stopped run resumes, what goes in a ledger row and what each agent's brief holds are worked out by code, so Claude, Codex, Antigravity, Cursor and OpenCode run the same steps the same way.
|
|
236
|
+
- **Fewer tokens, as a bonus.** No model turn is spent on bookkeeping, and each build agent starts on a brief of a few KB instead of the whole plan ([spending fewer tokens](#token-costs)).
|
|
237
|
+
|
|
238
|
+
<a id="knowledge"></a>
|
|
204
239
|
<a id="memory"></a>
|
|
205
240
|
|
|
206
|
-
##
|
|
241
|
+
## Knowledge store that writes itself
|
|
207
242
|
|
|
208
243
|
<p align="center">
|
|
209
244
|
<picture>
|
|
210
245
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-context-dark.svg">
|
|
211
|
-
<img alt="
|
|
246
|
+
<img alt="Where bkit keeps each kind of fact, in your repo or on your tracker, CI and runtime platforms, and which step reads or writes it." src=".github/assets/bkit-context-light.svg" width="100%">
|
|
212
247
|
</picture>
|
|
213
248
|
</p>
|
|
214
249
|
|
|
215
|
-
**
|
|
250
|
+
**Each kind of fact has one home**, in a plain file in your repo or a comment on your tracker issue. Agents read them directly, the way you do, and write back as they work. Lessons from fixes, decisions and the reasons behind them, work consciously postponed, known bugs, doc updates, tracker comments — the store accrues as the project runs, and every change arrives through git.
|
|
216
251
|
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
-
|
|
252
|
+
**Outside evidence, fetched when it's needed, not kept.** Design searches the web for feasibility. Debug pulls failed CI logs, the diff since the last green run, end-to-end reports and runtime errors. 10+ ready-made connectors cover GitHub, Sentry, Vercel, Supabase, Stripe, Expo, Playwright, Maestro, Inngest, Resend, Cloud Run, Tavily web search and Serena, each easy to customise, extend or leave out. Each fetches only the window, severity and fields it needs and tail-bounds what it returns, so a debug run reads lines rather than megabytes. A connector that isn't set up is reported as such, never read as "all clear".
|
|
253
|
+
|
|
254
|
+
**Where every kind of fact lives, who writes it, when the next step reads it:**
|
|
255
|
+
|
|
256
|
+
<!-- prettier-ignore -->
|
|
257
|
+
| Kind of fact | Lives in | Written by | Read at |
|
|
258
|
+
| --- | --- | --- | --- |
|
|
259
|
+
| What the project is | `docs/*.md`: architecture, security, testing, deployments, data schema, observability, technology, design | Agents fill them in as they work; `/bkit-ship` updates them after every feature | Every step, per the [docs index](.agents/docs.md) |
|
|
260
|
+
| Lessons from fixes | `docs/knowledge.jsonl` | `/bkit-debug` on root cause; a utility agent closes rows the code has since contradicted | `/bkit-debug` first; plan reviewers |
|
|
261
|
+
| Decisions and reasons | `docs/decisions.jsonl` | `/bkit-design` and `/bkit-plan`; a utility agent corrects contradicted ones | `/bkit-design`, `/bkit-plan` |
|
|
262
|
+
| Work consciously postponed | `docs/deferrals.jsonl` | Any phase that defers; a utility agent closes done ones | Plan reviewers; `/bkit-ship` checks nothing was quietly dropped |
|
|
263
|
+
| Known bugs | `docs/failures.jsonl` | `/bkit-debug`; a utility agent closes fixed ones | Plan reviewers |
|
|
264
|
+
| A feature's running record | Tracker issue comments (GitHub, Linear or Jira) | Every step appends one new comment and never edits older ones | Every step reads the whole issue; design, plan and debug also search other issues, closed ones included |
|
|
265
|
+
| Audit findings | `docs/audits/{YYYYMM}/` | `@bkit-audit-generate` | `/bkit-plan` when fixing |
|
|
266
|
+
| Run state and stats | `.bkit/status.jsonl`, `.bkit/stats.jsonl` | The engine, after every step | `bkit` on resume (any tool); `bkit stats` for your own numbers |
|
|
267
|
+
|
|
268
|
+
**Here's one run working through it** — a feature building _"Add password reset"_ (issue #123), with the exact file each phase draws from and the exact row it leaves behind:
|
|
269
|
+
|
|
270
|
+
<p align="center">
|
|
271
|
+
<picture>
|
|
272
|
+
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-knowledge-flow-dark.svg">
|
|
273
|
+
<img alt="One run on issue #123, “Add password reset”: the file each phase reads and the row or doc it writes back." src=".github/assets/bkit-knowledge-flow-light.svg" width="100%">
|
|
274
|
+
</picture>
|
|
275
|
+
</p>
|
|
276
|
+
|
|
277
|
+
**It's not a knowledge graph.** No nodes and edges, no embeddings, no retrieval service to keep running. The strength is the opposite — boring files, append-only ledgers, one home per fact:
|
|
278
|
+
|
|
279
|
+
- **You can read it.** Open any `.md` or `.jsonl` and see exactly what's there. No reconstruction from vectors, no "ask the graph" step.
|
|
280
|
+
- **Every change lands as a diff.** New lessons, decisions and doc updates arrive through git: review, blame, revert. A wrong fact is corrected the same way a wrong line of code is.
|
|
281
|
+
- **The "why" has a timestamp.** Ledger rows are append-only with a date and a reason, so you can replay how an opinion changed. A graph node loses that unless you build an audit layer yourself.
|
|
282
|
+
- **The agent writes to it in the same loop it works in.** Most "AI knowledge" setups are read-only from the model's side; bkit's agents update docs and ledgers as part of normal work, and utility agents close the rows the code has since contradicted. bkit skips its own tracker comments when it reads, so agents act on what people wrote, not on what the last agent said.
|
|
283
|
+
- **Nothing to run.** No index to rebuild, no embeddings to refresh, no service to fail. The agent's file reading is the lookup.
|
|
222
284
|
|
|
223
285
|
<a id="audits"></a>
|
|
224
286
|
|
|
@@ -227,7 +289,7 @@ How the lanes join into the one final check, and what happens on green or red: [
|
|
|
227
289
|
<p align="center">
|
|
228
290
|
<picture>
|
|
229
291
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-audits-dark.svg">
|
|
230
|
-
<img alt="
|
|
292
|
+
<img alt="A map of an app whose tests were all passing, marking the bugs that two of bkit’s 35 audit templates found anyway." src=".github/assets/bkit-audits-light.svg" width="100%">
|
|
231
293
|
</picture>
|
|
232
294
|
</p>
|
|
233
295
|
|
|
@@ -271,11 +333,102 @@ The ones that matter most, in the order to adopt them:
|
|
|
271
333
|
| **Cloud agents** | When CI finishes, a cloud agent picks up: ship on green, debug on red. No laptop needed. |
|
|
272
334
|
| **Context connectors** | `/bkit-debug` reads the real errors instead of guessing from the code: 10+ ready-made connectors for CI, error trackers, hosting, databases, payments, email, queues and the web. |
|
|
273
335
|
| **Secrets sync** | Keeps every password and key the same everywhere: one local file, one command to push it to Vercel, GitHub Actions, Google Cloud, Supabase, Expo and Cursor's cloud agents, another to prove every copy matches without printing a value. Prevents "works for me, broken in production". |
|
|
274
|
-
| **graphify** |
|
|
336
|
+
| **graphify** | Draws your code as a map (`docs/capabilities.md`), so agents check what already exists before building it again. The map marks likely problems in red, and the check fails when the map falls behind the code ([bkit's own map below](#code-map)). |
|
|
275
337
|
| **Dependency updates** | Small, grouped update pull requests from Renovate or Dependabot instead of one big risky upgrade later. GitHub Actions stay pinned, and security fixes skip the queue. |
|
|
276
338
|
| **Security scan** | Trivy fails the check when a change adds a known-vulnerable library in any language, a risky container or cluster setting, or a committed password. A daily run catches problems that have no fix yet, which an updater never shows. |
|
|
277
339
|
| **Audits** | 35 specialist checklists, one per area: testing, security, privacy, reliability, cost and more. Already installed in `docs/templates/`, so there's nothing to copy: name one to `@bkit-audit-generate` and hand its report to `/bkit-plan` ([above](#audits)). |
|
|
278
340
|
|
|
341
|
+
<a id="code-map"></a>
|
|
342
|
+
|
|
343
|
+
**See your code as a map, with likely problems marked in red.** This is the map graphify draws of bkit's own engine, and the same template draws yours. Each box is one part of the code, and parts that share a folder sit in one bigger box. An arrow means one part uses another; its number counts the links between them, and the more links, the thicker the arrow.
|
|
344
|
+
|
|
345
|
+
**A red dashed box is an open finding:** a part where graphify found a likely problem. Some code may skip the module that owns a job, two copies of one job may compete, a job may have no owner yet, or a call may go to an API route that nothing serves. Each kind has its own dash pattern. The box counts its findings, and [`docs/capabilities.md`](docs/capabilities.md) names each one. An amber box is one somebody has looked at and accepted, and the check fails if the number of exceptions changes. The map is generated: `pnpm bkit:graph:refresh` redraws it from the code, and the check fails if this copy falls behind. The full map, one level down, is in [`docs/capabilities.md`](docs/capabilities.md).
|
|
346
|
+
|
|
347
|
+
<!-- graph:packages:start -->
|
|
348
|
+
|
|
349
|
+
```mermaid
|
|
350
|
+
---
|
|
351
|
+
config:
|
|
352
|
+
layout: elk
|
|
353
|
+
themeCSS: "marker { overflow: visible; } marker path { transform: scale(1.8); transform-origin: 5px 5px; }"
|
|
354
|
+
flowchart:
|
|
355
|
+
useMaxWidth: false
|
|
356
|
+
---
|
|
357
|
+
flowchart LR
|
|
358
|
+
%% Generated by bkit-graphify-rollup.py — do not edit
|
|
359
|
+
subgraph gn_bkit_core_engine[".bkit/core/engine"]
|
|
360
|
+
n_bkit_core_engine_checks["checks<br/>251 symbols · 18 files"]
|
|
361
|
+
n_bkit_core_engine_cli["cli<br/>33 symbols · 1 files"]
|
|
362
|
+
n_bkit_core_engine_commands["commands<br/>1694 symbols · 51 files"]
|
|
363
|
+
n_bkit_core_engine_install["install<br/>308 symbols · 20 files"]
|
|
364
|
+
n_bkit_core_engine_ledgers["ledgers<br/>184 symbols · 6 files"]
|
|
365
|
+
n_bkit_core_engine_render["render<br/>62 symbols · 4 files"]
|
|
366
|
+
n_bkit_core_engine_shared["shared<br/>150 symbols · 13 files<br/>1 open finding"]
|
|
367
|
+
end
|
|
368
|
+
nscripts_harvest["scripts/harvest<br/>199 symbols · 2 files"]
|
|
369
|
+
n_bkit_core_engine_commands -->|385| n_bkit_core_engine_shared
|
|
370
|
+
n_bkit_core_engine_commands -->|364| n_bkit_core_engine_ledgers
|
|
371
|
+
n_bkit_core_engine_commands -->|204| n_bkit_core_engine_install
|
|
372
|
+
n_bkit_core_engine_install -->|170| n_bkit_core_engine_shared
|
|
373
|
+
n_bkit_core_engine_checks -->|131| n_bkit_core_engine_shared
|
|
374
|
+
n_bkit_core_engine_commands -->|83| n_bkit_core_engine_checks
|
|
375
|
+
n_bkit_core_engine_install -->|61| n_bkit_core_engine_render
|
|
376
|
+
n_bkit_core_engine_checks -->|56| n_bkit_core_engine_install
|
|
377
|
+
n_bkit_core_engine_commands -->|42| n_bkit_core_engine_render
|
|
378
|
+
n_bkit_core_engine_cli -->|34| n_bkit_core_engine_commands
|
|
379
|
+
n_bkit_core_engine_checks -->|18| n_bkit_core_engine_commands
|
|
380
|
+
n_bkit_core_engine_ledgers -->|17| n_bkit_core_engine_shared
|
|
381
|
+
n_bkit_core_engine_shared -->|15| n_bkit_core_engine_install
|
|
382
|
+
n_bkit_core_engine_commands -->|15| n_bkit_core_engine_cli
|
|
383
|
+
n_bkit_core_engine_install -->|14| n_bkit_core_engine_checks
|
|
384
|
+
nscripts_harvest -->|14| n_bkit_core_engine_ledgers
|
|
385
|
+
n_bkit_core_engine_checks -->|12| n_bkit_core_engine_cli
|
|
386
|
+
n_bkit_core_engine_render -->|12| n_bkit_core_engine_shared
|
|
387
|
+
n_bkit_core_engine_checks -->|11| n_bkit_core_engine_ledgers
|
|
388
|
+
n_bkit_core_engine_install -->|11| n_bkit_core_engine_ledgers
|
|
389
|
+
n_bkit_core_engine_install -->|8| n_bkit_core_engine_cli
|
|
390
|
+
n_bkit_core_engine_cli -->|7| n_bkit_core_engine_install
|
|
391
|
+
n_bkit_core_engine_render -->|7| n_bkit_core_engine_install
|
|
392
|
+
n_bkit_core_engine_checks -->|6| n_bkit_core_engine_render
|
|
393
|
+
n_bkit_core_engine_cli -->|6| n_bkit_core_engine_shared
|
|
394
|
+
style gn_bkit_core_engine fill:#59636e0a,stroke:#59636e,stroke-width:2px
|
|
395
|
+
style n_bkit_core_engine_checks stroke:#1a7f37,stroke-width:2px,fill:#1a7f3714
|
|
396
|
+
style n_bkit_core_engine_cli stroke:#8250df,stroke-width:2px,fill:#8250df14
|
|
397
|
+
style n_bkit_core_engine_commands stroke:#0969da,stroke-width:2px,fill:#0969da14
|
|
398
|
+
style n_bkit_core_engine_install stroke:#0a7b83,stroke-width:2px,fill:#0a7b8314
|
|
399
|
+
style n_bkit_core_engine_ledgers stroke:#1a7f37,stroke-width:2px,fill:#1a7f3714
|
|
400
|
+
style n_bkit_core_engine_render stroke:#0a7b83,stroke-width:2px,fill:#0a7b8314
|
|
401
|
+
style n_bkit_core_engine_shared stroke:#cf222e,stroke-width:4px,stroke-dasharray:8 4,fill:#cf222e26
|
|
402
|
+
style nscripts_harvest stroke:#8250df,stroke-width:2px,fill:#8250df14
|
|
403
|
+
linkStyle 0 stroke:#59636e,stroke-width:6px
|
|
404
|
+
linkStyle 1 stroke:#59636e,stroke-width:6px
|
|
405
|
+
linkStyle 2 stroke:#59636e,stroke-width:6px
|
|
406
|
+
linkStyle 3 stroke:#59636e,stroke-width:6px
|
|
407
|
+
linkStyle 4 stroke:#59636e,stroke-width:6px
|
|
408
|
+
linkStyle 5 stroke:#59636e,stroke-width:6px
|
|
409
|
+
linkStyle 6 stroke:#59636e,stroke-width:6px
|
|
410
|
+
linkStyle 7 stroke:#59636e,stroke-width:6px
|
|
411
|
+
linkStyle 8 stroke:#59636e,stroke-width:6px
|
|
412
|
+
linkStyle 9 stroke:#59636eb3,stroke-width:3px
|
|
413
|
+
linkStyle 10 stroke:#59636eb3,stroke-width:3px
|
|
414
|
+
linkStyle 11 stroke:#59636eb3,stroke-width:3px
|
|
415
|
+
linkStyle 12 stroke:#59636eb3,stroke-width:3px
|
|
416
|
+
linkStyle 13 stroke:#59636eb3,stroke-width:3px
|
|
417
|
+
linkStyle 14 stroke:#59636eb3,stroke-width:3px
|
|
418
|
+
linkStyle 15 stroke:#59636eb3,stroke-width:3px
|
|
419
|
+
linkStyle 16 stroke:#59636eb3,stroke-width:3px
|
|
420
|
+
linkStyle 17 stroke:#59636eb3,stroke-width:3px
|
|
421
|
+
linkStyle 18 stroke:#59636e80,stroke-width:2px
|
|
422
|
+
linkStyle 19 stroke:#59636e80,stroke-width:2px
|
|
423
|
+
linkStyle 20 stroke:#59636e80,stroke-width:2px
|
|
424
|
+
linkStyle 21 stroke:#59636e80,stroke-width:2px
|
|
425
|
+
linkStyle 22 stroke:#59636e80,stroke-width:2px
|
|
426
|
+
linkStyle 23 stroke:#59636e80,stroke-width:2px
|
|
427
|
+
linkStyle 24 stroke:#59636e80,stroke-width:2px
|
|
428
|
+
```
|
|
429
|
+
|
|
430
|
+
<!-- graph:packages:end -->
|
|
431
|
+
|
|
279
432
|
All templates, what each is for, and how to install them: [`.bkit/templates.md`](.bkit/templates.md).
|
|
280
433
|
|
|
281
434
|
## What else you get
|
|
@@ -284,15 +437,15 @@ All templates, what each is for, and how to install them: [`.bkit/templates.md`]
|
|
|
284
437
|
|
|
285
438
|
- **Best model for each job, on every tool.** Each agent has its own model and thinking depth, per tool and provider: deep reasoning models for architecture and security review, faster ones for writing code and docs. Starting a session on a cheaper model never quietly downgrades the reviewers. [Which model does each job](#models).
|
|
286
439
|
- **It tests ideas before you commit to them.** When reviewers flag an unknown a design depends on, design writes throwaway probe code to settle it before you approve. A design reviewer also checks failure modes and monitoring, not just whether it can be built.
|
|
287
|
-
- **Big features are built a group at a time.** The plan's tasks are grouped by the code they share. Each group gets a fresh agent and a short brief from `bkit`, never the whole plan, and an independent check of just that group's changes before the next group starts.
|
|
440
|
+
- **Big features are built a group at a time.** The plan's tasks are grouped by the code they share. Each group gets a fresh agent and a short brief from `bkit`, never the whole plan, and an independent check of just that group's changes before the next group starts. [The engine](#engine).
|
|
441
|
+
- **The right expertise for each feature, added and removed for you.** Before build writes code, an agent works out which tools the plan needs (say Stripe or Supabase) and installs one matching skill (a packaged set of instructions for that tool) from [skills.sh](https://skills.sh) for each one not already covered. It only takes a skill from the official publisher, or one with 1,000+ installs and 100+ stars on its repo. It never runs scripts a skill brings along. When the feature ships, bkit removes every skill not listed in `.agents/skills.md`, so add one there to keep it. Put `[skills=false]` in the issue to skip it.
|
|
288
442
|
- **Numbers on your own work.** Every run records its time, size of change, retries and the tokens each agent read in `.bkit/stats.jsonl`, and posts them to the issue next to the median of your last five runs.
|
|
289
443
|
|
|
290
444
|
### It fits how you work
|
|
291
445
|
|
|
292
|
-
- **Never blocked by usage limits.** Out of Claude for the week? Carry on in
|
|
293
|
-
- **Start on your laptop, check in from your phone.** A feature started at your desk can continue in a cloud session (Claude
|
|
446
|
+
- **Never blocked by usage limits.** Out of Claude for the week? Carry on in Codex, Antigravity or Cursor, or point OpenCode at your own key: OpenRouter, Ollama or the OpenCode gateways. Same feature, same checks, nothing to set up again. [Tool differences](.bkit/providers.md).
|
|
447
|
+
- **Start on your laptop, check in from your phone.** A feature started at your desk can continue in a cloud session (Claude on the web or the Claude app, Cursor cloud agents, or OpenCode on GitHub Actions), or start by itself when CI finishes: ship on green, debug on red. The cloud setup ships ready to adopt: [`.bkit/cloud.md`](.bkit/cloud.md).
|
|
294
448
|
- **Run several features at once.** Each works in its own copy of the repo (a git worktree), so they never trip over each other.
|
|
295
|
-
- **The right expertise for each feature.** When a plan needs, say, Stripe or Supabase, bkit installs a matching skill for the build and removes it when the feature ships.
|
|
296
449
|
|
|
297
450
|
### Your tracker is the control panel
|
|
298
451
|
|
|
@@ -305,7 +458,7 @@ All templates, what each is for, and how to install them: [`.bkit/templates.md`]
|
|
|
305
458
|
### You stay in control
|
|
306
459
|
|
|
307
460
|
- **Decide in plain English, not code.** Before any code is written you approve two short documents: a design ("three ways to build this; we recommend this one, because…") and a plan ("these twelve steps, and how we'll know each is done").
|
|
308
|
-
- **Three sign-offs, and production stays yours.** The
|
|
461
|
+
- **Three sign-offs, and production stays yours.** The workflows stop after the design, after the plan and before merging. bkit merges into your `dev` branch and never touches `main`: promoting to production is always your call. Cloud mode ships on green without you only for issues you've labelled `bkit:auto`; removing the label stops it.
|
|
309
462
|
- **A fix that doesn't work comes back to you.** After one automatic fix round, build asks before trying again, with a report: problems per round, code changed, and whether it's closing in, stuck or getting worse. Each place a run can ask has its own setting under `bkit.workflows` in `package.json`: whether to ask, and a hard limit (2 attempts by default) that no answer can raise.
|
|
310
463
|
- **Questions don't stall the build.** When build needs your decision, it keeps working on the tasks the question doesn't touch. With nobody at the keyboard, it goes ahead on its own recommendation, marks it as assumed, and won't merge until you confirm it.
|
|
311
464
|
- **Guardrails on the AI itself.** Dangerous commands like force-pushing or rewriting history are blocked, private keys can't be read, and each agent only gets the tools its job needs. [What each guard does](.bkit/providers.md#guardrails) and [what it tells agents](.bkit/prompts.md#hook-injected-text).
|
|
@@ -317,60 +470,80 @@ All templates, what each is for, and how to install them: [`.bkit/templates.md`]
|
|
|
317
470
|
<p align="center">
|
|
318
471
|
<picture>
|
|
319
472
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-reread-dark.svg">
|
|
320
|
-
<img alt="
|
|
473
|
+
<img alt="Most of what a coding agent reads is the conversation re-sent on every request, not tool output. bkit hands over to a fresh agent with a short brief instead of letting one agent’s context grow." src=".github/assets/bkit-reread-light.svg" width="100%">
|
|
321
474
|
</picture>
|
|
322
475
|
</p>
|
|
323
476
|
|
|
324
|
-
**Most of what a session costs is the model re-reading, not writing code.** On every request, Claude
|
|
477
|
+
**Most of what a session costs is the model re-reading, not writing code.** On every request, Claude sends the system prompt, rules, tool list and the whole conversation so far, and the model reads all of it again. Across 13.5M GitHub Copilot agent sessions, the conversation so far was 48% of what the model read on each request, tool output 28%, the system prompt 14% and instructions and other context 10%. The model read more than 275 tokens for every 1 it wrote ([Liu et al.](https://arxiv.org/abs/2608.00101); [Manus](https://manus.im/en/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus) reports about 100 to 1). Most of that reading comes from the cache, and cache reads are the largest part of an agent's bill ([Bai et al.](https://arxiv.org/abs/2604.22750)).
|
|
325
478
|
|
|
326
|
-
**That makes an agent's cost grow with how long it runs.** Each request re-sends everything so far. A token costs the same at 900k as at 9k ([Anthropic pricing](https://platform.claude.com/docs/en/about-claude/pricing#long-context-pricing)), but a turn at 900k sends 100 times as many, so every turn costs more than the last. Left alone, an agent keeps going until about 967k, where Claude
|
|
479
|
+
**That makes an agent's cost grow with how long it runs.** Each request re-sends everything so far. A token costs the same at 900k as at 9k ([Anthropic pricing](https://platform.claude.com/docs/en/about-claude/pricing#long-context-pricing)), but a turn at 900k sends 100 times as many, so every turn costs more than the last. Left alone, an agent keeps going until about 967k, where Claude summarises it and drops detail ([model configuration](https://code.claude.com/docs/en/model-config)). Quality slips long before that: every model in [Chroma's context-rot study](https://www.trychroma.com/research/context-rot) got worse as its input grew, and in [NoLiMa](https://arxiv.org/abs/2502.05167) most models fell below half their short-input score by 32k. Practitioners advise starting fresh at around 40–60% of a 200k window ([HumanLayer](https://humanlayer.dev/blog/advanced-context-engineering)), and Anthropic's own sub-agents hand back 1–2k tokens from tens of thousands they read ([Anthropic](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents)). bkit does that: a fresh agent with a short brief takes over by about 160k, so no agent carries a long history. Most of what an agent reads is cheap cache reads, so the dollar saving is smaller than the token saving.
|
|
327
480
|
|
|
328
|
-
**Measure it on your own work.**
|
|
481
|
+
**Measure it on your own work.** bkit keeps run statistics in your repo, ready to review and compare. [What we measure and how to share your results](#measurements).
|
|
329
482
|
|
|
330
|
-
**Why bkit doesn't use compression tools.** They shorten the output of commands and file reads before the model sees it. That's only part of what an agent reads, and most of it is code the agent needs word for word, so there's little a tool can safely cut. The re-reading of everything else stays. An independent test of 2,848 Claude
|
|
483
|
+
**Why bkit doesn't use compression tools.** They shorten the output of commands and file reads before the model sees it. That's only part of what an agent reads, and most of it is code the agent needs word for word, so there's little a tool can safely cut. The re-reading of everything else stays. An independent test of 2,848 Claude runs found the same: RTK cut the whole bill by 2.7%, and Headroom raised it by 48% ([Weinberger & Hozez](https://arxiv.org/abs/2607.12161)). In our tests, the tools that saved most did it by changing what the agent reads: one made an agent answer a question wrongly; another rewrote code.
|
|
331
484
|
|
|
332
485
|
**The three tools, how we measured, and why the risks outweigh the saving.**
|
|
333
486
|
|
|
334
487
|
<p align="center">
|
|
335
488
|
<picture>
|
|
336
489
|
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-tokens-dark.svg">
|
|
337
|
-
<img alt="
|
|
490
|
+
<img alt="Across more than 400 bkit transcripts, compression tools could touch only the tool-output share of the bill and saved 1 to 3 percent, at the risk of wrong answers and broken code." src=".github/assets/bkit-tokens-light.svg" width="100%">
|
|
338
491
|
</picture>
|
|
339
492
|
</p>
|
|
340
493
|
|
|
341
494
|
<!-- prettier-ignore -->
|
|
342
495
|
| Tool | How it works | Share of the bill saved | What went wrong |
|
|
343
496
|
| --- | --- | --- | --- |
|
|
344
|
-
| [caveman](https://www.npmjs.com/package/@caveman-ai/cli) | Sits between Claude
|
|
497
|
+
| [caveman](https://www.npmjs.com/package/@caveman-ai/cli) | Sits between Claude and the model and shortens tool output | 1.3% | An agent answered a question wrongly from a compressed log |
|
|
345
498
|
| [Headroom](https://pypi.org/project/headroom-ai/) | Same idea, plus an optional text model that rewrites output | 2.8% with the text model, 0.8% without | The text model rewrote code: `(preset) => void` came back as `(preset) void` |
|
|
346
499
|
| [RTK](https://github.com/rtk-ai/rtk) | A hook that swaps shell commands for versions that print less | 0.7–2.1% | Its `grep` strips indentation and cuts lines at 80 characters |
|
|
347
500
|
|
|
348
|
-
**How we measured.** The cost split above comes from
|
|
501
|
+
**How we measured.** The cost split above comes from more than 400 transcripts. The table compares the three tools on the 314 of them still on disk when RTK was tested, so all three are measured on the same data. We ran each tool over the large tool results, with no model calls. Each result counts by how often the model re-read it later, because that's what it cost. RTK acts before a command runs, so we re-ran the read-only commands with and without it. Full method, every result with its 95% range, and the scripts: [the comparison](tests/experiments/compression/reports/bkit-caveman-headroom-compression-proxy-comparison.md). Your sessions may differ: run the scripts on your own transcripts before you choose.
|
|
349
502
|
|
|
350
503
|
**Why the risks outweigh the saving, for now.** The saving is real but small, and the tools that save most get there by changing what the agent reads. An agent reading a shortened log can answer wrongly. An edit quoting a rewritten or cut-off line won't match the file. Either way the agent goes round again, and every extra round re-reads the whole conversation, so it doesn't take many to wipe out a 1–3% saving. On top of that, a proxy sees all your model traffic, and when one of these tools breaks, it tends to switch itself off without telling you. That could change if a tool learns to leave code alone and fail loudly.
|
|
351
504
|
|
|
352
|
-
**What bkit does instead: read less.** Cutting what gets read loses nothing, and a line an agent never reads is a line it never re-reads on every later request.
|
|
505
|
+
**What bkit does instead: read less.** Cutting what gets read loses nothing, and a line an agent never reads is a line it never re-reads on every later request. Most of that comes from how a run is split: plain code keeps the books and each agent gets only its part ([the engine](#engine)).
|
|
353
506
|
|
|
354
|
-
- **Fresh agents with short briefs.**
|
|
507
|
+
- **Fresh agents with short briefs.** `bkit context brief` cuts each group's part out of the plan, a few KB, and a new agent builds from that. No build agent sees the whole plan or runs past about 160k tokens: it hands over to a fresh one.
|
|
355
508
|
- **Code does the bookkeeping.** Anything with one right answer comes from a `bkit` command, not a model turn: ledger rows, whether a test failed before its code was written, run summaries, where a stopped run resumes, how many fix rounds a step has had. That saves the turns, and code gives the same answer every time, on every tool and every model.
|
|
356
509
|
- **Fewer rounds.** One plan review round, with two reviewers and a scope check side by side. One automatic fix round, then you decide. On a small change, build runs only the security reviewer.
|
|
357
510
|
- **Each agent carries only its own rules.** bkit's rules sit in the prompts of the agents that act on them, and plans hold tasks, not pages of instructions.
|
|
358
511
|
- **Find the definition first, then read only those lines.** Reading files through the shell (`sed`, `grep`, `cat`) was about 60% of what shell output cost in our transcripts. A whole file can be thousands of lines when the change needs ten.
|
|
359
512
|
- **List matching files first, then search inside them.** A broad search can return hundreds of lines the agent never needed, and they stay in the conversation.
|
|
360
513
|
- **Ask commands, APIs and databases for short, structured output.** An unfiltered log or API response can run to thousands of lines, re-read on every later request.
|
|
514
|
+
- **Bound outside evidence before it's downloaded.** Debug's connectors ask each source for the window, severity and fields they need, tail-bound the logs of each failed job, and page no further than a cap. Records are projected with `jq` to a PII-safe subset of fields, a JSON list is written as a table that repeats no key per row, and anything over 3,000 lines is trimmed to its head, tail and error lines — with a line in the file saying so.
|
|
361
515
|
- **Flag re-reads of a file that hasn't changed,** with a [hook](.bkit/prompts.md#hook-injected-text) on all five supported tools. 41% of file reads in our transcripts were repeats, each adding a second copy to the conversation.
|
|
362
516
|
- **Prefer command-line tools to MCP servers** for logs, errors and database data. Every connected MCP server's tool list is re-sent with every request, used or not.
|
|
363
517
|
- **Each step reads only the project docs it needs.** Whatever a step reads at the start is re-read on every request in that step.
|
|
364
518
|
- **A utility agent shortens markdown files without changing what they say.** Rules and prompts go out with every request of every agent, so a line cut there is saved many thousands of times.
|
|
365
519
|
|
|
366
|
-
**Or run fewer steps.** For a change that's clearly small, the [lite workflows](.bkit/lite.md) keep only the steps and reviewers it needs, so fewer requests re-read the conversation. You give up the safety checks, so the full workflow stays the default.
|
|
367
|
-
|
|
368
520
|
**What [`bkit tips`](.bkit/README.md#ongoing-cli) suggests for your repo:**
|
|
369
521
|
|
|
370
522
|
- **Set up Serena,** so agents ask where code is defined and what uses it, like your editor does. That's cheaper than reading whole files, and it doesn't miss callers that text search would.
|
|
371
|
-
- **Switch off claude.ai connectors** (MCP servers from your claude.ai account) in Claude
|
|
523
|
+
- **Switch off claude.ai connectors** (MCP servers from your claude.ai account) in Claude for this project: `"disableClaudeAiConnectors": true` in `.claude/settings.json`. Otherwise their tool lists are re-sent with every request, used or not.
|
|
372
524
|
- **Lock MCP servers to this project.** A server that can see your whole account makes agents look up account and project IDs before every task; locked, those extra calls disappear.
|
|
373
|
-
- **Summarise long sessions earlier:** `"autoCompactWindow": 300000` in `.claude/settings.json`, or `model_auto_compact_token_limit` in `.codex/config.toml`. By default a session grows close to the model's full size before it summarises, and every request re-reads all of it. Summaries lose some detail, so for your main session bkit suggests this rather than setting it. bkit's own Claude
|
|
525
|
+
- **Summarise long sessions earlier:** `"autoCompactWindow": 300000` in `.claude/settings.json`, or `model_auto_compact_token_limit` in `.codex/config.toml`. By default a session grows close to the model's full size before it summarises, and every request re-reads all of it. Summaries lose some detail, so for your main session bkit suggests this rather than setting it. bkit's own Claude subagents already summarise at 300,000 tokens at the latest.
|
|
526
|
+
|
|
527
|
+
<a id="measurements"></a>
|
|
528
|
+
|
|
529
|
+
### Measurements: v6/6.1 versus v5.x
|
|
530
|
+
|
|
531
|
+
**Median tokens for [/bkit-plan](.bkit/core/workflows/bkit-plan.md) and [/bkit-build](.bkit/core/workflows/bkit-build.md) workflow chats fell by roughly half in our latest measurements.** These measurements cover v6 and the development towards v6.1, compared with the last measured v5.x workflows.
|
|
532
|
+
|
|
533
|
+
<p align="center">
|
|
534
|
+
<picture>
|
|
535
|
+
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/bkit-stats-dark.svg">
|
|
536
|
+
<img alt="v6/6.1 versus v5.x: approximate median tokens for /bkit-plan workflow chats fell from 129M to 62M, a 50–55% reduction; for /bkit-build, from 201M to 104M, a 45–50% reduction. Small sample size; see Stats review #845 for details." src=".github/assets/bkit-stats-light.svg" width="100%">
|
|
537
|
+
</picture>
|
|
538
|
+
</p>
|
|
539
|
+
|
|
540
|
+
**Small sample size.** M means million tokens read per workflow chat, including subagents and incomplete attempts. Tasks, hosts and models differ. See [#845 — Stats review](https://github.com/cbartens/bkit/issues/845#issuecomment-6602753865) for the method, sample sizes and trade-offs.
|
|
541
|
+
|
|
542
|
+
**See where your runs spend time and effort.** Your local report shows run durations, change sizes, agent context peaks where available, rule compliance and workflow problems. Our [deeper local analysis](docs/observability.md#harvest--every-repo-every-chat-bkit-repo-only) adds token use, completion, repeated work and owner waits. It is separate from the report installed in your project.
|
|
543
|
+
|
|
544
|
+
**Your stats stay under your control.** bkit does not automatically upload stats or transcripts to us, and we do not remotely monitor your usage. Reports stay in your repository and follow its access settings.
|
|
545
|
+
|
|
546
|
+
**Help us grow the sample.** Voluntarily [share a cleaned summary](https://github.com/cbartens/bkit/issues/new) so we can test these improvements across more projects, hosts and models. Good results and problems are equally useful. [Report and sharing instructions](.bkit/README.md#share-friction-with-bkit) explain how to review your stats and approve exactly what you share.
|
|
374
547
|
|
|
375
548
|
## FAQ
|
|
376
549
|
|
|
@@ -381,19 +554,19 @@ No, but you need to read a design and a plan and decide whether they're right. S
|
|
|
381
554
|
bkit is heavier than a single prompt. For a one-off script or a quick experiment, just ask your AI. bkit pays off on a project you'll keep changing and want to trust.
|
|
382
555
|
|
|
383
556
|
**Does it work on an existing project?**
|
|
384
|
-
Yes.
|
|
557
|
+
Yes, in any language. bkit installs as an npm package, so the repo gets a `package.json` if it hasn't one ([not a JavaScript project?](#quick-start)). It adds its own files and writes into shared ones such as `CLAUDE.md`, `.gitignore` and `docs/*.md` only between `bkit:start` and `bkit:end` markers, leaving the rest alone. The project docs fill in as agents work on your code.
|
|
385
558
|
|
|
386
559
|
**What does install change, and can I remove it?**
|
|
387
560
|
Every file it writes is listed in [what install writes](.bkit/README.md#what-install-writes). `bkit uninstall` removes bkit's files and blocks, and keeps your own edits and every template you copied ([uninstall](.bkit/install.md#uninstall)).
|
|
388
561
|
|
|
389
562
|
**What does it cost?**
|
|
390
|
-
**bkit is free and open source** under the MIT licence, commercial use included ([License](#license)). It runs on AI subscriptions you already have (Claude,
|
|
563
|
+
**bkit is free and open source** under the MIT licence, commercial use included ([License](#license)). It runs on AI subscriptions you already have (Claude, Codex through ChatGPT, Antigravity, Cursor), on Antigravity's free tier, or with your own key on pay-as-you-go providers through OpenCode (OpenRouter, Ollama or the OpenCode gateways). Several agents reviewing in parallel use more of your quota than a single chat; that's the price of the second opinions.
|
|
391
564
|
|
|
392
565
|
**How long does a feature take?**
|
|
393
566
|
No full run, from design to merge, has taken longer than a day. Each run posts its own time to the issue, next to the median of your last five runs, so you can see how yours compare.
|
|
394
567
|
|
|
395
568
|
**Can it break my live site?**
|
|
396
|
-
**Not without your sign-off.**
|
|
569
|
+
**Not without your sign-off.** Work happens in a separate copy of the repo, goes through a pull request, must pass every test, and merges into `dev`, never `main`.
|
|
397
570
|
|
|
398
571
|
**Which issue tracker, and which code host?**
|
|
399
572
|
GitHub Issues, Linear or Jira for the tracker. The code has to live on GitHub: pull requests, CI and cloud mode run there.
|
|
@@ -413,8 +586,8 @@ On real bkit sessions they saved 1–3% of the bill, and each changes what the a
|
|
|
413
586
|
- **Isolation.** Every run gets its own git worktree; a per-feature lock blocks duplicate runs of the same feature. Bookkeeping reaches `dev` from a throwaway checkout of `origin/dev`, so it never touches your checkout; when another run moved `dev` first, it rebuilds and pushes again. No repo-wide lock.
|
|
414
587
|
- **Resume from state, not session.** Run state lives in `status.jsonl` and `docs/plans/`. A crashed or interrupted run resumes from its last completed step, on any host; `bkit` works out which step from `status.jsonl`, so no prompt describes the rule.
|
|
415
588
|
- **Mechanical step gates.** `bkit steps finish` checks each step's verdict and artifacts before the workflow moves on; build ticks a task only on a confirmed artifact, and checks test-first order before the next task group starts; ship's deferred sweep fails the merge on an unplanned gap.
|
|
416
|
-
- **Engine.** The `bkit` CLI is TypeScript in [`.bkit/core/engine/`](.bkit/core/engine/), built to `dist/`, covered by 5,800+ tests. `commands/` holds what you type; `install/`, `render/`, `checks/`, `ledgers/` and `shared/` hold the code underneath; `audits/` holds the tests that read shipped text. **Facts are code, judgement is the model:** anything with one right answer (ledger rows, briefs, summaries, resume points, fix-round limits, run stats) is a `bkit <noun> <verb>` command, so the workflow prompts hold only the decisions.
|
|
417
|
-
- **One source, every host.** `.bkit/` renders `.claude/`, `.
|
|
589
|
+
- **Engine.** The `bkit` CLI is TypeScript in [`.bkit/core/engine/`](.bkit/core/engine/), built to `dist/`, covered by 5,800+ tests. `commands/` holds what you type; `install/`, `render/`, `checks/`, `ledgers/` and `shared/` hold the code underneath; `audits/` holds the tests that read shipped text. **Facts are code, judgement is the model:** anything with one right answer (ledger rows, briefs, summaries, resume points, fix-round limits, run stats) is a `bkit <noun> <verb>` command, so the workflow prompts hold only the decisions ([picture](#engine)).
|
|
590
|
+
- **One source, every host.** `.bkit/` renders `.claude/`, `.codex/`, `.agents/` (Antigravity), `.cursor/` and `.opencode/`. `bkit check` is the CI drift gate.
|
|
418
591
|
- **Reviewer independence.** Parallel reviewers can't read sibling output. Design brainstorm and design review groups also cross models (Opus + Sonnet on Claude; Grok + Composer on Cursor); depth-sensitive lenses (plan review, build challenge) stay on the top tier.
|
|
419
592
|
- **Per-agent pins.** Model and effort per agent, per provider ([`.bkit/prompts.md`](.bkit/prompts.md) § Models), immune to the session default.
|
|
420
593
|
- **Against the literature.** bkit fully implements 13 of the 22 patterns in Antonio Gulli's _Agentic Design Patterns_, partly implements 7 (scoped to shipping code), leaves 2 out by design, and goes beyond the book in 8 places. Full mapping: [patterns comparison](.bkit/comparison.md#patterns), with [where bkit goes beyond the book](.bkit/comparison.md#beyond-the-book) and its [known gaps](.bkit/comparison.md#known-gaps). Every agent in execution order: [pipeline reference](.bkit/pipeline.md).
|
|
@@ -430,11 +603,10 @@ On real bkit sessions they saved 1–3% of the bill, and each changes what the a
|
|
|
430
603
|
| [`.bkit/README.md`](.bkit/README.md) | Day-to-day use: running workflows, environment, tracker setup, CLI |
|
|
431
604
|
| [`.bkit/workflows.md`](.bkit/workflows.md) | Every workflow step, verdict and contract |
|
|
432
605
|
| [`.bkit/providers.md`](.bkit/providers.md) | Tool and provider differences, guardrails, model pins |
|
|
433
|
-
| [`.bkit/cloud.md`](.bkit/cloud.md) | Cloud agents: Claude
|
|
606
|
+
| [`.bkit/cloud.md`](.bkit/cloud.md) | Cloud agents: Claude on the web, Cursor, OpenCode |
|
|
434
607
|
| [`.bkit/templates.md`](.bkit/templates.md) | Templates ready to adopt |
|
|
435
|
-
| [`.bkit/lite.md`](.bkit/lite.md) | Lite workflows: shorter prompts for small changes |
|
|
436
608
|
| [`.bkit/pipeline.md`](.bkit/pipeline.md) | Every agent in the order it runs, the CI scaffold, every audit template |
|
|
437
|
-
| [`.bkit/authoring.md`](.bkit/authoring.md) | Rules for writing docs, prompts and workflows |
|
|
609
|
+
| [`.bkit/authoring.md`](.bkit/authoring.md) | Rules for writing docs, prompts and workflows, matched against Anthropic's, OpenAI's and Google's prompting guides |
|
|
438
610
|
| [`.bkit/comparison.md`](.bkit/comparison.md) | Comparison with other AI development frameworks and with _Agentic Design Patterns_ |
|
|
439
611
|
| [`CHANGELOG.md`](CHANGELOG.md) | What changed in each release |
|
|
440
612
|
|
|
@@ -442,7 +614,9 @@ On real bkit sessions they saved 1–3% of the bill, and each changes what the a
|
|
|
442
614
|
|
|
443
615
|
## Quick start
|
|
444
616
|
|
|
445
|
-
**You need** a GitHub repo
|
|
617
|
+
**You need** a GitHub repo, Node 24+, pnpm, and at least one of Claude, Codex, Antigravity, Cursor or OpenCode.
|
|
618
|
+
|
|
619
|
+
**Not a JavaScript project?** bkit works with any stack. It installs as an npm package, so your repo gets a `package.json` (`pnpm add` creates one if there isn't one), but nothing else has to be JavaScript: point the `bkit:gate:*` scripts install adds at your own commands, such as `ruff check && pytest` or `go test ./...` ([required tools](.bkit/README.md#required-tools)).
|
|
446
620
|
|
|
447
621
|
**Easiest:** copy the [install prompt](.bkit/install.md#install--first-time) into your AI coding tool and let it do the setup.
|
|
448
622
|
|
|
@@ -450,8 +624,8 @@ On real bkit sessions they saved 1–3% of the bill, and each changes what the a
|
|
|
450
624
|
|
|
451
625
|
```bash
|
|
452
626
|
pnpm add -D @cbartens/bkit
|
|
453
|
-
pnpm bkit install --claude # pick your tools: --claude --
|
|
454
|
-
#
|
|
627
|
+
pnpm bkit install --claude # pick your tools: --claude --codex --antigravity --cursor --opencode=<provider>
|
|
628
|
+
# OpenCode provider: openrouter | ollama | opencode-zen | opencode-go
|
|
455
629
|
```
|
|
456
630
|
|
|
457
631
|
**Check it worked:** `pnpm bkit check` confirms every installed file matches the version you pinned (CI runs the same check), and `pnpm bkit tips` lists what isn't set up yet, most useful first.
|
|
@@ -478,7 +652,7 @@ bkit's process was worked out over months of building real products with it. The
|
|
|
478
652
|
| _Agentic Design Patterns_ (Antonio Gulli) | A "done when" line on every plan task, and testing hypotheses before fixing in debug. The book is also the yardstick in the [patterns comparison](.bkit/comparison.md#patterns). |
|
|
479
653
|
| [skills](https://github.com/mattpocock/skills) (Matt Pocock) | The interview that opens `/bkit-design`, adapted from `grill-me`: open questions are settled with you before any design work starts. |
|
|
480
654
|
|
|
481
|
-
**Built on.** The templates set up these tools; thanks to their maintainers: [Serena](https://github.com/oraios/serena), [graphify](https://github.com/Graphify-Labs/graphify), [slop-scan](https://github.com/modem-dev/slop-scan), [Vale](https://github.com/vale-cli/vale) with [write-good](https://github.com/vale-cli/write-good), [Renovate](https://github.com/renovatebot/renovate), [Dependabot](https://docs.github.com/en/code-security/dependabot), [Trivy](https://github.com/aquasecurity/trivy), [Husky](https://github.com/typicode/husky), [lint-staged](https://github.com/lint-staged/lint-staged), [Prettier](https://github.com/prettier/prettier), [actionlint](https://github.com/rhysd/actionlint)
|
|
655
|
+
**Built on.** The templates set up these tools; thanks to their maintainers: [Serena](https://github.com/oraios/serena), [graphify](https://github.com/Graphify-Labs/graphify), [slop-scan](https://github.com/modem-dev/slop-scan), [Vale](https://github.com/vale-cli/vale) with [write-good](https://github.com/vale-cli/write-good), [Renovate](https://github.com/renovatebot/renovate), [Dependabot](https://docs.github.com/en/code-security/dependabot), [Trivy](https://github.com/aquasecurity/trivy), [Husky](https://github.com/typicode/husky), [lint-staged](https://github.com/lint-staged/lint-staged), [Prettier](https://github.com/prettier/prettier), [actionlint](https://github.com/rhysd/actionlint), [direnv](https://github.com/direnv/direnv) and the [skills](https://github.com/vercel-labs/skills) CLI behind [skills.sh](https://skills.sh).
|
|
482
656
|
|
|
483
657
|
## License
|
|
484
658
|
|