Skip to content

docs: 아카이브 spec의 끊긴 DEPLOY.md 링크 delink (#90) - #95

Merged
DaveDev42 merged 1 commit into
mainfrom
docs/dangling-links-90
Jul 31, 2026
Merged

docs: 아카이브 spec의 끊긴 DEPLOY.md 링크 delink (#90)#95
DaveDev42 merged 1 commit into
mainfrom
docs/dangling-links-90

Conversation

@DaveDev42

Copy link
Copy Markdown
Contributor

목적

#90이 추적하던 끊긴 내부 링크 중 마지막으로 남아 있던 항목 6을 정리한다. 항목 1–3(기계적 경로 오류)은 PR #91에서 이미 머지됐다.

아울러 repo 전체를 다시 스캔해 항목 4–5는 실제로는 끊긴 링크가 아님을 확인했다 — 아래 근거.

변경

docs/superpowers/specs/2026-04-30-oidc-bridge-m1-redesign-design.md:156

Vultr 배포 경로가 Cloudflare Workers로 대체되며(#48) docs/DEPLOY.md가 제거됐는데, history-only로 보존되는 이 spec이 여전히 ../../DEPLOY.md를 링크하고 있었다. 링크만 풀고 파일명은 백틱 평문으로 남긴 뒤 사라진 경위를 덧붙였다. 설계 서술은 손대지 않았다 (CLAUDE.md상 history 보존 문서).

항목 4–5를 손대지 않는 이유

repo 전체 .md를 스캔하면 끊긴 상대경로 링크가 12건 잡히지만, 그중 11건이 코드 펜스 안이다. 이 링크들은 plan 문서 자신의 내비게이션이 아니라 다른 파일에 써 넣으라고 지시하는 내용물이다 — 예를 들어 phase-09 Task 12는 "docs/RUNBOOK.md에 이 섹션을 append하라"고 지시하며 그 안에 [`SELF_HOSTING.md`](./SELF_HOSTING.md)를 담는다. 이 링크의 기준 디렉토리는 docs/이고 docs/SELF_HOSTING.md는 실재하므로 원문이 맞다. 스캐너가 plan 파일 위치를 기준으로 풀어서 생긴 false positive다.

분류 건수 처리
코드 펜스 안 — 실재 파일을 올바르게 가리킴 (docs/SELF_HOSTING.md ×3, docs/RUNBOOK.md ×1) 4 손대지 않음. 고치면 지시가 깨진다
코드 펜스 안 — 생성되지 않은 문서 (SECURITY.md ×2, PUBLIC_INSTANCE.md ×3, admin/REGISTERING_AN_APP.md, LAUNCH.md) 7 손대지 않음. 해당 phase가 미실행이라 대상 문서가 없는 것이며, plan의 지시 내용 자체는 유효
prose — 실제로 끊김 (../../DEPLOY.md) 1 본 PR에서 delink

즉 #90의 항목 4(admin/REGISTERING_AN_APP.md)·5(PUBLIC_INSTANCE.md)는 "문서 생성 vs delink" 판단이 필요한 링크가 아니라, 미실행 phase의 지시문 안에 있는 문자열이다. 지우면 그 phase를 실행할 때 무엇을 만들어야 하는지가 사라진다.

검증

프로즈(펜스 밖) 끊긴 상대경로 링크 0건:

prose dangling relative .md links: 0

문서만 변경 — 코드·테스트 영향 없음. 이 repo는 Type C 서비스 repo라 changeset 없음.

Closes #90

Vultr 배포 경로가 Cloudflare Workers로 대체되면서(#48) `docs/DEPLOY.md`가
제거됐는데, history-only로 보존되는 M1 redesign spec이 여전히 그 문서를
상대경로로 링크하고 있었다. 링크만 풀고 원래 가리키던 파일명은 평문으로
남긴 뒤, 문서가 사라진 경위를 한 절 덧붙였다. 설계 서술은 손대지 않았다.
@DaveDev42
DaveDev42 merged commit ab507de into main Jul 31, 2026
2 checks passed
@DaveDev42
DaveDev42 deleted the docs/dangling-links-90 branch July 31, 2026 15:38
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.

내부 planning/spec docs 끊긴 링크 5건 (harness-integrity 감사)

1 participant