atlas-mcp-server
by cyanheads
Verified
create_task
Create a new task in the hierarchical task system.
Core Task Properties:
- Path: Hierarchical identifier (e.g., "project/backend/auth")
- Max length: 1000 chars
- Max depth: 10 levels
- Allowed chars: alphanumeric, hyphen, underscore, forward slash
- Forward slashes indicate hierarchy levels
- Name: Clear, action-oriented task title
- Max length: 200 chars
- Should describe concrete objective
- Description: Detailed task explanation
- Max length: 2000 chars
- Include context, requirements, success criteria
- Type: TASK or MILESTONE
- TASK: Concrete work item with specific deliverable
- MILESTONE: Organizational container for related tasks
Validation & Dependencies:
- Dependencies: Tasks that must complete first
- Max dependencies: 50 tasks
- Tasks blocked until dependencies met
- Circular dependencies prevented
- Parent-Child Rules:
- Parent task must exist if parentPath specified
- Child tasks inherit certain parent properties
- Parent status affects child task constraints
- Proper task hierarchy maintained
Notes & Documentation: Each category limited to 100 notes, 1000 chars per note
- Planning Notes: Initial task preparation
- Progress Notes: Implementation updates
- Completion Notes: Final outcomes
- Troubleshooting Notes: Issue resolution
Metadata Categories:
- Core Fields:
- Priority: low/medium/high
- Tags: Keywords for categorization (max 100)
- Reasoning: Decision rationale (max 2000 chars)
- Technical Details:
- Language & Framework
- Dependencies (max 50)
- Environment specifications
- Validation & Progress:
- Acceptance criteria (max 20)
- Test cases (max 20)
- Progress percentage (0-100)
- Milestone tracking
- Timestamps
- Resource Tracking:
- Tools used (max 100)
- Resources accessed (max 100)
- Context references (max 100)
- Status Information:
- Block tracking
- Resolution details
- Timestamps
- Version Control:
- Version numbers
- Branch information
- Commit references
- Version history (max 10)
Input Schema
Name | Required | Description | Default |
---|---|---|---|
completionNotes | No | Task completion notes. Max 100 notes, each max 1000 chars. | |
dependencies | No | Paths of tasks that must be completed first. Tasks will be blocked until dependencies are met. | |
description | No | Detailed explanation including context, requirements, and success criteria. Max length 2000 chars. | |
metadata | No | Task metadata with structured validation: 1. Core Fields: - priority: Task urgency (low/medium/high) - tags: Keywords for categorization (max 100 tags, each max 100 chars) - reasoning: Document decision rationale (max 2000 chars) 2. Technical Details: technicalRequirements: { - language: Programming language used - framework: Framework/libraries used - dependencies: Array of required dependencies (max 50) - environment: Runtime environment details - performance: Resource requirements } 3. Validation & Progress: acceptanceCriteria: { - criteria: Success validation points (max 20, each max 500 chars) - testCases: Test scenarios (max 20, each max 500 chars) - reviewers: Required reviewers list (max 10) } progress: { - percentage: Task completion (0-100) - milestones: Key progress points (max 20) - lastUpdated: Last status update timestamp - estimatedCompletion: Target completion timestamp } 4. Resource Tracking: resources: { - toolsUsed: Tools/utilities used (max 100) - resourcesAccessed: Data/systems accessed (max 100) - contextUsed: Related information (max 100, each max 1000 chars) } 5. Status Information: blockInfo: { - blockedBy: Task causing the block - blockReason: Block description (max 500 chars) - blockTimestamp: When block occurred - unblockTimestamp: When block was resolved - resolution: How block was resolved (max 500 chars) } 6. Version Control: versionControl: { - version: Current version number - branch: Active branch name - commit: Latest commit hash - previousVersions: Version history (max 10) } 7. Custom Fields: customFields: Record of additional string fields for extensibility | |
name | Yes | Clear, action-oriented name describing the task objective. Max length 200 chars. | |
parentPath | No | Path of parent task. Use for organizing subtasks under a milestone. | |
path | Yes | Hierarchical path (e.g., "project/backend/auth"). Max length 1000 chars, max depth 10 levels. Must be alphanumeric with -_/ characters. Use forward slashes to indicate task hierarchy. | |
planningNotes | No | Initial planning notes for the task. Max 100 notes, each max 1000 chars. | |
progressNotes | No | Progress tracking notes. Max 100 notes, each max 1000 chars. | |
troubleshootingNotes | No | Notes about issues and their resolution. Max 100 notes, each max 1000 chars. | |
type | No | TASK for concrete work items, MILESTONE for organizing related tasks. | TASK |
Input Schema (JSON Schema)
{
"properties": {
"completionNotes": {
"description": "Task completion notes. Max 100 notes, each max 1000 chars.",
"items": {
"type": "string"
},
"type": "array"
},
"dependencies": {
"description": "Paths of tasks that must be completed first. Tasks will be blocked until dependencies are met.",
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"description": "Detailed explanation including context, requirements, and success criteria. Max length 2000 chars.",
"type": "string"
},
"metadata": {
"description": "Task metadata with structured validation:\n\n1. Core Fields:\n - priority: Task urgency (low/medium/high)\n - tags: Keywords for categorization (max 100 tags, each max 100 chars)\n - reasoning: Document decision rationale (max 2000 chars)\n\n2. Technical Details:\n technicalRequirements: {\n - language: Programming language used\n - framework: Framework/libraries used\n - dependencies: Array of required dependencies (max 50)\n - environment: Runtime environment details\n - performance: Resource requirements\n }\n\n3. Validation & Progress:\n acceptanceCriteria: {\n - criteria: Success validation points (max 20, each max 500 chars)\n - testCases: Test scenarios (max 20, each max 500 chars)\n - reviewers: Required reviewers list (max 10)\n }\n progress: {\n - percentage: Task completion (0-100)\n - milestones: Key progress points (max 20)\n - lastUpdated: Last status update timestamp\n - estimatedCompletion: Target completion timestamp\n }\n\n4. Resource Tracking:\n resources: {\n - toolsUsed: Tools/utilities used (max 100)\n - resourcesAccessed: Data/systems accessed (max 100)\n - contextUsed: Related information (max 100, each max 1000 chars)\n }\n\n5. Status Information:\n blockInfo: {\n - blockedBy: Task causing the block\n - blockReason: Block description (max 500 chars)\n - blockTimestamp: When block occurred\n - unblockTimestamp: When block was resolved\n - resolution: How block was resolved (max 500 chars)\n }\n\n6. Version Control:\n versionControl: {\n - version: Current version number\n - branch: Active branch name\n - commit: Latest commit hash\n - previousVersions: Version history (max 10)\n }\n\n7. Custom Fields:\n customFields: Record of additional string fields for extensibility",
"properties": {
"acceptanceCriteria": {
"properties": {
"criteria": {
"items": {
"maxLength": 500,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"reviewers": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"testCases": {
"items": {
"maxLength": 500,
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"type": "object"
},
"blockInfo": {
"properties": {
"blockReason": {
"maxLength": 500,
"type": "string"
},
"blockTimestamp": {
"type": "number"
},
"blockedBy": {
"type": "string"
},
"resolution": {
"maxLength": 500,
"type": "string"
},
"unblockTimestamp": {
"type": "number"
}
},
"type": "object"
},
"customFields": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"priority": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"progress": {
"properties": {
"estimatedCompletion": {
"type": "number"
},
"lastUpdated": {
"type": "number"
},
"milestones": {
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"percentage": {
"maximum": 100,
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"reasoning": {
"maxLength": 2000,
"type": "string"
},
"resources": {
"properties": {
"contextUsed": {
"items": {
"maxLength": 1000,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"resourcesAccessed": {
"items": {
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"toolsUsed": {
"items": {
"type": "string"
},
"maxItems": 100,
"type": "array"
}
},
"type": "object"
},
"tags": {
"items": {
"maxLength": 100,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"technicalRequirements": {
"properties": {
"dependencies": {
"items": {
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"environment": {
"type": "string"
},
"framework": {
"type": "string"
},
"language": {
"type": "string"
},
"performance": {
"properties": {
"cpu": {
"type": "string"
},
"memory": {
"type": "string"
},
"storage": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"versionControl": {
"properties": {
"branch": {
"type": "string"
},
"commit": {
"type": "string"
},
"previousVersions": {
"items": {
"type": "number"
},
"maxItems": 10,
"type": "array"
},
"version": {
"type": "number"
}
},
"type": "object"
}
},
"type": "object"
},
"name": {
"description": "Clear, action-oriented name describing the task objective. Max length 200 chars.",
"type": "string"
},
"parentPath": {
"description": "Path of parent task. Use for organizing subtasks under a milestone.",
"type": "string"
},
"path": {
"description": "Hierarchical path (e.g., \"project/backend/auth\"). Max length 1000 chars, max depth 10 levels. Must be alphanumeric with -_/ characters. Use forward slashes to indicate task hierarchy.",
"type": "string"
},
"planningNotes": {
"description": "Initial planning notes for the task. Max 100 notes, each max 1000 chars.",
"items": {
"type": "string"
},
"type": "array"
},
"progressNotes": {
"description": "Progress tracking notes. Max 100 notes, each max 1000 chars.",
"items": {
"type": "string"
},
"type": "array"
},
"troubleshootingNotes": {
"description": "Notes about issues and their resolution. Max 100 notes, each max 1000 chars.",
"items": {
"type": "string"
},
"type": "array"
},
"type": {
"default": "TASK",
"description": "TASK for concrete work items, MILESTONE for organizing related tasks.",
"enum": [
"TASK",
"MILESTONE"
],
"type": "string"
}
},
"required": [
"path",
"name"
],
"type": "object"
}