Output Artifacts

epiphany-brief writes its output to ~/docs/epiphany/<slug>/:

File Purpose
living-brief.md The human-readable living brief --- the primary output
brief-session.md Q&A log from the interview
brief-crux-log.md Record of design decisions and cruxes
handoff.json Machine-readable handoff for epiphany-spec (12 fields)
acu-index.json Internal zero-loss audit trail (ACU index)

handoff.json

The handoff is a structured JSON file consumed by /epiphany-spec. It contains 12 fields including:

  • session_id --- unique identifier
  • slug --- the project slug
  • acus --- the full ACU index
  • domain_class --- classified domain
  • interview_log --- structured interview log
  • coverage_result --- coverage gate result
  • crux_log --- design decisions

epiphany-spec reads this file and ingests all content losslessly.