architecture-parity-review

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

9|2|Updated Mar 5, 2026

Search Tags:#automation #architecture #audit #docs #report #transcripts #parity

Ready to run

npx skills add https://github.com/DavidTeju/shared-skills --skill architecture-parity-review

💬 Prompt for ChatGPT / Claude Chat▼

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.