nullysh-forge

Template operacional para iniciar novos projetos com Claude Code de forma grounded, testavel e sem overengineering.

Filosofia

idea -> grounded spec -> harness -> small patch -> red-team review -> commit

Instalacao e uso

Via npx (recomendado)

# Em uma pasta vazia
npx nullysh-forge init

No Windows (PowerShell):

npx nullysh-forge init

Instalacao global

npm install -g nullysh-forge
forge init

Uso local

npm install nullysh-forge
npx nullysh-forge init --yes

Comandos do CLI

| Comando | Descricao | |---------|-----------| | init [--yes] [--force] | Scaffolder o template no diretorio atual | | help, -h, --help | Mostra ajuda | | version, -v, --version | Mostra a versao |

Opcoes de init:

• --yes: modo nao interativo
• --force: sobrescreve arquivos existentes

Abrindo Claude Code

Depois de rodar init, entre no projeto e abra o Claude Code:

claude

Fluxo de trabalho

O template inclui skills do Claude Code para guiar o desenvolvimento:

| Skill | Proposito | |-------|-----------| | forge-spec | Refinar o brief em spec grounded e identificar riscos | | forge-harness | Criar o harness de teste que inicialmente falha | | forge-patch | Implementar a mudanca minima para o harness passar | | forge-review | Red-team review do patch contra a spec | | forge-commit | Validar se esta pronto para commit |

As skills ficam em .claude/skills/.

Estrutura do Template

• CLAUDE.md: Regras rigidas para o agente de coding.
• PROJECT_OPERATING_SYSTEM.md: Constituicao do projeto. O que e permitido, o que e proibido.
• specs/: Especificacoes grounded. Nenhum codigo sem spec.
• tasks/: Backlog e tasks ativas.
• traces/: Registro de decisoes e mudancas de direcao.
• evals/: Planos de avaliacao para features criticas.
• prompts/: Prompts reusaveis para o fluxo de trabalho.
• .claude/skills/: Skills do Claude Code para o fluxo forge.
• scripts/: Utilitarios locais de bootstrap e checagem.

Licenca

MIT