Initial commit
This commit is contained in:
Zhongwei Li
200
commands/add-package.md
Normal file
200
commands/add-package.md
Normal file
@@ -0,0 +1,200 @@
|
||||
---
|
||||
description: Setup distribution packaging (npm, PyPI, Homebrew)
|
||||
argument-hint: [platform] [platform-2] [platform-3] ...
|
||||
allowed-tools: Task, AskUserQuestion, Bash, Read, Glob
|
||||
---
|
||||
|
||||
---
|
||||
🚨 **EXECUTION NOTICE FOR CLAUDE**
|
||||
|
||||
When you invoke this command via SlashCommand, the system returns THESE INSTRUCTIONS below.
|
||||
|
||||
**YOU are the executor. This is NOT an autonomous subprocess.**
|
||||
|
||||
- ✅ The phases below are YOUR execution checklist
|
||||
- ✅ YOU must run each phase immediately using tools (Bash, Read, Write, Edit, TodoWrite)
|
||||
- ✅ Complete ALL phases before considering this command done
|
||||
- ❌ DON't wait for "the command to complete" - YOU complete it by executing the phases
|
||||
- ❌ DON't treat this as status output - it IS your instruction set
|
||||
|
||||
**Immediately after SlashCommand returns, start executing Phase 0, then Phase 1, etc.**
|
||||
|
||||
See `@CLAUDE.md` section "SlashCommand Execution - YOU Are The Executor" for detailed explanation.
|
||||
|
||||
---
|
||||
|
||||
|
||||
**Arguments**: $ARGUMENTS
|
||||
|
||||
Goal: Orchestrate setting up distribution packaging for CLI tool, launching parallel agents for 3+ platforms.
|
||||
|
||||
**Architectural Context:**
|
||||
|
||||
This command is an **orchestrator** that:
|
||||
- Detects the CLI framework
|
||||
- Gathers requirements
|
||||
- Launches 1 agent for 1-2 distribution platforms
|
||||
- Launches MULTIPLE agents IN PARALLEL for 3+ platforms (all in ONE message)
|
||||
|
||||
Phase 1: Load Architectural Framework
|
||||
Goal: Understand composition and parallelization patterns
|
||||
|
||||
Actions:
|
||||
- Load component decision framework:
|
||||
!{Read ~/.claude/plugins/marketplaces/domain-plugin-builder/plugins/domain-plugin-builder/docs/frameworks/claude/reference/component-decision-framework.md}
|
||||
- Key patterns:
|
||||
- Commands orchestrate, agents implement
|
||||
- For 3+ items: Launch multiple agents in PARALLEL
|
||||
- Send ALL Task() calls in SINGLE message
|
||||
- Agents run concurrently for faster execution
|
||||
|
||||
Phase 2: Parse Arguments & Determine Mode
|
||||
Goal: Count how many distribution platforms to configure
|
||||
|
||||
Actions:
|
||||
- Parse $ARGUMENTS to extract platforms:
|
||||
!{bash echo "$ARGUMENTS" | wc -w}
|
||||
- Store count
|
||||
- Extract each platform:
|
||||
- If count = 0: Ask user for platform preference
|
||||
- If count = 1: Single platform mode
|
||||
- If count = 2: Two platforms mode
|
||||
- If count >= 3: **PARALLEL MODE** - multiple agents
|
||||
|
||||
Phase 3: Detect Existing CLI Framework
|
||||
Goal: Identify the framework and language
|
||||
|
||||
Actions:
|
||||
- Check for language indicators:
|
||||
- !{bash ls -1 package.json setup.py pyproject.toml go.mod Cargo.toml 2>/dev/null | head -1}
|
||||
- For Node.js (package.json found):
|
||||
- !{bash grep -E '"(commander|yargs|oclif|gluegun)"' package.json 2>/dev/null | head -1}
|
||||
- For Python files:
|
||||
- !{bash grep -r "import click\|import typer\|import argparse\|import fire" . --include="*.py" 2>/dev/null | head -1}
|
||||
- For Go:
|
||||
- !{bash grep -r "github.com/spf13/cobra\|github.com/urfave/cli" . --include="*.go" 2>/dev/null | head -1}
|
||||
- For Rust:
|
||||
- !{bash grep "clap" Cargo.toml 2>/dev/null}
|
||||
- Store detected framework and language
|
||||
|
||||
Phase 4: Gather Requirements (for all platforms)
|
||||
Goal: Collect specifications
|
||||
|
||||
Actions:
|
||||
- If no platforms in $ARGUMENTS:
|
||||
- Ask user via AskUserQuestion:
|
||||
- Which distribution platforms? (npm, pypi, homebrew, binary, cargo, go-install)
|
||||
- CLI tool name?
|
||||
- Current version? (default: 0.1.0)
|
||||
- GitHub repository URL? (for releases)
|
||||
- Automated releases via GitHub Actions?
|
||||
- For EACH platform from Phase 2:
|
||||
- Store platform type (npm, pypi, homebrew, binary, cargo, go-install)
|
||||
- Determine version management approach
|
||||
- Plan release automation
|
||||
|
||||
Phase 5: Launch Agent(s) for Implementation
|
||||
Goal: Delegate to cli-feature-impl agent(s)
|
||||
|
||||
Actions:
|
||||
|
||||
**Decision: 1-2 platforms = single/sequential agents, 3+ platforms = PARALLEL agents**
|
||||
|
||||
**For 1-2 Distribution Platforms:**
|
||||
|
||||
Task(
|
||||
description="Add package distribution to CLI",
|
||||
subagent_type="cli-tool-builder:cli-feature-impl",
|
||||
prompt="You are cli-feature-impl. Add distribution packaging to the CLI.
|
||||
|
||||
Framework: {detected_framework}
|
||||
Language: {detected_language}
|
||||
|
||||
Distribution Platforms: {platforms}
|
||||
Requirements:
|
||||
- Platforms: {npm/pypi/homebrew/binary/cargo/go-install}
|
||||
- CLI tool name: {tool_name}
|
||||
- Version: {version}
|
||||
- GitHub repo: {github_url}
|
||||
- Automated releases: {yes/no}
|
||||
- Version management: {standard-version/bump2version/goreleaser}
|
||||
|
||||
Use Skill(cli-tool-builder:{framework}-patterns) for patterns.
|
||||
Generate package configuration, release workflows, installation docs.
|
||||
|
||||
Deliverable: Working package distribution setup for CLI"
|
||||
)
|
||||
|
||||
**For 3+ Distribution Platforms - CRITICAL: Send ALL Task() calls in ONE MESSAGE:**
|
||||
|
||||
Task(description="Add platform 1", subagent_type="cli-tool-builder:cli-feature-impl", prompt="Add distribution packaging for '{platform_1}'.
|
||||
Framework: {framework}
|
||||
Language: {language}
|
||||
Platform: {platform_1}
|
||||
Tool name: {tool_name}
|
||||
Version: {version}
|
||||
Use Skill(cli-tool-builder:{framework}-patterns).
|
||||
Deliverable: Package config for {platform_1}")
|
||||
|
||||
Task(description="Add platform 2", subagent_type="cli-tool-builder:cli-feature-impl", prompt="Add distribution packaging for '{platform_2}'.
|
||||
Framework: {framework}
|
||||
Language: {language}
|
||||
Platform: {platform_2}
|
||||
Tool name: {tool_name}
|
||||
Version: {version}
|
||||
Use Skill(cli-tool-builder:{framework}-patterns).
|
||||
Deliverable: Package config for {platform_2}")
|
||||
|
||||
Task(description="Add platform 3", subagent_type="cli-tool-builder:cli-feature-impl", prompt="Add distribution packaging for '{platform_3}'.
|
||||
Framework: {framework}
|
||||
Language: {language}
|
||||
Platform: {platform_3}
|
||||
Tool name: {tool_name}
|
||||
Version: {version}
|
||||
Use Skill(cli-tool-builder:{framework}-patterns).
|
||||
Deliverable: Package config for {platform_3}")
|
||||
|
||||
[Continue for all N platforms...]
|
||||
|
||||
**DO NOT wait between Task() calls - send them ALL at once!**
|
||||
|
||||
Agents run in parallel. Proceed to Phase 6 only after ALL complete.
|
||||
|
||||
Phase 6: Verification
|
||||
Goal: Confirm all platforms were configured
|
||||
|
||||
Actions:
|
||||
- For each platform:
|
||||
- Verify package configuration was generated
|
||||
- Check syntax if possible
|
||||
- Test build process (if applicable)
|
||||
- Verify version management works
|
||||
- Test release workflow (dry-run if applicable)
|
||||
- Verify installation documentation complete
|
||||
- Report any failures
|
||||
|
||||
Phase 7: Summary
|
||||
Goal: Report results and next steps
|
||||
|
||||
Actions:
|
||||
- Display summary:
|
||||
- Platforms configured: {count}
|
||||
- Framework: {framework}
|
||||
- Tool name: {tool_name}
|
||||
- Version: {version}
|
||||
- Files modified/created
|
||||
- Release automation configured
|
||||
- Show installation commands for each platform:
|
||||
- npm: npm install -g {tool_name}
|
||||
- PyPI: pip install {tool_name}
|
||||
- Homebrew: brew install {user}/{tap}/{tool_name}
|
||||
- Binary: Download and install instructions
|
||||
- Cargo: cargo install {tool_name}
|
||||
- Go: go install github.com/{user}/{tool_name}@latest
|
||||
- Suggest next steps:
|
||||
- Test package installation locally
|
||||
- Create initial release tag
|
||||
- Update documentation with badges
|
||||
- Set up CI/CD secrets for automated publishing
|
||||
- Test version bumping workflow
|
||||
- Create CHANGELOG.md
|
||||
Reference in New Issue
Block a user