clauderc 1.0.0

package/src/stacks.js

@@ -0,0 +1,299 @@
+/**
+ * Stack detection and commands for multiple languages/frameworks
+ */
+
+export const STACKS = {
+  // ==================== Node.js / TypeScript ====================
+  node: {
+    name: 'Node.js',
+    detect: ['package.json'],
+    packageManagers: {
+      bun: { lockfile: 'bun.lockb', install: 'bun install', run: 'bun run' },
+      pnpm: { lockfile: 'pnpm-lock.yaml', install: 'pnpm install', run: 'pnpm run' },
+      yarn: { lockfile: 'yarn.lock', install: 'yarn install', run: 'yarn' },
+      npm: { lockfile: 'package-lock.json', install: 'npm install', run: 'npm run' },
+    },
+    commands: {
+      test: ['test', 'test:unit', 'vitest', 'jest'],
+      lint: ['lint', 'lint:fix', 'eslint'],
+      format: ['format', 'prettier'],
+      typecheck: ['typecheck', 'tsc', 'type-check'],
+      build: ['build', 'compile'],
+      dev: ['dev', 'start', 'serve'],
+    },
+    frameworks: {
+      next: { detect: 'next', dev: 'next dev', build: 'next build' },
+      nuxt: { detect: 'nuxt', dev: 'nuxt dev', build: 'nuxt build' },
+      remix: { detect: '@remix-run', dev: 'remix dev', build: 'remix build' },
+      astro: { detect: 'astro', dev: 'astro dev', build: 'astro build' },
+      vite: { detect: 'vite', dev: 'vite', build: 'vite build' },
+      express: { detect: 'express', dev: 'node src/index.js' },
+      fastify: { detect: 'fastify', dev: 'node src/index.js' },
+      nestjs: { detect: '@nestjs/core', dev: 'nest start --watch', build: 'nest build' },
+    },
+  },
+
+  // ==================== Python ====================
+  python: {
+    name: 'Python',
+    detect: ['pyproject.toml', 'requirements.txt', 'setup.py', 'Pipfile'],
+    packageManagers: {
+      poetry: { lockfile: 'poetry.lock', install: 'poetry install', run: 'poetry run' },
+      pipenv: { lockfile: 'Pipfile.lock', install: 'pipenv install', run: 'pipenv run' },
+      uv: { lockfile: 'uv.lock', install: 'uv sync', run: 'uv run' },
+      pip: { lockfile: 'requirements.txt', install: 'pip install -r requirements.txt', run: '' },
+    },
+    commands: {
+      test: 'pytest',
+      lint: 'ruff check .',
+      format: 'ruff format .',
+      typecheck: 'mypy .',
+    },
+    frameworks: {
+      django: { detect: 'django', dev: 'python manage.py runserver', test: 'python manage.py test' },
+      fastapi: { detect: 'fastapi', dev: 'uvicorn app.main:app --reload' },
+      flask: { detect: 'flask', dev: 'flask run --reload' },
+      pytorch: { detect: 'torch' },
+      tensorflow: { detect: 'tensorflow' },
+    },
+  },
+
+  // ==================== Go ====================
+  go: {
+    name: 'Go',
+    detect: ['go.mod'],
+    commands: {
+      test: 'go test ./...',
+      lint: 'golangci-lint run',
+      format: 'gofmt -w .',
+      build: 'go build ./...',
+      dev: 'go run .',
+      tidy: 'go mod tidy',
+    },
+    frameworks: {
+      gin: { detect: 'github.com/gin-gonic/gin' },
+      echo: { detect: 'github.com/labstack/echo' },
+      fiber: { detect: 'github.com/gofiber/fiber' },
+      chi: { detect: 'github.com/go-chi/chi' },
+    },
+  },
+
+  // ==================== Rust ====================
+  rust: {
+    name: 'Rust',
+    detect: ['Cargo.toml'],
+    commands: {
+      test: 'cargo test',
+      lint: 'cargo clippy',
+      format: 'cargo fmt',
+      formatCheck: 'cargo fmt --check',
+      build: 'cargo build',
+      buildRelease: 'cargo build --release',
+      dev: 'cargo run',
+      check: 'cargo check',
+    },
+    frameworks: {
+      actix: { detect: 'actix-web' },
+      axum: { detect: 'axum' },
+      rocket: { detect: 'rocket' },
+      tauri: { detect: 'tauri', dev: 'cargo tauri dev', build: 'cargo tauri build' },
+    },
+  },
+
+  // ==================== Java / Kotlin ====================
+  java: {
+    name: 'Java/Kotlin',
+    detect: ['pom.xml', 'build.gradle', 'build.gradle.kts'],
+    packageManagers: {
+      maven: { detect: 'pom.xml', install: 'mvn install', run: 'mvn' },
+      gradle: { detect: 'build.gradle', install: 'gradle build', run: 'gradle' },
+      gradleKts: { detect: 'build.gradle.kts', install: 'gradle build', run: 'gradle' },
+    },
+    commands: {
+      test: { maven: 'mvn test', gradle: 'gradle test' },
+      lint: { maven: 'mvn checkstyle:check', gradle: 'gradle checkstyleMain' },
+      build: { maven: 'mvn package', gradle: 'gradle build' },
+      dev: { maven: 'mvn spring-boot:run', gradle: 'gradle bootRun' },
+    },
+    frameworks: {
+      spring: { detect: 'spring-boot' },
+      quarkus: { detect: 'quarkus', dev: 'quarkus dev' },
+      micronaut: { detect: 'micronaut' },
+    },
+  },
+
+  // ==================== PHP ====================
+  php: {
+    name: 'PHP',
+    detect: ['composer.json'],
+    commands: {
+      install: 'composer install',
+      test: 'vendor/bin/phpunit',
+      lint: 'vendor/bin/phpcs',
+      format: 'vendor/bin/php-cs-fixer fix',
+    },
+    frameworks: {
+      laravel: { detect: 'laravel/framework', dev: 'php artisan serve', test: 'php artisan test' },
+      symfony: { detect: 'symfony/framework-bundle', dev: 'symfony server:start' },
+      wordpress: { detect: 'wordpress' },
+    },
+  },
+
+  // ==================== Ruby ====================
+  ruby: {
+    name: 'Ruby',
+    detect: ['Gemfile'],
+    commands: {
+      install: 'bundle install',
+      test: 'bundle exec rspec',
+      lint: 'bundle exec rubocop',
+      format: 'bundle exec rubocop -a',
+    },
+    frameworks: {
+      rails: { detect: 'rails', dev: 'rails server', test: 'rails test' },
+      sinatra: { detect: 'sinatra' },
+    },
+  },
+
+  // ==================== C# / .NET ====================
+  dotnet: {
+    name: '.NET/C#',
+    detect: ['*.csproj', '*.sln', '*.fsproj'],
+    commands: {
+      restore: 'dotnet restore',
+      test: 'dotnet test',
+      build: 'dotnet build',
+      dev: 'dotnet run',
+      format: 'dotnet format',
+    },
+    frameworks: {
+      aspnet: { detect: 'Microsoft.AspNetCore' },
+      maui: { detect: 'Microsoft.Maui' },
+      blazor: { detect: 'Microsoft.AspNetCore.Components' },
+    },
+  },
+
+  // ==================== Elixir ====================
+  elixir: {
+    name: 'Elixir',
+    detect: ['mix.exs'],
+    commands: {
+      deps: 'mix deps.get',
+      test: 'mix test',
+      lint: 'mix credo',
+      format: 'mix format',
+      dev: 'mix phx.server',
+    },
+    frameworks: {
+      phoenix: { detect: 'phoenix' },
+    },
+  },
+
+  // ==================== Swift ====================
+  swift: {
+    name: 'Swift',
+    detect: ['Package.swift', '*.xcodeproj', '*.xcworkspace'],
+    commands: {
+      build: 'swift build',
+      test: 'swift test',
+      dev: 'swift run',
+    },
+  },
+
+  // ==================== Dart / Flutter ====================
+  dart: {
+    name: 'Dart/Flutter',
+    detect: ['pubspec.yaml'],
+    commands: {
+      deps: 'dart pub get',
+      test: 'dart test',
+      lint: 'dart analyze',
+      format: 'dart format .',
+    },
+    frameworks: {
+      flutter: { detect: 'flutter', deps: 'flutter pub get', test: 'flutter test', dev: 'flutter run' },
+    },
+  },
+};
+
+/**
+ * Monorepo detection
+ */
+export const MONOREPO_TOOLS = {
+  turborepo: { detect: 'turbo.json', run: 'turbo run' },
+  nx: { detect: 'nx.json', run: 'nx run' },
+  lerna: { detect: 'lerna.json', run: 'lerna run' },
+  rush: { detect: 'rush.json', run: 'rush' },
+  pnpmWorkspace: { detect: 'pnpm-workspace.yaml' },
+  yarnWorkspaces: { detect: 'package.json' }, // check workspaces field
+};
+
+/**
+ * CI/CD detection
+ */
+export const CI_PLATFORMS = {
+  github: { detect: '.github/workflows' },
+  gitlab: { detect: '.gitlab-ci.yml' },
+  circleci: { detect: '.circleci' },
+  jenkins: { detect: 'Jenkinsfile' },
+  travis: { detect: '.travis.yml' },
+  azure: { detect: 'azure-pipelines.yml' },
+  bitbucket: { detect: 'bitbucket-pipelines.yml' },
+};
+
+/**
+ * Testing frameworks by language
+ */
+export const TEST_FRAMEWORKS = {
+  node: ['jest', 'vitest', 'mocha', 'ava', 'tap', 'playwright', 'cypress'],
+  python: ['pytest', 'unittest', 'nose2', 'hypothesis'],
+  go: ['testing', 'testify', 'ginkgo'],
+  rust: ['cargo test'],
+  java: ['junit', 'testng', 'mockito'],
+  php: ['phpunit', 'pest', 'codeception'],
+  ruby: ['rspec', 'minitest'],
+  dotnet: ['xunit', 'nunit', 'mstest'],
+  elixir: ['exunit'],
+};
+
+/**
+ * Linting/Formatting tools by language
+ */
+export const LINT_TOOLS = {
+  node: {
+    linters: ['eslint', 'biome', 'oxlint'],
+    formatters: ['prettier', 'biome', 'dprint'],
+    typecheckers: ['typescript', 'tsc'],
+  },
+  python: {
+    linters: ['ruff', 'flake8', 'pylint', 'pyflakes'],
+    formatters: ['ruff', 'black', 'autopep8', 'yapf'],
+    typecheckers: ['mypy', 'pyright', 'pyre'],
+  },
+  go: {
+    linters: ['golangci-lint', 'staticcheck', 'revive'],
+    formatters: ['gofmt', 'goimports'],
+  },
+  rust: {
+    linters: ['clippy'],
+    formatters: ['rustfmt'],
+  },
+  java: {
+    linters: ['checkstyle', 'pmd', 'spotbugs'],
+    formatters: ['google-java-format', 'spotless'],
+  },
+  php: {
+    linters: ['phpcs', 'phpstan', 'psalm'],
+    formatters: ['php-cs-fixer', 'phpcbf'],
+  },
+  ruby: {
+    linters: ['rubocop', 'reek'],
+    formatters: ['rubocop'],
+  },
+  dotnet: {
+    linters: ['dotnet format'],
+    formatters: ['dotnet format'],
+  },
+};
+
+export default STACKS;

