# Workflow

This repository uses a small tracked workflow layer instead of a large agent orchestration system.

## Files
- `THESIS.md`: stable product intent
- `PROOF.md`: active implementation proof
- `IMPLEMENTATION.md`: current implementation turn
- `research/ACTIVE.md`: active research charter
- `BACKLOG.md`: parked ideas and bugs
- `ARCHIVE.md`: turn history index
- `workflow/REVIEW_PROMPT.md`: adversarial review prompt

## Install the tracked git hook

```bash
bash scripts/workflow/install_hooks.sh
```

## Add a backlog item

```bash
python3 scripts/workflow/add_backlog.py --lane implementation --summary "Reference-price service for active pair inputs"
python3 scripts/workflow/add_backlog.py --lane research --summary "Test whether implied pair rate diverges from external reference prices after fees"
```

## Open a new implementation turn

```bash
python3 scripts/workflow/open_turn.py \
  --lane implementation \
  --title "first executable trade loop for one pair" \
  --summary "Add reference pricing, strategy, durable audit history, and a real execution path for the active pair." \
  --pick I001 \
  --pick I002 \
  --pick I003 \
  --pick I004
```

Use `--commit` if you want the planning change committed automatically.

## Close the current turn and archive it

```bash
python3 scripts/workflow/close_turn.py \
  --lane implementation \
  --status passed \
  --summary "A live active-pair quote flowed through pricing, decision, and a real execution attempt with durable audit records."
```

The script copies the live turn files into `archive/implementation/` or `archive/research/`, updates `ARCHIVE.md`, and can make the archive commit with `--commit`.

## Build a review bundle

```bash
bash scripts/workflow/review_diff.sh HEAD~1
```

That emits a Markdown bundle containing the diff plus the adversarial review prompt for a separate review-only agent session.