아카이브 / 개발

vibe-coding-docs — 바이브코딩 문서 템플릿 세트

유형개발

기간2026.02

역할기획·문서 작성

구분개인 프로젝트

형식Markdown 문서 (실행 코드 없음)

목차 — 프로젝트 요약 · 담당 범위 · 문제와 구현 접근 · 이 작업에서 한 일 · 결과물과 원문 · 구현 상세

프로젝트 요약

AI 보조 개발(바이브코딩)에서 AI 에이전트가 읽고 따를 수 있도록 PRD부터 ADR, CLAUDE.md·AGENTS.md, API 계약서, 테스트 명세까지 한 흐름으로 묶은 한국어 템플릿 모음.

담당 범위

기획·문서 작성을 맡은 개인 프로젝트다. 공개 저장소에 템플릿과 사용 가이드를 남겼다.

문제와 구현 접근

PRD, CLAUDE.md, 프랙탈 구조의 AGENTS.md, ADR, API 계약서, TDD 테스트 명세, 실전 사용 가이드로 구성했다.

PRD(방향 설정) → ADR(기술 결정) → CLAUDE.md·AGENTS.md → API 계약서·테스트 명세 → 구현으로 이어지는 문서 위계를 정의하고, 템플릿마다 작성 가이드와 채워진 예시(사용자 CRUD API, Zustand 상태 관리 ADR, 인증 함수 테스트 명세)를 넣었다.

Claude Code 공식 가이드와 oh-my-claudecode, oh-my-opencode, OpenClaw의 코드 분석을 바탕으로 정리했다. 실행 코드 없이 Markdown 문서만 담았다.

이 작업에서 한 일

AI 에이전트가 읽고 따를 문서의 순서와 역할을 정하고, 템플릿을 에이전트에게 주어 프로젝트에 맞게 채우게 하는 사용법까지 정리했다.

결과물과 원문

관련 등록공보·논문·저장소는 아래 링크에서 볼 수 있다.

GitHub 원문 보기 ↗

구현 상세

README공개 저장소의 구조·기능·실행 문서

Vibe Coding Docs

AI 보조 개발(바이브코딩)을 위한 방법론 템플릿 세트입니다.

PRD부터 ADR, CLAUDE.md/AGENTS.md, API 계약서, 테스트 명세까지 AI 에이전트가 읽고 따를 수 있는 문서를 한 흐름으로 묶었습니다. 각 템플릿에는 작성 가이드와 채워진 예시(사용자 CRUD API, Zustand 상태 관리 ADR, 인증 함수 테스트 명세 등)가 함께 들어 있습니다.

문서 구성

문서	용도	작성 시점
PRD_TEMPLATE.md	요구사항 정의	프로젝트 시작 전
CLAUDE_MD_TEMPLATE.md	AI 지시사항 (150줄 이내)	코딩 시작 전
AGENTS_MD_TEMPLATE.md	프로젝트 맵 (프랙탈 구조)	구조 확정 후
ADR_TEMPLATE.md	기술 결정 기록	기술 선택 시
API_CONTRACT_TEMPLATE.md	API 인터페이스 계약	모듈/API 설계 시
TEST_SPEC_TEMPLATE.md	TDD 테스트 명세	구현 직전
USAGE_GUIDE.md	실전 사용법 + 프롬프트 예시	참고용

문서 위계

PRD (방향 설정)
  → ADR (기술 결정)
    → CLAUDE.md (AI 지시사항) + AGENTS.md (프로젝트 맵)
      → API 계약서 + 테스트 명세 (반복)
        → 구현

사용법

AI에게 템플릿을 주고 프로젝트에 맞게 채워달라고 요청하면 됩니다.

"@PRD_TEMPLATE.md 를 참고해서 [프로젝트 설명]에 대한 PRD를 작성해줘"

자세한 사용법은 USAGE_GUIDE.md를 참조하세요.

기반 분석

Claude Code 공식 가이드
oh-my-claudecode 코드 분석
oh-my-opencode 코드 분석
OpenClaw 코드 분석

참고 사항

실행 코드 없이 Markdown 문서만 담고 있습니다. 설치나 빌드 과정은 없습니다.
예시는 TypeScript 기반 웹 프로젝트(React, Zustand, Vitest, pnpm 등)를 가정합니다. 다른 스택에서는 해당 부분을 바꿔 쓰세요.
예시에 나오는 이름, 이메일, 전화번호, 주소는 모두 가상의 값입니다.

GitHub에서 최신 문서 보기 ↗