diff --git a/README.md b/README.md index 9358df6f..b3ed6b05 100644 --- a/README.md +++ b/README.md @@ -225,7 +225,7 @@ reads them, except the one file noted below | --- | --- | | `docs/superpowers/` | past plans and specs | | `docs/reviews/` | reviews and the review guide. Keep `docs/reviews/adapters/`: `check:adapter-inventory` (FE-GATE-010) reads its `INVENTORY.md`, whose rows link to the adapter reviews beside it, and `docs/operations/adapter-remediation-ledger.md` cites those reviews | -| `SPEC.md`, `tasks/` | requirements and task list of the 2026-09-25 review fix round | +| `SPEC.md`, `docs/history/` | requirements of the 2026-09-25 review fix round (`SPEC.md`), and the plans and evidence of finished work, that round's task list included | | `CLAUDE.md` | review instructions for the template repository itself; replace it with your own | | `PRODUCT.md` | product context of the template itself (users, purpose, principles) for design tools; replace it with your product's | diff --git a/docs/README.md b/docs/README.md index 8ee965f4..74dc482b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -88,4 +88,26 @@ checkout이 없거나 그 커밋이 없으면 실패 대신 확인하지 못한 |---|---| | [`superpowers/`](superpowers/) | 과거 작업 계획과 스펙 | | [`reviews/`](reviews/) | 리뷰 결과. 리뷰 가이드와 실행 체크리스트는 2026-11-06에 design-docs 저장소로 옮겼고, 여기에는 정본 위치를 알려 주는 포인터 두 개만 있다. `reviews/adapters/INVENTORY.md`만 게이트가 읽는다. `reviews/adapters/`는 지우지 않는다: INVENTORY의 행과 `operations/adapter-remediation-ledger.md`가 그 안의 리뷰로 링크한다 | -| [`../SPEC.md`](../SPEC.md), [`../tasks/`](../tasks/) | 2026-09-25 리뷰 수정 라운드의 요구사항과 작업 목록. 그 라운드는 0.2.0(`CHANGELOG.md`)으로 끝났다. 그때 리뷰 문서(`reviews/2026-09-25-maturity-review/`)가 이 경로(`SPEC.md:18` 등)로 가리키므로 옮기지 않는다 | +| [`history/`](history/) | 끝난 작업의 계획서(`history/plans/`)와 증거(`history/evidence/`). 파일마다 맨 위에 머리 블록이 있다(아래 4절). 2026-11-07에 루트에서 옮겼다: `tasks/` → `history/plans/2026-09-25-review-fix-round/`, `.superpowers/sdd/2026-08-01-runtime-correctness-remediation/` → `history/evidence/2026-08-01-runtime-correctness-remediation/`. 그때의 기록 문서(`superpowers/plans/`, `reviews/2026-09-25-maturity-review/`, 루트 `SPEC.md`)는 옛 경로로 가리킨다. 기록이라 고치지 않는다 | +| [`../SPEC.md`](../SPEC.md) | 2026-09-25 리뷰 수정 라운드의 요구사항. 그 라운드는 0.2.0(`CHANGELOG.md`)으로 끝났다. 27~37줄 「공통 완료 기준」을 작업 매뉴얼로 옮긴 뒤 같은 라운드의 계획서 옆(`history/plans/2026-09-25-review-fix-round/`)으로 옮긴다 | + +## 4. 기록 문서의 머리 블록 + +`history/` 아래 `.md` 파일은 맨 위에 이 블록을 둔다. 블록을 빼면 쓴 때의 원문이다. 본문은 +고치지 않고 블록의 칸만 고친다. 형식의 정본은 design-docs 저장소의 +`conventions/docs-system.md` 4절이다. + +```text + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-25 +- 요약: 한국어 한 문장 +- 현재 정본: 지금 동작을 설명하는 문서나 코드의 경로. 없으면 「없음 — 이유」 + +``` + +- 종류는 폴더가 정하고 둘째 줄에 굵게 적는다: `history/plans/` 계획서, `history/evidence/` 증거. +- 상태: 계획서는 실행 중 · 끝남 · 중단 · 대체됨 · 확인 안 함, 증거는 보관. +- `.md`가 아닌 파일(레인 준비 셸 스크립트)에는 달지 않는다. 같은 폴더 문서의 블록이 그 파일을 설명한다. diff --git a/.superpowers/sdd/2026-08-01-runtime-correctness-remediation/task-5-report.md b/docs/history/evidence/2026-08-01-runtime-correctness-remediation/task-5-report.md similarity index 95% rename from .superpowers/sdd/2026-08-01-runtime-correctness-remediation/task-5-report.md rename to docs/history/evidence/2026-08-01-runtime-correctness-remediation/task-5-report.md index 1b11417e..bfc4c2d9 100644 --- a/.superpowers/sdd/2026-08-01-runtime-correctness-remediation/task-5-report.md +++ b/docs/history/evidence/2026-08-01-runtime-correctness-remediation/task-5-report.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-02 +- 요약: 런타임 정합성 수정 Task 5(결과가 불확실한 낙관적 변경을 남기고 나중에 맞추기)의 구현과 RED 증거 보고다. +- 현재 정본: `src/presentation/adapters/query/optimistic-layer-runtime.ts`, `src/presentation/adapters/query/application-query.ts` + + # Task 5 Report: Retain and reconcile uncertain optimistic mutations ## Status diff --git a/tasks/handoff.md b/docs/history/plans/2026-09-25-review-fix-round/handoff.md similarity index 93% rename from tasks/handoff.md rename to docs/history/plans/2026-09-25-review-fix-round/handoff.md index 66e284f3..317ecf2b 100644 --- a/tasks/handoff.md +++ b/docs/history/plans/2026-09-25-review-fix-round/handoff.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-26 +- 요약: 2026-09-25 리뷰 수정 작업을 노트북에서 desktop으로 넘길 때 쓴 인계 문서다. +- 현재 정본: 없음 — 끝난 라운드의 계획이다. 이 라운드가 바꾼 것은 `CHANGELOG.md` 0.2.0 절에 있다 + + # 인계: 성숙도 리뷰(2026-09-25) 수정 작업 2026-09-26 01:10, 노트북 부하 때문에 세션을 멈추고 desktop으로 옮긴다. 이 문서만 읽고 이어서 진행할 수 있게 적었다. diff --git a/tasks/lanes/LANE-BRIEF.md b/docs/history/plans/2026-09-25-review-fix-round/lanes/LANE-BRIEF.md similarity index 93% rename from tasks/lanes/LANE-BRIEF.md rename to docs/history/plans/2026-09-25-review-fix-round/lanes/LANE-BRIEF.md index 2d41d186..02015183 100644 --- a/tasks/lanes/LANE-BRIEF.md +++ b/docs/history/plans/2026-09-25-review-fix-round/lanes/LANE-BRIEF.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-26 +- 요약: 2026-09-25 리뷰 수정의 병렬 레인 에이전트가 먼저 읽던 공통 지시서이고, 같은 폴더의 setup-lane.sh가 레인 worktree를 만들었다. +- 현재 정본: 없음 — 이 라운드에서만 쓴 레인 작업 방식이다 + + # 구현 레인 공통 지시서 (모든 레인 에이전트가 먼저 읽는다) 원본 repo: 이 저장소를 clone한 경로(아래 `$REPO`) diff --git a/tasks/lanes/setup-lane.sh b/docs/history/plans/2026-09-25-review-fix-round/lanes/setup-lane.sh similarity index 100% rename from tasks/lanes/setup-lane.sh rename to docs/history/plans/2026-09-25-review-fix-round/lanes/setup-lane.sh diff --git a/tasks/plan.md b/docs/history/plans/2026-09-25-review-fix-round/plan.md similarity index 91% rename from tasks/plan.md rename to docs/history/plans/2026-09-25-review-fix-round/plan.md index ac9fe234..1b9aac14 100644 --- a/tasks/plan.md +++ b/docs/history/plans/2026-09-25-review-fix-round/plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-25 +- 요약: 2026-09-25 성숙도 리뷰 발견 138건을 Phase 0, 병렬 레인, 통합 순서로 고치는 실행 계획이고, 라운드는 v0.2.0(2026-09-27)으로 끝났다. +- 현재 정본: 없음 — 끝난 라운드의 계획이다. 이 라운드가 바꾼 것은 `CHANGELOG.md` 0.2.0 절에 있다 + + # Implementation Plan: 성숙도 리뷰(2026-09-25) 전 항목 반영 ## Overview diff --git a/tasks/todo.md b/docs/history/plans/2026-09-25-review-fix-round/todo.md similarity index 95% rename from tasks/todo.md rename to docs/history/plans/2026-09-25-review-fix-round/todo.md index af65c3aa..490c3968 100644 --- a/tasks/todo.md +++ b/docs/history/plans/2026-09-25-review-fix-round/todo.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-25 +- 요약: 2026-09-25 성숙도 리뷰 발견 138건을 작업으로 나눈 목록으로, 발견은 모두 표시됐고 마지막 확인 3개와 사용자 몫 U-1~U-5는 표시되지 않은 채 라운드가 v0.2.0으로 끝났다. +- 현재 정본: 없음 — 끝난 라운드의 계획이다. 이 라운드가 바꾼 것은 `CHANGELOG.md` 0.2.0 절에 있다 + + # Tasks: 성숙도 리뷰(2026-09-25) 전 항목 반영 작업 ID는 리뷰의 발견 ID다. 문제 설명·근거·검증 방법은 `docs/reviews/2026-09-25-maturity-review/<영역 문서>`의 같은 ID 항목을 본다. 결정은 `SPEC.md` "결정" 표(D-x), 실행 방식은 `tasks/plan.md`를 따른다. diff --git a/tests/unit/deletable-history-documents.test.ts b/tests/unit/deletable-history-documents.test.ts index 387fbd63..77dcdf98 100644 --- a/tests/unit/deletable-history-documents.test.ts +++ b/tests/unit/deletable-history-documents.test.ts @@ -23,12 +23,16 @@ const ROOT_FILES = [ // Built from pieces so that this file does not match itself. const REVIEWS = ["docs", "reviews", ""].join("/"); const KEPT = `${REVIEWS}adapters/INVENTORY.md`; +// The 2026-09-25 round's task folder moved into the history folder on +// 2026-11-07 (docs/README.md §3), so the history pattern covers it. A pattern +// for the old root folder would now only catch a product's own route or +// folder of that name. const DELETABLE = [ new RegExp(`${REVIEWS}(?!adapters/INVENTORY\\.md)`, "u"), new RegExp(["docs", "superpowers"].join("/"), "u"), + new RegExp(["docs", "history"].join("/"), "u"), new RegExp(`\\b${"SPEC"}\\.md\\b`, "u"), new RegExp(`\\b${"CLAUDE"}\\.md\\b`, "u"), - new RegExp(`(^|["'\`(\\s])${"tasks"}/`, "u"), ]; /** * 1101/14-01. A section number without a document name cannot be followed,