Skip to content

epic(cross-refs): complete and normalize cross-reference sections across all protocols and skills #187

@pentaxis93

Description

@pentaxis93

Summary

Cross-reference sections are the navigational tissue connecting protocols and
skills into a legible topology. Currently, coverage is uneven: two skills have
no cross-references at all, one protocol uses a non-standard section name, and
several protocols omit references to direct upstream or downstream consumers.
An implementer reading any single protocol should be able to see where it sits
in the system without cross-reading other files.

This epic brings every protocol and skill cross-reference section to the
standard established by begin, land, and document: present, accurately
described, and bidirectional where the dependency is bidirectional.

Task issues

Layer 0 — Add missing sections

Layer 1 — Normalize and fill gaps

Layer 2 — Minor additions

Layer 0 (no deps):  #188
Layer 1 (no deps):  #189
Layer 2 (no deps):  #190

All three layers are independently shippable — no hard dependencies between
them. Layer numbering reflects priority order, not blocking order.

Acceptance criteria

  • Every protocol and skill has a ## Cross-References section (not "Related Skills" or other variants)
  • Every reference includes a one-line description of the relationship direction (what flows from A to B)
  • No asymmetric gaps remain: if A references B, B references A (where the relationship is bidirectional)
  • No new content is invented — descriptions reflect actual documented artifact/trigger relationships

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions