speckl/README.md
Marcus (@cos) a97a532a3c Initial commit: Speckl project scaffold
- MIT license
- README with project overview, Dark Provenance intro, and structure
- Empty directories: speckdl/, reference-agent/, examples/
- Placeholder whitepaper with Dark Provenance outline

Parent: Greybeard Holdings, LLC
Status: Early / Pre-Alpha
2026-04-28 01:20:22 -07:00

1.9 KiB

Speckl

Spec-first. Everything else follows.

Speckl is an open standard and development system for spec-first multi-agent development — define what your software should do in a formal, machine-readable spec, then let AI agents generate, verify, and maintain the implementation.

What Makes Speckl Different

Most dev tools start with code. Speckl starts with the spec — a formal, versioned, verifiable contract that lives alongside your code. This contract is the single source of truth. Everything else (tests, docs, implementations, verifications) is derived, checked, and regenerated from it.

Dark Provenance

Speckl is built on Dark Provenance — a methodology for tracking the intent, decisions, and constraints behind every line of generated code. Dark Provenance makes AI-generated software auditable, explainable, and trustworthy by preserving the reasoning chain from spec to implementation.

"If you can't trace why every line exists, you don't own your code."

See the Dark Provenance Whitepaper for the full methodology.

Strategy

For the full strategic context and roadmap, read the Speckl Strategy v2 (or see speckl-strategy-v2.md in the workspace).

Repository Structure

speckl/
├── speckdl/           # Speckl Definition Language — the formal spec language
├── reference-agent/   # Reference implementation of a Speckl-compliant agent
├── docs/              # Documentation and whitepapers
├── examples/          # Example specs and generated outputs
└── LICENSE            # MIT License

Status

Early / Pre-Alpha — The spec language is being drafted. Nothing is stable. Contributions and feedback are welcome.

Parent

Greybeard Holdings, LLC — bootstrapped, independent, Scott Scoble, CEO.

License

MIT — see LICENSE.