mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-09 02:24:11 +08:00
- Add recommended field to explore-json-schema.json clarification_needs - Update lite-plan/lite-fix/context-gather agent prompts - Display ★ marker and (Recommended) label in AskUserQuestion options 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
125 lines
4.2 KiB
JSON
125 lines
4.2 KiB
JSON
{
|
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
"title": "Exploration Context Schema",
|
|
"description": "Code exploration results from cli-explore-agent for task context gathering",
|
|
"type": "object",
|
|
"required": [
|
|
"project_structure",
|
|
"relevant_files",
|
|
"patterns",
|
|
"dependencies",
|
|
"integration_points",
|
|
"constraints",
|
|
"clarification_needs",
|
|
"_metadata"
|
|
],
|
|
"properties": {
|
|
"project_structure": {
|
|
"type": "string",
|
|
"description": "Overall architecture description: module organization, layer structure, component relationships"
|
|
},
|
|
"relevant_files": {
|
|
"type": "array",
|
|
"items": {
|
|
"oneOf": [
|
|
{"type": "string"},
|
|
{
|
|
"type": "object",
|
|
"required": ["path", "relevance"],
|
|
"properties": {
|
|
"path": {"type": "string", "description": "File path relative to project root"},
|
|
"relevance": {"type": "number", "minimum": 0, "maximum": 1, "description": "Relevance score 0.0-1.0 (0.7+ high, 0.5-0.7 medium, <0.5 low)"},
|
|
"rationale": {"type": "string", "description": "Brief explanation of why this file is relevant from this exploration angle"}
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"description": "File paths to be modified or referenced for the task. Prefer object format with relevance scores for synthesis prioritization."
|
|
},
|
|
"patterns": {
|
|
"type": "string",
|
|
"description": "Existing code patterns, conventions, and styles found in the codebase"
|
|
},
|
|
"dependencies": {
|
|
"type": "string",
|
|
"description": "External and internal module dependencies relevant to the task"
|
|
},
|
|
"integration_points": {
|
|
"type": "string",
|
|
"description": "Where this task connects with existing code: APIs, hooks, events, shared state"
|
|
},
|
|
"constraints": {
|
|
"type": "string",
|
|
"description": "Technical constraints and limitations affecting implementation"
|
|
},
|
|
"clarification_needs": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"required": ["question", "context", "options"],
|
|
"properties": {
|
|
"question": {
|
|
"type": "string",
|
|
"description": "The clarification question to ask user"
|
|
},
|
|
"context": {
|
|
"type": "string",
|
|
"description": "Background context explaining why this clarification is needed"
|
|
},
|
|
"options": {
|
|
"type": "array",
|
|
"items": {"type": "string"},
|
|
"description": "Available options for user to choose from (2-4 options)"
|
|
},
|
|
"recommended": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"description": "Zero-based index of recommended option in the options array. Based on codebase patterns and best practices analysis."
|
|
}
|
|
}
|
|
},
|
|
"description": "Ambiguities requiring user input before planning"
|
|
},
|
|
"_metadata": {
|
|
"type": "object",
|
|
"required": ["timestamp", "task_description", "source"],
|
|
"properties": {
|
|
"timestamp": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "ISO 8601 timestamp of exploration"
|
|
},
|
|
"task_description": {
|
|
"type": "string",
|
|
"description": "Original task description that triggered exploration"
|
|
},
|
|
"source": {
|
|
"type": "string",
|
|
"const": "cli-explore-agent",
|
|
"description": "Agent that performed exploration"
|
|
},
|
|
"exploration_angle": {
|
|
"type": "string",
|
|
"description": "Agent-chosen exploration angle (e.g., 'architecture', 'security', 'dataflow')"
|
|
},
|
|
"exploration_index": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"maximum": 4,
|
|
"description": "Exploration index (1-4) in parallel exploration set"
|
|
},
|
|
"total_explorations": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"maximum": 4,
|
|
"description": "Total number of parallel explorations"
|
|
},
|
|
"duration_seconds": {
|
|
"type": "integer",
|
|
"description": "Exploration duration in seconds"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|