troubleshoot_guided_workflow
Analyze system failures, identify root causes, and generate specific test commands using structured input data to streamline troubleshooting and improve system reliability.
Instructions
Structured failure analysis and test plan generation - provide JSON failure info to get specific test commands
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adrDirectory | No | ADR directory path | docs/adrs |
| conversationContext | No | Rich context from the calling LLM about user goals and discussion history | |
| failure | No | Structured failure information (required for analyze_failure and generate_test_plan) | |
| operation | Yes | Type of troubleshooting operation | |
| projectPath | No | Path to project directory (optional) | |
| todoPath | No | Path to TODO.md file | TODO.md |
Input Schema (JSON Schema)
{
"properties": {
"adrDirectory": {
"default": "docs/adrs",
"description": "ADR directory path",
"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"
},
"failure": {
"description": "Structured failure information (required for analyze_failure and generate_test_plan)",
"properties": {
"context": {
"description": "Additional context about the failure (optional)",
"properties": {
"frequency": {
"description": "How often this failure occurs (optional)",
"type": "string"
},
"impact": {
"description": "Impact level of the failure (optional)",
"enum": [
"low",
"medium",
"high",
"critical"
],
"type": "string"
},
"recentChanges": {
"description": "Recent changes that might be related (optional)",
"type": "string"
},
"reproducible": {
"description": "Whether the failure is reproducible (optional)",
"type": "boolean"
}
},
"type": "object"
},
"failureDetails": {
"description": "Detailed failure information",
"properties": {
"affectedFiles": {
"description": "Files involved in the failure (optional)",
"items": {
"type": "string"
},
"type": "array"
},
"command": {
"description": "Command that failed (optional)",
"type": "string"
},
"environment": {
"description": "Environment where failure occurred (optional)",
"type": "string"
},
"errorMessage": {
"description": "Primary error message",
"type": "string"
},
"exitCode": {
"description": "Exit code of failed process (optional)",
"type": "number"
},
"logOutput": {
"description": "Relevant log output (optional)",
"type": "string"
},
"stackTrace": {
"description": "Stack trace if available (optional)",
"type": "string"
},
"timestamp": {
"description": "When the failure occurred (optional)",
"type": "string"
}
},
"required": [
"errorMessage"
],
"type": "object"
},
"failureType": {
"description": "Type of failure",
"enum": [
"test_failure",
"deployment_failure",
"build_failure",
"runtime_error",
"performance_issue",
"security_issue",
"other"
],
"type": "string"
}
},
"required": [
"failureType",
"failureDetails"
],
"type": "object"
},
"operation": {
"description": "Type of troubleshooting operation",
"enum": [
"analyze_failure",
"generate_test_plan",
"full_workflow"
],
"type": "string"
},
"projectPath": {
"description": "Path to project directory (optional)",
"type": "string"
},
"todoPath": {
"default": "TODO.md",
"description": "Path to TODO.md file",
"type": "string"
}
},
"required": [
"operation"
],
"type": "object"
}