@cbartens/bkit 5.1.0 → 5.2.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 +11 -7
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +39 -50
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +74 -56
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +72 -0
- package/.bkit/core/.agents/rules.md +8 -4
- package/.bkit/core/.agents/shortcuts.md +1 -1
- package/.bkit/core/.bkit/LICENSE.md +18 -140
- package/.bkit/core/.bkit/README.md +10 -6
- package/.bkit/core/.bkit/cloud.md +12 -15
- package/.bkit/core/.bkit/comparison.md +66 -14
- package/.bkit/core/.bkit/install.md +31 -8
- package/.bkit/core/.bkit/jsonl.md +0 -1
- package/.bkit/core/.bkit/prompts.md +14 -13
- package/.bkit/core/.bkit/providers.md +90 -26
- package/.bkit/core/.bkit/templates.md +38 -11
- package/.bkit/core/.bkit/workflows.md +63 -41
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +4 -3
- package/.bkit/core/.claude/hooks/bkit-readguard.cjs +60 -0
- package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +8 -6
- package/.bkit/core/.codex/hooks/bkit-readguard.cjs +58 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +12 -19
- package/.bkit/core/.cursor/hooks/bkit-readguard.cjs +59 -0
- package/.bkit/core/.opencode/plugin/bkit-gateguard.js +73 -22
- package/.bkit/core/.opencode/plugin/bkit-readguard.js +126 -0
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +2 -2
- package/.bkit/core/docs/templates/bkit-plan.md +6 -3
- package/.bkit/core/engine/checks/after/auth.ts +32 -0
- package/.bkit/core/engine/checks/after/github.ts +4 -4
- package/.bkit/core/engine/checks/after/index.ts +36 -50
- package/.bkit/core/engine/checks/after/managed.ts +40 -0
- package/.bkit/core/engine/checks/before/index.ts +5 -4
- package/.bkit/core/engine/checks/before/mcp.ts +60 -54
- package/.bkit/core/engine/checks/status-holes.ts +1 -1
- package/.bkit/core/engine/checks/tips/catalogue.ts +356 -0
- package/.bkit/core/engine/checks/tips/detect.ts +144 -0
- package/.bkit/core/engine/checks/tips/index.ts +174 -0
- package/.bkit/core/engine/cli.ts +57 -9
- package/.bkit/core/engine/commands/install/doctor.ts +5 -1
- package/.bkit/core/engine/commands/install/install.ts +39 -9
- package/.bkit/core/engine/commands/install/uninstall.ts +32 -18
- package/.bkit/core/engine/commands/install/upgrade.ts +15 -28
- package/.bkit/core/engine/commands/launch.ts +33 -11
- package/.bkit/core/engine/commands/tips.ts +16 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +57 -16
- package/.bkit/core/engine/commands/workflow/runtime.ts +12 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +1 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +647 -4
- package/.bkit/core/engine/commands/workflow/workstreams.ts +4 -4
- package/.bkit/core/engine/install/cloud-env.ts +7 -21
- package/.bkit/core/engine/install/hosts.ts +21 -0
- package/.bkit/core/engine/install/managed-block.ts +36 -0
- package/.bkit/core/engine/install/manifest.ts +46 -4
- package/.bkit/core/engine/install/modules/antigravity.ts +8 -7
- package/.bkit/core/engine/install/modules/claude.ts +6 -6
- package/.bkit/core/engine/install/modules/cloud.ts +2 -2
- package/.bkit/core/engine/install/modules/codex.ts +5 -5
- package/.bkit/core/engine/install/modules/core.ts +23 -9
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +4 -4
- package/.bkit/core/engine/install/payload-links.ts +6 -10
- package/.bkit/core/engine/install/placeholders.ts +1 -1
- package/.bkit/core/engine/install/version-file.ts +17 -9
- package/.bkit/core/engine/install/write.ts +68 -1
- package/.bkit/core/engine/ledgers/telemetry.ts +0 -2
- package/.bkit/core/engine/shared/package-roots.ts +8 -10
- package/.bkit/core/hooks/antigravity-hook.js +67 -0
- package/.bkit/core/hooks/gateguard-edit-payload.js +4 -4
- package/.bkit/core/hooks/gateguard-engine.js +16 -6
- package/.bkit/core/hooks/guardrails-read.js +23 -0
- package/.bkit/core/hooks/readguard-engine.js +259 -0
- package/.bkit/core/hooks/readguard-payload.js +67 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +1 -0
- package/.bkit/core/prompts/bkit-build-challenge-1.md +1 -0
- package/.bkit/core/prompts/bkit-build-challenge-2.md +1 -0
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +1 -0
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +1 -0
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +1 -0
- package/.bkit/core/prompts/bkit-build-install-skills.md +1 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +1 -0
- package/.bkit/core/prompts/bkit-build-plan-execute.md +5 -1
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +1 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +11 -3
- package/.bkit/core/prompts/bkit-build-summary.md +1 -0
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +1 -0
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +1 -0
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +1 -0
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +1 -0
- package/.bkit/core/prompts/bkit-debug-summary.md +1 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +1 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +1 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +1 -0
- package/.bkit/core/prompts/bkit-design-generate.md +9 -4
- package/.bkit/core/prompts/bkit-design-organise.md +1 -0
- package/.bkit/core/prompts/bkit-design-review-1.md +1 -0
- package/.bkit/core/prompts/bkit-design-review-2.md +1 -0
- package/.bkit/core/prompts/bkit-design-spike.md +1 -0
- package/.bkit/core/prompts/bkit-design-summary.md +1 -0
- package/.bkit/core/prompts/bkit-design-update.md +1 -0
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +1 -0
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +3 -2
- package/.bkit/core/prompts/bkit-plan-generate.md +1 -0
- package/.bkit/core/prompts/bkit-plan-review-1.md +1 -0
- package/.bkit/core/prompts/bkit-plan-review-2.md +1 -0
- package/.bkit/core/prompts/bkit-plan-review-3.md +1 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +2 -1
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +2 -1
- package/.bkit/core/prompts/bkit-plan-summary.md +1 -0
- package/.bkit/core/prompts/bkit-plan-update.md +2 -1
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +1 -0
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +1 -0
- package/.bkit/core/prompts/bkit-ship-summary.md +1 -0
- package/.bkit/core/prompts/bkit-ship-update-docs.md +1 -0
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +1 -0
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +1 -0
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +1 -0
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +1 -0
- package/.bkit/core/prompts/bkit-utility-update-failures.md +1 -0
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +1 -0
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +1 -0
- package/.bkit/core/workflows/bkit-build.md +33 -21
- package/.bkit/core/workflows/bkit-debug.md +29 -22
- package/.bkit/core/workflows/bkit-design.md +81 -38
- package/.bkit/core/workflows/bkit-plan.md +8 -2
- package/.bkit/core/workflows/bkit-ship.md +8 -2
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +13 -3
- package/.bkit/shared/.claude/settings.json +19 -0
- package/.bkit/shared/.codex/hooks.json +21 -0
- package/.bkit/shared/.cursor/hooks.json +6 -1
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/docs/deployments.md +1 -1
- package/.bkit/shared/docs/testing.md +12 -1
- package/.bkit/templates/.github/dependabot.yml +6 -0
- package/.bkit/templates/.github/renovate.json5 +3 -3
- package/.bkit/templates/.github/workflows/bkit-ci.yml +0 -13
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +5 -5
- package/.bkit/templates/.prettierignore +1 -1
- package/.bkit/templates/context/bkit-expo.md +22 -13
- package/.bkit/templates/context/bkit-github.md +20 -6
- package/.bkit/templates/context/bkit-inngest.md +10 -4
- package/.bkit/templates/context/bkit-maestro.md +5 -5
- package/.bkit/templates/context/bkit-playwright.md +3 -3
- package/.bkit/templates/context/bkit-sentry.md +6 -5
- package/.bkit/templates/context/bkit-stripe.md +31 -8
- package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +65 -19
- package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +34 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +33 -12
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +54 -0
- package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +76 -6
- package/.bkit/templates/slop-scan.config.json +7 -2
- package/CHANGELOG.md +42 -0
- package/LICENSE.md +21 -161
- package/README.md +58 -28
- package/dist/checks/after/auth.js +28 -0
- package/dist/checks/after/github.js +4 -4
- package/dist/checks/after/index.js +29 -45
- package/dist/checks/after/managed.js +40 -1
- package/dist/checks/before/index.js +5 -4
- package/dist/checks/before/mcp.js +53 -53
- package/dist/checks/status-holes.js +1 -1
- package/dist/checks/tips/catalogue.js +297 -0
- package/dist/checks/tips/detect.js +130 -0
- package/dist/checks/tips/index.js +146 -0
- package/dist/cli.js +47 -9
- package/dist/commands/install/doctor.js +5 -1
- package/dist/commands/install/install.js +27 -7
- package/dist/commands/install/uninstall.js +31 -16
- package/dist/commands/install/upgrade.js +15 -32
- package/dist/commands/launch.js +27 -11
- package/dist/commands/tips.js +10 -0
- package/dist/commands/workflow/runs.js +52 -16
- package/dist/commands/workflow/runtime.js +8 -0
- package/dist/commands/workflow/steps.js +1 -0
- package/dist/commands/workflow/tests.js +541 -4
- package/dist/commands/workflow/workstreams.js +4 -4
- package/dist/install/cloud-env.js +3 -14
- package/dist/install/hosts.js +22 -0
- package/dist/install/managed-block.js +36 -0
- package/dist/install/manifest.js +45 -4
- package/dist/install/modules/antigravity.js +8 -7
- package/dist/install/modules/claude.js +6 -6
- package/dist/install/modules/cloud.js +2 -2
- package/dist/install/modules/codex.js +5 -5
- package/dist/install/modules/core.js +14 -5
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +4 -4
- package/dist/install/payload-links.js +5 -5
- package/dist/install/placeholders.js +1 -1
- package/dist/install/version-file.js +12 -3
- package/dist/install/write.js +61 -2
- package/dist/shared/package-roots.js +8 -11
- package/package.json +4 -6
- package/.bkit/core/LICENSE.md +0 -149
- package/.bkit/shared/LICENSE.md +0 -22
- package/.bkit/templates/LICENSE.md +0 -22
|
@@ -2,150 +2,28 @@
|
|
|
2
2
|
|
|
3
3
|
{{BKIT_MANAGED_MARKER}}
|
|
4
4
|
|
|
5
|
-
Every file bkit wrote into this repository, and keeps current on `bkit upgrade`,
|
|
6
|
-
|
|
7
|
-
Required Notice: Copyright 2026 Christian Bartens (https://github.com/cbartens/bkit)
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# PolyForm Noncommercial License 1.0.0
|
|
12
|
-
|
|
13
|
-
<https://polyformproject.org/licenses/noncommercial/1.0.0>
|
|
14
|
-
|
|
15
|
-
## Acceptance
|
|
16
|
-
|
|
17
|
-
In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
|
|
18
|
-
|
|
19
|
-
## Copyright License
|
|
20
|
-
|
|
21
|
-
The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose. However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
|
|
22
|
-
|
|
23
|
-
## Distribution License
|
|
24
|
-
|
|
25
|
-
The licensor grants you an additional copyright license to distribute copies of the software. Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
|
|
26
|
-
|
|
27
|
-
## Notices
|
|
28
|
-
|
|
29
|
-
You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software. For example:
|
|
30
|
-
|
|
31
|
-
> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
|
|
32
|
-
|
|
33
|
-
## Changes and New Works License
|
|
34
|
-
|
|
35
|
-
The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
|
|
36
|
-
|
|
37
|
-
## Patent License
|
|
38
|
-
|
|
39
|
-
The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
|
|
40
|
-
|
|
41
|
-
## Noncommercial Purposes
|
|
42
|
-
|
|
43
|
-
Any noncommercial purpose is a permitted purpose.
|
|
44
|
-
|
|
45
|
-
## Personal Uses
|
|
46
|
-
|
|
47
|
-
Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
|
|
48
|
-
|
|
49
|
-
## Noncommercial Organizations
|
|
50
|
-
|
|
51
|
-
Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
|
|
52
|
-
|
|
53
|
-
## Fair Use
|
|
54
|
-
|
|
55
|
-
You may have "fair use" rights for the software under the law. These terms do not limit them.
|
|
56
|
-
|
|
57
|
-
## No Other Rights
|
|
58
|
-
|
|
59
|
-
These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else. These terms do not imply any other licenses.
|
|
60
|
-
|
|
61
|
-
## Patent Defense
|
|
62
|
-
|
|
63
|
-
If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
|
|
64
|
-
|
|
65
|
-
## Violations
|
|
66
|
-
|
|
67
|
-
The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice. Otherwise, all your licenses end immediately.
|
|
68
|
-
|
|
69
|
-
## No Liability
|
|
70
|
-
|
|
71
|
-
_**As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.**_
|
|
72
|
-
|
|
73
|
-
## Definitions
|
|
74
|
-
|
|
75
|
-
The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
|
|
76
|
-
|
|
77
|
-
**You** refers to the individual or entity agreeing to these terms.
|
|
78
|
-
|
|
79
|
-
**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
|
|
80
|
-
|
|
81
|
-
**Your licenses** are all the licenses granted to you for the software under these terms.
|
|
82
|
-
|
|
83
|
-
**Use** means anything you do with the software requiring one of your licenses.
|
|
5
|
+
Every file bkit wrote into this repository, and keeps current on `bkit upgrade`, and every template it copied into `.bkit/templates/`, is licensed under the MIT License below. What bkit's agents write for you is yours, not covered by this licence.
|
|
84
6
|
|
|
85
7
|
---
|
|
86
8
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
<https://polyformproject.org/licenses/small-business/1.0.0>
|
|
90
|
-
|
|
91
|
-
## Acceptance
|
|
92
|
-
|
|
93
|
-
In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
|
|
94
|
-
|
|
95
|
-
## Copyright License
|
|
96
|
-
|
|
97
|
-
The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose. However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
|
|
98
|
-
|
|
99
|
-
## Distribution License
|
|
100
|
-
|
|
101
|
-
The licensor grants you an additional copyright license to distribute copies of the software. Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
|
|
102
|
-
|
|
103
|
-
## Notices
|
|
104
|
-
|
|
105
|
-
You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software. For example:
|
|
106
|
-
|
|
107
|
-
> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
|
|
108
|
-
|
|
109
|
-
## Changes and New Works License
|
|
110
|
-
|
|
111
|
-
The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
|
|
112
|
-
|
|
113
|
-
## Patent License
|
|
114
|
-
|
|
115
|
-
The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
|
|
116
|
-
|
|
117
|
-
## Fair Use
|
|
118
|
-
|
|
119
|
-
You may have "fair use" rights for the software under the law. These terms do not limit them.
|
|
120
|
-
|
|
121
|
-
## Small Business
|
|
122
|
-
|
|
123
|
-
Use of the software for the benefit of your company is use for a permitted purpose if your company has fewer than 100 total individuals working as employees and independent contractors, and less than 1,000,000 USD (2019) total revenue in the prior tax year. Adjust this revenue threshold for inflation according to the United States Bureau of Labor Statistics' consumer price index for all urban consumers, U.S. city average, for all items, not seasonally adjusted, with 1982–1984=100 reference base.
|
|
124
|
-
|
|
125
|
-
## No Other Rights
|
|
126
|
-
|
|
127
|
-
These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else. These terms do not imply any other licenses.
|
|
128
|
-
|
|
129
|
-
## Patent Defense
|
|
130
|
-
|
|
131
|
-
If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
|
|
132
|
-
|
|
133
|
-
## Violations
|
|
134
|
-
|
|
135
|
-
The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice. Otherwise, all your licenses end immediately.
|
|
136
|
-
|
|
137
|
-
## No Liability
|
|
138
|
-
|
|
139
|
-
_**As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.**_
|
|
140
|
-
|
|
141
|
-
## Definitions
|
|
142
|
-
|
|
143
|
-
The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
|
|
9
|
+
MIT License
|
|
144
10
|
|
|
145
|
-
|
|
11
|
+
Copyright (c) 2026 Christian Bartens
|
|
146
12
|
|
|
147
|
-
|
|
13
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
14
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
15
|
+
in the Software without restriction, including without limitation the rights
|
|
16
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
17
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
18
|
+
furnished to do so, subject to the following conditions:
|
|
148
19
|
|
|
149
|
-
|
|
20
|
+
The above copyright notice and this permission notice shall be included in all
|
|
21
|
+
copies or substantial portions of the Software.
|
|
150
22
|
|
|
151
|
-
|
|
23
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
24
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
25
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
26
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
27
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
28
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
29
|
+
SOFTWARE.
|
|
@@ -20,7 +20,7 @@ Typical cycle for `ISSUE-123` "Add feature X":
|
|
|
20
20
|
6. **Phase summary** — verdict (`PASS` / `CONCERNS` / `FAIL`); commit `chore(issue-123-…): summary bkit [skip ci]` (design/plan) or `chore(issue-123-…): summary` (build/debug/ship) → push.
|
|
21
21
|
7. **Close Workflow** — tracker `In Review`; phase label persists. `/bkit-design` / `/bkit-plan`: prune worktree, delete `feat/issue-123-…` (merged into `dev`). `/bkit-build` / `/bkit-debug`: worktree persists.
|
|
22
22
|
8. **Human review** — design/plan at `docs/plans/{YYYYMM}/{FID}-{design,plan}.md` (canonical). Reviewer re-triggers or progresses to `/bkit-build`.
|
|
23
|
-
9. **`/bkit-build`** — re-creates worktree, executes plan, lint/typecheck/unit tests, opens PR to `dev`.
|
|
23
|
+
9. **`/bkit-build`** — re-creates worktree, executes plan test-first (each task's tests fail before its code, then pass), lint/typecheck/unit tests, opens PR to `dev`.
|
|
24
24
|
10. **CI** on PR. Red → `/bkit-debug` (PR mode: `gh run view --log-failed`). Green → `/bkit-ship`.
|
|
25
25
|
11. **`/bkit-ship`** — squash-merge PR, `@bkit-ship-update-docs` ‖ `@bkit-ship-summary` (parallel) on `dev`, prune worktree, issue `In Review` (`bkit:merged`; bkit never auto-closes). Plans stay at `docs/plans/{YYYYMM}/` — no archive move.
|
|
26
26
|
|
|
@@ -187,6 +187,7 @@ bkit upgrade # re-render at CURRENT installed version (offline)
|
|
|
187
187
|
bkit upgrade --latest # bump @cbartens/bkit + resync in one step (or --to=<version>)
|
|
188
188
|
bkit check # drift gate — exits non-zero on drift
|
|
189
189
|
bkit doctor # advisories only; exits 0; no managed-file writes
|
|
190
|
+
bkit tips [--all] # what is not set up yet, most useful first; exits 0
|
|
190
191
|
bkit install --claude --cursor # (re)seed hosts; name ≥1 module
|
|
191
192
|
```
|
|
192
193
|
|
|
@@ -211,10 +212,10 @@ bkit owns some files outright, owns one part of others, and ships the rest as te
|
|
|
211
212
|
| Kind | Semantics | Files |
|
|
212
213
|
| --- | --- | --- |
|
|
213
214
|
| **Tier 1 — Fully managed** | Idempotent rewrite of whole file on every install. A consumer edit is overwritten. Uninstall deletes the file while it still matches the hash bkit recorded. | `.cursor/hooks.json`, `.bkit/*.md` (except `prompts.md`, Tier 2), `.bkit/.env.example`, `.cursor/allowlist.json`, `.cursor/cli.json` |
|
|
214
|
-
| **Tier 2 — Managed-block** | bkit owns content between `bkit:start`/`bkit:end` markers. Consumer owns everything outside. File absent → write whole file. File present without markers → append block at EOF. A full uninstall strips the block and deletes a file left with nothing else; `docs/templates/bkit-*.md` are bkit's whole and are deleted. | `docs/*.md`, `docs/templates/bkit-*.md`, `.gitignore`, `.agents/rules.md`, `.agents/context.md`, `.agents/docs.md`, `.agents/skills.md`, `AGENTS.md`, `CLAUDE.md`, `.claude/hooks/bkit-preflight.sh`, `.cursor/hooks/bkit-preflight.sh`, `.claude/hooks/bkit-gateguard.cjs`, `.cursor/hooks/bkit-gateguard.cjs`, `.opencode/plugin/bkit-gateguard.js`, `.cursor/hooks/bkit-guardrails.cjs`, `.codex/hooks/bkit-gateguard.cjs`, `.codex/hooks/bkit-guardrails.cjs` |
|
|
215
|
+
| **Tier 2 — Managed-block** | bkit owns content between `bkit:start`/`bkit:end` markers. Consumer owns everything outside. File absent → write whole file. File present without markers → append block at EOF, unless the markdown file already holds an older unmarked copy of the block (its `# ` title plus 10+ long lines verbatim) → warn + skip. A full uninstall strips the block and deletes a file left with nothing else; `docs/templates/bkit-*.md` are bkit's whole and are deleted. | `docs/*.md`, `docs/templates/bkit-*.md`, `.gitignore`, `.agents/rules.md`, `.agents/context.md`, `.agents/docs.md`, `.agents/skills.md`, `AGENTS.md`, `CLAUDE.md`, `.claude/hooks/bkit-preflight.sh`, `.cursor/hooks/bkit-preflight.sh`, `.claude/hooks/bkit-gateguard.cjs`, `.cursor/hooks/bkit-gateguard.cjs`, `.opencode/plugin/bkit-gateguard.js`, `.cursor/hooks/bkit-guardrails.cjs`, `.codex/hooks/bkit-gateguard.cjs`, `.codex/hooks/bkit-guardrails.cjs` |
|
|
215
216
|
| **Shared JSON** | bkit owns the keys its template sets; every other key is yours. `.mcp.json` / `.cursor/mcp.json`: bkit owns exactly one entry, `mcpServers.<tracker>`, and resets it to the template on every install and upgrade. | `.claude/settings.json`, `.opencode/opencode.json`, `.mcp.json`, `.cursor/mcp.json` |
|
|
216
217
|
| **Seeded package.json scripts** | Every install and upgrade adds a missing name with bkit's default; a name already present is never touched, whatever its value. `bkit check` reports a missing name. Uninstall leaves them. | `scripts.bkit:gate:format` / `bkit:gate:static` / `bkit:gate:static-unit` / `bkit:gate:install-static-unit-build` / `bkit:deps:outdated` / `bkit:deps:audit` |
|
|
217
|
-
| **Templates** | Never written into your repo. Install and upgrade copy them, raw, into `.bkit/templates/`; you copy what you want and own it. Catalog: `.bkit/templates.md`. | `.github/workflows/bkit-ci.yml`, `.github/workflows/bkit-cloud.yml`, `.husky/*`, `.vale.ini`, `.vale/styles/House/*`, `.lintstagedrc.json`, `slop-scan.config.json`, `.prettierignore`, `.envrc`, `.cursor/{settings.json,environment.json,Dockerfile}`, dependency-updater examples, the per-provider context-fetch blocks (`context/bkit-*.md`), `scripts/slop/bkit-slop-type-suppression.mjs
|
|
218
|
+
| **Templates** | Never written into your repo. Install and upgrade copy them, raw, into `.bkit/templates/`; you copy what you want and own it. Catalog: `.bkit/templates.md`. | `.github/workflows/bkit-ci.yml`, `.github/workflows/bkit-cloud.yml`, `.husky/*`, `.vale.ini`, `.vale/styles/House/*`, `.lintstagedrc.json`, `slop-scan.config.json`, `.prettierignore`, `.envrc`, `.cursor/{settings.json,environment.json,Dockerfile}`, dependency-updater examples, the per-provider context-fetch blocks (`context/bkit-*.md`), `scripts/slop/bkit-slop-type-suppression.mjs`. Also the tool `package.json` scripts (`typecheck`, `lint`, `format:check`, `lint:prose`, `lint:slop`, `slop:delta`, `prepare`) and devDeps (prettier, slop-scan, lint-staged, husky): `.bkit/templates.md` lists them, install never adds them. |
|
|
218
219
|
|
|
219
220
|
**Marker syntax** format-specific:
|
|
220
221
|
|
|
@@ -224,9 +225,9 @@ bkit owns some files outright, owns one part of others, and ships the rest as te
|
|
|
224
225
|
|
|
225
226
|
Comment prefixes (`# `, `// `) before markers preserved on block updates.
|
|
226
227
|
|
|
227
|
-
**Managed-version marker.** Every non-JSON file bkit writes carries `bkit:managed vX.Y.Z` — first line inside the `bkit:start` block, or near the top of a whole file — in its comment syntax: `<!-- … -->` (markdown), `# <!-- … -->` (shell, `.gitignore`, `.gitattributes`, `.env.example`, TOML), `// …` (JS). The
|
|
228
|
+
**Managed-version marker.** Every non-JSON file bkit writes carries `bkit:managed vX.Y.Z` — first line inside the `bkit:start` block, or near the top of a whole file — in its comment syntax: `<!-- … -->` (markdown), `# <!-- … -->` (shell, `.gitignore`, `.gitattributes`, `.env.example`, TOML), `// …` (JS). The full MIT text and copyright notice travel at `.bkit/LICENSE.md`. Install and upgrade restamp it; `bkit check` reports `bkit-managed-stale` for a marker that differs from the installed version (blocker on `main` / `dev`, advisory on feature branches). Templates carry no marker and no block.
|
|
228
229
|
|
|
229
|
-
**Hook scripts.** Install generates each host's `bkit-preflight.sh`, `gateguard` and `guardrails` hook from its template plus the code the hosts share (`.bkit/core/hooks/`, `.bkit/providers.md` § Hooks). bkit's block in
|
|
230
|
+
**Hook scripts.** Install generates each host's `bkit-preflight.sh`, `gateguard`, `readguard` and `guardrails` hook from its template plus the code the hosts share (`.bkit/core/hooks/`, `.bkit/providers.md` § Hooks). bkit's block in the `bkit-gateguard` / `bkit-readguard` hooks and plugins and the `bkit-guardrails.cjs` hooks is a pure advisory engine — no stdin read, no stdout write, no top-level call — so it cannot collide with a consumer's own emitter. Delivery is per host: Claude / Cursor / Codex inject the checklist before the edit, opencode appends it to the tool result in `execute.after` (`BKIT_GATEGUARD=deny` is the only pre-edit block) — see `.bkit/providers.md` § Hooks. A consumer file with no markers gets the block appended; wire its exported function into your driver.
|
|
230
231
|
|
|
231
232
|
### What install writes
|
|
232
233
|
|
|
@@ -243,12 +244,13 @@ Comment prefixes (`# `, `// `) before markers preserved on block updates.
|
|
|
243
244
|
| `.gitattributes` | core | `.bkit/shared/.gitattributes` | Tier 2 html-comment (`merge=union` for the append-only ledgers) |
|
|
244
245
|
| `.bkit/templates/**` | — | the whole `.bkit/templates/` root | Raw copies, refreshed on every install and upgrade; never hashed. Upgrade prints the changed paths. |
|
|
245
246
|
| `.bkit/{core,shared}` | core | symlink into `node_modules/@cbartens/bkit/.bkit/{core,shared}` | View link, not a copy — browse the payload in-repo; always the installed version. Gitignored (dangles on a fresh clone / CI; install recreates). A real directory is never clobbered; `bkit uninstall` removes the link. |
|
|
246
|
-
| `.bkit/{cloud,comparison,install,jsonl,LICENSE,providers,prompts,trackers,workflows,README}.md` | core | `.bkit/core/.bkit/` | Tier 1 (canonical-overwrite). The reference docs agents read at runtime, plus `LICENSE.md`: the
|
|
247
|
+
| `.bkit/{cloud,comparison,install,jsonl,LICENSE,providers,prompts,trackers,workflows,README}.md` | core | `.bkit/core/.bkit/` | Tier 1 (canonical-overwrite). The reference docs agents read at runtime, plus `LICENSE.md`: the MIT text and copyright notice that travel with every file bkit writes. |
|
|
247
248
|
| `.claude/commands/bkit-*.md` | claude | `.bkit/core/workflows/` (byte-identical) | Host pass — always overwrite |
|
|
248
249
|
| `.claude/agents/bkit-*.md` | claude | `.bkit/core/prompts/` (byte-identical) | Host pass — always overwrite |
|
|
249
250
|
| `.claude/settings.json` | claude | `.bkit/shared/.claude/settings.json` | Tier 2 JSON deep-containment. Permission allow/deny/ask + SessionStart / PreToolUse hook wiring. |
|
|
250
251
|
| `.claude/hooks/bkit-preflight.sh` | claude | `.bkit/core/.claude/hooks/` | Tier 2 html-comment (`# ` prefix) |
|
|
251
252
|
| `.claude/hooks/bkit-gateguard.cjs` | claude | `.bkit/core/.claude/hooks/` | Tier 2 slash-comment |
|
|
253
|
+
| `.claude/hooks/bkit-readguard.cjs` | claude | `.bkit/core/.claude/hooks/` | Tier 2 slash-comment. Repeat-read advisory. |
|
|
252
254
|
| `.mcp.json` | claude | `.bkit/shared/.mcp.json` | Shared JSON: bkit owns `mcpServers.<tracker>` only; absent file → the tracker-filtered render |
|
|
253
255
|
| `.bkit/.env.example` | claude | `.bkit/shared/.bkit/.env.example` | Tier 1 (fully managed). Real values go in `.bkit/.env`. |
|
|
254
256
|
| `.cursor/commands/bkit-*.md` | cursor | `.bkit/core/workflows/` (T1+T2 transforms) | Host pass — always overwrite |
|
|
@@ -261,12 +263,14 @@ Comment prefixes (`# `, `// `) before markers preserved on block updates.
|
|
|
261
263
|
| `.cursor/hooks/bkit-preflight.sh` | cursor | `.bkit/core/.cursor/hooks/` | Tier 2 html-comment (`# ` prefix) |
|
|
262
264
|
| `.cursor/hooks/bkit-guardrails.cjs` | cursor | `.bkit/core/.cursor/hooks/` | Tier 2 slash-comment. Destructive-op + curl/wget host gates. |
|
|
263
265
|
| `.cursor/hooks/bkit-gateguard.cjs` | cursor | `.bkit/core/.cursor/hooks/` | Tier 2 slash-comment |
|
|
266
|
+
| `.cursor/hooks/bkit-readguard.cjs` | cursor | `.bkit/core/.cursor/hooks/` | Tier 2 slash-comment. Repeat-read advisory. |
|
|
264
267
|
| `.cursor/allowlist.json` | cursor | derived from bkit's shipped egress registry, union `.agents/context.md` allowed-domains | Tier 1 (canonical-overwrite). Curl/wget host allowlist `bkit-guardrails.cjs` reads at runtime. |
|
|
265
268
|
| `.cursor/cli.json` | cursor | derived from `.agents/context.md` mcp-servers | Tier 1 (canonical-overwrite). Cursor CLI / cloud-agent `Mcp(<server>:*)` allows. |
|
|
266
269
|
| `.opencode/opencode.json` | opencode | `.bkit/shared/.opencode/opencode.json` | Tier 2 JSON deep-containment; `@@OPENCODE_*@@` sentinels rendered to the chosen tracker + provider. **Opt-in via `bkit install --opencode=<provider>`**. |
|
|
267
270
|
| `.opencode/commands/bkit-*.md` | opencode | `.bkit/core/workflows/` | Host pass — always overwrite |
|
|
268
271
|
| `.opencode/agents/bkit-*.md` | opencode | `.bkit/core/prompts/` | Host pass — always overwrite |
|
|
269
272
|
| `.opencode/plugin/bkit-gateguard.js` | opencode | `.bkit/core/.opencode/plugin/` | Tier 2 slash-comment |
|
|
273
|
+
| `.opencode/plugin/bkit-readguard.js` | opencode | `.bkit/core/.opencode/plugin/` | Tier 2 slash-comment. Repeat-read advisory. |
|
|
270
274
|
| `.claude/hooks/bkit-cloud-bootstrap.sh` | — | `.bkit/templates/.claude/hooks/` | Copy-and-own template: no module writes it; adopt it from `.bkit/templates/` (the SessionStart entry runs it only when present). |
|
|
271
275
|
|
|
272
276
|
The cloud workflow and the Cursor Background Agent files are templates the `--auto` setup advisory points at.
|
|
@@ -24,13 +24,13 @@ Three cloud stacks — each agent pairs with one tracker. Pick row for agent you
|
|
|
24
24
|
<!-- prettier-ignore -->
|
|
25
25
|
| Agent (the agent, not the editor) | Ways to launch a cloud agent | Tracker | not supported |
|
|
26
26
|
| --- | --- | --- | --- |
|
|
27
|
-
| **Claude Code** (terminal — any IDE host) | **A)** Claude iOS / desktop app → Claude-on-web env (`.claude/hooks/bkit-cloud-bootstrap.sh` + the env defined in `claude.ai/code`) · **B)** manual `workflow_dispatch` on `bkit-cloud.yml` (pick
|
|
28
|
-
| **opencode** (GitHub runner) | **A)** manual `workflow_dispatch` on `bkit-cloud.yml` (pick
|
|
27
|
+
| **Claude Code** (terminal — any IDE host) | **A)** Claude iOS / desktop app → Claude-on-web env (`.claude/hooks/bkit-cloud-bootstrap.sh` + the env defined in `claude.ai/code`) · **B)** manual `workflow_dispatch` on `bkit-cloud.yml` (pick phase + issue) · **C)** GitHub CI pass/fail → `bkit-cloud.yml` claude job · **D)** `@claude` mention on a GitHub issue / PR (`/install-github-app` required — **base requirement** for `cloud=claude`) | **GitHub** | **Linear** |
|
|
28
|
+
| **opencode** (GitHub runner) | **A)** manual `workflow_dispatch` on `bkit-cloud.yml` (pick phase + issue) · **B)** GitHub CI pass/fail → `bkit-cloud.yml` opencode job (requires `OPENCODE_PROVIDER_KEY` secret) · **C)** reactive `/oc` comment handler (self-installed, not bkit — see § Reactive comment handlers) | **GitHub** | **Linear** |
|
|
29
29
|
| **Cursor** (native agent) | **A)** Cursor's built-in cloud-agent launch · **B)** Cursor's GitHub integration on PR events (CI pass/fail) · **C)** Linear → Cursor integration | **Linear** (+ GitHub PR events) | **GitHub Projects / Issues** |
|
|
30
30
|
|
|
31
31
|
**Unified file — additive coexistence:** Claude + opencode share one `bkit-cloud.yml`: a `context` job resolves the phase once, then two runner jobs, each runtime-gated on its secret (`ANTHROPIC_API_KEY` claude, `OPENCODE_PROVIDER_KEY` opencode). Both jobs can fire on same CI event — both secrets → both agents; one secret → one agent. Cursor separate (no GH Action; native triggers). **Cursor cloud ↔ Linear.**
|
|
32
32
|
|
|
33
|
-
**Manual dispatch (Claude or opencode, path A):** GitHub → **Actions** → **bkit-cloud** → **Run workflow** → `phase` (`ship` / `debug` / `
|
|
33
|
+
**Manual dispatch (Claude or opencode, path A):** GitHub → **Actions** → **bkit-cloud** → **Run workflow** → `phase` (`ship` / `debug` / `plan` / `build`) + `issue`. On-demand/smoke-test for `plan` / `build`; `ship` / `debug` normally CI-fired. `design` runs locally — its Grill step interviews the human; a headless run (`runtimeHeadless` = true: GitHub runner, Cursor cloud agent, unknown runtime) skips the interview and records each recommended answer as `Assumed, not confirmed`. Dispatched `/bkit-auto` orchestrator → matching phase skill → brief from GitHub issue (MCP).
|
|
34
34
|
|
|
35
35
|
### Reactive comment handlers (`claude.yml` + `opencode.yml`) — separately managed, not bkit
|
|
36
36
|
|
|
@@ -49,7 +49,7 @@ Three cloud stacks — each agent pairs with one tracker. Pick row for agent you
|
|
|
49
49
|
<!-- prettier-ignore -->
|
|
50
50
|
| Configuration | Lives in the repo (bkit-managed) | Lives in the online dashboard (manual, one-time) |
|
|
51
51
|
| --- | --- | --- |
|
|
52
|
-
| **Claude Code on the web** | `.claude/hooks/bkit-preflight.sh` (tracker opt-in guard) + `.claude/hooks/bkit-cloud-bootstrap.sh` (per-session install — copy-and-own template, adopt it from `.bkit/templates/`) | `claude.ai/code` → environment selector → **+ Add environment**: name, **setup script** (paste from § Setup script), **environment variables** (`BKIT_GH_TOKEN
|
|
52
|
+
| **Claude Code on the web** | `.claude/hooks/bkit-preflight.sh` (tracker opt-in guard) + `.claude/hooks/bkit-cloud-bootstrap.sh` (per-session install — copy-and-own template, adopt it from `.bkit/templates/`) | `claude.ai/code` → environment selector → **+ Add environment**: name, **setup script** (paste from § Setup script), **environment variables** (`BKIT_GH_TOKEN` — Claude pairs with the **GitHub** tracker, so no `BKIT_LINEAR_API_KEY`), **network access** (`Trusted`) |
|
|
53
53
|
| **Cursor Cloud Agents** | `.cursor/Dockerfile` + `.cursor/environment.json` (`install` / `start` / `terminals[]` / `env`), both copied from bkit's templates and owned by the repo, + `.cursor/hooks.json` (wires preflight `failClosed: true`) + `.cursor/hooks/bkit-preflight.sh` (Linear guard) | Cloud Agents dashboard (`cursor.com/dashboard/cloud-agents`) → your environment → **Secrets** tab, as **Runtime Secret**s: `BKIT_LINEAR_API_KEY`, `BKIT_GH_TOKEN`. (`LINEAR_ISSUE_ID` injected per-session by the integration — don't hardcode.) |
|
|
54
54
|
|
|
55
55
|
**Rule of thumb:** env vars / auth tokens → online dashboard (out of git). Scripts / Dockerfile / install hooks → repo.
|
|
@@ -106,7 +106,7 @@ Ships with repo — don't paste into app.
|
|
|
106
106
|
|
|
107
107
|
Name environment **after the repo** — one env per repo, secrets isolated (§ Sharing across repos). Setup script identical across repos.
|
|
108
108
|
|
|
109
|
-
Identical across repos: **setup-script body**, **network policy**, bkit **baseline token
|
|
109
|
+
Identical across repos: **setup-script body**, **network policy**, bkit **baseline token name** (`BKIT_GH_TOKEN`) — only values change. Rest of env-vars box is **this repo's own**, copied from env-var files per `.envrc` (§ Environment variables).
|
|
110
110
|
|
|
111
111
|
### Network access
|
|
112
112
|
|
|
@@ -120,7 +120,6 @@ Minimum:
|
|
|
120
120
|
|
|
121
121
|
```
|
|
122
122
|
BKIT_GH_TOKEN=<PAT — fine-grained for one owner, classic across owners; see permissions below>
|
|
123
|
-
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70
|
|
124
123
|
```
|
|
125
124
|
|
|
126
125
|
Claude pairs with **GitHub** tracker (see § Cloud-agent support matrix) — no `BKIT_LINEAR_API_KEY` / `LINEAR_ISSUE_ID`. Set `BKIT_GH_TOKEN` for GitHub MCP; authenticate `gh` via `gh auth login --with-token` in bootstrap hook (env vars not visible during setup script — see § Notes).
|
|
@@ -160,7 +159,7 @@ SUPABASE_ACCESS_TOKEN=<Supabase Management API token — https://supabase.com/da
|
|
|
160
159
|
#### Notes
|
|
161
160
|
|
|
162
161
|
- Claude app warns "don't add secrets" — env vars visible to anyone with edit rights. Personal account = just you; team account = treat as low-trust.
|
|
163
|
-
-
|
|
162
|
+
- Earlier auto-compaction: set `autoCompactWindow` in committed `.claude/settings.json` (`.bkit/providers.md` § Context compaction) — applies to cloud sessions as-is; no env var.
|
|
164
163
|
- **Env vars set in Claude app are not visible inside setup script.** Injected only after Claude Code starts → `SessionStart` hooks + interactive shell, not snapshot build. Tool needing token to bootstrap must inline it — leak you want to avoid. Avoided today: vale / gh / corepack don't need auth.
|
|
165
164
|
|
|
166
165
|
### Setup script
|
|
@@ -218,7 +217,7 @@ Token management by session type:
|
|
|
218
217
|
|
|
219
218
|
## MCP issue-tracker integration
|
|
220
219
|
|
|
221
|
-
bkit wires two MCP servers into `.mcp.json` at repo root (project-shared, read by Claude Code `/mcp` UI). Cursor reads same shape from `.cursor/mcp.json`. Both **remote HTTP MCPs
|
|
220
|
+
bkit wires two MCP servers into `.mcp.json` at repo root (project-shared, read by Claude Code `/mcp` UI). Cursor reads same shape from `.cursor/mcp.json`. Both **remote HTTP MCPs** — no docker. Linear: OAuth on first use — Claude Code launches browser auth on first server touch, stores token in own secret store. GitHub: `BKIT_GH_TOKEN` PAT in the `Authorization` header — no OAuth.
|
|
222
221
|
|
|
223
222
|
> Note: `mcpServers` in `.claude/settings.json` silently ignored by Claude Code — definitions only from `.mcp.json` (project) or `claude mcp add` (user scope). `mcp__<name>__*` in `.claude/settings.json` `permissions.allow` are tool-permission allowlists — different concern, remain there.
|
|
224
223
|
|
|
@@ -271,10 +270,9 @@ bkit wires two MCP servers into `.mcp.json` at repo root (project-shared, read b
|
|
|
271
270
|
> [!TIP]
|
|
272
271
|
> **No manual copy needed for the dashboard secrets.** `bkit install --cursor` writes
|
|
273
272
|
> `.cursor/bkit-cloud.md` — the twin of `.claude/bkit-cloud.md`, with the Cursor secrets block
|
|
274
|
-
> **resolved from `.envrc`** (Linear tracker adds `BKIT_LINEAR_API_KEY
|
|
275
|
-
> `
|
|
276
|
-
>
|
|
277
|
-
> as a **Runtime Secret** (loaded as an env var, redacted from the agent's transcript).
|
|
273
|
+
> **resolved from `.envrc`** (Linear tracker adds `BKIT_LINEAR_API_KEY`). Open it, then in the
|
|
274
|
+
> Cloud Agents dashboard (`cursor.com/dashboard/cloud-agents`) → your environment → **Secrets**
|
|
275
|
+
> tab, add each as a **Runtime Secret** (loaded as an env var, redacted from the agent's transcript).
|
|
278
276
|
> Gitignored (holds real secrets); regenerates on every install/upgrade. The toolchain
|
|
279
277
|
> half is the committed `.cursor/Dockerfile` + `.cursor/environment.json` (nothing to
|
|
280
278
|
> paste) — same tools, same versions as the Claude setup script.
|
|
@@ -313,7 +311,7 @@ GitHub dispatch uses Cursor Automations "Pull request label changed" trigger —
|
|
|
313
311
|
BKIT_GH_TOKEN=<PAT — fine-grained for one owner, classic across owners; same permissions as the Claude side>
|
|
314
312
|
```
|
|
315
313
|
|
|
316
|
-
`GITHUB_ISSUE_ID` injected per-session — do not hardcode. No `BKIT_LINEAR_API_KEY` or `LINEAR_ISSUE_ID` for tracker calls (MCP auth =
|
|
314
|
+
`GITHUB_ISSUE_ID` injected per-session — do not hardcode. No `BKIT_LINEAR_API_KEY` or `LINEAR_ISSUE_ID` for tracker calls (GitHub MCP auth = `BKIT_GH_TOKEN` above; `gh` uses `gh auth login` locally or `--with-token` in cloud bootstrap).
|
|
317
315
|
|
|
318
316
|
## How Linear dispatch works
|
|
319
317
|
|
|
@@ -364,7 +362,7 @@ Each repo gets **own** Claude environment, named after repo. Reason: **secrets,
|
|
|
364
362
|
Shared across repos (copy, don't re-derive) — non-secret only:
|
|
365
363
|
|
|
366
364
|
- **Setup script** — generic binaries only (vale, gh, pnpm via corepack); repo-specific install deferred to committed `bkit-cloud-bootstrap.sh` (lockfile → `pnpm install`, `.vale.ini` → `vale sync`). One body fits every repo.
|
|
367
|
-
- **bkit baseline token
|
|
365
|
+
- **bkit baseline token _name_** (`BKIT_GH_TOKEN`) + **network policy** (`Trusted`) — same everywhere, values differ. Repo _other_ env vars **not** shared: copy from own env files per `.envrc` — drop `unset`s, skip `BKIT_ANTHROPIC_API_KEY` (§ Environment variables).
|
|
368
366
|
- **Non-secret selectors** (`VERCEL_SCOPE`, `SUPABASE_PROJECT_ID`) stay committed in-repo (§ Environment variables), never in dashboard.
|
|
369
367
|
|
|
370
368
|
## Cursor — byte-identical Dockerfile
|
|
@@ -484,7 +482,6 @@ Skip conditions emit single GitHub-comment no-op line and exit 0 — only real f
|
|
|
484
482
|
- **Cursor image cache layer-based.** Reorder `RUN` lines carefully — frequently-changing line above slow one invalidates cache below.
|
|
485
483
|
- **GitHub App vs `/web-setup` (Claude).** Auto-fix PRs require GitHub App. `/web-setup` (sync `gh` token to Claude account) enough for clone + push, not auto-fix.
|
|
486
484
|
- **IP allowlists** on org GitHub / Anthropic accounts block cloud sessions — contact support to exempt managed infra.
|
|
487
|
-
- **pnpm `.npmrc` substitution.** Use `${VAR}` only, never `${VAR:-default}` — pnpm does not parse POSIX fallback and sends no auth → 401 on `@cbartens/bkit`. Both clouds equally.
|
|
488
485
|
|
|
489
486
|
# Sources
|
|
490
487
|
|
|
@@ -1,15 +1,16 @@
|
|
|
1
|
-
# bkit — Pipeline Reference &
|
|
1
|
+
# bkit — Comparison, Pipeline Reference & Agentic Design Patterns
|
|
2
2
|
|
|
3
3
|
{{BKIT_MANAGED_MARKER}}
|
|
4
4
|
|
|
5
5
|
> [!CAUTION]
|
|
6
|
-
> **Purpose:** Human-facing reference.
|
|
6
|
+
> **Purpose:** Human-facing reference. bkit vs other AI development frameworks, five-phase pipeline + every subagent (execution order), bkit vs Antonio Gulli's _Agentic Design Patterns_. Evaluation, onboarding, outreach — not agent workflow doc-matrix.
|
|
7
7
|
>
|
|
8
8
|
> **Rules:**
|
|
9
9
|
>
|
|
10
10
|
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
11
11
|
> - Describe current state / rules, not reasons / history; state what to do, not why.
|
|
12
12
|
> - Keep prose factual; house / write-good linters apply to `*.md`; no hype adjectives.
|
|
13
|
+
> - Part 3 cells: each project's own repo / docs only, never roundups or AI summaries; no star counts; refresh the as-of month with the table.
|
|
13
14
|
> - Pipeline or subagents change → update Part 1 to match `.bkit/core/workflows/*` and `.bkit/core/.bkit/prompts.md`.
|
|
14
15
|
|
|
15
16
|
## What this is
|
|
@@ -18,7 +19,9 @@ bkit turns a single coding-agent request into gated, peer-reviewed engineering.
|
|
|
18
19
|
|
|
19
20
|
Beside those commands, 35 read-only audit templates live at `docs/templates/bkit-audit-*.md`. `@bkit-audit-generate` runs one and writes `docs/audits/{YYYYMM}/{slug}.md`. `/bkit-plan` takes a design, one or more of those reports, or both.
|
|
20
21
|
|
|
21
|
-
Part 1: every phase subagent in execution order, then the main audit templates. Part 2: bkit vs Gulli agentic patterns. Full audit catalogue: `.bkit/prompts.md` § Audit (Ad-hoc).
|
|
22
|
+
Part 1: every phase subagent in execution order, then the main audit templates. Part 2: bkit vs Gulli agentic patterns. Part 3: bkit vs 10 other AI development frameworks, one table. Full audit catalogue: `.bkit/prompts.md` § Audit (Ad-hoc).
|
|
23
|
+
|
|
24
|
+
Not related to [bkit Vibecoding Kit](https://github.com/popup-studio-ai/bkit-claude-code), a separate project with the same name. This bkit = `@cbartens/bkit`, [github.com/cbartens/bkit](https://github.com/cbartens/bkit).
|
|
22
25
|
|
|
23
26
|
---
|
|
24
27
|
|
|
@@ -31,7 +34,7 @@ Each phase lists subagents in execution order. "Parallel" = same-time run, merge
|
|
|
31
34
|
```
|
|
32
35
|
┌────────────────────── bkit-auto (opt-in cloud router) ─────────────────┐
|
|
33
36
|
│ workflow_run on feat/** → ship (CI green) / debug (CI red) │
|
|
34
|
-
│ workflow_dispatch →
|
|
37
|
+
│ workflow_dispatch → ship|debug|plan|build (design: local only) │
|
|
35
38
|
│ Dispatches the matching /bkit-* skill — runs unattended in cloud │
|
|
36
39
|
│ (Claude Code on the web / Cursor cloud agents / opencode). │
|
|
37
40
|
│ Opt-in: `bkit install --auto=claude|cursor|opencode`. See `.bkit/cloud.md`. │
|
|
@@ -40,17 +43,19 @@ Each phase lists subagents in execution order. "Parallel" = same-time run, merge
|
|
|
40
43
|
▼
|
|
41
44
|
|
|
42
45
|
/bkit-design ───── output: detailed design ───────────────────────────────────
|
|
43
|
-
1.
|
|
44
|
-
|
|
46
|
+
1. grill (human interview, one decision frontier per round;
|
|
47
|
+
skipped headless: recommended answers recorded as assumed)
|
|
48
|
+
2. fetch related (semantic tracker search, rank order → related-issues.md)
|
|
49
|
+
3. brainstorm × 3 (parallel, distinct lenses, no sibling reads)
|
|
45
50
|
• pragmatic • optimal-tradeoff • risk / pre-mortem
|
|
46
|
-
|
|
47
|
-
|
|
51
|
+
4. generate design (synthesise across lenses + related issues)
|
|
52
|
+
5. review × 2 (parallel, cross-tier models)
|
|
48
53
|
• feasibility (web) • operability (failure modes, observability, on-call)
|
|
49
|
-
|
|
54
|
+
6. spike (only if review flags load-bearing unknowns:
|
|
50
55
|
throwaway probe code, confined to the run's log folder)
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
56
|
+
7. update design (fold reviews + spike back in)
|
|
57
|
+
8. organise (decompose into workstreams + DAG)
|
|
58
|
+
9. summary (tracker-facing)
|
|
54
59
|
|
|
55
60
|
/bkit-plan ───── output: detailed plan ───────────────────────────────────────
|
|
56
61
|
1. generate plan
|
|
@@ -300,7 +305,7 @@ Benchmark: Antonio Gulli's _Agentic Design Patterns: A Hands-On Guide to Buildin
|
|
|
300
305
|
| Goal Setting & Monitoring | Already does | Issue = goal, phase labels = state, verdicts = criteria. Per-task `Done when:` in the plan template; verifier ticks only on confirmed artifacts; deferred-sweep FAILs merge on any unplanned gap; `stats.jsonl` tracks every run. |
|
|
301
306
|
| Knowledge Retrieval (RAG) | Partial | Deterministic doc-matrix retrieval plus web search in design review. No embedding RAG (Grep wins at repo scale). |
|
|
302
307
|
| Reasoning Techniques | Partial | Extended thinking (CoT) plus parallel-pair-reconcile (a form of self-consistency). No formal ToT or ReAct trace. |
|
|
303
|
-
| Guardrails / Safety | Partial | Tool sandbox, destructive-git bans, locks, verdict checks, and an advisory edit-investigation plus gate-config hook (GateGuard). `bkit steps finish` validates each step's verdict and artifacts structurally. No content-level output validators (e.g. safety classifiers). |
|
|
308
|
+
| Guardrails / Safety | Partial | Tool sandbox, destructive-git bans, locks, verdict checks, and an advisory edit-investigation plus gate-config hook (GateGuard), and an advisory repeat-read hook (ReadGuard). `bkit steps finish` validates each step's verdict and artifacts structurally. No content-level output validators (e.g. safety classifiers). |
|
|
304
309
|
| Evaluation & Monitoring | Partial | `friction` / `knowledge` logs, CI gates, and a catalog-parity drift check. No automated regression-fixture eval harness yet. |
|
|
305
310
|
| Exploration & Discovery | Partial | Divergent brainstorm triplet plus feasibility search. No temperature-spread or vote-of-K. |
|
|
306
311
|
| Inter-Agent Communication (A2A) | N/A by design | Agents communicate only via filesystem artifacts — deliberate, to preserve leaf-only and resume guarantees. |
|
|
@@ -323,4 +328,51 @@ Most partials = deliberate scope. Two remain: automated eval harness with regres
|
|
|
323
328
|
|
|
324
329
|
---
|
|
325
330
|
|
|
326
|
-
|
|
331
|
+
## Part 3 — Compared with other AI development frameworks
|
|
332
|
+
|
|
333
|
+
As of October 2026. A cross-section of 10: the closest process frameworks, the two main spec toolkits, the largest skills pack, an autonomous agent platform and an agentic IDE. Each row read from the project's own repo and docs. ✅ yes · ◐ partly · — no · ? not documented.
|
|
334
|
+
|
|
335
|
+
<!-- prettier-ignore -->
|
|
336
|
+
| Column | Means |
|
|
337
|
+
| --- | --- |
|
|
338
|
+
| Kind | **Framework** runs a fixed multi-phase process · **Spec toolkit** writes specs / plans, agent does the rest · **Skills pack** library of skills / agents / commands, no fixed process · **Agent** product that writes code itself · **Editor** IDE or single-agent pair programmer |
|
|
339
|
+
| Phases | Own commands / agents for: design, plan, build, review, fix (debug failures), merge |
|
|
340
|
+
| Reviewers | Work reviewed by agents that did not write it |
|
|
341
|
+
| Sign-offs | Process stops for human approval at fixed points |
|
|
342
|
+
| Checked | "Done" verified by code / tests, not the agent's word |
|
|
343
|
+
| CI | Ships a CI pipeline for your project |
|
|
344
|
+
| Memory | File-based lessons / decisions later runs read |
|
|
345
|
+
| Parallel | Several features at once, isolated (e.g. worktrees) |
|
|
346
|
+
| Cloud | Runs unattended, triggered or hosted |
|
|
347
|
+
| Guards | Hooks that block dangerous actions |
|
|
348
|
+
| Audits | Audit / checklist templates |
|
|
349
|
+
|
|
350
|
+
<!-- prettier-ignore -->
|
|
351
|
+
| Project | Kind | Licence | Phases | Reviewers | Sign-offs | Checked | CI | Tracker | Memory | Docs | Parallel | Cloud | Guards | Audits | AI tools | Ahead of bkit on |
|
|
352
|
+
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
|
|
353
|
+
| **bkit** | Framework | MIT | all six | ✅ bug + security reviewers, blind to each other | ✅ design, plan, merge | ✅ + each task's tests seen failing before its code | ✅ capstone fails on skipped lane / zero tests | GitHub, Linear | ✅ | ✅ | ✅ | ✅ ship on green, debug on red | ✅ all hosts | ✅ 35 | 5 | — |
|
|
354
|
+
| [Superpowers](https://github.com/obra/superpowers) | Framework | MIT | all six; fix local only; merge or PR, no CI wait | ◐ fresh reviewer per task + whole branch | ✅ design, plan, merge | ✅ task done only if its test passes | — | — | — | — | ◐ | ? | ◐ prompt rules | — | 16 | skills trigger automatically; skill eval harness; official marketplaces |
|
|
355
|
+
| [gstack](https://github.com/garrytan/gstack) | Skills pack (sprint) | MIT | all six; host writes code; deploys after merge | ✅ up to 8 specialists + second model | ✅ design, plan, merge | ✅ test evidence tied to file fingerprint; zero tests fails | ◐ basic `test.yml` | ◐ GitHub | ✅ outside repo | ✅ | ◐ via Conductor | ◐ stops at gates | ◐ opt-in, Claude Code only | ✅ ~10 + 8 checklists | 1 certified, 7 experimental | Real-browser and iOS device QA; design mockups; deploy + canary monitoring; prompt-injection defences |
|
|
356
|
+
| [Compound Engineering](https://github.com/EveryInc/compound-engineering-plugin) | Framework | MIT | all six; merge only if granted | ✅ blind personas + second model | ◐ interactive only; `lfg` never pauses | ◐ | — | GitHub, Linear, Jira | ✅ `docs/solutions/` | ◐ | ◐ | ◐ scheduler | ◐ prompt rules | ◐ reviewer personas | ~14 | Learnings shared across repos; Jira; stacked-PR babysitting; Slack / GitHub feedback → plan |
|
|
357
|
+
| [GSD Core](https://github.com/open-gsd/gsd-core) | Framework | MIT | all six; PR, never merges | ✅ checkers + outside AI tools review plan | ✅ roadmap, acceptance, ship | ✅ verification goes stale on file change | — | — by design | ✅ | ◐ | ✅ | ◐ local | ◐ blocks `.env` reads | ◐ ~8 | 15 | Cross-tool plan review; ship blocked by open security threats; cross-project learnings |
|
|
358
|
+
| [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) + bmad-loop | Framework | MIT + trademark | all six; fix partial; local merge, no PR | ✅ 4 blind reviewers | ◐ risk-flagged plans, done, epic boundary | ◐ (✅ with loop) | — | GitHub, Jira, Linear, Notion, Trello | ◐ | ◐ | ◐ | ◐ local | — | ◐ 5 lenses | 10+ | Agile roles and artifacts (PRD, UX spec, epics, stories); most trackers |
|
|
359
|
+
| [Spec Kit](https://github.com/github/spec-kit) | Spec toolkit | MIT | design, plan, build; review, fix partial; no merge | ◐ via extensions | ✅ spec, plan | ◐ | — | ◐ tasks → GitHub issues | ◐ constitution | ◐ | ◐ via extensions | ◐ | — | ◐ checklists | 40+ | Most AI tools; 181 community extensions; workflow engine for custom processes |
|
|
360
|
+
| [OpenSpec](https://github.com/Fission-AI/OpenSpec) | Spec toolkit | MIT | design, plan, build; review partial; merges specs, not code | — | ◐ by convention | ◐ spec structure only | — | ? | ◐ living specs | ◐ specs | ◐ | ◐ via Copilot agent | ? | ? | 30+ | Light to adopt; made for existing code (spec deltas → living specs); multi-repo planning (beta) |
|
|
361
|
+
| [Kiro](https://kiro.dev) (AWS) | Editor + cloud agent | Closed source, paid tiers | all six; PR, never merges | ✅ opt-in; reviewers on different model vendors | ✅ requirements, design, PR | ✅ property-based tests from requirements | ◐ example | ◐ GitHub, GitLab | ◐ | ◐ | ✅ 10 cloud sandboxes | ✅ | ✅ | ? | own IDE, CLI, web, mobile | Full product; EARS requirements; workflow rules enforced by runtime; enterprise SSO |
|
|
362
|
+
| [everything-claude-code](https://github.com/affaan-m/ECC) | Skills pack + pipeline | MIT | all six; PR, no merge | ✅ + agent that tries to refute each finding | ✅ plan, commit | ◐ | — | GitHub, Jira | ✅ | ◐ | ◐ | ◐ | ✅ GateGuard | ✅ ~25 | 1 stable, ~15 beta / experimental | Largest library (70+ agents, 300+ skills); finding refutation; hosted skill generator |
|
|
363
|
+
| [OpenHands](https://github.com/OpenHands/OpenHands) | Agent | MIT (paid cloud) | build, review, fix, merge; plan partial | ◐ one reviewer agent | ◐ per action; factory has none | ✅ merge watchdog waits for CI | ◐ AI PR review only | GitHub, GitLab, Jira, Linear | ◐ opt-in | ◐ AGENTS.md | ✅ containers | ✅ | ✅ sandbox + hooks | ◐ | own UI / CLI / cloud, ACP editors | Sandboxed and hosted execution; issue-to-merge with no human; Jira, GitLab |
|
|
364
|
+
|
|
365
|
+
Where bkit stands apart, per the table:
|
|
366
|
+
|
|
367
|
+
- **Only one with all of:** blind bug + security reviewers, sign-off after design / plan / before merge, mechanical "done" checks, a CI pipeline for your project, GitHub / Linear tracker, and file-based memory.
|
|
368
|
+
- **CI pipeline for your project:** none of the 10 ships a multi-lane test pipeline with a final gate. Closest: gstack's basic `test.yml`, OpenHands' AI PR-review workflow, Kiro's example.
|
|
369
|
+
- **Merge discipline:** merges into `dev` only after the capstone check, never `main`. OpenHands merges with no human; most stop at a PR.
|
|
370
|
+
- **Debug with outside evidence:** connectors pull CI logs, runtime errors and web results into diagnosis; soak mode for runtime-only bugs; handover when unfixable.
|
|
371
|
+
- **Test first, checked by code:** each plan task's tests are run by bkit and must fail before the task's code exists, then pass; the agent's report of a failure never counts. Superpowers enforces TDD by instruction; Task Master's TDD mode takes pass / fail counts from the agent.
|
|
372
|
+
- **Gaps vs the field:** no IDE or hosted service; no Jira; no formal requirements notation (EARS); no embedding memory; far smaller community.
|
|
373
|
+
|
|
374
|
+
Also reviewed, left out of the table: Claude Task Master, ccpm, wshobson/agents, mattpocock/skills, SuperClaude, Ruflo, oh-my-openagent, Cline, Aider.
|
|
375
|
+
|
|
376
|
+
---
|
|
377
|
+
|
|
378
|
+
Sources: bkit workflow and prompt definitions (`.bkit/core/workflows/*`, `.bkit/core/.bkit/prompts.md`); the Gulli differential review of _Agentic Design Patterns_ (Part 2); each compared project's own repo and docs (Part 3).
|