@qazuor/claude-code-config 0.1.0

package/templates/commands/planning/sync-todos-github.md

@@ -0,0 +1,203 @@
+---
+name: sync-todos-github
+description: Sync code TODO comments to GitHub Issues
+type: planning
+category: planning
+config_required:
+  github_token_env: "GitHub token environment variable"
+  github_owner_env: "Repository owner env variable"
+  github_repo_env: "Repository name env variable"
+  tracking_file: "GitHub tracking file path"
+  todo_patterns: "Patterns to match (e.g., TODO, HACK, DEBUG)"
+---
+
+# Sync Code TODOs to GitHub
+
+Scan codebase for TODO/HACK/DEBUG comments and sync to GitHub Issues.
+
+## ⚙️ Configuration
+
+| Setting | Description | Example |
+|---------|-------------|---------|
+| `github_token_env` | GitHub token variable | `{{GITHUB_TOKEN}}` |
+| `github_owner_env` | Owner variable | `{{GITHUB_OWNER}}` |
+| `github_repo_env` | Repository variable | `{{GITHUB_REPO}}` |
+| `tracking_file` | Tracking data file | `{{TRACKING_FILE}}` |
+| `todo_patterns` | Comment patterns to match | `TODO, HACK, DEBUG` |
+
+## Usage
+
+```bash
+/sync-todos-github [scan_path]
+```
+
+## When to Use
+
+- Before committing code with new TODOs
+- To convert technical debt markers to issues
+- For team visibility on code tasks
+- As part of pre-commit hook
+- When reviewing technical debt
+
+## Process
+
+### Step 1: Identify Scope
+
+Scan options:
+
+- **Full codebase:** All files
+- **Specific directory:** Single package/app
+- **Changed files:** Git-modified only (recommended)
+
+### Step 2: Get Configuration
+
+Required:
+
+- `{{GITHUB_TOKEN}}`
+- `{{GITHUB_OWNER}}`
+- `{{GITHUB_REPO}}`
+
+### Step 3: Scan for TODOs
+
+Match patterns:
+
+```typescript
+// TODO: Description
+// TODO(username): Assigned task
+// TODO[HIGH]: High priority
+// TODO: #bug Task with label
+// HACK: Temporary workaround
+// DEBUG: Remove before production
+```
+
+### Step 4: Execute Sync
+
+- Create issues for new TODOs
+- Update existing issues
+- Close issues for removed TODOs
+- Add issue links to comments
+
+### Step 5: Report Results
+
+```text
+✅ TODOs synced to GitHub!
+
+Statistics:
+   • {n} new issues created
+   • {n} issues updated
+   • {n} issues closed (TODOs removed)
+   • {n} skipped
+
+Created Issues:
+   • #{n}: Description (file.ts:42)
+   • #{n}: Description (file.ts:78)
+
+Updated Comments:
+   Comments now have issue links
+
+Next Steps:
+   1. Review issues in GitHub
+   2. Commit updated files
+   3. Use /check-completed when resolved
+```
+
+### Step 6: Update Comments
+
+Automatically adds issue links:
+
+**Before:**
+
+```typescript
+// TODO: Fix authentication error
+```
+
+**After:**
+
+```typescript
+// TODO: Fix authentication error
+// GitHub: {issue_url}
+```
+
+## Error Handling
+
+| Error | Solution |
+|-------|----------|
+| Missing config | Set environment variables |
+| No TODOs found | Verify patterns and scan path |
+| API errors | Check token and permissions |
+| Parse errors | Fix syntax, re-run sync |
+
+## Advanced Options
+
+### Scan Specific Directory
+
+```typescript
+{ scanPath: 'packages/api' }
+```
+
+### Dry Run
+
+```typescript
+{ dryRun: true }
+```
+
+### Custom Patterns
+
+```typescript
+{
+  include: ['**/*.ts', '**/*.tsx'],
+  exclude: ['**/node_modules/**']
+}
+```
+
+### Preserve Comments
+
+```typescript
+{ updateComments: false }
+```
+
+## Comment Format
+
+### Basic
+
+```typescript
+// TODO: Add validation
+```
+
+### With Priority
+
+```typescript
+// TODO[HIGH]: Fix security issue
+```
+
+### With Assignment
+
+```typescript
+// TODO(john): Review query
+```
+
+### With Labels
+
+```typescript
+// TODO: #bug #security Fix injection
+```
+
+### Combined
+
+```typescript
+// TODO[HIGH](maria): #feature Add auth
+```
+
+## Important Notes
+
+- **Labels:** Auto-generated from comment type
+- **Priority:** [HIGH], [MEDIUM], [LOW] become labels
+- **Assignment:** TODO(username) auto-assigns
+- **Context:** Issues include code snippet and location
+- **Auto-close:** Issues close when TODOs removed
+
+## Related Commands
+
+- `/sync-planning-github` - Sync planning sessions
+- `/check-completed` - Auto-close completed
+- `/cleanup-issues` - Clean stale issues

