68 lines
5.7 KiB
Markdown
68 lines
5.7 KiB
Markdown
# 스킬 오케스트레이션 요구사항
|
|
|
|
## 문서 정보
|
|
|
|
| 항목 | 내용 |
|
|
|---|---|
|
|
| 문서 상태 | 구현 완료 |
|
|
| 작성일 | 2026-10-19 |
|
|
| 최종 수정일 | 2026-10-19 |
|
|
| 대상 | 루트 `AGENTS.md`의 skill orchestration 정책 및 사전 문서 |
|
|
| 관련 구현 계획 | [`plan-task.md`](plan-task.md) |
|
|
| 조사/시나리오 | [`audit.md`](audit.md), [`routing-scenarios.md`](routing-scenarios.md) |
|
|
|
|
## 1. 문제와 목표
|
|
|
|
루트 `AGENTS.md`는 일부 skill을 소개하지만 작업 유형별 선택, 순서, 중복 해소, 명시적 요청 경계와 host별 발견 한계를 한곳에서 안내하지 않는다. 이는 문서 baseline의 routing 공백이며, 자동 호출 실패라는 런타임 판정은 아니다.
|
|
|
|
목표는 사용자의 작업 유형에 맞는 최소 skill 선택 및 순서를 루트 정책으로 정리하고, 그 정책을 뒷받침하는 근거와 아홉 개의 실제 사용자 요청 예시를 함께 제공하는 것이다. 전체 승인 범위는 루트 `AGENTS.md`의 제한된 skill orchestration 영역 변경과 이 폴더의 네 문서 완성이다.
|
|
|
|
## 2. 범위
|
|
|
|
### 포함
|
|
|
|
- `AGENTS.md`에 skill 선택, 선행 순서, 중복 해소, explicit-only 처리, 자동 호출 조건, 검증/완료 경계를 좁게 추가한다.
|
|
- 다음 네 문서를 완성한다: `docs/20261019_스킬오케스트레이션/prd.md`, `plan-task.md`, `audit.md`, `routing-scenarios.md`.
|
|
- 현재 루트/전역 지침, 설치 경로, skill metadata와 공식 host 문서를 구분해 근거/불확실성을 기록한다.
|
|
- 9개 지정 요청에 각기 분류, 주 skill, 보조 skill, 실행 순서, 제외 대상, 조건부 자동 선택, 승인 경계, 관찰/검증 상태를 기록한다.
|
|
- 프로젝트 CORE와 기존 PRD/plan, TDD, focused verification, 한국어 보고 규칙을 유지한다.
|
|
|
|
### 제외
|
|
|
|
- 런타임 앱 코드, 테스트, 스크립트 또는 새 skill/plugin 구현.
|
|
- 전역/프로젝트 host 설정, global `AGENTS.md`, `SKILL.md` 변경, 설치 또는 gstack 설치.
|
|
- 문서에서 제안한 routing의 모델 자동 invocation을 테스트/보장한다고 주장하는 일.
|
|
- 요청된 루트 skill orchestration 영역 밖의 `AGENTS.md` 정리, 다른 기존 파일 변경, 자동 commit/push.
|
|
- PRD/plan 절차, API 계약, 보안 gate, 공통 tooling을 새로 정의하거나 약화하는 일.
|
|
|
|
## 3. 정책 요구사항
|
|
|
|
| ID | 요구사항 | 수용 기준 |
|
|
|---|---|---|
|
|
| ORCH-001 | 작업 산출물에 맞게 최소 skill 조합을 선택한다. | 대표 작업 유형에서 주 책임과 조건부 specialist가 구분되며 무관한 skill을 체인에 넣지 않는다. |
|
|
| ORCH-002 | 흐름은 요청의 명료도와 구현 여부에 맞춘다. | 새 기능은 brainstorming을 사용하고, 모호할 때만 deep-interview를 선택한 뒤 설계로 돌아간다. 구현은 기존 PRD/plan, 한 실행 경로, 구현 시 TDD를 따른다. |
|
|
| ORCH-003 | explicit-only 제약과 사용자 의도를 보존한다. | `improve-codebase-architecture`, `setup-matt-pocock-skills`는 implicit invocation하지 않는다. `grilling`을 metadata상 암묵 호출 금지로 오인하지 않고, 의미상 stress-test 요청일 때 조건부 선택한다. |
|
|
| ORCH-004 | 겹치는 skill은 책임별로 나눈다. | `audit.md`에 6개 쌍의 역할 차이와 선택 기준이 있고, 9개 시나리오에서 중복 실행/소유권을 판정한다. |
|
|
| ORCH-005 | 발견 상태와 실제 invocation을 분리한다. | 조건부 사용은 host에서 발견 가능하고 권한이 허용되는 경우로 한정한다. runtime 자동 호출은 테스트됐다고 하지 않는다. |
|
|
| ORCH-006 | 기존 프로젝트 정책과 상위 권한을 보존한다. | 기존 CORE/프로젝트 절차가 skill 일반 지침보다 우선한다. 자동 승인, 설치, commit을 추가하지 않는다. |
|
|
| ORCH-007 | 누락된 필수 checklist를 숨기거나 약화하지 않는다. | 전역 checklist 결손은 해당 checklist 기반 sign-off 제한으로 보고하며 파일 생성/설치/기준 완화는 하지 않는다. |
|
|
|
|
## 4. 충돌과 의존
|
|
|
|
- 시스템/플랫폼/도구 권한 및 루트 CORE와 프로젝트 규칙을 보존한다. 명확한 사용자 승인은 이 경계를 우회하지 않는다.
|
|
- 기존 `docs/agent-guides/작업절차.md`, `문서유지보수.md`의 PRD/plan 경로, goal, TDD 예외, focused test 우선 및 실제 결과 누적 요구를 유지한다.
|
|
- 조사된 shared checklist가 없으면 대체 문서를 임의로 작성하거나 full sign-off를 주장하지 않는다.
|
|
- Codex/OpenCode의 발견/우선순위는 각 host 문서에 귀속해 설명하며 하나의 공통 탐색 규칙으로 합치지 않는다.
|
|
|
|
## 5. 완료 기준
|
|
|
|
- 신규 문서는 지정 폴더 아래 정확히 네 개이며, 이 구현은 기존 `AGENTS.md`의 해당 routing 영역만 수정한다.
|
|
- 9개 scenario가 사용자 지정 원문 요청을 그대로 포함하고 각각 8개 필드를 갖는다. 문서상 논리 대조 결과와 런타임 자동 호출 미검증을 구분한다.
|
|
- `plan-task.md`의 루트 편집, 9 scenario 대조, 문서 점검 및 Gate가 실제 증거와 함께 완료된다.
|
|
- source/evidence path와 runtime 미확인 사항, checklist 결손이 정확히 구분된다.
|
|
- `git diff --check`, 신규 파일별 실제 경로 `git diff --no-index /dev/null <path>` 비교, `wc -c AGENTS.md`의 32,768 byte 기본 budget 비교, `./gradlew tasks --all` 결과는 실제 실행 뒤에만 기록한다.
|
|
|
|
## 6. 근거 범위
|
|
|
|
루트 `AGENTS.md`, 프로젝트 가이드와 샘플, 설치/설정 경로, Codex/OpenCode 공식 문서, skill 파일과 metadata를 [`audit.md`](audit.md)에 구체적으로 기록한다. 사용자 요청 원문 및 문서상 라우팅 기대는 [`routing-scenarios.md`](routing-scenarios.md)에 둔다.
|