Skip to main content

​
Overview

Perform a diagnostic health check across all ArcKit projects to identify governance artifacts that need attention — stale data, forgotten decisions, unresolved conditions, broken traceability, and version drift.
Console-only diagnostic. This command does NOT create a file — it outputs a health report directly to your conversation. The only file written is docs/health.json for dashboard integration.

​
When to Use

Run /arckit.health to:
  • Periodic governance health audits (monthly/quarterly)
  • Before major milestones or design reviews
  • After team transitions to identify forgotten artifacts
  • Troubleshoot traceability gaps

​
Usage

# Scan all projects
/arckit.health

# Scan specific project
/arckit.health 001-payment-gateway

# Show only high-severity findings
/arckit.health SEVERITY=HIGH

# Check what would be stale as of a specific date
/arckit.health SINCE=2024-01-01

​
Detection Rules

RuleSeverityThreshold
STALE-RSCHHIGHResearch documents >6 months old
FORGOTTEN-ADRHIGHADR status “Proposed” for >30 days
UNRESOLVED-CONDHIGHReview conditions without resolution
ORPHAN-ARTIFACTMEDIUMArtifacts not referenced in traceability
MISSING-TRACMEDIUMProjects without traceability matrix
VERSION-DRIFTLOWMultiple artifact versions without changelog
STALE-VENDORLOWVendor proposals >6 months old

​
Output Format

The command displays:
  1. Health Score (0-100%)
  2. Summary Statistics (total artifacts, findings by severity)
  3. Detailed Findings with:
    • Severity level (🔴 HIGH / 🟠 MEDIUM / 🟡 LOW)
    • Affected artifact path
    • Issue description
    • Suggested remediation

​
What It Does NOT Do

This command does NOT modify any project files. It is purely diagnostic. You must manually address the findings.

Analyze

Comprehensive governance quality analysis

Traceability

Generate requirements traceability matrix

Story

Generate project story with timeline

Build docs developers (and LLMs) love

Get started for freeTalk to us