fix-architecture

Fixes architectural flaws from agentic-architecture reports via a test-first workflow.

92|9|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/Ovid/paad --skill fix-architecture-ovid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-architecture
Source: https://github.com/Ovid/paad/tree/main/plugins/paad/skills/fix-architecture
Command: npx skills add https://github.com/Ovid/paad --skill fix-architecture-ovid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guided iterative workflow to fix architectural flaws identified by /paad:agentic-architecture. Loads an existing architecture report, walks the developer through selecting and prioritizing flaws, then fixes them one at a time with a test-first workflow. Updates the report with status tracking so the skill can be re-run across multiple sessions.

Core Features & Use Cases

  • Guided, iterative flaw fixing from architecture reports
  • Load and track status in paad/architecture-reviews/
  • Apply fixes with test-first workflow and developer approval

Quick Start

Start a new session with /paad:fix-architecture to load the latest architecture report and begin the guided fix workflow.

Frequently Asked Questions about fix-architecture

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

FAQPage Schema
How do I fix architectural flaws identified in a code review report?

Fix architectural flaws by loading an existing architecture report, prioritizing flaws, and applying a guided, test-first workflow. This process updates the report with status tracking, enabling iterative fixes across multiple development sessions.

What is a test-first workflow for fixing architecture flaws?

A test-first workflow for architecture flaws enforces pre-flight checks and safety-net test creation before applying fixes. It uses a stepwise Fix Loop with validation and commit handling to ensure code quality.

How do I prioritize and track architecture fixes across multiple sessions?

Prioritize and track architecture fixes across sessions by loading and updating status in architecture review reports. The guided workflow saves progress, allowing you to resume flaw fixing in new sessions.

Can I apply architecture fixes one at a time on feature branches?

Yes, you can apply architecture fixes one at a time on feature branches. The guided workflow walks developers through selecting individual flaws and implementing fixes with developer approval at each step.

Do I need an existing architecture report to start fixing code flaws?

Yes, you need an existing architecture report to start fixing code flaws. The workflow loads identified flaws from a prior architecture review session to prioritize and guide the test-first fixing process.