목적
++ AI를 빠른 코드 생성 도구로만 쓰지 않고, 변경 범위와 리스크를 사람이 검토할 수 있는 개발 보조 도구로 사용한다. +
+
+
+
+ 확인할 질문
+
+ -
+
- 어떤 문제를 해결하려고 했는가 +
- 구현 전에 어떤 영향과 리스크를 검토했는가 +
- AI 제안 중 무엇을 채택하거나 기각했는가 +
+ 남길 증거
+
+ -
+
- 실행한 테스트와 검증 결과 +
- PR에 남은 리스크 +
- 리뷰 의견의 채택 또는 기각 이유 +
개발 흐름
+
+
+
+
+ 1
+ 문제 정의
+ 해결할 문제, 성공 조건, 제외 범위를 먼저 정리한다.
+
+
+ 2
+ 구조 분석
+ 기존 코드, 변경 파일, API/DB 영향, 테스트 범위를 확인한다.
+
+
+ 3
+ 계획 승인
+ AI 제안을 검토하고 채택, 수정, 기각할 범위를 결정한다.
+
+
+ 4
+ 구현
+ 승인된 범위 안에서만 변경하고 계획 밖 변경은 다시 설명한다.
+
+
+ 5
+ 검증
+ 빌드, 테스트, 계약 영향, 성능 근거를 실제로 확인한다.
+
+
+ 6
+ 기록과 개선
+ 채택/기각 이유, 검증 결과, 남은 리스크를 남기고 흐름을 개선한다.
+ 단계별 AI 활용
+
+
+
+
+ 분석 단계
+-
+
- AI에게 기존 구조를 읽게 하고 변경 후보 파일을 좁힌다. +
- API, 데이터베이스, 트랜잭션, 비동기 경계 영향을 먼저 확인한다. +
- 불확실한 부분은 구현 전에 질문이나 대안으로 드러낸다. +
+
+ 구현 단계
+-
+
- 사람이 승인한 범위 안에서만 AI에게 구현을 맡긴다. +
- 계획 밖 변경이 필요하면 먼저 이유와 영향을 다시 설명한다. +
- 관련 없는 리팩터링과 서식 변경은 작업 범위에서 제외한다. +
검증과 기록
+
+
+
+
+ 검증
+-
+
- 테스트를 실행했다는 말보다 어떤 명령을 실행했고 어떤 결과였는지를 남긴다. +
- 성능 개선이나 운영 안정성 주장은 측정 결과가 있을 때만 주장한다. +
- 실행하지 못한 검증은 숨기지 않고 이유와 남은 리스크로 적는다. +
+
+ 기록
+-
+
- AI 사용 범위와 사람이 채택하거나 기각한 제안을 기록한다. +
- 남은 리스크를 PR이나 작업 요약에 남겨 다음 리뷰에서 확인할 수 있게 한다. +
- 원본 프롬프트, 도구 로그, 비밀 정보, 개인정보는 커밋하지 않는다. +
리뷰와 개선
++ 리뷰는 AI가 만든 변경을 신뢰하기 위한 통과 의례가 아니라, 사람이 놓칠 수 있는 회귀와 운영 리스크를 다시 찾는 단계다. +
+
+
+
+
+ 리뷰
+-
+
- 전체 diff 기준으로 기능 오류, 요구사항 불일치, 데이터 정합성을 확인한다. +
- 트랜잭션, 비동기, API/DB 호환성, 누락 테스트를 우선 점검한다. +
- 리뷰 의견은 실제 오류 여부와 복잡도 증가를 기준으로 채택하거나 기각한다. +
+
+ 개선
+-
+
- 반복적으로 도움이 된 절차는 유지한다. +
- 형식만 늘고 판단 품질을 높이지 못한 절차는 줄인다. +
- AI가 자주 놓치는 리스크는 실행 규칙과 워크플로우에 반영한다. +
Superpowers 사용 방식
++ Superpowers는 모든 작업에 기계적으로 적용하지 않는다. 판단이 필요한 작업이거나 사용자가 명시한 경우에 사용한다. +
+| 작업 성격 | +주로 사용하는 skill | +
|---|---|
| 새 기능 또는 구조 변경 | +brainstorming |
+
| 복잡한 구현 계획 | +writing-plans |
+
| 버그 수정 | +systematic-debugging |
+
| 테스트 중심 변경 | +test-driven-development |
+
| 완료 보고 전 검증 | +verification-before-completion |
+
+ Superpowers는
+ AGENTS.md의 저장소 규칙을 대체하지 않는다. 승인 전 파일 수정 금지, 변경 범위 제한, 한국어 문서 작성, Git 작업 제한은 그대로 유지한다.
+ 앞으로 개선할 점
+-
+
- 실제 작업 사례를 보며 분석, 계획, 구현, 검증 단계 중 도움이 된 절차를 유지한다. +
- 형식은 늘었지만 판단 품질을 높이지 못한 절차는 줄인다. +
- AI가 반복해서 놓치는 리스크는 다음 작업 흐름에 반영한다. +
- 자동화는 사람이 판단해야 할 부분을 대체하지 않는 범위에서만 도입한다. +