Audits codebase structure against the architect blueprint for orphaned work, deviations, and risks.
npx skills add https://github.com/Vimurai/ai-os --skill arch-review-vimurai
Please help me install this Agent Skill. Skill: arch-review Source: https://github.com/Vimurai/ai-os/tree/main/.claude/skills/arch-review Command: npx skills add https://github.com/Vimurai/ai-os --skill arch-review-vimurai
src/ as ALIGNED, ORPHANED, or DEVIATED relative to architect.md. - Coverage and Ambiguity Checks: Flags blueprint sections with no implementation and vague sections that are unsafe to implement. - Dependency and Risk Review: Verifies new dependencies have DECISIONS.md entries and produces a Top 3 architectural risks list with recommended P-## tasks. - Use Case: Before merging a large feature branch, run the audit to confirm every new module is covered by the blueprint and record an ARCH_AUDIT stamp in the project review log via MCP. ## Quick Start Ask the AI to run an architectural review auditing the current codebase against the blueprint before the next major commit.High-intent search queries and answers about installing and using this skill.
Run an architectural audit that compares each implemented feature in the source directory against sections of the blueprint document. Features are classified as aligned, orphaned, or deviated, and missing implementations are flagged as candidates for new engineering tasks.
The report contains an alignment summary, coverage gaps, ambiguous blueprint sections, the top three architectural risks with mitigations, and recommended planning tasks. It is output as structured Markdown and recorded as an ARCH_AUDIT stamp via the task-synchronizer MCP tool.
No. The audit is read-only for source code and must not write to src/ or append directly to REVIEWS.md, which is a generated view. Findings are recorded only through the MCP add_stamp interface to keep state consistent.
Run it before major commits, when the user requests an architectural review, or when checking blueprint alignment after significant implementation work. It is most useful when multiple agents or contributors have changed the codebase since the last audit.
The audit operates at the architectural level, so it compares the directory structure against blueprint sections rather than reviewing line-level code. This keeps the review fast and focused on alignment, coverage, and risk rather than implementation detail.
hadimiftahulfGenerates and maintains README, API specifications, and Architecture Decision Records.
yknothingIdentify and document delivery risks into a prioritized risk register with mitigations.
harshitsinghbhandariReview GitHub PRs, local branches, and diffs for code quality and security.
emilianoeloiConverts documented architecture rules into automated fitness function tests across multiple stacks.