Skip to content

Commit cebe38e

Browse files
redcourageclaude
andcommitted
docs(v04): add progress/ — Phase A 기능·확인법 정리
새 디렉토리 docs/v04/progress/ 신설 — spec(How)·overview(Why)·notes (검증 로그)와 별개로 "실제 구현이 어디까지 동작하는가 + 어떻게 직접 검증하는가"를 vertical slice 단위로 추적. phase-a-mcp-boot.md (직전 커밋 19b7bf6과 한 쌍): - 동작하는 기능 6가지 (빌드 · initialize · tools/list · schema 자동 추론 · tools/call stub · 정상 종료) - 동작하지 않는 것 (Phase A 한계 표 — Vault·envector·embedder·service 레이어 전부 미구현) - 확인법 3 레벨: CLI 직접 / Claude Code 등록 / MCP Inspector 각 레벨마다 step + 기대 출력 + 합격 기준 - Troubleshooting + 코드 변경 요약 + 다음 마일스톤 후보 progress/README.md (인덱스): - 디렉토리 목적 · spec/notes와의 차이 - 문서 명명 규칙 + "Phase A vs Phase 1~7" 관계 - 현재까지 추적된 마일스톤 표 (Phase A only) + 예정 마일스톤 docs/v04/README.md: 디렉토리 구조 표에 progress/ + notes/flow-matrix.md 한 줄씩 추가. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 19b7bf6 commit cebe38e

3 files changed

Lines changed: 435 additions & 3 deletions

File tree

docs/v04/README.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,9 +40,14 @@ docs/v04/
4040
│ │ └── envector.md # envector-go SDK
4141
│ └── python-mapping.md # Python 파일/LoC → Go 구조 매핑
4242
43-
└── notes/ # 내부 작업 노트 (참고용)
44-
├── verification-matrix.md # Python↔Go bit-identical 대조 검증 로그
45-
└── implementability-report.md # Go 개발자 진입 가능성 검증 리포트
43+
├── notes/ # 내부 작업 노트 (참고용)
44+
│ ├── verification-matrix.md # Python↔Go bit-identical 대조 검증 로그
45+
│ ├── implementability-report.md # Go 개발자 진입 가능성 검증 리포트
46+
│ └── flow-matrix.md # 10 flow × 파일 매트릭스 + Tier S/A/B 공통 모듈
47+
48+
└── progress/ # 실제 개발 진행 추적 (vertical slice 단위)
49+
├── README.md # 인덱스 + 마일스톤별 상태표
50+
└── phase-a-mcp-boot.md # MCP handshake + tools/list (`19b7bf6`)
4651
```
4752

4853
## 읽는 순서

docs/v04/progress/README.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# `progress/` — 실제 개발 진행 추적
2+
3+
본 디렉토리는 **`docs/v04/`의 spec(How)·overview(Why)와 별개로**, 실제 구현이 어디까지 진행됐는지·어떤 단면이 동작하는지·어떻게 검증할 수 있는지를 시간순으로 기록한다.
4+
5+
- **spec/** — "어떻게 만들어야 하는가" (변하지 않는 계약)
6+
- **overview/** — "왜 이렇게 만드는가" (결정·근거)
7+
- **notes/** — bit-identical 검증 로그 등 일회성 작업 노트
8+
- **progress/****여기**: "지금 어디까지 동작하는가 + 어떻게 직접 확인하는가"
9+
10+
## 진행 추적 단위
11+
12+
README의 7-Phase 로드맵(Phase 1 외부 deps → Phase 7 검증)이 **horizontal slice**라면, progress 문서는 **vertical slice** 단위로도 작성될 수 있다. 예를 들어 "MCP handshake만 통과시키는 Phase A"는 7-Phase 어디에도 정확히 매핑되지 않지만, end-to-end 단면이 동작하는 **첫 마일스톤**으로서 별도 문서를 갖는다.
13+
14+
## 문서 명명 규칙
15+
16+
- 하나의 마일스톤 = 하나의 파일 = `<phase-id>-<짧은 설명>.md`
17+
- `phase-a-mcp-boot.md` (handshake + tools/list)
18+
- `phase-1-deps.md` (외부 deps 추가)
19+
- `phase-4a-vault-client.md` (Phase 4 중 Vault 부분)
20+
- 각 문서 상단에 **관련 커밋 SHA · 브랜치 · PR 링크** 명시
21+
- "기능" + "확인법(여러 레벨)" 두 섹션은 필수
22+
- "한계" + "Troubleshooting"은 권장
23+
24+
## 현재 인덱스
25+
26+
| 마일스톤 | 상태 | 문서 | 관련 커밋 |
27+
|---|---|---|---|
28+
| Phase A — MCP boot (handshake + tools/list) | ✅ 합격 | [phase-a-mcp-boot.md](phase-a-mcp-boot.md) | `19b7bf6` (브랜치 `yg/first-mcp-boot`) |
29+
30+
이후 마일스톤 (예정):
31+
- Phase B — `rune_diagnostics` environment 섹션 진짜 응답 (stdlib only)
32+
- Phase 1 — `go.mod` 외부 deps 본격 추가 (gRPC · envector SDK · embedder proto)
33+
- Phase 4a — Vault 클라이언트 + 부팅 시퀀스 연결
34+
- Phase 4b — envector SDK 연결 (Q4 PR 머지 후)
35+
- Phase 4c — embedder 클라이언트
36+
- Phase 5 — service 레이어 오케스트레이션
37+
- Phase 7 — golden fixture 기반 bit-identical 검증
38+
39+
## 사용 방식
40+
41+
- **개발자**: 새 vertical slice를 시작할 때 이 디렉토리에 새 파일을 만들고, 합격 기준을 명시한 뒤 그 기준에 맞춰 작업한다. 파일은 PR과 함께 같은 커밋에 묶는다.
42+
- **리뷰어**: PR을 받았을 때 이 문서의 "확인법"을 그대로 따라 해보면 변경사항이 제대로 동작하는지 검증할 수 있다.
43+
- **다른 팀원**: 어디까지 동작하고 어디부터 미구현인지 한 곳에서 본다 (spec과 다름 — spec은 "최종 모양", progress는 "지금 모양").

0 commit comments

Comments
 (0)