Nullysh Forge

Grounded AI Project Starter Kit for Claude Code.

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