docs(history): 루트의 tasks/와 .superpowers/ 기록을 docs/history로 옮긴다

문제: 끝난 작업의 기록이 루트 폴더 둘에 따로 있다. 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절
This commit is contained in:
DongHyeonka
2026-11-07 19:02:47 +09:00
parent 0805910c47
commit 429b8d8802
9 changed files with 74 additions and 3 deletions
+1 -1
View File
@@ -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 |
+23 -1
View File
@@ -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
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
- 상태: 끝남
- 작성일: 2026-09-25
- 요약: 한국어 한 문장
- 현재 정본: 지금 동작을 설명하는 문서나 코드의 경로. 없으면 「없음 — 이유」
<!-- 머리 블록 끝 -->
```
- 종류는 폴더가 정하고 둘째 줄에 굵게 적는다: `history/plans/` 계획서, `history/evidence/` 증거.
- 상태: 계획서는 실행 중 · 끝남 · 중단 · 대체됨 · 확인 안 함, 증거는 보관.
- `.md`가 아닌 파일(레인 준비 셸 스크립트)에는 달지 않는다. 같은 폴더 문서의 블록이 그 파일을 설명한다.
@@ -1,3 +1,12 @@
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
- 상태: 보관
- 작성일: 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
@@ -1,3 +1,12 @@
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
- 상태: 끝남
- 작성일: 2026-09-26
- 요약: 2026-09-25 리뷰 수정 작업을 노트북에서 desktop으로 넘길 때 쓴 인계 문서다.
- 현재 정본: 없음 — 끝난 라운드의 계획이다. 이 라운드가 바꾼 것은 `CHANGELOG.md` 0.2.0 절에 있다
<!-- 머리 블록 끝 -->
# 인계: 성숙도 리뷰(2026-09-25) 수정 작업
2026-09-26 01:10, 노트북 부하 때문에 세션을 멈추고 desktop으로 옮긴다. 이 문서만 읽고 이어서 진행할 수 있게 적었다.
@@ -1,3 +1,12 @@
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
- 상태: 끝남
- 작성일: 2026-09-26
- 요약: 2026-09-25 리뷰 수정의 병렬 레인 에이전트가 먼저 읽던 공통 지시서이고, 같은 폴더의 setup-lane.sh가 레인 worktree를 만들었다.
- 현재 정본: 없음 — 이 라운드에서만 쓴 레인 작업 방식이다
<!-- 머리 블록 끝 -->
# 구현 레인 공통 지시서 (모든 레인 에이전트가 먼저 읽는다)
원본 repo: 이 저장소를 clone한 경로(아래 `$REPO`)
@@ -1,3 +1,12 @@
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
- 상태: 끝남
- 작성일: 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
@@ -1,3 +1,12 @@
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
- 상태: 끝남
- 작성일: 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`를 따른다.
@@ -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,