refactor: Enhance agent definitions and workflow documentation structure

- Update agent role definitions with clearer responsibilities and capabilities
- Refine task execution workflows with improved context gathering protocols
- Enhance tool implementation guide with better command examples
- Streamline workflow architecture documentation for better clarity

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

.claude/workflows/task-core.md

@@ -71,7 +71,18 @@ All task files use this unified 10-field structure:
       "performance_considerations": "JWT adds ~5ms latency",
       "error_handling": "No sensitive data in errors"
     },
-    "analysis_source": "manual|gemini|codex|auto-detected"
+    "pre_analysis": [
+      {
+        "action": "analyze patterns",
+        "template": "~/.claude/workflows/cli-templates/prompts/analysis/pattern.txt",
+        "method": "gemini"
+      },
+      {
+        "action": "implement feature",
+        "template": "~/.claude/workflows/cli-templates/prompts/development/feature.txt",
+        "method": "codex"
+      }
+    ]
   }
 }
 ```
@@ -96,7 +107,7 @@ All task files use this unified 10-field structure:
 - **performance_considerations**: Performance impact
 - **error_handling**: Error handling requirements
 
-### analysis_source Options
+### pre_analysis Options
 - **manual**: User-provided details
 - **auto-detected**: System-inferred
 - **gemini**: Requires Gemini CLI analysis

.claude/workflows/tools-implementation-guide.md

@@ -22,6 +22,39 @@ type: technical-guideline
 
 **Usage**: `$(cat ~/.claude/workflows/cli-templates/prompts/[category]/[template].txt)`
 
+### 📚 Template Quick Reference Map
+
+**Full Path Format**: All templates use complete paths starting with `~/.claude/`
+
+**Analysis Templates**:
+- `~/.claude/workflows/cli-templates/prompts/analysis/pattern.txt` - Pattern detection and convention analysis
+- `~/.claude/workflows/cli-templates/prompts/analysis/architecture.txt` - System architecture review
+- `~/.claude/workflows/cli-templates/prompts/analysis/security.txt` - Security vulnerability assessment
+- `~/.claude/workflows/cli-templates/prompts/analysis/performance.txt` - Performance bottleneck analysis
+- `~/.claude/workflows/cli-templates/prompts/analysis/quality.txt` - Code quality and maintainability review
+
+**Development Templates**:
+- `~/.claude/workflows/cli-templates/prompts/development/feature.txt` - Feature implementation guidance
+- `~/.claude/workflows/cli-templates/prompts/development/component.txt` - Component development patterns
+- `~/.claude/workflows/cli-templates/prompts/development/refactor.txt` - Refactoring strategies
+- `~/.claude/workflows/cli-templates/prompts/development/testing.txt` - Test generation and coverage
+- `~/.claude/workflows/cli-templates/prompts/development/debugging.txt` - Issue diagnosis and resolution
+
+**Planning Templates**:
+- `~/.claude/workflows/cli-templates/prompts/planning/task-breakdown.txt` - Task decomposition strategy
+- `~/.claude/workflows/cli-templates/prompts/planning/migration.txt` - Migration planning and execution
+
+**Automation Templates**:
+- `~/.claude/workflows/cli-templates/prompts/automation/scaffold.txt` - Project scaffolding automation
+- `~/.claude/workflows/cli-templates/prompts/automation/deployment.txt` - Deployment configuration
+
+**Review Templates**:
+- `~/.claude/workflows/cli-templates/prompts/review/code-review.txt` - Code review checklist
+
+**Integration Templates**:
+- `~/.claude/workflows/cli-templates/prompts/integration/api-design.txt` - API design patterns
+- `~/.claude/workflows/cli-templates/prompts/integration/database.txt` - Database schema design
+
 ### 📂 File Pattern Wildcards
 
 ```bash

.claude/workflows/workflow-architecture.md

@@ -152,7 +152,18 @@ All task files use this 10-field schema:
       "performance_considerations": "JWT validation will add approximately 5ms latency",
       "error_handling": "Ensure sensitive information is not leaked in error responses"
     },
-    "analysis_source": "manual|gemini|codex|auto-detected"
+    "pre_analysis": [
+      {
+        "action": "analyze patterns",
+        "template": "~/.claude/workflows/cli-templates/prompts/analysis/pattern.txt",
+        "method": "gemini"
+      },
+      {
+        "action": "generate implementation",
+        "template": "~/.claude/workflows/cli-templates/prompts/development/feature.txt",
+        "method": "codex"
+      }
+    ]
   }
 }
 ```
@@ -221,7 +232,7 @@ The **implementation** field provides detailed code implementation guidance with
 - **performance_considerations**: Performance impact assessment
 - **error_handling**: Error handling requirements
 
-#### analysis_source - Information Source Identifier
+#### pre_analysis - Information Source Identifier
 - **manual**: Detailed information manually provided by user
 - **gemini**: Automatically obtained through Gemini CLI analysis
 - **codex**: Automatically obtained through Codex CLI analysis
@@ -419,7 +430,7 @@ generate_todo_list_from_json .task/
 5. **Status Consistency**: Status values from defined enumeration
 6. **Required Fields**: All 9 core fields must be present
 7. **Implementation Structure**: implementation.files array must contain valid file paths
-8. **Analysis Source**: analysis_source must be one of: manual|gemini|codex|auto-detected
+8. **Pre-Analysis Source**: pre_analysis must be multi-step array format with action, template, method
 
 ### Session Consistency Checks
 ```bash