kb-assert

Validate ADR/DCL governance assertions against the GroundTruth knowledge database.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of manually checking whether your architecture decisions and design constraints are actually compliant with the platform’s governance rules.

Core Features & Use Cases

  • Runs architecture-layer assertions: Executes validation for ADR and DCL specifications from the knowledge database and classifies results by enforcement state.
  • Supports review and audit modes: Uses a dry-run to display outcomes without persisting them, and an optional record mode to store results for later reference.
  • Produces a compliance dashboard: Groups results into meaningful governance families (for example, Transport/Container, Zero-Knowledge/Isolation, RBAC) to highlight gaps quickly.

Quick Start

Run kb-assert in dry-run mode to view the current compliance dashboard without recording anything.

Frequently Asked Questions about kb-assert

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

FAQPage Schema
How do I validate architecture decision records against governance constraints?

To validate architecture decision records, you query the latest ADR and DCL spec versions from a SQLite knowledge database and execute validation functions to classify compliance by enforcement state.

What is the best way to check DCL constraints for active architecture specifications?

Checking DCL constraints involves loading a knowledge database module, retrieving active specifications grouped by lifecycle status, and running validation to highlight any governance gaps.

Can I persist architecture compliance check results to an SQLite audit table?

Yes, you can persist compliance check results by using a record mode that stores validation outcomes into an assertion_runs SQLite audit table for later reference.

How do I preview ADR validation results without permanently recording them?

You can preview ADR validation results by running the compliance check in a dry-run mode, which displays the dashboard outcomes without persisting anything to the database.

How are architecture compliance validation results grouped for review?

Architecture compliance validation results are grouped into governance families such as Transport, Zero-Knowledge, and RBAC within a dashboard to highlight specification gaps quickly.

Do I need a specific database setup to run design constraint lifecycle assertions?

Yes, running design constraint assertions requires a SQLite GroundTruth knowledge database containing the active ADR and DCL specifications to validate against.