docs(agents): 오케스트레이션 검증과 인용 정정 결과를 기록한다

This commit is contained in:
2026-10-19 16:15:09 +09:00
parent a35a038720
commit ed29250597
3 changed files with 483 additions and 0 deletions
@@ -0,0 +1,235 @@
# 스킬 오케스트레이션 및 우선순위 자동화 구현 계획
| 항목 | 내용 |
|---|---|
| 상태 | 구현 완료 |
| 작성일 | 2026-10-19 |
| 요구사항 기준 | [prd.md](prd.md) |
| API 기준 | 해당 없음 |
| 현재 Phase | 1: 지침·호출 정책 통합 |
| 현재 작업 | 없음 |
## 목표
프로젝트 지침에서 Superpowers 중심의 스킬 선택·중복 방지·호출 제한을 Codex와 OpenCode가 공통으로 읽을 수 있다.
## 범위와 제약
- 포함: 기존 지침 조사, 설치·메타데이터 조사, 공식 문서 대조, 프로젝트 Markdown 수정, 아홉 논리 시나리오 검증.
- 제외: 전역·설치 파일 수정, 스킬 설치, gstack 실행·설치, 앱 코드·빌드 설정 변경, 실제 시나리오 기능 개발, 커밋·푸시.
- 기존 PRD·계획, 한국어, 레거시·보안·Git·로컬 테스트·기기 제한을 보존한다.
- 하네스 지침 계층과 프로젝트의 프로세스 책임 순서를 분리한다.
- 런타임 자동 호출은 검사하지 않으며 문서 논리 검증으로 대신 성공했다고 주장하지 않는다.
- 문서 작업이므로 TDD 예외를 적용한다. 대체 검증은 변경 전 누락·충돌 기준선, 변경 후 시나리오 대조, 문구·경로·diff 검사다.
## Phase 1
**결과:** 근거가 기록된 스킬 선택 지침과 논리 검증 결과를 제공한다.
### 구현 항목
#### Task 1.1 기존 지침·설치·호출 근거 확정
- **작업 ID:** P1-T1.
- **시작 조건:** 사용자의 조사·수정 요청, 기존 지침 우선 조사.
- **범위:** ROUTE-001~003.
- **Files:** `AGENTS.md`, 전역 지침·설정의 관련 필드, 실제 `SKILL.md`와 호출 메타데이터는 읽기 전용. 생성: 이 작업의 `prd.md`, `plan-task.md`, `research.md`.
- **Interfaces:** 파일 경로·출처·정책·미검증 범위를 P1-T2에 전달한다.
- **완료 증거:** 출처를 포함한 조사 문서와 deep-interview의 전체 내용 분석.
- **범위 밖:** 스킬 워크플로 실행과 정책 수정.
- **TDD 예외 사유:** 읽기 전용 조사·문서 기록이다.
- **대체 검증 방법:** `pwd`, `git rev-parse --show-toplevel`, 지침 파일 목록·규칙 `rg`, 설정 관련 필드 읽기, 공식 문서와 설치 소스 대조.
- [x] 현재 위치·Git 루트와 작업 트리 확인, 전역·상위·프로젝트·하위 지침 우선 조사.
- [x] 기존 우선순위·확장 모드·PRD·테스트·보안 규칙과 충돌 후보 식별.
- [x] 설치 경로·심볼릭 링크·스킬 전문·호출 메타데이터 확인.
- [x] deep-interview·brainstorming·grilling 역할과 종료·전달 조건 확정.
- [x] 공식 문서·로컬 근거·설치/호출/런타임 구분을 `research.md`에 기록.
**검증 기록:**
- 2026-10-19: 작업 위치와 Git 루트가 `/Users/klaus/Develop/sodalive/Android/SodaLive`로 일치하고 시작 시 작업 트리가 깨끗함을 확인했다.
- 전역 지침·상위 경로 파일 확인 후 숨김·ignore 해제 파일 탐색에서 프로젝트 루트 `AGENTS.md`만 확인했다. 생성물·의존성·별도 `.worktrees/`는 현재 소스 범위에서 제외했다.
- 기존 확장 모드의 명시 브레인스토밍 제한, 무조건적인 스킬보다 상위라는 문구, 전역 Codex plan 에이전트의 별도 계획·병렬 검토 강제를 충돌 후보로 확인했다. 실제 하네스 상위 지침은 프로젝트 문서로 무효화하지 않는다.
- `codex --version`: `codex-cli 0.163.0`. `opencode --version`: `1.19.3`. 버전 조회는 런타임 호출 검증이 아니다.
- 2026-10-19 추가 확인: `codex plugin --help`, `codex plugin list --help`로 제공 명령을 확인한 뒤 `codex plugin list --json` 조회. Superpowers `6.4.2`는 `installed: true`, `enabled: true`다. 개별 자동 호출은 실행하지 않았다.
- 전체 deep-interview 127행과 관련 설계 스킬을 읽고, 두 Superpowers 경로의 15개 정의·메타데이터 및 Matt 다섯·Addy 여섯의 실제 설치·출처를 대조했다. 모든 보조 참조 문서의 전문까지 읽은 것은 아니며 범위와 누락을 `research.md`에 구분했다.
#### Task 1.2 프로세스 우선 선택·중복 방지 정책 반영
- **작업 ID:** P1-T2.
- **시작 조건:** P1-T1 근거 확정과 이 PRD·계획 준비.
- **범위:** ROUTE-004~007.
- **Files:** 수정 `AGENTS.md`, `docs/agent-guides/work-plan-docs.md`; 생성 `docs/agents/skill-routing.md`.
- **Interfaces:** AGENTS는 실행 핵심·기본 라우팅, 상세 가이드는 중복 조합·호출 제약·플랫폼 차이를 제공한다. 조사 문서는 시점별 근거이며 현재 스킬 내용 재확인을 대신하지 않는다.
- **완료 증거:** 충돌 문구의 좁은 수정과 단계별 단일 책임·명시 전용 분리.
- **범위 밖:** 전역 설정·플러그인·설치된 스킬·에이전트 수정, 자동 호출 보장.
- **TDD 예외 사유:** Markdown 정책만 수정한다.
- **대체 검증 방법:** 변경 전 정책 누락과 변경 후 문구·라우팅 시나리오·diff 비교.
- [x] 기존 스킬 설정 블록과 지침을 보존하며 Superpowers 주 책임·좁은 전문 보완을 명시한다.
- [x] 명시 브레인스토밍 제한과 우선순위 문구의 충돌만 최소 수정한다.
- [x] 작업 분류·선택·재사용·명시 호출 정책, 여섯 중복 조합의 책임을 기록한다.
- [x] 관련 작업 가이드의 절차·경로를 동기화한다.
**검증 기록:**
- 2026-10-19: `AGENTS.md`에 기존 Agent skills 블록을 확장하고 별도 스킬 블록을 중복 생성하지 않았다. `docs/agents/skill-routing.md`는 주 프로세스·중복 조합·명시 호출·권한을 기록하며 루트에서 필요한 경우 직접 읽도록 연결했다.
- 기존 “모든 프롬프트에 PRD” 문구는 일반 질문·읽기 전용 조사와 충돌하여 구현 요청에 한정했다. 구현의 PRD·계획 선행은 보존했다. 인터뷰도 실행 방향에 중요한 불확실성에 한정하고 관련 가이드와 동기화했다.
- `rg`로 실제 스킬 이름, 명시 호출 제한과 역할을 확인했다. Codex 플러그인 활성 조회 결과를 반영하되 실제 새 정책·자동 호출은 미검증으로 남겼다.
#### Task 1.3 전체 오케스트레이션 재검증
- **작업 ID:** P1-V1.
- **시작 조건:** P1-T1·P1-T2·P1-GATE 완료, 사용자의 전체 재검증 요청.
- **목표:** 체크리스트만이 아니라 ROUTE-001~009, 전체 정책 문서, 현재 설치·발견 상태와 아홉 시나리오를 재확인한다.
- **Files:** 정책·전역 설정·설치 스킬은 읽기 전용. 생성: `reviews/phase1-skill-orchestration-review.md`. 이 계획에는 검증 이력만 누적한다.
- **완료 증거:** 요구사항별 판정, 현재 CLI 발견 결과, 한 검토자의 판정, 실제 검증 명령과 제약.
- **범위 밖:** 정책·앱 코드·전역 설정 자동 수정, 새 기능·실제 시나리오 구현, 설치·커밋·푸시.
- **TDD 예외 사유:** 완료된 문서·설치 구성의 검증 작업이다.
- **대체 검증 방법:** 전체 문서 재읽기, 기존 지침 보존·호출 정책·부속 파일 대조, 읽기 전용 CLI 조회와 아홉 논리 시나리오, 한 검토자의 근거 대조.
- [x] 전체 문서와 기존 ROUTE-001~009의 대응 관계를 다시 확인한다.
- [x] 설치·명시 호출 정책·추가 참조와 실제 CLI 발견 상태를 확인한다.
- [x] 아홉 시나리오 및 명시 호출·권한 거부·후속 작업의 경계 조건을 대조한다.
- [x] 한 검토자의 판정과 남은 제약을 리뷰 보고서·검증 이력에 기록한다.
#### Task 1.4 R-01 Addy 출처 인용 회귀 정정
- **작업 ID:** P1-R1.
- **Review ID:** R-01, `reviews/phase1-skill-orchestration-review.md` §6.
- **시작 조건:** 사용자의 R-01 수정 승인, 실제 lockfile 키·source 및 기존 두 인용 재확인.
- **목표:** 변동하는 행 번호 인용을 여섯 스킬의 lockfile 키와 source 값 기준으로 바꾼다.
- **Files:** 수정 `research.md`의 Addy 표·출처 설명 두 곳. 이 계획과 기존 리뷰 보고서에는 정정·검증 결과를 누적한다.
- **회귀 검증:** `research.md`에서 `lines 134-186` 잔존 없음, 두 인용의 키·source 기준 확인, 실제 여섯 lockfile 항목의 source 일치 검사, 문서 diff·공백 검사.
- **완료 증거:** 두 인용 정정, 여섯 source 일치, 검증 명령 결과와 R-01 수정 완료 기록.
- **범위 밖:** 스킬·메타데이터·AGENTS·전역 설정·앱 코드 변경, 과거 발견·검증 기록 삭제, 커밋.
- **TDD 예외 사유:** 실행 로직 없는 문서 인용 정정이다. 기존 잘못된 인용 검색을 실패 기준선으로, source 대조·잔존 검색·diff 검사를 대체 검증으로 사용한다.
- [x] 기존 두 인용과 실제 여섯 lockfile 키·source를 재확인한다.
- [x] 두 인용을 행 번호가 아닌 키·source 기준으로 정정한다.
- [x] 여섯 source와 문서 인용·공백을 검사하고 계획·리뷰에 완료 증거를 누적한다.
**검증 기록:**
- 2026-10-19: 기존 `research.md` 두 곳의 `lines 134-186`을 재현·확인한 뒤 행 범위를 제거하고 실제 여섯 키와 `source` 값으로 정정했다.
- `jq -e`로 지정된 여섯 키 각각의 source가 `addyosmani/agent-skills`인지 검사해 `true`, 종료 코드 0을 확인했다. 전체 명령은 리뷰 보고서 §8에 기록했다.
- `rg` 부정 검색으로 `research.md`에 잘못된 행 범위가 남지 않았고, 두 인용이 모두 키·source 기준임을 확인했다. `git diff HEAD --check` 통과.
### Phase 1 Gate
- **작업 ID:** P1-GATE.
- **시작 조건:** P1-T1·P1-T2 완료.
- **범위:** ROUTE-008~009.
- **Files:** 생성 `scenario-validation.md`; 갱신 PRD·계획의 상태와 검증 기록.
- **완료 증거:** 원문 아홉 시나리오의 논리 판정, 문서 검사·범위·Gradle 조회 실제 결과.
- **범위 밖:** 실제 로그인·결제·보안·버그·구조 개선 실행, 런타임 자동 호출 주장.
- **대체 검증 방법:** 표 기반 정책 대조, 파일 읽기·`rg`, `git diff --check`, `git status --short --untracked-files=all`, `./gradlew tasks --all`.
- [x] 원문 아홉 시나리오 각각의 분류·메인·보완·순서·제외·호출·승인 조건을 대조한다.
- [x] 호출 제한·지원되지 않는 기능을 우회하지 않는지, 기존 핵심 제약이 유지되는지 확인한다.
- [x] 참조 경로·중복 헤더·공백·의도한 Markdown 변경 범위를 검사한다.
- [x] `./gradlew tasks --all`의 실제 결과와 진단 도구·런타임 검증 한계를 기록한다.
- [x] 전역 변경이 필요한 사항은 제안으로만 분리하고 최종 결과를 보고한다.
## 실행 순서
기존 지침 조사 → 설치·인터뷰 분석 및 공식 문서 조사 → P1-T1 근거 기록 → P1-T2 문서 반영 → P1-GATE.
독립적인 읽기 전용 조사만 병행하고 정책 편집자는 하나로 제한한다. 검증 결과가 의존하는 조사 완료 전에는 해당 정책을 구현하지 않는다.
## Progress
### P1-T1 1차 실행: 2026-10-19
- 상태: 진행 중.
- 무엇을: 기존 지침·환경·보존 조건을 확인하고 PRD와 계획을 준비했다.
- 왜: 새 규칙 전에 실제 적용 지침을 조사하라는 사용자 요구와 저장소 문서 절차를 준수한다.
- 어떻게: 경로·설정·기존 지침 읽기, 규칙 검색, CLI 버전 조회.
- 남은 항목: 스킬·공식 근거 수집, 정책 반영, 시나리오·문서 검증.
### P1-T1·P1-T2 2차 실행: 2026-10-19
- 상태: 완료.
- 무엇을: 지침·설치·공식 근거와 deep-interview 분석을 기록하고 프로젝트 정책 세 문서를 반영했다.
- 왜: 주 책임·전문 보완·명시 호출·실행 전제를 분리해 반복 분석과 권한 우회를 방지한다.
- 어떻게: 실제 스킬·메타데이터·출처 lockfile 읽기, 공식 문서 조회, Codex 플러그인 조회, root·가이드 diff 및 문구 대조.
- 남은 항목: 없음. 현재 하네스의 자동 호출과 Addy의 누락 자료는 검증 제한으로 별도 기록했다.
### P1-GATE 1차 실행: 2026-10-19
- 상태: 완료.
- 무엇을: 아홉 원문 요청의 기대 경로와 최종 정책을 대조하여 논리 판정 9/9 PASS를 기록했다.
- 왜: 기능을 실제 개발하지 않고도 정책의 단일 책임·승인·호출 제한을 확인한다.
- 어떻게: `scenario-validation.md`의 결과표, 아래 정합성·범위·Gradle 검증 결과.
- 남은 항목: 없음. 실제 자동 호출은 수행 범위 밖이며 미검증이다.
### P1-V1 전체 재검증: 2026-10-19
- 상태: 검증 완료.
- 무엇을: ROUTE-001~009 전체와 아홉 시나리오, 현재 설치·호출 제한·CLI 발견을 재확인하고 단일 독립 검토를 받았다.
- 왜: 사용자가 누락 체크리스트만이 아니라 오케스트레이션 전체를 다시 검증하라고 요청했다.
- 어떻게: 전체 정책·기준 문서 재읽기, 현재 파일·메타데이터·부속 의존성 검사, `opencode debug skill`·`debug config`의 실제 출력 대조, `codex plugin list --json`, 보호 경로 diff, 정책 문구 검사, Gradle task 목록 조회.
- 결과: OpenCode 대상 27/27 발견(전체 목록 44개), Codex Superpowers 6.4.2 설치·활성, 논리 Q1~Q9 PASS, 독립 검토 APPROVE. 상세 증거는 `reviews/phase1-skill-orchestration-review.md`에 기록했다.
- 발견: R-01 Low. `research.md`의 Addy lockfile 인용 범위가 현재 행과 달라졌으며 문서 추적 정확성 문제다. 실제 여섯 source·설치·발견은 정상이다. 검증 요청 범위를 넘지 않도록 원문은 수정하지 않았다.
- 남은 검증: 실제 모델 자동 호출, 설치본·upstream revision 완전 일치, 모든 실행 스크립트의 실제 호환성·승인 충족은 이번 검증으로 보장하지 않는다.
### P1-R1 R-01 인용 정정: 2026-10-19
- 상태: 수정·검증 완료.
- 무엇을: `research.md`의 Addy 출처 인용 두 곳을 행 번호 대신 실제 스킬 키·source 값 기준으로 정정했다.
- 왜: 사용자가 확인된 R-01 수정을 승인했으며, lockfile 행 이동으로 같은 문제가 반복되지 않도록 한다.
- 어떻게: P1-R1을 먼저 추가한 뒤 문서 두 곳만 정정하고 실제 여섯 source, 잔존 인용, 공백·변경 범위와 Gradle task 명령을 검사했다. 리뷰의 과거 발견·판정 기록은 남기고 §8에 수정 결과를 누적했다.
- 남은 항목: R-01 없음. 기존 모델 자동 호출 등 미검증 범위는 이번 문서 정정과 별개다.
## Decision Log
| 날짜 | ID | 상태 | 결정 | 근거 |
|---|---|---|---|---|
| 2026-10-19 | DEC-001 | 확정 | 기존 개발 안전 제약 보존, 충돌만 좁게 조정 | 사용자 요구와 PRD |
| 2026-10-19 | DEC-002 | 확정 | 별도 설치·런타임 실행 없이 문서 정책·논리 시나리오 검증 | 사용자 지정 범위 |
| 2026-10-19 | DEC-003 | 확정 | 일반 질문·읽기 전용 조사에는 불필요한 PRD·계획 생성 제외 | 구현 선행 문서 조건은 보존하며 읽기 전용 라우팅과 기존 포괄 문구 충돌 해소 |
| 2026-10-19 | DEC-004 | 확정 | R-01 출처를 행 번호 대신 스킬 키·source 값으로 인용 | 사용자 수정 승인, 실제 lockfile 여섯 항목 대조 |
## Verification Log
최종 검증 전이다. 통합 결과는 아래에 누적한다.
### 최종 검증: 2026-10-19
- 위 문장은 초기 상태 기록이다. 아래는 실제 최종 검증 결과다.
- 논리 시나리오: `scenario-validation.md`에 사용자가 준 아홉 원문, 변경 전 기준선, 변경 후 분류·메인·보완·순서·제외·자동 선택·승인 조건과 최종 9/9 PASS를 기록했다. 정책 문서 대조이며 런타임 테스트가 아니다.
- `rg` 및 셸 `test`: Agent skills 헤더 한 개, 여섯 중복 조합, 원문·기대 경로의 아홉 행, 실제 TDD 스킬명, 명시 전용 두 스킬, 후속 첫 미완료 Task, deep-interview의 중요한 0.50 이하 차원 조건, 레거시·기기 테스트·민감 파일 보호 문구와 문서 링크 경로 확인. 종료 코드 0.
- `git diff --check`: 종료 코드 0, 추적 문서의 공백 오류 없음. 신규 파일은 별도 `rg`의 줄 끝 공백·내부 표식 부정 검색과 전체 재읽기로 확인했다.
- `git diff --exit-code -- app build.gradle settings.gradle gradle.properties .gitignore docs/agents/issue-tracker.md docs/agents/domain.md`: 종료 코드 0. 앱·빌드 설정·기존 로컬 이슈·도메인 설정 변경 없음.
- `git -c core.quotePath=false status --short --untracked-files=all`: 수정 2개(`AGENTS.md`, 작업 가이드), 신규 5개(상세 정책, 이번 작업 PRD·계획·조사·시나리오), 모두 Markdown이다. 전역·설치 파일에 대한 편집 도구 호출은 하지 않았다.
- `git diff --stat`: 기존 문서 기준 22줄 추가, 6줄 삭제. 신규 다섯 파일은 미추적 상태여서 이 통계에 포함되지 않으며 최종 파일 범위에는 포함했다.
- `wc -c AGENTS.md`: 현재 루트 문서는 Codex 기본 합산 한도 32 KiB보다 작다. 이는 다른 지침이 더해질 미래 세션의 무조건적인 비절단 보장은 아니다.
- `./gradlew tasks --all`: 종료 코드 0, `BUILD SUCCESSFUL in 3s`, `1 actionable task: 1 executed`. task 목록 조회만 수행했고 앱 컴파일·테스트는 하지 않았다.
- 기존 Gradle deprecated feature 경고(Gradle 9.0 비호환)가 출력됐으며 문서 변경과 무관한 범위로 수정하지 않았다.
- Markdown LSP: 현재 도구에 `lsp_diagnostics`가 없어 실행하지 못했다. 이 제한을 문서 검사 통과와 구별한다.
- 런타임 제한: CLI 버전·플러그인 설치/활성·현재 스킬 광고와 파일 검색은 확인했으나 새 세션에서 AGENTS를 로드하여 아홉 요청의 자동 선택을 실행하지 않았다. 두 하네스에 새 지침을 적용하려면 프로젝트 루트에서 새 세션을 시작한다.
- 후속 제안만 기록: 전역 Codex planner의 `.omo/plans`·병렬 절차와 프로젝트 규칙의 조정, Addy 공유 체크리스트 네 개의 설치 복구는 별도 승인 대상이다. 현재 설치·활성인 Superpowers를 다시 설치하거나 활성화하지 않는다.
- 생략: 문서 전용 작업으로 앱 빌드·전체 테스트·UI·기기 검증을 하지 않았다. 스킬·플러그인 설치, gstack 호출, 커밋·푸시도 하지 않았다.
### 전체 재검증 추가 기록: 2026-10-19
- 위 최초 조사·검증 기록은 보존했다. 사용자가 추가한 Addy 공유 체크리스트 네 개는 현재 실제 경로·본문·직접 및 하위 패턴의 참조가 모두 정상이다. 당시 누락 기록을 현재 상태로 오인하지 않는다.
- `opencode debug skill`: 일반 파이프·PTY 직접 jq 파싱은 실패했지만, PTY 출력의 로그·ANSI를 분리하고 완결 JSON 배열을 파싱하는 방식으로 종료 코드 0. 전체 44개 중 목표 27개 모두 발견, 누락 0. 발견과 자동 호출을 구분한다.
- `opencode debug config`: 필요한 설정 필드만 출력해 Superpowers 경로 등록, 추가 `instructions: []`, 명시적 전역·에이전트 skill 차단 설정 없음 확인. 원본 전체 구성·비밀값은 기록하지 않았다.
- `codex plugin list --json`: Superpowers 6.4.2 `installed: true`, `enabled: true` 재확인. 스킬별 모델 자동 선택 증거는 아니다.
- `git diff HEAD --check` 및 보호 경로의 `git diff HEAD --exit-code`: 종료 코드 0. 현재 전체 정책은 staged 변경까지 포함해 재읽었다. 이 재검증은 기존 stage/index를 조작하는 Git 명령을 실행하지 않았다.
- 독립적인 정책 문구 검사 Q1~Q9: 모두 PASS. 별도로 명시 전용·잘못된 트리거·deny·후속 재개·도구 전제 조건을 확인했다. 실제 기능·모델 테스트로 해석하지 않는다.
- `./gradlew tasks --all`: 종료 코드 0, `BUILD SUCCESSFUL in 2s`, `1 actionable task: 1 executed`. 기존 Gradle 9.0 비호환 deprecated feature 경고는 범위 밖으로 보존했다.
- Oracle 검토자 한 명이 문서·설치 원문과 CLI 결과를 읽기 전용으로 대조하고 APPROVE했다. 승인 범위는 문서 정책·설치 연결·발견에 한정된다. R-01 Low 인용 오류는 실제 lockfile 재읽기로 확인했고 수정은 미실행이다.
- Markdown LSP·앱 빌드·전체 테스트·UI·기기 실행·새 정책의 실제 모델 자동 호출은 하지 않았다. 정책 본문·전역 설정·설치본을 수정하지 않았고 기록 문서만 갱신했다.
- 추가 진단 확인: 현재 `lsp_diagnostics` 도구는 호출 가능하며, 계획·리뷰 `.md` 두 파일 모두 `No LSP server configured for extension: .md`를 반환했다. 이번 재검증의 정확한 제한은 Markdown 서버 미설정이다. 앞선 LSP 미실행 기록과 구분하며 진단 완료로 판정하지 않았다. 앱·UI·실제 자동 호출 미실행과 전역 무수정은 그대로다.
### R-01 문서 정정 검증: 2026-10-19
- P1-R1을 추가한 뒤 `research.md`의 두 인용만 정정했다. 기존 완료 Task·검증·리뷰 기록은 보존했고, 이번 변경 대상은 조사·계획·리뷰 Markdown 세 파일이다.
- 여섯 스킬 키의 실제 source 검사: `jq -e` 결과 `true`, 종료 코드 0. 잘못된 행 범위 부정 검색과 두 키·source 인용 확인도 종료 코드 0.
- `git diff HEAD --check` 통과. `git diff -- research.md`는 출처 인용 두 줄의 변경만 확인했다. Git stage·commit·push 명령을 실행하지 않았다.
- `./gradlew tasks --all`: 종료 코드 0, `BUILD SUCCESSFUL in 1s`, `1 actionable task: 1 executed`. 기존 Gradle deprecated feature 경고는 수정하지 않았다. 앱 빌드·테스트 결과가 아니다.
- Markdown LSP는 요청했으나 `.md` 서버 미설정으로 완료할 수 없다. 문서 검색·실제 JSON 대조·diff 검사를 대체 검증으로 사용했다.
- R-01은 문서 회귀 검증으로 수정 완료했다. 별도 새 독립 검토나 실제 모델 자동 호출은 실행하지 않았다. 스킬·AGENTS·전역 설정·앱 코드는 변경하지 않았다.
@@ -0,0 +1,176 @@
# 전체 스킬 오케스트레이션 재검증 보고서
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 1 전체, ROUTE-001~009, P1-T1·P1-T2·P1-GATE |
| 기준 | 현재 working tree와 HEAD의 차이. 시작 시 기존 7개 파일이 staged 상태였음 |
| 리뷰 일자 | 2026-10-19 |
| 리뷰어 | Sisyphus 자체 검증, Oracle 독립 검토자 1명 |
| 기준 문서 | `../prd.md`, `../plan-task.md`, `../research.md`, `../scenario-validation.md` |
| 리뷰 상태 | 판정 완료: 문서 정책·설치·발견 APPROVE, 실제 자동 호출 미검증 |
| 후속 정정 상태 | P1-R1에서 R-01 수정·검증 완료. §8 참조 |
## 2. 목적과 범위
체크리스트 네 개만이 아니라 사용자가 요청한 AGENTS 스킬 오케스트레이션 전체가 추가되었는지 확인한다. 전체 정책·작업 문서를 재읽고 현재 설치, 호출 제한, 실제 CLI 발견 결과와 아홉 논리 시나리오를 대조한다.
- 포함: `AGENTS.md`, `docs/agents/skill-routing.md`, `docs/agent-guides/work-plan-docs.md`, 이 작업의 PRD·계획·조사·시나리오, 기존 이슈·도메인 안내와 현재 설치 스킬·참조.
- 제외: 정책·앱 코드·전역 설정의 자동 수정, 실제 로그인·API·보안·버그·리팩터링 기능 실행, 설치·커밋·푸시.
- 검증 층위: 문서 논리, 파일·메타데이터, 실제 CLI 발견, 실제 모델의 자동 선택을 구분한다. 마지막 항목은 미실행이며 다른 층위의 PASS로 대신하지 않는다.
- 현재 트리의 문서·구성 검토이며 PR·브랜치 전환 리뷰가 아니므로 별도 worktree를 만들지 않는다.
## 3. 요구사항별 대조
| 요구사항 | 판정 | 근거 |
|---|---|---|
| ROUTE-001 기존 지침·우선순위 조사 | 확인 | 현재 루트 외 적용 경로의 AGENTS·override·CLAUDE 부재 재확인, 전역 설정 존재 확인. `AGENTS.md:10`, `research.md` §3 |
| ROUTE-002 설치·호출 정책 구분 | 확인 | 양쪽 Superpowers 소스 15개, 공유 Matt 5·Addy 6·deep 1 확인. OpenCode 실제 발견 27/27, Codex 플러그인 설치·활성. 아래 CLI 증거 |
| ROUTE-003 deep-interview 전문·책임 | 확인 | 현재 127행 전문 재읽기. 한 질문, 중요 불확실성, 점수 휴리스틱·종료 예외와 파일 생성 지시 부재 확인. 상세 정책 §기본 라우팅 |
| ROUTE-004 Superpowers 중심 단일 책임 | 확인 | `AGENTS.md:145`, `:147`, `:149`, `:152`; 상세 정책 §적용 원칙·기본 라우팅 |
| ROUTE-005 여섯 중복 조합 | 확인 | 상세 정책 §여섯 중복 조합 6개 행, 요청 유형별 전문 역할·우선순위·진입 조건 구분 |
| ROUTE-006 명시 호출·권한·도구 제약 | 확인 | 두 Matt 스킬의 SKILL·OpenAI policy 모두 금지 확인. `AGENTS.md:151`, 상세 정책 §명시 호출·권한·플랫폼 차이 |
| ROUTE-007 기존 지침 보존·최소 수정 | 확인 | `git diff HEAD -- AGENTS.md docs/agent-guides/work-plan-docs.md`; 보호 대상 diff 없음, 기존 Issue tracker·Domain docs 유지 |
| ROUTE-008 아홉 시나리오 논리 검증 | 확인 | 기존 원문 9개·기대 경로·판정 재대조. 아래 QA Q1~Q9. 실제 워크플로 실행은 하지 않음 |
| ROUTE-009 출처·검증·제약 기록 | 확인 | 기존 조사 출처·이력 보존, 현재 CLI·설치·복구 결과를 이 보고서에 누적. 실제 자동 호출은 미검증으로 유지 |
## 4. 자체 QA와 실행 증거
### 환경과 원본 상태
- 작업 위치: `/Users/klaus/Develop/sodalive/Android/SodaLive`.
- 시작 시 `git status --short --branch --untracked-files=all`: `main`, origin 대비 ahead 125, 기존 정책 7개 파일이 staged. 이 검증은 index를 변경하지 않는다.
- 최근 관련 기록: `d4a46802` 저장소 지침에 기존 스킬 설정 문서 연결. 아직 커밋되지 않은 오케스트레이션 문서는 HEAD가 아니라 현재 파일 자체를 검토했다.
- 적용 경로 파일 확인: 현재 루트 `AGENTS.md`, 전역 `~/.config/opencode/opencode.json`만 발견. 소스 범위 재귀 탐색도 `AGENTS.md`만 반환했다. 별도 worktree·생성물·의존성은 현재 적용 범위 밖이다.
- `wc -c AGENTS.md`: 13224 bytes, 현재 Codex 기본 문서 한도 32 KiB 미만. 향후 추가 지침 합산까지 보증하지 않는다.
### 주요 명령과 실제 결과
1. `codex plugin list --json | jq '.installed | map(select(.name == "superpowers") | {pluginId,version,installed,enabled})'`
```json
[{"pluginId":"superpowers@openai-curated-remote","version":"6.4.2","installed":true,"enabled":true}]
```
2. `opencode debug --help`, `opencode debug skill --help`로 실제 명령을 먼저 확인했다. 일반 파이프의 `opencode debug skill | jq ...`는 불완전 JSON 오류, PTY 출력에 바로 jq를 붙인 방식은 로그 혼합으로 파싱 오류가 났다. 전역 설정을 바꾸지 않고 PTY 출력의 ANSI·로그를 분리한 뒤 완결 JSON 배열만 파싱하여 성공했다.
실행은 `NO_COLOR=1 script -q /dev/null opencode debug skill`의 표준출력을 Node의 stdin 문자열 처리로 넘겼다. decoder는 ANSI escape와 CR을 제거하고 단독 `[` 행부터 마지막 배열 종료 `]`까지 JSON.parse한 뒤 아래 27개 이름의 존재를 검사했다. 파일을 읽거나 쓰는 스크립트를 설치하지 않았다.
```text
total: 44
sampleKeys: name, description, location, content
target skills found: 27/27
missing: []
```
발견된 대상은 Superpowers 15개, Matt 5개, Addy 6개, deep-interview 1개다. 위치는 기존 조사 보고서의 두 Superpowers 캐시 및 `~/.agents/skills/<name>/SKILL.md`와 일치했다. 이 목록은 등록·발견 증거이며 모델 자동 호출 결과가 아니다. 명시 전용 두 Matt 스킬도 발견 목록에는 존재하므로 발견 여부와 호출 허용을 혼동하지 않는다.
3. 셸 `test -s`로 두 Superpowers 경로의 15개 정의 각각과 공유 스킬 12개를 검사했다. 모두 통과했다. 선택적 실행 전제를 확인하기 위해 다음 부속 파일의 존재도 검사했다.
```text
PASS brainstorming/builder-check-prompt.md
PASS executing-plans/scripts/task-start
PASS executing-plans/scripts/task-done
PASS subagent-driven-development/scripts/sdd-workspace
PASS subagent-driven-development/scripts/review-package
PASS codebase-design/DEEPENING.md, DESIGN-IT-TWICE.md
PASS domain-modeling/GLOSSARY-FORMAT.md, ADR-FORMAT.md
PASS improve-codebase-architecture/HTML-REPORT.md
```
파일의 존재는 실행 호환성·격리·권한 충족의 증거가 아니므로 스크립트는 실행하지 않았다.
4. `rg -n '^name:|^disable-model-invocation:|^metadata:|opencode/autoinvoke|allow_implicit_invocation'`으로 해당 Matt 정의·sidecar를 확인했다. `improve-codebase-architecture`, `setup-matt-pocock-skills`는 `disable-model-invocation: true` 및 `allow_implicit_invocation: false`를 유지한다. 세 모델 호출용 Matt sidecar는 표시 메타데이터만 있고, deep-interview는 본문에 명시 호출 금지 메타데이터가 없다.
5. 복구한 네 문서는 `~/.agents/references/`에 모두 존재하고 읽을 수 있으며 비어 있지 않다. 실제 `../../references/` 경로와 기존 보안·성능 패턴 문서의 `../../../references/` 경로도 통과했다. 직전 전체 본문 확인에서 Markdown 제목과 필요한 OWASP·destructive path·caching 섹션을 확인했다. upstream 특정 revision과의 전체 내용 일치는 검사하지 않았다.
6. `rg`·셸 assertion은 다음 조건을 모두 통과했다: Agent skills 블록 1개, 중복 조합 6개, 기존 시나리오 판정 9개, 일반 조사 예외, 단계별 단일 책임, bootstrap 중복 로드 방지, domain-modeling의 직접 책임, 기존 의존성 검토와 신규 설계 분리, 인터뷰 동시 루프 금지, 중요 명확성 0.50 이하 guard, 명시 호출·권한 승인 구분, deny 우회 금지, 두 실행 스킬의 배타 선택, 첫 미완료 Task 재개, 자동 호출 보장 금지, gstack 금지.
7. `git diff HEAD --check`: 종료 코드 0. `git diff HEAD --exit-code -- app build.gradle settings.gradle gradle.properties .gitignore docs/agents/issue-tracker.md docs/agents/domain.md`: 종료 코드 0. 정책 본문은 보존하고 이 계획·보고서만 검증 기록으로 갱신한다.
8. `./gradlew tasks --all`: 종료 코드 0, `BUILD SUCCESSFUL in 2s`, `1 actionable task: 1 executed`. 기존 Gradle deprecated feature 경고는 그대로이며 이 명령은 앱 빌드·테스트나 스킬 자동 호출 검증이 아니다. 신규 리뷰 보고서의 줄 끝 공백 검사와 `../../agents/skill-routing.md`, `../prd.md`, `../scenario-validation.md`의 실제 경로 검사도 통과했다.
9. `opencode debug config`의 현재 병합 결과도 PTY·JSON 추출 방식으로 조회했다. 원본 전체 구성은 노출하지 않고 `instructions`, `skills.paths`, 전역·에이전트별 skill 권한과 tool 활성 필드만 출력했다. 결과는 `instructions: []`, Superpowers·Ponytail·i-have-adhd 경로 등록, 전역 및 조회된 에이전트의 명시적 `permission.skill`·`tools.skill` 설정 없음이다. 따라서 이 구성에서 별도 skill 거부나 tool 비활성 설정은 발견되지 않았다. 미설정 필드를 모든 상황의 실행 허가·자동 호출 증거로 간주하지 않는다. 기본 AGENTS 검색은 `instructions` 배열과 별도이므로 빈 배열이 루트 지침 누락을 뜻하지 않는다.
10. 현재 도구로 계획·리뷰 Markdown 두 파일에 `lsp_diagnostics`를 실제 요청했다. 두 결과 모두 `No LSP server configured for extension: .md`였다. 따라서 이 재검증에서의 LSP 제한은 도구 자체 부재가 아니라 Markdown 서버 미설정이며, 진단 완료·오류 없음으로 주장하지 않는다. 서버나 전역 설정은 설치·수정하지 않았다.
### 아홉 시나리오 재대조
| QA | 원문 요청 | 기대 경로와 관찰된 문서 규칙 | 논리 판정 | 근거 artifact |
|---|---|---|---|---|
| Q1 | 사용자 로그인 기능을 만들어줘. | brainstorming 주 설계, security 보완, 실제 계약이 있을 때 API 보완. 기준선·최종 정책 일치 | PASS | `../../agents/skill-routing.md` §기본 라우팅, `../scenario-validation.md` S1 |
| Q2 | 요구사항이 아직 모호한 신규 서비스를 설계해줘. | brainstorming 메인, 중요한 요구 공백만 deep-interview 하위 단계, 결정 재사용 | PASS | 같은 정책 §여섯 중복 조합, 시나리오 S2 |
| Q3 | 결제 도메인의 용어와 상태를 정리해줘. | domain-modeling이 전문 작업 담당. 불필요한 신규 기능 설계 루프 제외 | PASS | 같은 정책 기본 라우팅의 도메인 행, 시나리오 S3 |
| Q4 | 이 모듈의 의존성 설계를 검토해줘. | requesting-code-review와 codebase-design으로 읽기 전용 검토. 자동 리팩터링 제외 | PASS | 같은 정책 기존 의존성 행, 시나리오 S4 |
| Q5 | 새로운 REST API를 설계해줘. | brainstorming 설계, api-and-interface-design의 계약·호환성 보완 | PASS | 같은 정책 REST/API 행, 시나리오 S5 |
| Q6 | 인증 과정에 보안 취약점이 있는지 검토해줘. | 하나의 리뷰 절차에 security 기준 보완, 임의 수정·실제 공격 제외 | PASS | 같은 정책 §실행 방식과 인계·여섯 중복 조합, 시나리오 S6 |
| Q7 | 테스트에 실패하는 버그를 수정해줘. | systematic-debugging 원인 확인 후 TDD, 일반 탐색은 사실 수집 보조 | PASS | 같은 정책 버그·테스트 행, 시나리오 S7 |
| Q8 | 기존 코드베이스에서 구조 개선 후보를 찾아줘. | 읽기 전용 조사와 codebase-design. 명시 전용 improve 스킬 자동 호출 안 함 | PASS | `AGENTS.md:150~151`, 같은 정책 아키텍처·호출 제약, 시나리오 S8 |
| Q9 | 기존 설계가 확정되었으니 구현을 계속해줘. | 기존 계획 첫 미완료 Task, 실행 스킬 하나 선택, 전제 확인, 인터뷰·계획 재시작 안 함 | PASS | `AGENTS.md:152~153`, 같은 정책 §실행 방식과 인계, 시나리오 S9 |
추가 경계 대조: 이미 명확한 요청, glossary를 읽기만 하는 요청, 일반 아키텍처 문장의 명시 호출 오인, skill deny, 하위 에이전트·격리·스크립트 전제 미충족을 정책 문구와 대조했다. 모두 질문·권한·도구 전제를 우회하지 않도록 정의돼 있다. 이 역시 실제 모델 실행 테스트는 아니다.
기존 PASS 표의 개수 확인과 별도로, `check_route` 셸 함수에서 `rg -q`로 현재 상세 정책의 각 해당 행·전달 규칙을 검사했다. Q1~Q9 모두 PASS였다. 검사 대상은 신규 설계 책임자, 조건부 요구 인터뷰, 직접 도메인 책임, 기존 의존성 검토, REST 계약 보완, 단일 보안 리뷰, 디버깅→TDD, 일반 구조 조사와 명시 improve 분리, 기존 문서의 첫 미완료 Task 재개다. 이 검사는 정책 문구 회귀 검사이며 자연어 입력에 대한 실제 모델 라우팅 테스트가 아니다.
## 5. 발견 사항과 남은 검증
- 승인 차단 수준의 확정 정책 구현 결함은 없다. 독립 검토에서 문서 인용의 경미한 오류 R-01을 확인했고 아래에 기록한다.
- 원래 `research.md:208`, `:241` 및 과거 계획 로그의 Addy 누락 기록은 최초 조사 시점의 사실이다. 현재는 사용자가 복구했으며 이 보고서가 새 상태를 기록한다. 이전 검증 이력을 삭제하거나 현황이 여전히 누락이라고 재판정하지 않는다.
- OpenCode CLI 출력의 파이프 파싱 문제는 PTY·JSON 추출 방식으로 우회해 발견 검증을 완료했다. 설치나 정책 파일을 수정하지 않았다.
- 실제 자동 스킬 선택, Codex의 개별 스킬 선택 기록, 모든 스크립트 실행 호환성·승인 충족, 특정 upstream revision과의 설치본 완전 일치는 미검증이다. 원래 PRD의 비목표·조건부 정책과 일치하며 성공으로 합산하지 않는다.
- 전역 Codex planner의 `.omo/plans/`·병렬 규칙은 선택 시 프로젝트 절차와 충돌할 수 있다. 실제 상위 지침을 AGENTS로 덮어쓸 수 없다는 제약은 유지하며 전역 수정은 하지 않는다.
## 6. 독립 검토자 판정
**판정: APPROVE. 신뢰도: 높음. 범위: 문서 정책·설치 연결·발견 검증.** 검토자 1명이 현재 working tree의 문서와 관련 설치 원문을 읽고, 아홉 논리 경로와 호출 제약을 대조했다. OpenCode의 대상 27/27 발견 및 Codex Superpowers 설치·활성 조회도 독립 재현했다.
- ROUTE-001~008: 충족. ROUTE-009: 충족하되 R-01 Low 인용 오류 존재.
- 실제 무인 모델 선택·호출은 INCONCLUSIVE/미검증이며 원래 비목표에 해당한다. 정책·설치 검증의 승인을 자동 호출 보증으로 확대하지 않는다.
- Codex·OpenCode는 공통된 스킬 이름을 갖지만 본문이 완전히 같지는 않다. 예를 들어 OpenCode brainstorming의 builder-check 참조가 Codex 6.4.2 본문에 없다고 곧 누락으로 판단하지 않았다. 각 하네스의 실제 설치 원문을 읽는 정책이 필요하다.
- 최초 조사 순서와 과거 전역 파일 무변경은 당시 로그에 근거하며 현재 조회만으로 과거 전체를 독립 증명하지 않는다. 검토자는 Gradle을 재실행하지 않았고 최신 `BUILD SUCCESSFUL in 2s`는 Sisyphus가 직접 확인한 결과다.
### R-01: Addy 출처 lockfile의 인용 행 범위
- **심각도:** Low.
- **상태:** 확정, 수정 미실행.
- **관련 요구사항:** ROUTE-009 출처 추적 정확성.
- **대상:** `research.md:109`, `research.md:207`.
- **관찰:** 기록된 `~/.agents/.skill-lock.json`의 Addy 행 범위 `134-186`은 현재 파일과 다르다. 직접 재읽은 현재 여섯 항목은 `125-178`행이며, 기존 범위는 API 스킬의 항목을 놓치고 Matt grilling 항목을 포함한다.
- **영향:** Addy 여섯 스킬의 설치·출처·발견은 별도로 확인돼 라우팅 동작에는 영향이 없다. 문서의 행 기반 근거 추적 정확성에 한정된다.
- **권장 조치:** 후속 문서 정정 시 현재 행 범위로 갱신하거나, 변동하는 행 번호 대신 여섯 스킬의 lockfile 키 이름과 source 값을 기준으로 인용한다.
- **판정 기록:** 2026-10-19 Oracle 발견, Sisyphus가 lockfile `118-195`행을 직접 재읽어 확인.
- **plan 전환:** 현재 요청은 검증이므로 원문·정책을 자동 수정하지 않는다. 수정 작업이 승인되면 기존 완료 Task를 다시 열지 않고 R-01·대상 파일·수정 범위·인용 검증을 포함한 별도 회귀 문서 Task를 먼저 추가한다.
## 7. 종료 판정
| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 원래 요구사항 전체 문서 대조 | 충족 | ROUTE-001~009 매핑, 독립 검토 APPROVE |
| 아홉 논리 시나리오 | 충족 | Q1~Q9 재대조·별도 정책 문구 검사 PASS |
| 설치·호출 메타데이터·실제 발견 | 충족 | 양쪽 SP 소스·Matt/Addy/deep, OpenCode 27/27, Codex 설치·활성 |
| 발견 사항 판정 | 충족 | 승인 차단 결함 없음, R-01 Low 확정·수정 미실행 |
| 현재 복구 체크리스트 | 충족 | 네 개 본문·읽기·직접 및 패턴 문서 상대 참조 확인 |
| 실제 모델 자동 선택·호출 | 미검증 | 모델 기반 아홉 요청 실행을 하지 않음, 원래 비목표 |
| 정책·코드·전역 설정 보호 | 충족 | 검증 기록만 갱신, 보호 경로 diff 없음, 커밋·설치 없음 |
**최종 결론: 문서 정책·설치 연결·발견 검증은 통과했으며, 승인 차단 수준의 확정 구현 결함은 없다. Low 문서 인용 오류 1건은 발견 사항으로 남긴다. 실제 모델 자동 호출 전체 검증 완료라는 표현은 사용하지 않는다.**
## 8. 수정 후 검증 기록
### R-01 1차 수정 검증: 2026-10-19
- **상태:** 수정 완료.
- **사용자 승인·계획:** 사용자의 수정 요청 후 `plan-task.md`에 P1-R1을 먼저 추가했다. 이전 완료 Task나 위 최초 발견·판정 기록을 다시 열거나 삭제하지 않았다.
- **무엇을:** `research.md`의 Addy 표와 출처 설명 두 곳에서 `lines 134-186`을 제거하고, lockfile의 여섯 스킬 키와 `source: addyosmani/agent-skills` 값으로 인용했다.
- **왜:** 현재 행 번호로 바꾸는 데 그치지 않고 lockfile 행 이동의 영향을 받지 않는 출처 기준을 사용한다.
- **실제 source 검증 명령:**
```bash
jq -e --argjson names '["api-and-interface-design","ci-cd-and-automation","frontend-ui-engineering","observability-and-instrumentation","performance-optimization","security-and-hardening"]' '. as $lock | ($names | length == 6) and all($names[]; . as $name | $lock.skills[$name].source == "addyosmani/agent-skills")' /Users/klaus/.agents/.skill-lock.json
```
- **결과:** `true`, 종료 코드 0. `rg` 부정 검색으로 조사 문서의 잘못된 행 범위 잔존이 없고 두 인용이 모두 키·source 기준임을 확인했다. `git diff HEAD --check` 통과, 조사 문서 diff는 인용 두 줄만 변경했다.
- **기타 검증:** `./gradlew tasks --all`은 `BUILD SUCCESSFUL in 1s`, 종료 코드 0. Markdown 진단은 `.md` 서버 미설정으로 완료할 수 없으며 진단 통과로 간주하지 않았다.
- **범위:** 조사·계획·리뷰 문서만 수정했다. 스킬·AGENTS·전역 설정·앱 코드·Git index를 수정하는 명령은 실행하지 않았고 커밋하지 않았다.
- **최신 판정:** R-01은 수정·검증 완료다. 위 §6~7의 수정 미실행 표기는 최초 리뷰 당시의 기록이며, 현재 미해결 항목이라는 뜻은 아니다. 별도 새 독립 검토·실제 모델 자동 호출 검증은 이번 문서 정정에 포함하지 않았다.
@@ -0,0 +1,72 @@
# 스킬 라우팅 논리 시나리오 검증
## 검증 범위
- 입력은 사용자의 이번 요청 §7에 있는 아홉 문장을 그대로 사용한다.
- 실제 기능 개발·스킬 워크플로 실행·권한 변경은 하지 않는다.
- 검증 대상은 프로젝트 Markdown 정책의 분류·주 책임·전달·중복 방지·호출 제한이다.
- Codex/OpenCode 런타임 로딩·자동 호출은 미검증이다. 아래 문서 판정을 런타임 성공으로 해석하지 않는다.
## 변경 전 기준선: 2026-10-19
기존 `AGENTS.md`의 안전·PRD·테스트·이슈·도메인 안내는 존재한다. 다음 누락·충돌은 자동 라우팅 정책의 부족이며 기능 테스트 실패를 뜻하지 않는다.
| ID | 원문 시나리오 | 기존 정책의 누락·충돌 |
|---|---|---|
| S1 | 사용자 로그인 기능을 만들어줘. | 명시 요청만 브레인스토밍을 허용하여 신규 기능의 기본 자동 설계 선택과 충돌 |
| S2 | 요구사항이 아직 모호한 신규 서비스를 설계해줘. | 인터뷰 요구는 있지만 brainstorming·deep-interview의 단일 책임과 전달 조건 없음 |
| S3 | 결제 도메인의 용어와 상태를 정리해줘. | 도메인 문서 안내는 있지만 domain-modeling 주 책임·선택 조건 없음 |
| S4 | 이 모듈의 의존성 설계를 검토해줘. | codebase-design의 좁은 검토와 설계·심층 검토의 분리 없음 |
| S5 | 새로운 REST API를 설계해줘. | 설계 프로세스와 API 전문 계약 검토의 책임 경계 없음 |
| S6 | 인증 과정에 보안 취약점이 있는지 검토해줘. | 비밀값 보호는 있지만 리뷰 프로세스와 보안 기준의 중복 방지 없음 |
| S7 | 테스트에 실패하는 버그를 수정해줘. | 테스트 원칙은 있지만 원인 진단→회귀 테스트→최소 수정의 스킬 연결 없음 |
| S8 | 기존 코드베이스에서 구조 개선 후보를 찾아줘. | 진단 스킬의 실제 명시 호출 제한 확인·일반 자동 라우팅 분리 없음 |
| S9 | 기존 설계가 확정되었으니 구현을 계속해줘. | 기존 작업 문서 재사용 규칙은 있지만 재설계 없이 이어갈 실행 스킬 선택 없음 |
## 변경 후 판정
설치·호출 근거 확인과 정책 수정 이후 아홉 시나리오를 다시 대조한다. 아직 변경 후 성공 판정을 내리지 않았다.
### 판정 기준과 예상 경로
현재 작성된 [라우팅 정책](../agents/skill-routing.md)의 기본 라우팅·실행 방식·여섯 중복 조합·호출 제약을 대조한다. 아래는 시나리오별 기대 경로이며, 최종 문서 검증 후 판정을 추가한다.
`조건부 자동`은 현재 하네스의 스킬 목록·권한·실제 선택 기능이 허용하고 설명이 요청과 맞을 때만 모델이 선택할 수 있다는 뜻이다. 명시 전용 플래그가 없는 것, Codex 플러그인의 설치·활성 상태, OpenCode 세션에서 스킬이 광고되는 것은 자동 호출 성공의 증거가 아니다. `ask`는 별도 접근 승인, `deny`는 실행 금지이며 사용자 명시 스킬 선택과 다르다. 추가 상위 지침이 적용되면 이 표보다 실제 하네스 제약을 우선한다.
| ID | 작업 분류 | 메인 스킬 | 필요한 보완 | 실행 순서 | 제외한 중복 | 자동 선택·사용자 승인 조건 |
|---|---|---|---|---|---|---|
| S1 | 신규 인증 기능 | brainstorming | security-and-hardening, 실제 새 API 계약이 있으면 api-and-interface-design | 기존 인증 조사 → 남은 설계·수용 기준 확정 → PRD·계획 → 승인된 실행·TDD → 리뷰·완료 검증 | 기본 deep-interview·grilling·구조 개선 리포트 | 조건부 자동. 인증 방식·보안 민감 변경의 미결 결정과 실제 구현 승인은 확인한다. 새 기능 요청을 병렬 작업·외부 연동의 포괄 승인으로 보지 않는다. |
| S2 | 신규 설계·요구사항 탐색 | brainstorming | 중요한 목표·범위·제약·완료 기준 공백에만 deep-interview | 현황 조사 → 요구 탐색 하위 단계의 한 질문씩 → 결정 요약 → 남은 설계 선택·PRD → 승인 후 계획 | 두 인터뷰 루프 동시 실행, 이미 답한 질문 재진행, grilling | 조건부 자동. 중요한 불확실성이 해소되고 설계 기준이 승인되기 전 임의 구현하지 않는다. |
| S3 | 도메인 용어·상태 모델 정리 | domain-modeling | 모듈 seam까지 실제 다룰 때만 codebase-design | 용어집·관련 ADR·현재 코드 확인 → 용어·상태 관계 정리 → 확정 용어 기록, 조건에 맞는 ADR만 제안 | 불필요한 brainstorming·deep-interview·grilling·setup | 조건부 자동. 용어 충돌과 중요한 새 결정만 질문한다. 코드 변경이나 전체 개발 루프를 시작하지 않는다. |
| S4 | 기존 모듈 의존성 설계 리뷰 | requesting-code-review | codebase-design | 대상·범위 확인 → 의존성과 interface 조사 → 한 리뷰 절차로 근거·후보 보고 | 신규 설계 brainstorming, 자동 grilling·리팩터링·improve-codebase-architecture | 조건부 자동. 검토 요청은 실제 리팩터링 승인과 다르며 변경이 필요하면 제안 후 확인한다. |
| S5 | 공개 REST API 계약 설계 | brainstorming | api-and-interface-design, 실제 보안·도메인 필요에만 관련 전문 스킬 | 소비자·기존 계약 조사 → 입출력·오류·호환성 계약 설계 → PRD·설계 승인 → 필요하면 구현 계획 | 모듈 seam과 관계없는 codebase-design, 중복 요구 인터뷰 | 조건부 자동. 계약·호환성의 중요한 미결 결정은 확인하며 설계 요청만으로 endpoint 구현·배포하지 않는다. |
| S6 | 인증 보안 리뷰 | requesting-code-review | security-and-hardening | 인증 흐름·신뢰 경계 확인 → 읽을 수 있는 보안 본문·패턴으로 검토 → 근거·위험·검증 한계 보고 | 별도 일반 리뷰·보안 리뷰 루프 중복, brainstorming, 자동 수정·실제 공격 | 조건부 자동. 누락 체크리스트를 읽은 것으로 처리하지 않는다. 실제 인증 수정·공격 실험·민감 데이터 접근은 별도 범위·승인이 필요하다. |
| S7 | 테스트 실패 버그 수정 | systematic-debugging | 원인 확정 후 test-driven-development, 완료 시 verification-before-completion | 실패 재현 → 근거·가설 검증 → 회귀 테스트 RED → 최소 수정 GREEN → 영향 회귀·완료 검증 | 일반 탐색 스킬의 별도 진단 루프, 새 기능 brainstorming, 재설계 인터뷰 | 조건부 자동. 기존 레거시 파일 변경이 불가피하면 저장소 규칙대로 먼저 확인한다. 범위 밖 리팩터링은 하지 않는다. |
| S8 | 구조 개선 후보의 읽기 전용 탐색 | 읽기 전용 조사와 codebase-design | 용어를 실제 바꿀 때만 domain-modeling | 대상·최근 변경 조사 → 깊이·locality·seam 근거로 후보 보고 → 실제 개선 범위 확인 | improve-codebase-architecture의 자동 HTML 리포트·grilling, setup | 조사·codebase-design은 조건부 자동. improve-codebase-architecture는 자동 금지이며 사용자가 해당 스킬을 명시 선택해야 한다. 단순 권한 승인은 명시 선택을 대신하지 않는다. |
| S9 | 확정 설계의 구현 재개 | 실행 방식에 맞는 executing-plans 또는 subagent-driven-development 하나 | test-driven-development, 실제 작업의 전문 스킬, 완료 검증 | 기존 PRD·계획·진행 기록 확인 → 가용성·격리·ledger/script 전제 확인 → 첫 미완료 Task 재개 → 필요한 리뷰·완료 검증 | brainstorming·deep-interview·grilling 재시작, 변경 없는 계획 재작성, 두 실행 스킬 동시 선택 | 조건부 자동. 실행 방식 선택·격리·main/master·스크립트 전제를 충족해야 한다. 기존 승인 결정을 재승인하지 않으며 병렬·다중 에이전트는 명시 범위·방식 승인 필요. |
### 정책 범위의 예외 확인
- S3는 도메인 모델 변경 자체가 요청이므로 domain-modeling이 해당 전문 작업을 소유한다. 모든 작업을 brainstorming으로 시작하지 않는다.
- S4와 S6은 읽기 전용 리뷰가 요청이므로 하나의 리뷰 절차만 사용하고 구현을 시작하지 않는다.
- S8의 일반 문장은 명시 호출 전용 스킬의 이름을 선택한 요청이 아니다. 자동 호출 제한을 우회하지 않고 허용된 일반 조사를 제공한다.
- S9는 설계 승인만으로 실행 환경 전제와 호출 권한까지 충족했다고 가정하지 않는다. 단, 이미 확정된 설계의 질문을 다시 열지 않는다.
- 이 표를 작성하기 위해 실제 로그인·결제·보안·버그·리팩터링 스킬을 실행하지 않았다.
### 최종 논리 검증 결과: 2026-10-19
위 “아직 변경 후 성공 판정을 내리지 않았다”는 기대 경로 작성 당시의 기록이다. 최종 `AGENTS.md`와 상세 정책을 다시 읽어 아래와 같이 판정했다.
| ID | 논리 판정 | 확인한 최종 정책 근거 |
|---|---|---|
| S1 | PASS | 신규 설계의 brainstorming 주 책임, 인증·보안 전문 보완, 설계·실행 승인 구분 |
| S2 | PASS | 중요한 요구 공백만 deep-interview 하위 단계로 전달, 질문·결정 재사용, 동시 인터뷰 금지 |
| S3 | PASS | 도메인 모델 정리 자체는 domain-modeling이 담당, 읽기만 할 때 호출하지 않음 |
| S4 | PASS | 기존 의존성 검토는 requesting-code-review와 codebase-design, 신규 설계·리팩터링 자동 시작 금지 |
| S5 | PASS | 설계 프로세스와 API 공개 계약·호환성 기준의 분리 |
| S6 | PASS | 한 리뷰 절차에 보안 기준만 보완, 누락 체크리스트 검증을 완료로 주장하지 않음 |
| S7 | PASS | systematic-debugging 원인 확인 뒤 TDD, 일반 탐색은 보조, 완료 증거 필요 |
| S8 | PASS | 읽기 전용 후보 탐색은 허용하되 명시 전용 improve-codebase-architecture를 자동 호출하지 않음 |
| S9 | PASS | 기존 문서·첫 미완료 Task 재사용, 실행 스킬 하나만 선택, 격리·권한·도구 전제 확인 |
**결과: 정책 논리 대조 9/9 PASS.** 파일 검사로 원문·기대 경로 각각 아홉 행과 여섯 중복 조합의 존재도 확인했다. 행 수 검사는 표의 완전성 확인이며 선택 동작을 자동 실행한 테스트가 아니다. Codex/OpenCode에서 새 정책을 로드해 이 아홉 요청의 스킬을 실제 자동 호출하는 런타임 검증은 하지 않았다.