AI 서비스 엔지니어링: Track A
9주차 · 빈 저장소에서 v0.5까지
CodeCompose · 2026-09-18
1회전 지시 프롬프트
저장소 문서를 세우자. 코드는 아직 만들지 마.
- README.md: 이 서비스가 누구의 무슨 불편을 더는지 세 문단.
그 아래에 실행 방법(지금은 "아직 없음"이라고 정직하게),
데이터 출처, 라이선스
- AGENTS.md: 너에게 주는 규칙. 개발 명령, 커밋 전 검증,
커밋 메시지 규칙, 브랜치 규칙, 하지 말 것. 30줄을 넘기지 마라
- docs/architecture.md: 층 그림 하나(mermaid)와 층별 책임.
AI가 들어갈 자리는 "미정"으로 두고 자리만 표시해라
- docs/git-workflow.md: git flow 브랜치 모델과 커밋 규칙
- docs/decisions.md: 오늘 정한 것과 미룬 것을 날짜와 함께
- web/index.html: 동작하지 않는 샘플 화면 한 장.
입력 자리, 실행 버튼, 결과 자리. 프레임워크 쓰지 마라
- 문서 한 장이 커밋 하나다. 커밋하면서 진행해라 커밋 → PR → 머지 → v0.1
git push -u origin feature/docs
gh pr create --base develop --title "Set up project docs and a sample screen"
gh pr merge --mergegit switch develop && git pull
git switch -c release/v0.1
git switch main && git merge --no-ff release/v0.1
git tag -a v0.1 -m "Docs, conventions, and a sample screen"
git push origin main --tags 2회전 지시 프롬프트
AI 없이 도는 제품을 만들자. 모델 호출은 한 줄도 넣지 마.
- <소재>의 핵심 기능 하나를 끝까지 동작시켜라.
기능을 늘리지 말고 하나를 끝까지
- 데이터는 data/ 아래 파일 하나로. DB는 아직 쓰지 마라
- AI가 들어갈 자리는 Protocol 하나로 선언하고,
각본 대역 구현을 하나 만들어라. 화면에 "각본 대역" 표시가 뜨게
- 화면은 web/index.html을 목 UI로 키워라.
버튼이 서버를 부르고, 진행 표시와 에러 자리가 실제로 동작해야 한다
- 테스트: 핵심 경로가 각본 대역으로 키 없이 통과해야 한다.
GitHub Actions에서도 돌게 워크플로를 한 장 넣어라
- docs/architecture.md의 "미정" 자리를 방금 만든 Protocol로 채워라
- 작업 단위마다 커밋해라. 데이터 읽기 → 핵심 기능 → 화면 → 테스트 순으로 3회전 지시 프롬프트
각본 대역 자리에 진짜 모델을 넣자. 한 걸음씩, 걸음마다 커밋해라.
1) LiteLLM로 호출 하나. 모델은 환경변수로.
키가 없거나 호출이 실패하면 각본 대역으로 떨어지게 하고,
화면에 어느 쪽이 답했는지 표시해라
2) 응답 형식을 Pydantic 스키마로 고정해라.
core/assist.py의 Suggestion을 그대로 쓴다
3) 도구를 하나 붙여라. data/를 읽는 조회 도구만.
쓰기·삭제 도구는 만들지 마라
4) 루프를 붙여라. 스텝 상한과 누적 비용 상한을 같이 넣고,
스텝 수와 비용을 응답에 실어라
- 프롬프트는 prompts/ 아래 파일로 빼라. 코드에 박지 마라
- 각 걸음이 끝나면 테스트가 여전히 통과해야 한다
- 2회전에서 만든 시그니처는 바꾸지 마라. 바꿔야 한다면 먼저 말해라 한 장으로
flowchart LR
G["빈 저장소<br/>라이선스 · .gitignore<br/>develop"]
subgraph R1["1회전 → v0.1"]
direction TB
D["README 사람<br/>AGENTS.md 에이전트"] --> U["샘플 화면"]
end
subgraph R2["2회전 → v0.2"]
direction TB
C["AI 없이 도는 제품"] --> S["각본 대역"] --> T["테스트 · CI"]
end
subgraph R3["3회전 → v0.5"]
direction TB
A1["호출 하나"] --> A2["형식 고정"] --> A3["도구 하나"] --> A4["루프 · 상한"]
end
G --> D
U --> C
T --> A1
A4 --> P(["10주차<br/>내 프로젝트"])