verify-architecture

Validate plan.md architecture decisions against GOAL.md and SPEC.md criteria.

28|2|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/labs21-dev/agents-stack --skill verify-architecture-labs21-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verify-architecture
Source: https://github.com/labs21-dev/agents-stack/tree/main/templates/.agents/skills/using-agents-stack/verify-architecture
Command: npx skills add https://github.com/labs21-dev/agents-stack --skill verify-architecture-labs21-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Verifies that every architecture decision in plan.md serves the defined goal and acceptance criteria, preventing drift and misalignment before task breakdown.

Core Features & Use Cases

  • Architecture Trace validation aligning plan decisions with GOAL.md success criteria and SPEC.md ACs.
  • Orphan decision detection and route guidance to plan for trace completion.
  • Coverage checks ensuring all Success Criteria are represented in architecture decisions.
  • Early feedback and guardrails to avoid over-engineering and scope creep.

Quick Start

Verify that the current workstream plan adheres to the architecture-goal alignment by running the architecture checkpoint for the active spec.

Frequently Asked Questions about verify-architecture

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

FAQPage Schema
How do I validate architecture decisions against goals before task breakdown?

Architecture trace validation aligns plan decisions with GOAL.md success criteria and SPEC.md acceptance criteria. It checks traceability across plan, spec, and goal, flagging orphan decisions to prevent drift before task breakdown begins.

What is architecture traceability and when do I need it?

Architecture traceability ensures every architecture decision serves defined goals and acceptance criteria. You need it when orchestrating workflows with SPEC.md, GOAL.md, and plan.md to prevent scope creep and misalignment.

How do I detect orphan architecture decisions in my spec?

Orphan decision detection identifies architecture choices in plan.md that lack traceability to GOAL.md or SPEC.md. It provides route guidance back to plan for trace completion, ensuring all decisions serve defined goals.

Does this architecture audit require SPEC.md and GOAL.md files?

Yes, this architecture audit applies to orchestration workflows containing SPEC.md, GOAL.md, and plan.md. These files provide the success criteria and acceptance criteria needed to validate architecture decision coverage and alignment.

What happens when architecture coverage checks fail?

When checks fail, the process provides clear failure routing hints and withholds outputs arch-report.md and status.json. It routes you back to complete missing traceability between architecture decisions and success criteria.

Why does architecture drift happen and how to prevent it early?

Architecture drift happens when decisions lack traceability to goals and acceptance criteria. Early feedback guardrails prevent over-engineering by validating coverage of all success criteria in architecture decisions before task breakdown.