@qazuor/claude-code-config 0.1.0

package/templates/commands/meta/help.md

@@ -0,0 +1,318 @@
+---
+name: help
+type: meta
+category: system
+description: Interactive help system for commands, agents, skills, and workflows
+config_required:
+  - help_topics: "Define available help topics"
+  - doc_locations: "Configure documentation paths"
+  - display_limits: "Set display limits for lists"
+---
+
+# Help Command
+
+## Purpose
+
+Comprehensive, context-aware help system providing guidance on commands, agents, skills, workflow, and project structure.
+
+## ⚙️ Configuration
+
+| Setting | Description | Example |
+|---------|-------------|---------|
+| `help_topics` | Available topics | `commands, agents, skills, workflow, quick-start` |
+| `doc_locations.base` | Documentation root | `.claude/docs/` |
+| `doc_locations.agents` | Agents directory | `.claude/agents/` |
+| `doc_locations.commands` | Commands directory | `.claude/commands/` |
+| `display_limits.list` | Max items in list | `20` |
+| `search_enabled` | Enable search | `true` |
+
+## Usage
+
+```bash
+/help [topic] [options]
+```
+
+### Topics
+
+- `commands` - List and search commands
+- `agents` - Browse agents by category
+- `skills` - View available skills
+- `workflow` - Understand workflow phases
+- `quick-start` - Get started quickly
+- `architecture` - Project structure overview
+- `glossary` - Terminology and concepts
+
+### Options
+
+- `--search <query>`: Search across documentation
+- `--category <cat>`: Filter by category
+- `--details`: Show detailed information
+- `--examples`: Show usage examples
+
+## When to Use
+
+- Getting started
+- Command discovery
+- Agent information
+- Workflow guidance
+- Troubleshooting
+
+## Help System Structure
+
+### Main Menu
+
+```text
+🎯 Help System
+
+📚 Available Topics:
+1. commands - Available slash commands
+2. agents - Specialized AI agents
+3. skills - Reusable workflows
+4. workflow - Development workflow
+5. quick-start - Getting started guide
+6. architecture - Project structure
+7. glossary - Terminology
+
+🔍 Search: /help --search <query>
+```
+
+### Commands Help
+
+```text
+📜 Available Commands
+
+🔧 Development & Workflow ({count})
+{command_list}
+
+📋 Planning ({count})
+{command_list}
+
+✅ Quality ({count})
+{command_list}
+
+[Additional categories...]
+
+Use /help commands <name> for details
+```
+
+### Agents Help
+
+```text
+🤖 Available Agents
+
+📦 Product & Planning ({count})
+{agent_list}
+
+🛠️ Backend Development ({count})
+{agent_list}
+
+[Additional categories...]
+
+Use /help agents <name> for details
+```
+
+### Skills Help
+
+```text
+🎯 Available Skills
+
+🧪 Testing ({count})
+{skill_list}
+
+🔧 Development ({count})
+{skill_list}
+
+[Additional categories...]
+
+Use /help skills <name> for details
+```
+
+### Workflow Help
+
+```text
+🔄 Development Workflow
+
+📋 Phase 1: Planning
+Goal: {goal}
+Steps: {steps}
+Time: {estimate}
+Deliverables: {deliverables}
+
+🛠️ Phase 2: Implementation
+[Similar structure...]
+
+✅ Phase 3: Validation
+[Similar structure...]
+
+📝 Phase 4: Finalization
+[Similar structure...]
+```
+
+## Detailed Help Output
+
+### Command Details
+
+```text
+Command: /{command-name}
+
+Type: {type}
+Category: {category}
+
+Description: {description}
+
+When to Use:
+{scenarios}
+
+Usage: {syntax}
+
+Options: {options}
+
+Examples: {examples}
+
+Related Commands: {related}
+
+Documentation: {file_path}
+```
+
+### Agent Details
+
+```text
+Agent: {agent-name}
+
+Category: {category}
+Model: {model}
+
+Description: {description}
+
+Responsibilities: {responsibilities}
+
+Tools: {tools}
+
+Phases: {phases}
+
+Invocation Examples: {examples}
+
+Works With: {agents}
+
+Documentation: {file_path}
+```
+
+## Search Functionality
+
+```bash
+/help --search "testing"
+```
+
+**Output**:
+
+```text
+🔍 Search Results for "testing"
+
+📜 Commands ({count})
+{matching_commands}
+
+🤖 Agents ({count})
+{matching_agents}
+
+🎯 Skills ({count})
+{matching_skills}
+
+📚 Documentation ({count})
+{matching_docs}
+```
+
+## Quick Start
+
+```text
+🚀 Quick Start Guide
+
+Step 1: Understand Structure
+{overview}
+
+Step 2: Basic Commands
+{essential_commands}
+
+Step 3: Understand Workflow
+{workflow_overview}
+
+Next Steps:
+{recommended_actions}
+```
+
+## Architecture Overview
+
+```text
+🏗️ Project Architecture
+
+Monorepo Structure:
+{directory_structure}
+
+Tech Stack:
+{technology_overview}
+
+Architecture Patterns:
+{patterns}
+
+Documentation: {paths}
+```
+
+## Glossary
+
+```text
+📖 Glossary
+
+Agent: {definition}
+Command: {definition}
+Skill: {definition}
+[Additional terms...]
+
+[View full glossary]: {path}
+```
+
+## Error Handling
+
+### Topic Not Found
+
+```text
+❌ Help Topic Not Found
+
+Topic "{topic}" not found.
+
+Available topics: {list}
+
+Try:
+  /help - Main menu
+  /help --search {topic}
+```
+
+## Integration
+
+Available at all times for:
+
+- Onboarding
+- Discovery
+- Troubleshooting
+- Learning
+
+## Best Practices
+
+1. Start with quick-start
+2. Use search feature
+3. Explore by category
+4. Read detailed help
+5. Reference documentation
+
+## Related Commands
+
+- `/create-agent` - Create new agent
+- `/create-command` - Create new command
+- `/create-skill` - Create new skill
+
+## Notes
+
+- Context-aware output
+- Full-text search capability
+- Examples included
+- Direct documentation links
+- Interactive navigation
+- Auto-generated from files

