review/architecture

Verify touched modules preserve architectural boundaries and single reasons to change.

8|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/usurobor/cnos --skill review-architecture-usurobor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review/architecture
Source: https://github.com/usurobor/cnos/tree/main/src/packages/cnos.cdd/skills/cdd/review/architecture
Command: npx skills add https://github.com/usurobor/cnos --skill review-architecture-usurobor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture and design checks ensure that touched modules preserve one real reason to change, maintain policy above detail, and keep interface truthfulness, registry normalization, source/artifact/installed boundaries, and clear surface separation.

Core Features & Use Cases

  • Checks that each touched module has one real reason to change.
  • Verifies that policy remains in the kernel/core and is not smeared across boundaries.
  • Ensures truthful interfaces, registry normalization, and clear source/artifact/installed boundaries.
  • Confirms surface separation between skills, commands, orchestrators, and providers.
  • Detects degraded-path visibility to guarantee fallback behavior is visible and testable.

Quick Start

Run this skill during a change touching architecture boundaries to verify boundary preservation and surface separation.

Frequently Asked Questions about review/architecture

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

FAQPage Schema
How do I verify architectural boundaries stay intact during code changes?▼

To verify architectural boundaries stay intact, run a design check that evaluates whether touched modules retain a single reason to change, preserve policy above detail, and maintain interface truthfulness across package boundaries.

What is registry normalization in software architecture?▼

Registry normalization ensures that interface registrations and runtime surfaces follow consistent mapping rules, preventing smeared kernel policy and maintaining clear separation between source, artifact, and installed package boundaries.

How do I check if my module has a single reason to change?▼

To check if a module has a single reason to change, apply architectural review checks that verify policy is not smeared across boundaries, interfaces remain truthful, and kernel responsibilities are distinctly separated from package tasks.

When do I need an architectural design check for package boundaries?▼

You need an architectural design check when changes affect package boundaries, registry normalization, kernel versus package responsibilities, or runtime surfaces, ensuring degraded-path visibility and fallback behavior remain testable.

What's the best way to review surface separation between commands and orchestrators?▼

The best way to review surface separation is applying checks that confirm clear boundaries between skills, commands, orchestrators, and providers, verifying that policy remains in the kernel and degraded paths are explicitly visible.

Why does my code review fail on degraded-path visibility checks?▼

Code review fails on degraded-path visibility when fallback behavior is hidden or untestable, violating the architectural boundary check that requires degraded paths to remain explicitly visible across module runtime surfaces.