Prodara Documentation

Prodara compiles .prd specs into a typed Product Graph. Write declarative files that describe your software product — entities, workflows, screens, permissions, governance — and the compiler validates everything through a 13-phase pipeline. Change a spec and your agent knows exactly what's impacted — no scanning your codebase.

The Prodara Ecosystem

📝

Specification Language

Declarative .prd files for product modeling

⚙️

Compiler & CLI

13-phase pipeline with JSON output

💻

VS Code Extension

Syntax highlighting, real-time diagnostics, LSP

🤖

AI Agent Workflows

Works with GitHub Copilot, Claude, Cursor & more

Quick Navigation

Architecture

The 13-phase compiler pipeline, from source discovery to build orchestration.

Configuration

Configure the compiler, reviewers, workflows, and more via prodara.config.json.

Product Graph

The canonical JSON output with 40+ typed edge relationships.

Diagnostics

Structured error codes, severities, and suggested fixes.

AI Agent Integration

26+ supported agents with a single AI prompt file and structured JSON output.

AI Prompt File

One prompt file that teaches your agent the complete 8-phase lifecycle.

Interactive Modes

Explore, Help, Party, Design, and Onboard modes for AI agents.

Reviewers & Constitution

9 built-in reviewers, custom reviewers, and constitution governance.

Extensions & Presets

Plugin system with marketplace, 5 capability kinds, and shareable presets.

Proposals & Changes

Stage specification changes in isolation with full review feedback.

Custom Workflows

Define workflow pipelines with review gates and custom phase sequences.

Entities & Fields

Persistent domain objects with fields, types, and relationships.

Workflows

Business logic, authorization, steps, transitions, and effects.

CLI Usage

13 commands: build, init, validate, graph, plan, test, review, propose, and more.

API Reference

Programmatic access to 200+ functions via @prodara/compiler.

Design Goals

  • Human-readable - Plain text specs that anyone on the team can understand - product managers, designers, and engineers
  • AI-native - Built for AI agents: non-interactive CLI, JSON output, stable contracts, suggested fixes, and a single AI prompt file
  • Deterministic - Same input always produces the exact same Product Graph (SHA-256 verified)
  • Git-friendly - Merge specs like code, track changes over time, and use proposals for isolated change management
  • Governance-first - Constitution-governed generation with security, privacy, compliance, and code style policies at three stacking layers
  • Editor-integrated - VS Code extension with syntax highlighting, real-time diagnostics, completions, hover, go-to-definition, and document symbols via LSP
  • Incrementally buildable - Semantic diffing and impact propagation mean only changed artifacts are regenerated

Language Constructs

The Prodara specification language supports 30+ declaration types for modeling every aspect of your product:

Domain: entity, value, enum, rule
Behavior: workflow, action, event, schedule
UI/Surface: surface, rendering, tokens, theme
Users: actor, capability
Data: serialization, storage, strings
Infra: integration, transport, execution
Governance: constitution, security, privacy, validation
Runtime: secret, environment, deployment
Quality: test, extension, product_ref

Next Steps

New to Prodara? Start with the Quick Start tutorial — run prodara init, open your IDE, and type @prodara to start building. Or explore the Architecture guide to understand the 13-phase compiler pipeline.