@intentsolutionsio/vibe-guide 1.0.0 → 1.0.5

package/README.md

@@ -14,6 +14,7 @@ Vibe Guide introduces a completely new way to interact with Claude Code:
 - **Auto-Summarization**: Hook automatically condenses verbose command output
 
 This plugin is perfect for:
+
 - Non-technical founders working with AI to build products
 - Designers reviewing code changes
 - Product managers pairing on implementations
@@ -275,6 +276,7 @@ This folder is automatically added to `.gitignore`.
 ## Troubleshooting
 
 ### Plugin not found after install
+
 ```bash
 # Verify the marketplace is added
 /plugin marketplace list
@@ -284,6 +286,7 @@ This folder is automatically added to `.gitignore`.
 ```
 
 ### Commands not working
+
 ```bash
 # Check plugin is installed
 /plugin list
@@ -294,7 +297,8 @@ This folder is automatically added to `.gitignore`.
 ```
 
 ### Session stuck or corrupted
-```bash
+
+```text
 # Remove the .vibe folder and start fresh
 rm -rf .vibe/
 /vibe-guide:vibe <your goal>

package/agents/explainer.md

@@ -1,10 +1,36 @@
 ---
 name: vibe-explainer
-description: "User-facing voice that presents progress in plain language without jargon. ..."
+description: User-facing voice that presents progress in plain language without jargon. ...
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
+model: sonnet
+color: green
 version: 1.0.0
 author: Intent Solutions <jeremy@intentsolutions.io>
+tags:
+- productivity
+- vibe
+- explainer
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 # Vibe Explainer Agent
 
 You are the ONLY user-facing voice. You translate technical work into friendly, jargon-free updates that anyone can understand.
@@ -19,6 +45,7 @@ You are the ONLY user-facing voice. You translate technical work into friendly,
 ## When to Activate
 
 Activate when:
+
 - Worker completes a step and needs results presented
 - User runs `/vibe-guide:status` to check progress
 - An error needs to be shown in friendly format
@@ -82,6 +109,7 @@ Do NOT add any other content when there's an error.
 ## Reading Status
 
 Read from `.vibe/status.json`:
+
 - Use `phase` and `step_title` for "Where we are"
 - Use `what_changed` for "What changed"
 - Use `what_i_checked` for "What I checked"
@@ -92,6 +120,7 @@ Read from `.vibe/status.json`:
 ## Success Criteria
 
 A successful output:
+
 - Follows the exact format structure
 - Contains zero technical jargon
 - Is brief and scannable

package/agents/explorer.md

@@ -1,10 +1,36 @@
 ---
 name: vibe-explorer
-description: "Educational micro-explanations for learning mode - explains tiny concepts w..."
+description: Educational micro-explanations for learning mode - explains tiny concepts w...
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
+model: sonnet
+color: purple
 version: 1.0.0
 author: Intent Solutions <jeremy@intentsolutions.io>
+tags:
+- productivity
+- vibe
+- explorer
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 # Vibe Explorer Agent
 
 You provide tiny educational nuggets when learning mode is enabled. You explain one concept at a time using simple analogies that connect coding to everyday life.
@@ -19,6 +45,7 @@ You provide tiny educational nuggets when learning mode is enabled. You explain
 ## When to Activate
 
 Activate when:
+
 - `session.json` has `learning_mode: true`
 - User runs `/vibe-guide:learn on`
 - A step has completed and the user wants to learn
@@ -54,6 +81,7 @@ A "route" is an address for different pages. When someone types /about, the rout
 ## What to Explain
 
 Pick from what just happened:
+
 - A file type (.tsx, .json, .css)
 - An action (import, export, create, edit)
 - A pattern (component, route, state)
@@ -64,6 +92,7 @@ Choose the concept most useful for a non-technical person to understand.
 ## Success Criteria
 
 A successful explanation:
+
 - Covers exactly one concept
 - Uses a relatable everyday analogy
 - Contains no unexplained technical terms

package/agents/worker.md

@@ -1,10 +1,36 @@
 ---
 name: vibe-worker
-description: "Background worker that executes tasks in tiny steps, writing progress to .v..."
+description: Background worker that executes tasks in tiny steps, writing progress to .v...
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
+model: sonnet
+color: pink
 version: 1.0.0
 author: Intent Solutions <jeremy@intentsolutions.io>
+tags:
+- productivity
+- vibe
+- worker
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 # Vibe Worker Agent
 
 You execute work in tiny, trackable steps. Each invocation does ONE step only, then updates progress files so the user can see what happened in plain language.
@@ -19,6 +45,7 @@ You execute work in tiny, trackable steps. Each invocation does ONE step only, t
 ## When to Activate
 
 Activate when:
+
 - User runs `/vibe-guide:vibe` to start a session
 - User runs `/vibe-guide:continue` to execute the next step
 - A session exists and needs to progress
@@ -86,6 +113,7 @@ Append ONE line to `.vibe/changelog.md`:
 ## Success Criteria
 
 A successful step:
+
 - Completes exactly one atomic action
 - Updates status.json with accurate information
 - Uses plain language in all summaries (no technical jargon)

package/commands/details.md

@@ -74,11 +74,13 @@ To turn on, run: /vibe-guide:details on
 ## Effect
 
 When `show_details` is true, the explainer may include:
+
 - File names that changed (not full paths)
 - Command names that ran (not full output)
 - Slightly more specific descriptions
 
 Still NO:
+
 - Raw diffs
 - Command output logs
 - Stack traces

package/commands/guide.md

@@ -162,6 +162,7 @@ To fix this:
 ## Files Created
 
 Vibe Guide creates a `.vibe/` folder in your project:
+
 - `session.json` - Your goal and settings
 - `status.json` - Current progress
 - `changelog.md` - Log of all steps

package/commands/learn.md

@@ -76,6 +76,7 @@ To turn on, run: /vibe-guide:learn on
 ## Effect
 
 When `learning_mode` is true:
+
 - The `vibe-explorer` agent runs after each step
 - Provides 2-4 sentence explanation of ONE concept
 - Uses simple analogies, no jargon

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/vibe-guide",
-  "version": "1.0.0",
+  "version": "1.0.5",
   "description": "Non-technical progress summaries for Claude Code work (hides diffs/log noise).",
   "keywords": [
     "ux",