메뉴
날것의 아이디어를 실행 가능한 one-pager(artifacts/<feature>/idea.md)로 다듬는 옵션 모듈. 아이디어가 막연하거나 MVP 범위·추진 방향을 정해야 할 때("이거 괜찮을까?", "뭘 먼저 만들지?") 트리거한다. 요구사항이 이미 구체적이면 건너뛰고 /write-spec으로 간다. "/idea-refine", "아이디어 정리", "ideate"로도 호출한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | idea-refine |
| description | 날것의 아이디어를 실행 가능한 one-pager(artifacts/<feature>/idea.md)로 다듬는 옵션 모듈. 아이디어가 막연하거나 MVP 범위·추진 방향을 정해야 할 때("이거 괜찮을까?", "뭘 먼저 만들지?") 트리거한다. 요구사항이 이미 구체적이면 건너뛰고 /write-spec으로 간다. "/idea-refine", "아이디어 정리", "ideate"로도 호출한다. |
| argument-hint | idea or feature name |
날것의 아이디어를 추진할 만한 one-pager로 다듬는다. 요구사항이 이미 구체적이면 이 단계를 건너뛰고 /write-spec으로 간다.
| 입력 | 출력 |
|---|---|
| 사용자의 날것 아이디어 | artifacts/<feature>/idea.md |
아이디어를 명료한 문제 진술로 재진술한다. 사용자의 말을 되풀이하지 말고 문제의 틀 자체를 다시 잡는다. 그리고 AskUserQuestion으로 날카로운 질문을 3~5개 던진다. 초점: 누구를 위한 것인가, 성공은 어떤 모습인가, 진짜 제약은 무엇인가, 왜 지금인가. 처음 요청에 이미 답이 나왔으면 확인만 한다.
코드베이스 안이라면 Glob·Grep·Read로 기존 아키텍처·패턴·제약을 먼저 훑는다. 방향은 실제로 존재하는 것에 발을 붙여야 한다.
진짜로 다른 방향을 2~3개 만들고, 각각의 사용자 가치·실현 가능성·차별점을 평가한 뒤 하나를 추천한다. 낮은 차별성이나 높은 복잡도는 그대로 지적한다. 맞장구치지 않는다.
숨은 가정을 드러내고, 틀리면 아이디어가 죽는 가정부터 검증 대상으로 삼는다.
확산 축, 평가 프레임워크, 가정 분류법 같은 사고 도구가 필요하면 references/thinking-frameworks.md를 참조한다.
references/idea-template.md 형식으로 정리한다. MVP는 가장 위험한 가정을 먼저 검증해야 하고, "Not Doing" 리스트가 가장 가치 있다. 집중은 좋은 아이디어에 No라고 말하는 것이다.
사용자에게 artifacts/<feature>/idea.md에 저장할지 묻고, 확인했을 때만 저장한다.
저장 후 다음 단계는 /write-spec <feature>로 외부 관찰 가능한 동작을 spec.md에 확정하는 것이다.
여러 feature에 쌓인 `artifacts/*/learnings.md`를 정리한다 — 중복 병합, 충돌 해소, 낡은 항목 폐기, hypothesis 확정. 승격은 하지 않는다. learnings.md가 여러 feature에 쌓였을 때 트리거하고, 단일 feature 진행 중에는 쓰지 않는다. "/compound", "회고", "메모리 정리"로도 호출한다.
spec.md를 기반으로 구현 계획(artifacts/<feature>/plan.md)을 작성한다. 여러 파일에 걸치거나 시나리오가 서로 의존하는 product feature에 쓴다. 한 세션에 끝나는 작업·meta-tooling·명백한 변경은 내장 plan 모드로 한다. "/draft-plan", "draft plan", "계획 작성", "구현 계획"으로도 호출한다.
확정된 artifacts/<feature>/plan.md의 Task를 TDD로 하나씩 구현하고 Task당 한 커밋을 만든다. 사용자가 "이제 구현 시작", "플랜 실행" 같은 신호를 보낼 때 트리거한다. plan.md 없이 바로 구현하는 경우에는 쓰지 않는다. "/execute-plan", "플랜 실행", "구현 시작"으로도 호출한다.
spec.md를 기반으로 HTML 와이어프레임을 생성하는 옵션 모듈. 레이아웃 구조가 바뀌는 UI feature(새 화면, 새 레이아웃, 화면 간 흐름)에 사용한다. 서버·데이터 전용 변경이나 레이아웃이 그대로인 변경에는 쓰지 않는다. "/sketch-wireframe", "wireframe", "와이어프레임", "레이아웃 확인"으로도 호출한다.
새 feature의 외부 관찰 가능한 동작(WHAT)을 사용자와 대화하며 spec.md로 확정한다. 요구사항이 모호하거나 여러 화면·경로에 걸친 다단계 feature를 정의하려는 신호가 보이면 트리거한다. 버그 수정, 한 줄 변경, 이미 구체적인 요구에는 쓰지 않는다. "/write-spec", "스펙 작성", "기능 정의"로도 호출한다.
