Files
T

67 lines
4.6 KiB
Markdown

# 스킬 오케스트레이션 및 우선순위 자동화 PRD
## 문서 정보
| 항목 | 내용 |
|---|---|
| 문서 상태 | 문서 정책 구현·논리 검증 완료 |
| 작성일 | 2026-10-19 |
| 대상 | Codex·OpenCode 공용 프로젝트 스킬 선택 지침 |
| 결정권자 | 저장소 사용자 |
| 관련 구현 계획 | [plan-task.md](plan-task.md) |
| 관련 조사 | [research.md](research.md) |
| 관련 검증 | [scenario-validation.md](scenario-validation.md) |
| API Contract | 해당 없음: 프로젝트 Markdown만 변경 |
## 1. Overview
Superpowers를 기본 개발 프로세스로 유지하고, 설치가 확인된 Matt Pocock·Addy Osmani·로컬 `deep-interview` 스킬을 필요한 단계에서만 보완적으로 선택한다. 사용자는 지침 조사, 설치·호출 정책 확인, 실제 `AGENTS.md` 수정과 아홉 시나리오의 논리 검증을 명시적으로 요청했다.
## 2. Goals
- 하네스의 지침 로딩 우선순위와 스킬의 작업 단계별 책임을 구분한다.
- 스킬 명시 호출 없이 선택할 수 있는 범위만 안내하고 권한·호출 금지를 준수한다.
- 같은 인터뷰·설계·계획·리뷰를 중복 실행하지 않으며 확정 결과를 후속 단계에서 재사용한다.
- 기존 최소 변경, PRD·계획, 레거시 보호, 로컬 테스트·기기 제한, 보안·Git 규칙을 보존한다.
## 3. Non-Goals
- 전역 설정, 플러그인, 설치된 스킬·에이전트 파일 변경.
- 스킬 설치, gstack 사용·설치, 소스 코드·빌드 설정 변경.
- 실제 기능 개발, 보안 공격 실험, 기기·UI 조작, 커밋·푸시.
- 런타임 자동 호출·동일한 하네스 동작의 보장.
## 4. 기능 요구사항
| ID | 상태 | 요구사항 | 수용 기준 | Task |
|---|---|---|---|---|
| ROUTE-001 | 확정 | 기존 지침을 가장 먼저 조사 | 위치·Git 루트·전역·상위·루트·하위·override·추가 지침의 경로와 범위 기록 | P1-T1 |
| ROUTE-002 | 확정 | 실제 스킬 설치·호출 정책 조사 | 논리/실제 경로, frontmatter, 부속 정책, 발견·호출 가능 여부 구분 | P1-T1 |
| ROUTE-003 | 확정 | deep-interview 전문 및 의존성 분석 | 질문·종료·출력·의존성과 brainstorming·grilling 역할 구분 | P1-T1 |
| ROUTE-004 | 확정 | Superpowers 중심 단계별 단일 책임 | 작업 분류, 프로세스 우선, 좁은 전문 보완, 완료 검증 명시 | P1-T2 |
| ROUTE-005 | 확정 | 중복 방지 | 요청한 여섯 스킬 조합의 공통·고유 책임, 조건·우선순위 기록 | P1-T2 |
| ROUTE-006 | 확정 | 호출 제한 존중 | 명시 전용·권한 거부·미지원 기능 우회 금지, setup·아키텍처 진단 조건 명시 | P1-T2 |
| ROUTE-007 | 확정 | 기존 AGENTS와 가이드 최소 수정 | 기존 지침 보존·충돌 문구만 조정, 공통 Markdown과 상세 참조 문서 사용 | P1-T2 |
| ROUTE-008 | 확정 | 아홉 시나리오 논리 검증 | 원문 요청별 분류·메인·보완·순서·제외·호출·승인 조건과 판정 기록 | P1-GATE |
| ROUTE-009 | 확정 | 출처·제약·변경 증거 보고 | 공식·로컬 출처, diff·정합성 결과, 미검증 런타임과 전역 변경 제안 기록 | P1-GATE |
## 5. 검증과 성공 기준
- 프로젝트 정책은 최신 설치 문서에서 확인된 기능·제약만 사용한다.
- `AGENTS.md`에서 주 프로세스, 선택 순서, 요구사항 탐색, 기본 라우팅, 호출 제한을 확인할 수 있다.
- 아홉 시나리오는 실제 스킬 실행 없이 논리적으로 대조하고 런타임 검증과 구별한다.
- 변경은 프로젝트 Markdown으로 한정하고 문서 경로·공백·기존 안전 규칙을 검사한다.
- 저장소 규칙에 따라 `./gradlew tasks --all`의 실제 결과를 기록한다. 앱 빌드·테스트 통과로 해석하지 않는다.
## 6. Open Questions
추가 제품 결정은 없다. 하네스별 설치·권한·호출 기능은 조사 근거로 판정하며 확인할 수 없는 항목은 미검증으로 남긴다.
## 7. Decision Log
| 날짜 | ID | 상태 | 결정 | 근거 |
|---|---|---|---|---|
| 2026-10-19 | DEC-001 | 확정 | 기존 설정 작업과 별개 목적이므로 새 작업 디렉터리 사용 | 사용자의 새 오케스트레이션 요구 |
| 2026-10-19 | DEC-002 | 확정 | 상세 요구를 재인터뷰하지 않고 조사 후 안전한 범위까지 구현 | 실제 수정·검증까지 완료하라는 명시 요청 |
| 2026-10-19 | DEC-003 | 확정 | 기존 확장 모드 제한 중 자동 설계 선택과 충돌하는 부분만 좁게 조정 | 기본 brainstorming 선택 요구, 기존 안전 제약 보존 |