invest-architecture

Audits repositories to verify alignment with ARCHITECTURE.md and generates structured reports with optional auto-fixes.

7|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/celanthe/clarion --skill invest-architecture-celanthe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: invest-architecture
Source: https://github.com/celanthe/clarion/tree/main/.claude/skills/invest-architecture
Command: npx skills add https://github.com/celanthe/clarion --skill invest-architecture-celanthe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit the project structure against ARCHITECTURE.md by deriving rules from the operator's doctrine and enforcing them across the codebase.

Core Features & Use Cases

  • Doctrine-driven audit: Read ARCHITECTURE.md, VECTOR.md, and CLAUDE.md to derive rules and verify compliance.
  • Layer, naming, and import validation: Ensure modules live in correct layers, follow naming conventions, and respect import directions.
  • Audit report: Produce a structured summary with findings and severity levels, and optional auto-fix hints.

Quick Start

Run the audit on the repository to validate alignment with ARCHITECTURE.md.

Frequently Asked Questions about invest-architecture

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

FAQPage Schema
How do I audit my codebase architecture against a doctrine file?

You can audit codebase architecture by running this Skill, which reads your doctrine files like ARCHITECTURE.md, VECTOR.md, and CLAUDE.md to verify layer boundaries, naming conventions, and import direction compliance across the project.

What is import direction compliance in a codebase audit?

Import direction compliance verifies that modules respect architectural layer boundaries by ensuring imports follow the allowed direction defined in your doctrine, preventing lower layers from improperly importing higher layers.

Does the architecture audit require an ARCHITECTURE.md file to work?

Yes, the architecture audit reads ARCHITECTURE.md to derive rules and enforce alignment, and also reads VECTOR.md and CLAUDE.md to fully derive the operator's doctrine before validating layers, naming, and imports.

Can I automatically fix import and layer boundary violations found during the audit?

Yes, the audit produces a structured report with findings, severity levels, and optional auto-fix hints that you can use to correct layer boundary, naming convention, and import direction violations across your codebase.

What is the best way to enforce naming conventions across a large repository?

The best way to enforce naming conventions is to define them in your doctrine files and run a doctrine-driven architecture audit, which derives rules from ARCHITECTURE.md and verifies that all modules follow the specified naming patterns.

What limitations exist when auditing stack choices against a codebase doctrine?

The audit derives rules strictly from existing doctrine files like ARCHITECTURE.md and CLAUDE.md, meaning if your doctrine does not explicitly define stack choices or layer boundaries, the audit cannot verify compliance for those unspecified architectural constraints.