init: llm-wiki-haness 하네스 설계

docs/superpowers/README.md

@@ -0,0 +1,95 @@
+# docs/superpowers/ — 작업 기록 아카이브 인덱스
+
+이 폴더는 정제된 지식(`wiki/`)이 아니라 **Superpowers 워크플로우의 작업 기록 보관소**입니다.
+"이 결정을 언제 왜 했나"를 남기는 연대기 로그라서, 파일은 **산출물 종류별 폴더 + 날짜 prefix** 로 평면 저장됩니다.
+
+```
+specs/   *-design.md   — 브레인스토밍(설계) 결과
+plans/   *.md          — 구현 계획 (writing-plans 산출물)
+notes/   *.md          — 실행 중 조사·실측 메모
+```
+
+표준 흐름: `brainstorming → specs/` → `writing-plans → plans/` → 실행 → `notes/`.
+spec ↔ plan 은 **슬러그를 공유**하며 폴더만 다릅니다 (예: `…/branch-depth-gate-design.md` ↔ `…/branch-depth-gate.md`).
+
+> 이 인덱스는 평면 구조를 토픽별로 묶어주는 **읽기용 진입점**입니다. 파일을 옮기지 않으므로 기존 경로 참조는 그대로 유효합니다.
+> 새 작업물은 종전대로 `specs/`·`plans/`·`notes/` 에 날짜 prefix 로 추가하고, 새 토픽이면 아래에 한 줄 추가하세요.
+
+---
+
+## 토픽별 인덱스
+
+### 1. 문서 깊이·구조·검증 게이트 (wiki harness 1차)
+
+브랜치/문서가 "되묻지 않고 착수 가능한 깊이"인지 판정하는 결정론 린터 + 의미 게이트 계열.
+
+| 주제 | 설계(spec) | 계획(plan) |
+|------|-----------|-----------|
+| branch-depth-gate (구현 착수 깊이) | [spec](specs/2026-06-01-branch-depth-gate-design.md) | [plan](plans/2026-06-01-branch-depth-gate.md) |
+| wiki-structure-lint (결정론 구조 린터) | [spec](specs/2026-06-01-wiki-structure-lint-design.md) | _(spec에서 직접 실행)_ |
+| coverage 완전성 게이트 | [spec](specs/2026-06-02-coverage-gate-design.md) | _(spec에서 직접 실행)_ |
+| branch-spec 조립 파이프라인 | [spec](specs/2026-06-02-branch-spec-assembly-pipeline-design.md) | _(spec에서 직접 실행)_ |
+| 검증 강화 (Phase 2) | [spec](specs/2026-06-02-validation-strengthening-design.md) | _(spec에서 직접 실행)_ |
+| 옵시디언 링크 검증 강화 | [spec](specs/2026-06-02-obsidian-link-validation-hardening-design.md) | [plan](plans/2026-06-02-obsidian-link-validation-hardening.md) |
+| operational-error-observability 보강 | [spec](specs/2026-06-01-operational-error-observability-foundation-reinforcement-design.md) | _(branch-note 보강 — plan 없음)_ |
+
+### 2. 한국어 윤문 · 템플릿 모델
+
+| 주제 | 설계(spec) | 계획(plan) |
+|------|-----------|-----------|
+| 한국어 윤문 standard (prose-style) | [spec](specs/2026-06-02-korean-prose-style-design.md) | _(spec에서 직접 실행)_ |
+| wiki/projects 템플릿 · source_type 분리 | [spec](specs/2026-06-04-wiki-project-template-source-type-split-design.md) | [plan](plans/2026-06-04-wiki-project-template-source-type-split.md) |
+
+### 3. project-note 파이프라인
+
+| 주제 | 설계(spec) | 계획(plan) |
+|------|-----------|-----------|
+| project-note 작성 파이프라인 | [spec](specs/2026-06-05-project-note-pipeline-design.md) | [plan](plans/2026-06-05-project-note-pipeline.md) |
+
+### 4. 3-플랫폼 동기화 (Claude / Codex / Antigravity)
+
+| 주제 | 설계(spec) | 계획(plan) | 실측 메모(notes) |
+|------|-----------|-----------|-----------------|
+| 워크플로우 자동화 동기화 (전체 설계) | [spec](specs/2026-06-04-three-platform-workflow-sync-design.md) | — | — |
+| Phase 0 — 생성 엔진 + agents | — | [plan](plans/2026-06-04-three-platform-sync-phase0-engine-agents.md) | [phase1 포맷 실측](notes/2026-06-04-phase1-empirical-format-check.md) |
+| Phase 1 — commands | — | [plan](plans/2026-06-04-three-platform-sync-phase1-commands.md) | — |
+| Phase 2 — hooks + 프로젝트 지침 | — | [plan](plans/2026-06-04-three-platform-sync-phase2-hooks-agentsmd.md) | [antigravity 훅 커버리지](notes/2026-06-04-phase2-antigravity-hook-coverage.md) · [codex 훅 스키마](notes/2026-06-04-phase2-codex-hook-schema.md) |
+| Spec E — Antigravity hook 포팅 | [spec](specs/2026-06-08-spec-e-antigravity-hook-port-design.md) | _(아래 Spec A~F 시리즈 참조)_ | — |
+
+### 5. 하네스 경화 — Spec A~F 시리즈
+
+`2026-06-06` 하네스 설계 감사에서 출발한 연속 deliverable. 같은 "Spec 〈문자〉" 명명을 공유.
+
+| 항목 | 설계(spec) | 계획(plan) |
+|------|-----------|-----------|
+| (출발점) 하네스 설계 감사 보고서 | [report](specs/2026-06-06-harness-audit-report.md) | — |
+| Spec A — 결정론 backbone 게이트화 | [spec](specs/2026-06-06-spec-a-deterministic-backbone-gate-design.md) | [plan](plans/2026-06-06-spec-a-deterministic-backbone-gate.md) |
+| Spec B — judge verdict 스키마 + quorum | [spec](specs/2026-06-06-spec-b-judge-verdict-schema-and-quorum-design.md) | [plan](plans/2026-06-06-spec-b-judge-verdict-schema-and-quorum.md) |
+| Spec C — funnel stats + no-silent-truncation | [spec](specs/2026-06-06-spec-c-funnel-stats-no-silent-truncation-design.md) | [plan](plans/2026-06-06-spec-c-funnel-stats-no-silent-truncation.md) |
+| Spec D — research-fanout Workflow | [spec](specs/2026-06-06-spec-d-research-fanout-workflow-design.md) | [plan](plans/2026-06-06-spec-d-research-fanout-workflow.md) |
+| Spec E — Antigravity hook 포팅 _(→ §4 동기화)_ | [spec](specs/2026-06-08-spec-e-antigravity-hook-port-design.md) | — |
+| Spec F — 투자 파이프라인 경화 _(→ §7 투자)_ | [spec](specs/2026-06-08-spec-f-invest-pipeline-hardening-design.md) | — |
+
+### 6. Deep-Research 하네스 CLI 이식
+
+| 주제 | 설계(spec) | 계획(plan) |
+|------|-----------|-----------|
+| Deep-Research → Codex / Antigravity CLI 이식 | [spec](specs/2026-06-09-deep-research-codex-antigravity-port-design.md) | [plan](plans/2026-06-09-deep-research-codex-antigravity-port.md) |
+
+### 7. 투자(invest) 파이프라인 — Claude 전용
+
+| 주제 | 설계(spec) | 계획(plan) |
+|------|-----------|-----------|
+| 투자 자료·전략 파이프라인 | [spec](specs/2026-06-05-investment-wiki-pipeline-design.md) | [plan](plans/2026-06-05-investment-wiki-pipeline.md) |
+| 투자 분야 지식 지도 (Field Map) | [spec](specs/2026-06-08-invest-field-map-design.md) | [plan](plans/2026-06-08-invest-field-map.md) |
+| 자금흐름 관측 시스템 — 마스터 빌드아웃 | — | [plan](plans/2026-06-08-invest-system-buildout.md) |
+| Spec F — 투자 파이프라인 경화 | [spec](specs/2026-06-08-spec-f-invest-pipeline-hardening-design.md) | _(spec에서 직접 실행)_ |
+
+### 8. ca-tmpl 감사 (외부 코드 대상 — wiki harness 아님)
+
+Clean Architecture Template 저장소(`/home/donghyeon/workspace/ca-tmpl`) 최적화 감사 산출물.
+
+| 주제 | 문서 |
+|------|------|
+| 감사 마스터 보고서 | [report](specs/2026-06-04-ca-tmpl-optimization-report.md) |
+| 파일별 상세 findings | [per-file findings](specs/2026-06-04-ca-tmpl-optimization-per-file-findings.md) |