WORK-021
ID:WORK-021Status:done

Update Plan Documents to Use Xref Syntax

Priority:highComplexity:unknownSource:SPEC-008

Summary

Plan documents currently use plain-text references like Ref: SPEC-008 (Unbuilt Runes) and Dependencies: WORK-015. Replace these with {% ref %} tags so cross-references are machine-readable and will resolve to links once Add Entity Registration to @refrakt-md/plan (entity registration) is complete.

Scope

All files under plan/work/, plan/spec/, and plan/decision/ that contain cross-references to other plan documents.

Examples

Before:

> Ref: SPEC-008 (Unbuilt Runes) — Package: `@refrakt-md/media`

After:

> Ref: {% xref "SPEC-008" /%} Package: `@refrakt-md/media`

Before:

- Requires track and playlist runes (WORK-015) to exist as child content

After:

- Requires track and playlist runes ({% xref "WORK-015" /%}) to exist as child content

Acceptance Criteria

  • All SPEC-###, WORK-###, ADR-### references in plan documents use {% xref %} syntax
  • Blockquote Ref: lines use xref for each referenced ID
  • Dependency mentions in prose and lists use xref
  • No plain-text ID references remain (except inside attribute values like id="WORK-004")

Dependencies

History

  1. f262d7b
    source+SPEC-008
  2. cf0cfc0
    Content edited
  3. 703b85a
    Content edited
  4. ebe0c64
    statusreadydone
    • ☑ All `SPEC-###`, `WORK-###`, `ADR-###` references in plan documents use `{% xref %}` syntax
    • ☑ Blockquote `Ref:` lines use xref for each referenced ID
    • ☑ Dependency mentions in prose and lists use xref
    • +1 more criteria
  5. 38e7523
    statuspendingreadyprioritylowhigh
  6. 6424098
    Created (pending, low, plan, xref, content)