architectural-conformance-validation

Validate feature designs, wave plans, and code against ADRs and architecture patterns.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/onshoreoutsourcing/lighthouse-beacon --skill architectural-conformance-validation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architectural-conformance-validation
Source: https://github.com/onshoreoutsourcing/lighthouse-beacon/tree/main/.claude/skills/architectural-conformance-validation
Command: npx skills add https://github.com/onshoreoutsourcing/lighthouse-beacon --skill architectural-conformance-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Architectural drift and misalignment with architectural decisions slow delivery and increase risk. This Skill provides automated validation against ADRs, patterns, and architecture docs to ensure features, waves, and implementations stay compliant.

Core Features & Use Cases

  • Pattern and ADR conformance checks that verify alignment with documented patterns and decisions.
  • Risk scoring and reporting that produce a conformance score and structured findings with remediation guidance.
  • Artifact scope coverage for feature plans, wave designs, and post-implementation code across the repository.
  • Reference-driven validation against Architecture.md, ADRs, and validation references to maintain architectural integrity.

Quick Start

  1. Prepare the artifact you want to validate (e.g., Docs/design-features/feature-5.1.md).
  2. Ensure Architecture.md and ADRs are accessible as references for checklists.
  3. Run the architectural conformance validation skill to generate a report and identify remediation steps.

Frequently Asked Questions about architectural-conformance-validation

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

FAQPage Schema
How do I validate my code against architectural decisions and design patterns?

Architectural conformance validation checks your feature designs and post-implementation code against established ADRs and architecture docs. It outputs a conformance score and structured findings to identify and remediate deviations.

What is architectural conformance validation and when do I need it?

Architectural conformance validation identifies and reports deviations from established architecture decisions and patterns. You need it to prevent architectural drift and misalignment across feature plans, wave designs, and repository implementations.

How do I check ADR compliance in my feature design files?

To check ADR compliance, ensure your Architecture.md and ADRs are accessible as references, then run the validation against your feature design artifacts. It verifies alignment with documented patterns, API contracts, and security data handling.

Does architectural conformance validation work with post-implementation code reviews?

Yes, architectural conformance validation applies to post-implementation code across the repository. It checks ADR compliance, design-pattern usage, and API contracts to ensure code implementations stay compliant with documented architecture.

Can I use architectural validation for wave plans and feature plans at scale?

Architectural conformance validation covers feature plans, wave designs, and post-implementation code across your project. It produces risk scoring and structured reporting with remediation guidance to maintain architectural integrity at scope.

What are the limitations of relying on architecture docs for conformance checks?

Validation depends on accessible Architecture.md and ADR references to generate accurate conformance scores. If these reference documents are outdated or incomplete, the automated validation cannot effectively identify architectural drift or verify pattern usage.