ProvenanceCode¶
Decision-Driven Development for the AI Era¶
Traceable AI-assisted decisions. Enforced at merge time.
The Problem¶
AI coding agents have increased development velocity.
They have also increased:
- Untraceable architectural decisions
- Undocumented AI influence
- Review ambiguity
- Governance gaps
- Enterprise risk
Most organizations cannot answer:
Why does this code exist?
Was AI involved?
Who approved the decision?
What risk was acknowledged?
Velocity without accountability is fragile.
The Solution¶
ProvenanceCode is a decision-driven development standard for AI-assisted software.
It defines how teams:
- Capture structured decision records
- Link code to documented intent
- Enforce review checkpoints
- Surface risk and tradeoffs
- Maintain auditability without slowing delivery
ProvenanceCode operates at the pull request layer.
It does not replace tools.
It governs them.
How It Works¶
- Decision Records
- Structured decision artifacts (Decision Evidence Objects)
- Stored in the repository
-
Linked to code changes
-
Enforcement Presets
- Light
- Standard
- Regulated
-
Configurable governance depth
-
Merge-Time Validation
- Pull request hooks
- Missing decisions fail validation
-
Unapproved decisions block merge (configurable)
-
Human-in-the-Loop Control
- AI may propose
- Humans approve
- Decisions are recorded
What's New: ProvenanceCode v2.0¶
Enhanced naming convention with monorepo and Jira support
v2.0 introduces:
- 🎯 Monorepo Support - Map artifacts to specific workspaces
- 🔗 Jira Integration - Automatic project and component linking
- 📁 Hierarchical Organization - Project/subproject structure
- ✅ Backward Compatible - v1.0 format still fully supported
Format comparison:
v1.0: DEC-000001
v2.0: DEC-PROJ-CORE-000001
Both formats work together. Migration is optional.
📖 Learn more about v2.0 | Migration Guide
Get Started¶
- Read the Standard: Standard → Overview
- Implement enforcement: Implementation → GitHub Action
- Product path: Implementation → GitHub App
- New: ProvenanceCode v2.0
ProvenanceCode is developed and maintained by EmbankAI.