Skip to content

Commit a872f35

Browse files
mjunaidcaclaude
andcommitted
refactor: remove Module 6, add resilience notes, update guides
- Delete module-6-marketplace-distribution (exercises 6.1 and 6.2) - Merge marketplace creation into Capstone A (Step 6) - Add resilience notes to exercises 3.1, 4.1, 7.1 - Fix ralph-wiggum → ralph-loop plugin name in exercise 7.1 - Update EXERCISE-GUIDE.md and README.md: 6 modules, 15 exercises Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 2048e21 commit a872f35

File tree

16 files changed

+62
-403
lines changed

16 files changed

+62
-403
lines changed

EXERCISE-GUIDE.md

Lines changed: 16 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,11 @@ _By Panaversity -- Configure, Extend, Automate_
88

99
## How This Guide Works
1010

11-
Every exercise in this guide teaches one layer of Claude Code's extensibility system -- from configuring settings through building and distributing plugins to running autonomous iteration loops. These aren't abstract concepts. They are working configurations you build, test, and debug on real scenarios.
11+
This guide contains 12 core exercises across 6 modules plus 3 capstone projects (15 total). Each exercise teaches one layer of Claude Code's extensibility system -- from configuring settings through building and distributing plugins to running autonomous iteration loops. These aren't abstract concepts. They are working configurations you build, test, and debug on real scenarios.
1212

1313
**The exercise pattern:**
1414

15-
Each module covers one extensibility layer with two exercises. Exercise X.1 is **Hands-on** -- you build or configure something real. Exercise X.2 is **Debug/Diagnose** -- you fix a broken configuration, audit a problematic setup, or analyze a failure.
15+
Each module covers one extensibility layer with two exercises. Exercise X.1 is **Hands-on** -- you build or configure something real. Exercise X.2 is **Debug/Diagnose** -- you fix a broken configuration, audit a problematic setup, or analyze a failure. Marketplace distribution is integrated into the Capstone A project rather than being a standalone module.
1616

1717
**The three skills you'll develop:**
1818

@@ -267,7 +267,7 @@ Packaging is just organization plus a manifest. The skills themselves don't chan
267267

268268
---
269269

270-
### Exercise 5.2 -- Full Plugin Bundle
270+
### Exercise 5.2 -- Full Plugin Bundle (Advanced)
271271

272272
**The Problem:**
273273
A complete "Team Productivity" plugin needs skills, hooks, and an MCP server configuration bundled together. This is the full plugin packaging exercise -- everything you've learned about skills, hooks, and plugins combined into one distributable package.
@@ -290,57 +290,6 @@ A complete "Team Productivity" plugin needs skills, hooks, and an MCP server con
290290

291291
---
292292

293-
## Module 6: Marketplace Distribution
294-
295-
> **Core Skill:** Create plugin marketplaces and distribute plugins to teams and the community.
296-
297-
### Exercise 6.1 -- Create Marketplace
298-
299-
**The Problem:**
300-
You have two plugins ready to share with your team, but they need a marketplace to discover and install them easily. You need to create a marketplace listing, organize the directory structure, and configure it as a marketplace source.
301-
302-
**Your Task:**
303-
304-
1. Create the marketplace directory structure
305-
2. Write a `marketplace.json` listing the two provided plugins
306-
3. Add the plugins to the marketplace directory
307-
4. Configure the marketplace as a source using `/plugin marketplace add`
308-
5. Verify plugins appear in the Discover tab
309-
310-
**The Principle at Work:**
311-
A marketplace is just a catalog -- a `marketplace.json` file that points to plugin directories. The infrastructure is simple; the value is in organization and discoverability.
312-
313-
**What You'll Learn:**
314-
315-
- The `marketplace.json` format and required fields
316-
- How marketplace sources work (local, GitHub, GitLab)
317-
- The relationship between plugins and marketplaces (apps vs. app store)
318-
- How to test marketplace listings locally before publishing
319-
320-
---
321-
322-
### Exercise 6.2 -- Cross-Marketplace
323-
324-
**The Problem:**
325-
You're evaluating plugins from three different marketplace sources (official Anthropic, a community marketplace, and a company-internal marketplace). Each has plugins that partially overlap. You need to compare them and recommend the best plugin for a specific need.
326-
327-
**Your Task:**
328-
329-
1. Review the three marketplace listings provided
330-
2. Compare overlapping plugins across marketplaces
331-
3. Evaluate each based on: feature fit, maintenance quality, scope, and trust level
332-
4. Write a recommendation document with your analysis
333-
5. Create a "marketplace evaluation framework" for future decisions
334-
335-
**What You'll Learn:**
336-
337-
- How to evaluate plugin quality across different sources
338-
- Trust considerations: official vs. community vs. internal marketplaces
339-
- Feature overlap resolution: when two plugins solve the same problem
340-
- Documentation standards for plugin recommendations
341-
342-
---
343-
344293
## Module 7: Ralph Wiggum Loop
345294

