architect-first

Guide implementation of Architect-First development with design, documentation, and tests.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/Gabrielloopes33/utem1 --skill architect-first-gabrielloopes33
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-first
Source: https://github.com/Gabrielloopes33/utem1/tree/main/.claude/skills/architect-first
Command: npx skills add https://github.com/Gabrielloopes33/utem1 --skill architect-first-gabrielloopes33

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires architecture_validator.py, check_coupling.py, validate_risk_mitigation.py, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill enforces a disciplined development process, ensuring robust architecture and high-quality code by mandating design and documentation before implementation.

Core Features & Use Cases

  • Architectural Design: Guides the creation of perfect, well-documented architectures.
  • Quality Gates: Enforces non-negotiable standards like zero coupling and capability preservation.
  • Pragmatic Execution: Allows for negotiable code quality if backed by tests.
  • Use Case: When starting a new complex feature, use this Skill to ensure the architecture is sound, validated, and documented before any code is written, preventing costly rework later.

Quick Start

Use the architect-first skill to map the current architecture before starting a new feature.

Frequently Asked Questions about architect-first

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

FAQPage Schema
How do I ensure software architecture design is validated before writing code?

Validating software architecture before coding requires mapping the current architecture, enforcing zero coupling, and completing design documentation. This approach mandates multi-perspective validation for architectural decisions to prevent costly rework during new feature implementation or system refactoring.

What is the architect-first development philosophy for software engineering?

The architect-first development philosophy enforces complete design and documentation preceding code, ensuring perfect architecture and pragmatic execution. It mandates non-negotiable principles like zero coupling and multi-perspective validation for architectural decisions.

How do I enforce zero coupling and quality assurance in a software development process?

Enforcing zero coupling and quality assurance in a software development process requires architectural validation checks and mandated tests. This ensures robust architecture and high-quality code by treating design documentation as a non-negotiable prerequisite before implementation.

Can I allow negotiable code quality during software refactoring while maintaining architecture standards?

Yes, you can allow negotiable code quality during software refactoring if it is backed by tests. This pragmatic execution approach maintains strict architectural standards and capability preservation while permitting flexibility in implementation details.

When do I need to map current architecture before starting a new complex feature?

You need to map current architecture before starting a new complex feature to ensure the design is sound, validated, and documented. This prevents costly rework later by enforcing design completion and quality gates prior to any code implementation.