greenfield

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.