Skip to main content

Ritual: The Inspection

Trigger

Every weekday at 9:00 AM local time.

What It Does

Scans the codebase for code health signals: TODOs and FIXMEs, files exceeding size limits, wildcard dependency versions, and any patterns the Doorman considers hygiene violations.

Steps

  1. Search for TODO and FIXME comments — record file:line for each
  2. Find files exceeding 500 lines — list them with line count
  3. Parse package.json (and equivalents) for wildcard versions
  4. Check test file ratio — flag source files with no corresponding test file
  5. Check for files modified in the last 7 days with no corresponding test changes
  6. Produce the health report

Report Format

## 🔍 Daily Inspection — {Date}

### 📋 TODO / FIXME ({count})
{file:line — comment text}

### 📏 Oversized Files ({count})
{file — N lines (limit: 500)}

### 📦 Dependency Drift ({count})
{dependency@^version — pin to exact version}

### 🧪 Untested Files ({count})
{file — no corresponding test file found}

### ✅ All Clear
{categories with zero findings}

---
*Generated by The Doorman · Agenthood*

Notes

  • File size limit is configurable (default: 500 lines)
  • TODO age threshold: flag TODOs older than 30 days
  • Does not modify any files — report only