ai-workspace-template

AI 에이전트가 아이디에이션 → 기획 → 디자인 → 개발 → 테스트 → 배포 흐름을 따라 일할 수 있도록 만든 보일러플레이트 모노레포입니다. Cursor 규칙·스킬, 문서 위치, 태스크 보드, 샘플 웹 앱이 한곳에 묶여 있습니다.

처음이신가요? (이 폴더를 방금 만들었다면)

npm create ai-workspace-template 으로 이 구조를 만든 경우, 스크립트가 이미 **pnpm install** 을 실행했을 수 있습니다. 문제가 없다면 아래부터 이어가면 됩니다.

SUPABASE_URL · SUPABASE_SECRET_KEY 만 채웁니다. Publishable(anon) 키는 사용하지 않습니다. (docs/architecture/env-template.md)

• Cursor를 쓴다면 이 폴더(프로젝트 루트)를 워크스페이스로 연 상태에서 작업하면 .cursor 규칙이 적용됩니다.

• 에이전트에게 맡길 일은 docs/project-concept.md 부터 채우고, 상세 가이드는 **AGENTS.md** 를 보세요.

이 템플릿이 제공하는 것

역할 기반 에이전트 워크플로우

에이전트를 기획자, 디자이너/개발자, 테스트, PM 등으로 나누고, 규칙과 스킬로 “언제 무엇을 할지”를 정해 두었습니다. “~ 하고 싶어”처럼 말하면 기획·태스크 단계로 이어지도록 설계되어 있습니다.

파일 기반 태스크 보드

tasks/board.json 과 tasks/items/*.md 만으로 보드를 운영합니다. 상태(pending → in_progress → in_test → done 등)와 handoff 로 인수인계를 남깁니다.

에이전트 피드백

스펙 불명확, 규칙 충돌, 블로커 등은 docs/feedback/ 에 기록하도록 안내합니다.

컨텍스트가 모이는 문서 위치

docs/specs/, docs/architecture/, docs/runbook/, design/ 등 경로가 고정되어 있어, 에이전트와 사람이 같은 곳을 보도록 했습니다.

웹 앱 (apps/web)

Next.js (App Router) + TypeScript + Vitest. Supabase는 서버 전용 — Route Handlers·Server Actions에서만 호출합니다. 배포는 Vercel + GitHub Integration (docs/runbook/runbook.md).

더 읽을 곳

• 에이전트 가이드: AGENTS.md
• 스택: docs/architecture/stack.md
• 설치·빌드·테스트: docs/runbook/runbook.md
• 태스크 보드 형식: tasks/README.md
• 피드백 채널: docs/feedback/README.md