Repository navigation
docs: refresh for v6.12.0 - #13
Merged
Merged
Conversation
Incremental, not a rewrite — the docs were rebuilt one release ago and
are structurally correct. Changed what v6.12.0 makes false.
- Pinned versions and counts everywhere they appear: core v6.12.0, bmb
v2.2.2, cis v0.3.2, gds v0.7.2, tea v1.26.0, bmad-loop v0.11.1;
110 -> 111 skills (bmm 35 -> 36); 20 -> 21 deprecated-described skills;
a plain /bmad:init now creates 36, not 37. Every number derived from
the tree or from a real init run, not carried over.
- **The shim rationale is rewritten, not restated.** v6.11.0.0 justified
shipping the shims by quoting upstream's v6-shims/README.md. v6.12.0
made them opt-in and left that README stale, so the same conclusion now
rests on different evidence: GDS v0.7.2's live instructions and
customize.toml values. README, AGENTS, the plugin README, the ecosystem
audit and module-integration all say so in those terms, and
module-integration gains an edge-case section — 'a module can depend on
a skill the installer stops installing by default' — next to its
existing sibling about the installer silently dropping skills.
- README gains a 'New in v6.12.0' block: bmad-walkthrough replacing
bmad-checkpoint-preview, Build sizing its own ceremony, review triage
logging a verdict per finding, bmad-project-context adopting a
handwritten AGENTS.md, and the two renames that break custom overrides
(persistent_facts now empty, {diff_output} -> {diff_file}).
- Ecosystem re-audited against gh api: bmad-plugins, bmad-eval-quality
and cis-skills added with one line each on why none is a bundle
candidate; bmad-skills recorded as no longer listed in the org.
- manual-testing gains a check for the dependency that justifies
--shims, since that is what will one day retire it.
- CHANGELOG: 6.12.0.0 section, and the release-script fixes that were
sitting under Unreleased are folded into it.
tgorka
added this pull request to stack #14
September 13, 2026 01:29
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Incremental, not a rewrite — the docs were rebuilt one release ago and
are structurally correct. Changed what v6.12.0 makes false.
v2.2.2, cis v0.3.2, gds v0.7.2, tea v1.26.0, bmad-loop v0.11.1;
110 -> 111 skills (bmm 35 -> 36); 20 -> 21 deprecated-described skills;
a plain /bmad:init now creates 36, not 37. Every number derived from
the tree or from a real init run, not carried over.
shipping the shims by quoting upstream's v6-shims/README.md. v6.12.0
made them opt-in and left that README stale, so the same conclusion now
rests on different evidence: GDS v0.7.2's live instructions and
customize.toml values. README, AGENTS, the plugin README, the ecosystem
audit and module-integration all say so in those terms, and
module-integration gains an edge-case section — 'a module can depend on
a skill the installer stops installing by default' — next to its
existing sibling about the installer silently dropping skills.
bmad-checkpoint-preview, Build sizing its own ceremony, review triage
logging a verdict per finding, bmad-project-context adopting a
handwritten AGENTS.md, and the two renames that break custom overrides
(persistent_facts now empty, {diff_output} -> {diff_file}).
and cis-skills added with one line each on why none is a bundle
candidate; bmad-skills recorded as no longer listed in the org.
--shims, since that is what will one day retire it.
sitting under Unreleased are folded into it.
Stack created with GitHub Stacks CLI • Give Feedback 💬
Summary by cubic
Refreshes the docs for the v6.12.0 upstream release, updating every version, count, and the rationale for shipping the v6 deprecation shims.
/bmad:initnow creates 36 files instead of 37.v6-shims/README.mdis stale, so the docs now cite GDS v0.7.2's live instructions andcustomize.tomlreferences as the reason the sync passes--shims.bmad-walkthroughrename, build ceremony changes, review triage verdicts, and two override-breaking renames (persistent_factsnow empty,{diff_output}→{diff_file}).gh apiand addsbmad-plugins,bmad-eval-quality, andcis-skillswith why each is not a bundle candidate; recordsbmad-skillsas no longer listed in the org.--shims.Written for commit a58fd15. Summary will update on new commits.