docs: route the skill by subject, not by requirement number - #241
Merged
Merged
Conversation
Every routing table in add-a-domain cited FR numbers. The components pages have carried headings rather than requirement numbers since the spec-kit removal, so all 58 citations pointed at something that no longer existed. An agent following the skill hit a dead pointer at step one of every layer. Each row now links a heading, and the links and anchors are checked: all 52 resolve. Three things came out with them. The SDK rules routed to domains.md when sdk.md states them, and the CLI rows had nowhere to point until cli.md was written. Two passages were archaeology, narrating what an earlier version of the file claimed and that the claim was wrong. The constitution forbids that for the same reason it forbids restating a rule: a reader cannot tell a record of a correction from the thing being corrected. What binds is stated plainly instead. The README justified relative links by saying scripts/validate-skills.py checks them and `just skill-lint` fails when one breaks. Both were removed earlier; the reason for relative links is now the one that is still true. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FuKUsHFG1EqZXamffh9M2c
|
Thank you for contributing to this project! 😊🕹️ |
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.
Every routing table in
add-a-domaincited FR numbers. Thecomponents/pages have carried headings rather than requirement numbers since the spec-kit removal, so all 58 citations pointed at something that no longer existed. An agent following the skill hit a dead pointer at step one of every layer.Each row now links a heading, and I checked every link and anchor resolves against the file it names rather than assuming.
Three things came out with them
The SDK rules routed to the wrong page. They pointed at
domains.mdwhensdk.mdstates them.Two passages were archaeology.
sdk.mdandapi.mdnarrated what an earlier version of the file had claimed and that the claim was wrong:The constitution forbids that for the same reason it forbids restating a rule: a reader cannot tell a record of a correction from the thing being corrected. What binds is now stated plainly, in four lines instead of twelve.
The README justified relative links with tooling that no longer exists. It said
scripts/validate-skills.pyresolves them andjust skill-lintfails when one breaks. Both were removed earlier in the spec-kit cleanup. The reason given is now the one that is still true: a relative link breaks visibly when the target moves, where an absolute URL goes on resolving to a page that no longer says what the row claims.What this unblocks
This was the blocker for "go implement X soup to nuts". The skill is 832 lines across seven files and covers the pipeline; it just could not be followed.
just testpasses.🤖 Generated with Claude Code
https://claude.ai/code/session_01FuKUsHFG1EqZXamffh9M2c