22 KiB
스킬 오케스트레이션 및 우선순위 자동화 구현 계획
| 항목 | 내용 |
|---|---|
| 상태 | 구현 완료 |
| 작성일 | 2026-10-19 |
| 요구사항 기준 | 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, 설정 관련 필드 읽기, 공식 문서와 설치 소스 대조. -
현재 위치·Git 루트와 작업 트리 확인, 전역·상위·프로젝트·하위 지침 우선 조사.
-
기존 우선순위·확장 모드·PRD·테스트·보안 규칙과 충돌 후보 식별.
-
설치 경로·심볼릭 링크·스킬 전문·호출 메타데이터 확인.
-
deep-interview·brainstorming·grilling 역할과 종료·전달 조건 확정.
-
공식 문서·로컬 근거·설치/호출/런타임 구분을
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조회. Superpowers6.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 비교.
-
기존 스킬 설정 블록과 지침을 보존하며 Superpowers 주 책임·좁은 전문 보완을 명시한다.
-
명시 브레인스토밍 제한과 우선순위 문구의 충돌만 최소 수정한다.
-
작업 분류·선택·재사용·명시 호출 정책, 여섯 중복 조합의 책임을 기록한다.
-
관련 작업 가이드의 절차·경로를 동기화한다.
검증 기록:
- 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 조회와 아홉 논리 시나리오, 한 검토자의 근거 대조.
-
전체 문서와 기존 ROUTE-001~009의 대응 관계를 다시 확인한다.
-
설치·명시 호출 정책·추가 참조와 실제 CLI 발견 상태를 확인한다.
-
아홉 시나리오 및 명시 호출·권한 거부·후속 작업의 경계 조건을 대조한다.
-
한 검토자의 판정과 남은 제약을 리뷰 보고서·검증 이력에 기록한다.
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 검사를 대체 검증으로 사용한다.
-
기존 두 인용과 실제 여섯 lockfile 키·source를 재확인한다.
-
두 인용을 행 번호가 아닌 키·source 기준으로 정정한다.
-
여섯 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. -
원문 아홉 시나리오 각각의 분류·메인·보완·순서·제외·호출·승인 조건을 대조한다.
-
호출 제한·지원되지 않는 기능을 우회하지 않는지, 기존 핵심 제약이 유지되는지 확인한다.
-
참조 경로·중복 헤더·공백·의도한 Markdown 변경 범위를 검사한다.
-
./gradlew tasks --all의 실제 결과와 진단 도구·런타임 검증 한계를 기록한다. -
전역 변경이 필요한 사항은 제안으로만 분리하고 최종 결과를 보고한다.
실행 순서
기존 지침 조사 → 설치·인터뷰 분석 및 공식 문서 조사 → 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.2installed: 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·전역 설정·앱 코드는 변경하지 않았다.