blue/.blue/docs/rfcs/0020-rfc-source-link-resolution.draft.md
Eric Garcia 0fea499957 feat: lifecycle suffixes for all document states + resolve all clippy warnings
Every document filename now mirrors its lifecycle state with a status
suffix (e.g., .draft.md, .wip.md, .accepted.md). No more bare .md for
tracked document types. Also renamed all from_str methods to parse to
avoid FromStr trait confusion, introduced StagingDeploymentParams struct,
and fixed all 19 clippy warnings across the codebase.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 12:19:46 -05:00

913 B

RFC 0020: RFC Source Link Resolution

Status Draft
Date 2026-01-26
Source Spike RFC Source Link Generation
Related RFC 0022: Filesystem Authority

Summary

RFC metadata's Source Spike field renders as plain text instead of a clickable markdown link. When blue_rfc_create is called with source_spike, the value is stored and rendered verbatim. Users cannot navigate directly from an RFC to its source spike.

Current behavior: | **Source Spike** | Spike Title | Expected behavior: | **Source Spike** | [Spike Title](../spikes/date-title.md) |

The store already provides find_document(DocType::Spike, title) which returns the spike's file_path. The fix is to resolve spike titles to markdown links at RFC creation time.

Test Plan

  • TBD

"Right then. Let's get to it."

— Blue