clauderc 1.0.0

package/templates/commands/verify.md

@@ -0,0 +1,69 @@
+# Full verification before commit/PR
+
+Run all checks: lint, typecheck, test, build.
+
+## When to use
+- Before committing changes
+- Before creating a PR
+- After major refactoring
+
+## Implementation
+```bash
+echo "🔍 Running verification..."
+
+# Node.js
+if [ -f "package.json" ]; then
+  echo "→ Lint"
+  npm run lint 2>/dev/null || true
+
+  echo "→ Typecheck"
+  npm run typecheck 2>/dev/null || npx tsc --noEmit 2>/dev/null || true
+
+  echo "→ Test"
+  npm test
+
+  echo "→ Build"
+  npm run build 2>/dev/null || true
+fi
+
+# Python
+if [ -f "pyproject.toml" ]; then
+  echo "→ Lint"
+  ruff check .
+
+  echo "→ Type check"
+  mypy . 2>/dev/null || true
+
+  echo "→ Test"
+  pytest
+fi
+
+# Go
+if [ -f "go.mod" ]; then
+  echo "→ Lint"
+  golangci-lint run
+
+  echo "→ Test"
+  go test ./...
+
+  echo "→ Build"
+  go build ./...
+fi
+
+# Rust
+if [ -f "Cargo.toml" ]; then
+  echo "→ Format check"
+  cargo fmt --check
+
+  echo "→ Clippy"
+  cargo clippy
+
+  echo "→ Test"
+  cargo test
+
+  echo "→ Build"
+  cargo build
+fi
+
+echo "✅ Verification complete"
+```

package/templates/manifest.json

@@ -0,0 +1,93 @@
+{
+  "version": "1.0.0",
+  "generatedAt": "2025-01-24T00:00:00.000Z",
+  "files": {
+    "agents/project-setup-wizard.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Setup wizard agent for configuring Claude Code in any project"
+    },
+    "skills/project-analysis/SKILL.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Systematic project analysis skill"
+    },
+    "skills/claude-code-templates/SKILL.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Quick reference for Claude Code templates"
+    },
+    "commands/test.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Run project tests"
+    },
+    "commands/lint.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Run linter and formatter"
+    },
+    "commands/verify.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Full verification before commit/PR"
+    },
+    "commands/pr.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Create a Pull Request"
+    },
+    "commands/setup.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Project setup and dependency installation"
+    },
+    "templates/project-setup/CLAUDE_MD_TEMPLATE.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Template for CLAUDE.md files"
+    },
+    "templates/project-setup/COMMANDS_TEMPLATE.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Template for slash commands"
+    },
+    "templates/project-setup/SKILLS_TEMPLATE.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Template for skills"
+    },
+    "templates/project-setup/AGENTS_TEMPLATE.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Template for subagents"
+    },
+    "templates/project-setup/TEAM_DOCS_TEMPLATE.md": {
+      "version": "1.0.0",
+      "added": "1.0.0",
+      "description": "Template for team documentation"
+    }
+  },
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2025-01-24",
+      "changes": {
+        "added": [
+          "agents/project-setup-wizard.md - Setup wizard agent",
+          "skills/project-analysis/SKILL.md - Project analysis skill",
+          "skills/claude-code-templates/SKILL.md - Templates reference skill",
+          "commands/test.md - Test command",
+          "commands/lint.md - Lint command",
+          "commands/verify.md - Verify command",
+          "commands/pr.md - PR command",
+          "commands/setup.md - Setup command",
+          "templates/project-setup/* - All project setup templates"
+        ],
+        "changed": [],
+        "removed": [],
+        "deprecated": []
+      }
+    }
+  ]
+}

package/templates/project-setup/AGENTS_TEMPLATE.md

