architect-validate

Validate project plans against architectural decision records for coherence.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/chaimt/GarminShabbatMode --skill architect-validate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-validate
Source: https://github.com/chaimt/GarminShabbatMode/tree/main/.cursor/skills/architect-validate
Command: npx skills add https://github.com/chaimt/GarminShabbatMode --skill architect-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures that project plans stay aligned with documented architectural decisions, preventing drift and costly rework.

Core Features & Use Cases

  • Pillar-based validation against ADRs and generated plans
  • Escalation detection for missing ADRs or plan gaps
  • Read-only validation that reports issues in JSON or console formats

Quick Start

Run architect-validate against the current repository to verify ADR alignment and plan consistency.

Frequently Asked Questions about architect-validate

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

FAQPage Schema
How do I validate that a project plan aligns with architectural decisions?

To validate plan alignment with architectural decisions, run a read-only check against your repository to verify ADR coherence and detect gaps. This process examines cross-ADR consistency and data flows without modifying files.

What is cross-ADR consistency checking?

Cross-ADR consistency checking verifies that architectural decisions do not conflict across components and data flows. It detects inconsistencies and plan gaps to ensure project plans remain aligned with the established architecture.

How do I check my repository for missing ADRs and plan gaps?

You can check for missing ADRs and plan gaps by applying pillar-based validation to your repository. This read-only process detects potential escalations and reports issues in either JSON or console output formats.

Does architectural validation support JSON output format?

Yes, architectural validation supports both JSON and console outputs. This allows you to programmatically capture detected alignment issues and inconsistencies or review them directly in your terminal.

Can I validate plans against team directives stored in repository memory?

Yes, you can validate plans against team directives stored in repository memory. The validation process applies to ADRs kept in memory or drafts, ensuring plan-to-architecture coherence across all components.

Why does architectural plan validation need to be read-only?

Architectural plan validation is read-only to enforce safe checking that reports issues without modifying existing plans or ADRs. This prevents accidental changes to documented decisions during the consistency review.