skills.rest
tractorjuice
tractorjuiceCOMMUNITY
Explore all skills by this author →
GitHub

arckit-conformance

Compare architecture principles, ADR decisions, and design artifacts against implemented designs.

2.1k|266|Updated Oct 14, 2025
Search Tags:#architecture#adr#technical debt#principles#drift#conformance
One-click install
npx skills add https://github.com/tractorjuice/arc-kit --skill arckit-conformance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arckit-conformance
Source: https://github.com/tractorjuice/arc-kit/tree/main/arckit-codex/skills/arckit-conformance
Command: npx skills add https://github.com/tractorjuice/arc-kit --skill arckit-conformance

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill systematically assesses whether your designed or implemented architecture aligns with established architecture principles, approved decisions (ADRs), and review conditions, identifying drift and technical debt.

Core Features & Use Cases

  • ADR Implementation Check: Verifies that accepted Architecture Decision Records are reflected in design documents.
  • Principle Alignment: Ensures designs strictly adhere to mandatory architecture principles.
  • Drift Detection: Identifies discrepancies between decided and designed technologies and patterns.
  • Technical Debt Identification: Surfaces known and potential untracked architecture technical debt.
  • Use Case: Before a major release, run this Skill to ensure the new features comply with all architectural standards and decisions, preventing costly rework and ensuring long-term maintainability.

Quick Start

Assess the architecture conformance for the current project, checking ADR implementation and principle alignment.

Frequently Asked Questions about arckit-conformance

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

FAQPage Schema
How do I verify architecture conformance against ADR decisions and principles?▼

Architecture conformance is verified by systematically comparing implemented designs against established architecture principles, ADR decisions, and design artifacts to identify drift and technical debt.

What is architecture drift detection and when do I need it?▼

Architecture drift detection identifies discrepancies between decided technologies and patterns in ADRs versus actual implemented designs. You need it before major releases to ensure features comply with architectural standards and prevent costly rework.

How do I check if approved Architecture Decision Records are reflected in design documents?▼

ADR implementation checking verifies that accepted Architecture Decision Records are accurately reflected in design documents by comparing ADR decisions against HLD and DLD artifacts for strict alignment.

Can I assess technical debt using only architecture principles without ADRs?▼

Architecture principles alone are insufficient for comprehensive analysis. The conformance assessment requires both architecture principles and ADRs, while optionally including HLD and DLD documents to surface known and potential untracked technical debt.

Does this architecture conformance assessment work with custom constraint rules?▼

Yes, the architecture conformance assessment identifies adherence to custom constraint rules by comparing your specified architecture principles and ADR decisions against the implemented design artifacts for violations.

What's the best way to ensure design adherence to mandatory architecture principles?▼

The best way to ensure adherence is performing systematic principle alignment checks that compare mandatory architecture principles against design documents to identify technical debt and prevent drift before release.

Related Skills

Explore More Software Engineering Skills→
tractorjuicetractorjuice
2.1k

arckit-diagram

Generate C4, sequence, and data flow diagrams using Mermaid or PlantUML.

Community
Advanced
MovchanetsMovchanets

code-refactoring-tech-debt

Identify technical debt and prioritize remediation opportunities across a codebase.

Community
Advanced
yutaro0915yutaro0915

cdd-review-decision

Validate DECIDED design decisions for alignment with architecture and related documents before implementation.

Community
Advanced
Obsidian-OwlObsidian-Owl
9

gate-wiring

Detect unused exports, orphaned files, layer violations, and circular dependencies in changed code.

Official
Intermediate