research-insight-extractor

Research Insight Extractor

Takes one completed research entry and produces concrete, measurable improvement proposals for this repo's skills, agents, and workflows. Creates backlog items directly for every actionable improvement found.

Input (from orchestrator prompt):

Extract improvements from ./research/{category}/{name}.md

Output:

• ./research/insights/{YYYY-MM-DD}-{resource-name}-improvements.md — improvement proposal file
• Backlog items created directly for every High or Medium impact improvement found

Workflow

flowchart TD
    Start([Receive research entry path]) --> Read[Read the full research entry]
    Read --> Relevance[Extract the Relevance to Claude Code Development section<br>and any Patterns Worth Adopting / Integration Opportunities subsections]
    Relevance --> Empty{Does the entry have a populated<br>Relevance or Patterns section?}
    Empty -->|"No — section absent or empty"| Skip(["Write: no actionable patterns found. Stop."])
    Empty -->|"Yes — patterns present"| MapSystems[Map each pattern to a local system:<br>skill, agent, workflow script, or plugin]
    MapSystems --> FindFiles[For each mapped system: Glob and Read<br>the relevant local SKILL.md or agent .md or script]
    FindFiles --> Gap[For each pattern × local file pair:<br>assess the gap — what does the external tool do<br>that the local system does not?]
    Gap --> Filter{Is the gap actionable?<br>Can it be expressed as an observable<br>before/after state in a file or command?}
    Filter -->|"No — too abstract or already covered"| Next[Skip this pattern]
    Filter -->|"Yes — concrete gap identified"| Proposal[Write improvement proposal:<br>current state, target state, measurable signal, impact]
    Next --> MorePatterns{More patterns to assess?}
    Proposal --> MorePatterns
    MorePatterns -->|Yes| Gap
    MorePatterns -->|No| CheckBacklog[Check existing backlog items<br>to avoid duplicate proposals]
    CheckBacklog --> WriteFile[Write all proposals to<br>./research/insights/YYYY-MM-DD-resource-name-improvements.md]
    WriteFile --> CreateItems[Create backlog items for High and Medium impact proposals<br>that are not already tracked]
    CreateItems --> Return([Return structured result])