@qazuor/claude-code-config 0.1.0

package/templates/scripts/worktree-cleanup.sh

@@ -0,0 +1,81 @@
+#!/bin/bash
+# Cleanup merged worktrees
+
+set -e
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🧹 Cleaning up merged worktrees"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Update main branch
+echo "📡 Fetching latest changes..."
+git fetch origin main
+git checkout main
+git pull origin main
+
+echo ""
+echo "🔍 Checking for merged branches..."
+echo ""
+
+REMOVED_COUNT=0
+KEPT_COUNT=0
+
+# Get list of worktrees
+git worktree list --porcelain | while read -r line; do
+  if [[ $line == worktree* ]]; then
+    WORKTREE_PATH=${line#worktree }
+    CURRENT_PATH="$WORKTREE_PATH"
+  elif [[ $line == branch* ]]; then
+    BRANCH=${line#branch refs/heads/}
+
+    # Skip main branch
+    if [[ $BRANCH == "main" ]]; then
+      continue
+    fi
+
+    # Check if merged
+    if git branch --merged main | grep -q "^  $BRANCH\$" 2>/dev/null; then
+      echo "🗑️  Removing: $CURRENT_PATH ($BRANCH)"
+
+      # Remove worktree
+      if git worktree remove "$CURRENT_PATH" 2>/dev/null; then
+        echo "   ✅ Worktree removed"
+      else
+        echo "   ⚠️  Failed to remove worktree (might have uncommitted changes)"
+        continue
+      fi
+
+      # Delete local branch
+      if git branch -d "$BRANCH" 2>/dev/null; then
+        echo "   ✅ Branch deleted"
+      else
+        echo "   ⚠️  Failed to delete branch"
+      fi
+
+      REMOVED_COUNT=$((REMOVED_COUNT + 1))
+      echo ""
+    else
+      echo "⏭️  Keeping: $CURRENT_PATH ($BRANCH) - not merged"
+      KEPT_COUNT=$((KEPT_COUNT + 1))
+    fi
+  fi
+done
+
+# Prune deleted worktrees
+echo ""
+echo "🔧 Pruning deleted worktrees..."
+git worktree prune
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "✅ Cleanup complete!"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Removed: $REMOVED_COUNT worktree(s)"
+echo "Kept:    $KEPT_COUNT worktree(s)"
+echo ""
+
+# Show remaining worktrees
+echo "📋 Current worktrees:"
+git worktree list
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/templates/scripts/worktree-create.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# Create worktree with project conventions
+
+set -e
+
+if [ -z "$1" ]; then
+  echo "Usage: ./worktree-create.sh <branch-name> [base-branch]"
+  echo ""
+  echo "Examples:"
+  echo "  ./worktree-create.sh feature/auth main"
+  echo "  ./worktree-create.sh fix/login-bug main"
+  echo "  ./worktree-create.sh hotfix/critical main"
+  echo ""
+  exit 1
+fi
+
+BRANCH=$1
+BASE_BRANCH=${2:-main}
+WORKTREE_NAME="project-${BRANCH//\//-}"
+WORKTREE_PATH="../${WORKTREE_NAME}"
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🌿 Creating Worktree"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Branch:      $BRANCH"
+echo "Base:        $BASE_BRANCH"
+echo "Path:        $WORKTREE_PATH"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Check if base branch exists
+if ! git rev-parse --verify "$BASE_BRANCH" >/dev/null 2>&1; then
+  echo "❌ Base branch '$BASE_BRANCH' not found"
+  exit 1
+fi
+
+# Create worktree
+echo "📁 Creating worktree..."
+git worktree add "$WORKTREE_PATH" -b "$BRANCH" "$BASE_BRANCH"
+
+# Navigate to worktree
+cd "$WORKTREE_PATH"
+
+# Install dependencies
+echo ""
+echo "📦 Installing dependencies..."
+pnpm install --frozen-lockfile
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "✅ Worktree created successfully!"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📁 Path:   $WORKTREE_PATH"
+echo "🌿 Branch: $BRANCH"
+echo ""
+echo "Next steps:"
+echo "  cd $WORKTREE_PATH"
+echo "  pnpm dev"
+echo ""
+echo "When done:"
+echo "  cd ~/projects/your-project"
+echo "  git worktree remove $WORKTREE_PATH"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/templates/settings.json

@@ -0,0 +1,202 @@
+{
+    "$schema": "https://json.schemastore.org/claude-code-settings.json",
+    "env": {
+        "CLAUDE_CODE_ENABLE_TELEMETRY": "0",
+        "DISABLE_PROMPT_CACHING": "0",
+        "MCP_TIMEOUT": "30000",
+        "OTEL_METRIC_EXPORT_INTERVAL": "10000",
+        "NODE_ENV": "development"
+    },
+    "includeCoAuthoredBy": false,
+    "permissions": {
+        "allow": [
+            "Bash(pnpm:*)",
+            "Bash(git status:*)",
+            "Bash(git diff:*)",
+            "Bash(git log:*)",
+            "Bash(ls:*)",
+            "Bash(cat:*)",
+            "Bash(pwd:*)",
+            "Bash(cd:*)",
+            "Bash(mkdir:*)",
+            "Bash(grep:*)",
+            "Bash(grep -n:*)",
+            "WebFetch(*)",
+            "Bash(docker:*)",
+            "Bash(docker-compose:*)",
+            "Edit",
+            "Find",
+            "Create",
+            "Read",
+            "Write",
+            "Replace",
+            "Bash(tsx:*)",
+            "Bash(npx tsx:*)",
+            "Bash(claude mcp:*)"
+        ],
+        "deny": [
+            "Bash(git add .)",
+            "Bash(rm -rf /)",
+            "Bash(sudo rm:*)",
+            "Bash(dd:*)",
+            "Edit(/etc/**)",
+            "Edit(/usr/**)",
+            "Edit(~/.ssh/**)"
+        ]
+    },
+    "allowedCommands": [
+        "pnpm",
+        "npm",
+        "node",
+        "git",
+        "bash",
+        "sh",
+        "echo",
+        "cat",
+        "ls",
+        "cd",
+        "pwd",
+        "mkdir",
+        "rm",
+        "cp",
+        "mv",
+        "find",
+        "grep",
+        "sed",
+        "awk",
+        "curl",
+        "wget",
+        "tar",
+        "gzip",
+        "unzip"
+    ],
+    "alwaysAllowedCommands": [
+        "pnpm run typecheck",
+        "pnpm run lint",
+        "pnpm run test",
+        "pnpm run build",
+        "pnpm run dev",
+        "git status",
+        "git diff",
+        "git log",
+        "git branch"
+    ],
+    "alwaysAllowReads": [
+        "**/*.ts",
+        "**/*.tsx",
+        "**/*.js",
+        "**/*.jsx",
+        "**/*.json",
+        "**/*.md",
+        "**/*.astro",
+        "**/*.css",
+        "**/*.html",
+        "**/package.json",
+        "**/tsconfig.json",
+        "**/CLAUDE.md",
+        "**/.claude/**/*",
+        "**/README.md"
+    ],
+    "alwaysAllowWrites": [
+        "**/*.ts",
+        "**/*.tsx",
+        "**/*.js",
+        "**/*.jsx",
+        "**/*.astro",
+        "**/*.css",
+        "**/*.html",
+        "**/*.md",
+        ".claude/sessions/**/*"
+    ],
+    "neverAllowWrites": [
+        ".claude/commands/**/*",
+        "**/node_modules/**/*",
+        "**/.git/**/*",
+        "**/dist/**/*",
+        "**/build/**/*",
+        "**/.next/**/*",
+        "**/.astro/**/*"
+    ],
+    "allowedTools": {
+        "Edit": true,
+        "Bash": [
+            "npm",
+            "node",
+            "ls",
+            "cat",
+            "git*",
+            "find",
+            "grep",
+            "cd",
+            "mkdir",
+            "touch",
+            "cp",
+            "mv",
+            "echo",
+            "pwd",
+            "test",
+            "head",
+            "tail",
+            "less",
+            "more",
+            "nano",
+            "wc",
+            "sort",
+            "uniq",
+            "cut",
+            "sed",
+            "awk",
+            "curl",
+            "wget",
+            "diff",
+            "patch",
+            "tar",
+            "zip",
+            "unzip",
+            "jq",
+            "npm run*"
+        ],
+        "Fetch": true,
+        "mcp__modelcontextprotocol-server-github__server-github": true
+    },
+    "defaultMode": "acceptEdits",
+    "preferences": {
+        "theme": "dark",
+        "autoSave": true
+    },
+    "hooks": {
+        "Stop": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "echo -ne '\\007'",
+                        "timeout": 5
+                    }
+                ]
+            }
+        ],
+        "SubagentStop": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "echo -ne '\\007'",
+                        "timeout": 5
+                    }
+                ]
+            }
+        ],
+        "Notification": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": ".claude/hooks/on-notification.sh",
+                        "timeout": 10
+                    }
+                ]
+            }
+        ]
+    }
+}

