invest-architecture

Audits a codebase against project-defined architectural rules in markdown files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automatically audits your codebase against your project's specific architectural rules, ensuring consistency and adherence to your defined standards without manual checks.

Core Features & Use Cases

  • Automated Auditing: Scans code against doctrine defined in ARCHITECTURE.md, VECTOR.md, and CLAUDE.md.
  • Rule Enforcement: Checks for layer separation, import direction, naming conventions, and design token usage.
  • Use Case: After defining your project's layers and naming conventions in ARCHITECTURE.md, run this skill to verify that new code adheres to these established rules, preventing architectural drift.

Quick Start

Run the invest-architecture skill to audit the entire project for architectural violations.

Frequently Asked Questions about invest-architecture

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

FAQPage Schema
How do I enforce architectural rules in a codebase automatically?

To enforce architectural rules automatically, audit your codebase against project-specific doctrine defined in markdown files. This skill scans for layer separation, import direction, and naming conventions to prevent architectural drift.

How do I prevent architectural drift when adding new code?

Prevent architectural drift by running an audit that checks new code against established rules in your architecture markdown files. It verifies layer separation and design token usage, offering optional auto-fixing for eligible violations.

Do I need to define project layers before running a code architecture audit?

Yes, you must define your project's layers and naming conventions in markdown files like ARCHITECTURE.md before auditing. The architecture audit uses these specific doctrine files to evaluate code compliance.

Can an architecture audit automatically fix import direction violations?

Yes, an architecture audit can automatically fix eligible violations. Alongside reporting layer separation and naming convention issues, it supports optional auto-fixing for certain import direction and architectural rule breaches.

What is the best way to check design token usage across a project?

The best way to check design token usage is to run an automated code audit against your project's architectural doctrine. It evaluates token application alongside import direction and layer separation to ensure consistency.