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
- Add ref as Alias for xref (ref alias — so migrated files can use the shorter
{% ref %}syntax)
Relationships
History
- f262d7bsource+SPEC-008
- cf0cfc0Content edited
- 703b85aContent edited
- ebe0c64statusready→done
- ☑ 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
- 38e7523statuspending→readyprioritylow→high
- 6424098Created (pending, low, plan, xref, content)