A skill for AI coding agents that enforces spec-anchored development with mechanical auditing, ensuring code always aligns with specification through automated verification.

Stars

40

7-day growth

No data

Forks

4

Open issues

1

License

MIT

Last updated

2026-07-29

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

Introduces a novel 'spec-anchored' approach where specification and code evolve together, enforced by a mechanical gate that provides machine-verified proof of compliance, achieving 100% defect detection in benchmarks.

Who it is for

  • AI coding agent users (Claude Code, Antigravity)
  • Software developers seeking stricter spec adherence
  • Teams practicing specification-driven development
  • Engineering managers wanting auditable development processes

Use cases

  • Specifying and implementing features with guaranteed traceability
  • Parallel task execution with clean workspace isolation
  • Automated auditing of code against acceptance criteria
  • Project-wide constitution checks for non-negotiable rules (e.g., data privacy)

Strengths

  • End-to-end traceability with codes linking stories, criteria, tasks, and tests
  • Machine-verified 'done' - only passing tests count as proof
  • Forces explicit recording of assumptions and open questions
  • Planned parallel execution with git worktree and branch isolation

Considerations

  • Requires Node.js ≥18 and specific AI agents (Claude Code or Antigravity)
  • Initial setup per project needed (npx or manual copy)
  • Benchmarks limited to one domain (SDD projects); broader applicability not yet demonstrated

README quick start

onp-spec-driven

A especificação que continua verdadeira. Você descreve a feature, o agente de IA especifica, planeja, executa em paralelo e prova que fez — com auditoria mecânica, não com promessa. Se a spec e o código desalinham, a máquina acusa.

┌───────────┐  ┌────────┐  ┌───────┐  ┌───────┐  ┌────────┐  ┌───────┐
│ESPECIFICAR│→ │PROJETAR│→ │TAREFAS│→ │ PLANO │→ │EXECUTAR│→ │AUDITAR│
└───────────┘  └────────┘  └───────┘  └───────┘  └────────┘  └───────┘
                                          ↑ paralelismo         ↑ o gate mecânico

Instalação (2 minutos)

A skill é autossuficiente: o motor mecânico já vem embarcado dentro dela (zero dependências — só precisa de Node.js ≥ 18 no ambiente, que seu agente já usa). Instalar é colocar uma pasta no lugar certo. Escolha o seu agente:

Claude Code

Na raiz do seu projeto:

npx @onovoprogramador/onp-spec init --agents claude

Pronto: isso cria a estrutura .spec/ do projeto e instala a skill em .claude/skills/onp-spec-driven/. Abra uma conversa nova no Claude Code e a skill já está ativa.

Antigravity

Na raiz do seu projeto:

npx @onovoprogramador/onp-spec init --agents antigravity

Isso cria a estrutura .spec/ e instala a skill em .agents/skills/onp-spec-driven/ (o diretório de skills do workspace do Antigravity). Abra uma conversa nova e pronto.

Sem npm/npx (instalação manual)

Baixe o repositório e copie a pasta da skill do seu agente:

git clone --depth 1 https://github.com/onovoprogramador/onp-spec-driven.git /tmp/onp-spec

# Claude Code (neste projeto)
mkdir -p .claude/skills
cp -r /tmp/onp-spec/skills/onp-spec-driven .claude/skills/onp-spec-driven

# Antigravity (neste workspace)
mkdir -p .agents/skills
cp -r /tmp/onp-spec/skills/onp-spec-driven-antigravity .agents/skills/onp-spec-driven

Quer a skill disponível em todos os seus projetos? Copie para o diretório global do agente em vez do projeto: ~/.claude/skills/ (Claude Code) ou ~/.gemini/config/skills/ (Antigravity).

Importante: cada agente tem a SUA skill — a do Claude Code executa o plano com sessões headless paralelas do próprio Claude; a do Antigravity usa os agentes paralelos nativos dele. Não misture as pastas (a skill sabe se defender, mas por que arriscar?).

Como usar — você fala, o agente prova

Você **não precisa aprend

Related repositories

Similar projects matched by category, topics, and programming language.

react
Featured
react GitHub avatar

react

React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.

Web DevelopmentFrontend Frameworks
246,741
tandpfun
Featured
tandpfun GitHub avatar

wardrobe

A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.

JavaScript
1,570
mshumer
Featured
mshumer GitHub avatar

Claude-of-Duty

A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.

AI & Machine LearningAI Agents
1,234