package/templates/agents/project-setup-wizard.md

@@ -0,0 +1,230 @@
+---
+name: project-setup-wizard
+description: Setup Claude Code for any project - creates CLAUDE.md, commands, skills, subagents, and docs following best practices.
+model: inherit
+color: purple
+allowed_tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+---
+
+You are a **Claude Code Setup Wizard**. You analyze projects and create optimized Claude Code configurations.
+
+## Core Principles
+
+1. **Explore First** - Understand stack, workflow, pain points before proposing
+2. **Executable Config** - Every command must work immediately
+3. **Context Economy** - CLAUDE.md < 100 lines, use @imports for details
+4. **Verification First** - All workflows include validation steps
+5. **Plan Mode Default** - Complex tasks start in Plan Mode
+
+## Phase 1: Analysis (REQUIRED)
+
+**Start in Plan Mode. Do NOT create files until plan is approved.**
+
+### Stack Detection
+
+Check these files to identify the stack:
+
+| File | Indicates |
+|------|-----------|
+| `package.json` | Node.js - check scripts, deps |
+| `requirements.txt`, `pyproject.toml` | Python |
+| `go.mod` | Go |
+| `Cargo.toml` | Rust |
+| `composer.json` | PHP |
+| `pom.xml`, `build.gradle` | Java |
+
+### Extract Key Info
+
+1. **Package Manager**: npm/pnpm/bun/yarn/pip/poetry/cargo
+2. **Test Framework**: jest/vitest/pytest/go test/cargo test
+3. **Linter/Formatter**: eslint/prettier/black/ruff/golangci-lint/clippy
+4. **Build Tool**: vite/webpack/esbuild/turbo/nx
+5. **Project Type**: monorepo/single, frontend/backend/fullstack
+
+### Check Existing Docs
+
+- `README.md` - Setup instructions?
+- `CONTRIBUTING.md` - Guidelines?
+- `CLAUDE.md` - Already configured?
+- `.claude/` - Existing commands/skills?
+
+### Present Plan
+
+```markdown
+# Claude Code Setup Plan
+
+## Stack Detected
+- Language: [X]
+- Framework: [Y]
+- Package Manager: [Z]
+- Testing: [W]
+- Type: [monorepo/single]
+
+## Proposed Configuration
+
+### CLAUDE.md
+- [ ] Stack summary
+- [ ] Dev/test/build commands
+- [ ] Code style rules
+- [ ] Workflow guidelines
+
+### Commands (.claude/commands/)
+- `/test` - [test command]
+- `/lint` - [lint command]
+- `/verify` - [full validation]
+- `/pr` - Create PR
+
+### Skills (.claude/skills/)
+- `debug-workflow/` - Systematic debugging
+- `verification-workflow/` - Test-first development
+
+### Subagents (.claude/agents/)
+- `security-reviewer.md` - Security audit
+- `test-writer.md` - Test generation
+
+### Team Docs
+- CLAUDE_CODE_GUIDE.md
+- CONTRIBUTING_WITH_CLAUDE.md
+
+## Questions
+- [Any clarifications needed]
+```
+
+**Wait for approval before Phase 2.**
+
+## Phase 2: Create CLAUDE.md
+
+Read template: `~/.claude/templates/project-setup/CLAUDE_MD_TEMPLATE.md`
+
+Create `CLAUDE.md` in project root. Requirements:
+- Under 100 lines
+- Commands must be copy-pasteable
+- Use @imports for detailed docs
+- Include verification commands
+
+## Phase 3: Create .claude/ Structure
+
+```
+.claude/
+├── commands/
+│   ├── test.md
+│   ├── lint.md
+│   ├── verify.md
+│   └── pr.md
+├── skills/
+│   ├── debug-workflow/SKILL.md
+│   └── verification-workflow/SKILL.md
+├── agents/
+│   ├── security-reviewer.md
+│   └── test-writer.md
+└── settings.json
+```
+
+### settings.json Format
+
+```json
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm:*)", "Bash(pnpm:*)", "Bash(bun:*)",
+      "Bash(git:*)", "Bash(gh:*)"
+    ]
+  },
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": ["{{LINT_FIX_COMMAND}}"]
+      }
+    ]
+  }
+}
+```
+
+Read templates from `~/.claude/templates/project-setup/` for:
+- Commands: `COMMANDS_TEMPLATE.md`
+- Skills: `SKILLS_TEMPLATE.md`
+- Agents: `AGENTS_TEMPLATE.md`
+
+## Phase 4: Team Documentation
+
+Read: `~/.claude/templates/project-setup/TEAM_DOCS_TEMPLATE.md`
+
+Create in project root:
+- `CLAUDE_CODE_GUIDE.md` - How to use Claude Code in this project
+- `CONTRIBUTING_WITH_CLAUDE.md` - Contribution workflow with Claude
+
+## Phase 5: Validation
+
+Test each command:
+```bash
+# Verify commands exist and are readable
+ls -la .claude/commands/
+cat .claude/commands/test.md
+
+# Verify CLAUDE.md is under 100 lines
+wc -l CLAUDE.md
+```
+
+## Final Output
+
+```markdown
+# Setup Complete
+
+## Created
+- CLAUDE.md ([X] lines)
+- [N] commands in .claude/commands/
+- [N] skills in .claude/skills/
+- [N] agents in .claude/agents/
+- settings.json with hooks
+- Team documentation
+
+## Quick Start
+\`\`\`bash
+claude
+/test
+/verify
+\`\`\`
+
+## Next Steps
+1. Review CLAUDE.md
+2. Test commands
+3. Share CLAUDE_CODE_GUIDE.md with team
+```
+
+## When NOT to Use
+
+- Single-file scripts (overkill)
+- Already has complete setup (review instead)
+- User only wants CLAUDE.md (create directly)
+
+## Stack-Specific Notes
+
+### Node.js/TypeScript
+- Check for pnpm-lock.yaml/bun.lockb/yarn.lock
+- Look for turbo.json/nx.json (monorepo)
+- Common: `npm run test`, `npm run lint`
+
+### Python
+- Check for pyproject.toml (poetry) vs requirements.txt
+- Look for pytest.ini/setup.cfg
+- Common: `pytest`, `ruff check --fix`
+
+### Go
+- Standard: `go test ./...`, `go build`
+- Check for golangci.yml
+- Common: `golangci-lint run`
+
+### Rust
+- Standard: `cargo test`, `cargo build`
+- Common: `cargo clippy`, `cargo fmt`
+
+---
+
+**Begin with Phase 1 analysis. Plan Mode first, then systematic execution.**

