architect

Audit codebase architecture and generate a formal report.

86|20|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/optave/ops-codegraph-tool --skill architect-optave
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/optave/ops-codegraph-tool/tree/main/.claude/skills/architect
Command: npx skills add https://github.com/optave/ops-codegraph-tool --skill architect-optave

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architects and teams often struggle to coordinate an architecture audit across large codebases, leading to gaps between decisions, implementation, and documentation, which degrades accountability and traceability.

Core Features & Use Cases

  • Dual-Lens Scoring: assesses current architecture against state-of-the-art benchmarks to surface architectural debt with prioritized remediation.
  • ADR Compliance & Documentation: maps decisions to ADRs and produces auditable artifacts for governance.
  • End-to-End Audit Flow: coordinates setup, metrics collection, and structured reporting for reproducible, scalable assessments.

Quick Start

Run a comprehensive architectural audit of the codegraph repository and generate a formal report in generated/architecture.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I perform an architecture audit on a large codebase?

An architecture audit comprehensively identifies and surfaces architectural flaws and misalignments in a codebase. This Skill coordinates setup, metrics collection, and structured reporting to evaluate repositories against enterprise-grade standards.

What is dual-lens scoring in architecture review?

Dual-lens scoring assesses current architecture against state-of-the-art benchmarks to surface architectural debt. It provides prioritized remediation strategies by evaluating the codebase from two distinct analytical perspectives.

How do I check ADR compliance and map decisions to documentation?

ADR compliance checks map architectural decisions to ADRs and produce auditable artifacts for governance. This ensures traceability and accountability between implementation, documentation, and architectural standards.

Can I use this architectural audit for Codegraph-scale repositories?

Yes, this architectural audit is designed for Codegraph-scale repositories and architectural review scenarios. It evaluates the codebase across multiple layers using industry tools and enterprise-grade standards.

How do I generate a formal architecture audit report?

Run a comprehensive architectural audit of the codegraph repository to generate a formal report in the generated/architecture directory. The end-to-end audit flow produces structured, evidence-backed findings for reproducible assessments.