architecture-parity-review

Audit Claude Code transcripts to verify ARCHITECTURE.md parity with implemented decisions.

9|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/DavidTeju/shared-skills --skill architecture-parity-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-parity-review
Source: https://github.com/DavidTeju/shared-skills/tree/main/skills/architecture-parity-review
Command: npx skills add https://github.com/DavidTeju/shared-skills --skill architecture-parity-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture parity ensures ARCHITECTURE.md stays in sync with decisions documented during feature work and audits, helping teams align implementation with governance.

Core Features & Use Cases

  • Cross-reference transcripts against ARCHITECTURE.md to surface drift and misalignments
  • Spawn parallel agents to audit decisions across sessions and projects
  • Generate ARCHITECTURE_PARITY_REPORT.md with gaps and recommended updates
  • Project-specific to Flow budget tracking app

Quick Start

Run the parity analysis on the latest project transcript to generate ARCHITECTURE_PARITY_REPORT.md

Frequently Asked Questions about architecture-parity-review

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

FAQPage Schema
How do I audit Claude Code transcripts to verify ARCHITECTURE.md parity with implemented decisions?

To audit Claude Code transcripts for ARCHITECTURE.md parity, you cross-reference session transcripts against the documented architecture to surface drift and misalignments. This process enforces cross-reference checks and generates a synthesized parity report with documented gaps and recommended updates.

What is architecture parity and when do I need to audit my project transcripts?

Architecture parity ensures ARCHITECTURE.md stays in sync with decisions documented during feature work. You need to audit project transcripts during major feature rollouts, periodic audits, and new-team onboarding to align implementation with governance.

How do I generate an architecture parity report with gaps and recommended updates?

You generate an architecture parity report by running parity analysis on project transcripts, which spawns parallel agents to audit decisions across sessions and projects. The analysis outputs an ARCHITECTURE_PARITY_REPORT.md file detailing documented gaps and recommended updates.

Can I use parallel agents to audit architecture decisions across multiple sessions?

Yes, you can spawn parallel agents to audit architecture decisions across multiple sessions and projects. This parallel-agent analysis verifies ARCHITECTURE.md parity against implemented decisions and synthesizes findings into a comprehensive parity report.

Does the architecture parity audit work for any software project or is it project-specific?

The architecture parity audit is currently project-specific to the Flow budget tracking app. It enforces cross-reference checks and parallel-agent analysis tailored to this context to surface drift and misalignments effectively.

Why does my ARCHITECTURE.md drift from implemented decisions during feature rollouts?

ARCHITECTURE.md drifts from implemented decisions when session transcripts document changes that are not reflected in the architecture file. Cross-referencing transcripts against ARCHITECTURE.md surfaces this drift and misalignment for governance alignment.