pipeline: make tech-log-tree.json the one decomposition contract and enforce it

리뷰 두 건을 반영했다. 계약 - tech-log-tree.json 하나가 분해 계약이자 색인이다. 사람이 읽는 트리·Node Specification· 후보 대장은 없어졌고, 문서에 남아 있던 그 개념을 걷어냈다 - candidateScope — 후보를 찾는 SSOT 범위. 접어 넣은 제2부·제3부는 근거이지 후보가 아니다 - sourceRepository — 분석한 저장소의 경로·리비전·판단 근거. 리비전을 모르면 null 로 두고 지어내지 않는다. 갈래가 여럿이면 revisions - 검사기: 계약 미채택·PENDING·PROMOTE↔글감 양방향·candidateScope·sourceRepository 를 error/warn 으로 센다. 옛 스키마도 검사를 피하지 못한다. 테스트 22 → 31 기록 쓰기 - 템플릿 5종에 source·sourceRevision·topicName, Question 에 닫는 조건, 본문 없는 종류에서 assets 제거. 고정 절 개수 삭제 - check_evidence.mjs — 인용한 코드가 SSOT 에 있는지, 앵커가 SSOT 를 가리키는지, 제목이 계약과 같은지, 리비전이 저장소에 있는지. 게시된 기록에서 SSOT 와 다른 URL 을 잡았다 문체 - 문체 규칙의 정본을 ai-tells.md 로. explaining.md 의 질문체 제목·절 끝 대조 반복·그림 예고 규칙을 삭제해 충돌을 없앴다. 첫 절 「설명 뒤에 평가를 붙이지 않는다」에 지우는 사례 네 유형 - voice 스킬의 「독자 쪽을 본다」를 자료에 오독 기록이 있을 때로 좁히고, 평가만 더한 예시를 교체 - check_prose: 안내 문장을 요구하던 경고 제거, 문장이 끝나지 않은 채 문단이 끝나는 조각 검사 추가 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-07 12:39:20 +09:00
parent 73026cada6
commit 9d2a3725c5
54 changed files with 3583 additions and 871 deletions
@@ -0,0 +1,2 @@
+그림의 정본 — <이름>/{context.json, spec.json, prompt.md}.
+technical-visualizer 스킬이 만든다. 손으로 SVG 를 그리지 않는다.
@@ -0,0 +1,2 @@
+그림. 그림 하나가 폴더 하나다 — <이름>/<이름>.svg 와 편집 형식들.
+Studio 에 올릴 표현물은 tech-log-studio/ 아래에 flat SVG 로 둔다.
@@ -0,0 +1,2 @@
+Studio 에 올릴 표현물. 기록 frontmatter 의 `assets: file:` 이 가리키는 자리다.
+그림의 정본은 ../<이름>/ 과 ../../.techviz/<이름>/ 에 있다.
@@ -0,0 +1 @@
+Playwright MCP 로 찍은 브라우저 캡처. 무엇을 찍었는지 한 줄을 적는다.
@@ -0,0 +1 @@
+그 실행의 command·cwd·executedAt·exitCode·revision. 형식은 evidence.json.
@@ -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/rendered|browser/<file>",
+  "proves": "<bounded claim>",
+  "doesNotProve": "<important limitation>"
+}
@@ -0,0 +1,2 @@
+명령 출력·csv·덤프 원문. 여기가 정본이다.
+하위 폴더를 자유롭게 둔다(explain/, guards/). 폴더마다 무엇을 담았는지 한 줄을 README.txt 에 적는다.
@@ -0,0 +1,2 @@
+raw 에서 만든 터미널 SVG. 표현물이지 정본이 아니다.
+scripts/terminal-evidence/render_terminal.py 로 만든다.
				`@@ -0,0 +1 @@`
				`Playwright MCP 로 찍은 브라우저 캡처. 무엇을 찍었는지 한 줄을 적는다.`
				`@@ -0,0 +1 @@`
				`그 실행의 command·cwd·executedAt·exitCode·revision. 형식은 evidence.json.`