From 477ee460995936af00e12b7871a36799123cb7bd Mon Sep 17 00:00:00 2001 From: krsnaa Date: Wed, 2 Jul 2025 08:35:08 -0700 Subject: [PATCH] docs: Add missing /task command documentation and fix command count references (#66) - Add complete /task command documentation to COMMANDS.md with operations, features, and examples - Update command count from 18 to 19 across README.md, ROADMAP.md, and COMMANDS.md - Correct /task syntax in index.md to use colon-based operations (:create, :status, :resume) - Add changelog entry documenting the documentation fixes - Maintain historical accuracy in previous changelog entries --- .claude/commands/index.md | 2 +- .gitignore | 1 + CHANGELOG.md | 7 +++++++ COMMANDS.md | 30 ++++++++++++++++++++++++++++-- README.md | 2 +- ROADMAP.md | 2 +- 6 files changed, 39 insertions(+), 5 deletions(-) diff --git a/.claude/commands/index.md b/.claude/commands/index.md index b8fdc2a..acb4ca9 100644 --- a/.claude/commands/index.md +++ b/.claude/commands/index.md @@ -19,7 +19,7 @@ Commands: `/cmd --flags` | 19 total | Universal flags available **Analysis**: `/analyze` --code|arch | `/review` --files|commit|pr | `/troubleshoot` --fix|prod | `/improve` --perf|quality | `/explain` --depth **Ops**: `/deploy` --env|rollback | `/migrate` --dry-run | `/scan` --security | `/estimate` --detailed | `/cleanup` --all | `/git` --commit|sync **Design**: `/design` --api|ddd | `/document` --api|user | `/spawn` --task -**Manage**: `/task` --create|status | `/load` --context +**Manage**: `/task` :create|:status|:resume | `/load` --context ## Workflow Patterns **Setup**: `/load` → `/dev-setup --install` → `/build --init` → `/test` **Feature**: `/analyze` → `/design --api` → `/build --tdd` → `/test --e2e` → `/deploy` diff --git a/.gitignore b/.gitignore index 35b36f7..2a71dec 100644 --- a/.gitignore +++ b/.gitignore @@ -4,6 +4,7 @@ logs/ # Claude operations documentation .claudedocs/ +.claude_logs/ # Task management (project-specific) ./claudedocs/tasks/ diff --git a/CHANGELOG.md b/CHANGELOG.md index 74e68da..842ea87 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,13 @@ All notable changes to SuperClaude will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [Unreleased] + +### Fixed +- Added missing `/task` command documentation to COMMANDS.md +- Updated command count references from 18 to 19 across documentation files +- Corrected `/task` command flag syntax in index.md to use colon operations + ## [2.0.1] - 2025-06-26 ### Added diff --git a/COMMANDS.md b/COMMANDS.md index f5853e8..b92a99e 100644 --- a/COMMANDS.md +++ b/COMMANDS.md @@ -19,6 +19,7 @@ /analyze --code --persona-architect # Code analysis with architect mindset /build --react --magic --tdd # Build React app with AI components /troubleshoot --prod --five-whys --seq # Production debugging with reasoning +/task:create "Add user authentication" # Create and manage complex features /deploy --env prod --plan --validate # Safe production deployment ``` @@ -379,7 +380,7 @@ Professional system design with specifications. /design --microservices --event-driven # Microservices design ``` -### 🔄 Workflow Commands (3) +### 🔄 Workflow Commands (4) #### `/spawn` - Specialized Agents Spawn focused agents for parallel tasks. @@ -433,6 +434,31 @@ Load and analyze project context. /load --structure --health --standards # Project assessment ``` +#### `/task` - Task Management +Complex feature management across sessions with automatic breakdown and recovery. + +**Command-Specific Operations:** +- `/task:create [description]` - Create new task with automatic breakdown +- `/task:status [task-id]` - Check task status and progress +- `/task:resume [task-id]` - Resume work after break +- `/task:update [task-id] [updates]` - Update task progress and requirements +- `/task:complete [task-id]` - Mark task as done with summary + +**Key Features:** +- **Smart Breakdown**: Automatic complexity analysis and subtask creation +- **Context Preservation**: Save working state across sessions +- **Progress Tracking**: Automatic updates and blocker detection +- **Session Recovery**: Resume from checkpoints with full context + +**Examples:** +```bash +/task:create "Implement OAuth 2.0 authentication system" # Create complex feature +/task:status oauth-task-id # Check progress +/task:resume oauth-task-id # Resume after break +/task:update oauth-task-id "Found library conflict" # Update with discoveries +/task:complete oauth-task-id # Complete with summary +``` + --- ## Flag Combinations & Best Practices @@ -509,4 +535,4 @@ Load and analyze project context. --- -**SuperClaude v2.0.1** - 18 professional commands | 9 cognitive personas | Advanced MCP integration | Evidence-based methodology +**SuperClaude v2.0.1** - 19 professional commands | 9 cognitive personas | Advanced MCP integration | Evidence-based methodology diff --git a/README.md b/README.md index 5440433..1e9c436 100644 --- a/README.md +++ b/README.md @@ -283,7 +283,7 @@ SuperClaude v2's architecture enables extensibility: | Aspect | Standard Claude Code | SuperClaude Framework | |--------|---------------------|----------------------| | **Expertise** | General responses | 9 specialized personas | -| **Commands** | Manual instructions | 18 workflow commands | +| **Commands** | Manual instructions | 19 workflow commands | | **Context** | Session-based | Git checkpoint support | | **Tokens** | Standard usage | Compression options | | **Approach** | General purpose | Evidence-based | diff --git a/ROADMAP.md b/ROADMAP.md index e59a643..eae597f 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -8,7 +8,7 @@ SuperClaude is a configuration framework for Claude Code that enhances developme Released with architectural improvements including the @include reference system, unified persona flags, and enhanced installer. ### Current Features -- ✅ 18 slash commands with unified flag system +- ✅ 19 slash commands with unified flag system - ✅ MCP integration (Context7, Sequential, Magic, Puppeteer) - ✅ 9 Personas integrated as universal flags - ✅ Token economy with compression options