mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-10 02:24:35 +08:00
9371af8d8d
- Update workflow-architecture.md: Streamline structure, enforce 10-task hard limit - Update workflow plan.md: Add file cohesion rules, similar functionality warnings - Update task breakdown.md: Manual breakdown controls, conflict detection - Update task-core.md: Sync JSON schema with workflow-architecture.md - Establish consistent 10-task maximum across all workflow commands - Add file cohesion enforcement to prevent splitting related files - Replace "Complex" classification with "Over-scope" requiring re-planning 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
162 lines
4.1 KiB
Markdown
162 lines
4.1 KiB
Markdown
---
|
|
name: create
|
|
description: Create implementation tasks with automatic context awareness
|
|
usage: /task:create "title"
|
|
argument-hint: "task title"
|
|
examples:
|
|
- /task:create "Implement user authentication"
|
|
- /task:create "Build REST API endpoints"
|
|
- /task:create "Fix login validation bug"
|
|
---
|
|
|
|
# Task Create Command (/task:create)
|
|
|
|
## Overview
|
|
Creates new implementation tasks with automatic context awareness and ID generation.
|
|
|
|
## Core Principles
|
|
**Task System:** @~/.claude/workflows/task-core.md
|
|
|
|
## Core Features
|
|
|
|
### Automatic Behaviors
|
|
- **ID Generation**: Auto-generates IMPL-N format (max 2 levels)
|
|
- **Context Inheritance**: Inherits from active workflow session
|
|
- **JSON Creation**: Creates task JSON in active session
|
|
- **Status Setting**: Initial status = "pending"
|
|
- **Agent Assignment**: Suggests agent based on task type
|
|
- **Session Integration**: Updates workflow session stats
|
|
|
|
### Context Awareness
|
|
- Validates active workflow session exists
|
|
- Avoids duplicate task IDs
|
|
- Inherits session requirements and scope
|
|
- Suggests task relationships
|
|
|
|
## Usage
|
|
|
|
### Basic Creation
|
|
```bash
|
|
/task:create "Build authentication module"
|
|
```
|
|
|
|
Output:
|
|
```
|
|
✅ Task created: IMPL-1
|
|
Title: Build authentication module
|
|
Type: feature
|
|
Agent: code-developer
|
|
Status: pending
|
|
```
|
|
|
|
### Task Types
|
|
- `feature` - New functionality (default)
|
|
- `bugfix` - Bug fixes
|
|
- `refactor` - Code improvements
|
|
- `test` - Test implementation
|
|
- `docs` - Documentation
|
|
|
|
## Task Creation Process
|
|
|
|
1. **Session Validation**: Check active workflow session
|
|
2. **ID Generation**: Auto-increment IMPL-N
|
|
3. **Context Inheritance**: Load workflow context
|
|
4. **Implementation Setup**: Initialize implementation field
|
|
5. **Agent Assignment**: Select appropriate agent
|
|
6. **File Creation**: Save JSON to .task/ directory
|
|
7. **Session Update**: Update workflow stats
|
|
|
|
**Task Schema**: See @~/.claude/workflows/task-core.md for complete JSON structure
|
|
|
|
## Implementation Field Setup
|
|
|
|
### Auto-Population Strategy
|
|
- **Detailed info**: Extract from task description and scope
|
|
- **Missing info**: Mark `pre_analysis` as multi-step array format for later pre-analysis
|
|
- **Basic structure**: Initialize with standard template
|
|
|
|
### Analysis Triggers
|
|
When implementation details incomplete:
|
|
```bash
|
|
⚠️ Task requires analysis for implementation details
|
|
Suggest running: gemini analysis for file locations and dependencies
|
|
```
|
|
|
|
## File Management
|
|
|
|
### JSON Task File
|
|
- **Location**: `.task/IMPL-[N].json` in active session
|
|
- **Content**: Complete task with implementation field
|
|
- **Updates**: Session stats only
|
|
|
|
### Simple Process
|
|
1. Validate session and inputs
|
|
2. Generate task JSON
|
|
3. Update session stats
|
|
4. Notify completion
|
|
|
|
## Context Inheritance
|
|
|
|
Tasks inherit from:
|
|
1. **Active Session** - Requirements and scope from workflow-session.json
|
|
2. **Planning Document** - Context from IMPL_PLAN.md
|
|
3. **Parent Task** - For subtasks (IMPL-N.M format)
|
|
|
|
## Agent Assignment
|
|
|
|
Based on task type and title keywords:
|
|
- **Build/Implement** → `code-developer`
|
|
- **Design/Plan** → `planning-agent`
|
|
- **Test/Validate** → `code-review-test-agent`
|
|
- **Review/Audit** → `review-agent`
|
|
|
|
## Validation Rules
|
|
|
|
1. **Session Check** - Active workflow session required
|
|
2. **Duplicate Check** - Avoid similar task titles
|
|
3. **ID Uniqueness** - Auto-increment task IDs
|
|
4. **Schema Validation** - Ensure proper JSON structure
|
|
|
|
## Error Handling
|
|
|
|
```bash
|
|
# No workflow session
|
|
❌ No active workflow found
|
|
→ Use: /workflow init "project name"
|
|
|
|
# Duplicate task
|
|
⚠️ Similar task exists: IMPL-3
|
|
→ Continue anyway? (y/n)
|
|
|
|
# Max depth exceeded
|
|
❌ Cannot create IMPL-1.2.1 (max 2 levels)
|
|
→ Use: IMPL-2 for new main task
|
|
```
|
|
|
|
## Examples
|
|
|
|
### Feature Task
|
|
```bash
|
|
/task:create "Implement user authentication"
|
|
|
|
✅ Created IMPL-1: Implement user authentication
|
|
Type: feature
|
|
Agent: code-developer
|
|
Status: pending
|
|
```
|
|
|
|
### Bug Fix
|
|
```bash
|
|
/task:create "Fix login validation bug" --type=bugfix
|
|
|
|
✅ Created IMPL-2: Fix login validation bug
|
|
Type: bugfix
|
|
Agent: code-developer
|
|
Status: pending
|
|
```
|
|
|
|
## Related Commands
|
|
|
|
- `/task:breakdown` - Break into subtasks
|
|
- `/task:execute` - Execute with agent
|
|
- `/context` - View task details |