Guia de Criação de Projeto

Este guia acompanha você na configuração de um novo projeto com Claude-Craft.

---

Escolher Sua Tecnologia

Tecnologia	Ideal Para	Arquitetura
Symfony	APIs backend, Apps web	Clean Architecture + DDD
Flutter	Apps móveis	Feature-based + BLoC
Python	APIs, Serviços de dados	Arquitetura em camadas
React	SPAs web	Feature-based + Hooks
React Native	Móvel multiplataforma	Baseado em navegação

---

Métodos de Instalação

Método 1: Makefile (Recomendado)

make install-{tecnologia} TARGET=caminho LANG=idioma

# Exemplos
make install-symfony TARGET=./backend LANG=pt
make install-flutter TARGET=./mobile LANG=pt

Opções

OPTIONS="--dry-run"      # Pré-visualização sem alterações
OPTIONS="--force"        # Sobrescrever arquivos
OPTIONS="--backup"       # Criar backup
OPTIONS="--interactive"  # Modo interativo
OPTIONS="--update"       # Apenas atualizar

Método 2: Script Direto

./Dev/scripts/install-symfony-rules.sh --lang=pt ~/meu-projeto

Método 3: Configuração YAML

# claude-projects.yaml
settings:
  default_lang: "pt"

projects:
  - name: "minha-plataforma"
    path: "~/Projetos/minha-plataforma"
    modules:
      - name: "api"
        path: "backend"
        technologies: ["symfony"]
      - name: "mobile"
        path: "app"
        technologies: ["flutter"]

make config-install CONFIG=claude-projects.yaml PROJECT=minha-plataforma

---

Projetos Mono-Tecnologia

Projeto Symfony

mkdir ~/minha-api && cd ~/minha-api && git init
make install-symfony TARGET=. LANG=pt

Projeto Flutter

flutter create minha_app && cd minha_app && git init
make install-flutter TARGET=. LANG=pt

Projeto Python

mkdir ~/minha-api-python && cd ~/minha-api-python && git init
make install-python TARGET=. LANG=pt

---

Configuração Pós-Instalação

1. Contexto do Projeto (rules/00-project-context.md)

Este é o arquivo mais importante para personalizar.

Opção A: Configuração Interativa (Recomendada)

Execute este comando no Claude Code para detectar sua stack e responder perguntas direcionadas:

/common:setup-project-context

Opção B: Configuração Manual

Edite o arquivo diretamente com os detalhes do seu projeto:

# Contexto do Projeto

## Informações
- **Nome**: Minha API E-commerce
- **Tipo**: API REST para plataforma e-commerce

## Stack Técnico
- PHP 8.3 com Symfony 7.0
- PostgreSQL 16
- Redis para cache

## Convenções
- Código em inglês, documentação em português

2. Configuração Principal (CLAUDE.md)

Revisar e ajustar:

• Configuração de idioma
• Requisitos de arquitetura
• Requisitos de qualidade
• Requisitos Docker

---

Checklist de Início

Pré-Instalação

• [ ] Diretório do projeto criado
• [ ] Repositório Git inicializado
• [ ] Stack tecnológico decidido

Instalação

• [ ] Regras Claude-Craft instaladas
• [ ] Instalação verificada (ls .claude/)

Configuração

• [ ] 00-project-context.md personalizado
• [ ] CLAUDE.md revisado

Verificação

• [ ] Claude Code iniciado no diretório
• [ ] Comandos disponíveis
• [ ] Agentes respondendo

---

← Primeiros Passos | Desenvolvimento de Features →