arch-compliance

Audit Kartix implementation against documentation and classify feature reality.

Updated Mar 11, 2026
One-click install
npx skills add https://github.com/FutureAtoms/Kartix --skill arch-compliance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-compliance
Source: https://github.com/FutureAtoms/Kartix/tree/main/.agents/skills/arch-compliance
Command: npx skills add https://github.com/FutureAtoms/Kartix --skill arch-compliance

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill ensures that the Kartix project's implementation accurately reflects its documented architecture and plan, preventing overclaiming and identifying actual work remaining.

Core Features & Use Cases

  • Truthfulness Auditing: Verifies the actual implementation status of features against documentation, distinguishing between REAL, PARTIAL, STUB, MISSING, and FACADE.
  • Gap Identification & Closure: Pinpoints missing code, broken wiring, and insufficient tests, then actively works to implement them.
  • Honest Coverage Reporting: Provides clear metrics on feature completion and test effectiveness, avoiding inflation from passing tests on non-functional features.
  • Use Case: After a development sprint, use this Skill to confirm that all features planned for the current phase are genuinely implemented and tested, not just stubbed or partially wired, before a release.

Quick Start

Use the arch-compliance skill to run the full architecture compliance cycle and implement any remaining in-scope gaps.

Frequently Asked Questions about arch-compliance

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

FAQPage Schema
How do I verify architecture compliance against project documentation?

Architecture compliance verification audits implementation against documentation by classifying feature reality as REAL, PARTIAL, STUB, MISSING, or FACADE. It pinpoints broken wiring and missing code, actively implements remaining gaps, and reports honest coverage metrics to prevent overclaiming.

How do I distinguish real features from stubs or facades in my codebase?

Distinguishing real features from stubs or facades involves a truthfulness audit that evaluates actual implementation status against documented plans. This classification categorizes features into REAL, PARTIAL, STUB, MISSING, or FACADE states, ensuring passing tests on non-functional features do not inflate coverage.

How do I close architecture gaps and implement missing code after a sprint?

Closing architecture gaps requires a full-cycle compliance audit that identifies missing code and broken wiring, then actively implements the remaining in-scope features. It adds corresponding tests to verify the new implementation and reports honest coverage metrics for release readiness.

What is honest coverage reporting and how does it prevent overclaiming?

Honest coverage reporting provides clear metrics on feature completion and test effectiveness by factoring in the actual implementation status. It prevents overclaiming by ensuring that passing tests on STUB or FACADE features do not inflate the reported coverage of genuinely MISSING or PARTIAL functionality.

Can I use architecture compliance auditing for release readiness checks?

Architecture compliance auditing suits release readiness checks by confirming that all features planned for a development phase are genuinely implemented and tested. It verifies implementation against documentation, ensuring no planned functionality remains partially wired or missing before a release.

Why does my test coverage report show high scores but features are missing?

Test coverage reports show high scores with missing features when tests pass on STUB or FACADE implementations. An architecture compliance audit identifies this by classifying feature reality and reporting honest coverage metrics that reflect actual implementation status rather than inflated test pass rates.