docs(doctrine): reconcile 3.0.md tooling-floor wording with the bd/git floor (ag-60jd #tooling-floor-reconcile)#790
Merged
Conversation
…t floor (ag-60jd #tooling-floor-reconcile)
docs/3.0.md non-goals listed "No new required tooling; `bd`, the ratchet, and
the `ao` CLI carry the load," which read as if nothing was required and
contradicted "No bead, no PR" (bd is load-bearing for the canonical workflow)
plus docs/dependencies.md ("bd: Required for tracked work").
Restate the floor consistently with README:86 and dependencies.md: `git` + an
agent runtime stay hard-required, `bd` is required for the bead-tracked
workflow, and the ratchet + `ao` CLI carry the rest. The README rewrite already
removed the old "bd = Optional" table, so 3.0.md:168 was the last outlier.
Closes-scenario: ag-60jd#tooling-floor-reconcile
Bounded-context: BC5-Runtime
Evidence: docs/3.0.md
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
1 participant
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.
What
docs/3.0.md:168(Non-goals) read "No new required tooling;bd, the ratchet, and theaoCLI carry the load," which sounded like nothing was required and contradicted two settled statements:AGENTS-WORKFLOW.md/ CLAUDE.md doctrine: "No bead, no PR" (bd is load-bearing for the canonical workflow).docs/dependencies.md:14:bd→ "Required for tracked work."This restates the floor in one consistent form across the doctrine surfaces:
Why this is the only change needed
The README rewrite already removed the old "bd = Optional" requirements table the bead cited (README:128). The current surfaces are already aligned:
README.md:86— "The only hard requirement is an agent runtime andgit."docs/dependencies.md:14—bd= "Required for tracked work";ao/bdrecommended (line 32).AGENTS.md— no contradicting "bd optional" statement.So
docs/3.0.md:168was the last outlying statement. One line changed.Verification
markdownlint-cli2 docs/3.0.md→ 0 errors.scripts/pre-push-gate.sh --fast→ passed (2 pre-existing warn-only F1.6 items, unrelated).Closes-scenario: ag-60jd#tooling-floor-reconcile
Bounded-context: BC5-Runtime
Evidence: docs/3.0.md