grace-generate

Generate GRACE-marked module code with contract fidelity and graph synchronization.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill automates generation of implementation code for a GRACE module from its contract and knowledge-graph entry, ensuring semantic markup, contract fidelity, and consistent graph synchronization so agents can produce verifiable, controller-friendly code.

Core Features & Use Cases

  • Structured GRACE Markup: Emits module-level headers, START_MODULE_CONTRACT, START_MODULE_MAP, change summaries, and per-block START_BLOCK/END_BLOCK markers adapted to the target language comment syntax.
  • Graph Synchronization Modes: In standalone mode it can update docs/knowledge-graph.xml directly; in controller-driven multi-agent mode it produces a graph delta proposal with module ID, imports, exports, and crosslink suggestions.
  • Verification & Reporting: Performs module-local verification (type checks, lint, and local tests), and returns a concise implementation packet listing files changed, verification results, sync output, and open assumptions.
  • Use Case: After a module is planned in development-plan.xml, run this skill to produce the implementation code, per-block semantic markup, and either update the knowledge graph or return a delta for controller review.

Quick Start

Generate the implementation for the module 'payment' using its contract in docs/development-plan.xml and return files changed, verification results, and a graph delta proposal.

Frequently Asked Questions about grace-generate

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

FAQPage Schema
How do I generate module code with semantic markup from a development plan?

To generate module code with semantic markup, use a tool that parses your development-plan.xml and knowledge-graph.xml to produce source files with START_MODULE_CONTRACT and START_BLOCK markers. This ensures contract fidelity and consistent graph synchronization.

What is a graph delta proposal in multi-agent code generation?

A graph delta proposal in multi-agent code generation is a structured output containing module ID, imports, exports, and crosslink suggestions. It allows a controller agent to review knowledge-graph updates before applying them, rather than writing directly to the graph file.

How do I synchronize a knowledge graph after generating module code?

To synchronize a knowledge graph after generating module code, you can either update docs/knowledge-graph.xml directly in standalone mode or return a structured graph delta proposal in controller-driven mode for centralized review and application.

Does code generation with GRACE markup support local verification and testing?

Code generation with GRACE markup supports module-local verification by performing type checks, lint, and local tests. It returns a concise implementation packet listing files changed, verification results, sync output, and open assumptions.

Can I use automated code generation for controller-driven multi-agent workflows?

You can use automated code generation for controller-driven multi-agent workflows by operating in a mode that produces a graph delta proposal instead of direct updates. This provides the controller with module ID, imports, exports, and crosslink suggestions for review.

What do I need to start generating code from a module contract?

To start generating code from a module contract, you need docs/development-plan.xml and docs/knowledge-graph.xml files with the target module registered. The generation tool uses these entries to produce source files with semantic markup and verification results.