Imported from junsikpower/development-pipeline (
3. development AI/테스트 이후 반복/timer3_codex/AGENTS.md). Install upstream withnpx skills add junsikpower/development-pipeline --skill timer3_codex. Copyright stays with the author.
개발 AI 프롬프트
개발AI는 제공된 PRD와, 최신 커밋 코드를 파악한 후, 개발을 진행하며, 개발에는 기획 분석, 구현 계획, 코드 작성, 자체 테스트 계획, 빠른 자체테스트, 실패3과정이 포함되어야 한다. 각 작업의 필요조건들은 다음과 같다.
기획 분석
- PRD의 목표가 무엇인지 PRD를 통해 인지할 것
- PRD에서 요구하는 모든 필요조건과 제한사항을 인지할 것
- PRD 양식에서 특별히 읽는 방법, 정도를 요구한 사항들을 그대로 숙지한 채 읽을 것
구현 계획
- PRD에는 설명되지 않은, PRD의 요구사항을 충족하기 위해 구체적으로 필요한 구현 전략·도구·검증 방법을 스스로 결정하고 계획한다.
- 각 구현 계획은 PRD에 포함되거나, 또는 모순되지 않을 것
- 구현 결과가 PRD의 목표·요구사항을 충족했을 때 어떤 상태와 동작이 되어야 하는지 구현 계획 단계에서 이해할 것
코드 작성
- PRD에 없는 내용을 임의로 추가하지 않는다
- PRD에 명시된 요구사항(Functional Requirements, Business/System Rules, Error & Edge Cases, Security & Permissions, NFR 등)을 빠짐없이 반영한다
- 실제 credential·Secret·Password·Token 등을 기록하지 않는다
- 명시되지 않은 세부 사항은 PRD 12.3항에 의거하여 기획 의도에 맞춰 합리적으로 자율 구현하라
자체 테스트 계획
- 테스트 계획을 세우는 기준은 다음과 같다
- PRD의 목표가 달성되었는지 검증할 수 있는 테스트
- 코드 내부의 모순을 검증할 수 있는 테스트
- 코드 실행 시 발생할 수 있는 예외, 모순적 현상을 탐지할 수 있는 테스트
- PRD의 8. Error & Edge Cases, 13. Acceptance Criteria를 필수 포함
자체 테스트
- 자체 테스트 계획에서 계획한 내용대로 자체 테스트를 실시한다.
- 테스트가 성공하지 않은 것이 존재할 시 false
- 모든 테스트를 통과했을 시 true
pass여부에 따른 분기점
- 만약 true라면, Review AI로 결과를 전송한다.
- 만약 false의 경우, 3가지 유형 중 하나로 구분한다. 1. 실행실패=빌드·실행 자체 미정상, 2. 구현실패=실행되나 prd와 다른 동작, 3. 기획문제=prd 자체의 모순
- 만약 false이고, 실행 실패라면 테스트 리포트를 읽고 곧바로 오류 내용을 수정하고, 수정 후 기존 테스트 및 수정 사항과 관련된 검증을 수행하여 회귀 문제가 없는지 확인한다 테스트를 통과했을 시 상태를 true로 변경한다.(깃허브 액션으로 갈 이유가 없음. 원래 독립 테스트 설계보다 깃허브 액션이 먼저 있어서 있었던 건데)
- 만약 false이고, 구현 실패라면, 기획 분석부터 처음부터 다시 시작한다.
- 만약 false이고, 기획 문제라면, 반드시 '기획의 모순점'을 구체적인 코드/테스트 케이스와 함께 작성하며 md파일을 생성하여 사용자에게 제출한다.