contextd check

Validate the health and completeness of your context files.

Usage

contextd check [options]

Options

What it checks

Core file checks

• project.md — Required. Error if missing.
• architecture.md — Recommended for larger projects. Warning if missing.
• conventions.md — Helps AI follow coding style. Warning if missing.

Content quality checks

• Empty files — Warns if a file’s content is less than 50 characters or contains only comments/headers
• Stale files — Warns if a file has no updated date or the date is more than 3 months old

Decision records

• Counts the number of ADRs recorded
• Warns if no decisions have been recorded

Module coverage

Checks your source directories for modules that lack context files:

• Scanned directories: src, app, lib, packages, services, api, components
• Warns if subdirectories exist without corresponding module context in .context/modules/
• Checks up to 8 source directories, max 5 subdirectories per top-level directory

Example output

  Context Health Check

  ✓ project.md exists
  ✓ architecture.md exists
  ✓ conventions.md exists
  ⚠  decisions/001-example.md appears to be empty/unfilled
  ⚠  conventions.md has no updated date or is > 3 months old
  ⚠  src/api/ has no module context — consider adding .context/modules/api.md
  ⚠  No architecture decisions recorded — consider adding ADRs

  3 passed · 4 warnings · 0 errors

Auto-fix

The --fix flag is reserved for future use. Auto-fix functionality is not yet implemented.