Ag 6 Iniciar

INICIAR — Maquina Autonoma de Inicializacao

Pre-Flight Obrigatório (modo projeto)

ANTES de qualquer scaffolding, executar:

# 1. Carregar regras de stack no contexto (Read obrigatório)
Read ~/Claude/.claude/rules/stack-enforcement.md
Read ~/Claude/.claude/rules/package-manager.md
Read ~/Claude/.claude/rules/gha-minimal.md

# 2. Carregar design system Raiz (Read obrigatório se projeto tem UI)
Read ~/Claude/assets/design-library/UI_UX/raiz-educacao-design-system.md

# 3. Validar package manager
test -f bun.lock && PM=bun || PM=npm   # NUNCA pnpm sem ADR

Validações inegociáveis ANTES de scaffolding:

• [ ] PM = bun OU npm (não pnpm/yarn/turbo)
• [ ] Framework decidido (Next.js App Router | Vite + React | Astro)
• [ ] shadcn/ui no plano de instalação
• [ ] lucide-react no plano (NUNCA emojis em UI)
• [ ] IBM Plex Sans + Mono no plano de fontes
• [ ] Tokens Raiz mapeados em tailwind.config (#F7941D, #5BB5A2)
• [ ] Sentry SDK no plano
• [ ] Vitest + Playwright no plano
• [ ] NÃO gerar .github/workflows/ci.yml — Vercel CI cobre. Gerar .husky/pre-commit + vercel.json com buildCommand (ver gha-minimal.md)
• [ ] Workflow GHA SOMENTE se enquadra na whitelist W1-W4 de gha-minimal.md (com header JUSTIFICATIVA-GHA:)

Se usuário pediu lib FORA whitelist:

1. PARAR e perguntar: "X não está na whitelist Raiz. Justificativa? Criamos ADR?"
2. Se autorizado → criar docs/adr/-.md antes de instalar
3. NUNCA decidir sozinho

Invocacao

/iniciar projeto SaaS com Next.js + Supabase + Clerk
/iniciar ambiente ~/Claude/GitHub/example-platform
/iniciar explorar ~/Claude/GitHub/novo-repo
/iniciar pesquisar alternativas de auth

Inline Stack Decisions (Opus 4.7 ADR-0001 P1.2)

Stack approved (Vercel + Supabase first):

| Necessidade | Canonical | Plugin skill | Alternativa | |---|---|---|---| | Framework | Next.js 16 App Router | vercel:nextjs | — | | Auth | Supabase Auth | supabase:supabase | Clerk via vercel:auth (multi-org) | | DB | Supabase Postgres | supabase:supabase | Neon (branching) via vercel:vercel-storage | | Storage | Supabase Storage | supabase:supabase | Vercel Blob via vercel:vercel-storage | | Cache | Vercel Runtime Cache | vercel:runtime-cache | — | | Email | Resend | — | — | | Styling | Tailwind 4 + shadcn/ui | vercel:shadcn | — | | Forms | React Hook Form + Zod | — | — | | State | Server Components + Zustand | — | — | | AI (single provider) | AI SDK | vercel:ai-sdk | — | | AI (multi/failover) | AI Gateway | vercel:ai-gateway | — | | Chatbot multi-platform | Chat SDK | vercel:chat-sdk | — | | Workflow/durável | Workflow DevKit | vercel:workflow | — | | Charts | Recharts | — | — | | Testes unit | Vitest | — | — | | Testes E2E | Playwright (MCP) | — | — | | Monitoring | Sentry | sentry:sentry-sdk-setup | — | | Deploy | Vercel | vercel:deployments-cicd | Railway via railway:use-railway | | Env vars | Vercel CLI | vercel:env-vars | — |

Bibliotecas REJEITADAS: MongoDB, Firebase, Redux, MUI, Chakra, NextAuth, Prisma (novo projeto), Jest (novo projeto), Cypress.

NUNCA desviar sem ADR + aprovação do usuário.

Pre-Load: Stack Decisions + Design Library

ANTES de criar projeto novo ou pesquisar alternativas:

1. Stack obrigatório (inline acima; /ag-referencia-stack-decisions tem detalhes completos)

• Vercel + Supabase first — libs avulsas só quando plataforma nativa não resolve
• Template: Next.js 16 + Tailwind 4 + shadcn/ui + Zod + Supabase (Auth+DB+Storage)
• NUNCA desviar do stack aprovado sem ADR + aprovação do usuário

2. Design Library (example-catalog.vercel.app)

• Soluções (24 patterns): dashboard, workflow, chat, etc.
• Elementos UI (144): referências best-in-class
• Módulos funcionais (32): auth, LLM router, TOTVS sync, export engine, etc.
• Se solução/módulo existe → adaptar em vez de criar do zero

---

Modos

| Modo | Agent interno | O que faz | |------|--------------|-----------| | projeto | ag-criar-projeto + ag-preparar-ambiente | Scaffold + setup (consulta Design Library primeiro) | | ambiente | ag-preparar-ambiente | Dev environment (deps, env vars, dev server) | | explorar | ag-explorar-codigo | Mapear codebase (project-profile, findings) | | pesquisar | ag-pesquisar-referencia | Benchmarks e alternativas com trade-offs |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: andregusman-raiz
• Source: andregusman-raiz/a-gusman-claude
• License: MIT

Install and usage instructions live in the source repository linked above.