arckit-health

Scan ArcKit projects for governance health issues and write findings to docs/health.json.

2.1k|266|Updated Oct 14, 2025
One-click install
npx skills add https://github.com/tractorjuice/arc-kit --skill arckit-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arckit-health
Source: https://github.com/tractorjuice/arc-kit/tree/main/arckit-codex/skills/arckit-health
Command: npx skills add https://github.com/tractorjuice/arc-kit --skill arckit-health

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill proactively identifies potential governance gaps and risks within your enterprise architecture artifacts, ensuring that your documentation remains current, complete, and actionable.

Core Features & Use Cases

  • Proactive Issue Detection: Scans for stale research, forgotten decisions, unresolved review conditions, orphaned requirements, missing traceability, and version drift.
  • Severity-Based Prioritization: Assigns HIGH, MEDIUM, or LOW severity to findings, allowing you to focus on the most critical issues first.
  • Use Case: Before a major design review, run this Skill to quickly identify any outstanding conditions from previous reviews or ensure all new requirements have corresponding architectural decisions documented.

Quick Start

Run the arckit-health skill to scan all projects for governance issues.

Frequently Asked Questions about arckit-health

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

FAQPage Schema
How do I check my architecture repository for stale research and forgotten ADRs?

To check for stale research and forgotten ADRs, run a diagnostic health scan across all ArcKit projects. This identifies unresolved review conditions and outputs severity-based findings to the console and a health.json file.

What is architecture governance health and how does artifact scanning work?

Architecture governance health is the completeness and currency of your enterprise documentation. Artifact scanning works by applying seven detection rules to your projects directory to identify orphaned artifacts, missing traceability, and version drift.

Can I use this to find unresolved review conditions before a major design review?

Yes, you can use this to find unresolved review conditions before a major design review. It proactively scans your architecture artifacts to ensure documentation remains current, complete, and actionable by assigning severity priorities.

What's the best way to identify orphaned requirements and version drift in architecture projects?

The best way to identify orphaned requirements and version drift is to execute a diagnostic health check. This applies seven detection rules to your artifacts, prioritizing discovered governance risks by HIGH, MEDIUM, or LOW severity.

Do I need specific dependencies to run an architecture governance health check?

No specific dependencies are required to run an architecture governance health check. The Skill operates independently by scanning your projects directory for ARC artifacts and writing the diagnostic results directly to your documentation.