davila7__claude-code-templates/.claude/rules/cli-tool.md

paths

paths
cli-tool/** src/**

CLI Tool — Component System

This is the npm package claude-code-templates. A Node.js CLI for installing Claude Code components.

Architecture

• Entry point: src/index.js
• Components live in cli-tool/components/{type}/{category}/{name}.md
• Types: agents, commands, mcps, hooks, settings, skills, templates
• Catalog generated by python scripts/generate_components_json.py

Component Files

• Format: Markdown with YAML frontmatter
• Names: kebab-case only (e.g., react-performance-expert.md)
• No hardcoded secrets, API keys, or absolute paths
• Include clear description, usage examples, and tags
• Always validate with the component-reviewer agent before committing

After Adding/Modifying Components

1. Run python scripts/generate_components_json.py to regenerate catalog
2. Copy docs/components.json to dashboard/public/components.json
3. Deploy dashboard

Testing

npm test          # Run all tests
npm run test:watch

Publishing

Always check npm view claude-code-templates version before publishing to avoid version conflicts.