manage_todo_json
Manage and analyze tasks in JSON format with automated scoring, knowledge graph integration, and LLM interactions to streamline project workflows effectively.
Instructions
JSON-first TODO management with consistent LLM interactions, automatic scoring sync, and knowledge graph integration
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adrDirectory | No | ADR directory path for imports | docs/adrs |
| assignee | No | Task assignee | |
| autoComplete | No | Auto-complete when criteria are met | |
| autoLinkDependencies | No | Auto-detect task dependencies | |
| backupExisting | No | Create backup before destructive operations | |
| category | No | Task category | |
| completionCriteria | No | Auto-completion rules | |
| dependencies | No | Task dependencies (task IDs) | |
| description | No | Task description | |
| direction | No | Knowledge graph sync direction | bidirectional |
| dueDate | No | Due date (ISO string format) | |
| filters | No | Filter criteria for get_tasks operation | |
| force | No | Force operation even if conflicts exist | |
| includeScoring | No | Include scoring metrics in analytics | |
| includeVelocity | No | Include velocity metrics in analytics | |
| intentId | No | Link to knowledge graph intent | |
| limit | No | Maximum number of tasks to return | |
| linkedAdrs | No | Related ADR files | |
| mergeStrategy | No | Merge strategy for imports | merge |
| operation | Yes | Operation to perform on TODO JSON backend | |
| preserveExisting | No | Keep existing tasks during imports | |
| priority | No | Task priority level | medium |
| projectPath | No | Project root path (uses configured PROJECT_PATH if not provided) | |
| reason | No | Reason for update (for changelog) | |
| sortBy | No | Sort field for get_tasks operation | priority |
| sortOrder | No | Sort order for get_tasks operation | desc |
| tags | No | Task tags | |
| taskId | No | Task ID for update operations | |
| timeframe | No | Analysis timeframe for analytics | week |
| title | No | Task title for create operations | |
| updates | No | Fields to update for update operations |
Input Schema (JSON Schema)
{
"properties": {
"adrDirectory": {
"default": "docs/adrs",
"description": "ADR directory path for imports",
"type": "string"
},
"assignee": {
"description": "Task assignee",
"type": "string"
},
"autoComplete": {
"default": false,
"description": "Auto-complete when criteria are met",
"type": "boolean"
},
"autoLinkDependencies": {
"default": true,
"description": "Auto-detect task dependencies",
"type": "boolean"
},
"backupExisting": {
"default": true,
"description": "Create backup before destructive operations",
"type": "boolean"
},
"category": {
"description": "Task category",
"type": "string"
},
"completionCriteria": {
"description": "Auto-completion rules",
"type": "string"
},
"dependencies": {
"description": "Task dependencies (task IDs)",
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"description": "Task description",
"type": "string"
},
"direction": {
"default": "bidirectional",
"description": "Knowledge graph sync direction",
"enum": [
"to_kg",
"from_kg",
"bidirectional"
],
"type": "string"
},
"dueDate": {
"description": "Due date (ISO string format)",
"type": "string"
},
"filters": {
"description": "Filter criteria for get_tasks operation",
"properties": {
"assignee": {
"type": "string"
},
"category": {
"type": "string"
},
"hasDeadline": {
"type": "boolean"
},
"overdue": {
"type": "boolean"
},
"priority": {
"enum": [
"low",
"medium",
"high",
"critical"
],
"type": "string"
},
"status": {
"enum": [
"pending",
"in_progress",
"completed",
"blocked",
"cancelled"
],
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"force": {
"default": false,
"description": "Force operation even if conflicts exist",
"type": "boolean"
},
"includeScoring": {
"default": true,
"description": "Include scoring metrics in analytics",
"type": "boolean"
},
"includeVelocity": {
"default": true,
"description": "Include velocity metrics in analytics",
"type": "boolean"
},
"intentId": {
"description": "Link to knowledge graph intent",
"type": "string"
},
"limit": {
"description": "Maximum number of tasks to return",
"type": "number"
},
"linkedAdrs": {
"description": "Related ADR files",
"items": {
"type": "string"
},
"type": "array"
},
"mergeStrategy": {
"default": "merge",
"description": "Merge strategy for imports",
"enum": [
"overwrite",
"merge",
"preserve_json"
],
"type": "string"
},
"operation": {
"description": "Operation to perform on TODO JSON backend",
"enum": [
"create_task",
"update_task",
"bulk_update",
"get_tasks",
"get_analytics",
"import_adr_tasks",
"sync_knowledge_graph",
"sync_to_markdown",
"import_from_markdown"
],
"type": "string"
},
"preserveExisting": {
"default": true,
"description": "Keep existing tasks during imports",
"type": "boolean"
},
"priority": {
"default": "medium",
"description": "Task priority level",
"enum": [
"low",
"medium",
"high",
"critical"
],
"type": "string"
},
"projectPath": {
"description": "Project root path (uses configured PROJECT_PATH if not provided)",
"type": "string"
},
"reason": {
"description": "Reason for update (for changelog)",
"type": "string"
},
"sortBy": {
"default": "priority",
"description": "Sort field for get_tasks operation",
"enum": [
"priority",
"dueDate",
"createdAt",
"updatedAt"
],
"type": "string"
},
"sortOrder": {
"default": "desc",
"description": "Sort order for get_tasks operation",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"tags": {
"description": "Task tags",
"items": {
"type": "string"
},
"type": "array"
},
"taskId": {
"description": "Task ID for update operations",
"type": "string"
},
"timeframe": {
"default": "week",
"description": "Analysis timeframe for analytics",
"enum": [
"day",
"week",
"month",
"all"
],
"type": "string"
},
"title": {
"description": "Task title for create operations",
"type": "string"
},
"updates": {
"description": "Fields to update for update operations",
"properties": {
"assignee": {
"type": "string"
},
"description": {
"type": "string"
},
"dueDate": {
"type": "string"
},
"notes": {
"type": "string"
},
"priority": {
"enum": [
"low",
"medium",
"high",
"critical"
],
"type": "string"
},
"progressPercentage": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"status": {
"enum": [
"pending",
"in_progress",
"completed",
"blocked",
"cancelled"
],
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
}
},
"type": "object"
}
},
"required": [
"operation"
],
"type": "object"
}