Skip to content

docs(adr): unify ADR canonical to vault, monorepo stubs only (#561 PR-B)#563

Merged
thxforall merged 3 commits into
chore/561-harness-docs-ssotfrom
chore/561-adr-vault
May 21, 2026
Merged

docs(adr): unify ADR canonical to vault, monorepo stubs only (#561 PR-B)#563
thxforall merged 3 commits into
chore/561-harness-docs-ssotfrom
chore/561-adr-vault

Conversation

@thxforall
Copy link
Copy Markdown
Contributor

Summary

#561 Sub-task #4 + #6 (monorepo 측) — ADR canonical을 vault Architecture/adr/로 일원화. monorepo docs/adr/는 redirect stub만.

  • docs/adr/index.md 신설 (vault link + 최근 ADR 표 + 정책)
  • ADR-0001-ai-dev-boilerplate.md vault redirect stub로 치환 (status: superseded-by-vault)
  • ADR-0002-llm-wiki-foundation.md vault redirect stub로 치환

Stacked PR

이 PR은 #562 위에 stack되어 있다 (base: chore/561-harness-docs-ssot). #562가 먼저 merge되어야 본 PR의 diff가 깨끗하게 보인다.

Vault 측 작업 (별도 PR, decoded-docs 레포)

본 PR과 짝을 이루는 vault PR을 decoded-docs에 생성해야 한다:

  • Architecture/adr/ADR-0003-cross-tool-agent-entry-policy.md 작성
  • 본문 포함 항목:
  • Architecture/adr/ADR-0001-ai-dev-boilerplate.md, Architecture/adr/ADR-0002-llm-wiki-foundation.md vault 측 본문 확인 (없으면 monorepo에서 historical body를 복원해 작성)

주의: monorepo의 ADR-0001/0002는 이미 이전에 redirect notice 형태로 축소되어 있어서, vault에 원본 body가 필요하면 git history에서 복원해야 한다 (백업 위치: /tmp/561-adr-backup/는 ephemeral, 권장하지 않음).

Verification

  • docs/adr/index.md 존재, vault link + 최근 ADR 표 포함
  • ADR-0001/0002 모두 status: superseded-by-vault
  • 2 commits, 3 files changed (+39/-24)

Linked

Part of #561 (Sub-task #4 monorepo 측, #6 monorepo 측). Vault PR과 짝.

🤖 Generated with Claude Code

@thxforall thxforall force-pushed the chore/561-adr-vault branch from dd0816d to 62e9a0b Compare May 21, 2026 10:42
@vercel
Copy link
Copy Markdown

vercel Bot commented May 21, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
decoded-app Ready Ready Preview, Comment May 21, 2026 10:45am

ADR redirect stubs were failing wiki-lint due to:
- MISSING_FIELD owner/tags
- INVALID_STATUS "superseded-by-vault" (not in vocab)
- H1_TITLE_MISMATCH
- UNKNOWN_TAG "adr" in docs/adr/index.md

Normalize frontmatter to the existing vocab:
- status: deprecated for redirect stubs (vault is canonical)
- tags: [harness, agent]
- align H1 with title; move "(redirect to vault)" into body callout

No semantic change — vault remains the canonical ADR source.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@thxforall thxforall marked this pull request as ready for review May 21, 2026 10:47
@thxforall thxforall added the bump:none Docs / CI / tests only label May 21, 2026
@thxforall thxforall merged commit 03aaff4 into chore/561-harness-docs-ssot May 21, 2026
9 of 10 checks passed
@github-project-automation github-project-automation Bot moved this from In Progress to Done in decoded-monorepo May 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bump:none Docs / CI / tests only

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant