Communitygithub.com

samarv/Shanon

AI 네이티브 제품 구축을 위한 프레임워크로, 신규 애플리케이션을 신속하게 개발, 프로토타이핑, 배포합니다. 그린필드 앱 생성, 고충실도 프로토타입 제작, 내부 도구 개발 병목 현상 해소 시 사용하세요.

Shanon란 무엇인가요?

Shanon은 Product Manager(PM)가 요구사항 문서를 작성하는 대신 AI 에이전트를 직접 지시하여 소프트웨어를 구축하게 함으로써 개발 시간을 수개월에서 수주로, 비용을 최대 99%까지 절감하는 AI 네이티브 제품 구축 방법론입니다. 이 스킬은 'JIRA-Prompt'라는 핵심 프레임워크를 중심으로 구성되어 있으며, PM이 AI 에이전트(Bolt, Cursor 등)와 상호작용할 때 마치 시니어 개발자에게 고품질 티켓을 작성하듯 정확한 지시를 내리는 방법을 가르칩니다. 특히 기술 범위 정의(핵심 기능, 스택, 데이터 컨텍스트), 명세와 감성의 균형(비즈니스 로직은 구체적으로, UI/UX는 감성적으로), 반복적 디버깅(스크린샷 기반 수정, 3회 실패 시 휴먼-인-더-루프)의 세 단계를 상세히 설명합니다. 또한 Figma 디자인에서 코드 추출, 라이브 프로토타이핑, 원클릭 배포까지의 전체 워크플로우를 제공하며, 레거시 코드 마이그레이션 회피, 과도한 초기 프롬프트 금지, 환경 부트 완료 확인 등 실제 사용 시 흔한 함정을 피하는 방법도 알려줍니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samarv/Shanon/tree/HEAD/.claude/skills/ai-native-product-building

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

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

문서

AI 네이티브 제품 구축은 Product Manager(PM)의 역할을 타인을 위한 요구사항 작성에서 AI 에이전트를 직접 지시하는 방향으로 전환합니다. 이 접근 방식은 개발 기간을 수개월에서 수주로 단축하고 비용을 최대 99%까지 절감합니다.

"JIRA-Prompt" 프레임워크

AI 에이전트(Bolt 등)와의 모든 상호작용을 시니어 개발자를 위한 고품질 티켓을 작성하는 것처럼 처리합니다.

1. 기술 범위 정의

일반적인 설명 대신 AI가 환경을 구성하는 데 필요한 구체적인 매개변수를 제공합니다:

  • 핵심 기능 식별: "스트리밍, 재생목록, MP3 파일 지원이 포함된 Spotify 클론을 만드세요."
  • 스택 지정: 원하는 통합을 명시합니다(예: "데이터베이스는 Supabase, 호스팅은 Netlify 사용").
  • 데이터 컨텍스트 제공: 원시 데이터(예: LinkedIn 소개, CSV 행, 브랜드 가이드라인)를 프롬프트에 직접 붙여넣어 AI에 컨텍스트를 제공합니다.

2. 명세와 "감성"의 균형 맞추기

AI 에이전트는 엄격한 요구사항과 창의적 자유가 혼합될 때 최상의 성능을 발휘합니다.

  • 높은 구체성: 비즈니스 로직, 데이터 스키마, 사용자 흐름에 사용합니다.
  • "감성" 프롬프트: UI/UX의 경우, 특정 CSS 대신 설명적인 언어를 사용합니다.
    • 예시: "고급 의료 기부 사이트처럼 보이게 만드세요—깔끔하고 전문적이며 신뢰감이 있어야 함."
    • 예시: "더 예쁘고 현대적으로 만드세요."

3. 반복적 디버깅 구현

AI가 막히거나 오류가 발생한 경우:

  • 스크린샷 디버깅: UI 문제 또는 오류 메시지의 스크린샷을 업로드하고 "의도된 디자인에 맞게 수정하세요"라고 요청합니다.
  • "해결" 프로토콜: 특정 로직 문제에서 AI가 3회 이상 실패하면 휴먼-인-더-루프 접근 방식으로 전환합니다. 전문가나 개발자에게 문의하여 해당 특정 "구석"을 수정하는 동안 AI가 전체 코드베이스의 주도권을 유지하도록 합니다.

