grace-plan

What problem does it solve?

Transforms written requirements and technology decisions into a validated, contract-first module architecture and a navigable knowledge graph so teams can move from ambiguity to approved implementation plans without generating code prematurely.

Core Features & Use Cases

• Prerequisite validation: Checks for docs/requirements.xml and docs/technology.xml and prompts to run initialization if they are missing.
• Contract-first module design: Produces MODULE_CONTRACT entries (purpose, scope, dependencies, links) and classifies modules by type (ENTRY_POINT, CORE_LOGIC, DATA_LAYER, UI_COMPONENT, UTILITY, INTEGRATION).
• Knowledge graph generation: Emits docs/knowledge-graph.xml with unique M-xxx nodes, function/type annotations, and CrossLinks.
• Collaborative approval workflow: Presents a structured module breakdown and mental test walkthroughs, waits for user approval, then creates docs/development-plan.xml and knowledge-graph.xml.
• Use cases: New feature scoping, module refactors, platform integration planning, and design audits before code generation.

Quick Start

Run the grace-plan skill against your project that contains docs/requirements.xml and docs/technology.xml to produce a development-plan.xml and knowledge-graph.xml after approving the proposed architecture.