cody-product-builder: 아이디어를 실제 제품으로 구현하는 가이드 워크플로우

이 스킬이 도움이 되었다면, 이 레포지토리에 별점을 눌러 응원을 보여주세요! ⭐⭐

Cody Product Builder는 지식 노동자와 도메인 전문가가 AI를 활용하여 아이디어를 실제 제품으로 전환할 수 있도록 돕는 가이드 워크플로우(agent skill)입니다. 이 도구는 아이디어 구상부터 배포된 버전까지 사고 과정을 구조화하여, 개발자가 되지 않고도 혼란에 빠지지 않게 제품을 구축할 수 있게 합니다.

새로운 프로젝트를 시작하든, 기존 프로젝트를 이어가든, 혹은 간단한 수정 사항을 배포하든 상관없이, Cody는 모든 AI 코딩 환경(Claude Code, Cursor, GitHub Copilot 등)에서 작동하는 반복 가능한 워크플로우를 제공합니다. 이는 AI가 생성한 아이디어를 표면화하고 포착하여 좋은 제안들이 채팅에 묻히지 않게 하며, 프로젝트가 성장함에 따라 계속해서 구축 가능하도록 유지해 줍니다.

새로 시작하나요? Cody는 단 한 줄의 코드가 작성되기 전에 아이디어 구체화, 요구 사항 정의 및 계획 수립 과정을 안내합니다.

기존 프로젝트가 있나요? Cody는 코드베이스를 분석하고 이미 구축된 내용을 이해한 후, 그 지점부터 작업을 이어 나갑니다.

간단한 수정이 필요한가요? 패치(Patches) 기능을 사용하면 전체 빌드 사이클을 건너뛰면서도 무엇이 변경되었고 왜 변경되었는지 추적할 수 있습니다.

아이디어를 테스트하고 싶나요? 프로토타입(Prototypes) 기능은 계획 및 구축 전후에 아이디어를 시도해 볼 수 있는 임시적인 대화형 목업을 만들게 해줍니다.

당신과 AI 양쪽의 아이디어를 하나의 구조화된 장소에 포착하여 좋은 제안들이 채팅에서 사라지는 것을 방지하세요. 그리고 이를 코드베이스에 통합하기 전에 평가할 수 있습니다.

영감의 불꽃들을 포착하고 그것들을 명확하고, 정렬되고, 잘 정의된 제품 개념으로 다듬으세요.

당신의 생각, 요구 사항, 흐름(flows), 의사결정 등을 정리하는 AI 친화적인 문서를 사용하면서도 아이디어가 자연스럽게 진화하도록 허용합니다.

작업을 관리 가능한 점진적 '버전'으로 나누어 AI를 통해 더 빠르고 쉽게 구축하고, 테스트하고, 배포할 수 있습니다. 각 버전은 완전하며 배포 가능합니다.

전체 버전 빌드 사이클의 오버헤드 없이 버그를 수정하고 작은 개선 사항을 빠르게 만들면서도 모든 것을 추적할 수 있습니다.

언제든지 아이디어를 시험해 볼 수 있는 임시적이고 상호작용적인 목업(mockup)을 만드세요. 프로토타이핑은 계획 및 구축과 독립적입니다. 계획하거나 구축할 때, Cody에게 프로토타입을 사용하여 작업에 도움을 받도록 요청할 수 있습니다.

AI 도구는 강력하지만, 구조가 없으면 모든 것이 무너집니다: 지저분한 프롬프트(prompts), 일관성 없는 코드, 불명확한 요구사항, 손실된 컨텍스트(context), 그리고 끝없는 재작업이 발생합니다. 동시에, AI에서 나온 좋은 아이디어들은 캡처되고 평가되기보다는 채팅 기록 속에 사라지곤 합니다.

Cody Product Builder는 다음을 제공함으로써 이 문제를 해결합니다:

• AI 코딩 도구가 따를 수 있는 반복 가능한 워크플로우로, AI가 생성한 아이디어를 표면화하고 포착합니다.
• 추측을 없애고 추진력을 유지하는 템플릿과 명령어(commands).
• 창의성을 저해하지 않으면서 혼란을 방지하는 구조.
• 명확한 연속성으로 작업을 배포 가능한 버전(shippable versions)으로 나누는 일관된 방법.
• 단순히 코드를 생성하는 것이 아니라, 실제 제품을 구축하는 방법.

