grace-plan

Generate validated development-plan.xml and knowledge-graph.xml from requirements and technology decisions.

233|51|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/osovv/grace-marketplace --skill grace-plan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grace-plan
Source: https://github.com/osovv/grace-marketplace/tree/main/skills/grace/grace-plan
Command: npx skills add https://github.com/osovv/grace-marketplace --skill grace-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about grace-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate module architecture and a knowledge graph from project requirements?▼

Module architecture and a knowledge graph are generated by validating requirements and technology decisions, then producing module breakdowns, contracts, and data flows. You need docs/requirements.xml and docs/technology.xml to create development-plan.xml and knowledge-graph.xml.

How does contract-first module design work for a development plan?▼

Contract-first design produces MODULE_CONTRACT entries defining purpose, scope, dependencies, and links, classifying modules by type (ENTRY_POINT, CORE_LOGIC, DATA_LAYER, UI_COMPONENT, UTILITY, INTEGRATION). A structured breakdown is presented for user approval before generating plan artifacts.

What do I need to create a development plan from use cases and stack decisions?▼

You need docs/requirements.xml defining use cases and docs/technology.xml defining stack decisions. If these prerequisite files are missing, the process prompts you to run initialization before proceeding with architectural plan generation.

Can I plan a module refactor without generating code prematurely?▼

Yes, you can plan module refactors by transforming written requirements into validated, contract-first module architecture and a navigable knowledge graph. This moves teams from ambiguity to approved implementation plans without generating code prematurely.

What is included in a knowledge graph generated from architectural requirements?▼

A generated knowledge graph includes unique M-xxx nodes, function and type annotations, and CrossLinks. It is emitted as docs/knowledge-graph.xml alongside docs/development-plan.xml after the proposed architecture passes user approval.

Does architectural plan generation include risk assessments and implementation phases?▼

Yes, architectural plan generation includes risk assessments and implementation phases within the output development-plan.xml. The process enforces collaborative approval of the module breakdown and mental test walkthroughs before creating these artifacts.