package/templates/commands/quality-check.md

@@ -0,0 +1,211 @@
+---
+name: quality-check
+description: Master quality validation before merge - runs code checks, tests, and reviews
+type: quality
+category: validation
+config_required:
+  - test_command: "Command to run tests (e.g., pnpm test)"
+  - lint_command: "Command to run linting (e.g., pnpm lint)"
+  - typecheck_command: "Command to run type checking (e.g., pnpm typecheck)"
+  - coverage_target: "Minimum coverage percentage (default: 90)"
+---
+
+# Quality Check Command
+
+## ⚙️ Configuration
+
+Ensure your project has these commands configured in `package.json`:
+
+| Setting | Description | Example |
+|---------|-------------|---------|
+| `test` | Run test suite with coverage | `vitest run --coverage` |
+| `lint` | Run linter | `eslint .` or `biome check .` |
+| `typecheck` | Run TypeScript compiler | `tsc --noEmit` |
+
+---
+
+## Purpose
+
+Master quality validation command that runs all quality checks before code can be merged. This is a **required gate** before any PR merge.
+
+---
+
+## Usage
+
+```bash
+/quality-check
+```
+
+---
+
+## Execution Flow
+
+### Step 1: Code Quality (STOP on error)
+```bash
+{{TYPECHECK_COMMAND}}  # e.g., pnpm typecheck
+{{LINT_COMMAND}}       # e.g., pnpm lint
+```
+**Behavior**: If either fails, STOP and report errors. Do not continue.
+
+### Step 2: Tests & Coverage (STOP on failure)
+```bash
+{{TEST_COMMAND}}  # e.g., pnpm test:coverage
+```
+**Behavior**:
+- If tests fail, STOP and report failures
+- If coverage < {{COVERAGE_TARGET}}%, STOP and report
+
+### Step 3: Code Review (REPORT findings)
+Invoke tech-lead agent for code review:
+- Architecture patterns
+- Code quality standards
+- Documentation completeness
+
+**Behavior**: Report all findings, do not stop.
+
+### Step 4: Security Review (REPORT findings)
+Check for:
+- Input validation
+- Authentication/authorization
+- Sensitive data handling
+- Dependency vulnerabilities
+
+**Behavior**: Report all findings, do not stop.
+
+### Step 5: Performance Review (REPORT findings)
+Check for:
+- N+1 queries
+- Missing indexes
+- Inefficient algorithms
+- Bundle size (frontend)
+
+**Behavior**: Report all findings, do not stop.
+
+---
+
+## Output Format
+
+### Success
+```
+✅ QUALITY CHECK PASSED
+
+📋 Results:
+✅ TypeScript: No errors
+✅ Linting: No issues
+✅ Tests: 142 passed, 0 failed
+✅ Coverage: 94.2% (target: 90%)
+
+📝 Review Notes:
+- Code follows patterns ✓
+- Documentation complete ✓
+- No security issues ✓
+- Performance acceptable ✓
+
+🚀 Ready to merge
+```
+
+### Failure (Critical)
+```
+❌ QUALITY CHECK FAILED
+
+📋 Results:
+✅ TypeScript: No errors
+❌ Tests: 140 passed, 2 failed
+⚠️ Coverage: 87.3% (target: 90%)
+
+🛑 BLOCKING ISSUES:
+
+1. Test Failures:
+   - src/services/user.test.ts:45 - "should validate email"
+   - src/api/auth.test.ts:78 - "should reject expired tokens"
+
+2. Coverage Below Target:
+   - Current: 87.3%
+   - Required: 90%
+   - Missing: src/utils/date-helper.ts (45% coverage)
+
+Fix these issues before merging.
+```
+
+### Partial Success (Warnings)
+```
+⚠️ QUALITY CHECK PASSED WITH WARNINGS
+
+📋 Results:
+✅ TypeScript: No errors
+✅ Linting: No issues
+✅ Tests: 142 passed
+✅ Coverage: 91.5%
+
+⚠️ ADVISORY ISSUES:
+
+Code Review:
+- Medium: Missing JSDoc on 3 exported functions
+- Low: Consider extracting repeated logic in UserService
+
+Security Review:
+- Low: Consider adding rate limiting to /api/auth endpoints
+
+Performance Review:
+- Medium: Potential N+1 query in getOrdersWithItems()
+
+These don't block merge but should be addressed.
+```
+
+---
+
+## Behavior Rules
+
+| Check | On Failure |
+|-------|------------|
+| TypeScript errors | **STOP** - Must fix |
+| Lint errors | **STOP** - Must fix |
+| Test failures | **STOP** - Must fix |
+| Coverage below target | **STOP** - Must fix |
+| Code review issues | **REPORT** - Advisory |
+| Security issues | **REPORT** - Advisory (unless Critical) |
+| Performance issues | **REPORT** - Advisory |
+
+**Exception**: Critical security issues should block merge.
+
+---
+
+## Issue Severity
+
+| Severity | Description | Action |
+|----------|-------------|--------|
+| **Critical** | Security vulnerabilities, data loss risk | Must fix before merge |
+| **High** | Bugs, broken functionality | Must fix before merge |
+| **Medium** | Code quality, patterns, performance | Should fix, can merge |
+| **Low** | Style, minor improvements | Nice to have |
+
+---
+
+## Quick Reference
+
+```bash
+# Run individual checks
+{{TYPECHECK_COMMAND}}
+{{LINT_COMMAND}}
+{{TEST_COMMAND}}
+
+# Run full quality check
+/quality-check
+```
+
+---
+
+## Related Commands
+
+- `/code-check` - Only lint + typecheck (faster)
+- `/run-tests` - Only tests with coverage
+- `/security-audit` - Deep security review
+- `/performance-audit` - Deep performance review
+
+---
+
+## When to Use
+
+- **Required**: Before every PR merge
+- **Recommended**: Before pushing to main
+- **Optional**: During development for early feedback