원시적인 아이디어를 다음 세 가지 핵심 문서를 사용하여 실행 가능한 계획으로 전환하세요:

• 아이디어 문서 (Idea Document): 필터링되지 않은 초기 아이디어를 담고 AI 에이전트와 상호작용적인 Q&A를 시작합니다. 결과물은 명확한 비전과 기본 요구사항입니다. 그린필드(greenfield) 프로젝트에 사용됩니다.
• 기술 감사 문서 (Technical Audit Document): 기존 코드베이스의 경우, 프로젝트에 대한 자율적인 기술 감사(tech stack, 아키텍처, 의존성, 기존 기능)를 대상 사용자 Q&A와 결합하여 포착합니다. 브라운필드(brownfield) 프로젝트용 discovery.md를 대체합니다.
• 제품 정의서 (Product Definition): 목표, 타겟 사용자, 기능, 성공 기준, 스토리, 가정(assumptions), 의존성 등을 포함하는 '무엇과 왜'를 정의합니다.
• 실행 계획서 (Execution Plan): 아키텍처, 구성 요소(components), 데이터 모델, 마일스톤, 위험 요소(risks), 도구(tooling), 배포 전략을 포함하는 '어떻게와 언제'를 정의합니다.

빌드 단계는 이 계획을 구조화되고 버전 기반의 실행으로 변환합니다.

• 우선순위 및 상태 추적과 함께 버전별로 구성된 모든 기능 목록이 중앙 집중식으로 제공됩니다 (🔴 미시작, 🟡 진행 중, 🟢 완료).

각 버전에는 다음이 포함됩니다:

• 기술 구현 가이드, 아키텍처 개요, 그리고 열린 질문들.
• 기능 백로그(Feature Backlog)에서 파생된 작업에 대한 상세한 분류.

배운 점(Lessons learned), 개선 사항(improvements), 성공 사례(successes) 및 피드백을 사용자와 AI 에이전트 모두를 위해 기록합니다.

패치(Patches)는 전체 버전 빌드 주기를 건너뛰는 가벼운 수정 또는 작은 개선 사항입니다. 각 패치는 빌드 디렉터리의 버전들과 나란히 자체 폴더에 존재합니다.

문제점, 계획, 해결책, 그리고 변경된 파일을 기록합니다. 디자인 문서(design doc), 작업 목록(tasklist) 또는 회고록(retrospective)이 필요하지 않습니다.

빌드를 하는 동안 사용자와 AI 모두에게서 아이디어가 끊임없이 떠오릅니다. 이 아이디어들을 잃어버리거나 다른 앱으로 컨텍스트 스위칭하는 대신, :cody idea를 사용하면 즉시 기록할 수 있습니다. 이 아이디어들은 기능 백로그(feature backlog)의 백로그 섹션에 직접 추가되며, 새로운 버전이나 패치를 생성할 때 시작점으로 제공됩니다.

버전 또는 패치가 끝날 때마다 자동으로 업데이트되어 변경 사항, 개선 사항, 수정 사항을 추적합니다.

프로젝트가 구축되면서 배운 모범 사례(best practices)에 대한 살아있는 기록입니다. 매 버전 또는 패치가 끝난 후, Cody는 자신이 학습한 내용(회고록이나 패치와 세션으로부터 얻은 것)을 분류된 모범 사례 파일로 기록하고, 버전을 설계하거나, 패치를 시작하거나, 빌드할 때, 그리고 :cody refresh를 할 때 이를 다시 읽어옵니다. 따라서 모든 빌드는 프로젝트가 이미 정한 표준을 따르게 됩니다. Cody는 간결하게 유지합니다: 새로운 학습 내용이 오래된 규칙과 모순될 경우, 쌓아 올리기보다는 이전 것을 변경하거나 제거합니다. 이 파일은 프로젝트 수준의 best-practices/ 폴더에 존재하며 비어 있는 상태로 시작하여 빌드함에 따라 채워집니다.