346295
> **Core Skill:** Design and execute autonomous iteration loops with proper completion promises, safety guardrails, and cost awareness.
@@ -401,23 +350,24 @@ An activity log from a Ralph Wiggum Loop that ran for 12 iterations without comp
401350
### Capstone A -- Full Plugin from Scratch
402351

403352
**The Problem:**
404-
Build a complete "Code Review" plugin that includes skills for review patterns, hooks for automated checks, and documentation for team adoption. Package it, test it, and create a marketplace entry.
353+
Build a complete "Code Review" plugin that includes skills for review patterns, hooks for automated checks, and documentation for team adoption. Package it, test it, create a marketplace entry, and distribute it.
405354

406355
**Your Task:**
407356

408357
1. Design the plugin: define skills, hooks, and configurations needed
409358
2. Create each component: skills for review checklists, hooks for pre-commit checks
410359
3. Write the plugin manifest (`plugin.json`)
411-
4. Create marketplace entry (`marketplace.json`)
412-
5. Test the complete plugin locally with `--plugin-dir`
413-
6. Write user documentation explaining how to install and use the plugin
360+
4. Test the complete plugin locally with `--plugin-dir`
361+
5. Write user documentation explaining how to install and use the plugin
362+
6. Create a marketplace listing and distribute the plugin
414363

415364
**Deliverables:**
416365

417366
- Working plugin directory with all components
418367
- Plugin manifest and marketplace listing
419368
- User documentation (README.md inside the plugin)
420369
- Test results showing all components work together
370+
- Marketplace entry with installation instructions
421371

422372
**Estimated Time:** 2-4 hours
423373

@@ -477,15 +427,14 @@ Audit your own Claude Code workflow and identify what's missing from your extens
477427

478428
For each exercise, evaluate yourself on:
479429

480-
| Criteria | Beginner (1) | Developing (2) | Proficient (3) | Advanced (4) |
481-
| ---------------------- | :----------------------------: | :---------------------------------: | :--------------------------------------------: | :----------------------------------------: |
482-
| Settings Understanding | Uses only defaults | Configured one level | Manages all 3 levels with correct precedence | Designs team-wide configuration strategies |
483-
| Hook Implementation | Cannot create hooks | Basic hooks, no error handling | Multi-event hooks with matchers and exit codes | Production hooks with logging and testing |
484-
| Plugin Evaluation | Cannot navigate marketplace | Browses marketplace | Evaluates fit systematically | Creates evaluation frameworks for teams |
485-
| Plugin Creation | Cannot create manifest | Basic manifest with skills | Full bundle with hooks + MCP | Production plugins with docs and tests |
486-
| Marketplace Competence | Unaware of marketplace concept | Uses official marketplace | Creates personal marketplaces | Multi-source marketplace strategy |
487-
| Autonomous Iteration | Never used Ralph Loop | Basic loop, poor completion promise | Effective promises with safety limits | Complex loops with cost management |
488-
| Integration Thinking | Components in isolation | Combines 2 components | Full extensibility stack | Team-wide extensibility architecture |
430+
| Criteria | Beginner (1) | Developing (2) | Proficient (3) | Advanced (4) |
431+
| ---------------------- | :-------------------------: | :---------------------------------: | :--------------------------------------------: | :---------------------------------------------------------------: |
432+
| Settings Understanding | Uses only defaults | Configured one level | Manages all 3 levels with correct precedence | Designs team-wide configuration strategies |
433+
| Hook Implementation | Cannot create hooks | Basic hooks, no error handling | Multi-event hooks with matchers and exit codes | Production hooks with logging and testing |
434+
| Plugin Evaluation | Cannot navigate marketplace | Browses marketplace | Evaluates fit systematically | Creates evaluation frameworks for teams |
435+
| Plugin Creation | Cannot create manifest | Basic manifest with skills | Full bundle with hooks + MCP | Production plugins with docs, tests, and marketplace distribution |
436+
| Autonomous Iteration | Never used Ralph Loop | Basic loop, poor completion promise | Effective promises with safety limits | Complex loops with cost management |
437+
| Integration Thinking | Components in isolation | Combines 2 components | Full extensibility stack | Team-wide extensibility architecture |
489438

