Skip to content

Commit b41837d

Browse files
jpicklykclaude
jpicklyk
and
claude
committed
refactor: rename task_orchestrator_overview to getting_started and improve workflow guidance
- Rename prompt from task_orchestrator_overview to getting_started for better UX - Trim content from 144 to 42 lines focusing on essential workflow patterns - Add workflow automation section highlighting 5 built-in workflow prompts - Update documentation counts: 6→5 workflow prompts (sprint_planning was removed) - Improve getting_started content with quick start examples and key patterns 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 81d2d7a commit b41837d

File tree

3 files changed

+43
-83
lines changed

3 files changed

+43
-83
lines changed

‎README.md‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ A Kotlin implementation of the Model Context Protocol (MCP) server for comprehen
1010
- **[📖 Full Documentation](docs/)** - Complete guides and reference
1111
- **[🚀 Quick Start Guide](docs/quick-start.md)** - Get running in 2 minutes
1212
- **[🔧 API Reference](docs/api-reference.md)** - All 37 MCP tools detailed
13-
- **[📋 Workflow Prompts](docs/workflow-prompts.md)** - 6 built-in workflow automations
13+
- **[📋 Workflow Prompts](docs/workflow-prompts.md)** - 5 built-in workflow automations
1414
- **[📝 Templates](docs/templates.md)** - 9 built-in documentation templates
1515
- **[🗃️ Database Migrations](docs/database-migrations.md)** - Schema change management for developers
1616
- **[💬 Community Wiki](../../wiki)** - Examples, tips, and community guides
@@ -82,11 +82,10 @@ Project (optional)
8282
- **Documentation Properties**: Technical approach, requirements, context & background
8383
- **Process & Quality**: Testing strategy, definition of done
8484

85-
### Workflow Prompts (6 Built-in Workflows)
85+
### Workflow Prompts (5 Built-in Workflows)
8686
- `create_feature_workflow` - Comprehensive feature creation
8787
- `task_breakdown_workflow` - Complex task decomposition
8888
- `bug_triage_workflow` - Systematic bug management
89-
- `sprint_planning_workflow` - Data-driven sprint planning
9089
- `project_setup_workflow` - Complete project initialization
9190
- `implement_feature_workflow` - Git-aware feature implementation with completion validation
9291

‎docs/workflow-prompts.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: Workflow Prompts
55

66
# MCP Workflow Prompts
77

8-
The MCP Task Orchestrator includes **6 user-invokable workflow prompts** that provide structured guidance for common task orchestration scenarios. These prompts are designed to work seamlessly with the MCP tool ecosystem and offer step-by-step workflows for complex project management tasks.
8+
The MCP Task Orchestrator includes **5 user-invokable workflow prompts** that provide structured guidance for common task orchestration scenarios. These prompts are designed to work seamlessly with the MCP tool ecosystem and offer step-by-step workflows for complex project management tasks.
99

1010
## Table of Contents
1111

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