워크플로우: Figma에서 배포까지

1단계: 디자인 추출

직접 URL 방식을 사용하여 정적 디자인을 코드로 변환합니다:

  • Figma 디자인 URL을 가져옵니다.
  • AI 도구의 URL을 앞에 붙입니다(예: bolt.new/[FIGMA_URL]).
  • 에이전트가 자산과 레이아웃을 "흡수"하여 초기 환경을 생성하도록 합니다.

2단계: 라이브 프로토타이핑

Figma에서 프레임을 드래그하는 대신 기능 변경을 프롬프트합니다:

  • "Supabase Auth를 사용한 로그인 페이지를 추가하세요."
  • "사용자 테이블에서 데이터를 가져오는 대시보드를 만드세요."
  • QR 코드 미리보기를 사용하여 실제 기기에서 앱을 실시간으로 테스트합니다.

3단계: 원클릭 배포

앱을 즉시 프로덕션 URL로 이동합니다:

  • "배포"를 클릭합니다.
  • 호스팅 제공업체(Netlify/Vercel)에 연결합니다.
  • 맞춤 도메인을 연결하여 프로토타입을 라이브 비즈니스로 전환합니다.

예시

예시 1: "제로-투-마켓" CRM

  • 컨텍스트: 창업자가 Stripe 청구 기능이 포함된 맞춤형 CRM이 필요하지만 $30,000 에이전시 예산이 없습니다.
  • 입력: "부동산 중개인을 위한 CRM을 구축하세요. 리드 추적, 월간 구독을 위한 Stripe 통합, AI 기반 이메일 초안 작성기를 포함하세요. 깔끔하고 파란색 테마의 UI를 사용하세요."
  • 적용: Bolt를 사용하여 기본 앱을 생성합니다. '마지막 연락 날짜' 열을 추가하세요"와 "Stripe 테스트 키를 통합하세요"라고 말하며 반복합니다.
  • 출력: 3주 만에 약 $300의 추론 비용으로 구축된 기능적이고 수익을 창출하는 SaaS 제품.

예시 2: 신속한 마케팅 랜딩 페이지

  • 컨텍스트: PM이 새로운 기능 실험을 위한 랜딩 페이지가 필요합니다.
  • 입력: [LinkedIn 소개/브랜드 사양 붙여넣기] + "개인 포트폴리오 사이트를 만드세요. 전문적인 다크 모드를 사용하세요. 쉽게 편집할 수 있는 '현재 프로젝트' 섹션을 추가하세요."
  • 적용: 사이트를 생성한 후 "항목을 내 이메일로 보내는 연락처 양식을 추가하세요"라고 프롬프트합니다.
  • 출력: 10분 이내에 트래픽 수신 준비가 완료된 라이브 호스팅 URL.

일반적인 함정

  • 레거시 코드 마이그레이션: 20년 된 수천 개의 파일로 구성된 프로덕션 코드베이스를 브라우저 기반 AI 에이전트로 옮기려고 시도하지 마세요. 이러한 도구는 그린필드 프로젝트나 관리자 패널 및 마케팅 사이트와 같은 격리된 "포드"에 사용하세요.
  • 첫 번째 초안에 과도한 프롬프팅: 첫 번째 버전에 5페이지 분량의 프롬프트를 작성하지 마세요. "Spotify 클론" 기본에서 시작하여 AI가 혼동하지 않도록 기능을 하나씩 추가하세요.
  • 결정론 무시: 코드는 결정론적입니다. 즉, 실행되거나 실행되지 않습니다. AI가 깨진 앱을 생성한 경우, 코드가 잘못되었다고 가정하기 전에 환경(WebContainer) 부팅이 완료되었는지 확인하세요.
  • 디자이너로만 취급: UI에만 사용하지 마세요. "풀 스택"(데이터베이스, 인증, API) 구축 능력을 활용하여 프로토타입이 단순한 고충실도 목업이 아니라 실제로 기능하도록 하세요.

관련 스킬