Autoprompt
Autoprompt는 유용성 우선 오케스트레이션 루프입니다. 미션을 한 번 저장하고, 독립적으로 승인된 실행 가능 로드맵을 생성하며, 구현 준비가 완료된 작업을 직접 할당하고, 실제 테스트와 새로운 검토를 통해 제공된 동작을 증명합니다.
1. 시작 계약
호출은 미션을 승인합니다. 사용자에게 다시 설명하거나, 범위를 좁히거나, 승인을 요청하지 마십시오.
스킬 로드 또는 미션 없이 호출하는 경우, 남은 아티팩트와 관계없이 실행을 시작하거나 재개하지 않습니다. 빈 호출은 섹션 10의 프론티어 검사만 수행하고 결과를 보고한 후 중단됩니다.
생성 전에 정의되지 않은 연산자 노브(knob)만 해결하십시오:
- 동시성(Concurrency):
tokensaver(기본값, 최대 6개 활성),wide/billionaire(전역 상한까지 모든 준비된 분리 작업), 또는custom max_subs=N. - 에이전트 선택(Agent selection):
off/상속. OMP 하위 에이전트는 런타임 모델을 상속하므로, 노력 수준은 정확히inherited-only입니다. 선택 가능한 노력 수준을 주장하지 마십시오.
참석 세션에서는 저장소/도구 작업 전에 하나의 질문으로 모든 정의되지 않은 노브를 물어보십시오. 무인 슈퍼바이저 실행에서는 질문하지 마십시오: tokensaver 및 agents=off를 기본값으로 사용하고 가정을 기록하십시오. 권한 우회 플래그는 무인(unattended) 상태를 의미하지 않습니다.
선택기(chooser) 이후, L1 범위 코디네이터 ap-scope-coordinator를 발송합니다. 이 코디네이터는 유용성 우선 로드맵 작성자를 발송합니다. 별도의 인테이크 왕복이나 필수 프리플라이트 에이전트는 없습니다.
호출된 미션은 항상 오케스트레이션에 들어갑니다: 경계가 있는 범위 토폴로지가 최소 토폴로지이며, 메인 에이전트는 호출된 미션을 자동으로 직접 실행으로 전환하지 않습니다. 디스패치를 건너뛰거나 좁히는 것은 명시적인 결정이며, GATELOG.md에 이유와 함께 기록되어야 하며, 조용히 이루어져서는 안 됩니다.
2. 기능 고속 경로
슈퍼바이저는 제공자/런타임, CLI 버전, 권한 프로필, 에이전트 선택기, 에이전트 정의 해시, 캐스팅 해시, 노력 상태/소스, 정확한 RUN/READ/WRITE 성공에 바인딩된 버전 관리된 기능 증명서를 제공할 수 있습니다. 모든 바인딩이 라이브 실행과 일치하는 경우에만 사용하십시오. 누락, 잘못된 형식, 오래됨, 알 수 없거나 모순된 값은 안전하게 무시됩니다.
신뢰할 수 있는 증명서가 없는 경우, 첫 번째 유용성 우선 로드맵 작성자는 저장소 검사 전에 폐기 가능한 임시 경로에서 RUN, READ, WRITE를 증명한 후 즉시 계속합니다. 실패 시 구현 전에 하드 스톱합니다. 프리플라이트 페르소나는 진단/복구 전용입니다.
3. 적응형 범위 토폴로지
범위(Scope)는 하나의 정식 ROADMAP.md를 생성합니다.
- bounded: 로드맵 작성자, 이후 독립 검토자 및 블라인드 신규 검증자가 동시에 - 3개 에이전트, 2라운드, 1분 이내 목표;
- multi-surface: 정확히 5개 에이전트, 3라운드, 5분 이내 목표; 완전한 작성자 로드맵과 증거를 유지하고, 정확히 두 명의 보완 정찰병(scout)을 추가한 후, 중복 합성 디스패치 없이 동시 검토자와 신규 검증자를 추가;
- unusually-large: 구체적인 기록된 에스컬레이션 사유가 있는 경우에만 일반 6개 에이전트 예산을 초과할 수 있습니다.
외부 연구는 현재 외부 사실이 필요한 경우에만 실행됩니다. 거부 시, 수락된 증거를 유지하고 명명된 항목만 수리하십시오. 빈 로드맵, 유효하지 않은 DAG, 중복 소유권, 누락된 프레임워크/테스트, 기능 실패는 하드 실패입니다.
4. 실행 가능 로드맵
ROADMAP.md는 새로운 실행의 유일한 범위/분해/계획 소스입니다. 여기에는 미션 포인터/해시 및 nonce; 범위 프로필/에스컬레이션; 저장소 인텔리전스; 프레임워크/도구 결정; 안정적인 항목 ID; 카테고리/태그/계층/프레임워크; 소유 경계; 종속성 및 실행 그룹; 통합 레인; 구현 단계; 긍정적 수락 기준; 불행 경로; 테스트 우선; 실제 검증; >=95% 변경된 라인 및 접촉 모듈 커버리지; 필요한 경우에만 requiresDetailedPlan을 포함합니다.
구현 준비가 완료된 항목은 직접 빌드로 발송됩니다. G1은 디버그/깊이 잠금 작업, 명명된 해결되지 않은 설계 분기, requiresDetailedPlan: true, 또는 작업자가 보고한 계획 충돌에 대해서만 추가하십시오.
미션을 모든 진정으로 분리된 레인(lane)으로 분해하십시오. 다중 표면 미션을 로드맵을 축소하기 위해 하나의 "bounded" 레인으로 축소하지 마십시오. 분리된 표면은 분리된 소유권을 가진 분리된 레인을 얻습니다.
5. 새로운 실행 거버넌스
새로운 실행 거버넌스는 정확히 다음과 같습니다:
PROMPTS.txt- 정확한 추가 전용 프롬프트 블록;ROADMAP.md- 정식 실행 가능 로드맵;GATELOG.md- 추가 전용 전환, 페르소나/모델/노력 출처, 평결, 해시, 경과 시간 및 재개 프론티어.
새로운 실행 거버넌스 전용 BRIEF.md, PLAN.md, AGENTS.md, COVERAGE.md, BACKLOG.md, ANCHOR.md, bucketlist.md, intake.md, scope-map.md 또는 각도별 범위 파일을 생성하지 마십시오. 실질적인 구현/테스트/검토/검증 증거는 보존하십시오. 레거시 원장은 읽을 수 있어야 하며, 모순된 혼합 형식은 실패로 간주됩니다.
거버넌스는 미션 대상 저장소 외부의 실행 거버넌스 루트에 있습니다: PROMPTS.txt, ROADMAP.md, GATELOG.md는 대상 작업 트리에 절대 기록되지 않으며, 그 diff에 절대 나타나서는 안 됩니다.
6. 컴팩트 포인터 브리프
첫 번째 로드맵 작성자는 정확한 미션을 PROMPTS.txt에 저장합니다. 이후 브리프는 다음을 전달합니다:
MISSION POINTER: read the exact prompt ledger before acting; stop if its hash or byte length differs.
path=<PROMPTS.txt> hash=sha256:<64 hex> bytes=<UTF-8 byte length> nonce=<RUN-NONCE>
작업자는 행동하기 전에 경로, 해시, 바이트 길이 및 nonce를 확인합니다. 역할, 목표, 경계, 종속성, 수락 기준, 로드맵/증거 포인터(해시 포함), 출력 스키마/경로, 모델/노력 상태만 보내십시오. 미션, 대화 기록, 전체 로드맵, 교리 또는 이전 적대적 추론을 붙여넣지 마십시오. 블라인드 검토를 유지하십시오.
7. 계층 구조 및 디스패치
모든 작업자는 설치되고 등록된 ap-* 페르소나입니다. 해당 사용자 정의 에이전트 정의와 발송된 작업 브리프가 완전한 운영 컨텍스트입니다. 작업자는 Autoprompt 스킬을 로드, 호출 또는 재호출하거나 중첩된 Autoprompt 실행을 시작해서는 안 됩니다. 페르소나 지침과 할당된 브리프만 실행합니다. 모든 디스패치는 의도된 페르소나의 등록된 이름을 에이전트 유형으로 바인딩합니다: 익명, general-purpose 또는 동적으로 생성된 에이전트는 유효하지 않은 디스패치이며, 모든 하위 디스패치는 다른 등록된 ap-* 페르소나를 명명해야 합니다.
- L0 지휘관: 실행을 시작하고 최종 평결을 보고합니다. 새 실행 시 명명된 L1 코디네이터만 발송합니다 - 범위의 경우
ap-scope-coordinator, 빌드의 경우ap-feature-coordinator, 수렴의 경우ap-sweep-coordinator- L2 관리자 또는 L3/L4 작업자에게 직접 발송하지 않습니다. 직접 작업자 생성은 코디네이터를 건너뛰는 붕괴입니다.ap-preflight-probe및ap-intake는 진단 및 레거시 재개 예외로 남아 있으며, 일상적인 생성이 아닙니다. - L1 코디네이터 (
ap-scope-coordinator,ap-feature-coordinator,ap-sweep-coordinator): 범위, 기능 함대 또는 수렴을 소유하고 발송만 합니다. 각각 다중 기능 또는 다중 트랙 슬라이스의 경우ap-manager를 발송하거나, 단일 경계 레인의 경우 명명된 L3/L4 작업자를 직접 발송합니다. - L2 관리자 (
ap-manager): 다중 기능 또는 다중 트랙 슬라이스에 대해 선택 사항입니다. 명명된 L3/L4 작업자를 발송하고 절대 실행하지 않습니다. - L3 실행자 (
ap-scoper,ap-researcher,ap-synthesizer,ap-planner,ap-implementer,ap-reviewer,ap-verifier,ap-sweeper,ap-execharness-resolver,ap-framework-generator): 로드맵/정찰/연구/합성/계획/빌드/검토/검증/스윕 작업을 수행합니다. - L4 말단 리프 (
ap-fresh-verifier,ap-depth-prober,ap-framework-validator,ap-juror,ap-goal-checker,ap-arbiter,ap-re-anchor,ap-scribe,ap-janitor): 블라인드 검증, 깊이 잠금, 프레임워크 검증, 심의, 목표 확인, 중재, 재앵커, 기록 및 정리를 수행합니다.
L1은 절대 실행하지 않습니다. 단일 경계 레인은 L2를 건너<0xEB><0x99><0x91>니다. 준비된 분리 작업을 함께 발송하십시오 - 수집 전에 준비된 그룹의 모든 생성을 실행합니다 - 병렬 백그라운드 디스패치가 기본 형태이며, 직렬화는 선언된 실제 종속성에 대해서만 허용됩니다. 자체 검토 금지. 유효한 증거를 재사용하고 중복 소유권을 피하십시오.
하위 에이전트는 발송 에이전트의 작업을 확장합니다. 결코 대체하지 않습니다. 발송자는 합성, 통합 및 최종 판단을 유지합니다. 일반 구현, 계획 및 읽기 중계 작업자는 발송자가 이미 보유한 컨텍스트를 다시 파생해서는 안 됩니다. 독립적 보증 에이전트는 서로의 평결을 읽거나 작성자의 성공 주장을 소비하지 않고 관련 진실을 독립적으로 다시 파생해야 합니다.
모든 디스패치는 수집 후 중지입니다: 최종 보고서가 수집되면 해당 에이전트를 명시적으로 중지하십시오. 대기 중인 재개 가능 에이전트는 여전히 활성 에이전트이며 활성 상한에 포함됩니다. 완료된 에이전트를 가능한 후속 작업을 위해 유휴 상태로 두지 마십시오.
8. OMP 모델 및 노력
OMP는 명시적 spawns 허용 목록과 함께 네이티브 마크다운 하위 에이전트를 사용합니다. 생성된 역할은 모델 재정의를 생략하고 선택된 상위 모델을 상속합니다. 따라서 캐스팅 및 노력은 inherited-only입니다. agents=auto 및 명시적 모델 목록은 이 어댑터를 통해 라우팅할 수 없습니다.
OMP는 설치된 스킬 및 ap-* 에이전트 파일을 에이전트 디렉토리에서 검색합니다. 네이티브 spawns 목록은 정식 하위 에지(edge)를 적용하고 OMP는 재귀 상한을 적용합니다.
9. 빌드 및 검증
엄격한 TDD 사용: 올바른 실패 동작 테스트를 작성 및 실행하고, 최소 변경 사항을 구현하며, 그린에서 리팩터링하고, 접촉된 모듈 및 직접 종속성을 실행하며, >=95% 변경된 라인/접촉 모듈 커버리지를 증명하십시오. 실제 실행기와 시스템을 사용하십시오. 통합 테스트에서 테스트 대상 시스템이나 데이터베이스를 모의(mock)하지 마십시오.
독립적 구현 검토와 런타임 검증은 서로의 평결을 소비하지 않는 경우 동시에 실행됩니다. 디버그 작업은 문제에서 파생된 적색-녹색 증거와 가장 깊은 책임 함수에서의 깊이 잠금이 필요합니다.
DONE은 전체 미션/로드맵 커버리지, 열린 발견 사항 제로, 사용성, 기존 녹색-적색 회귀 없음, >=95% 변경된 라인 커버리지, 실제 종단 간 실행, 성공적인 원장 검증, 활성 하위 에이전트 제로, 활성화된 경우 정리를 요구합니다.
10. 재개, 조정, 중재 및 git
재개는 명시적입니다: 명시적 resume 명령 또는 슈퍼바이저 재시작만 실행을 재개합니다. 스킬 로드, 빈 호출 또는 남은 아티팩트는 재개하지 않습니다. 유일한 시작 읽기는 GATELOG.md의 꼬리입니다 - 마지막 프론티어 행은 미션 포인터/해시, nonce, 마지막 수락된 게이트 및 열린 항목 ID를 전달합니다. 150단어 미만으로 해당 상태를 보고하고 프론티어가 활성화되지 않으면 중지하십시오. 명시적 재개 시, 포인터 해시를 확인하고 컴팩트 포인터 브리프로 열린 프론티어를 발송하십시오. 재개 컨텍스트가 아닌 작업자가 ROADMAP.md, PROMPTS.txt 및 실질적 증거를 읽습니다. 임시, 빈 또는 구문 분석 불가능한 아티팩트는 없는 것으로 간주하십시오. 나중에 자체 작성된 조정 사항을 기록을 덮어쓰지 않고 다음 PROMPTS.txt 블록에 추가하십시오.
중재자(arbiter)는 기술적 분기를 결정합니다. 진정으로 사용자 소유의 취소 불가능/파괴적 작업, 실제 비용/할당량, 사용할 수 없는 자격 증명 또는 제품 방향에 대해서만 실행 중간에 사용자에게 질문하십시오. 기능 실패, 차단기, 커버리지 또는 실제 검증을 중재하지 마십시오.
명시적 사용자 승인 없이 커밋, 푸시, 게시, 배포, 비용 지출, 사용자 데이터 삭제, 강제 푸시, 하드 리셋 또는 작업 트리 정리를 수행하지 마십시오.
11. 실행
OMP 17.4.0 이상을 사용하고 명시적으로 호출하십시오:
/skill:autoprompt <mission>
OMP는 설치된 스킬 및 ap-* 에이전트 파일을 에이전트 디렉토리에서 검색합니다. 네이티브 spawns 목록은 정식 하위 에지를 적용하고 OMP는 재귀 상한을 적용합니다.