recursive-mode 소개

recursive-mode는 구조화된 AI-assisted software development를 위한 설치형 skill 패키지다. 요구사항, 계획, 구현, 테스트, 리뷰, 마무리, 메모리를 채팅이 아니라 파일 기반 워크플로로 남겨서, 세션이 끝나도 작업 맥락이 사라지지 않게 한다.

핵심 문제는 context rot다. 긴 에이전트 작업에서는 요구사항과 의사결정, 계획이 대화창에만 남아 세션 종료나 context window 초과와 함께 유실된다. recursive-mode는 이 문제를 해결하기 위해 저장소 안의 정적 문서를 단일 진실 공급원으로 삼고, 프롬프트는 짧은 명령으로 축소한다.

이 방식의 핵심은 재귀성이다. 각 개발 단계는 하나의 잠긴 산출물을 만들고, 다음 단계는 그 이전 단계의 산출물을 입력으로 사용한다. 또한 단계 종료 전에는 워크플로와 이전 문서를 기준으로 정해진 exit criteria를 충족해야 하며, 부족하면 draft → audit → repair → re-audit를 반복해 실제로 준비된 상태까지 끌어올린다.

저장되는 문서는 다음처럼 구성된다.

• .recursive/RECURSIVE.md: 전체 워크플로의 기준 스펙
• STATE.md: 현재 저장소 상태
• DECISIONS.md: 의사결정 기록
• run/…/: 개별 작업의 요구사항, as-is 분석, to-be 계획, 구현 요약, 테스트 요약, 수동 QA, addenda

Global STATE.md와 DECISIONS.md는 각 run의 시작과 끝에서 읽고 갱신한다. 이렇게 하면 채팅에 흩어진 맥락 대신, 사람이든 에이전트든 언제든 재현 가능한 traceability를 확보할 수 있다.

저자는 이 문서화를 단순한 기록 이상의 것으로 본다. 문서는 인간과 기계 모두가 읽을 수 있고, 장기적으로는 코드 diff와 함께 fine-tuning이나 self-distillation용 데이터셋으로도 쓸 수 있다. 결국 중요한 것은 대화가 아니라 저장소에 남는 증거다.

운영 방식도 명확하다. 채팅은 복잡한 대화를 이어가는 공간이 아니라 명령을 내리는 CLI처럼 쓰고, 세부 계획은 plan mode와 문서로 관리한다. 필요하면 작업용 run 폴더와 requirements 문서를 먼저 만들고, 에이전트에게 “run 01을 구현하라”처럼 짧게 지시한다.

이 패키지는 다음과 같은 하위 skill을 포함한다.

• recursive-mode: 단계별 오케스트레이션, 잠긴 아티팩트, durable memory
• recursive-worktree: 전용 git worktree로 구현 작업 분리
• recursive-debugging: Phase 1.5를 포함한 구조화된 디버깅
• recursive-tdd: RED/GREEN 증거를 기록하는 TDD
• recursive-review-bundle: 위임 리뷰를 재현 가능한 번들로 패키징
• recursive-subagent: subagent handoff 계약과 self-audit fallback 관리

설치는 전체 패키지 또는 단일 subskill 단위로 가능하다. 저자는 이를 Missions의 대안으로도 설명하며, 오픈소스이고 어떤 IDE, CLI, agent, 모델에서도 동작한다고 강조한다.