Trace, RunState, and Debugging Development SOP
Prerequisites
Read the module overview, then confirm the business owner, inputs, outputs, failure conditions, and permission boundary.
Procedure
- Locate the run by runId.
- Rebuild the timeline by sequence.
- Inspect backward from the first fatal error or policy_denied.
- For a Loop, validate snapshot version, configuration fingerprint, and the latest stable phase.
- Resume only after confirming complete step output, no replay of committed effects, and human reconciliation of unknown effects.
- Reproduce from evidence before changing code.
- Use fake credentials, body content, and a URL with a sensitive query value to verify pre-persistence redaction while keeping ordinary test commands auditable for graders.
- Keep before-and-after traces.
- Run the listed module tests and
npm run check:modules. - Preserve trace, evaluation, and owner-approval evidence; do not publish without explicit authorization.
Stop conditions
Stop for unconfirmed business rules, non-reversible side effects, access outside the workspace, unavailable real credentials, or failed security gates. Ask the owner instead of expanding scope.