ahtserhsuddav/project-setup

프로젝트 설정

모든 단계는 해당 도구의 공식 CLI 또는 문서(스킬 official-docs)를 사용합니다. 원격 작업은 먼저 물어보세요.

방금 생성한 경우 (CLI가 이미 스캐폴딩, 설치, 확인을 모두 마친 상태)

1. PROJECT.md를 읽고 What(이름, 도메인, 유형, 목적)을 사람의 말로 그대로 채우세요. {{#dotenv}}
2. 사람이 .env.example을 .env로 복사하여 채웁니다{{#auth}} ({{dlx}} auth@latest secret으로 인증 시크릿 생성){{/auth}}. 에이전트는 절대 .env를 생성, 읽기, 쓰기하지 않습니다. .env가 존재할 때까지는 해당 명령에만 일회용 값으로 테스트하세요. {{/dotenv}} {{#postgres}}
3. 로컬 데이터베이스: docker compose up -d, 그 다음 {{run}} db:migrate (먼저 물어보세요). {{/postgres}} {{#d1}}
4. 로컬 데이터베이스: {{run}} db:migrate (먼저 물어보세요). {{/d1}}
5. {{run}} docs:sync, 그 다음 docs/DEPLOYMENT.md 채우기 (URL, 시크릿 설정 위치). {{#cloudflare}} 리소스가 생성되면 (DEPLOYMENT.md → 첫 설정) wrangler.jsonc의 플레이스홀더 ID를 교체하세요. {{/cloudflare}}
6. design/DESIGN.md는 website-design 스킬을 위해 남겨두세요. 이 스킬은 첫 페이지 전에 디자인 입력을 순서대로 수집합니다. 홈 페이지는 플레이스홀더입니다.
7. 저장소가 GitHub에 올라가면, 사람이 Settings → Actions → General → "Allow GitHub Actions to create and approve pull requests"를 켜서 주간 에이전트 스킬 업데이트가 PR을 열 수 있도록 합니다. Dependabot 및 워크플로 변경: 스킬 dependabot 및 github-actions-hardening.
8. {{run}} log "Project set up" --by <agent>.

기존 프로젝트 (키트 적용)

1. {{dlx}} create-agent-ready-app@latest install .는 에이전트 설정(AGENTS.md, 스킬, 스크립트, 가드레일)만 추가합니다. package.json에서 애드온을 감지합니다. 기존 AGENTS.md, CLAUDE.md, .cursorrules 및 유사 파일은 docs/legacy-agents.md로 이동합니다: 여전히 적용되는 규칙은 PROJECT.md → Rules for agents로 접은 다음 파일을 삭제하세요(먼저 물어보세요).
2. PROJECT.md를 기존 내용(package.json, 라우트, 빠른 폴더 목록)으로 채우세요. 깊이 탐색하지 마세요.
3. 구조를 변경하지 마세요. 발견된 차이점(구조, 검사, SEO, 보안)을 하나의 제안된 Big task로 나열하고 물어보세요.

나중에 애드온 추가 (보호됨)

1. 한 가지 예/아니오 질문을 하세요: 애드온, 추가할 패키지, 생성할 파일.
2. {{dlx}} create-agent-ready-app@latest add <add-on> .는 아직 존재하지 않는 애드온 파일을 생성하고, AGENTS.md와 스킬을 새로고침하며, 스킬 팩을 설치하고, 추가할 패키지를 출력합니다.
3. {{add}} 그 패키지들을 추가하세요. 그런 다음 프로젝트가 이미 소유한 파일에 연결하세요. create-agent-ready-app 저장소의 애드온 파일(template/frameworks/)과 공식 문서를 따르세요:
   • query: {{#tanstack-start}}src/router.tsx (QueryClient + SSR 통합) 및 src/routes/__root.tsx (devtools 패널){{/tanstack-start}}{{#next}}src/shared/lib/tanstack/query-provider.tsx를 src/app/layout.tsx에{{/next}};
   • shadcn: {{dlx}} shadcn@latest apply --preset nova, 그 다음 필요한 컴포넌트를 add;
   • auth: {{#tanstack-start}}src/routes/_private/{{/tanstack-start}}{{#next}}src/app/(private)/{{/next}} 아래의 가드와 {{run}} auth:generate, 그 다음 {{run}} db:generate.
4. {{run}} docs:sync, {{run}} check, PROJECT.md → Stack and Decisions 업데이트, 로그 라인 추가.

애드온 제거 (보호됨)

{{dlx}} create-agent-ready-app@latest remove <add-on> .는 키트 파일, 스킬, 스크립트 및 권한을 제거합니다. 코드와 패키지를 삭제하는 것은 Big task입니다: rg로 모든 사용처를 찾고, 삭제한 다음 {{run}} check.

에이전트 스킬

• .agents/skills/의 커뮤니티 스킬은 제작자가 제공합니다(skills-lock.json에 각 출처와 해시가 기록됨). {{run}} skills:update로 업데이트합니다. 다른 코드 변경과 마찬가지로 커밋 전에 diff를 읽으세요.
• 더 많은 스킬: 도구 제작자의 공식 스킬(https://www.skills.sh/official)을 선호하세요. 스킬 find-skills 또는 {{dlx}} skills@latest add <owner/repo> --skill <name> -a universal -a claude-code (먼저 물어보세요). 선택적 키트 팩: {{dlx}} create-agent-ready-app@latest add <pack> . (마케팅, 보안 검토…).

키트 업데이트

{{run}} kit:update는 AGENTS.md, 스킬 및 스크립트를 업데이트합니다. 이 프로젝트에서 변경된 키트 파일은 유지되고 보고됩니다. 키트 파일을 편집하는 대신 프로젝트별 규칙은 PROJECT.md에 넣으세요.