490439
---
491440

README.md

Lines changed: 13 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
**By Panaversity -- Master the Full Plugin Lifecycle**
44

5-
Welcome! This package contains 14 exercises + 3 capstone projects covering Claude Code's extensibility system -- from settings hierarchy and hooks through plugin creation, marketplace distribution, and autonomous iteration with Ralph Wiggum Loop. You'll configure real settings, write working hooks, build plugins from scratch, and run autonomous loops.
5+
Welcome! This package contains 12 exercises + 3 capstone projects (15 total) covering Claude Code's extensibility system -- from settings hierarchy and hooks through plugin creation and autonomous iteration with Ralph Wiggum Loop. You'll configure real settings, write working hooks, build plugins from scratch, distribute them via marketplaces (in Capstone A), and run autonomous loops.
66

77
---
88

@@ -26,15 +26,12 @@ plugins-exercises/
2626
| +-- exercise-4.2-plugin-workflow-chain/ (chain plugins for a complete workflow)
2727
+-- module-5-plugin-packaging/
2828
| +-- exercise-5.1-package-skills-plugin/ (package skills into a plugin)
29-
| +-- exercise-5.2-full-plugin-bundle/ (build a complete plugin bundle)
30-
+-- module-6-marketplace-distribution/
31-
| +-- exercise-6.1-create-marketplace/ (create a marketplace listing)
32-
| +-- exercise-6.2-cross-marketplace/ (evaluate and compare marketplaces)
29+
| +-- exercise-5.2-full-plugin-bundle/ (build a complete plugin bundle -- Advanced)
3330
+-- module-7-ralph-wiggum/
3431
| +-- exercise-7.1-autonomous-loop/ (run your first Ralph Wiggum loop)
3532
| +-- exercise-7.2-stuck-loop-debug/ (diagnose a stuck loop from logs)
3633
+-- module-8-capstones/
37-
+-- capstone-A-full-plugin/ (build a complete plugin from scratch)
34+
+-- capstone-A-full-plugin/ (build a complete plugin + marketplace distribution)
3835
+-- capstone-B-team-extensibility-kit/ (design extensibility for a team)
3936
+-- capstone-C-your-workflow/ (audit and extend your own workflow)
4037
```
@@ -67,9 +64,8 @@ plugins-exercises/
6764
**Week 3 (Plugin Discovery):** Exercises 3.1, 3.2
6865
**Week 4 (Plugin Usage):** Exercises 4.1, 4.2
6966
**Week 5 (Plugin Packaging):** Exercises 5.1, 5.2
70-
**Week 6 (Marketplace Distribution):** Exercises 6.1, 6.2
71-
**Week 7 (Ralph Wiggum Loop):** Exercises 7.1, 7.2
72-
**Week 8 (Capstone):** Choose one capstone project
67+
**Week 6 (Ralph Wiggum Loop):** Exercises 7.1, 7.2
68+
**Week 7 (Capstone):** Choose one capstone project
7369

7470
---
7571

@@ -88,15 +84,14 @@ Use this for every exercise:
8884

8985
## Self-Assessment Rubric
9086

91-
| Criteria | Beginner (1) | Developing (2) | Proficient (3) | Advanced (4) |
92-
| ---------------------- | :--------------------------: | :-----------------------------: | :------------------------------------: | :--------------------------------------------: |
93-
| Settings Understanding | Uses only default settings | Configured one level | Manages all 3 levels with precedence | Designs team-wide configuration strategies |
94-
| Hook Design | Cannot create hooks | Basic single-event hooks | Multi-event hooks with matchers | Hook systems with error handling and logging |
95-
| Plugin Usage | Cannot install plugins | Installs and uses basic plugins | Evaluates plugin fit for workflows | Chains plugins for complex workflows |
96-
| Plugin Creation | Cannot create plugins | Basic manifest with skills only | Full plugin bundle with hooks + MCP | Production-quality plugins with documentation |
97-
| Marketplace Knowledge | Unaware of marketplaces | Uses official marketplace | Creates personal marketplaces | Manages multi-source marketplace strategy |
98-
| Autonomous Iteration | Never used Ralph Loop | Basic loop with simple task | Effective completion promises + safety | Complex multi-stage loops with cost management |
99-
| Integration Thinking | Components used in isolation | Combines 2 components | Full extensibility stack configured | Team-wide extensibility architecture |
87+
| Criteria | Beginner (1) | Developing (2) | Proficient (3) | Advanced (4) |
88+
| ---------------------- | :--------------------------: | :-----------------------------: | :------------------------------------: | :---------------------------------------------------------------: |
89+
| Settings Understanding | Uses only default settings | Configured one level | Manages all 3 levels with precedence | Designs team-wide configuration strategies |
90+
| Hook Design | Cannot create hooks | Basic single-event hooks | Multi-event hooks with matchers | Hook systems with error handling and logging |
91+
| Plugin Usage | Cannot install plugins | Installs and uses basic plugins | Evaluates plugin fit for workflows | Chains plugins for complex workflows |
92+
| Plugin Creation | Cannot create plugins | Basic manifest with skills only | Full plugin bundle with hooks + MCP | Production plugins with docs, tests, and marketplace distribution |
93+
| Autonomous Iteration | Never used Ralph Loop | Basic loop with simple task | Effective completion promises + safety | Complex multi-stage loops with cost management |
94+
| Integration Thinking | Components used in isolation | Combines 2 components | Full extensibility stack configured | Team-wide extensibility architecture |
10095

10196
---
10297

module-3-plugin-discovery/exercise-3.1-marketplace-explorer/INSTRUCTIONS.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,8 @@ Learn to survey the Claude Code plugin marketplace and make informed decisions a
1313

1414
## Your Tasks
1515

16+
> **Note**: The plugin marketplace evolves over time. If no plugin matches a workflow need, that's a valid finding — recommend "Build Custom" and describe what you'd create. The evaluation PROCESS matters more than finding a perfect match.
17+
1618
### Step 1: Review the Workflow Needs
1719

1820
Read `workflow-needs.md` carefully. Each need describes a concrete workflow problem that might be solved by an existing plugin.

module-4-plugin-usage/exercise-4.1-install-and-use/INSTRUCTIONS.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ Install a plugin from the official marketplace and use it on a real project. Exp
1212

1313
## Your Tasks
1414

15+
> **Prerequisites check**: Run `npm --version` to verify Node.js is installed. If installing an LSP plugin, ensure the language server binary is available (e.g., `typescript-language-server --version`). If LSP installation fails, complete the exercise using only `commit-commands` — the core learning is the install-configure-verify cycle, not the specific plugin.
16+
1517
### Step 1: Install the commit-commands Plugin
1618

1719
Install from the official marketplace:

module-6-marketplace-distribution/exercise-6.1-create-marketplace/INSTRUCTIONS.md

Lines changed: 0 additions & 85 deletions
This file was deleted.

module-6-marketplace-distribution/exercise-6.1-create-marketplace/plugins/code-quality/.claude-plugin/plugin.json

Lines changed: 0 additions & 8 deletions
This file was deleted.

module-6-marketplace-distribution/exercise-6.1-create-marketplace/plugins/code-quality/skills/lint-check/SKILL.md

Lines changed: 0 additions & 34 deletions
This file was deleted.

module-6-marketplace-distribution/exercise-6.1-create-marketplace/plugins/productivity/.claude-plugin/plugin.json

Lines changed: 0 additions & 8 deletions
This file was deleted.

module-6-marketplace-distribution/exercise-6.1-create-marketplace/plugins/productivity/skills/daily-standup/SKILL.md

Lines changed: 0 additions & 28 deletions
This file was deleted.

0 commit comments

Comments
 (0)