메뉴
payment-platform의 discuss → plan → execute → ship 워크플로우 오케스트레이터. docs/STATE.md에 활성 토픽이 있거나, 사용자가 "discuss 시작", "plan 작성", "execute 시작", "워크플로우로", "다음 단계", "세션 재개", "이어서 진행", "어디까지 했지" 등을 말할 때 반드시 이 스킬을 사용한다. 단순 질문, 빠른 수정, 일회성 코드 변경에는 사용하지 않는다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | workflow |
| description | payment-platform의 discuss → plan → execute → ship 워크플로우 오케스트레이터. docs/STATE.md에 활성 토픽이 있거나, 사용자가 "discuss 시작", "plan 작성", "execute 시작", "워크플로우로", "다음 단계", "세션 재개", "이어서 진행", "어디까지 했지" 등을 말할 때 반드시 이 스킬을 사용한다. 단순 질문, 빠른 수정, 일회성 코드 변경에는 사용하지 않는다. |
4단계: discuss → plan → execute → ship. 메인 스레드가 설계·분해·오케스트레이션을 직접 수행하고, 독립 시각이 가치 있는 지점에만 서브에이전트를 쓴다.
reviewer / domain-expert 서브에이전트로만 실행한다. 메인이 만든 산출물을 메인이 판정하면 self-rubber-stamp가 된다.implementer 서브에이전트로만 실행한다 (태스크당 1회).docs/context/PITFALLS.md)을 프롬프트에 명시한다. 입력이 좋아야 검토가 깊어진다.docs/STATE.md 읽기 → 활성 토픽·단계·재개 메모 파악| 현재 단계 | 참조 스킬 |
|---|---|
| idle / discuss | workflow-discuss |
| plan | workflow-plan |
| execute | workflow-execute |
| ship | workflow-ship |
사용자가 특정 단계를 명시하면 해당 스킬로 바로 진행한다.
idle 상태에서 다음 작업이 명확하지 않으면 docs/context/TODOS.md를 읽고 항목을 제안한다.
게이트 라운드를 돌리기 전(사전 브리핑)과 게이트 pass 후(완료 브리핑), 사용자에게 도메인 용어 + Mermaid 플로우차트 포함 브리핑을 제시한다. 목적: 사용자가 방향을 교정할 수 있는 게이트 보장.
() 부가 표기.{ } · → — 대체 표기는 _shared/conventions/writing.md 참조.각 단계가 끝나면 멈추고 사용자의 명시적 확인을 기다린다. 자동 진행 금지.
## [단계명] 완료
<완료 내용 한 줄 요약>
다음 단계: [다음 단계명] — 계속 진행할까요?
예외: 사용자가 "연속으로 진행해", "끝까지 해줘" 등을 명시한 경우만 자동 진행.
승인이 필요한 질문(AskUserQuestion 포함)이 응답 없이 타임아웃되면 단독으로 진행하지 않는다 — 턴을 종료하고 답변을 기다린다. 무응답은 승인이 아니다. 단계 전환뿐 아니라 findings 채택, 게이트 진행 등 모든 승인 지점에 적용된다.
단계 전환 시 항상 이 형식으로 갱신한다. 완료 이력은 STATE에 쌓지 않는다 — 아카이브의 COMPLETION-BRIEFING이 이력의 SSOT다. "최근 완료" 항목도 한 줄 + 브리핑 링크만 — 결정 상세·수치·후속 메모를 압축 서사로 욱여넣지 않는다 (상세는 브리핑 몫, 대기 액션은 TODOS.md 몫).
# 현재 작업 상태
> 최종 수정: YYYY-MM-DD
## 활성 작업
- **주제**: <주제> (없으면 "없음 (idle)")
- **단계**: discuss | plan | execute | ship
- **활성 태스크**: Task N: <이름> ← execute 단계에서만
- **이슈/브랜치**: #<번호> ← discuss 완료 후
- **파일**: docs/topics/<TOPIC>.md / docs/<TOPIC>-PLAN.md
## 재개 메모
(세션 중단 시 작성, 평소 비움: 완료/남은 태스크, 결정·주의사항, 재개 방법)
## 최근 완료
- **<주제>** (YYYY-MM-DD) — docs/archive/<topic-kebab>/COMPLETION-BRIEFING.md
- (최대 2개 유지, 전체 이력은 docs/archive/README.md)
세션 중단 시: 재개 메모를 채우고 WIP를 wip: 커밋에 STATE.md와 함께 포함한다.
| 시점 | 포함 파일 | 커밋 타입 |
|---|---|---|
| Discuss 완료 | topic.md(브리핑 포함) + STATE.md | docs: |
| Plan 완료 (게이트 통과 후) | PLAN.md + STATE.md | docs: |
| TDD RED | 실패 테스트 파일만 | test: |
| TDD GREEN | 구현 + 테스트 + PLAN.md + STATE.md | feat: |
| TDD REFACTOR | 정리된 코드 (변경 있을 때만) | refactor: |
| tdd=false 태스크 완료 | 구현 + PLAN.md + STATE.md | feat: / chore: |
| 리뷰 피드백 수정 | 수정 파일 + PLAN.md 리뷰 처리 | fix: / refactor: (수정 성격) |
| 세션 중단 | WIP + STATE.md(재개 메모) | wip: |
| Ship 마무리 | context 갱신 + 아카이브 + STATE.md | docs: |
세부 규칙은 _shared/conventions/commit.md, 이슈/브랜치/PR은 _shared/conventions/github.md 참조.
코드 변경(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-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 으로 접근하게 해준다. "포트폴리오" 단어가 없어도 결제 플랫폼 소개 페이지·시스템 아키텍처 다이어그램·시나리오 극장·섹션 밴드/모션 같은 그 페이지의 콘텐츠를 손봐야 하는 맥락이면 사용을 고려한다.
payment-platform의 docs/context/ 영구 문서를 현재 코드베이스 상태에 맞게 갱신한다. "컨텍스트 업데이트", "context 문서 갱신", "docs/context 최신화", "아키텍처 문서 업데이트", "문서 동기화", "context 맞춰줘" 등을 말할 때 반드시 이 스킬을 사용한다. workflow ship 단계에서도 호출된다.