fix-decision-router
Post-documentation decision menu for fix-reporter. Routes to critical patterns, skill updates, cross-references, or discovery enablement.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
fix-decision-router Skill
Purpose: Present post-capture options and execute user's choice after fix-reporter creates documentation.
Decision Menu
Present after successful documentation:
Solution documented
File created:
- .agents-os/lessons/[category]/[filename].md
What's next?
1. Continue workflow (recommended)
2. Add to Critical Patterns
3. Link related issues
4. Add to existing skill
5. Create new skill
6. View documentation
7. Enable discovery
8. Other
Option Handlers
Option 1: Continue workflow
- Return to calling skill/workflow
- Documentation complete, no further action
Option 2: Add to Critical Patterns
When user selects: Pattern is non-obvious but must be followed every time.
1. Extract pattern from the documentation
2. Format as WRONG vs CORRECT (use template below)
3. Append to .agents-os/lessons/patterns/critical-patterns.md
4. Add cross-reference back to source doc
5. Confirm: "Added to Critical Patterns"
Template:
## N. [Pattern Name] (Required)
### WRONG ([Will cause X error])
```[language]
[code showing wrong approach]
CORRECT
[code showing correct approach]
Why: [Technical explanation]
Context: [When this applies]
Source: .agents-os/lessons/[category]/[filename].md
### Option 3: Link related issues
- Prompt: "Which doc to link? (filename or describe)"
- Search .agents-os/lessons/ for matching doc
- Add cross-reference to both docs under "## Related Issues"
- Confirm: "Cross-reference added to both files"
### Option 4: Add to existing skill
- Prompt: "Which skill?"
- Find skill in plugins/*/skills/
- Determine target: resources.md, patterns.md, or examples.md
- Add link and brief description
- Confirm: "Added to [skill-name] in [file]"
### Option 5: Create new skill
- Prompt: "Skill name?"
- Create directory: plugins/majestic-engineer/skills/[name]/
- Create SKILL.md with basic structure
- Add solution as first example in resources/
- Confirm: "Created [skill-name] skill"
### Option 6: View documentation
- Read and display the created file
- Present decision menu again
### Option 7: Enable discovery
Make lesson discoverable by lessons-discoverer agent:
- Prompt workflow phases: [planning, debugging, review, implementation]
- Prompt tech stacks: [rails, python, react, node, generic]
- Prompt lesson type: [antipattern, gotcha, pattern, setup, workflow]
- Update YAML frontmatter with:
- workflow_phase: [selected phases]
- tech_stack: [selected stacks]
- lesson_type: [selected type]
- impact: Derive from severity
- keywords: Extract from tags + symptoms
- Confirm: "Lesson discoverable during [phases] workflows"
**Impact mapping:**
- critical → blocks_work
- high → major_time_sink
- medium/low → minor_inconvenience
### Option 8: Other
Prompt for custom action and execute.
## Integration
**Invoked by:** fix-reporter (after Step 7)
**Invokes:** None (terminal options)
## Input Schema
```yaml
doc_path: string # Path to created documentation
category: string # Problem category from fix-reporter
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-02-04
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!