# Review Guide

This is the human review entry point for the integrated CrewRift optimizer
learning package.

## What To Review

- [METADATA.md](METADATA.md): package provenance, source machines, player IDs,
  and source roots.
- [LOOP.md](LOOP.md): reconstructed optimization loop across zephyrus, xpser,
  and mbp.
- [performance/LOG.md](performance/LOG.md): concrete policy trajectory findings
  from Suspectra/co-gas and RelhAlpha/player-labs, plus the explicit Titan
  non-CrewRift gap.
- [AGENTS.md](AGENTS.md): compact always-on guidance for future CrewRift
  optimizer agents.
- [review.html](review.html): HTML review snapshot for the integrated package.

## Tiered Packages

- [universal/](universal/): all learnings before tier subtraction.
- [crewrift-specific/](crewrift-specific/): CrewRift-only mechanics and
  social-policy findings.
- [remote-xp-optimizer-loop/](remote-xp-optimizer-loop/): hosted XP,
  candidate-ledger, and remote evaluation workflow lessons.
- [generic/](generic/): fully general evidence-first optimization practices.

## Source Machine Provenance

The four original machine extraction runs were collapsed into this package.
Generated per-machine review pages are retained for source review. The
provenance summary records what was integrated and what was cut:

- [source-machines/review-zephyrus.html](source-machines/review-zephyrus.html)
- [source-machines/review-xpser.html](source-machines/review-xpser.html)
- [source-machines/review-mbp.html](source-machines/review-mbp.html)
- [source-machines/review-titan.html](source-machines/review-titan.html)
- [source-machines/INDEX.md](source-machines/INDEX.md)

## Integration Notes

- The canonical package is
  `packages/coworld/templates/optimizers/202624/richard-higgins-crewrift-player-optimizer/`.
- Machine-specific directories were removed after integration.
- Source-machine names are retained as provenance, not as separate packages.
