gaps-wdyk

Cross-reference your career goals, arsenal evidence, and learning session history to identify knowledge gaps, blind spots, and areas of strength. Produces a prioritized gap report with actionable next steps. Load Configuration Resolve the user's home directory. echo $HOME Never pass `~` to the Read tool. Tell the user: "Run `/things:setup-things` first." Then stop. Tell the user: "Run `/setup-wdyk` first." Then stop. Extract `building_skills`, `aspirational_skills`, `current_role`, `target_roles` from the professional profile. Load All Data Read the following data files: Read all files in `/.things/i-did-a-thing/arsenal/` for skill evidence. bash /scripts/search-sessions.sh --recent 50 Load all learning session history for score data. No learning sessions found. I'll analyze your arsenal for potential gaps, but your gap analysis will be more accurate after a few explore or quiz sessions.

  Try `/explore-wdyk` first to establish baseline knowledge in your key areas.
  </output>
</if>

Determine Focus Use the provided focus. Which skills should I analyze? Building skills -- skills you're actively developing (Recommended) Aspirational skills -- skills you want to develop next All -- comprehensive analysis across both Analyze Each Skill Area For each skill in the selected focus set, evaluate across four dimensions:

<validate name="arsenal-evidence">
  Arsenal evidence:
  - How many index entries reference this skill?
  - What evidence types are present? (accomplishments only? or also lessons, decisions, expertise, insights?)
  - How recent is the evidence?
  - How diverse are the projects/contexts?
</validate>

<validate name="learning-session-data">
  Learning session data:
  - How many explore/quiz sessions cover this topic?
  - What are the average scores across learning dimensions?
  - Are scores trending up, stable, or down?
  - What concepts within this skill are strong vs. gap?
</validate>

<validate name="evidence-type-diversity">
  Evidence type diversity:
  - All accomplishments? --> You can do it but can you explain it?
  - No lessons? --> You may not recognize failure patterns
  - No decisions? --> You may not be able to articulate tradeoffs
  - No expertise? --> Surface-level understanding risk
</validate>

<validate name="goal-alignment">
  Goal alignment:
  - Is this skill critical for `target_roles`?
  - How does it relate to `career_direction`?
  - Is it a prerequisite for `aspirational_skills`?
</validate>

Classify Each Area Based on the analysis, classify each skill: - Strong -- Multiple diverse evidence types + high learning scores + recent activity. You can explain it, apply it, and teach it. - Building -- Some evidence and/or moderate learning scores. You're developing but have clear depth gaps. - Gap -- Little evidence despite relevance to goals. You know it exists but can't go deep. - Blind Spot -- Relevant to target roles but no evidence AND no learning sessions. You may not realize you need it. Present Gap Report

<template name="gap-report">
  <output>
  Knowledge Gap Analysis

  Focus: `<building|aspirational|all>` skills for `<target_roles>`
  </output>

  <section name="strong">
    <output>
    Strong
    | Skill | Evidence | Types | Learning Score | Last Active |
    |-------|----------|-------|---------------|-------------|
    | skill | N entries | acc, les, dec | x.x/5 | date |
    </output>
  </section>

  <section name="building">
    <output>
    Building
    | Skill | Evidence | Missing Types | Learning Score | Priority |
    |-------|----------|--------------|---------------|----------|
    | skill | N entries | missing types | x.x/5 | why it matters |
    </output>
  </section>

  <section name="gap">
    <output>
    Gap
    | Skill | Evidence | Learning Score | Why It Matters |
    |-------|----------|---------------|----------------|
    | skill | N entries | x.x/5 or -- | relation to goals |
    </output>
  </section>

  <section name="blind-spot">
    <output>
    Blind Spot
    | Skill | Relevance | Suggested First Step |
    |-------|-----------|---------------------|
    | skill | why needed for target role | explore or bridge suggestion |
    </output>
  </section>
</template>

Prioritized Recommendations Generate a prioritized list of actions:

<template name="action-list">
  <output>
  Recommended Actions (highest impact first)

  1. [Gap/Blind Spot skill] -- `/explore-wdyk <topic>` to establish baseline understanding
  2. [Building skill] -- `/quiz-wdyk --topic <topic>` to test retention and find specific weak spots
  3. [Gap skill] -- `/bridge-wdyk <topic> --from <related strong skill>` to build from existing knowledge
  4. [Evidence gap] -- `/thing-i-did` to log a `<missing evidence type>` entry for skill
  </output>
</template>

Offer Next Steps What would you like to do? Explore a gap topic -- deep-dive into an area I'm weak in Quiz a building area -- test what I'm developing Bridge a gap -- build a learning plan from existing knowledge Done for now -- I'll review the report