invest-doctrine

Audit project doctrine files for consistency and codebase drift.

52|9|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/erikaflowers/investiture --skill invest-doctrine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: invest-doctrine
Source: https://github.com/erikaflowers/investiture/tree/main/.claude/skills/invest-doctrine
Command: npx skills add https://github.com/erikaflowers/investiture --skill invest-doctrine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Ensures that project documentation (doctrine files) is complete, consistent, and aligned with the actual codebase, preventing errors in downstream automated processes.

Core Features & Use Cases

  • Doctrine Validation: Audits VECTOR.md, CLAUDE.md, and ARCHITECTURE.md for completeness, internal consistency, and contradictions.
  • Structure vs. Disk Check: Verifies that declared directories in ARCHITECTURE.md exist on the filesystem and vice-versa.
  • Drift Detection: Identifies discrepancies between declared conventions/stack and actual codebase implementation.
  • Use Case: Before deploying a new feature, run this skill to confirm that the project's core principles, contributor guidelines, and technical architecture are up-to-date and accurately reflect the current state of the codebase.

Quick Start

Audit all project doctrine files for completeness and consistency.

Frequently Asked Questions about invest-doctrine

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

FAQPage Schema
How do I audit project documentation for consistency with my codebase?

To audit project documentation for consistency, validate doctrine files like VECTOR.md and ARCHITECTURE.md against filesystem reality to detect drift, check structural requirements, and identify cross-document contradictions. This ensures technical architecture accurately reflects the current codebase state.

What is project doctrine drift detection and when do I need it?

Project doctrine drift detection identifies discrepancies between declared conventions in documentation files and actual codebase implementation. You need it before deploying features to confirm core principles, contributor guidelines, and stack declarations remain accurate and prevent downstream automation errors.

Can I check if declared directories in ARCHITECTURE.md exist on the filesystem?

Yes, you can check if declared directories in ARCHITECTURE.md exist on the filesystem by running a structure versus disk validation. This verifies that declared directories match filesystem reality and flags missing or undocumented folders in your project architecture.

How do I validate naming conventions and import directions against actual code?

Validate naming conventions and import directions by auditing project doctrine files to compare declared structural requirements against the actual codebase. This process checks filesystem reality to ensure your technical stack declarations and architectural rules are correctly implemented.

What's the best way to find contradictions across project documentation files?

The best way to find contradictions across project documentation files is to audit doctrine files for internal consistency and cross-document contradictions. This checks completeness across VECTOR.md, CLAUDE.md, and ARCHITECTURE.md to ensure alignment and produces a report with recommended actions.

Why does my project architecture documentation fail completeness checks?

Project architecture documentation fails completeness checks when doctrine files lack required structural sections, miss naming conventions, or omit stack declarations. Auditing these files identifies missing elements and cross-document contradictions, producing a detailed report of findings and recommended actions.