프로젝트 전달 엔진 | Project Delivery Engine
AI가 몇 달 동안 일해도 여전히 자신이 무엇을 하고 있는지 알게 합니다.
프로젝트가 오래 지속될수록 AI는 진행 상황을 잊어버리고, 파일을 엉망으로 만들거나, 완료되지 않은 작업을 완료된 것으로 말하기 쉽습니다. 프로젝트 전달 엔진은 프로젝트 상태를 지속적으로 관리합니다.
- 매우 가벼움: 진입점은 약 4KB이며, 규칙은 필요에 따라 읽습니다.
- 매우 강력함: 주요 결과물을 다른 AI에 맡겨 독립적으로 재검토하게 하여, 가짜 완료를 집중적으로 찾아냅니다.
- 매우 안정적임: 프로젝트 파일만 남아 있으면, 창을 바꾸거나 AI를 바꾸거나 몇 달 후에 다시 돌아와도 저장된 상태에서 계속 진행할 수 있습니다.
사용 방법: 이 Skill을 선택한 후 프로젝트 초기화, 프로젝트 재개, 인수인계 문서 정리, 독립 검토, 병렬 실행(spawn agent, 하위 에이전트 파견) 등을 입력하세요.
프로젝트 페이지: GitHub｜프로젝트 전달 엔진 (작성자 GitHub 홈페이지)
이 엔진이 사용자를 위해 관리하는 것
- 현재 진행 상황, 다음 단계, 위험 및 인수인계 진입점을 저장하여 창을 전환해도 다시 설명할 필요가 없습니다.
- 규칙, 현재 상태, 과거 증거 및 실제 자료를 분리하여 파일이 많아져도 혼란스럽지 않습니다.
- 하위 작업에 범위, 승인 기준 및 중단 조건을 설정하여 여러 AI가 병렬로 작업해도 각자 따로 작업하지 않습니다.
- 중요한 결과물이 독립적인 재검토를 받도록 하여, 작업을 수행하는 AI가 스스로 평가하지 못하게 합니다.
- 단계 종료 시 인수인계를 정리하여 새 창, 새 AI 또는 몇 달 후에도 계속할 수 있습니다.
처리 순서
SKILL.md는 프로젝트 전달 엔진의 라우팅과 하드 경계만 유지하며, 세부 규칙은 필요에 따라 참조 파일을 읽습니다.
- 사용자의 최신 명령과 현재 프로젝트 파일을 기반으로 작업 범위를 결정합니다. 작업이 현재 프로젝트 상태에 의존하거나 사용자가 명시적으로 현재 프로젝트 관리를 요청한 경우에만 이 Skill을 적용합니다. 일반적인 임시 요청 및 프로젝트 상태에 의존하지 않는 일회성 병렬 작업은 파일을 생성하지 않습니다.
- 작업이 프로젝트 상태에 의존하는 경우 references/project-state.md에 따라 프로젝트 루트, 5종 핵심 파일 및 필요한 인덱스를 확인합니다. 새 파일을 만들거나 수정할 때는 references/project-file-templates.md를 읽습니다.
- 간단한 메인 스레드 작업은 직접 실행합니다. 협업, 병렬 실행, worktree(격리 작업 트리) 또는 확인이 필요한 경우 references/collaboration.md에 따라 경로를 선택합니다. 실제 분업이 필요하면 references/taskcard-evidencebundle.md를 읽습니다.
- 작업 종료 시 references/project-state.md에 따라 문서화가 필요한지 판단합니다.
기계적 검사, 번호 부여, 시작 문구 및 거버넌스 파일의 제어된 쓰기는 references/project-gov-cli.md를 참조하십시오.
처음 사용 시, 사용자가 구체적인 사용법을 묻거나 project-gov 명령이 오류를 보고할 때 references/quickstart-faq.md를 읽습니다.
하드 경계
- 메인 스레드가 최종 채택을 담당합니다. 협업 스레드, 스크립트 및 증거 번들은 메인 스레드를 대신하여 완료를 선언하거나 결과를 병합할 수 없습니다.
- 프로젝트의
AGENTS.md파일에는 프로젝트 ID, 고유 사실, 권한 및 경계만 작성하며, 이 Skill의 일반 규칙을 복사하지 않습니다. - 거버넌스 범위에 대한 파일 생성, checkpoint(검사점) 또는 인수인계 기록 시에는 반드시
project-gov propose(시뮬레이션) → apply(실행)를 사용해야 합니다. 도구가 이를 표현할 수 없는 경우 중단하고 설명해야 하며, 우회해서는 안 됩니다. - 현재 작업에 필요한 참조 파일만 선택합니다. 선택 후에는 반드시 완전히 읽어야 합니다.