kb-ssot-registries

Centralize Next.js domain data into typed registries with pre-commit drift validation.

Updated May 19, 2026
One-click install
npx skills add https://github.com/TimeKast/AgendaInteligente --skill kb-ssot-registries
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb-ssot-registries
Source: https://github.com/TimeKast/AgendaInteligente/tree/main/.claude/skills/kb-ssot-registries
Command: npx skills add https://github.com/TimeKast/AgendaInteligente --skill kb-ssot-registries

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents drift and broken integrations when multiple parts of a Next.js app consume the same domain data by centralizing that data into a single editable registry.

Core Features & Use Cases

  • Portable registry-as-SSOT: Model a domain once (as a typed as const registry) and derive all downstream types/configs from it.
  • Reconcile vs validate guardrails: Use pre-commit reconcilers to regenerate derived outputs silently, and validators to block commits when drift still exists or hooks are bypassed.
  • Best-effort handler resolution: Validate that referenced handlers/exported symbols exist using static source parsing instead of runtime imports.
  • Four-phase pre-commit workflow: Fit registry derivation and validation into a predictable hook architecture (fix, kit-generic autogen, domain autogen, then validators).

Quick Start

Use the kb-ssot-registries pattern to replace duplicated domain lists (for example, roles, navigation items, or notification categories) with a single editable registry file and wire its reconciler and validator into your pre-commit flow.

Frequently Asked Questions about kb-ssot-registries

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

FAQPage Schema
How do I prevent configuration drift in a Next.js and TypeScript application?

To prevent configuration drift in a Next.js TypeScript app, model domain data once in a typed registry and wire pre-commit reconcilers and validators into your workflow to block commits if duplicated outputs diverge from the source.

What is the single source of truth pattern for TypeScript domain data?

The single source of truth pattern for TypeScript uses a typed `as const` registry to model domain data once, deriving all downstream types and generated platform configs from that single editable file to eliminate duplicated lists.

Can I validate exported handlers without runtime imports in TypeScript?

Yes, you can validate exported handlers without runtime imports by using best-effort static source parsing. This mechanism checks that referenced handlers and exported symbols exist safely during pre-commit validation without executing code.

How do I set up a pre-commit hook for TypeScript registry validation?

Set up pre-commit registry validation by configuring a four-phase hook architecture: fix, kit-generic autogen, domain autogen, then validators. Reconcilers silently regenerate derived outputs first, followed by validators to block remaining drift.

When do I need a registry pattern for cross-cutting concerns like cron jobs and feature flags?

You need a registry pattern for cron jobs, navigation, roles, and feature flags when multiple Next.js app consumers access the same domain data. Centralizing this data eliminates duplicated lists and prevents broken integrations across consumers.

Does this single source of truth approach work with TypeScript id unions and derived lookup tables?

Yes, the single source of truth approach works with TypeScript id unions and derived lookup tables by satisfying typed derivation. It automatically derives downstream types and lookup tables directly from the centralized `as const` registry data.