generate_adr_todo
Create and sync TDD-focused TODO.md tasks from existing ADRs using a JSON-first approach, linking dependencies and validating architectural rules for structured task management.
Instructions
Generate TDD-focused todo.md from existing ADRs with JSON-first approach: creates structured JSON TODO and syncs to markdown
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adrDirectory | No | Directory containing ADR files (optional, uses configured ADR_DIRECTORY if not provided) | |
| conversationContext | No | Rich context from the calling LLM about user goals and discussion history | |
| createJsonBackup | No | Create backup of existing JSON TODO data before import | |
| forceSyncToMarkdown | No | Force sync JSON to markdown even if markdown is newer | |
| includeRules | No | Include architectural rules validation in TDD tasks | |
| intentId | No | Link generated tasks to specific knowledge graph intent | |
| linkAdrs | No | Auto-detect and link ADR dependencies in task creation | |
| phase | No | TDD phase: both (default), test (mock test generation), production (implementation after tests) | both |
| preserveExisting | No | Preserve existing TODO.md content by merging instead of overwriting | |
| ruleSource | No | Source for architectural rules (only used if includeRules is true) | both |
| scope | No | Scope of tasks to include | all |
| todoPath | No | Path to TODO.md file (relative to project root) | TODO.md |
Input Schema (JSON Schema)
{
"properties": {
"adrDirectory": {
"description": "Directory containing ADR files (optional, uses configured ADR_DIRECTORY if not provided)",
"type": "string"
},
"conversationContext": {
"additionalProperties": false,
"description": "Rich context from the calling LLM about user goals and discussion history",
"properties": {
"budget": {
"description": "Budget or resource constraints (e.g., \"limited budget\", \"enterprise scale\")",
"type": "string"
},
"constraints": {
"description": "Limitations, compliance requirements, or restrictions (e.g., [\"GDPR compliance\", \"budget under $50k\", \"minimal downtime\"])",
"items": {
"type": "string"
},
"type": "array"
},
"focusAreas": {
"description": "Specific areas of concern or interest (e.g., [\"security\", \"performance\", \"maintainability\"])",
"items": {
"type": "string"
},
"type": "array"
},
"humanRequest": {
"description": "Original human request text for context restoration and knowledge graph storage",
"type": "string"
},
"previousContext": {
"description": "Relevant context from previous conversation (e.g., \"User mentioned concerns about database splitting\")",
"type": "string"
},
"projectPhase": {
"description": "Current project phase (e.g., \"planning\", \"development\", \"migration\", \"production\")",
"type": "string"
},
"requirements": {
"description": "Specific requirements or preferences mentioned",
"items": {
"type": "string"
},
"type": "array"
},
"timeline": {
"description": "Timeline or urgency information (e.g., \"launch in 3 months\", \"urgent migration\")",
"type": "string"
},
"userGoals": {
"description": "Primary objectives the user wants to achieve (e.g., [\"microservices migration\", \"improve security\"])",
"items": {
"type": "string"
},
"type": "array"
},
"userRole": {
"description": "User's role or expertise level (e.g., \"senior architect\", \"developer\", \"project manager\")",
"type": "string"
}
},
"type": "object"
},
"createJsonBackup": {
"default": true,
"description": "Create backup of existing JSON TODO data before import",
"type": "boolean"
},
"forceSyncToMarkdown": {
"default": false,
"description": "Force sync JSON to markdown even if markdown is newer",
"type": "boolean"
},
"includeRules": {
"default": true,
"description": "Include architectural rules validation in TDD tasks",
"type": "boolean"
},
"intentId": {
"description": "Link generated tasks to specific knowledge graph intent",
"type": "string"
},
"linkAdrs": {
"default": true,
"description": "Auto-detect and link ADR dependencies in task creation",
"type": "boolean"
},
"phase": {
"default": "both",
"description": "TDD phase: both (default), test (mock test generation), production (implementation after tests)",
"enum": [
"both",
"test",
"production"
],
"type": "string"
},
"preserveExisting": {
"default": true,
"description": "Preserve existing TODO.md content by merging instead of overwriting",
"type": "boolean"
},
"ruleSource": {
"default": "both",
"description": "Source for architectural rules (only used if includeRules is true)",
"enum": [
"adrs",
"patterns",
"both"
],
"type": "string"
},
"scope": {
"default": "all",
"description": "Scope of tasks to include",
"enum": [
"all",
"pending",
"in_progress"
],
"type": "string"
},
"todoPath": {
"default": "TODO.md",
"description": "Path to TODO.md file (relative to project root)",
"type": "string"
}
},
"type": "object"
}