architect-first

Validate system changes through documentation and multi-agent checks before implementation.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/fabiolpgomes/lodgra --skill architect-first-fabiolpgomes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-first
Source: https://github.com/fabiolpgomes/lodgra/tree/main/.agents/skills/architect-first
Command: npx skills add https://github.com/fabiolpgomes/lodgra --skill architect-first-fabiolpgomes

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill solves the problem of chaotic, uncoordinated development by enforcing a strict Architect-First philosophy, ensuring that structural decisions are documented, validated, and tested before a single line of implementation code is written.

Core Features & Use Cases

  • Architectural Validation: Provides a structured workflow to map, document, and validate system changes before implementation.
  • Quality Gates: Enforces non-negotiable standards like zero-coupling and multi-agent validation to prevent technical debt.
  • Use Case: When planning a major refactor of the Lodgra property management system, use this Skill to generate an ADR, validate the design against the zero-coupling script, and ensure all previous capabilities are preserved.

Quick Start

Use the architect-first skill to validate the proposed architecture for the new booking synchronization module by following the pre-implementation checklist.

Frequently Asked Questions about architect-first

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

FAQPage Schema
How do I enforce architectural validation before refactoring a complex system?

Architectural validation enforces structural integrity by mapping, documenting, and validating system changes through a pre-implementation checklist before any code is written. This prevents technical debt by ensuring design decisions are tested.

What is the architect-first philosophy for software development?

The architect-first philosophy is a development approach mandating that all structural decisions are documented, validated, and tested before implementation begins. It solves chaotic development by enforcing quality gates like zero-coupling principles.

How do I prevent technical debt when designing new features?

Prevent technical debt during new feature design by enforcing non-negotiable quality gates such as zero-coupling principles and multi-agent validation. This ensures structural decisions are validated against strict architectural standards.

Can I use pyyaml for architectural documentation and validation?

Yes, the workflow requires pyyaml as a dependency to implement the architect-first validation process. It processes the structured documentation and validation scripts required to enforce modularity and quality assurance.

Does zero-coupling validation work for major system refactoring?

Zero-coupling validation works for major system refactoring by ensuring all previous capabilities are preserved. It validates the proposed architecture against strict modularity rules before implementation begins.

When should I not use an architect-first approach?

You should not use an architect-first approach for rapid prototyping or experimental changes where strict documentation, zero-coupling principles, and test-driven safety nets would create unnecessary overhead for minor modifications.