package/templates/commands/lint.md

@@ -0,0 +1,33 @@
+# Run linter and formatter
+
+Detect and run the appropriate lint/format command for this project.
+
+## Implementation
+```bash
+# Node.js
+if [ -f "package.json" ]; then
+  if grep -q '"lint"' package.json; then
+    npm run lint
+  elif [ -f ".eslintrc" ] || [ -f ".eslintrc.js" ] || [ -f ".eslintrc.json" ]; then
+    npx eslint . --fix
+  fi
+fi
+
+# Python
+if [ -f "pyproject.toml" ] || [ -f "ruff.toml" ]; then
+  ruff check --fix .
+  ruff format .
+fi
+
+# Go
+if [ -f "go.mod" ]; then
+  gofmt -w .
+  golangci-lint run
+fi
+
+# Rust
+if [ -f "Cargo.toml" ]; then
+  cargo fmt
+  cargo clippy
+fi
+```

package/templates/commands/pr.md

@@ -0,0 +1,46 @@
+# Create a Pull Request
+
+Commit changes, push to remote, and create a PR with generated description.
+
+## Workflow
+1. Stage all changes
+2. Generate commit message from diff
+3. Push to current branch
+4. Create PR with description
+
+## Prerequisites
+- `gh` CLI installed and authenticated
+- Changes ready to commit
+
+## Implementation
+```bash
+# Get current branch
+BRANCH=$(git branch --show-current)
+
+# Check for changes
+if [ -z "$(git status --porcelain)" ]; then
+  echo "No changes to commit"
+  exit 0
+fi
+
+# Stage changes
+git add -A
+
+# Show what will be committed
+echo "📝 Changes to commit:"
+git status --short
+
+# Commit (message should be provided by Claude)
+# git commit -m "..."
+
+# Push
+git push -u origin $BRANCH
+
+# Create PR
+gh pr create --fill
+```
+
+## Notes
+- Claude will generate an appropriate commit message
+- PR description is auto-generated from commits
+- Use `--draft` flag for draft PRs