@@ -0,0 +1,100 @@
+# Subagent Templates
+
+## security-reviewer.md
+
+```markdown
+---
+name: security-reviewer
+description: Review code for security vulnerabilities
+model: inherit
+---
+
+You are a SECURITY REVIEWER.
+
+## Checklist
+- [ ] No SQL/NoSQL injection vectors
+- [ ] Input validation on user inputs
+- [ ] Auth checks on protected routes
+- [ ] No secrets in code
+- [ ] Dependencies have no critical CVEs
+- [ ] Error messages don't leak info
+- [ ] HTTPS enforced
+- [ ] CORS properly configured
+
+## Output Format
+
+### Critical Issues
+- [file:line] Description
+
+### Warnings
+- [file:line] Description
+
+### Good Practices Found
+- Description
+
+### Recommendations
+- Suggestion
+```
+
+---
+
+## test-writer.md
+
+```markdown
+---
+name: test-writer
+description: Write comprehensive tests for code
+model: inherit
+---
+
+You are a TEST WRITER specialist.
+
+## Approach
+1. Analyze code to understand behavior
+2. Identify edge cases
+3. Write tests following project conventions
+4. Ensure good coverage
+
+## Test Categories
+- **Happy path**: Normal expected usage
+- **Edge cases**: Boundaries, empty inputs, nulls
+- **Error cases**: Invalid inputs, failures
+- **Integration**: Component interactions
+
+## Output
+- Tests in project's test framework
+- Clear test names describing behavior
+- Proper setup/teardown
+- Mocks where appropriate
+```
+
+---
+
+## code-quality.md
+
+```markdown
+---
+name: code-quality
+description: Review code for quality and maintainability
+model: inherit
+---
+
+You are a CODE QUALITY reviewer.
+
+## Review Areas
+1. **Readability**: Clear names, comments where needed
+2. **Maintainability**: DRY, single responsibility
+3. **Performance**: Obvious inefficiencies
+4. **Patterns**: Following project conventions
+
+## Output Format
+
+### Issues Found
+- [severity] [file:line] Description
+
+### Suggestions
+- Improvement opportunity
+
+### Positive Notes
+- Good patterns observed
+```

package/templates/project-setup/CLAUDE_MD_TEMPLATE.md

@@ -0,0 +1,49 @@
+# CLAUDE.md Template
+
+Use this template as base for generating project-specific CLAUDE.md files.
+
+---
+
+```markdown
+# {{PROJECT_NAME}}
+
+## Stack
+{{STACK_SUMMARY}}
+
+## Commands
+
+```bash
+# Dev
+{{DEV_COMMANDS}}
+
+# Test
+{{TEST_COMMANDS}}
+
+# Build
+{{BUILD_COMMANDS}}
+```
+
+## Code Style
+{{CODE_STYLE_RULES}}
+
+## Workflow
+- Plan Mode for: refactors > 3 files, new features, architecture changes
+- Always run `{{VERIFY_COMMAND}}` before commit
+- Parallel work OK for: independent modules, test files, docs
+
+## Architecture
+{{ARCHITECTURE_NOTES}}
+
+## Docs
+{{DOC_REFERENCES}}
+```
+
+---
+
+## Guidelines
+
+1. **Keep it under 100 lines** - Be concise, link to detailed docs
+2. **Commands must be copy-pasteable** - Test them before adding
+3. **Focus on what's different** - Don't repeat language defaults
+4. **Use @imports for details** - `@docs/architecture.md` instead of inline
+5. **Update the date** - Add `Last updated: YYYY-MM-DD` at bottom

package/templates/project-setup/COMMANDS_TEMPLATE.md

@@ -0,0 +1,92 @@
+# Slash Commands Templates
+
+## /test.md
+
+```markdown
+Run project test suite.
+
+## Steps
+1. Execute test command for this project
+2. Report results with coverage if available
+3. Highlight failures with context
+
+## Implementation
+\`\`\`bash
+{{TEST_COMMAND}}
+\`\`\`
+```
+
+---
+
+## /lint.md
+
+```markdown
+Check and fix code quality issues.
+
+## Steps
+1. Run linter with auto-fix
+2. Run formatter
+3. Report remaining issues
+
+## Implementation
+\`\`\`bash
+{{LINT_COMMAND}}
+\`\`\`
+```
+
+---
+
+## /verify.md
+
+```markdown
+Full project validation before commit/PR.
+
+## Steps
+1. Run linter
+2. Run tests
+3. Run build
+4. Report any failures
+
+## Implementation
+\`\`\`bash
+{{LINT_COMMAND}} && {{TEST_COMMAND}} && {{BUILD_COMMAND}}
+\`\`\`
+```
+
+---
+
+## /pr.md
+
+```markdown
+Create a pull request with auto-generated description.
+
+## Steps
+1. Check git status
+2. Analyze commits since branch point
+3. Generate PR description
+4. Create PR using gh CLI
+
+## Prerequisites
+- GitHub CLI installed and authenticated
+- Clean working directory (all changes committed)
+```
+
+---
+
+## /setup.md
+
+```markdown
+Setup development environment.
+
+## Steps
+1. Install dependencies
+2. Setup environment variables (from .env.example if exists)
+3. Run database migrations if applicable
+4. Verify setup with quick test
+
+## Implementation
+\`\`\`bash
+{{INSTALL_COMMAND}}
+{{SETUP_COMMANDS}}
+\`\`\`
+```

package/templates/project-setup/SKILLS_TEMPLATE.md

@@ -0,0 +1,113 @@
+# Skills Templates
+
+## debug-workflow/SKILL.md
+
+```markdown
+# Debug Workflow
+
+Systematic approach to debugging issues.
+
+## When to Use
+- Bug reports
+- Failing tests without obvious cause
+- Performance issues
+- Production errors
+
+## Workflow
+
+### 1. Reproduce
+- [ ] Create minimal reproduction
+- [ ] Document steps to reproduce
+- [ ] Identify expected vs actual behavior
+
+### 2. Isolate
+- [ ] Add debug logging
+- [ ] Check recent changes in related files
+- [ ] Bisect if needed: `git bisect`
+
+### 3. Fix
+- [ ] Implement minimal fix
+- [ ] Add regression test
+- [ ] Verify locally
+
+### 4. Validate
+- [ ] Run full test suite
+- [ ] Check for side effects
+- [ ] Update docs if needed
+```
+
+---
+
+## verification-workflow/SKILL.md
+
+```markdown
+# Verification-First Development
+
+Write Test -> Write Code -> Verify
+
+## Workflow
+
+### 1. Write Test First
+Create failing test that defines expected behavior.
+
+### 2. Implement
+Write minimal code to make test pass.
+
+### 3. Verify
+\`\`\`bash
+/test    # Should pass
+/lint    # Should pass
+/verify  # Full validation
+\`\`\`
+
+### 4. Refactor (if needed)
+Improve code while keeping tests green.
+
+## Checklist Before Commit
+- [ ] All tests pass
+- [ ] Linter passes
+- [ ] Build succeeds
+- [ ] Feature works (manual test)
+- [ ] Docs updated
+```
+
+---
+
+## parallel-work/SKILL.md
+
+```markdown
+# Parallel Work with Multiple Claudes
+
+## When to Parallelize
+- Independent test files
+- Separate features/modules
+- Documentation updates
+- Code review of different areas
+
+## When NOT to Parallelize
+- Interdependent changes
+- Database migrations
+- Breaking API changes
+- Cross-cutting refactors
+
+## How To
+
+### Using Worktrees (Recommended)
+\`\`\`bash
+claude --worktree feature-auth
+claude --worktree feature-dashboard
+claude --worktree docs-update
+\`\`\`
+
+### Patterns
+
+**Test Suite Split**
+- Claude 1: Unit tests (src/utils)
+- Claude 2: Unit tests (src/components)
+- Claude 3: Integration tests
+
+**Feature Development**
+- Claude 1: Backend API
+- Claude 2: Frontend UI
+- Claude 3: Tests + Docs
+```

package/templates/project-setup/TEAM_DOCS_TEMPLATE.md

@@ -0,0 +1,102 @@
+# Team Documentation Templates
+
+## CLAUDE_CODE_GUIDE.md
+
+```markdown
+# Claude Code Guide - {{PROJECT_NAME}}
+
+## Quick Start
+
+1. Install: `npm i -g @anthropic-ai/claude-code` (or appropriate method)
+2. Run: `cd {{PROJECT_PATH}} && claude`
+3. Try: `/test`, `/lint`, `/verify`
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/test` | Run test suite |
+| `/lint` | Check code quality |
+| `/verify` | Full validation (build + test + lint) |
+| `/pr` | Create pull request |
+
+## Workflows
+
+### New Feature
+1. Enter Plan Mode (Shift+Tab 2x)
+2. Describe feature requirements
+3. Approve plan
+4. Implement with verification-first approach
+
+### Bug Fix
+1. Use: "Investigate bug: [description]"
+2. Claude will reproduce, isolate, fix
+3. Run `/verify` before committing
+
+### Parallel Work
+```bash
+claude --worktree feature-a
+claude --worktree feature-b
+```
+
+## Tips
+- Use Plan Mode for changes > 3 files
+- Reference existing code: "similar to src/utils/auth.ts"
+- Always run `/verify` before committing
+```
+
+---
+
+## CONTRIBUTING_WITH_CLAUDE.md
+
+```markdown
+# Contributing with Claude Code
+
+## Setup
+1. Clone repo
+2. Run `/setup` in Claude
+3. Verify with `/verify`
+
+## Workflow
+1. Create branch: `git checkout -b feature/description`
+2. Use Plan Mode for non-trivial changes
+3. Implement with tests
+4. Run `/verify`
+5. Create PR with `/pr`
+
+## Standards
+- All code must have tests
+- Must pass linter
+- Update docs for new features
+```
+
+---
+
+## TROUBLESHOOTING.md
+
+```markdown
+# Troubleshooting
+
+## "Tests failing"
+```bash
+/test  # See failures
+# Share errors with Claude
+```
+
+## "Build broken"
+```bash
+/verify  # See build errors
+```
+
+## "Need fresh context"
+```bash
+/clear
+# Start with focused prompt
+```
+
+## Decision Tree
+- Bug? → "Use debug workflow"
+- New feature? → Plan Mode + verification-first
+- Refactor? → Plan Mode
+- Quick fix (< 10 lines)? → Direct execution
+```