# Reproducible End-to-End Demo

This demo uses only local workflow state and the built-in fake provider path. It
does not require OpenAI, Anthropic, GitHub, or tracker credentials.

Run it in a disposable directory:

```bash
mkdir open-orchestra-demo
cd open-orchestra-demo
npm install -g @jterrats/open-orchestra
orchestra init --confirm-unknown
orchestra health --json
```

In a disposable empty directory, `health` may report a workspace-classification
warning while still reporting workflow readiness as passed. Real project
directories should have project signals such as a package manager or source tree.

## 1. Create a Governed Task

```bash
orchestra task add \
  --id DEMO-001 \
  --title "Ship a governed README update" \
  --owner product_owner \
  --paths "README.md"

orchestra estimate \
  --task DEMO-001 \
  --sizing s \
  --solo-days 1 \
  --ai-unguided-days 0.5 \
  --ai-guided-days 0.25 \
  --confidence medium
```

## 2. Satisfy the Architect Sizing Gate

The autonomous workflow always requires architect sizing before developer work.

```bash
orchestra decision add \
  --task DEMO-001 \
  --owner architect \
  --title "Story sizing" \
  --decision "s 2 points" \
  --context "Local fake-provider demo" \
  --consequences "Developer phase can start"
```

## 3. Run the Workflow

```bash
orchestra workflow run --task DEMO-001 --gates none
orchestra workflow runs --json
```

Expected result: the run creates PM, PO, architect, developer, QA, and release
phase records in `.agent-workflow/` and completes without provider API keys.

## 4. Attach Evidence and Review

```bash
orchestra evidence add \
  --task DEMO-001 \
  --role developer \
  --type command \
  --summary "Demo workflow completed with fake provider"

orchestra review \
  --task DEMO-001 \
  --role qa \
  --result approve \
  --findings "Demo artifacts are present and workflow completed" \
  --recommendation "Use this path for local onboarding"
```

## 5. Inspect Release Readiness

```bash
orchestra release candidate --version 0.0.0-demo --dry-run --json
orchestra benchmark --task DEMO-001
orchestra summary --json
```

The demo is complete when the workflow run is done, evidence and QA review exist,
and the release candidate dry run reports the remaining gaps explicitly.