Skip to content

Spec-Anchored-Dev: switch back-link identifier from slug to repo-relative path#3

Merged
wesnick merged 1 commit into
mainfrom
feat/spec-id-to-path
May 28, 2026
Merged

Spec-Anchored-Dev: switch back-link identifier from slug to repo-relative path#3
wesnick merged 1 commit into
mainfrom
feat/spec-id-to-path

Conversation

@wesnick
Copy link
Copy Markdown
Contributor

@wesnick wesnick commented May 28, 2026

The spec frontmatter spec: field and every code-side // Spec: back-link now use the spec file's repo-relative path (e.g. docs/specs/agent/executor.md) instead of a decoupled slug id. The path doubles as a navigable link target in IDE plugins and Markdown renderers, at the cost of making spec renames a graph-wide rewrite. Touches SKILL.md (frontmatter, back-link format, gate checklist, anti-pattern table) plus the matching paragraphs in references/existing-codebase.md and references/maintenance.md.

…g to repo-relative path

The spec frontmatter `spec:` field and every code-side `// Spec:` back-link
now use the spec file's repo-relative path (e.g. `docs/specs/agent/executor.md`)
instead of a decoupled slug id. The path doubles as a navigable link target
in IDE plugins and Markdown renderers, at the cost of making spec renames
a graph-wide rewrite. Touches SKILL.md (frontmatter, back-link format,
gate checklist, anti-pattern table) plus the matching paragraphs in
references/existing-codebase.md and references/maintenance.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@wesnick wesnick merged commit 0d80d7a into main May 28, 2026
2 checks passed
@wesnick wesnick deleted the feat/spec-id-to-path branch May 28, 2026 14:28
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