ribeirorafadev

Estrutura Pastas Superpowers — Testing skill for Claude Code

Testing community

Scaffold de estrutura de pastas cross-agent (.agents/) + Spec-Driven Development (PRD/ADR/specs) + .editorconfig por linguagem, pra começar projetos novos com Claude Code, Cursor, Grok, Codex, Antigra.

How to install Estrutura Pastas Superpowers

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ribeirorafadev/estrutura-pastas-superpowers and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Estrutura Pastas Superpowers does

Alternatives in Testing

Spec Kitty — Spec-Driven Development for serious software developers 1.6k ★
Add Scaffold — 按 14-phase 工作流为指定 app 编写清理 scaffold（含需求采集、实测勘测、TOML、safety test、UI 集成） 1.3k ★
Spec Driven Develop — Spec-driven development workflow for AI coding agents: architecture-first planning, task decomposition, GitHub 975 ★

README

novo-projeto

Scaffold de estrutura de pastas padrão pra projetos novos desenvolvidos com IA como pair programming. Gera uma fonte de verdade cross-agent (`.agents/`), um fluxo de Spec-Driven Development (PRD/ADR/specs/plans) e um `.editorconfig` com cada regra de indentação vinda de fonte oficial — não de suposição.

Exemplo rápido

bash scripts/scaffold.sh minha-api --lang=python --agents=claude

Cria `minha-api/` com `.agents/` (fonte de verdade cross-agent), `docs/superpowers/` (PRD/ADR/specs/plans vazios, prontos pra preencher), `CLAUDE.md` + `.claude/` (porque pediu `claude` em `--agents`) e um `.editorconfig` com a seção `[*.py]` do PEP 8. Sem `--agents`, gera pra todos; sem `--lang`, o `.editorconfig` sai só com a base universal. Mais detalhes de cada flag nas seções abaixo.

Quando usar

Feita pra **começar um projeto novo**, não pra injetar estrutura num projeto já em andamento. Por padrão o script sempre cria uma subpasta nova com o nome do projeto e recusa rodar se ela já existir (`Erro: '...' já existe`) — nunca escreve por cima de arquivos existentes. Com `--here` (ver seção abaixo), dá pra gerar direto no diretório atual sem a subpasta — mas o mesmo princípio vale: se algo colidir, nada é movido, nunca sobrescreve. Se você quer adotar `.agents/`/`docs/superpowers/` num projeto que já tem código real, copie os templates manualmente em vez de rodar o scaffold ali dentro.

Estrutura do repositório

novo-projeto/
├── .github/
│   └── workflows/
│       └── test.yml          # CI: matrix ubuntu/macos/windows, 33 steps
├── .gitattributes            # força LF em todo checkout (independe de core.autocrlf do usuário)
├── scripts/
│   └── scaffold.sh           # gera a estrutura (único script executável)
├── templates/                # conteúdo copiado/adaptado pro projeto gerado
│   ├── AGENTS.md.tmpl
│   ├── CLAUDE.md.tmpl
│   ├── HANDOFF.md            # template — vira o HANDOFF.md do projeto gerado
│   ├── claude-settings.json
│