review-codebase

Detect codebase misalignment with documented architectural specs and invariants.

Updated May 7, 2026
One-click install
npx skills add https://github.com/marktoda/cohesive --skill review-codebase-marktoda
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-codebase
Source: https://github.com/marktoda/cohesive/tree/main/skills/review-codebase
Command: npx skills add https://github.com/marktoda/cohesive --skill review-codebase-marktoda

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of unassessed architectural drift in long-lived codebases, where implementation gradually diverges from documented specs, invariants, and intended system boundaries, leading to risky changes that require original author context to execute safely.

Core Features & Use Cases

  • Full architecture review: Audits entire codebases or named subsystems for alignment with normative documentation, enforcement of named invariants, and correct placement of architectural seams.
  • Parallel specialized review: Dispatches four focused reviewer agents in parallel to assess substrate alignment, code structure, library-native patterns, and agent-readiness, then synthesizes their findings into a single thesis-led report with prioritized, actionable recommendations.
  • Use case: Use this when planning a major refactor, onboarding to a legacy codebase, or auditing a repo for hidden architectural drift before high-stakes changes to ensure the system can scale development without relying on founder memory.

Quick Start

Use the review-codebase skill to audit the entire payment processing subsystem for architectural cohesion against the existing specs and invariants.

Frequently Asked Questions about review-codebase

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

FAQPage Schema
How do I audit my codebase for architectural drift before a major refactor?

To audit a codebase for architectural drift, dispatch parallel specialized reviewers to assess substrate alignment, code structure, library-native patterns, and agent-readiness, then synthesize their findings into a thesis-led report with prioritized remediation steps.

What is the best way to check subsystem cohesion in a legacy codebase?

The best way to check subsystem cohesion is auditing named subsystems against normative documentation to verify enforcement of invariants and correct placement of architectural seams, ensuring the system scales without relying on founder memory.

Can I run a codebase review if my architectural documentation is sparse or incomplete?

You cannot run a valid codebase review with sparse or inconsistent documentation, as the parallel review process halts early if underlying architectural specs and invariants are too insufficient to support a valid assessment.

How does parallelized codebase review work for assessing architectural consistency?

Parallelized codebase review dispatches four focused reviewer agents simultaneously to evaluate substrate alignment, code structure, library-native patterns, and agent-readiness, synthesizing their findings into a single thesis-led report with actionable recommendations.

When do I need an architecture review for my repository?

You need an architecture review when planning a major refactor, onboarding to a legacy codebase, or auditing for hidden architectural drift before high-stakes changes to ensure the system can scale development without relying on founder memory.

Does codebase review work for pre-change health checks on specific subsystems?

Codebase review works for pre-change health checks by applying named subsystem cohesion audits to validate architectural consistency before major feature work, ensuring intended system boundaries and invariants are correctly enforced.