fix-reporter

name	fix-reporter
description	Capture solved problems as categorized documentation with YAML frontmatter for fast lookup
allowed-tools	Read Write Bash Grep
preconditions	["Problem has been solved (not in-progress)","Solution has been verified working"]

fix-reporter Skill

Purpose: Document solved problems to build searchable institutional knowledge.

Organization: Single-file per problem in .agents/lessons/[category]/[filename].md with YAML frontmatter. Files with workflow_phase fields are discoverable by lessons-discoverer agent.

7-Step Capture Process

Step 1: Detect Confirmation

Auto-invoke triggers:

• "that worked", "it's fixed", "working now", "problem solved", "that did it"

Manual: /report-fix command

Document when:

• Multiple investigation attempts needed
• Tricky debugging that took time
• Non-obvious solution
• Future sessions would benefit

Skip for: Simple typos, obvious syntax errors, trivial fixes

Step 2: Gather Context

Extract from conversation:

Field