review-architecture

Identify architectural drift and layering issues across compiler and runtime boundaries.

92|7|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/dannys-code-corner/incan --skill review-architecture-dannys-code-corner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-architecture
Source: https://github.com/dannys-code-corner/incan/tree/main/.agents/skills/review-architecture
Command: npx skills add https://github.com/dannys-code-corner/incan --skill review-architecture-dannys-code-corner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review touched subsystems for layering, crate boundaries, single-source-of-truth rules, registry-driven behavior, and compiler/runtime separation. Use when a broad review needs a dedicated architecture pass or when the user asks for architectural review specifically.

Core Features & Use Cases

  • Cross-file architecture reviews to identify layering and boundary drift.
  • Enforce canonical registries and shared semantics across subsystems during refactors.
  • Produce actionable architecture reports for planning and governance.

Quick Start

Provide a high-level architecture review of the touched subsystems and generate a concise findings report.

Frequently Asked Questions about review-architecture

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

FAQPage Schema
How do I review compiler architecture for subsystem layering issues?

To review compiler architecture, analyze cross-crate boundaries and subsystem layering to identify architectural drift. This process detects wrong-layer implementations and split-brain decision surfaces, producing a structured architecture report for governance.

What is architectural drift in a compiler runtime boundary?

Architectural drift is the degradation of intended subsystem layering across compiler and runtime boundaries. It manifests as duplicate policies, wrong-layer implementations, and split-brain decision surfaces that deviate from the original architectural design.

How do I enforce canonical registries during a subsystem refactor?

To enforce canonical registries during refactoring, perform an architecture pass that checks cross-crate boundaries for single-source-of-truth rules. This identifies duplicate policies and ensures shared semantics across subsystems.

When do I need an architecture pass for cross-crate reviews?

You need an architecture pass for cross-crate reviews when executing broad refactors or when specifically asked to perform an architectural review. It verifies registry-driven behavior and compiler/runtime separation across touched subsystems.

Can I check for split-brain decision surfaces across multiple crates?

Yes, you can check for split-brain decision surfaces by reviewing cross-crate boundaries for single-source-of-truth violations. The review identifies duplicate policies and wrong-layer implementations, outputting a structured findings report for planning.

What is the best way to identify wrong-layer implementations in a compiler?

The best way to identify wrong-layer implementations is to review touched subsystems for compiler and runtime separation. This architectural review detects boundary violations and registry consistency issues, generating an actionable architecture report.