메뉴
/plan 실행 전 사전 정보를 정리하는 스킬. 사용자와 실시간 대화로 PROMPT/PRD/SPEC 3개 문서를 docs/agents/output/plan/{타임스탬프}/ 에 작성한다. PRD/SPEC은 이후 /plan 모드에 전달된다. 트리거: /BeforePlan, "plan 준비", "사전 계획 문서", "PRD/SPEC 먼저 작성", "/plan 전 정리".
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Android 라이브러리 코드 리뷰 스킬. 우선순위 5단계(아키텍처→기능→로직→품질→명명) 순서로 점검하고 100점 평가한다. 코드 리뷰가 필요할 때 슬래시 명령 `/CodeReview`로 실행한다(자동 호출 비활성 — 자연어 "코드 리뷰" 요청은 review 에이전트 담당).
프로젝트의 Skill(.claude/skills/)과 구식 커맨드(.claude/commands/)를 품질 루브릭(6섹션 30항목, 규칙/모델 검사 분리, S~F 등급)으로 점검하고 등급표와 개선 조치를 보고한다. 스킬을 새로 만들었거나 수정한 직후, 또는 스킬이 호출되지 않거나 이상 동작할 때 반드시 사용한다. 트리거: /SkillReview, "스킬 점검", "스킬 품질 검사", "스킬 평가", "SKILL.md 검사", "skill review", "루브릭 점검", "스킬이 왜 호출 안 되지".
ktlint, lint, apiDump 정적 분석 일괄 실행 스킬. "품질 체크", "ktlint", "lint 체크", "api dump", "정적 분석" 요청 시 사용.
Android app 모듈에 파일 세트를 생성한다. FQCN을 입력하면 suffix로 타입(Activity/Fragment/DialogFragment/Adapter/Layout)을 자동 감지하여 Kotlin 파일과 XML 레이아웃을 함께 생성한다. "만들어줘", "생성해줘", "Activity/Fragment 추가" 등의 요청 시 사용.
PRD/SPEC을 입력으로 구현 계획(PLAN)을 작성하는 절차. /plan 진입 시 mainAgent가 이 절차를 따른다. 선행 PRD/SPEC을 알 때만 적용(세션 내 BeforePlan 산출물 또는 사용자 명시 참조), 모르면 기본 /plan 수행. PRD/SPEC의 생성·포맷은 BeforePlan이 단일 소유한다. EnterPlanMode/ExitPlanMode와 plan_format_check로 검증한다. 트리거: /plan (PRD/SPEC을 아는 경우), /MakePlan, "구현 계획 작성", "PLAN 작성".
SimpleUI_XML 프로젝트의 테스트 코드를 작성. 대상 코드, 기존 테스트 관례, 관련 문서를 직접 읽고 Unit 또는 Robolectric 테스트를 판단한다. "테스트 코드 작성", "테스트 만들어줘", "test code" 등의 요청 시 사용.
| name | BeforePlan |
| description | /plan 실행 전 사전 정보를 정리하는 스킬. 사용자와 실시간 대화로 PROMPT/PRD/SPEC 3개 문서를 docs/agents/output/plan/{타임스탬프}/ 에 작성한다. PRD/SPEC은 이후 /plan 모드에 전달된다. 트리거: /BeforePlan, "plan 준비", "사전 계획 문서", "PRD/SPEC 먼저 작성", "/plan 전 정리". |
순수 /plan 모드에 진입하기 전에, 요구사항을 명확히 정리한 PRD/SPEC을 미리 만들어 둔다.
이렇게 하면 /plan 모드는 잘 정의된 입력 위에서 PLAN(구현 계획) 작성에 집중할 수 있다.
| 문서 | 역할 | 편집 방식 |
|---|---|---|
| PROMPT | 사용자와의 대화 기록 (Q&A 로그) | append-only — 그대로 덧붙이기만, 요약/재해석/삭제 금지 |
| PRD | 요구사항 정제본 (성공기준·범위·제약) | 편집 가능 — 사용자 발언에 근거한 갱신은 자유. 발언 없이 임의 변경 금지 |
| SPEC | 기술 명세 (코드 탐색 기반) | 편집 가능 — 기술적 수정은 자율, 근거(파일:라인) 필수 |
docs/agents/output/plan/{타임스탬프}/yyMMdd_HHmmss (예: 260604_121053)
Get-Date -Format "yyMMdd_HHmmss" (PowerShell){TS}_PROMPT.md, {TS}_PRD.md, {TS}_SPEC.md
260604_121053_PROMPT.md1. 타임스탬프 생성 + 폴더 생성
2. 사용자와 대화 → PROMPT(로그)와 PRD(정제본)를 병행 기록
- 종료 게이트: PRD가 빈틈없음 (성공기준·범위·제약이 충분히 채워짐)
3. PRD 기반으로 코드를 직접 탐색하며 SPEC 작성
- 탐색 중 오류/모호 발견 시 아래 "분기 기준"에 따라 처리
4. 종료 조건 충족 시 3개 문서 확정 저장
4.5 PRD/SPEC 규격 검증 (① — PLAN 없음, 아래 "검증 단계(①)" 절)
- ps1 `-Stage prd_spec` → PASS면 plan_format_check `Stage=prd_spec`
- 이상 시 → 종료 조건 미충족으로 보고, 단계 2/3로 돌아가 수정 후 재검증
5. (① 검증 PASS 후) 사용자에게 /plan 실행 안내
- 생성한 `docs/agents/output/plan/{TS}/` 경로와 PRD/SPEC 파일명을 **명시 출력**한다.
- 이 `{TS}` 경로가 MakePlan(/plan)의 입력이며, 세션이 길어져 컨텍스트를 잃을 경우 사용자가 이 경로를 그대로 전달하면 된다고 안내한다.
| 상황 | 처리 | 비고 |
|---|---|---|
| 코드와 SPEC의 기술적 불일치 (사용자 질문 불필요) | SPEC만 수정 | PROMPT/PRD 변동 없음 |
| 답이 기술 수준인 질문 | 질문 → PROMPT 추가 → SPEC 수정 | PRD 변동 없음 |
| 답이 요구사항을 건드리는 질문 | 질문 → 답변(=근거) → PROMPT 추가 + PRD 수정 → SPEC 수정 | 답변이 곧 근거 |
아래가 모두 충족되면 완료:
3개 문서 저장 후, 사용자에게 안내하기 전에 PRD/SPEC 규격을 기계(ps1) + 에이전트(format_check)로 검증한다.
PLAN은 BeforePlan에서 만들지 않으므로 검증 대상이 아니다 → 항상 Stage=prd_spec.
powershell -ExecutionPolicy Bypass -File .claude/hooks/plan_artifact_check.ps1 -TS {TS} -Stage prd_spec 실행
{TS}/_verification.txt를 생성한다.Stage=prd_spec로 호출 → PRD/SPEC 필수 섹션·충실도 검증.
각 문서를 실제로 작성할 때 해당 guide를 읽어 규칙을 따른다.
.claude/skills/BeforePlan/references/prompt_guide.md.claude/skills/BeforePlan/references/prd_guide.md.claude/skills/BeforePlan/references/spec_guide.md