package/templates/commands/run-tests.md

@@ -0,0 +1,159 @@
+---
+name: run-tests
+description: Execute test suite and validate coverage requirements
+type: quality
+category: validation
+config_required:
+  - TEST_COMMAND: "Command to run tests (e.g., pnpm test)"
+  - COVERAGE_COMMAND: "Command to run coverage (e.g., pnpm test:coverage)"
+  - COVERAGE_THRESHOLD: "Minimum coverage percentage (e.g., 90)"
+  - PROJECT_ROOT: "Project root directory path"
+---
+
+# Run Tests Command
+
+## Purpose
+
+Execute comprehensive test suite and validate coverage requirements. Stops at first failure.
+
+## ⚙️ Configuration
+
+| Setting | Description | Example |
+|---------|-------------|---------|
+| TEST_COMMAND | Test execution command | `pnpm test` |
+| COVERAGE_COMMAND | Coverage command | `pnpm test:coverage` |
+| COVERAGE_THRESHOLD | Minimum coverage % | `90` |
+| PROJECT_ROOT | Project root directory | `/path/to/project` |
+| STOP_ON_ERROR | Stop on first failure | `true` |
+
+## Usage
+
+```bash
+/run-tests
+```
+
+## Execution Flow
+
+### 1. Test Execution
+
+**Process:**
+
+| Step | Action |
+|------|--------|
+| 1 | Navigate to {{PROJECT_ROOT}} |
+| 2 | Execute {{TEST_COMMAND}} |
+| 3 | Run all test suites |
+| 4 | Stop on first failure |
+
+**Test Categories:**
+
+- Unit tests
+- Integration tests
+- API/Endpoint tests
+- Component tests
+
+**Output on Failure:**
+
+```text
+❌ TESTS FAILED
+
+Test: {{TEST_NAME}}
+File: {{FILE_PATH}}:{{LINE}}
+
+Expected: {{EXPECTED}}
+Received: {{ACTUAL}}
+
+Error: {{ERROR_MESSAGE}}
+
+Fix required before proceeding.
+```
+
+### 2. Coverage Validation
+
+**Process:**
+
+| Step | Action |
+|------|--------|
+| 1 | Execute {{COVERAGE_COMMAND}} |
+| 2 | Validate coverage thresholds |
+| 3 | Generate coverage report |
+| 4 | Identify uncovered code |
+
+**Coverage Metrics:**
+
+| Metric | Threshold |
+|--------|-----------|
+| Statements | ≥ {{COVERAGE_THRESHOLD}}% |
+| Branches | ≥ {{COVERAGE_THRESHOLD}}% |
+| Functions | ≥ {{COVERAGE_THRESHOLD}}% |
+| Lines | ≥ {{COVERAGE_THRESHOLD}}% |
+
+**Output on Insufficient Coverage:**
+
+```text
+❌ INSUFFICIENT COVERAGE
+
+Coverage Results:
+❌ Statements: {{ACTUAL}}% (target: ≥{{THRESHOLD}}%)
+❌ Branches: {{ACTUAL}}% (target: ≥{{THRESHOLD}}%)
+❌ Functions: {{ACTUAL}}% (target: ≥{{THRESHOLD}}%)
+❌ Lines: {{ACTUAL}}% (target: ≥{{THRESHOLD}}%)
+
+Uncovered Files:
+- {{FILE_PATH}} (Lines: {{UNCOVERED_LINES}})
+
+Add tests for uncovered code paths.
+```
+
+## Quality Standards
+
+| Category | Requirements |
+|----------|--------------|
+| **Test Structure** | AAA pattern (Arrange, Act, Assert) |
+| **Coverage** | Minimum {{COVERAGE_THRESHOLD}}% across all metrics |
+| **Test Isolation** | No dependencies between tests |
+| **Assertions** | Clear, specific assertions |
+
+## Output Format
+
+### Success
+
+```text
+✅ TESTS PASSED
+
+Test Results:
+✅ Unit Tests: {{PASSED}}/{{TOTAL}} passed
+✅ Integration Tests: {{PASSED}}/{{TOTAL}} passed
+✅ All test suites passing
+
+Coverage Results:
+✅ Statements: {{ACTUAL}}% (target: ≥{{THRESHOLD}}%)
+✅ Branches: {{ACTUAL}}% (target: ≥{{THRESHOLD}}%)
+✅ Functions: {{ACTUAL}}% (target: ≥{{THRESHOLD}}%)
+✅ Lines: {{ACTUAL}}% (target: ≥{{THRESHOLD}}%)
+
+🚀 All quality standards met
+```
+
+### Failure
+
+```text
+❌ TESTS FAILED
+
+{{ERROR_DETAILS}}
+
+Fix failing tests or add missing coverage.
+```
+
+## Related Commands
+
+- `/quality-check` - Full quality validation
+- `/code-check` - Code quality validation
+- `/review-code` - Code review
+
+## When to Use
+
+- Before every commit
+- As part of `/quality-check`
+- After significant changes
+- In CI/CD pipeline