Reality Report template

Reality Report — Project name

 

1. Project Overview

  • Current purpose of the project
  • Current version or release state
  • Main entry point
  • Short description of what the system currently does

2. Architecture

  • Main modules
  • Current responsibilities of key parts
  • High-level execution flow

3. Current Capabilities

  • What the project can currently do
  • Supported modes, features, and behaviors
  • Important operational constraints if relevant

4. Test Suite Status

  • Current test files or groups
  • Test counts if relevant
  • Default test behavior
  • Current pass/fail state
  • Important coverage notes

5. Golden System

  • How the golden mechanism currently works
  • What golden layers or artifacts exist
  • Current consistency status

6. Recent Changes

  • Most important recent changes
  • Short explanation of impact
  • Important related commits if relevant

7. Known Issues / Open Decisions

  • Current known issues
  • Current open decisions
  • Unresolved behavior differences or gaps

8. Technical Debt

  • Existing technical debt
  • Legacy parts
  • Structural weaknesses
  • Non-urgent but real issues

9. Overall Assessment

  • Current overall state of the project
  • Stability assessment
  • Main strengths
  • Main weaknesses
  • Short closing summary

10. Next Logical Steps

  • Immediate next priorities based on the current state of the project
  • Follow-up work that should logically come next
  • Open items that are ready for the next iteration