What problem does it solve?
It prevents repeated pain by turning failures, confusions, odd results, and workarounds encountered during work into a persistent, session-level record that future agents can learn from.
Core Features & Use Cases
- Proactive issues logging: Records errors, confusions, unexpected behavior, workarounds, and improvement suggestions as you encounter them.
- Session-aware documentation: Writes to the active research session’s top-level issues.md using agent_logs/.current to resolve the correct directory.
- Operational guardrails: Refuses to run when there is no valid active session marker (agent_logs/.current missing or stale), prompting you to start with /research-session.
Quick Start
Run /document-issues while you have an active research session so the skill updates agent_logs/<SESSION_NAME>/issues.md with what went wrong and how you worked around it.