From 429b8d88022e01e89bbd984c879c4290a6459360 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 18:32:33 +0900 Subject: [PATCH] =?UTF-8?q?docs(history):=20=EB=A3=A8=ED=8A=B8=EC=9D=98=20?= =?UTF-8?q?tasks/=EC=99=80=20.superpowers/=20=EA=B8=B0=EB=A1=9D=EC=9D=84?= =?UTF-8?q?=20docs/history=EB=A1=9C=20=EC=98=AE=EA=B8=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 끝난 작업의 기록이 루트 폴더 둘에 따로 있다. tasks/는 2026-09-25 리뷰 수정 라운드(v0.2.0으로 끝남)의 계획·작업 목록·인계·레인 지시서와 레인 준비 스크립트 5개, .superpowers/는 2026-08-01 런타임 정합성 수정의 작업 보고 1개다. 읽는 코드는 없다(tests/unit/deletable-history- documents.test.ts가 지킨다). 소유자가 2026-11-07 백엔드와 같이 이력 폴더로 옮기기로 정했다. 고른 방법: - tasks/ → docs/history/plans/2026-09-25-review-fix-round/ (lanes/ 유지), .superpowers/sdd/2026-08-01-runtime-correctness-remediation/ task-5-report.md → docs/history/evidence/2026-08-01-runtime-correctness- remediation/. 폴더 이름은 docs-system 2절과 백엔드를 따른다. - .md 5개 맨 위에 docs-system 4.1절 머리 블록 9줄(빈 줄 포함, 백엔드와 같은 모양)을 단다. 본문은 바꾸지 않았다: 블록 9줄을 빼면 옛 파일과 바이트가 같다(cmp). setup-lane.sh는 실행 파일(첫 줄 shebang)이라 블록을 달지 않고 그대로 옮긴다(R100). 같은 폴더 LANE-BRIEF.md의 블록이 그 파일을 설명한다. - 상태: 계획서 넷은 끝남. 기계 규칙(체크 상자가 모두 표시돼야 끝남)으로는 plan·todo가 확인 안 함이지만, 이력이 라운드의 끝을 정한다(CHANGELOG 0.2.0, 태그 v0.2.0 2026-09-27). 증거는 보관. - 작성일: plan·todo는 2026-09-25. git이 처음 더한 날(ea0f01f, 2026-09-24)은 이 파일이 앞 라운드(src 리뷰) 계획이던 때이고, 지금 본문은 c5f379b(2026-09-25)가 통째로 다시 썼다. handoff는 본문 날짜 줄 (2026-09-26 01:10), LANE-BRIEF는 git이 처음 더한 날(54ba358, 2026-09-26), 보고는 git이 처음 더한 날(d9afccd, 2026-08-02). - docs/README.md: 3절 지도에 history/ 행을 더하고 옛 경로 → 새 경로를 적는다. 블록 첫 줄이 가리키는 「기록 문서의 머리 블록」 절(4절)을 더한다. ../tasks/ 링크는 없앴다. README.md의 "Files you can delete after copying" 행도 docs/history/로 바꾼다. - deletable-history-documents.test.ts: docs/history 패턴을 더하고 tasks/ 패턴은 뺀다. 루트 tasks/가 없어져 그 패턴이 지킬 문서가 없고, 남기면 제품의 "tasks/..." 라우트·폴더 문자열을 잘못 잡는다. 버린 대안: 옮긴 파일을 가리키는 다른 기록(docs/superpowers/plans/ 2026-08-02-*.md, docs/reviews/2026-09-25-maturity-review/, SPEC.md)의 옛 경로를 고치기. 기록 본문은 고치지 않는다(docs-system 1절). 대신 지도 행에 옛 경로를 적었다. 위험·한계: SPEC.md는 이번에 옮기지 않는다. 27~37줄 「공통 완료 기준」을 작업 매뉴얼(docs/work/improve.md, 뒤 단계)로 옮긴 뒤 같은 폴더로 보낸다. secret-scan-policy.json의 trackedRoots와 루트 경로 목록 7곳에는 tasks, .superpowers가 없어 바꿀 것이 없다. 검증: - 옮긴 .md 5개: 첫 9줄을 빼면 옛 파일과 cmp가 같다. git diff -M이 R091~R100 rename으로 잡고 지운 줄은 0이다. - desktop(네 커밋의 끝 30a379f, 로그 ~/l1-layout-cleanup-logs/): deletable-history-documents.test.ts는 지금 트리에서 통과하고, 테스트 폴더에 "docs/history/plans"를 담은 파일 하나를 두면 그 줄을 내며 실패한다. verify:documentation: PASS_SCOPED. test:unit 3091 tests 통과. Refs: design-docs repo-structure/04-frontend-layout.md 2.1절, 9.2절; design-docs conventions/docs-system.md 2·4절 --- README.md | 2 +- docs/README.md | 24 ++++++++++++++++++- .../task-5-report.md | 9 +++++++ .../2026-09-25-review-fix-round}/handoff.md | 9 +++++++ .../lanes/LANE-BRIEF.md | 9 +++++++ .../lanes/setup-lane.sh | 0 .../2026-09-25-review-fix-round}/plan.md | 9 +++++++ .../2026-09-25-review-fix-round}/todo.md | 9 +++++++ .../unit/deletable-history-documents.test.ts | 6 ++++- 9 files changed, 74 insertions(+), 3 deletions(-) rename {.superpowers/sdd => docs/history/evidence}/2026-08-01-runtime-correctness-remediation/task-5-report.md (95%) rename {tasks => docs/history/plans/2026-09-25-review-fix-round}/handoff.md (93%) rename {tasks => docs/history/plans/2026-09-25-review-fix-round}/lanes/LANE-BRIEF.md (93%) rename {tasks => docs/history/plans/2026-09-25-review-fix-round}/lanes/setup-lane.sh (100%) rename {tasks => docs/history/plans/2026-09-25-review-fix-round}/plan.md (91%) rename {tasks => docs/history/plans/2026-09-25-review-fix-round}/todo.md (95%) 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,