# Agent Scaffold

> ---

- Skill: `kaualealz/agent-scaffold` (Agent Skill, multi-file: 46 files)
- Install (CLI): `npx skillmds@latest add kaualealz/agent-scaffold`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kaualealz/agent-scaffold/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: KauaLealz (https://skillmd.com/u/kaualealz)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/kaualealz/agent-scaffold

---

---
name: bootstrap-agent-scaffold
description: >-
  Bootstraps agents/: guidelines (always/conditional), reference/, workflows/
  with per-service activities. No use-cases.md or use-cases/ folder.
disable-model-invocation: true
---

# Bootstrap agents scaffold

## Princípios

1. Inferir da codebase; confirmar com usuário (blocos 1–10)
2. **Atividades do dia a dia** → `workflows/services/<s>/{explore,new-feature,fix-bug}.md`
3. `guidelines/always/` = agente + código invariante; `guidelines/conditional/` = back, permissions, i18n…
4. `reference/` = projeto, integrações, structure por serviço
5. ≥2 serviços → `workflows/cross-service.md`
6. Skills: **`use-agent-scaffold`** + **`improve-agent-scaffold`**

## Fluxo

```
- [ ] 0. Varredura (atividades por serviço)
- [ ] 1. Sondagem 1–10
- [ ] 2. Síntese + “pode gerar?”
- [ ] 3. Gerar agents/ (guidelines + reference + workflows)
- [ ] 4. IDE + skills
- [ ] 5. Validação
```

### Bloco 9 (crítico)

Atividades por serviço em `workflows/services/<s>/` — **não** `use-cases/`.

### Contrato

| Item | Uso |
|------|-----|
| `use-agent-scaffold` | `guidelines/always` + workflow + conditional se indicado |
| `improve-agent-scaffold` | Evoluir harness |
| `guidelines/conditional/permissions.md` | Features com auth |
| `guidelines/conditional/i18n-frontend.md` | UI com texto |

## Recursos

[discovery.md](discovery.md) · [structure-spec.md](structure-spec.md) · [templates/](templates/)