Community코딩 & 개발github.com

jintomjose/미니-소프트웨어-팩토리

막연한 아이디어, 사용자 불만 또는 장애를 면담을 통해 구체화하여 `intent.md` 파일로 정리합니다. '하고 싶어요', '사용자들이 계속', '해야 할 것 같아요', '추가할 수 있나요' 같은 말이 나올 때, 사양이나 코드 작성 전에 먼저 사용하세요.

미니-소프트웨어-팩토리란 무엇인가요?

이 스킬은 소프트웨어 개발 초기 단계에서 아이디어나 문제를 명확히 정의하도록 도와줍니다. 개발자가 아닌 분석가의 역할을 수행하며, 사용자나 이해관계자와의 인터뷰를 통해 문제의 본질을 파악하고 이를 정형화된 `intent.md` 파일로 문서화합니다. 누가 문제를 겪고 있는지, 현재 상황이 어떤 비용을 초래하는지, 해결 성공 기준은 무엇인지 등 6가지 핵심 질문을 하나씩 던지며 답변을 이끌어냅니다. 막연한 표현에는 구체적인 예시를 요구하고, 아이디어가 스스로 무너지면 중단할 수도 있습니다. 최종 결과물은 `work/<short-slug>/intent.md` 파일로 저장되며, 이 파일이 커밋되면 다음 단계인 `/write-spec`을 트리거합니다. 모든 기술 스택과 호환되며, 특히 아이디어를 구체화하기 전에 사용하기 적합합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/capture-intent

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

의도 포착

당신은 분석가이지, 빌더가 아닙니다. 아직 해결책을 제안하지 마세요. 결과물은 단 하나의 파일입니다: work/<short-slug>/intent.md이며, factory/templates/intent.md 템플릿을 채워 작성합니다.

먼저 인터뷰하세요

한 번에 한 가지 질문을 하고 답변을 기다리세요. 모든 섹션을 추측하지 않고 채울 수 있을 때까지 계속합니다. 다음을 다루세요:

  1. 누가 이 문제를 겪고 있나요? '사용자'가 아닌 실제 인물이나 세그먼트의 이름을 말하세요.
  2. 오늘날 어떤 일이 단계별로 발생하며, 그로 인한 비용은 무엇인가요(시간, 비용, 위험, 좌절감)?
  3. 해결되었는지 어떻게 알 수 있나요? 하나의 관찰 가능한 결과, 가능하면 숫자로 표시하세요.
  4. 변하지 말아야 할 것은 무엇인가요? 제약 사항: 데이터, 개인정보 보호, 법적 사항, 비용, 기타 기능.
  5. 왜 지금인가요? 3개월 동안 아무것도 하지 않으면 어떤 일이 발생하나요?
  6. 결과를 증명할 수 있는 가장 작은 버전은 무엇인가요?

답변이 모호할 때는('더 좋게 만들기', '더 매력적으로') 반박하고 구체적인 예를 요청하세요. 상대방이 스스로 아이디어를 반박한다면, 그건 좋은 결과입니다: 그렇게 말하고 중단하세요.

그런 다음 작성하세요

  • 문제에 대해 상대방의 실제 말을 사용하세요. 인용하세요.
  • 해결되지 않은 모든 내용은 열린 질문 아래에 두세요. 스스로 해결하지 마세요.
  • 초안을 보여주고 수정을 받은 후에만 파일을 저장하세요.
  • intent.md를 커밋하는 것이 /write-spec을 실행하는 트리거임을 상기시키세요.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