코딩 에이전트가 계획부터 테스트까지 개발 과정을 스스로 완주하게 하는 방법
코딩 에이전트를 켜자마자 코드를 쏟아내지 않고, 먼저 무엇을 만들지 묻고 설계안을 보여줍니다. 사용자가 승인하면 에이전트가 몇 시간 동안 혼자 일하면서도 계획에서 벗어나지 않도록 하는 규칙과 스킬 모음입니다. 소프트웨어 개발 전 과정을 체계적으로 수행하도록 돕는 프레임워크입니다.
코딩 전 설계와 계획 수립
에이전트는 사용자가 무언가를 만들려 할 때 바로 코딩에 들어가지 않습니다. 대신 대화를 통해 실제 의도를 파악하고, 설계안을 짧은 단위로 나누어 보여줍니다. 사용자가 설계에 동의하면, 초보 엔지니어라도 따라 할 수 있을 정도로 상세한 구현 계획을 세웁니다. 이 계획에는 테스트 우선 원칙과 불필요한 기능을 제거하는 규칙이 포함됩니다. 사용자가 '시작'이라고 하면, 에이전트는 하위 에이전트를 통해 각 작업을 수행하고 검토하는 과정을 자동으로 진행합니다.
개발 단계별 자동 실행 스킬
개발 단계마다 자동으로 활성화되는 스킬이 개발 흐름을 이끕니다.
- 브레인스토밍 코드를 쓰기 전에 아이디어를 다듬고 대안을 탐색합니다. 설계를 검증 가능한 단위로 나누어 제시합니다.
- 계획 작성 작업을 2~5분 단위의 작은 태스크로 분해합니다. 각 태스크에는 정확한 파일 경로와 검증 단계를 포함합니다.
- 테스트 주도 개발 실패하는 테스트를 먼저 작성하고, 통과하는 최소한의 코드만 작성합니다. 테스트 전에 쓴 코드는 삭제합니다.
- 코드 리뷰 태스크 사이에 계획 대비 검토를 수행합니다. 치명적인 문제가 있으면 진행을 막습니다.
지원 에이전트와 설치 방법
Claude Code, Cursor, Codex, Gemini CLI 등 여러 코딩 에이전트에서 사용할 수 있습니다. 각 에이전트에 맞는 설치 명령이 제공되며, 한 번 설치하면 세션 시작 시 자동으로 활성화됩니다. 여러 에이전트를 함께 쓴다면 각각에 따로 설치해야 합니다. 업데이트도 에이전트마다 다른 방식으로 진행됩니다.
사용 전 알아둘 점
이 저장소는 MIT 라이선스로 공개되어 있습니다. 에이전트가 자율적으로 작업하는 시간이 길어질 수 있으므로, 계획이 잘 잡혀 있는지 중간에 확인하는 습관이 필요합니다. 일부 기능은 텔레메트리를 통해 사용 버전만 수집하며, 이는 환경 변수로 비활성화할 수 있습니다. 새로운 스킬 기여는 일반적으로 받지 않으며, 기존 스킬 수정 시 모든 지원 에이전트에서 작동해야 합니다.
