핵심 원칙
모드는 프로젝트 전체에 붙이는 이름이 아니라 다음 한 단계의 운영 자세입니다. 근거가 쌓이면 사고에서 조사, 구현, 리뷰, 통합으로 이동할 수 있습니다.
결정 흐름이 다음 모드를 알려주면 이 페이지에서 그 모드가 어떻게 움직여야 하는지, 에이전트가 무엇을 내야 하는지, 어떤 증거를 요구해야 하는지 확인합니다.
모드는 프로젝트 전체에 붙이는 이름이 아니라 다음 한 단계의 운영 자세입니다. 근거가 쌓이면 사고에서 조사, 구현, 리뷰, 통합으로 이동할 수 있습니다.
목표, 실제 질문, 완료 조건이 불명확할 때 사용합니다.
한 문장 완료 조건, 미해결 질문, 추천하는 다음 모드.
출력을 읽고 “맞다, 이게 실제로 해결할 일이다”라고 말할 수 있어야 합니다.
아직 해결하지 마세요. 작업을 정의하도록 도와주세요. 완료 조건, 빠진 결정, 가정, 다음 모드를 제시하세요.
구현 전에 불확실성을 줄여야 할 때 사용합니다.
발견 사항, 근거, 확신 수준, 남은 미지수, 추천하는 다음 단계.
중요한 주장마다 출처, 예시, 파일, 명령, 관찰 중 하나가 연결되어야 합니다.
조사만 하세요. 구현하지 마세요. 이 질문에 답하고, 확인한 근거와 남은 미지수를 보여준 뒤 다음 모드를 추천하세요.
분야가 낯설고 최종 정답을 아직 판단하기 어려울 때 사용합니다.
도메인 지도, 예시 모음, 임시 규칙, 위험 목록, 사람 확인 대기열.
규칙이 예시에 연결되고, 불확실한 결정은 추측하지 않고 표시되어야 합니다.
나는 이 분야의 최종 정답을 판단할 만큼 이해하지 못합니다. 업무를 매핑하고, 예시를 모으고, 임시 규칙만 추론하며, 가정과 사람 판단이 필요한 지점을 드러내세요.
목표가 정해졌고 산출물을 만들 수 있을 때 사용합니다.
산출물, 짧은 변경 설명, 수정 파일, 가정, 검증 절차.
변경을 직접 확인하고 같은 검사를 다시 실행할 수 있어야 합니다.
정해진 범위 안에서만 구현하세요. 지정된 파일만 수정하고, 가정을 표시하며, 변경과 내가 다시 실행할 정확한 검증 절차를 제공하세요.
산출물을 믿기 전에 결함을 찾아야 할 때 사용합니다.
결함, 누락, 위험, 정확한 위치, 입증된 문제와 추정 위험의 구분.
모든 발견이 줄, 섹션, 화면, 출력, 요구사항 중 하나에 근거해야 합니다.
이 산출물을 이 기준에 맞춰 리뷰하세요. 결함을 먼저 찾고 정확한 위치, 심각도, 근거를 주세요. 문제 설명에 필요할 때만 수정안을 제시하세요.
여러 출력을 하나의 일관된 결과로 합칠 때 사용합니다.
통합 산출물, 발견한 충돌, 해결 방식, 하나의 전체 검증.
부분별 검사뿐 아니라 통합된 전체 결과가 하나의 검사를 통과해야 합니다.
이 부분들을 통합하세요. 충돌과 해결 방식을 설명하고, 미해결 결정을 표시하며, 하나의 전체 검증 절차를 제공하세요.
위임한 결과를 받아들이기 전에 사용합니다.
직접 확인할 수 있는 명령, 관찰, 화면, 인용, 비교 또는 다른 증거.
중요한 주장을 독립적으로 확인할 수 있어야 합니다.
확신을 요약하지 마세요. 검증 근거, 정확한 명령 또는 출처, 아직 틀릴 수 있는 부분을 보여주세요.
Proof gate가 실패했거나 피드백이 결함을 드러냈을 때 사용합니다.
표적 수정, 수정 이유, 재검사 근거, 새로 생긴 위험.
원래 실패가 사라지고 명백한 새 실패가 생기지 않아야 합니다.
실패한 이 기준만 고치세요. 무엇을 바꿨는지 설명하고 관련 검사를 다시 실행하세요. 제품이나 도메인 결정이 필요하면 멈추세요.
작은 산출물 하나 또는 일관된 작업 하나에 사용합니다.
작업이 작고, 도메인과 산출물이 하나이며, 독립 작업선이 필요하지 않을 때.
프롬프트 하나, 담당 하나, proof gate 하나, 최종 리뷰 하나.
새 미지수가 생기면 억지로 끝내지 말고 조사 또는 순차 모드로 바꿉니다.
뒤 단계가 앞 단계 결과에 의존할 때 사용합니다.
다음 결정이 조사, 시제품, 리뷰, 사용자나 도메인 선택에 달려 있을 때.
1단계 proof gate → 결정 → 2단계 proof gate → 통합.
검증되지 않은 1단계 가정에서 2단계를 시작하지 않습니다.
출력이 충돌하지 않는 독립 질문에 사용합니다.
질문들을 독립적으로 조사할 수 있고 사용자가 결과를 직접 수렴할 때.
분리된 질문, 분리된 근거, 하나의 수렴 요약.
결과가 모순되면 평균내지 말고 결정 사항으로 올립니다.
충돌 위험이 낮다고 증명될 때만 드물게 사용합니다.
파일이 겹치지 않고, 실행 상태가 격리되며, 각 부분을 독립 검증할 수 있고, 통합 계획이 있을 때.
에이전트마다 별도 브랜치나 worktree, 파일 겹침 없음, 한 번에 하나씩 병합.
정확한 파일 경계나 공유 실행 상태를 말할 수 없다면 순차 모드로 바꿉니다.
업무 흐름이 반복할 만큼 안정된 뒤에만 사용합니다.
입력, 출력, 로그, 실패 동작이 명확한 반복 가능 업무 흐름.
수동 실행을 충분히 반복해 규칙이 매번 바뀌지 않아야 합니다.
작업에서 반복 결정이나 재사용 규칙이 드러났을 때 사용합니다.
체크리스트 후보, AGENTS.md 규칙, 스킬 메모 또는 자동화 아이디어.
이 작업 하나를 넘어 유용하고 적용 한계를 포함해야 합니다.
사고 모드. 아직 구현하지 않습니다.
조사 모드. 추측이 아니라 근거를 요구합니다.
미지 도메인 모드. 지원 레이어부터 자동화합니다.
믿기 전에 리뷰 모드를 사용합니다.
통합 모드에서 전체 결과 검사를 요구합니다.
더 좁은 목표로 수정 모드를 사용합니다.
구조, 리뷰어, 도구를 바꾸거나 직접 처리합니다.
캡처 모드 후 필요하면 자동화 모드로 옮깁니다.