Evolve

Evolve은(는) 무엇을 하나요?

현재 저장소를 고정된 의미 체계와 선택적 제한 수정을 통해 거버넌스된 단계로 발전시킵니다. 목표가 없으면 기본 동작은 내성적입니다: 저장소를 분석하고 하나의 제한된 개선을 추천하며, 계획 수준의 아티팩트 집합에서 중단됩니다.

이는 자율적인 코드 생성이 아닙니다. 인지 주변의 형태를 규율합니다 — 모든 단계는 타입이 지정된 아티팩트를 생성하고, 모든 변이는 승인이 필요하며, 모든 단계는 영수증을 방출합니다. 단일 evolve 실행은 제한된 아티팩트에서 끝나며, 열린 개선 루프가 아닙니다.

표준 의미 체계

복잡한 runx 스킬은 하나의 내부 단계 언어를 공유합니다:

• scope
• ingest
• model
• materialize
• evaluate
• revise
• verify
• ratify

현재 evolve 러너는 제한된 하위 집합을 사용하며 일부 단계를 더 적은 구체적 단계로 압축합니다. 이는 허용됩니다. 고정된 것은 단계의 수가 아니라 단계의 의미입니다.

현재 러너 매핑

Introspect (내성)

호출자 중개 (에이전트 단계). 이는 인수 없는 추천 경로입니다. scope + ingest + model을 사용하여 현재 저장소를 분석하고 다음을 생성합니다:

• opportunity_report — 저장소 증거에 기반한 순위가 매겨진 기회
• recommended_objective — 하나의 제한된 다음 단계
• change_plan — 해당 추천에 대한 구체적인 계획
• spec_document — 거버넌스가 적용될 때 초안 scafld 스타일 명세

이 러너에서는 승인 게이트나 변이가 발생하지 않습니다. 내성만 수행합니다.

Preflight (사전 점검)

결정론적. 이는 현재 scope + ingest 단계입니다. 대상 저장소를 검사하고 repo_profile을 생성합니다: 저장소 루트, git 상태, 기본 브랜치, 더티 작업 트리, .ai/ 존재 여부 (scafld 초기화), 감지된 언어, 테스트 명령, 위험 신호. 에이전트 인지 없음, 변이 없음.

Plan (계획)

호출자 중개 (에이전트 단계). 이는 현재 model 단계이며 제한된 계획 아티팩트도 초안합니다. 목표와 저장소 프로필이 주어지면 한 번에 네 개의 아티팩트를 생성합니다:

• objective_brief — 대상 종류, 제약 조건, 성공 기준에 대한 재진술.
• diagnosis_report — 목표에 대한 현재 저장소 상태.
• change_plan — 정렬된 단계, 수용 검사, 접점, 위험.
• spec_document — 거버넌스가 적용될 때 초안 scafld 명세.

종료 보호 장치

evolve는 현재 계획/명세 아티팩트에서 중단됩니다. 호출자가 terminate=patch 또는 terminate=pr을 요청하면 러너는 변이하거나 게시할 수 있다고 가정하는 대신 명확한 오류와 함께 즉시 실패합니다.

수정 정책

evolve는 현재 수정 라운드를 수행하지 않습니다. 이는 의도적입니다. 제한된 수정이 도입되면 반드시 명시적이고 정책에 의해 제어되어야 합니다(예: max_rounds: 1 또는 2, 정의된 중단 및 에스컬레이션 조건 포함).

호출 모드

• runx evolve — 현재 저장소를 내성하고 하나의 제한된 개선을 추천
• runx evolve "<목표>" — 지시된 변경 계획
• runx evolve "<목표>" --terminate patch|pr — 실제 실행 경로가 존재할 때까지 현재 거부됨

발전 대상

목표 문자열이 대상을 결정합니다. 사전 점검 단계는 현재 저장소 컨텍스트에서 구체적인 대상을 확인합니다.

• 저장소: "웹소켓 어댑터 지원 추가" — 코드베이스를 목표 방향으로 개선.
• 스킬: --skill ./skills/sourcey — 특정 스킬 패키지 개선.
• 영수증: --receipt rx_8f3a — 실패한 실행을 기반으로 복구.
• 자체: runx 저장소 자체에 대해 증명 환경에서 실행.

종료

• spec (기본값): 계획 후 중단. 변이 없음.
• patch: 이 배송된 러너에서 아직 지원되지 않음.
• pr: 이 배송된 러너에서 아직 지원되지 않음.

경계 규칙

• 단일 evolve 실행은 제한된 아티팩트에서 끝나며, 또 다른 은닉 루프가 아닙니다.
• 정책은 구조화된 필드를 평가하며, 산문은 절대 평가하지 않습니다.
• 나중에 실행이 추가되면 합성된 내부 단계 대신 실제 도구, scafld 또는 기타 거버넌스된 경로를 통해 라우팅되어야 합니다.

입력

• objective (선택 사항): 무엇을 향해 발전할지. 생략하면 evolve는 내성 추천 러너를 사용합니다.
• repo_root (선택 사항): 저장소 루트. 기본값은 cwd입니다.
• terminate (선택 사항): 기본값은 spec. 다른 값은 현재 배송된 러너에서 거부됩니다.