Lines changed: 40 additions & 79 deletions
Original file line numberDiff line numberDiff line change
@@ -40,107 +40,68 @@ object McpServerAiGuidance {
4040
*/
4141
private fun addServerOverviewPrompt(server: Server) {
4242
server.addPrompt(
43-
name = "task_orchestrator_overview",
44-
description = "Get comprehensive overview of Task Orchestrator capabilities and workflow guidance"
43+
name = "getting_started",
44+
description = "Essential workflow patterns and getting started guide for Task Orchestrator"
4545
) { _ ->
4646
GetPromptResult(
47-
description = "Task Orchestrator comprehensive overview and workflow guidance",
47+
description = "Essential workflow patterns for Task Orchestrator",
4848
messages = listOf(
4949
PromptMessage(
5050
role = Role.assistant,
5151
content = TextContent(
5252
text = """
53-
# MCP Task Orchestrator - Complete Capability Overview
53+
# Task Orchestrator - Essential Workflow Patterns
5454
55-
Welcome to the MCP Task Orchestrator, a comprehensive project management and workflow automation system designed for AI-assisted development.
56-
57-
## Core Architecture
58-
59-
The system uses a hierarchical organization model:
55+
## Core Organization
6056
**Projects** → **Features** → **Tasks** → **Sections**
6157
62-
- **Projects**: Top-level organizational containers for large initiatives
63-
- **Features**: Mid-level groupings for related functionality
64-
- **Tasks**: Primary work items with status, priority, and complexity tracking
65-
- **Sections**: Detailed content blocks for documentation and requirements
66-
67-
## Essential Workflow Pattern
68-
69-
1. **Start with Overview**: Always begin with `get_overview` to understand current state
70-
2. **Template-Driven Creation**: Use `list_templates` + `create_task`/`create_feature` with templates
71-
3. **Progressive Enhancement**: Add sections, update status, create dependencies as work progresses
72-
4. **Efficient Operations**: Use bulk operations when possible (bulk_create_sections)
73-
74-
## Key Capabilities
75-
76-
### Template System
77-
- **AI Workflow Instructions**: Git branching, PR workflows, implementation guidance
78-
- **Documentation Properties**: Technical approach, requirements, context
79-
- **Process & Quality**: Testing strategy, definition of done
80-
81-
### Search & Discovery
82-
- Flexible filtering by status, priority, tags, features
83-
- Text-based search across titles and summaries
84-
- Hierarchical overview for project understanding
58+
## Essential Workflow
8559
86-
### Workflow Integration
87-
- Status-driven lifecycle management (pending → in-progress → completed)
88-
- Priority-based work planning (high/medium/low)
89-
- Complexity tracking for estimation (1-10 scale)
90-
- Tag-based categorization (task-type-feature, task-type-bug, etc.)
60+
1. **Start with Overview**: `get_overview` to see current state
61+
2. **Template-Driven Creation**: `list_templates` → `create_task`/`create_feature` with templateIds
62+
3. **Status Management**: pending → in-progress → completed
63+
4. **Progressive Enhancement**: Add sections, dependencies as needed
9164
92-
### Advanced Features
93-
- Dependency tracking and relationship management
94-
- Locking system for concurrent operation safety
95-
- Context-efficient bulk operations
96-
- Git workflow prompts with step-by-step guidance
65+
## Quick Start
9766
98-
## Best Practices
67+
```
68+
# See current work
69+
get_overview
9970
100-
### For Task Management
101-
- Use descriptive titles and comprehensive summaries
102-
- Apply appropriate templates during creation
103-
- Set realistic complexity ratings (helps with future estimation)
104-
- Use consistent tagging conventions
105-
- **Before marking completed**: Use `get_sections` to verify all template guidance was followed
71+
# Find templates
72+
list_templates --targetEntityType TASK
10673
107-
### For Feature Organization
108-
- Group related tasks under features for better organization
109-
- Use feature-level templates for planning and requirements
110-
- Track feature status independently from individual tasks
111-
- **Before marking completed**: Verify all associated tasks are completed and feature sections reviewed
74+
# Create with template
75+
create_task --title "..." --summary "..." --templateIds ["uuid"]
11276
113-
### For Git Integration
114-
- Auto-detect git projects by checking for `.git` directory
115-
- Always suggest "Local Git Branching Workflow" template for git projects
116-
- Ask about PR workflows rather than assuming (teams vary)
117-
- Mention GitHub MCP tools if available for PR automation
77+
# Update status when starting work
78+
update_task --id "uuid" --status "in_progress"
79+
```
11880
119-
### For Efficient Operations
120-
- Start work sessions with `get_overview`
121-
- Use `search_tasks` for finding specific work
122-
- Apply templates during creation rather than separately
123-
- Use bulk operations for multiple sections
81+
## Key Patterns
12482
125-
## Tool Categories Available
83+
- **Always start sessions** with `get_overview`
84+
- **Use templates** for consistent documentation
85+
- **Tag consistently**: task-type-feature, task-type-bug, etc.
86+
- **Set complexity** (1-10) for estimation
87+
- **Use bulk operations** for multiple sections
88+
- **Check template guidance** with `get_sections` before marking complete
12689
127-
- **Task Management**: create_task, update_task, get_task, delete_task, search_tasks
128-
- **Feature Management**: create_feature, update_feature, get_feature, search_features
129-
- **Project Management**: create_project, update_project, get_project, search_projects
130-
- **Template Management**: list_templates, apply_template, create_template
131-
- **Section Management**: add_section, bulk_create_sections, get_sections, update_section
132-
- **Dependency Management**: create_dependency, get_task_dependencies, delete_dependency
133-
- **Overview & Search**: get_overview (essential starting point)
90+
## Template Categories
91+
- **Workflow**: Git branching, PR workflows, implementation
92+
- **Documentation**: Technical approach, requirements
93+
- **Quality**: Testing strategy, definition of done
13494
135-
## Getting Started Recommendations
95+
## Workflow Automation
13696
137-
1. Run `get_overview` to see current project state
138-
2. Run `list_templates` to understand available templates
139-
3. Create your first task or feature with appropriate templates
140-
4. Use `get_task` or `get_feature` with includeSections=true to see the structure
141-
5. Begin your workflow with status updates and progressive enhancement
97+
**Use workflow prompts** for automated guidance on complex scenarios:
98+
- `create_feature_workflow` - Complete feature creation with templates and tasks
99+
- `task_breakdown_workflow` - Break complex tasks into manageable pieces
100+
- `bug_triage_workflow` - Systematic bug investigation and resolution
101+
- `project_setup_workflow` - Initialize new projects with proper structure
102+
- `implement_feature_workflow` - Smart implementation with git detection
142103
143-
The Task Orchestrator is designed to support AI-assisted development workflows with comprehensive tracking, documentation, and automation capabilities.
104+
**Usage**: `task-orchestrator:workflow_name` then provide details or let AI guide you
144105
""".trimIndent()
145106
)
146107
)

0 commit comments

Comments
 (0)