package/templates/commands/setup.md

@@ -0,0 +1,51 @@
+# Project setup
+
+Install dependencies and prepare development environment.
+
+## Implementation
+```bash
+echo "🚀 Setting up project..."
+
+# Node.js
+if [ -f "package.json" ]; then
+  # Detect package manager
+  if [ -f "bun.lockb" ]; then
+    echo "→ Installing with bun"
+    bun install
+  elif [ -f "pnpm-lock.yaml" ]; then
+    echo "→ Installing with pnpm"
+    pnpm install
+  elif [ -f "yarn.lock" ]; then
+    echo "→ Installing with yarn"
+    yarn install
+  else
+    echo "→ Installing with npm"
+    npm install
+  fi
+fi
+
+# Python
+if [ -f "pyproject.toml" ]; then
+  if grep -q "poetry" pyproject.toml; then
+    echo "→ Installing with poetry"
+    poetry install
+  else
+    echo "→ Installing with pip"
+    pip install -e ".[dev]" 2>/dev/null || pip install -r requirements.txt
+  fi
+fi
+
+# Go
+if [ -f "go.mod" ]; then
+  echo "→ Downloading Go modules"
+  go mod download
+fi
+
+# Rust
+if [ -f "Cargo.toml" ]; then
+  echo "→ Building Rust project"
+  cargo build
+fi
+
+echo "✅ Setup complete"
+```

package/templates/commands/test.md

@@ -0,0 +1,33 @@
+# Run project tests
+
+Detect and run the appropriate test command for this project.
+
+## Detection Order
+1. Check package.json for test script
+2. Check for pytest/go test/cargo test
+3. Fall back to common patterns
+
+## Implementation
+```bash
+# Node.js
+if [ -f "package.json" ]; then
+  if grep -q '"test"' package.json; then
+    npm test
+  fi
+fi
+
+# Python
+if [ -f "pytest.ini" ] || [ -f "pyproject.toml" ]; then
+  pytest
+fi
+
+# Go
+if [ -f "go.mod" ]; then
+  go test ./...
+fi
+
+# Rust
+if [ -f "Cargo.toml" ]; then
+  cargo test
+fi
+```