때로는 아이디어를 확정하기 전에 테스트해 보고 싶을 때가 있습니다. :cody prototype를 사용하면 바로 그러한 목적을 위한 임시적이고 상호작용적인 목업(mockup)을 구축할 수 있습니다. 프로토타이핑은 계획(Plan) 단계와 빌드(Build) 단계와 독립적입니다: 계획하기 전, 계획하는 동안, 빌드 전 또는 도중에, 혹은 후에 언제든지 실행할 수 있습니다. 하나의 세션에서 처음부터 끝까지 프로토타입을 구축합니다.

단일 프로토타입을 기록합니다: 테스트 중인 아이디어, 무엇을 테스트할지, 빌드 접근 방식, 반복적인 발견 로그(iterative findings log), 그리고 사용자의 선호 및 비선호 사항(작동하는 것, 유지할 것, 버릴 것).

각 프로토타입은 prototypes/ 아래에 자체적으로 독립된 폴더에 존재합니다.

프로토타입은 일회성(disposable)입니다. 계획을 세우거나 빌드할 때, Cody는 사용자가 가진 모든 프로토타입을 언급하여 이를 작업에 활용하도록 요청할 수 있게 합니다. 프로토타입이 목적을 다했다면, 참고용으로 보관할지 삭제할지 선택합니다.

프로토타입은 단순히 프로젝트 내의 파일들(폴더와 prototype.md)로 구성되어 있으므로, 어떤 AI 세션에서 빌드했는지는 중요하지 않습니다. 실제로 사용자가 결정하는 것은 프로토타입이 계획 또는 빌드 작업과 얼마나 많은 대화 내용을 공유할지 여부입니다.

같은 세션(Same session). 이미 계획을 세우거나 빌드하고 있는 세션에서 :cody prototype를 실행합니다. 에이전트는 해당 대화를 프로토타입에 포함시키므로, 사용자의 발견 내용(discovery answers), 구체화하는 계획(plan you are shaping), 그리고 범위를 정하는 버전(version you are scoping) 모두가 프로토타입을 구축하는 데 영향을 미칩니다. 이 방법은 프로토타입이 현재 작업하고 있는 내용과 밀접하게 연결되어 있고, 그 맥락(context)으로 인해 모양을 갖추기를 원할 때 사용합니다.

별도 세션(Separate session). 새로운 AI 개발 세션을 열고 거기서 :cody prototype를 실행합니다. 프로토타이핑 대화는 계획 또는 빌드 세션과 완전히 분리되어 유지됩니다. 어느 쪽이든, 프로토타입은 여전히 같은 프로젝트 내에 생성되며 파일들은 prototypes/ 아래에 위치하게 됩니다. 나중에 계획 또는 빌드 세션으로 돌아와 프로토타입을 참조할 때, Cody는 그 발견 내용과 좋았던 점 및 싫었던 점(findings and the likes and dislikes)을 가져오기 위해 prototype.md를 읽습니다. 이 방법은 길거나 복잡한 프로토타입 탐색 과정을 메인 세션에서 분리하여 대화가 혼잡해지는 것을 방지하고 싶을 때 사용합니다.

어떤 경우든, prototype.md는 세션 간의 지속적인 연결고리(durable bridge)입니다. 같은 세션에서는 에이전트가 실시간 대화를 활용할 수 있고; 별도 세션에서는 prototype.md가 전달되는 유일한 요소이며, 이것이 바로 그 목적과 정확히 일치합니다.

형식: v[major.minor.patch]-[name]

예시: v1.0.3-refactor-code

• 시작 버전은 지정되지 않는 한 v0.1.0입니다 - 이름은 30자 이하, 소문자, 영숫자 및 -를 사용합니다.

• 지정하지 않으면 자동으로 버전 증가
  [name]

선택 사항입니다.

명령어는 다음 형식을 사용합니다: :cody [command]

이것을 설치하는 것입니다. Cody Product Builder는 단일하고 자체 포함된 Agent Skill 폴더입니다:

