🚀 DevSquad

Agente de IA para inicializar, arquitetar e documentar sistemas profissionais — direto do Claude Code.

DevSquad é um framework de Agent Skills compatível com o padrão oficial da Anthropic, construído para o stack NestJS + React + PostgreSQL. Funciona como um tech lead sênior que guia desde a primeira decisão arquitetural até o primeiro deploy — e permanece como guia de referência durante todo o desenvolvimento.

✨ O que o DevSquad faz

• 🧱 Onboarding estruturado — 10 perguntas antes de gerar qualquer coisa
• 🏗️ Scaffolding inteligente — estrutura DDD pronta, configs e código base
• 📝 Documentação completa — README, ARCHITECTURE, CONTRIBUTING, Postman Collection
• 🌿 Git Flow profissional — commits semânticos, branching, PR templates, Husky
• 🔒 Segurança por padrão — OWASP Top 10 em cada decisão
• 🗂️ Tasks no ClickUp — backlog organizado por sprint automaticamente
• 🎨 Tokens do Figma — extração para TailwindCSS
• 📚 Guia vivo — explica o porquê de cada decisão (aprender enquanto constrói)

🛠️ Stack

| Camada | Tecnologia | |--------|-----------| | Backend | NestJS + Prisma + PostgreSQL | | Frontend | React + TypeScript + TailwindCSS | | Mobile | React Native + Expo + NativeWind | | Auth | JWT (Access 15min + Refresh 7d) | | Segurança | OWASP Top 10 | | Versionamento | Git Flow + Conventional Commits |

⚡ Instalação

Pré-requisito: Claude Code instalado.

# Substitua pela URL do seu fork ou clone local
git clone <URL_DO_REPOSITORIO> devsquad
cd devsquad
cp -r .claude /caminho/do/seu-projeto/
cp CLAUDE.md /caminho/do/seu-projeto/

Ou use como referência global adicionando ao ~/.claude/CLAUDE.md.

🚀 Como usar

No Claude Code, dentro do seu projeto:

/devsquad init          → Onboarding completo (10 perguntas)
/devsquad backend       → Setup NestJS + Prisma + JWT
/devsquad frontend      → Setup React + TS + Tailwind
/devsquad mobile        → Setup React Native + Expo
/devsquad git           → Git Flow + commits semânticos
/devsquad security      → Checklist OWASP
/devsquad database      → Prisma + PostgreSQL
/devsquad postman       → Postman Collection
/devsquad docs          → Templates de documentação
/devsquad clickup       → Tasks e sprints
/devsquad figma         → Tokens de design

📁 Estrutura deste repositório

Este pacote contém Agent Skills e o CLAUDE.md. O scaffolding (pastas backend/, frontend/, ARCHITECTURE.md, etc.) é gerado pelo Claude Code durante o onboarding (/devsquad init), não é versionado aqui.

devsquad/
├── CLAUDE.md                      ← Instruções universais (enxuto)
├── README.md
├── LICENSE
└── .claude/
    └── skills/                    ← Padrão oficial Anthropic Agent Skills
        ├── nestjs/
        │   ├── SKILL.md
        │   ├── setup.md
        │   ├── auth.md
        │   ├── modules.md
        │   └── security.md
        ├── react/
        │   ├── SKILL.md
        │   └── setup.md
        ├── react-native/
        │   ├── SKILL.md
        │   └── setup.md
        ├── git/SKILL.md
        ├── security/SKILL.md
        ├── database/SKILL.md
        ├── postman/SKILL.md
        ├── docs/
        │   ├── SKILL.md
        │   └── templates.md
        ├── security/
        │   ├── SKILL.md
        │   └── owasp-full.md
        ├── clickup/SKILL.md
        └── figma/SKILL.md

🧠 Progressive Disclosure

O DevSquad segue o padrão oficial de Agent Skills da Anthropic:

1. Nível 1 — CLAUDE.md: regras universais sempre carregadas (enxuto)
2. Nível 2 — SKILL.md: frontmatter + overview da skill (carregado sob demanda)
3. Nível 3 — setup.md, auth.md, etc.: detalhes carregados conforme necessário

Isso mantém o contexto limpo e relevante para cada tarefa.

🤝 Contribuindo

git checkout -b feature/nova-skill-stripe
git commit -m "feat(skills): adicionar skill de integração Stripe"

📄 Licença

MIT — veja o arquivo LICENSE.