release: v5.9.8 - Brainstorm workflow improvements and documentation updates

## Changes
- Simplify analysis output strategy to optional modular structure
- Update synthesis/artifacts documentation to use AskUserQuestion tool
- Add modular output strategy for brainstorm analysis
- Simplify clarification deduplication in lite-plan
- Add "Fix, Don't Hide" section to CLAUDE.md guidelines
- Simplify project.json schema by removing unused fields
- Update session ID format in lite-fix/lite-plan workflows
- Add development index to project JSON schema

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
2025-12-03 22:45:04 +08:00
parent 7a61119c55
commit c43a72ef46
18 changed files with 713 additions and 1127 deletions

View File

@@ -9,7 +9,6 @@
"overview",
"features",
"statistics",
"memory_resources",
"_metadata"
],
"properties": {
@@ -28,9 +27,7 @@
"description",
"technology_stack",
"architecture",
"key_components",
"entry_points",
"metrics"
"key_components"
],
"properties": {
"description": {
@@ -125,49 +122,6 @@
}
},
"description": "5-10 core modules/components"
},
"entry_points": {
"type": "object",
"required": ["main", "cli_commands", "api_endpoints"],
"properties": {
"main": {
"type": "string",
"description": "Primary application entry point (index.ts, main.py, etc.)"
},
"cli_commands": {
"type": "array",
"items": {"type": "string"},
"description": "Available CLI commands (npm start, make build, etc.)"
},
"api_endpoints": {
"type": "array",
"items": {"type": "string"},
"description": "HTTP/REST/GraphQL endpoints (if applicable)"
}
}
},
"metrics": {
"type": "object",
"required": ["total_files", "lines_of_code", "module_count", "complexity"],
"properties": {
"total_files": {
"type": "integer",
"description": "Total source code files"
},
"lines_of_code": {
"type": "integer",
"description": "Estimated total lines of code"
},
"module_count": {
"type": "integer",
"description": "Number of top-level modules/packages"
},
"complexity": {
"type": "string",
"enum": ["low", "medium", "high"],
"description": "Overall project complexity rating"
}
}
}
}
},
@@ -199,6 +153,17 @@
},
"description": "Completed workflow features (populated by /workflow:session:complete)"
},
"development_index": {
"type": "object",
"description": "Categorized development history (lite-plan/lite-execute)",
"properties": {
"feature": { "type": "array", "items": { "$ref": "#/$defs/devIndexEntry" } },
"enhancement": { "type": "array", "items": { "$ref": "#/$defs/devIndexEntry" } },
"bugfix": { "type": "array", "items": { "$ref": "#/$defs/devIndexEntry" } },
"refactor": { "type": "array", "items": { "$ref": "#/$defs/devIndexEntry" } },
"docs": { "type": "array", "items": { "$ref": "#/$defs/devIndexEntry" } }
}
},
"statistics": {
"type": "object",
"required": ["total_features", "total_sessions", "last_updated"],
@@ -218,85 +183,6 @@
}
}
},
"memory_resources": {
"type": "object",
"required": ["skills", "documentation", "module_docs", "gaps", "last_scanned"],
"properties": {
"skills": {
"type": "array",
"items": {
"type": "object",
"required": ["name", "type", "path"],
"properties": {
"name": {
"type": "string",
"description": "SKILL package name"
},
"type": {
"type": "string",
"enum": ["workflow_progress", "project_docs", "tech_stacks", "codemap", "style"],
"description": "SKILL package type"
},
"path": {
"type": "string",
"description": "Relative path to SKILL package directory"
}
}
},
"description": "SKILL packages generated by /memory:* commands"
},
"documentation": {
"type": "array",
"items": {
"type": "object",
"required": ["name", "path", "has_readme", "has_architecture"],
"properties": {
"name": {
"type": "string",
"description": "Documentation project name"
},
"path": {
"type": "string",
"description": "Path to documentation directory"
},
"has_readme": {
"type": "boolean",
"description": "README.md exists"
},
"has_architecture": {
"type": "boolean",
"description": "ARCHITECTURE.md exists"
}
}
},
"description": "Documentation generated by /memory:docs"
},
"module_docs": {
"type": "array",
"items": {"type": "string"},
"description": "Paths to CLAUDE.md files generated by /memory:update-*"
},
"gaps": {
"type": "array",
"items": {
"type": "string",
"enum": [
"project_skill",
"documentation",
"tech_stack",
"workflow_history",
"module_docs_low_coverage"
]
},
"description": "Missing memory resources"
},
"last_scanned": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp of last memory scan"
}
}
},
"_metadata": {
"type": "object",
"required": ["initialized_by", "analysis_timestamp", "analysis_mode"],
@@ -317,5 +203,19 @@
}
}
}
},
"$defs": {
"devIndexEntry": {
"type": "object",
"required": ["title", "sub_feature", "date", "description", "status"],
"properties": {
"title": { "type": "string", "maxLength": 60 },
"sub_feature": { "type": "string", "description": "Module/component area" },
"date": { "type": "string", "format": "date" },
"description": { "type": "string", "maxLength": 100 },
"status": { "type": "string", "enum": ["completed", "partial"] },
"session_id": { "type": "string", "description": "lite-plan session ID" }
}
}
}
}