Plan: Bundle Claude skills as distributable plugin

[brian-lai]

Summary

This PR introduces a comprehensive plan to bundle the PARA-Programming Claude skills as a distributable plugin in a separate repository.

Key Changes

• 📋 Created detailed implementation plan at context/plans/2025-12-18-claude-skill-plugin.md
• 🔄 Updated execution context with full to-do list
• 🎯 Defined plugin structure following official Claude Code specification

What This Plan Proposes

New Repository: para-programming-plugin (separate from main docs)

Plugin Structure:

para-programming-plugin/
├── .claude-plugin/plugin.json    # Plugin manifest (required)
├── commands/                      # Slash commands (keep existing)
├── hooks/hooks.json              # Convert from .sh to hooks.json
├── templates/                     # Keep existing templates
├── resources/CLAUDE.md           # Global methodology file
└── [docs, scripts, examples...]

Installation Flow:

claude plugin marketplace add para-programming/para-programming-plugin
claude plugin install para-programming@para-programming --scope user

Implementation Steps

The plan is organized into 8 phases:

1. Repository Creation - Set up new GitHub repo with proper structure
2. Structure Migration - Convert claude-skill/ to plugin format
3. Command Updates - Review and update all 7 commands
4. Documentation Rewrite - Update INSTALL.md, README.md for plugin
5. Script Updates - Modify install/uninstall scripts
6. Testing - Cross-platform testing and validation
7. Release - Publish v1.0.0 to GitHub releases
8. Deprecation - Phase out manual installation method

Benefits

• ✅ One-command installation via Claude Code CLI
• ✅ Automatic updates through plugin system
• ✅ Separation of concerns (plugin vs. documentation)
• ✅ Official Claude Code plugin compliance
• ✅ Better discoverability via marketplace

Open Questions

1. Global CLAUDE.md Strategy: Option B (explicit /para-install-global command) recommended
2. Repository Name: para-programming-plugin proposed
3. Version: Start at v1.0.0 (stable release)

Next Steps

Upon approval:

1. Create para-programming-plugin repository
2. Begin structure migration
3. Test plugin installation flow
4. Release and announce

---

Test plan

• Plan document is comprehensive and addresses all aspects
• Plugin structure follows official Claude Code specification
• Implementation steps are clear and actionable
• Human review of approach and strategy
• Approval to proceed with repository creation

🤖 Generated with Claude Code