Skip to content

Conversation

@brian-lai
Copy link
Owner

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

brian-lai and others added 5 commits December 18, 2025 09:15
This commit initializes the execution phase for bundling the PARA-Programming
Claude skills as a distributable plugin. The plan includes:

- Creating a separate para-programming-plugin repository
- Converting claude-skill/ to official Claude Code plugin format
- Enabling installation via claude plugin install
- Maintaining consistency with main documentation repo

Plan details at context/plans/2025-12-18-claude-skill-plugin.md
Branch: para/claude-skill-plugin

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Update main documentation to highlight the new plugin:
- Add plugin installation to quick start
- Update platform comparison table
- Add deprecation notice to claude-skill directory
- Create DEPRECATED.md migration guide
- Update README.md recommendations

The plugin provides:
- One-command installation
- Automatic updates
- Official Claude Code plugin structure
- Better discoverability

Migration guide available at claude-skill/DEPRECATED.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Major progress on plugin bundling:
- Repository created and structured
- Plugin manifest and hooks configured
- v1.0.0 release published
- Documentation updated and deprecation notices added

Remaining: testing, CI/CD, and announcement

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Updates:
- Fix README.md quick start with correct /plugin commands
- Update claude-skill/README.md with correct syntax
- Update claude-skill/DEPRECATED.md migration guide
- Change from 'claude plugin' to '/plugin' CLI syntax
- Fix marketplace identifier to include full repo path

Correct installation:
/plugin marketplace add brian-lai/para-programming-plugin
/plugin install para-programming@brian-lai/para-programming-plugin

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Changes:
- Update plugin name from 'para-programming' to 'para-program'
- Simplify command references throughout documentation
- Update installation examples

New installation:
/plugin install para-program@brian-lai/para-programming-plugin

New command pattern:
/para-program:init, /para-program:plan, /para-program:execute, etc.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants