clauderc 1.0.0

package/templates/skills/claude-code-templates/SKILL.md

@@ -0,0 +1,260 @@
+# Claude Code Templates Skill
+
+Quick access to templates for setting up Claude Code in projects.
+
+## When to Use
+
+- Creating CLAUDE.md for a project
+- Setting up slash commands
+- Creating custom skills
+- Adding subagents to a project
+
+## Quick Reference
+
+### CLAUDE.md Structure
+
+```markdown
+# Project Name
+
+## Stack
+- Language: X
+- Framework: Y
+- Package Manager: Z
+
+## Commands
+\`\`\`bash
+# Dev
+npm run dev
+
+# Test
+npm test
+
+# Build
+npm run build
+\`\`\`
+
+## Code Style
+- [Key conventions]
+
+## Workflow
+- Plan Mode for: refactors, new features, architecture
+- Always verify before commit
+
+## Docs
+@README.md
+@docs/architecture.md
+```
+
+**Keep under 100 lines. Link to detailed docs with @imports.**
+
+---
+
+### Slash Command Template
+
+Location: `.claude/commands/<name>.md`
+
+```markdown
+# Command description in one line
+
+## What it does
+1. Step one
+2. Step two
+
+## Implementation
+\`\`\`bash
+your-command-here
+\`\`\`
+```
+
+---
+
+### Skill Template
+
+Location: `.claude/skills/<name>/SKILL.md`
+
+```markdown
+# Skill Name
+
+Brief description.
+
+## When to Use
+- Scenario 1
+- Scenario 2
+
+## Workflow
+1. Step one
+2. Step two
+
+## Checklist
+- [ ] Item 1
+- [ ] Item 2
+```
+
+---
+
+### Subagent Template
+
+Location: `.claude/agents/<name>.md`
+
+```markdown
+---
+name: agent-name
+description: One-line description
+model: inherit
+---
+
+You are a [ROLE].
+
+## Responsibilities
+1. Task one
+2. Task two
+
+## Output Format
+[How to structure output]
+```
+
+---
+
+### settings.json Template
+
+Location: `.claude/settings.json`
+
+```json
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm:*)",
+      "Bash(git:*)"
+    ]
+  },
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": ["npm run lint --fix || true"]
+      }
+    ]
+  }
+}
+```
+
+---
+
+## Stack-Specific Templates
+
+### Node.js/TypeScript
+
+**CLAUDE.md commands:**
+```bash
+# Dev
+npm run dev
+
+# Test
+npm test
+
+# Lint
+npm run lint
+
+# Build
+npm run build
+
+# Verify
+npm run lint && npm test && npm run build
+```
+
+**settings.json hooks:**
+```json
+{
+  "hooks": {
+    "PostToolUse": [{
+      "matcher": "Edit|Write",
+      "hooks": ["npx eslint --fix ${file} || true"]
+    }]
+  }
+}
+```
+
+### Python
+
+**CLAUDE.md commands:**
+```bash
+# Dev
+python -m uvicorn app.main:app --reload
+
+# Test
+pytest
+
+# Lint
+ruff check --fix .
+
+# Type Check
+mypy .
+
+# Verify
+ruff check . && mypy . && pytest
+```
+
+**settings.json hooks:**
+```json
+{
+  "hooks": {
+    "PostToolUse": [{
+      "matcher": "Edit|Write",
+      "hooks": ["ruff format ${file} || true"]
+    }]
+  }
+}
+```
+
+### Go
+
+**CLAUDE.md commands:**
+```bash
+# Dev
+go run ./cmd/server
+
+# Test
+go test ./...
+
+# Lint
+golangci-lint run
+
+# Build
+go build ./...
+
+# Verify
+golangci-lint run && go test ./... && go build ./...
+```
+
+### Rust
+
+**CLAUDE.md commands:**
+```bash
+# Dev
+cargo run
+
+# Test
+cargo test
+
+# Lint
+cargo clippy
+
+# Format
+cargo fmt
+
+# Verify
+cargo fmt --check && cargo clippy && cargo test && cargo build
+```
+
+---
+
+## Full Templates Location
+
+For complete templates with examples, see:
+`~/.claude/templates/project-setup/`
+
+- `CLAUDE_MD_TEMPLATE.md` - Full CLAUDE.md template
+- `COMMANDS_TEMPLATE.md` - All standard commands
+- `SKILLS_TEMPLATE.md` - Skill examples
+- `AGENTS_TEMPLATE.md` - Subagent examples
+- `TEAM_DOCS_TEMPLATE.md` - Team documentation

package/templates/skills/project-analysis/SKILL.md

@@ -0,0 +1,184 @@
+# Project Analysis Skill
+
+Systematic analysis of any software project to understand stack, structure, and development workflow.
+
+## When to Use
+
+- Before setting up Claude Code for a project
+- When joining a new codebase
+- When auditing project structure
+- Before major refactoring
+
+## Quick Analysis Checklist
+
+### 1. Identify Language & Package Manager
+
+```bash
+# Check for config files
+ls -la package.json pyproject.toml requirements.txt go.mod Cargo.toml composer.json pom.xml build.gradle 2>/dev/null
+```
+
+| File Found | Language | Package Manager |
+|------------|----------|-----------------|
+| `package.json` | JavaScript/TypeScript | npm/pnpm/bun/yarn |
+| `pnpm-lock.yaml` | - | pnpm |
+| `bun.lockb` | - | bun |
+| `yarn.lock` | - | yarn |
+| `pyproject.toml` | Python | poetry/pip |
+| `requirements.txt` | Python | pip |
+| `go.mod` | Go | go mod |
+| `Cargo.toml` | Rust | cargo |
+| `composer.json` | PHP | composer |
+| `pom.xml` | Java | maven |
+| `build.gradle` | Java/Kotlin | gradle |
+
+### 2. Detect Framework
+
+**Node.js** - Check `package.json` dependencies:
+- `next` → Next.js
+- `react` → React (check for vite/CRA)
+- `vue` → Vue.js
+- `express`/`fastify`/`hono` → Backend
+- `electron` → Desktop
+
+**Python** - Check imports or dependencies:
+- `django` → Django
+- `fastapi` → FastAPI
+- `flask` → Flask
+- `pytorch`/`tensorflow` → ML
+
+### 3. Identify Testing & Linting
+
+```bash
+# Node.js
+cat package.json | grep -E "(jest|vitest|mocha|eslint|prettier|biome)"
+
+# Python
+cat pyproject.toml | grep -E "(pytest|ruff|black|mypy)"
+
+# Check for config files
+ls -la jest.config* vitest.config* pytest.ini .eslintrc* .prettierrc* ruff.toml
+```
+
+### 4. Check Project Structure
+
+```bash
+# Is it a monorepo?
+ls -la turbo.json nx.json pnpm-workspace.yaml lerna.json 2>/dev/null
+
+# Check directory structure
+ls -la src/ app/ lib/ packages/ apps/ 2>/dev/null
+```
+
+| Indicator | Type |
+|-----------|------|
+| `packages/` + `turbo.json` | Turborepo monorepo |
+| `apps/` + `packages/` | Nx or similar |
+| `pnpm-workspace.yaml` | pnpm workspace |
+| Single `src/` | Standard single repo |
+
+### 5. Check CI/CD
+
+```bash
+ls -la .github/workflows/ .gitlab-ci.yml .circleci/ Jenkinsfile 2>/dev/null
+```
+
+### 6. Read Existing Docs
+
+```bash
+# Check for existing docs
+cat README.md 2>/dev/null | head -100
+cat CONTRIBUTING.md 2>/dev/null | head -50
+cat CLAUDE.md 2>/dev/null
+ls -la .claude/ 2>/dev/null
+```
+
+## Output Template
+
+After analysis, produce this summary:
+
+```markdown
+## Project Analysis
+
+### Stack
+- **Language**: [X]
+- **Framework**: [Y]
+- **Package Manager**: [Z]
+- **Runtime**: [Node vX / Python X.X / etc]
+
+### Testing & Quality
+- **Test Framework**: [jest/vitest/pytest/etc]
+- **Linter**: [eslint/ruff/golangci-lint/etc]
+- **Formatter**: [prettier/black/gofmt/etc]
+- **Type Checking**: [TypeScript/mypy/etc]
+
+### Structure
+- **Type**: [monorepo/single]
+- **Architecture**: [frontend/backend/fullstack]
+- **Key Directories**: [list main dirs]
+
+### Scripts Available
+```bash
+# From package.json/Makefile/etc
+dev: [command]
+test: [command]
+build: [command]
+lint: [command]
+```
+
+### CI/CD
+- **Platform**: [GitHub Actions/GitLab CI/etc]
+- **Key Workflows**: [list]
+
+### Documentation Status
+- [ ] README.md - [exists/missing] - [quality]
+- [ ] CONTRIBUTING.md - [exists/missing]
+- [ ] CLAUDE.md - [exists/missing]
+
+### Recommendations
+1. [First recommendation]
+2. [Second recommendation]
+```
+
+## Common Patterns by Stack
+
+### Next.js App Router
+```
+app/
+├── layout.tsx
+├── page.tsx
+├── api/
+└── components/
+```
+
+### Turborepo
+```
+apps/
+├── web/
+└── docs/
+packages/
+├── ui/
+└── config/
+turbo.json
+```
+
+### FastAPI
+```
+app/
+├── main.py
+├── routers/
+├── models/
+└── services/
+tests/
+```
+
+### Go Standard
+```
+cmd/
+├── server/
+internal/
+├── handlers/
+├── services/
+pkg/
+go.mod
+```