docs: fix the SKILLS.md heading hierarchy - #32
Merged
Conversation
`## The write-guard hook dangles on a submodule-less checkout` sat between `### From gregoryfoster-skills` and `### From obra-superpowers`, so an H2 terminated `## Available skills` mid-inventory and the obra table became a child of the write-guard section rather than of the skills list. Moves that section down beside the other two submodule-operational sections, and lifts the v1.2 hold prose out of the gregoryfoster skills table into its own `## The curating-context v1.2 hold` — it is about submodule pinning and the suspended refresh, not about what that table lists. The gregoryfoster section keeps a pointer to it. Reading order is now normal path then exceptions: Maintenance, the hold, the dangling write-guard hook, submodules in CI. The Maintenance block's `git submodule update --remote --merge` gains the note that it is suspended for the duration of the hold — it was directly above advice the hold forbids. Prose is unchanged except for those cross-references. Anchors verified to resolve; codebase_context_index re-run for the moved chunks. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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.
Structural only — no fact in this doc changes.
The break
## The write-guard hook dangles on a submodule-less checkoutsat between### From gregoryfoster-skillsand### From obra-superpowers. An H2 in that positionterminates
## Available skillshalfway through its own inventory, which makes theobra-superpowersskill table a child of the write-guard section instead of the skills list.Second, smaller: the v1.2 hold prose lived under
### From gregoryfoster-skills, a section whosejob is listing what that submodule provides. The hold is about submodule pinning and the suspended
refresh — adjacent, but not that.
After
Reading order is now normal path first, exceptions after: maintenance, the hold that suspends part
of it, the hook that dangles without it, and CI.
The one substantive addition
The
Maintenanceblock'sgit submodule update --remote --mergesat two lines above prose thehold forbids, with nothing marking it. It now carries
# SUSPENDED during the v1.2 hold — it would bump gregoryfoster-skills past the pin.Everything else is a cross-reference: the gregoryfostersection points at the hold, and the CI section's "the v1.2 hold above" became a link now that it is
no longer directly above.
Verification
HEADshows only the intended additions —the new H2, two cross-reference lines, the SUSPENDED comment, and one bullet reflow. No prose lost.
#submodules-in-ci,#the-curating-context-v12-hold×2). No inbound anchor links exist elsewhere in the repo — checked.codebase_context_indexre-run;skills-docre-chunked. Its manifest description still describesthe file accurately, so it is unchanged.
uv run ruff check .clean,ruff format --checkclean,uv run pytest— 444 passed, 99.77%.🤖 Generated with Claude Code