overthink-dev

Provide guidance on immutable OS architecture, build system, testing methods, and design decisions. Explains WHY things work the way they do.

Validates build cache layer ordering to prevent cache invalidation. Advisory warnings for changes to stable layers, Containerfile modifications, and build script sequencing.

Deep architectural exploration using chunkhound code_research. Use for understanding component relationships, flows, and patterns across the codebase.

Blocks any attempt to edit ~/.config/* files directly. These are OUTPUT configs generated by ujust commands - edit source code instead.

Enforces documentation system requirements. Validates MyST syntax, myst.yml completeness, cross-references, and file organization before editing docs or committing.

Reports GitHub Actions workflow status and error details using the GitHub MCP Server. Data reporter only - delegates analysis to root-cause-analyzer.

PROACTIVELY enforce justfile coding standards and non-interactive requirements when editing .just files. Validates syntax, patterns, and automation support.

Blocks any `just -f` usage in testing documentation and guides. Enforces Policy

Blocks any manual edit to pixi.lock files. Lock files must be regenerated via `pixi install`, never edited directly.

MUST BE USED before any code changes, commits, or declaring features "working". Enforces critical development policies from CLAUDE.md and docs/developer-guide/policies.md.

MUST BE USED before ANY git commit operation. Runs pre-commit validation and blocks commits if hooks fail. NEVER allows --no-verify.

MUST BE USED when any unexpected behavior, error, warning, or anomaly occurs. Performs deep root cause analysis following mandatory 8-step process. Never accepts "probably expected" without investigation.

Blocks documentation and code suggesting `sudo ujust` or `sudo just`. Enforces Policy

PROACTIVELY verify proper LOCAL system testing was performed before declaring features "working". Ensures all 8 testing standards met. Blocks commits if LOCAL verification missing.