refactor: integrate template guidance into tool descriptions

- Enhanced ApplyTemplateTool description with template combination patterns and context efficiency techniques
- Updated UpdateSectionTextTool description with targeted update strategies and usage examples
- Removed TemplateMgtGuidance.kt prompts that were not user-invokable
- Integrated template selection strategies and multi-template application guidance directly into tool descriptions
- Added category-based template organization and workflow integration patterns
- Improved context efficiency guidance for AI agents using template tools

This makes template usage patterns automatically available to AI agents rather than requiring manual prompt invocation.

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

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

Author: jpicklyk

src/main/kotlin/io/github/jpicklyk/mcptask/application/tools/section/UpdateSectionTextTool.kt

@@ -24,8 +24,29 @@ class UpdateSectionTextTool : BaseToolDefinition() {
         This tool allows changing portions of section content by providing the text to replace
         and its replacement.
         
-        This is particularly useful for large section contents where sending the entire
-        content for small changes would be inefficient for context usage.
+        ## Context Efficiency Strategy
+        
+        **PREFERRED** for targeted content updates in large sections:
+        - Only send the specific text segment to replace and its replacement
+        - Much more efficient than sending entire content for small changes
+        - Ideal for correcting typos, updating specific paragraphs, or modifying parts of documentation
+        - Significantly reduces token usage compared to full content updates
+        
+        **When to Use**:
+        - Correcting typos in template-generated content
+        - Updating specific values or references within larger documentation
+        - Making incremental improvements to existing sections
+        - Modifying parts of sections without affecting the overall structure
+        
+        **Usage Examples**:
+        - Fixing typos: `oldText: "straegy"` → `newText: "strategy"`
+        - Updating references: `oldText: "version 1.0"` → `newText: "version 2.0"`
+        - Modifying template placeholders: `oldText: "[Insert details here]"` → `newText: "Actual implementation details"`
+        
+        **Compared to Other Update Tools**:
+        - Use `update_section_text` for content changes (most efficient for partial updates)
+        - Use `update_section_metadata` for title, format, ordinal, or tag changes
+        - Use `update_section` for complete content replacement (less efficient)
         
         Parameters:
         - id (required): UUID of the section to update

src/main/kotlin/io/github/jpicklyk/mcptask/application/tools/template/ApplyTemplateTool.kt

@@ -31,8 +31,66 @@ class ApplyTemplateTool(
 
     override val description: String = """Apply one or more templates to create sections for a task or feature.
         
-        Templates provide a standardized structure for task and feature documentation.
-        This tool applies templates to an entity, creating sections based on the templates' section definitions.
+        ## Purpose
+        Templates provide standardized structure for task and feature documentation.
+        This tool applies templates to an entity, creating sections based on template section definitions.
+        
+        ## Template Application Strategies
+        
+        **Multiple Template Support**:
+        - Apply multiple templates in single operation using templateIds array
+        - Templates applied in array order (later templates' sections appear after earlier ones)
+        - Use single-item array for one template: ["template-uuid"]
+        - Use multiple templates for comprehensive coverage: ["uuid1", "uuid2", "uuid3"]
+        
+        **Template Combination Patterns**:
+        The template system is organized into composable categories:
+        
+        **AI Workflow Instructions** (process guidance):
+        - Local Git Branching Workflow, GitHub PR Workflow
+        - Task Implementation Workflow, Bug Investigation Workflow
+        
+        **Documentation Properties** (information capture):
+        - Technical Approach, Requirements Specification, Context & Background
+        
+        **Process & Quality** (standards and completion):
+        - Testing Strategy, Definition of Done
+        
+        **Recommended Combinations**:
+        - **Development Task**: Technical Approach + Task Implementation Workflow + Testing Strategy
+        - **Bug Fix**: Bug Investigation Workflow + Technical Approach + Definition of Done
+        - **Feature Planning**: Requirements Specification + Context & Background + Testing Strategy
+        - **Complex Implementation**: Technical Approach + Local Git Branching + GitHub PR + Definition of Done
+        
+        ## Context Efficiency Techniques
+        
+        **ALWAYS PREFER** direct creation with templates over separate operations:
+        ```
+        // EFFICIENT
+        create_task(title: "X", templateIds: ["Y"])
+        
+        // LESS EFFICIENT  
+        id = create_task(title: "X")
+        apply_template(entityId: id, templateIds: ["Y"])
+        ```
+        
+        **Multiple Templates in One Call**:
+        ```
+        // EFFICIENT
+        apply_template(entityId: id, templateIds: ["A", "B", "C"])
+        
+        // LESS EFFICIENT
+        apply_template(entityId: id, templateIds: ["A"])
+        apply_template(entityId: id, templateIds: ["B"]) 
+        apply_template(entityId: id, templateIds: ["C"])
+        ```
+        
+        **Template Sequence Optimization**:
+        1. Start with Context: Context & Background, Requirements Specification
+        2. Add Technical Detail: Technical Approach for implementation guidance  
+        3. Include Process Guidance: Task Implementation, Bug Investigation workflows
+        4. Add Git Workflow: Local Git Branching, GitHub PR workflows
+        5. Ensure Quality: Testing Strategy, Definition of Done
         
         You can apply one or more templates by providing a templateIds array parameter.
         Use a single-item array for applying just one template.

src/main/kotlin/io/github/jpicklyk/mcptask/interfaces/mcp/McpServerAiGuidance.kt

@@ -28,8 +28,7 @@ object McpServerAiGuidance {
         // Add server overview prompt for users
         addServerOverviewPrompt(this)
 
-        // Add template management guidance
-        TemplateMgtGuidance.configureTemplateManagementGuidance(this)
+        // Template management guidance now integrated into tool descriptions
 
         // Add workflow prompts for common task orchestrator workflows
         WorkflowPromptsGuidance.configureWorkflowPrompts(this)