⛔ Create Plugin — STOP AND READ

<!-- ⛔⛔⛔ MANDATORY: READ THIS ENTIRE FILE BEFORE ANY ACTION ⛔⛔⛔ -->

⛔ Create Plugin — STOP AND READ

DO NOT ACT ON ASSUMPTIONS. Read this file first.

This is a structured workflow command for creating a new plugin in a Claude Code marketplace.

Your FIRST and ONLY action right now: Execute the TodoWrite below.

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

⛔ MANDATORY FIRST ACTION: TodoWrite Initialization

YOUR FIRST ACTION MUST BE the TodoWrite call below.

DO NOT:

• ❌ Create any directories before TodoWrite
• ❌ Read marketplace.json before TodoWrite
• ❌ Ask questions before TodoWrite
• ❌ Jump to any phase without completing Step 0

Step 0.1: Detect Marketplace Root

Before executing TodoWrite, verify you're in a marketplace directory:

/​usr/​bin/​env bash << 'PREFLIGHT_EOF'
# Check for marketplace.json in cwd
if [ -f ".claude-plugin/​marketplace.json" ]; then
  echo "✅ Marketplace detected: $(jq -r .name .claude-plugin/​marketplace.json)"
else
  echo "❌ Not a marketplace directory. Run from a marketplace root."
  exit 1
fi
PREFLIGHT_EOF

Step 0.2: Execute MANDATORY TodoWrite

Execute TodoWrite NOW with this template:

TodoWrite with todos:

- "[Plugin] Phase 0: Detect marketplace root" | in_progress
- "[Plugin] Phase 0: Interactive prompts (name, category, components)" | pending
- "[Plugin] Phase 0: Confirm plugin doesn't exist" | pending
- "[Plugin] Phase 1: Skill → plugin-structure (scaffold)" | pending
- "[Plugin] Phase 1: Create plugin directory + plugin.json" | pending
- "[Plugin] Phase 1: Skill → implement-plan-preflight (ADR)" | pending
- "[Plugin] Phase 2: Skill → skill-architecture (if has-skills)" | pending
- "[Plugin] Phase 2: Skill → hook-development (if has-hooks)" | pending
- "[Plugin] Phase 2: Skill → command-development (if has-commands)" | pending
- "[Plugin] Phase 2: Skill → agent-development (if has-agents)" | pending
- "[Plugin] Phase 2: Agent → skill-reviewer (if skills created)" | pending
- "[Plugin] Phase 3: Add to marketplace.json" | pending
- "[Plugin] Phase 3: Run validate-plugins.mjs" | pending
- "[Plugin] Phase 3: Skill → code-hardcode-audit" | pending
- "[Plugin] Phase 3: Agent → plugin-validator" | pending
- "[Plugin] Phase 4: Git commit (conventional format)" | pending
- "[Plugin] Phase 4: Push to remote" | pending
- "[Plugin] Phase 4: Skill → semantic-release" | pending

After TodoWrite completes, proceed to Phase 0 section below.

---

Quick Reference

Skills Invoked (Optimized Sequence)

Skills EXCLUDED (Redundant)

Agents Spawned

File Locations

---

Phase 0: Discovery & Validation

Detect marketplace root, gather plugin name/​category/​components via interactive prompts, confirm the plugin does not already exist.

Detailed steps: Phase 0 Reference

Phase 0 Gate

• Marketplace root detected (.claude-plugin/​marketplace.json exists)
• Plugin name collected (kebab-case, no spaces)
• Category selected
• Components selected (skills/​hooks/​commands/​agents)
• Plugin directory does NOT exist
• Plugin NOT in marketplace.json

---

Phase 1: Scaffold Plugin

1. Invoke Skill(plugin-dev:plugin-structure) -- directory & manifest patterns
2. Create plugin directory with component subdirs based on user selections
3. Generate plugin.json using marketplace version
4. Invoke Skill(itp:implement-plan-preflight) -- creates ADR + Design Spec + diagrams

Detailed steps: Phase 1 Reference

Phase 1 Gate

• Plugin directory exists: plugins/​$PLUGIN_NAME/
• plugin.json created with marketplace version
• ADR exists: docs/​adr/​$ADR_ID.md
• Design spec exists: docs/​design/​$ADR_ID/​spec.md
• Both diagrams in ADR (Before/​After + Architecture)

---

Phase 2: Component Creation (Conditional)

Execute ONLY the skills for components the user selected:

Detailed steps: Phase 2 Reference

Phase 2 Gate

• All selected components created
• If skills: skill-reviewer agent completed review
• Files follow plugin-dev patterns

---

Phase 3: Registration & Validation

1. Add plugin to marketplace.json (include hooks field if hooks exist)
2. Run node scripts/​validate-plugins.mjs -- expect all-pass
3. Invoke Skill(itp:code-hardcode-audit) -- quality audit
4. Run silent failure audit on all hook entry points
5. Spawn Task(plugin-dev:plugin-validator) -- structural validation

Detailed steps: Phase 3 Reference

Phase 3 Gate

• Plugin added to marketplace.json
• validate-plugins.mjs passes
• code-hardcode-audit passes
• silent-failure-audit passes (no errors)
• plugin-validator agent approves

---

Phase 4: Commit & Release

1. Stage changes: plugin dir, marketplace.json, ADR, design spec
2. Conventional commit: feat($PLUGIN_NAME): add plugin for [brief description]
3. Push to remote
4. Invoke Skill(mise:run-full-release) -- run repo's mise release pipeline for tag, changelog, GitHub release

Detailed steps: Phase 4 Reference

Phase 4 Success Criteria

• All changes committed with conventional commit
• Pushed to remote
• semantic-release completed
• New version tag created
• GitHub release published

Troubleshooting

See Troubleshooting Reference for common issues and fixes.

Post-Execution Reflection

After this skill completes, reflect before closing the task:

1. Locate yourself. — Find this SKILL.md's canonical path (Glob for this skill's name) before editing. All corrections target THIS file and its sibling references/ — never other documentation.
2. What failed? — Fix the instruction that caused it. If it could recur, add it as an anti-pattern.
3. What worked better than expected? — Promote it to recommended practice. Document why.
4. What drifted? — Any script, reference, or external dependency that no longer matches reality gets fixed now.
5. Log it. — Every change gets an evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

---

---