invest-doctrine

Audit VECTOR.md, CLAUDE.md, and ARCHITECTURE.md for completeness, consistency, and drift.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/robjonesdesigns/portfolio --skill invest-doctrine-robjonesdesigns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: invest-doctrine
Source: https://github.com/robjonesdesigns/portfolio/tree/main/.claude/skills/invest-doctrine
Command: npx skills add https://github.com/robjonesdesigns/portfolio --skill invest-doctrine-robjonesdesigns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill ensures doctrine documents are complete, internally consistent, and aligned with the actual codebase, preventing gaps that derail downstream audits.

Core Features & Use Cases

  • Cross-document validation of VECTOR.md, CLAUDE.md, and ARCHITECTURE.md to detect missing files, contradictions, and drift.
  • Consistency checks across entries to ensure terminology, rules, and boundaries match the codebase and project governance.
  • Open-question tracking surfaces gaps and ambiguous requirements to guide investments in invest-architecture.

Quick Start

Run the Doctrine Audit to verify VECTOR.md, CLAUDE.md, and ARCHITECTURE.md are present, internally consistent, and aligned with the actual codebase.

Frequently Asked Questions about invest-doctrine

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

FAQPage Schema
How do I audit architecture doctrine files for consistency and drift?

The audit detects missing files, contradictions, and drift by cross-checking VECTOR.md, CLAUDE.md, and ARCHITECTURE.md against each other and the actual codebase. It enforces structure rules and reports findings to guide downstream architecture investments.

Why does my project documentation have contradictions between CLAUDE.md and ARCHITECTURE.md?

Documentation contradictions happen when doctrine files drift from the actual codebase and lose cross-document coherence. Running a doctrine audit surfaces these gaps, validates terminology boundaries, and identifies ambiguous requirements to prevent downstream audit failures.

Do I need all three doctrine files to run a consistency audit?

Yes, a consistency audit requires all three doctrine files—VECTOR.md, CLAUDE.md, and ARCHITECTURE.md—to exist. The audit enforces structure and cross-check rules across the complete set to accurately validate content quality and detect drift.

What is the best way to track open questions and gaps in project governance documents?

The best way to track open questions in governance documents is to audit doctrine files for completeness and cross-document consistency. This surfaces ambiguous requirements and gaps, reporting findings to guide architecture investments.

Can I check if my architecture documentation matches the actual codebase?

Yes, you can check if architecture documentation matches the actual codebase by running a doctrine audit. It validates presence, content quality, and cross-document coherence across VECTOR.md, CLAUDE.md, and ARCHITECTURE.md to detect drift.