Skip to content

A Claude Code / Codex plugin that helps you learn how to build while AI writes the code.

Python

docs: describe feedback and follow-ups in the learning loop

Noah Kim026fc0f01223
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index dc6ed32..07a8cbe 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "vibe-wise",
- "version": "0.1.23",
+ "version": "0.1.24",
"description": "You build. AI writes. Learn how to build software while Claude writes the code.",
"author": { "name": "Noah Kim" },
"repository": "https://github.com/nykooi1/vibe-wise",
diff --git a/README.md b/README.md
index 1801d0e..11e1c44 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
**You build. AI writes.**
-A Claude Code plugin that puts learning first while AI writes the code. You work through each meaningful build decision: Claude asks how you'd approach it **before suggesting a solution**, waits for your reasoning, then helps refine it. You review the approach together before Claude implements it.
+A Claude Code plugin that puts learning first while AI writes the code. You work through each meaningful build decision: Claude **asks for your approach first**, then gives feedback, explains unfamiliar concepts, and asks follow-ups where needed. Your reasoning shapes the design. You review the approach together before Claude implements it.
Built for junior or aspiring engineers under pressure to ship with AI. Practice planning how the pieces fit together, anticipating failures, and checking the result—while keeping ownership of the decisions.
@@ -37,7 +37,7 @@ Claude:
| Friends need to read the list without being able to change it. |
| **How would you make sure only the owner can edit?** |
-[Claude waits for your reasoning before offering an approach.]
+[Claude waits for your reasoning before responding.]
You:
I'd check on the server that the person making the change owns the list.
diff --git a/skills/learn/SKILL.md b/skills/learn/SKILL.md
index f76ca72..147ff15 100644
--- a/skills/learn/SKILL.md
+++ b/skills/learn/SKILL.md
@@ -1,6 +1,6 @@
---
name: learn
-description: Activate or resume learning-first development. You reason through decisions before Claude suggests an approach or writes the implementation.
+description: Activate or resume learning-first development. You lead the design; Claude gives feedback, explains concepts, asks follow-ups, and writes the agreed code.
disable-model-invocation: true
---
@@ -9,7 +9,9 @@ disable-model-invocation: true
Activate learning mode in the main conversation. Read [behavior.md](behavior.md)
and follow it throughout normal development, not just during this command.
Learning takes priority over build speed: ask for the learner's approach and wait
-before suggesting yours. An ordinary build request in this mode retains that loop;
+before suggesting yours. Respond to their reasoning with feedback, explanations,
+and follow-ups where needed, not an automatic list of options.
+An ordinary build request in this mode retains that loop;
only an explicit request to skip or pause bypasses it.
Do not switch to a subagent or require manual coding by default.
diff --git a/skills/learn/onboarding.md b/skills/learn/onboarding.md
index 4de77e4..830b487 100644
--- a/skills/learn/onboarding.md
+++ b/skills/learn/onboarding.md
@@ -9,8 +9,9 @@ brief descriptions, a header of at most 12 characters, and `multiSelect: false`.
Use its native keyboard picker, not a printed imitation. If unavailable, ask one
plain-text question. Open-ended answers belong in chat.
-Briefly explain: learning comes first. For each meaningful decision, ask how they'd
-approach it before offering suggestions; AI writes the agreed implementation.
+Briefly explain: learning comes first. Ask for their approach, then give feedback,
+explain unfamiliar concepts, and ask follow-ups where needed. Their reasoning shapes
+the design; AI writes the agreed implementation. Suggestions aren't an automatic next step.
Notes live in .vibe-wise/. Recommend ignoring that directory in Git. Don't
change .gitignore unless requested; announce the edit first.