bridge-wdyk

Build a concrete learning plan that bridges from what you already know to a gap topic. Plans are grounded in your arsenal evidence and include checkpoints using explore and quiz sessions. 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. 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 20 Identify the Gap Use the gap topic from the argument. What topic do you want to build a learning plan for? Free text -- e.g., "distributed consensus", "observability", "API design patterns" Reference the gap report to suggest options. Find the Bridge Use that as the starting strength. Search the arsenal and learning sessions for the closest existing knowledge: Search `/.things/i-did-a-thing/index.json` for entries with skills that relate to the gap topic. Check `knowledge-map.json` for strong topics adjacent to the gap. Check learning session scores for related topics.

<output>
Bridging to: [gap topic]

Starting from: [existing strength] -- based on [evidence]

You understand [existing concept] from your experience with [project/entry from arsenal]. To get to [gap topic], you can build on that foundation:
- [connection point 1]
- [connection point 2]
</output>

<if condition="no-clear-connection">
  <output>
  I don't see a strong bridge from your existing knowledge. This is more of a greenfield learning area. The plan will start from fundamentals.
  </output>
</if>

Select Timeline Use the provided timeline. How much time do you want to invest? 1 week -- focused sprint, ~30 min/day 2 weeks -- steady pace, ~20 min/day (Recommended) 1 month -- deep investment, ~15 min/day Build the Plan Generate a structured learning plan with milestones and checkpoints. Reference `references/learning-plan-framework.md` for plan structure.

<constraint>
Each plan section should:
- Start from what the user already knows (grounded in arsenal)
- Include exercises tied to actual projects where possible
- Have checkpoints using quiz and explore skills
- Build incrementally toward the target understanding
</constraint>

<template name="learning-plan">
  <output>
  Learning Plan: [Gap Topic]

  Starting from: [existing strength]
  Timeline: [duration]
  Goal: [what "understanding this topic" means concretely]
  </output>

  <phase name="foundation" number="1">
    <output>
    Phase 1: Foundation (Days 1-N)
    Objective: [what you'll understand after this phase]

    Building from: Your experience with [arsenal reference] gives you a foundation in [related concept].

    Activities:
    - [ ] Read/research: [specific resource or concept]
    - [ ] Reflect: How does [concept] relate to your [arsenal entry]?
    - [ ] Checkpoint: `/explore-wdyk <sub-topic> --depth exploratory`
    </output>
  </phase>

  <phase name="depth" number="2">
    <output>
    Phase 2: Depth (Days N-M)
    Objective: [deeper understanding target]

    Activities:
    - [ ] Hands-on: [exercise tied to their projects]
    - [ ] Connect: [concept] <-> [related concept from their work]
    - [ ] Checkpoint: `/quiz-wdyk --topic <topic> --count 5`
    </output>
  </phase>

  <phase name="integration" number="3">
    <output>
    Phase 3: Integration (Days M-End)
    Objective: [ability to apply and teach]

    Activities:
    - [ ] Apply: How would [concept] change your approach to [past project]?
    - [ ] Teach: Explain [concept] as if writing a blog post
    - [ ] Checkpoint: `/explore-wdyk <topic> --depth deep`
    - [ ] Log it: `/thing-i-did` -- capture what you learned as an expertise entry
    </output>
  </phase>

  <section name="success-criteria">
    <output>
    Success Criteria
    - [ ] Can explain [topic] to a peer without notes
    - [ ] Can identify tradeoffs between [approach A] and [approach B]
    - [ ] Score >= 4/5 on quiz for [topic]
    </output>
  </section>
</template>

Write the Plan

  <schema name="study-plan-frontmatter">
  ```yaml
  ---
  topic: "<gap topic>"
  bridge_from: "<existing strength>"
  timeline: "<1-week|2-weeks|1-month>"
  created: <date>
  status: active
  phases:
    - name: "Foundation"
      target_date: "<date>"
      status: pending
    - name: "Depth"
      target_date: "<date>"
      status: pending
    - name: "Integration"
      target_date: "<date>"
      status: pending
  arsenal_references:
    - file: "<log filename>"
      relevance: "<bridge connection>"
  ---
  ```
  </schema>

  <constraint>Follow the frontmatter with the full plan content in markdown.</constraint>
</write>

Handle Git Workflow Before committing, pull latest changes from the remote (if one exists) to avoid conflicts. git -C /.things pull --rebase 2>/dev/null || true Based on the `git_workflow` setting in `config.json`: Would you like to commit and push this learning plan? Yes No Automatically `git add` the study plan, `git commit -m "bridge: "`, and `git push`. Tell the user the plan has been saved and they can commit when ready. Offer to Start Ready to start? Yes -- begin with an explore session on [topic] Not now -- I'll follow the plan on my own Adjust the plan -- I want to change something