chore: 이전 세션이 남긴 변경을 커밋한다

이번 파이프라인 작업과 무관하게 작업 트리에 남아 있던 것을 그대로 올린다.
사용자가 「전부 커밋」으로 정했고, 이번 작업과 섞이지 않게 커밋만 나눴다.

대부분은 clean-architecture-backend-template 의 그림 정본 재배치다 —
final/assets/diagrams/<이름>/ 에 있던 것이 CLAUDE.md 가 적은 배치인
final/assets/<이름>/ 로 옮겨졌고 .techviz/<이름>/ 이 함께 들어왔다.
삽입 줄의 대부분(3.15M)이 그 .techviz context.json 이다.

그 밖에 ca-tmpl·document-haness 의 정리, .claude/agents/ 열한 개,
writing-practitioner-guides 스킬, .playwright-mcp 세션 산출물,
scripts/check-ssot-facts.py 와 그 시험이 들어 있다.

이 커밋의 내용은 내가 만든 것이 아니라 이전 세션이 남긴 것이고 검증하지 않았다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

.agents/skills/deriving-tech-log-root-tree/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: deriving-tech-log-root-tree
-description: Use when a completed or substantially completed docs project analysis must be decomposed into grounded Tech Log Topics and candidate Case, Concept, Reference, Open Question, and Decision records.
+description: Use when a completed or substantially completed docs project analysis must be decomposed into grounded Tech Log Topics and candidate Case, Concept, Setup, Reference, Open Question, and Decision records.
 metadata:
   version: "1.0.0"
   language: "ko-KR"
@@ -77,7 +77,9 @@ They do not hold candidates, and in a folded project they are gone.
 4. Pick **Decisions** from the explicit-decision section (§10).
 5. Pick **Questions** from the unresolved section (§11).
 6. Only now add the **Concepts** those four need in order to be understood. Concept is
-   derived backwards from the records that require it, never by sweeping headings.
+   derived backwards from the records that require it, never by sweeping headings. Add the
+   **Setups** the analysis actually supports in the same pass — the section below says which
+   ones those are.
 7. Give every candidate a disposition — `references/candidate-disposition.md` — and set
    `dispositionReview` to `CONFIRMED` only for the ones a person actually re-read.
 8. Group `PROMOTE` candidates into Topics. Write one reader question per Topic.
@@ -89,6 +91,20 @@ They do not hold candidates, and in a folded project they are gone.
     `python3 scripts/verify-tech-log-tree.py <project>` — errors must be 0. Build fills
     `ssotSha256`; verify errors when it is absent, so verifying before building always fails.
 
+## When a Setup belongs in the tree
+
+Add a **Setup** where the analysis records the commands and configuration values that stand
+an environment up and someone other than the author has to run them.
+
+Its test is not the one the other five take. They ask whether a claim is worth publishing on
+its own; this one asks whether a reader would type these lines. A reproduction that only
+re-obtains one measurement stays inside that Case's `재현 조건` field, and a procedure nobody
+but the author would run is that Case's environment section.
+
+Setup nodes need a project. A Topic is optional, and a Setup without one reads as that
+project's shared configuration. Instead of a verification date it carries `pinned-versions`
+— the versions the procedure was established on.
+
 ## Three fields the verifier requires and this procedure does not otherwise name
 
 Write them by hand. `verify-tech-log-tree.py` counts each as an error when missing.
@@ -141,12 +157,19 @@ Do not create one Topic per source file or module. A directory is not a Topic.
 - **Open Question** — no answer yet, the design turns on the answer, and there is a next
   verification and a closing criterion.
 - **Decision** — the project actually chose a direction, with grounds and an accepted cost.
+- **Setup** — a procedure the reader runs to stand the environment up. Carries
+  `pinned-versions` instead of a verification date, and always belongs to a project.
 
-The independence test decides all five:
+The independence test decides the first five:
 
 > Delete this record and fold it into a related Case or Concept as one section. If
 > understanding, decisions, and reuse are unchanged, it is not an independent record.
 
+Setup does not answer that question, because folding a procedure into a Case is exactly what
+this kind exists to stop — the commands end up in a plain-text `검증 환경` field where they
+cannot be copied. Ask instead who runs it. If only the author ever will, it is that Case's
+environment, not a record.
+
 Branches may be empty. Symmetry is not a quality goal. Neither is volume — a large
 denominator justifies a long `final/document.md`, not a long tree.
 

.agents/skills/deriving-tech-log-root-tree/references/candidate-disposition.md

@@ -46,6 +46,7 @@
 | Reference | 다음 프로젝트에도 적용할 규칙이며 적용 조건과 예외가 있다 | Case 결론을 선언문으로 바꾼 것 |
 | Question | 답이 아직 없고, 답에 따라 설계가 달라지며, 다음 검증과 종료 기준이 있다 | 실행하지 않은 테스트 목록, 막연한 "다른 방법은?" |
 | Decision | 대안 중 프로젝트가 실제 방향을 정했고 근거와 감수한 비용이 있다 | 기술이 존재한다는 사실, 권장사항, 아직 정하지 않은 방향 |
+| Setup | 남이 자기 기계에서 실행할 명령과 구성 값이 있고 프로젝트가 정해져 있다 | 글쓴이만 다시 돌릴 재현 순서(그 Case 의 재현 조건이다), 명령 없는 구성 설명 |
 
 ## Case 를 언제 합치나
 

.agents/skills/deriving-tech-log-root-tree/references/decomposition-checklist.md

@@ -40,6 +40,13 @@
 - [ ] The title names a mechanism, not an absence, a count, or an analysis-scope fact.
 - [ ] No analysis section number or finding grade survives in the title.
 
+## Setup
+
+- [ ] Someone other than the author has to run it; it is not one Case's reproduction steps.
+- [ ] The commands and configuration values come from the analysis, not from memory.
+- [ ] `pinned-versions` names the versions the procedure was established on.
+- [ ] A project is set. No verification date is invented to stand in for the versions.
+
 ## Reference
 
 - [ ] The rule is reusable beyond the originating incident.

.agents/skills/deriving-tech-log-root-tree/references/example-tech-log-tree.md

@@ -102,7 +102,8 @@
             "classification": "대안을 두고 프로젝트가 실제로 고른 방향이다",
             "relations": ["case:eager-to-one-n-plus-one"]
           }
-        ]
+        ],
+        "setup": []
       }
     }
   },
@@ -149,4 +150,5 @@
 - 후보 셋 중 하나만 글감이 됐다. `MERGE_INTO` 와 `KEEP_IN_SSOT` 이 없는 분해는 선별하지 않은 분해다.
 - Concept 은 Case 를 먼저 고른 뒤에 그것을 읽는 데 필요해서 더했다.
 - Question 에 `decision-criterion` 이 있다. 무엇이 나오면 닫는지를 적지 않으면 검증을 마쳐도 열려 있다.
-- 다섯 종류를 억지로 채우지 않아도 된다. 여기서 다섯이 다 있는 것은 실제로 다섯이 있었기 때문이다.
+- 여섯 종류를 억지로 채우지 않아도 된다. 여기서 다섯이 다 있는 까닭은 실제로 다섯이 있었기
+  때문이고, 여섯 번째인 `setup` 은 비어 있다 — 이 프로젝트에는 남이 따라 할 절차가 없었다.