https://github.com/prime-radiant-inc/greenfield
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.
https://github.com/prime-radiant-inc/greenfield
ai-agents claude-code-plugin reverse-engineering specifications
Last synced: 5 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/prime-radiant-inc/greenfield
- Owner: prime-radiant-inc
- License: apache-2.0
- Created: 2026-04-23T06:25:56.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-06T18:41:20.000Z (about 1 month ago)
- Last Synced: 2026-06-06T20:16:45.694Z (about 1 month ago)
- Topics: ai-agents, claude-code-plugin, reverse-engineering, specifications
- Size: 172 KB
- Stars: 148
- Watchers: 4
- Forks: 13
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://claude.com/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
```bash
/plugin marketplace add prime-radiant-inc/prime-radiant-marketplace
/plugin install greenfield@prime-radiant-marketplace
```
Restart Claude Code after installing.
## Usage
### Extract specs
```bash
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
```bash
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.