메뉴
payment-platform 워크플로우의 plan 단계를 실행한다. discuss가 완료된 후 "plan 작성", "플랜 짜줘", "태스크 분해", "구현 계획" 등을 말할 때 이 스킬을 사용한다. docs/topics/<TOPIC>.md를 읽고 구체적인 구현 태스크로 분해하고, 게이트 검수까지 통과시키는 것이 목적이다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | workflow-plan |
| description | payment-platform 워크플로우의 plan 단계를 실행한다. discuss가 완료된 후 "plan 작성", "플랜 짜줘", "태스크 분해", "구현 계획" 등을 말할 때 이 스킬을 사용한다. docs/topics/<TOPIC>.md를 읽고 구체적인 구현 태스크로 분해하고, 게이트 검수까지 통과시키는 것이 목적이다. |
메인 스레드가 태스크 분해를 직접 수행하고, 완료 게이트만 서브에이전트로 격리한다.
공통 원칙은 workflow 스킬 참조.
docs/topics/<TOPIC>.md (discuss 산출물 — 결정 사항이 분해의 원천)docs/context/ARCHITECTURE.md, TESTING.mddocs/<TOPIC>-PLAN.md 작성:
# <주제> 구현 플랜
> 작성일: YYYY-MM-DD
## 목표
<한 줄 — 무엇이 완료되면 이 플랜이 끝나는지>
## 컨텍스트
- 설계 문서: docs/topics/<TOPIC>.md
- 주요 변경 파일: <예상 핵심 파일>
## 진행 상황
- [ ] Task 1: <이름>
- [ ] Task N: <이름>
## 태스크
### Task 1: <이름> [tdd=true|false] [domain_risk=true|false]
**테스트 (RED)** ← tdd=true만
- 테스트 클래스 + 메서드 스펙 (예: `IdempotencyStoreTest` — `get_존재하는_키_반환`)
- 패턴: `@ParameterizedTest @EnumSource` / Mockito BDD / AssertJ
**구현 (GREEN)**
- 무엇을 어디에 만들지 (파일 경로)
**완료 기준**
- <객관적 기준: 테스트 X pass, `./gradlew test` 회귀 없음>
**완료 결과**
> (execute에서 채움)
## 리뷰 처리
> (ship 단계에서 채움 — finding별 채택/스킵 + 사유)
분해 원칙:
Agent(subagent_type="reviewer", prompt="stage=plan, topic=<TOPIC>.
대상: docs/<TOPIC>-PLAN.md
체크리스트: .claude/skills/_shared/checklists/plan-ready.md 의 Gate 섹션
참고: docs/topics/<TOPIC>.md (traceability 대조)")
토픽에 domain_risk=true 태스크가 있으면 같은 메시지에서 domain-expert도 병렬 dispatch (plan-ready.md의 domain risk 섹션 + discuss 리스크 → 태스크 매핑 검증).
workflow 스킬의 교착 처리.PLAN.md 상단에 ## 요약 브리핑 섹션:
workflow 브리핑 원칙 준수)채팅에는 위치 안내 한 줄만. 사용자 확인 후 후처리.
execute, 활성 태스크 → Task 1docs: 단일 커밋알림: "plan 완료. 다음 단계: execute — 계속 진행할까요?"
코드 변경(diff, 브랜치, 커밋 범위, PR)을 배경–직관–코드–퀴즈 4섹션의 자기완결 인터랙티브 HTML 페이지로 풀어 설명한다. "diff 설명해줘", "이 PR 설명 페이지 만들어줘", "변경 내용 인터랙티브로 정리", "이 브랜치에서 뭘 바꿨는지 학습용으로 설명" 등 변경 사항의 리치 설명을 요청하면 HTML을 직접 언급하지 않아도 반드시 이 스킬을 사용한다. workflow ship 단계의 리뷰 통과 직후(A5)에도 자동 호출된다. 문제점을 찾는 검토 요청은 review 스킬, 대화 내 짧은 텍스트 요약은 일반 응답으로 처리한다.
payment-platform 워크플로우의 discuss 단계를 실행한다. 사용자가 새 기능/버그/개선의 설계를 논의하거나, "discuss 시작", "설계 논의", "어떻게 구현할지 얘기해보자", "방법 고민" 등을 말할 때 이 스킬을 사용한다. 구현 전에 결정해야 할 사항을 명확히 하는 것이 목적이다.
payment-platform 워크플로우의 execute 단계를 실행한다. docs/<TOPIC>-PLAN.md가 존재하고 사용자가 "execute 시작", "구현 시작", "코딩 시작", "태스크 실행", "다음 태스크" 등을 말할 때 이 스킬을 사용한다. TDD로 태스크를 하나씩 구현하고 커밋하는 것이 목적이다.
payment-platform 워크플로우의 ship 단계(코드 리뷰 + 마무리)를 실행한다. execute 완료 후 "ship 시작", "리뷰 시작", "코드 리뷰", "리뷰하고 마무리", "검증하고 마무리", "아카이브", "PR 만들어줘" 등을 말할 때 이 스킬을 사용한다. 리뷰 → 수정 → 최종 검증 → 문서 동기화 → 아카이브 → PR 흐름이다.
payment-platform의 discuss → plan → execute → ship 워크플로우 오케스트레이터. docs/STATE.md에 활성 토픽이 있거나, 사용자가 "discuss 시작", "plan 작성", "execute 시작", "워크플로우로", "다음 단계", "세션 재개", "이어서 진행", "어디까지 했지" 등을 말할 때 반드시 이 스킬을 사용한다. 단순 질문, 빠른 수정, 일회성 코드 변경에는 사용하지 않는다.
사용자가 "포트폴리오 수정", "포트폴리오 사이트", "payment-flows", "포트폴리오 페이지", "포트폴리오 배포", "index.html 고쳐", "포트폴리오 확인" 같은 표현으로 결제 플랫폼 포트폴리오 페이지를 참조·수정하라는 신호를 줄 때 반드시 사용한다. 이 포트폴리오(구 `docs/site/payment-flows.html`)는 payment-platform이 아니라 **별도 blog 저장소**(`notes/blog`, Astro)에서 관리되며 payment-platform 트리 안엔 존재하지 않으므로, 이 스킬이 정본 페이지(`src/pages/payment-platform-portfolio/index.astro` — CSS·데이터·로직은 각각 `src/styles/`·`src/data/paymentPortfolio/`·`src/scripts/portfolio/` 모듈로 분리)와 dev 툴 위치를 자동으로 찾아 Read / Grep / Edit 으로 접근하게 해준다. "포트폴리오" 단어가 없어도 결제 플랫폼 소개 페이지·시스템 아키텍처 다이어그램·시나리오 극장·섹션 밴드/모션 같은 그 페이지의 콘텐츠를 손봐야 하는 맥락이면 사용을 고려한다.