Context
Users hitting common issues (e.g. plugin not loading, compaction recovery, state file corruption) currently have no troubleshooting guide.
Suggested scope
- Add a "Troubleshooting" section to the README (or a separate
docs/troubleshooting.md)
- Cover common issues: plugin installation problems,
/sw-status --reset for stuck state, compaction recovery
- Reference
protocols/recovery.md for compaction details
Helpful references
protocols/recovery.md — compaction recovery procedureskills/sw-status/SKILL.md — describes --reset flagCLAUDE.md — key rules section
Context
Users hitting common issues (e.g. plugin not loading, compaction recovery, state file corruption) currently have no troubleshooting guide.
Suggested scope
docs/troubleshooting.md)/sw-status --resetfor stuck state, compaction recoveryprotocols/recovery.mdfor compaction detailsHelpful references
protocols/recovery.md— compaction recovery procedureskills/sw-status/SKILL.md— describes--resetflagCLAUDE.md— key rules section