Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
The diff you're trying to view is too large. We only load the first 3000 changed files.
18 changes: 16 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

**PRD·저장 가능한 작업 계획·요구사항 검증·Git 작업을 위한 선택형 스킬 모음.**

![Version](https://img.shields.io/badge/version-0.5.4-6C5CE7?style=for-the-badge)
![Version](https://img.shields.io/badge/version-0.5.5-6C5CE7?style=for-the-badge)
![Skills](https://img.shields.io/badge/core_skills-9-00B894?style=for-the-badge)
![Platform](https://img.shields.io/badge/platform-Codex-111827?style=for-the-badge)
![License](https://img.shields.io/badge/license-Apache--2.0-0984E3?style=for-the-badge)
Expand Down Expand Up @@ -120,6 +120,18 @@ release-readiness ──── 안전한 커밋·푸시·PR

---

## v0.5.5: WorkGraph 선택 조회와 실측 보고서

- `inspect --task TASK-ID`로 지정한 작업·선행 작업과 연결된 기록을 조회합니다. 전체 검증·소스 변경 감지·릴리스 게이트와 생략 개수는 유지합니다.
- 작업 ID를 알 때 사용할 명령 예제를 스킬에 제시하고, 수정용 참조 문서는 필요한 경우에 읽도록 바꿨습니다.
- 8개 합성 상태 조회 사례의 후속 비교에서 두 구현 모두 정답 8/8을 기록했고, v0.5.4 대비 총입력 합계는 56.2% 감소했습니다(조건당 8회, 총 16회; 캐시 입력 포함). 일반 코딩 성능이나 청구 비용의 개선율은 아닙니다.
- 1차 24회와 후속 16회의 결과·실행 로그·고정 스냅샷을 공개합니다. 후보와 사례가 달라 두 실험의 수치를 합산하지 않습니다.
- Knowledge Wiki는 공동 버전 정책에 따른 manifest 변경만 포함합니다.

[변경 내용과 검증 범위](docs/RELEASE-v0.5.5-KO.md) · [실측 테크리포트](docs/scoped-inspect-2026-09-08/report.ko.md)

---

## v0.5.4: Astra 지침 정리·검증 정확성·WorkGraph 복구

- 요청 범위에 맞게 스킬·참조 문서를 정리하고, 명시 호출형 Verified Delivery와 일반 코딩의 경계를 유지했습니다.
Expand Down Expand Up @@ -249,7 +261,9 @@ python3 plugins/wigtn-plugins-with-codex/scripts/wigtn.py --json diff --check
python3 plugins/wigtn-plugins-with-codex/scripts/wigtn.py --json doctor
```

`inspect`는 저장 파일을 검증하고 source drift와 다음 작업을 읽기 전용으로 조회합니다. 저장된 검사 명령을 실행하거나 변경을 적용하지 않습니다. `import`의 상대경로는 `--root` 기준입니다.
`inspect`는 저장 파일을 검증하고 source drift와 다음 작업을 읽기 전용으로 조회합니다. v0.5.5부터 특정 작업을 재개할 때 `inspect --task TASK-ID`로 해당 작업·선행 작업과 연결된 기록만 조회할 수 있습니다. 전체 검증·변경 경고와 생략 개수는 유지되며, 전체 그래프는 옵션 없이 조회합니다. 저장된 검사 명령을 실행하거나 변경을 적용하지 않습니다. `import`의 상대경로는 `--root` 기준입니다.

v0.5.5에 반영한 선택 조회의 GPT-6 Astra 후속 평가에서는 **8개 합성 상태 조회 사례에서 정답 8/8을 유지하며 v0.5.4 대비 총입력 합계가 56.2% 감소**했습니다(조건당 8회, 총 16회; 캐시 입력 포함). 과제별 결과와 적용 범위는 [실측 보고서](docs/scoped-inspect-2026-09-08/report.ko.md)에 기록했습니다.

mutation 명령은 `--apply`가 없으면 dry-run이며, 동일한 import·plan·drift
적용은 revision을 올리지 않습니다. 자세한 상태 의미는
Expand Down
33 changes: 33 additions & 0 deletions docs/RELEASE-v0.5.5-KO.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# v0.5.5 — WorkGraph 선택 조회

저장된 계획에서 특정 작업을 재개할 때 전체 작업 기록을 읽던 경로에 `inspect --task TASK-ID`를 추가했습니다. 예를 들어 두 작업을 확인할 때 `--task`를 두 번 지정하면 해당 작업과 전이적 선행 작업, 연결된 검사·산출물·요구사항·소스를 반환합니다. 옵션을 생략하면 기존 전체 조회를 유지합니다.

전체 그래프 검증·소스 변경 감지·요약·릴리스 게이트는 선택 밖도 계속 검사합니다. 생략 개수와 조회 범위를 명시하며, 알 수 없는 작업 ID는 오류로 처리합니다. `saved_revision`으로 저장된 revision과 변경 감지 후 임시 revision을 구분합니다. 조회는 파일을 변경하거나 저장된 검사 명령을 실행하지 않습니다.

Work Planner 스킬에는 작업 ID를 알 때 사용할 선택 조회 예제를 직접 제시했습니다. 수정용 참조 문서는 상태 수정이나 추가 의미 설명이 필요한 경우 읽도록 바꿨습니다. Knowledge Wiki는 공동 버전 정책에 따라 manifest만 0.5.5로 올렸습니다.

## 실측 결과와 범위

[테크리포트와 원본 증거](scoped-inspect-2026-09-08/report.ko.md)를 함께 공개합니다. 후속 비교는 GPT-6 Astra medium에서 내부 합성 상태 조회 8개 사례를 조건당 한 번씩, 총 16회 실행한 결과입니다.

| 지표 · 조건당 8회 합계 | v0.5.4 | 최종 후보 |
|---|---:|---:|
| 요구 항목 정답 | 8/8 | 8/8 |
| 총입력 토큰 · 캐시 포함 | 696,334 | 304,669 |
| 총입력−캐시 입력 · 단순 차감 | 113,934 | 82,589 |
| 경과 시간(초) | 302.739 | 190.268 |

총입력 합계는 56.2% 감소했습니다. 비용, 일반 코딩 품질, 실제 제품 개발 성능의 개선율을 뜻하지 않습니다. 경과 시간에는 서버 상태와 캐시 영향이 남습니다. 개발자와 평가 설계자가 같으며 외부 독립 평가가 아닙니다.

앞선 1차 24회는 다른 후보와 사례를 사용했으므로 후속 16회와 합산하지 않습니다. 입력이 증가한 1차 실행과 전체 연결 그래프에서 도구 응답이 커진 경계 사례도 보존했습니다.

## 릴리스 검증

- `./scripts/validate.sh`: 전체 저장소·플러그인·스킬·정적 계약 검증 통과. 선택 조회 회귀 테스트 14개 포함.
- 추가 경계 검사 6개 재실행 통과: 손상된 설정/증거, 선택 밖 손상 작업, 선택 안팎 소스 누락, 공유 검사 연결.
- 보관된 1차·후속 세션을 복사본에서 재채점해 결과 JSON이 기존과 정확히 일치함을 확인.
- 원본 archive manifest의 2,594개 + 1,939개 파일 해시 검증 통과. 인증 폴더·파일·심볼릭 링크는 증거 묶음에 포함하지 않음.
- Core 플러그인의 manifest 버전 필드 외 모든 파일이 실측한 후속 후보와 일치함을 확인. 보관된 스냅샷은 수정하지 않음.
- 현재 재현 스크립트는 스냅샷 manifest에서 설치 버전을 읽도록 수정. `prepare --suite followup`으로 v0.5.4/v0.5.5 스냅샷과 기존과 동일한 과제·실행 순서를 생성함을 확인. 릴리스 준비 중 추가 모델 호출은 하지 않음.

실험 시점의 후보 manifest는 0.5.4였습니다. 릴리스 버전만 0.5.5로 변경했으며, 재현 스크립트의 버전 경로 수정과 문서 편집을 모델 성능 재측정으로 취급하지 않습니다.
Loading
Loading