docs(workflow): surface make regen-all finalizer in contributor docs (ag-hlng #regen-all-discoverability)#659
Merged
Merged
Conversation
…s (ag-hlng #regen-all-discoverability) The regen-all finalizer shipped via ag-jima (scripts/regen-all.sh + Makefile regen-all/regen-check), but was referenced only in skills/evolve — not in the canonical contributor docs. An agent adding a skill/command still had no pointer to the one-command finalizer and would do the serial CI scavenger hunt (the exact ag-nk67 / PR #598 pain). This closes the "document the pre-push sweep" half of ag-nk67. docs/agent-workflow-reference.md (the deep-detail sidecar CLAUDE.md points to): - Key Scripts: add `make regen-all` (composite finalizer) + `make regen-check` (no-write drift companion) at the top. - Quick Local Sanity Checks: add the regen-all line for skill/command additions. - "Skill counts must be synced" rule: note regen-all is the superset. No pre-push-gate wiring — scripts/pre-push-gate.sh was retired (soc-g2r9); CI is the sole authoritative gate. Closes-scenario: ag-hlng#regen-all-discoverability Bounded-context: BC5-Runtime Evidence: docs/agent-workflow-reference.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
The
regen-allfinalizer already shipped (ag-jima—scripts/regen-all.sh+ Makefileregen-all/regen-check), but was referenced only inskills/evolve. None of the canonical contributor docs pointed to it, so an agent adding a skill/command still had no pointer to the one-command finalizer and would do the serial CI scavenger hunt — the exactag-nk67/ PR #598 pain (9 CI rounds, 0 feature failures).This closes the "document the pre-push sweep" half of
ag-nk67. (The finalizer core was the other half, already done.)Changes —
docs/agent-workflow-reference.mdmake regen-all(composite finalizer) +make regen-check(no-write drift companion) at the top.regen-allis the superset ofsync-skill-counts.sh.Not done (deliberately)
No
pre-push-gate.shwiring — that gate was retired (soc-g2r9, PR #357); CI is the sole authoritative gate.Evidence
Docs-only; markdownlint clean; no new relative links introduced. Claims verified against the actual
scripts/regen-all.shgenerator list.Closes-scenario: ag-hlng#regen-all-discoverability
Bounded-context: BC5-Runtime
Evidence: docs/agent-workflow-reference.md