TEMPLATE.md

• Status: draft
• Date: YYYY-MM-DD
• Scope:

Objective

1. ...
2. ...

Status Quo Baseline

Capture current behavior with explicit evidence links.

1. Baseline metric or trace A.
2. Baseline metric or trace B.
3. Baseline metric or trace C.

Expected Improvements

State measurable deltas from the baseline.

1. Metric X from <baseline> to <target>.
2. Metric Y from <baseline> to <target>.
3. Metric Z from <baseline> to <target>.

Non-Improvement Expectations

State what should not regress.

1. Behavior A remains unchanged.
2. Behavior B remains unchanged.

Validation Signals and Thresholds

1. Test suites/specs that must pass.
2. Trace scenarios and log fields to inspect.
3. Explicit pass/fail thresholds.
4. Minimum observation window.

Rollback or Adjustment Triggers

1. Trigger condition A -> adjustment action A.
2. Trigger condition B -> rollback action B.

Non-Goals

1. ...

Design Constraints

1. ...

Delivery Strategy

Phase 0:

Goals:

1. ...

Implementation:

1. ...

Phase Improvement Contract:

1. Baseline snapshot: <metric/trace before phase>
2. Expected delta:
3. Observed delta:

Exit criteria:

1. ...

Phase 1:

Goals:

1. ...

Implementation:

1. ...

Phase Improvement Contract:

1. Baseline snapshot: ...
2. Expected delta: ...
3. Observed delta: ...

Exit criteria:

1. ...

Test Strategy

1. Unit tests
2. Integration tests
3. Acceptance tests
4. Regression tests

Risks and Mitigations

1. Risk A -> mitigation A.
2. Risk B -> mitigation B.

Completion Criteria

1. ...