# Ag Criar Projeto

> Scaffolding completo: estrutura de pastas, configs, .env.example, CI base, README. Projeto nasce agent-ready.

- **Type:** Skill
- **Install:** `agentstack add skill-andregusman-raiz-a-gusman-claude-ag-criar-projeto`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [andregusman-raiz](https://agentstack.voostack.com/s/andregusman-raiz)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **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-criar-projeto

## Install

```sh
agentstack add skill-andregusman-raiz-a-gusman-claude-ag-criar-projeto
```

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

## About

## Pre-check
- **Templates disponiveis**: !`ls ~/.claude/shared/templates/ 2>/dev/null | tr '\n' ', '`

# ag-criar-projeto — Iniciar Projeto

## Quem você é

O Fundador. Gera scaffolding completo: estrutura de pastas, configs (eslint,
prettier, tsconfig), .env.example, gitignore, CI base, README.

## Modos

```
/ag-criar-projeto → Modo interativo (pergunta tipo, stack)
/ag-criar-projeto [stack] [nome] → Direto com defaults inteligentes
```

## Pre-Flight Obrigatório (gha-minimal)

ANTES de gerar QUALQUER `.github/workflows/*.yml`, ler:

```bash
Read ~/Claude/.claude/rules/gha-minimal.md
```

**Default:** projeto novo NÃO recebe `.github/workflows/ci.yml`. Vercel CI cobre typecheck/lint/test em PRs.

GHA só se enquadra na whitelist W1-W4 de `gha-minimal.md` (TOTVS/MSSQL legacy, CLI release multi-OS, VPS self-hosted, DB-first PR gate). Caso aplicável, header obrigatório no YAML:

```yaml
# JUSTIFICATIVA-GHA:  — 
# ALTERNATIVA-DESCARTADA: 
```

## Shared Layer (OBRIGATORIO)

Antes de gerar qualquer scaffolding, copiar templates de `~/.claude/shared/`:

```bash
# 1. Templates de roadmap
cp -r ~/.claude/shared/templates/roadmap/ /roadmap/templates/

# 2. Templates de E2E (se projeto tem testes)
mkdir -p /tests/e2e/shared/
cp -r ~/.claude/shared/templates/e2e/ /tests/e2e/shared/

# 3. CI: NÃO copiar ci-workflows/ por default — Vercel CI cobre.
#    Em vez disso, gerar localmente:
#    - .husky/pre-commit (typecheck + lint via lint-staged)
#    - vercel.json com buildCommand: "bun run check && bun run build"
#    - package.json script "check": "bun run typecheck && bun run lint && bun run test"
#    Só copiar templates GHA se enquadrar W1-W4 de gha-minimal.md

# 4. Templates de database (se Supabase)
cp -r ~/.claude/shared/templates/database/ /supabase/templates/

# 5. Templates de projeto
cp ~/.claude/shared/templates/project-init/CLAUDE.template.md /CLAUDE.md
cp ~/.claude/shared/templates/project-init/.env.template /.env.example
cp ~/.claude/shared/templates/project-init/tsconfig.template.json /tsconfig.json

# 6. Roadmap inicial
cp ~/.claude/shared/templates/roadmap/backlog.template.md /roadmap/backlog.md
```

Apos copiar, customizar cada arquivo para o projeto especifico.
Patterns em `~/.claude/shared/patterns/` e gotchas em `~/.claude/shared/gotchas/` sao referencia (nao copiados).

## O que gera

- Estrutura de pastas baseada nas convenções da stack
- Configs completas (linter, formatter, types)
- `.env.example` documentado
- `.gitignore` apropriado
- `README.md` com seção de setup (incluir nota: "CI roda em Vercel — para gates locais: `bun run check`")
- `docs/ai-state/` pré-populado com project-profile.json
- `roadmap/` pre-populado com templates do .shared/
- `tests/e2e/shared/` com base fixtures do .shared/
- `.husky/pre-commit` + `vercel.json` (NÃO `.github/workflows/ci.yml` por default)
- Git inicializado com primeiro commit

## Knowledge Search Setup

Ao criar o scaffolding, incluir automaticamente:

1. **`knowledge-config.json`** na raiz (copiar de `~/.claude/mcp/knowledge-search/knowledge-config.template.json`)
   - Default: indexa `docs/**/*.md` + `*.md`

2. **`.mcp.json`** incluir o knowledge server:
   ```json
   {
     "mcpServers": {
       "knowledge": {
         "command": "python",
         "args": ["~/.claude/mcp/knowledge-search/server.py"],
         "env": { "KNOWLEDGE_DB": "/knowledge.db" }
       }
     }
   }
   ```

3. **`.gitignore`** incluir `knowledge.db` (gerado, nao versionado)

## Quality Gate

- `bun run dev` (ou equivalente) funciona logo apos scaffold?
- README permite setup em 10 minutos?
- Nenhum secret hardcoded nos configs?
- knowledge-config.json criado?
- .mcp.json inclui knowledge server?
- knowledge.db no .gitignore?

Se algum falha → PARAR. Corrigir antes de prosseguir.

## 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:** yes
- **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-criar-projeto
- 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%.