refactor: 분리되어 관리하고 있던 문서 시스템을 하나로 통일

2026-09-04 18:56:01 +09:00
parent 4b9e7148b5
commit 43bccd08a8
121 changed files with 2861 additions and 534 deletions
@@ -0,0 +1,9 @@
+# <project>
+
+- codebase: `/shared/codebase/<project>`
+- analysis owner: `/shared/document-detail/<project>`
+- Tech Log output: `/shared/Tech-Log-Document/<project>`
+
+## Current analysis scope
+
+`state.json`을 정본으로 사용한다. 대형 코드베이스에서는 한 실행에 한 module/subsystem을 우선한다.
@@ -0,0 +1,25 @@
+# Project Overview
+
+## 분석 기준 revision
+
+- repository: `/shared/codebase/<project>`
+- revision: `<git revision or non-git snapshot note>`
+
+## Build and module map
+
+## Dependency direction
+
+## Runtime entry points
+
+## Persistence / messaging / external systems
+
+## Test topology
+
+## Configuration and operational surfaces
+
+## 분석할 bounded scopes
+
+| scope | why separate | status | analysis file |
+|---|---|---|---|
+
+## 아직 단정하지 않는 것
@@ -0,0 +1,60 @@
+# <module/subsystem> 완전 해부
+
+> 상태: IN_PROGRESS | COMPLETE  
+> 기준 revision: <git-sha>  
+> 분석 범위: <path/module>
+
+## 0. 커버리지와 숫자 지도
+
+- production files:
+- production LOC:
+- packages/directories:
+- tests by lane:
+- migrations/config/build files:
+- runtime membership:
+
+### Coverage ledger
+
+| scope/file group | count | disposition | reason |
+|---|---:|---|---|
+| | | FULL_READ / STRUCTURAL_ONLY / EXCLUDED | |
+
+## 1. 모듈의 정체와 경계
+
+## 2. 의존성과 런타임 배선
+
+## 3. 패키지/컴포넌트 지도
+
+## 4. 계약·불변식·상태 모델
+
+## 5. 주요 실행 경로
+
+## 6. 실패 경로와 복구/번역
+
+## 7. 트랜잭션·동시성·수명주기
+
+## 8. 설정·기능 플래그·환경 차이
+
+## 9. 퍼시스턴스/외부 시스템 세부
+
+## 10. 테스트 레인과 실제 증명 범위
+
+## 11. 빌드/ArchUnit/CI 강제 지점
+
+## 12. 실제 사용 여부와 dead/unwired/duplicate 경로
+
+## 13. Git/설계 문서에서 확인한 변화와 실패 기록
+
+## 14. 런타임·터미널·브라우저 Evidence
+
+## 15. 명시적 설계 이유와 추론을 구분한 정리
+
+## 16. 확인한 것 / 확인하지 못한 것
+
+## 17. 손볼 것
+
+각 항목: 우선순위 → 사실 → 근거 → 왜 문제인가 → 확인 방법 → 후보/다음 단계.
+
+## Source anchors
+
+모든 핵심 주장에 source-index의 파일/심볼/테스트/evidence anchor를 연결한다.
@@ -0,0 +1,13 @@
+{
+  "id": "<evidence-id>",
+  "kind": "terminal|browser|query-plan|benchmark|other",
+  "sourceRevision": "<git revision or snapshot>",
+  "executedAt": "<ISO-8601>",
+  "command": "<command without secrets or null>",
+  "cwd": "<working directory or null>",
+  "exitCode": null,
+  "rawPath": "evidence/raw/<file>",
+  "presentationPath": "evidence/terminal|browser|svg/<file>",
+  "proves": "<bounded claim>",
+  "doesNotProve": "<important limitation>"
+}
@@ -0,0 +1,27 @@
+# <project> 상세 분석
+
+> 이 문서는 `analysis/`의 완료된 bounded analysis를 통합한 정본이다. 새로운 사실을 이 문서에서 처음 만들어내지 않는다.
+
+## 1. Project map
+
+## 2. Architectural boundaries
+
+## 3. Representative execution paths
+
+## 4. Data and state
+
+## 5. Failure and operational behavior
+
+## 6. Tests and verification coverage
+
+## 7. Confirmed problems / incidents
+
+## 8. Reusable criteria and rules
+
+## 9. Unresolved questions
+
+## 10. Explicit project decisions
+
+## 11. Evidence index
+
+## 12. Limits of this analysis
@@ -0,0 +1,85 @@
+---
+schemaVersion: 1
+project: <project>
+sourceDocument: final/document.md
+sourceDocumentSha256: <sha256>
+sourceRevision: <git-revision-or-snapshot>
+generatedAt: <ISO-8601>
+---
+
+# Root Tree
+
+PROJECT
+<project>
+
+TOPIC
+<Topic title>
+<topic-slug>
+
+├── CASE
+│   └── <Case title>
+├── REFERENCE
+│   └── <Reference title>
+├── OPEN QUESTION
+│   └── <Open Question title>
+└── DECISION
+    └── <Decision title>
+
+# Node Specifications
+
+## CASE — <Case title>
+
+- slug: `<slug>`
+- readiness: `READY | NEEDS_EVIDENCE | BLOCKED | REJECTED`
+- source:
+  - `final/document.md#<anchor>`
+- code:
+  - `/shared/codebase/<project>/<path>:<line-or-symbol>`
+- evidence:
+  - `evidence/raw/<file>`
+- classification: `<specific incident/experiment/diagnosis that makes this a Case>`
+- missing-verification: `<none or concrete missing check>`
+- relations:
+  - `<kind>:<slug> — <reason>`
+
+## REFERENCE — <Reference title>
+
+- slug: `<slug>`
+- readiness: `READY | NEEDS_EVIDENCE | BLOCKED | REJECTED`
+- source:
+  - `final/document.md#<anchor>`
+- classification: `<reusable criterion rather than a retelling of one Case>`
+- scope: `<where the rule applies>`
+- exceptions: `<known exceptions or none>`
+- relations:
+  - `<kind>:<slug> — <reason>`
+
+## OPEN QUESTION — <Open Question title>
+
+- slug: `<slug>`
+- readiness: `OPEN | BLOCKED | REJECTED`
+- source:
+  - `final/document.md#<anchor>`
+- known:
+  - `<grounded fact>`
+- unknown:
+  - `<unresolved fact>`
+- next-verification: `<what would reduce the uncertainty>`
+- decision-criterion: `<what would allow this question to close>`
+- relations:
+  - `<kind>:<slug> — <reason>`
+
+## DECISION — <Decision title>
+
+- slug: `<slug>`
+- readiness: `READY | NEEDS_DECISION | BLOCKED | REJECTED`
+- decision-status: `PROPOSED | ADOPTED | SUPERSEDED | NOT_DECIDED`
+- source:
+  - `final/document.md#<anchor>`
+- decision-evidence:
+  - `<commit/ADR/config/history/user-provided decision record>`
+- grounds:
+  - `<case/reference relation>`
+- classification: `<why this is an actual project decision, not advice>`
+- relations:
+  - `<kind>:<slug> — <reason>`
@@ -0,0 +1,7 @@
+# Source Index
+
+상세 문서의 주장과 근거를 다시 찾을 수 있게 code/config/test/git/runtime source를 색인한다.
+
+| id | kind | path / command / URL | revision or time | what it proves | limitations |
+|---|---|---|---|---|---|
+| SRC-001 | code | `<path>` | `<revision>` | `<grounded fact>` | `<limit>` |
@@ -0,0 +1,30 @@
+{
+  "schemaVersion": 2,
+  "project": "<project>",
+  "codebasePath": "/shared/codebase/<project>",
+  "gitRevision": null,
+  "analysisStatus": "NOT_STARTED",
+  "analysisCycle": 1,
+  "scopes": [],
+  "reanalysis": {
+    "baselineRevision": null,
+    "targetRevision": null,
+    "mode": null,
+    "changedPaths": [],
+    "impactedScopes": [],
+    "requestedAt": null,
+    "completedAt": null
+  },
+  "finalDocument": {
+    "path": "final/document.md",
+    "status": "NOT_STARTED",
+    "sourceRevision": null
+  },
+  "rootTree": {
+    "path": "root-tree.md",
+    "status": "NOT_STARTED",
+    "sourceDocumentHash": null
+  },
+  "evidenceTasks": [],
+  "lastRunAt": null
+}