CodeGuide

CodeGuide란?

CodeGuide는 AI 코딩 도구를 위한 스펙 기반 컨텍스트 생성기입니다. 아이디어나 기존 GitHub 코드베이스를 PRD, 기술 스펙, 와이어프레임 같은 구조화된 프로젝트 문서로 변환해 AI 모델이 소프트웨어 구현 시 참조할 수 있게 합니다.

핵심 목적은 AI 지원 개발의 “블랙박스” 문제를 줄이는 것입니다. 설명부터 시작하든 레거시 레포를 확장하든, 계획과 문서화를 위한 명확한 컨텍스트를 가진 프로젝트 지식 베이스를 만듭니다.

주요 기능

스펙 기반 문서 생성 (일반 영어 입력): 프로젝트를 일반 영어로 설명하면 PRD, 기술 스택 가이드, 와이어프레임을 포함한 문서 키트를 생성합니다.
기존 GitHub 코드베이스 문서화: 기존 GitHub 프로젝트를 입력해 코드베이스를 매핑하면 AI 도구가 레포지토리 내용을 더 명확히 이해합니다.
AI 문서 워크플로 (명확화 질문 → 계획 → 문서): 프로젝트 개요를 제공하고 개방형 질문(예: 알림 동작, 온보딩, 기능 제약)에 답변해 결과 문서를 형성합니다.
Software v2 자율 코딩 에이전트: 코드베이스를 분석하고 문서를 계획하며 장기 세션에서 “자율”적으로 코딩 작업을 실행하는 에이전트를 사용합니다.
다중 CLI 도구/모델 라우팅 통합 인터페이스: 단일 인터페이스로 여러 AI 모델이 동기화되어 작동하며, 모델 라우터가 워크플로 각 부분에 적합한 모델을 선택합니다.
브라우저 기반 생성 Chrome 확장: 브라우저에서 직접 PRD, 기술 스펙, 문서를 생성합니다.
화면상 UI 에디터: 화면에서 편집하며 UI 수정이나 기능 추가를 위해 여러 에이전트를 병렬로 조정합니다.
설정 노력 최소화 스타터 키트: AI 코딩 모델용 오픈소스 보일러플레이트로 인증, 데이터베이스 설정, Stripe 결제 설정 등 일반 인프라를 포함합니다(템플릿 설명 참조).

CodeGuide 사용법

아이디어나 레포로 시작: 원하는 것을 일반 영어로 설명하거나 기존 GitHub 프로젝트를 지정합니다.
요청 시 프로젝트 질문에 답변: 명확화 질문을 통해 제품 동작과 제약을 지정합니다.
문서 키트 생성: 구현에 필요한 PRD, 기술 스펙, 와이어프레임, 관련 계획 산출물을 생성합니다.
실행 시 Software v2 사용: 코딩과 구현 단계로 넘어가면 자율 에이전트를 실행해 코드베이스를 분석하고 계획된 문서를 따릅니다.
선택적으로 Chrome 확장 사용: 브라우저 워크플로 내에서 PRD/기술 스펙/문서를 생성합니다.

사용 사례

앱 아이디어를 구현 준비 스펙으로 변환: 개발자가 앱 개념(예: 모바일 앱 vs. 웹사이트)을 설명하고 제품 동작 질문을 답변해 PRD, 기술 스펙, 와이어프레임을 얻습니다.
레거시 GitHub 레포를 AI 개발용 문서화: 해석 어려운 오래된 코드 작업 시 레포를 입력해 매핑된 AI 사용 가능 컨텍스트를 얻습니다.
AI 코딩 어시스턴트 사용 전 제품 요구사항 계획: 생성된 스펙을 구조화된 입력으로 사용해 AI 코딩 도구가 즉석 프롬프트 대신 명시적 요구사항 기반으로 기능을 구현합니다.
에이전트로 자율 코딩 작업 실행: Software v2를 사용해 통합 인터페이스에서 코드베이스 분석, 계획, 코딩 실행을 장기 세션으로 조정합니다.
UI를 반복적으로 개선/확장: 화면 에디터를 사용해 UI 문제를 수정하거나 기능을 추가하며 여러 에이전트를 병렬로 작동합니다.

FAQ

CodeGuide는 설명, 레포지토리, 또는 둘 다로부터 문서를 생성하나요?

CodeGuide는 둘 다 지원합니다: 일반 영어 아이디어로부터 문서를 생성할 수 있고, GitHub 코드베이스를 매핑해 AI 컨텍스트용 문서를 생성할 수 있습니다.

CodeGuide가 생성할 수 있는 문서 종류는 무엇인가요?

사이트에서 PRD, 기술 스펙, 와이어프레임을 주요 출력물로 설명하며, 프로젝트 브리프에 연계된 광범위한 “documentation kit”도 포함합니다.

Software v2란 무엇인가요?

Software v2는 코드베이스를 분석하고, 문서를 계획하며, 코드를 실행하는 자율 코딩 에이전트로 설명되며, 통합 인터페이스와 여러 모델이 동기화됩니다.

이 제품이 AI 환각을 어떻게 도와주나요?

사이트는 프로젝트 지식 베이스와 구조화된 스펙/컨텍스트를 만들어 AI 모델이 참조할 수 있게 함으로써, 누락되거나 불명확한 컨텍스트로 인한 “추측”을 줄이는 접근으로 설명합니다.

메인 앱 외부에서 CodeGuide를 사용할 도구가 있나요?

네. 사이트에서 브라우저에서 직접 PRD, 기술 스펙, 문서를 생성하는 Chrome 확장 프로그램을 언급합니다.

대안

수동 PRD/기술 스펙 작성 + AI 코딩 어시스턴트: 문서를 직접(또는 일반 AI 채팅으로) 작성한 후 코딩 도구에 제공; 레포지토리 매핑과 구조화된 생성 워크플로 대신 사용자 작성 스펙에 의존합니다.
범용 AI 코딩 코파일럿: 코드 생성과 리팩토링에 초점을 맞춘 도구들은 여기 설명된 엔드투엔드 문서 키트(PRD/기술 스펙/와이어프레임)나 레포지토리 매핑을 제공하지 않을 수 있습니다.
문서 우선 코드베이스 분석 도구: 소스 코드로부터 문서를 생성하는 접근(스펙/PRD 워크플로 없이)은 이해에 도움이 되지만, 제품 요구사항에 연계된 동일한 계획 산출물을 생성하지 않을 수 있습니다.
별도 계획과 함께 스타터 템플릿/보일러플레이트 사용: 보일러플레이트는 설정 시간을 줄일 수 있지만, AI 코딩 워크플로용 PRD/기술 스펙/와이어프레임을 생성하는 별도 프로세스가 필요합니다.