Skip to content

prime-radiant-inc/greenfield

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Greenfield

Reverse engineer clean behavioral specs from any codebase.

Greenfield reads source code, documentation, SDKs, runtime behavior, and binaries, then produces behavioral specifications, test vectors, acceptance criteria, and a full provenance trail. The output describes what the software does — not how any particular codebase does it — so a fresh implementation team can build against the specs without inheriting the original's internal structure.

Greenfield is a Claude Code plugin. It runs inside the claude CLI and uses Claude agents as the workers that read code, write specs, and audit output.

Installation

/plugin marketplace add prime-radiant-inc/prime-radiant-marketplace
/plugin install greenfield@prime-radiant-marketplace

Restart Claude Code after installing.

Usage

Extract specs

claude
> /analyze /path/to/target

/analyze runs a seven-layer pipeline. It discovers the available intelligence sources (source, docs, SDK, community, runtime, binary, git history, tests, UI, contracts), gathers evidence from each, synthesizes behavioral specs with provenance citations, generates test vectors and acceptance criteria, sanitizes the specs of implementation details, then runs a second-pass review of the result.

Target shape doesn't matter. Greenfield has been used on single-file minified JavaScript bundles and on source-tree projects; the pipeline also has a path for decompiled native binaries. The methodology adapts to what's there.

Workspace output:

workspace/
├── raw/         # Analysis artifacts with source references
├── output/      # Sanitized specs for the implementation team
│   ├── specs/
│   ├── test-vectors/
│   └── validation/
└── provenance/  # Citation audit trail

Re-sanitize an existing workspace

claude
> /sanitize /path/to/workspace

Re-runs the sanitization pass on an existing workspace. Useful when the initial pass left contamination that the audit caught.

Implement from the output specs

Greenfield stops at the specs. The implementation team reads workspace/output/ and builds against the behavioral specs, test vectors, and acceptance criteria there.

How it works

The pipeline dispatches agents with role-specific prompts across the seven layers. Each dispatch runs one of two generic agent types loaded with a specific skill:

  • analyzer — the workhorse. Reads evidence and writes specs. Dispatched under many roles across layers: discovery-agent, bundle-splitter, chunk-analyzer, function-analyzer, doc-researcher, community-analyst, sdk-analyzer, cli-explorer, behavior-observer, feature-discoverer, architecture-analyst, api-extractor, synthesizer, module-mapper, deep-dive-analyzer, behavior-documenter, user-journey-analyzer, contract-extractor, spec-verifier, source-completeness-checker, test-vector-generator, test-generator, acceptance-criteria-writer, spec-reviewer, structural-leakage-reviewer, content-contamination-reviewer, behavioral-completeness-reviewer, deep-read-auditor, fidelity-validator.
  • sanitizer — rewrites raw specs into output specs free of implementation details. Dispatched during Layer 5 and for remediation during Layers 6 and 7.

Pipeline

Layer Roles Output
L1: Intelligence bundle-splitter, chunk-analyzer, function-analyzer, doc-researcher, community-analyst, sdk-analyzer, cli-explorer, behavior-observer Raw evidence from source, docs, SDK, community, runtime, binary
L2: Synthesis feature-discoverer, architecture-analyst, api-extractor, synthesizer, module-mapper Feature inventory, architecture model, module map
L3: Deep Docs deep-dive-analyzer, behavior-documenter, user-journey-analyzer, contract-extractor Behavioral specs, journeys, contracts
Gate 1 spec-verifier Correctness, contradictions, gaps
Gate 1b source-completeness-checker Every user-facing surface captured
L4: Validation test-vector-generator, test-generator, acceptance-criteria-writer Test vectors, test specs, acceptance criteria
Gate 2 spec-reviewer Implementation leakage, completeness, quality
L5: Sanitization sanitizer Output specs rewritten from understanding, not copied
L6: Review structural, content, completeness reviewers + deep-read auditors Second-pass contamination review
L7: Fidelity fidelity-validators Flags behavioral detail lost or weakened during sanitization

License

Apache 2.0. Copyright 2026 Prime Radiant, Inc.

About

A Claude Code plugin that reverse-engineers clean behavioral specs, test vectors, and acceptance criteria from any codebase, producing a provenance trail so a fresh team can reimplement without inheriting the original's internal structure.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors