architect-first

Validate architectural decisions through documentation, multi-agent review, and zero-coupling checks.

Updated May 25, 2026
One-click install
npx skills add https://github.com/FelipeMaines/ProjetoWeb --skill architect-first-felipemaines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-first
Source: https://github.com/FelipeMaines/ProjetoWeb/tree/main/.claude/skills/architect-first
Command: npx skills add https://github.com/FelipeMaines/ProjetoWeb --skill architect-first-felipemaines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

It prevents architectural drift and fragile implementations by forcing complete design and documentation before code, then validating structural choices through multi-agent review and test-backed execution.

Core Features & Use Cases

  • Architecture Flow with hard stop rules: Stops implementation when documentation is missing, capability is reduced, or coupling is detected.
  • Multi-agent validation & decision rationale: Requires review by Product Owner, Architect, and User/Stakeholder before structural decisions are finalized.
  • Zero-coupling and config externalization: Enforces independence between expansion packs and requires mutable configuration to be externalized to YAML.
  • Test-driven safety net (escape hatch): Allows pragmatic “ugly/rapid” code only when tests and logging/observation points are in place.

Quick Start

Use this skill to define the architecture and acceptance criteria for a new feature (or a refactor), validate it with A/B/C options via stakeholder review, then implement only after documentation is complete and coupling/tests are ready.

Frequently Asked Questions about architect-first

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

FAQPage Schema
How do I prevent architectural drift when adding new features or refactoring modules?

Prevent architectural drift by enforcing complete design documentation before implementation, validating structural choices via multi-agent review, and running zero-coupling checks to ensure module independence.

What is the best way to enforce zero coupling between modules during a structural refactor?

Enforce zero coupling by requiring structural validation checks during the architectural phase, ensuring module independence and capability preservation before any implementation code is written.

How do I externalize mutable configuration to YAML for system architecture decisions?

Externalize mutable configuration to YAML by enforcing it as a non-negotiable architectural rule during the design phase, separating configuration from logic before module implementation begins.

Does multi-agent validation work for architectural decisions affecting system boundaries?

Yes, multi-agent validation requires review by Product Owner, Architect, and User/Stakeholder roles to finalize structural decisions, ensuring capability preservation and reduced implementation risk.

When should I use the rapid code escape hatch during architectural implementation?

Use the rapid code escape hatch only when pragmatic implementation is necessary and a test-driven safety net with logging and observation points is already in place to prevent fragile deployments.

Why does my implementation stop when architectural design documentation is missing?

Implementation stops because the architecture flow uses hard stop rules that block code execution when documentation is missing, coupling is detected, or system capabilities are reduced.