Use this document as the structured workspace whenever a complex issue arises (e.g., “app fails to launch if it’s raining outside”). The goal is to capture observations, develop and test hypotheses systematically, and leave a durable record that future agents can build on. Follow the sections in order; update them as you work. Keep entries concise but specific.
- Problem statement: Describe the issue in one sentence. Include any user reports, reproducibility notes, or triggering conditions.
- Environment: List OS, hardware, app version/commit, and any relevant runtime flags or services.
- Guardrails: Note any actions that are out-of-bounds (e.g., no network access, no external APIs, approvals needed).