Files
T

4.6 KiB

스킬 오케스트레이션 및 우선순위 자동화 PRD

문서 정보

항목 내용
문서 상태 문서 정책 구현·논리 검증 완료
작성일 2026-10-19
대상 Codex·OpenCode 공용 프로젝트 스킬 선택 지침
결정권자 저장소 사용자
관련 구현 계획 plan-task.md
관련 조사 research.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 선택 요구, 기존 안전 제약 보존