cody-product-builder/ # 스킬 폴더 (이것을 에이전트의 스킬 디렉터리에 복사하세요)
├── SKILL.md # 스킬 정의: 프론트매터(frontmatter)와 에이전트 지침 및 명령어 레지스트리
├── commands/ # 명령어 구현 파일
...

이 저장소에서, 스킬 폴더는 source/cody-product-builder/에 위치하며,
앱이 파일로부터 스킬을 설치하는 경우 패키징된 cody-product-builder.skill 파일(해당 폴더의 zip)은 저장소 루트에 있습니다.

Cody를 사용하기 시작하면, 다음 항목들이 사용자 프로젝트 내에 생성됩니다:

cody.json # 프로젝트 설정 (':cody plan' 실행 시 생성)
release-notes.md # 릴리스 노트 (위치는 cody.json의 releaseNotesPath로 구성 가능)
<project-path>/ # 사용자가 구성하는 출력 경로 (기본값: cody-projects/product-builder/)
...

Cody Product Builder는 Agent Skill입니다. 설치 방법은 두 가지가 있으며, 앱이 지원하는 방법을 사용하세요.

Claude.ai(데스크톱 또는 웹) 및 파일로부터 스킬을 설치하는 다른 모든 앱의 경우, 패키징된 스킬 파일을 사용하세요.

• 다운로드
  cody-product-builder.skill

리포지토리 루트(repository root)에서 다음 경로로 가져옵니다: https://github.com/ibuildwith-ai/cody-product-builder - cody-product-builder.skill 파일을 업로드하여 앱에 스킬(skill)로 추가합니다.
Claude.ai에서는 스킬 설정(skills settings)에서 이 작업을 수행할 수 있습니다. 다른 앱의 경우, 해당 앱이 제공하는 .skill 파일 추가 절차를 따르세요.

옵션 2: 스킬 폴더 (The skill folder)

(Claude Code, Cursor, GitHub Copilot, Codex 또는 .skill을 지원하지 않는 기타 에이전트의 경우)

스킬을 폴더에서 로드하는 코딩 에이전트의 경우, 해당 스킬 폴더를 에이전트의 스킬 디렉토리(skills directory)에 복사합니다.

• 다음 경로에서 Cody Product Builder를 클론하거나 다운로드합니다: https://github.com/ibuildwith-ai/cody-product-builder
• source/cody-product-builder/ 폴더를 에이전트의 스킬 디렉토리에 복사하되, 폴더 이름은 cody-product-builder로 유지합니다:
  Claude Code: .claude/skills/cody-product-builder/
  Cursor: .cursor/skills/cody-product-builder/
  GitHub Copilot: .github/skills/cody-product-builder/

프로젝트 내부에 있는 스킬 디렉토리는 해당 프로젝트에서만 Cody를 사용할 수 있게 합니다. 홈 폴더에 있는 스킬 디렉토리는 모든 프로젝트에서 Cody를 사용할 수 있게 합니다. 사용 중인 에이전트의 문서를 확인하여 정확히 지원되는 위치를 확인하세요.

설치 후, Cody Product Builder는 두 가지 방식으로 활성화됩니다:

자동으로(Automatically). 평범한 언어로 원하는 바를 설명합니다 (예:

그리고 전체 버전 빌드 주기(full version build cycle)를 거치지 않고도 가벼운 수정(lightweight fix)을 위해 패치 옵션(patch option)을 선택할 수 있습니다.

나중에 사용할 아이디어 캡처:
:cody idea [설명]

현재 작업 흐름을 방해하지 않으면서 백로그(backlog)에 저장할 수 있습니다. 새로운 버전이나 패치를 시작할 때, Cody는 백로그 항목들을 시작점으로 제시합니다.

프로토타입으로 아이디어 테스트:
:cody prototype

언제든지 임시 프로토타입(throwaway prototype)을 구축하고 아이디어를 테스트할 수 있습니다. 계획하거나 빌드할 때, Cody는 사용자가 요청하여 사용할 수 있도록 프로토타입들을 언급합니다.

기존 프로젝트 작업:
:cody refresh

Cody가 코드베이스를 분석하고 모든 계획 문서를 자동으로 생성하도록 한 다음, :cody build