grace-refresh

Synchronize the GRACE knowledge graph with the repository codebase and generate an integrity report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Synchronizes the GRACE knowledge graph with the actual codebase to eliminate drift caused by refactors, multi-agent waves, or manual edits and to avoid stale dependencies and missing module entries that break tooling and navigation.

Core Features & Use Cases

  • Targeted vs full refresh: perform narrow scans of changed modules and immediate dependency surfaces or full tree scans after broad refactors.
  • Graph comparison and integrity reporting: extract MODULE_CONTRACT and MODULE_MAP, compare imports and CrossLinks against docs/knowledge-graph.xml, and produce a structured GRACE Integrity Report listing missing, orphaned, and stale entries.
  • Safe remediation workflow: propose concrete fixes (add/remove/update entries or generate missing contracts) and apply changes only after explicit user approval.
  • Use case: after a coordinated multi-agent execution wave, run a targeted refresh to validate cross-module changes; after a large refactor, run a full refresh to reconcile the graph.

Quick Start

Ask the assistant to "Refresh the GRACE knowledge graph for the files changed in the latest commit and produce an integrity report with proposed fixes."

Frequently Asked Questions about grace-refresh

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

FAQPage Schema
How do I detect drift between my codebase and knowledge graph after a refactor?

Knowledge graph drift is detected by running a full repository scan that compares actual imports and CrossLinks against docs/knowledge-graph.xml to identify missing modules, orphaned entries, and stale connections. It generates a structured integrity report detailing the discrepancies.

What is the best way to synchronize module contracts after multi-agent code changes?

Synchronizing module contracts after multi-agent changes is done by performing a targeted scan of changed modules and their immediate dependency surfaces. It extracts MODULE_CONTRACT and MODULE_MAP data, compares them against the graph, and proposes user-approved updates to reconcile drift.

How does crosslink integrity reporting work for repository codebases?

CrossLink integrity reporting works by extracting MODULE_CONTRACT and MODULE_MAP files, comparing their declared imports against docs/knowledge-graph.xml, and producing a structured report. It lists missing, orphaned, and stale entries to highlight exactly where the graph and codebase diverge.

Can I automatically update the knowledge graph when files are missing module contracts?

You cannot automatically apply changes; the remediation workflow proposes concrete fixes like generating missing contracts or updating entries, but changes apply only after explicit user approval. This safe workflow ensures you retain full control over knowledge graph modifications.

When should I run a targeted scan versus a full knowledge graph refresh?

Run a targeted scan during active multi-agent waves to validate specific cross-module changes and immediate dependencies. A full refresh is intended for use after large refactors or when broad drift is suspected across the entire repository codebase.