처음부터 프로젝트 스캐폴드

빈 디렉토리에서 실행되는 프로젝트로. 기술 스택과 규칙을 설명하면 OpenCode가 폴더 레이아웃, 설정 파일, 처음에 빌드되는 스타터를 생성합니다.

이 레시피를 사용하는 경우

• 새 프로젝트를 시작하고 합리적인 기본 구조를 원할 때.
• 팀의 규칙을 일관되게 적용하고 싶을 때.
• 즉시 빌드 및 실행되는 스타터를 원할 때.

전제 조건

• 비어 있거나 초기화된 git 저장소.
• OpenCode를 설치.

단계

1. 스택과 목표 설명

   기술, 규칙, “완료”의 의미를 구체적으로 전달합니다.

   TypeScript Node.js 서비스를 Fastify로 스캐폴드하세요. 라우트, 서비스, 설정을 분리한 src/ 레이아웃을 포함하세요. ESLint, Prettier, Vitest, 헬스 체크 라우트를 추가하세요. 프로젝트는 첫 실행에 빌드되어야 하고 헬스 체크가 통과해야 합니다.

2. 제안 구조 검토

   OpenCode는 먼저 트리를 보여줍니다. 파일을 쓰기 전에 조정합니다.

   src/
     routes/health.ts
     services/
     config/index.ts
     index.ts

3. 파일 생성

   OpenCode가 레이아웃, 설정, 보일러플레이트를 작성하게 합니다.

4. 빌드 검증

   npm install
   npm run build
   npm test

5. 베이스라인 커밋

   git add -A && git commit -m "chore: initial scaffold"

핵심 프롬프트

TypeScript Fastify 서비스를 만드세요. 레이아웃으로 src/routes, src/services, src/config를 사용하세요. ESLint + Prettier + Vitest, /health 라우트, env 기반 설정 로더를 추가하세요. npm install && npm run build가 오류 없이 성공하게 하세요.

흔한 주의점

• 모호한 사양: “웹 앱 만들어”는 일반적인 결과를 낳습니다——스택, 레이아웃, 성공 기준을 명시하세요.
• 성공 확인 누락: 프롬프트에 항상 빌드/테스트 명령을 포함하여 스캐폴드가 작성만 되지 않고 검증되게 합니다.
• 규칙 무시: 팀이 특정 패턴(기능 폴더 등)을 사용하면 명시하지 않으면 스캐폴드가 맞지 않습니다.

관련 문서

• 빠른 시작 — 새 프로젝트에서 몇 분 만에 OpenCode 실행
• 설정 — 프로젝트 레이아웃에 맞춘 opencode.json 설정

관련 레시피

• git-commit-workflow — reason.scaffold.to-git
• mcp-server — reason.scaffold.to-mcp
• custom-skill — reason.scaffold.to-skill

관련 문서

• 빠른 시작
• 설치
• 설정

다음 단계

• git-commit-workflow — next.scaffold.to-git