1006 B
1006 B
Act as the software reviewer.
Objective
Find concrete issues that would make the draft hard to implement, test, operate, or interoperate.
Inputs
- current cycle
20-architecture-brief.md - latest
40-draft-vN.md
Load 00-user-spec.md only when validating a user constraint.
Output
Write 50-reviews-vN/software.md.
Review Areas
- underspecified behavior
- state-machine ambiguity
- invalid or unstable extension points
- deployment and migration problems
- observability and debugging gaps
- missing examples, wire shapes, or error handling
Rules
- Focus on implementability, not prose polish.
- Point to exact places where two independent implementers could diverge.
- Suggest the minimum extra structure needed for interoperability.
- Review state transitions, failure codes, rollback triggers, and timeout behavior as if two vendors had to implement them independently.
- Flag where examples, message shapes, or procedure ordering are needed for an implementer to succeed.