package/templates/settings.local.json

@@ -0,0 +1,138 @@
+{
+  "includeCoAuthoredBy": false,
+  "permissions": {
+    "allow": [
+      "Bash(npx markdownlint-cli2:*)",
+      "Bash(pnpm format:md:claude:*)",
+      "mcp__serena__list_dir",
+      "Bash(cat:*)",
+      "Bash(pnpm lint:*)",
+      "Bash(pnpm typecheck:*)",
+      "Bash(pnpm test:*)",
+      "Bash(mkdir:*)",
+      "Bash(pnpm audit:*)",
+      "Bash(pnpm test:coverage:*)",
+      "Bash(find:*)",
+      "Bash(pnpm planning:sync:*)",
+      "Bash(test:*)",
+      "mcp__serena__find_symbol",
+      "Edit",
+      "Read",
+      "Bash(git log:*)",
+      "LS",
+      "Grep",
+      "Glob",
+      "Bash(pnpm run cleanup:issues:*)",
+      "Bash(pnpm run planning:cleanup:*)",
+      "Bash(tsx src/scripts/cleanup-issues.ts:*)",
+      "Bash(npx tsx:*)",
+      "Bash(node --loader tsx src/scripts/cleanup-issues.ts:*)",
+      "Bash(pnpm exec tsx:*)",
+      "Bash(pnpm run planning:create:*)",
+      "Bash(pnpm run planning:sync:*)",
+      "WebFetch(domain:www.reddit.com)",
+      "WebFetch(domain:docs.github.com)",
+      "mcp__serena__search_for_pattern",
+      "Bash(tsx src/scripts/planning-sync.ts:*)",
+      "Bash(pnpm run lint)",
+      "Bash(pnpm run test)",
+      "Bash(pnpm run typecheck:*)",
+      "Bash(pnpm run test:coverage)",
+      "Bash(pnpm exec biome:*)",
+      "Bash(pnpm exec vitest:*)",
+      "Bash(pnpm run lint:*)",
+      "Bash(pnpm run test:*)",
+      "Bash(pnpm --filter=@repo/db run typecheck:*)",
+      "mcp__serena__get_symbols_overview",
+      "Bash(./.claude/scripts/validate-registry.sh:*)",
+      "Bash(./sync-registry.sh:*)",
+      "Bash(./.claude/scripts/validate-docs.sh:*)",
+      "Bash(./.claude/scripts/health-check.sh:*)",
+      "WebSearch",
+      "Bash(pnpm build:*)",
+      "Bash(pnpm vitest run:*)",
+      "Bash(pnpm format:*)",
+      "Bash(pnpm check:*)",
+      "Bash(pnpm test:file:*)",
+      "Bash(pnpm biome check:*)",
+      "Bash(pnpm run test:coverage:*)",
+      "Bash(pnpm --filter=@repo/github-workflow test:coverage:*)",
+      "Bash(pnpm lint:md:*)",
+      "Bash(pnpm markdownlint-cli2:*)",
+      "Bash(pnpm biome lint:*)",
+      "Bash(pnpm --filter=@repo/db biome check:*)",
+      "Bash(pnpm lint:md:docs:*)",
+      "Bash(tee:*)",
+      "Bash(pnpm --filter=@repo/schemas run typecheck:*)",
+      "Bash(pnpm --filter=@repo/db run test -- pricingPlan)",
+      "Bash(pnpm --filter=@repo/service-core run lint:*)",
+      "Bash(pnpm --filter=@repo/service-core run typecheck:*)",
+      "Bash(pnpm --filter=@repo/service-core run test -- pricingPlan)",
+      "Bash(pnpm --filter=@repo/service-core run test -- \"pricingPlan|pricingTier|purchase\")",
+      "Bash(pnpm --filter=@repo/service-core run test:*)",
+      "Bash(pnpm --filter=@repo/db run test:*)",
+      "Bash(pnpm --filter=@repo/schemas run test:*)",
+      "Bash(pnpm --filter @repo/service-core test:*)",
+      "Bash(pnpm --filter @repo/schemas run lint)",
+      "Bash(pnpm --filter @repo/db run lint:*)",
+      "Bash(pnpm --filter @repo/service-core run lint:*)",
+      "Bash(pnpm --filter @repo/schemas run typecheck:*)",
+      "Bash(pnpm --filter @repo/db run typecheck:*)",
+      "Bash(pnpm --filter @repo/service-core run typecheck:*)",
+      "mcp__serena__find_file",
+      "Bash(pnpm test:e2e:*)",
+      "Bash(pnpm --filter=api test test/e2e/flows/campaign/scenario-1-complete-flow.test.ts)",
+      "Bash(pnpm --filter=@hospeda/api test:e2e test/e2e/flows/campaign/scenario-1-complete-flow.test.ts)",
+      "Bash(pnpm --filter @repo/api test:e2e:*)",
+      "Bash(pnpm --filter hospeda-api test:e2e:*)",
+      "Bash(pnpm --filter @hospeda/api test:e2e:*)",
+      "Bash(pnpm --filter hospeda-api test test/e2e/flows/professional-service/debug.test.ts)",
+      "Bash(pnpm --filter=hospeda-api test:e2e test/e2e/flows/professional-service/scenario-1-complete-flow.test.ts)",
+      "Bash(pnpm --filter=@hospeda/api test:*)",
+      "Bash(pnpm --filter=api test test/e2e/flows/professional-service/scenario-1-complete-flow.test.ts)",
+      "Bash(pnpm --filter=@hospeda/api run typecheck)",
+      "Bash(pnpm --filter=hospeda-api test:e2e:*)",
+      "Bash(pnpm run test:e2e:*)",
+      "Bash(pnpm --filter=@hospeda/api test:e2e:*)",
+      "Bash(pnpm --filter=hospeda-api test:*)",
+      "mcp__filesystem__list_directory"
+    ],
+    "deny": [],
+    "ask": []
+  },
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo -ne '\\007'",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo -ne '\\007'",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/on-notification.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/skills/README.md

@@ -0,0 +1,197 @@
+# Skills
+
+This directory contains **reusable skill modules** that provide specialized knowledge and workflows. Skills can be used by multiple agents and are invoked when specific expertise is needed.
+
+## ⚙️ Configuration Required
+
+All skills include a `config_required` section in their YAML frontmatter. Configure the required settings in your project before using a skill.
+
+**Example skill frontmatter:**
+```yaml
+---
+name: skill-name
+category: testing|audit|patterns|tech|utils
+description: Brief description
+usage: When to use this skill
+input: What the skill needs
+output: What the skill produces
+config_required:
+  - setting_name: "Description of what to configure"
+---
+```
+
+## Skill Categories
+
+### Testing Skills (6 skills)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [api-app-testing](testing/api-app-testing.md) | API endpoint testing workflow | Testing APIs during development |
+| [performance-testing](testing/performance-testing.md) | Performance benchmarks and load testing | Validating performance requirements |
+| [security-testing](testing/security-testing.md) | Security testing patterns | Testing security during development |
+| [web-app-testing](qa/web-app-testing.md) | E2E web application testing | Testing web UI flows |
+| [qa-criteria-validator](qa/qa-criteria-validator.md) | Validate against PDR acceptance criteria | Before feature completion |
+| [tdd-methodology](patterns/tdd-methodology.md) | Test-Driven Development workflow | During implementation |
+
+### Audit Skills (3 skills)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [security-audit](audit/security-audit.md) | OWASP compliance and penetration testing | Pre-deployment, quarterly reviews |
+| [performance-audit](audit/performance-audit.md) | Core Web Vitals and optimization | Pre-deployment, after major features |
+| [accessibility-audit](audit/accessibility-audit.md) | WCAG 2.1 Level AA compliance | Pre-deployment, after UI changes |
+
+### Pattern Skills (3 skills)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [error-handling-patterns](patterns/error-handling-patterns.md) | Error class hierarchy and handling | Implementing error handling |
+| [auth-patterns](auth/nextauth-patterns.md) | Authentication patterns | Implementing auth flows |
+| [i18n-patterns](i18n/i18n-patterns.md) | Internationalization patterns | Adding multi-language support |
+
+### State Management Skills (3 skills)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [redux-toolkit-patterns](state/redux-toolkit-patterns.md) | Redux Toolkit patterns | Using Redux for state |
+| [tanstack-query-patterns](state/tanstack-query-patterns.md) | TanStack Query patterns | Server state management |
+| [zustand-patterns](state/zustand-patterns.md) | Zustand patterns | Simple client state |
+
+### React Skills (1 skill)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [react-hook-form-patterns](react/react-hook-form-patterns.md) | Form handling with React Hook Form | Building forms |
+
+### Tech Skills (3 skills)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [mermaid-diagram-specialist](tech/mermaid-diagram-specialist.md) | Creating Mermaid diagrams | Documentation, architecture |
+| [component-library-specialist](tech/shadcn-specialist.md) | Component library integration | UI implementation |
+| [deployment-platform-specialist](tech/vercel-specialist.md) | Deployment configuration | Deploying applications |
+
+### Utility Skills (3 skills)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [add-memory](utils/add-memory.md) | Capture learnings and knowledge | After discovering patterns/issues |
+| [json-data-auditor](utils/json-data-auditor.md) | JSON validation and transformation | Working with JSON data |
+| [pdf-generator](utils/pdf-creator-editor.md) | PDF generation | Creating reports, invoices |
+
+### Git Skills (1 skill)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [git-commit-helper](git/git-commit-helper.md) | Conventional commit messages | Creating commits |
+
+### Documentation Skills (1 skill)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [markdown-formatter](documentation/markdown-formatter.md) | Markdown formatting standards | Formatting documentation |
+
+### Design Skills (1 skill)
+
+| Skill | Description | When to Use |
+|-------|-------------|-------------|
+| [brand-guidelines](brand-guidelines.md) | Brand consistency in UI | Creating UI components |
+
+## Testing vs Audit Skills
+
+| Aspect | Testing Skills | Audit Skills |
+|--------|----------------|--------------|
+| **When** | During development (Phase 2) | Before deployment (Phase 3-4) |
+| **Frequency** | Continuous (every commit) | Periodic (quarterly, pre-deploy) |
+| **Duration** | Minutes | 60-90 minutes |
+| **Output** | Pass/Fail + Coverage % | Comprehensive report |
+| **Focus** | Does code work? | Meets standards/compliance? |
+
+## Usage
+
+Skills are invoked within agent workflows or directly:
+
+```text
+"Apply the security-testing skill to validate input handling"
+"Use git-commit-helper to generate commit message"
+"Run qa-criteria-validator against the PDR"
+```
+
+## Skill File Format
+
+Each skill file includes:
+
+1. **YAML Frontmatter**
+   - `name`: Unique identifier
+   - `category`: Skill category
+   - `description`: Brief description
+   - `usage`: When to use
+   - `input`/`output`: What skill needs and produces
+   - `config_required`: Configuration directives
+
+2. **Configuration Section**
+   - Table of required settings
+
+3. **Skill Content**
+   - Purpose
+   - Capabilities
+   - Workflow steps
+   - Best practices
+   - Deliverables
+
+## Directory Structure
+
+```text
+skills/
+├── README.md
+├── brand-guidelines.md
+├── audit/
+│   ├── security-audit.md
+│   ├── performance-audit.md
+│   └── accessibility-audit.md
+├── auth/
+│   └── nextauth-patterns.md
+├── documentation/
+│   └── markdown-formatter.md
+├── git/
+│   └── git-commit-helper.md
+├── i18n/
+│   └── i18n-patterns.md
+├── patterns/
+│   ├── error-handling-patterns.md
+│   └── tdd-methodology.md
+├── qa/
+│   ├── qa-criteria-validator.md
+│   └── web-app-testing.md
+├── react/
+│   └── react-hook-form-patterns.md
+├── state/
+│   ├── redux-toolkit-patterns.md
+│   ├── tanstack-query-patterns.md
+│   └── zustand-patterns.md
+├── tech/
+│   ├── mermaid-diagram-specialist.md
+│   ├── shadcn-specialist.md
+│   └── vercel-specialist.md
+├── testing/
+│   ├── api-app-testing.md
+│   ├── performance-testing.md
+│   └── security-testing.md
+└── utils/
+    ├── add-memory.md
+    ├── json-data-auditor.md
+    └── pdf-creator-editor.md
+```
+
+## Adding New Skills
+
+1. Create `.md` file in appropriate category folder
+2. Include YAML frontmatter with `config_required`
+3. Add `⚙️ Configuration` section with settings table
+4. Keep content concise (150-300 lines target)
+5. Update this README
+
+## Related
+
+- [Agents](../agents/README.md)
+- [Commands](../commands/README.md)