Skip to content

docs: fix cross-references, phase index, and duplicated blocks - #165

Open
HorchataHTML wants to merge 1 commit into
devallibus:masterfrom
HorchataHTML:audit/fix-cross-refs
Open

docs: fix cross-references, phase index, and duplicated blocks#165
HorchataHTML wants to merge 1 commit into
devallibus:masterfrom
HorchataHTML:audit/fix-cross-refs

Conversation

@HorchataHTML

Copy link
Copy Markdown
  • Replace fragile SKILL.md §8 citations (19x across 12 files) with a
    name-based reference to the "Agent Identity Signing" section; the
    number had no resolvable anchor in the unnumbered SKILL.md
  • SKILL.md: document the commands/ vs skills/ split in the Verb Grid,
    add a Phase Sub-skill Index so phase sub-skill files are reachable
    from the central navigation, and note the two-tree layout in the
    Integration Map (also rename "Sub-skill map" to "Command map")
  • skills/shiplog/pr.md: renumber phase steps 5 -> 4 and 6 -> 5 (gap)
  • Replace legacy shiplog:<skill> references with file paths (4x)
  • branch.md: mark the worktree cleanup block with a canonical-source
    note (owned by references/orchestrator-protocol.md)
  • phase-templates.md: drop the duplicated review sign-off block and
    point to closure-and-review.md "Sign-off format" (single source)
  • SKILL.md golden path: note inline blocks are illustrative; canonical
    templates live in the phase sub-skills
  • CONTRIBUTING.md: clarify PR template vs runnable policy file
  • Add cross-ref-check workflow rejecting legacy shiplog:<skill> refs
  • Bump plugin.json version to 0.5.2

Authored-by: moonshot/kimi-k3 (kimi-code)
Reviewed-by: anthropic/claude-opus-4.6

- Replace fragile `SKILL.md §8` citations (19x across 12 files) with a
  name-based reference to the "Agent Identity Signing" section; the
  number had no resolvable anchor in the unnumbered SKILL.md
- SKILL.md: document the commands/ vs skills/ split in the Verb Grid,
  add a Phase Sub-skill Index so phase sub-skill files are reachable
  from the central navigation, and note the two-tree layout in the
  Integration Map (also rename "Sub-skill map" to "Command map")
- skills/shiplog/pr.md: renumber phase steps 5 -> 4 and 6 -> 5 (gap)
- Replace legacy `shiplog:<skill>` references with file paths (4x)
- branch.md: mark the worktree cleanup block with a canonical-source
  note (owned by references/orchestrator-protocol.md)
- phase-templates.md: drop the duplicated review sign-off block and
  point to closure-and-review.md "Sign-off format" (single source)
- SKILL.md golden path: note inline blocks are illustrative; canonical
  templates live in the phase sub-skills
- CONTRIBUTING.md: clarify PR template vs runnable policy file
- Add cross-ref-check workflow rejecting legacy `shiplog:<skill>` refs
- Bump plugin.json version to 0.5.2

Authored-by: moonshot/kimi-k3 (kimi-code)
Reviewed-by: anthropic/claude-opus-4.6
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant