claude-code-templates: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code when working with this repository.

Project Overview

Node.js CLI tool for managing Claude Code components (agents, commands, MCPs, hooks, settings) with a static website for browsing and installing components. The dashboard and its API routes are deployed on Cloudflare Pages, with supporting cron and monitoring tasks running as Cloudflare Workers.

Essential Commands

# Development
npm install                    # Install dependencies
npm test                       # Run tests
npm version X.Y.Z --ignore-scripts=false  # Sync, commit, and tag all package versions
npm run version:set -- X.Y.Z   # Sync versions without creating a commit or tag
npm publish --ignore-scripts=false  # Publish and run the trusted prepublish guard

# Component catalog
python scripts/generate_components_json.py                   # Update docs/components.json (pulls download counts from Supabase: minutes)
python scripts/generate_components_json.py --skip-downloads  # Same, keeping the counts already in the catalog: seconds

# Dashboard + API (Astro on Cloudflare Pages)
cd dashboard && npm run build  # Build before deploy
npm run deploy                 # Deploy www + app.aitmpl.com via wrangler

Deploys to production happen automatically via GitHub Actions on push to main (changes in dashboard/**). Manual deploy uses wrangler pages deploy, not Vercel.

Security Guidelines

⛔ CRITICAL: NEVER Hardcode Secrets or IDs

NEVER write API keys, tokens, passwords, project IDs, org IDs, or any identifier in code. This includes Cloudflare account/project IDs, Supabase URLs, Discord IDs, database connection strings, and any other infrastructure identifier. ALL must go in .env (or Cloudflare secrets via wrangler secret put).

// ❌ WRONG
const API_KEY = "AIzaSy...";

// ✅ CORRECT
const API_KEY = process.env.GOOGLE_API_KEY;

When creating scripts with API keys:

1. Use process.env (Node.js) or os.environ.get() (Python)
2. Load from .env file using dotenv
3. Add variable to .env.example with placeholder
4. Verify .env is in .gitignore