# Ag 6 Iniciar

> Maquina autonoma de inicializacao. Projeto novo, setup ambiente, explorar codebase, pesquisar alternativas — produz ambiente pronto para dev.

- **Type:** Skill
- **Install:** `agentstack add skill-andregusman-raiz-a-gusman-claude-ag-6-iniciar`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [andregusman-raiz](https://agentstack.voostack.com/s/andregusman-raiz)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [andregusman-raiz](https://github.com/andregusman-raiz)
- **Source:** https://github.com/andregusman-raiz/a-gusman-claude/tree/main/skills/ag-6-iniciar

## Install

```sh
agentstack add skill-andregusman-raiz-a-gusman-claude-ag-6-iniciar
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# INICIAR — Maquina Autonoma de Inicializacao

## Pre-Flight Obrigatório (modo `projeto`)

**ANTES de qualquer scaffolding, executar:**

```bash
# 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](https://github.com/andregusman-raiz)
- **Source:** [andregusman-raiz/a-gusman-claude](https://github.com/andregusman-raiz/a-gusman-claude)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-andregusman-raiz-a-gusman-claude-ag-6-iniciar
- Seller: https://agentstack.voostack.com/s/andregusman-raiz
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.