package/templates/commands/planning/check-completed-tasks.md

@@ -0,0 +1,224 @@
+---
+name: check-completed-tasks
+description: Auto-detect completed tasks from commits and close issues
+type: planning
+category: planning
+config_required:
+  issue_tracker: "Issue tracking system name"
+  issue_tracker_token_env: "Auth token environment variable"
+  issue_tracker_owner_env: "Owner/org environment variable"
+  issue_tracker_repo_env: "Repository environment variable"
+  tracking_file: "Issue tracking data file"
+  task_code_pattern: "Pattern for task codes in commits (e.g., T-XXX-XXX)"
+---
+
+# Check Completed Tasks
+
+Auto-detect completed tasks from git commits and close corresponding issues.
+
+## ⚙️ Configuration
+
+| Setting | Description | Example |
+|---------|-------------|---------|
+| `issue_tracker` | Issue tracking system | `{{ISSUE_TRACKER}}` |
+| `issue_tracker_token_env` | Auth token variable | `{{ISSUE_TRACKER_TOKEN}}` |
+| `issue_tracker_owner_env` | Owner variable | `{{ISSUE_TRACKER_OWNER}}` |
+| `issue_tracker_repo_env` | Repository variable | `{{ISSUE_TRACKER_REPO}}` |
+| `tracking_file` | Tracking data file | `{{TRACKING_FILE}}` |
+| `task_code_pattern` | Task code pattern | `{{TASK_CODE_PATTERN}}` |
+
+## Usage
+
+```bash
+/check-completed [commit_range]
+```
+
+## When to Use
+
+- After committing code that completes tasks
+- As part of post-commit hook (automated)
+- To bulk-check recent commits
+- Before status meetings
+- When reviewing project progress
+
+## Process
+
+### Step 1: Determine Range
+
+Scan options:
+
+- **Last commit:** Most recent only
+- **Last N commits:** Recent N commits
+- **Since date:** All since specific date
+- **Commit range:** Specific range (e.g., HEAD~5..HEAD)
+
+### Step 2: Get Configuration
+
+Required:
+
+- `{{ISSUE_TRACKER_TOKEN}}`
+- `{{ISSUE_TRACKER_OWNER}}`
+- `{{ISSUE_TRACKER_REPO}}`
+
+### Step 3: Parse Commits
+
+Match task codes in commit messages:
+
+**Supported formats:**
+
+```text
+feat(api): implement auth [T-003-012]
+fix(db): resolve timeout T-005-003
+refactor: optimize query (T-002-007)
+```
+
+Patterns:
+
+- `[T-XXX-XXX]` - Bracketed
+- `T-XXX-XXX` - Bare
+- `(T-XXX-XXX)` - Parenthesized
+
+### Step 4: Execute Detection
+
+- Parse commit messages
+- Identify completed tasks
+- Update TODOs.md status
+- Close corresponding issues
+
+### Step 5: Report Results
+
+```text
+✅ Completed tasks detected!
+
+Statistics:
+   • {n} tasks detected
+   • {n} tasks completed
+   • {n} issues closed
+   • {n} failed
+
+Completed Tasks:
+   • T-003-012: Task name
+     Commit: {hash} - {message}
+     Issue: #{n} (closed)
+
+Updated Files:
+   • TODOs.md
+   • {{TRACKING_FILE}}
+
+Next Steps:
+   1. Review closed issues
+   2. Commit updated TODOs.md
+   3. Continue with next tasks
+```
+
+### Step 6: Update TODOs.md
+
+**Before:**
+
+```markdown
+### T-003-012: Task name
+
+**Status:** [ ] Pending
+**Issue:** [#{n}]({url})
+```
+
+**After:**
+
+```markdown
+### T-003-012: Task name
+
+**Status:** [x] Completed
+**Completed:** {date}
+**Issue:** [#{n}]({url}) ✓ Closed
+```
+
+### Step 7: Close Issues
+
+Issues automatically closed with completion comment:
+
+```text
+Task completed!
+
+Commit: {hash}
+Message: {message}
+
+Automatically detected and closed.
+```
+
+## Error Handling
+
+| Error | Solution |
+|-------|----------|
+| Missing config | Set environment variables |
+| No tasks detected | Include task codes in commits |
+| API errors | Check token and permissions |
+| File not found | Verify planning session exists |
+
+## Advanced Options
+
+### Scan Specific Session
+
+```typescript
+{ sessionPath: '{{PLANNING_PATH}}/{session}' }
+```
+
+### Dry Run
+
+```typescript
+{ dryRun: true }
+```
+
+### Skip TODOs Update
+
+```typescript
+{ updateTodos: false }
+```
+
+### Skip Issue Closure
+
+```typescript
+{ closeIssues: false }
+```
+
+## Commit Best Practices
+
+### Include Task Code
+
+```bash
+git commit -m "feat(api): implement auth [T-003-012]"
+```
+
+### Conventional Commits
+
+```bash
+git commit -m "feat(api): add endpoints [T-005-001]"
+git commit -m "fix(db): resolve issue [T-005-002]"
+```
+
+### Multiple Tasks
+
+```bash
+git commit -m "feat(api): complete flow [T-003-012][T-003-013]"
+```
+
+### Partial Progress
+
+```bash
+git commit -m "wip(api): partial auth (T-003-012)"
+# Using 'wip' or '(code)' won't trigger auto-completion
+```
+
+## Important Notes
+
+- **Automatic:** Runs via post-commit hook if configured
+- **Idempotent:** Safe to run multiple times
+- **Validation:** Verifies files exist before marking complete
+- **Tracking:** Updates {{TRACKING_FILE}} with completion data
+- **Reversible:** Can manually reopen issues
+- **Linking:** Issues link to completion commits
+
+## Related Commands
+
+- `/sync-planning` - Sync planning to tracker
+- `/sync-todos` - Sync code TODOs
+- `/cleanup-issues` - Clean stale issues