structural-hygiene-review

Detects and grades authority drift in project structures, then applies corrective actions.

2|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill structural-hygiene-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: structural-hygiene-review
Source: https://github.com/Remaker-Digital/groundtruth-kb/tree/main/.claude/skills/structural-hygiene-review
Command: npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill structural-hygiene-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structural hygiene review prevents agents from learning the wrong “rules of the road” by ensuring the repo’s visible artifacts (directories, filenames, schemas, commands, and docs) match the canonical glossary and current sources of truth.

Core Features & Use Cases

  • Detect authority drift: Finds stale or historical artifacts that appear active, causing competing or confusing sources of truth.
  • Enforce canonical terminology: Flags terminology drift across MemBase views, docs, schemas, CLI names, tests, and generated outputs.
  • Guide safe corrections: Archives obsolete artifacts into clearly labeled history/deprecated locations, updates references/tests, and adds guards against legacy names.

Quick Start

Use structural-hygiene-review to inventory the repo for competing authority cues and generate a hygiene report with prioritized corrections.

Frequently Asked Questions about structural-hygiene-review

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

FAQPage Schema
How do I detect authority drift in my project repository?

To detect authority drift, inventory the repo for competing authority cues across directories, filenames, schemas, CLI surfaces, and docs. This process builds an authority map that flags historical artifacts appearing active with P0–P3 severity levels.

What is the best way to enforce canonical terminology across schemas and CLI surfaces?

The best way to enforce canonical terminology is to flag terminology drift across MemBase views, docs, schemas, CLI names, tests, and generated outputs. This ensures visible artifacts match the canonical glossary and current sources of truth.

How do I safely archive obsolete artifacts causing repo hygiene issues?

To safely archive obsolete artifacts, apply safe archiving and correction rules that move deprecated files into clearly labeled history or deprecated locations. This updates references, tests, and adds guards against legacy names.

Why do agents learn the wrong rules when project structure diverges from the operating model?

Agents learn the wrong rules because stale or historical artifacts appear active and act as competing sources of truth. Structural hygiene review corrects this by aligning the repo’s visible artifacts with the true operating model and canonical glossary.

Can I use structural hygiene review for audits of generated outputs and cross-references?

Yes, you can use it to audit generated outputs, cross-references, directories, filenames, schemas, table names, view names, CLI surfaces, and docs for a given concept under review to correct project-structure authority drift.