architect-first

Enforce architectural documentation and multi-agent validation before code implementation.

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

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 technical debt and architectural drift by enforcing a rigorous, multi-agent validation process that ensures design and documentation precede implementation.

Core Features & Use Cases

  • Quality Gates: Enforces non-negotiable architectural documentation and multi-agent validation before any code is written.
  • Zero-Coupling Validation: Uses automated scripts to ensure expansion packs remain independent and modular.
  • Use Case: When refactoring a complex system, use this skill to map the current state, present A/B/C architectural options, and ensure the new design maintains all previous capabilities before starting development.

Quick Start

Use the architect-first skill to validate the proposed architecture for the new feature by running the architecture validator script against the design document.

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 during complex system refactoring?

Prevent architectural drift by mandating architectural documentation and running multi-agent validation before code implementation. This process maps the current state, presents A/B/C options, and verifies new designs maintain previous capabilities before development starts.

What is the architect-first development philosophy for structural system changes?

The architect-first development philosophy is a process enforcing zero-coupling validation, configuration externalization, and test-driven safety nets. It requires design validation and automated scripts to ensure expansion packs remain independent and modular before structural changes begin.

How do I validate zero-coupling and modularity before writing new feature code?

Validate zero-coupling and modularity by running automated architecture validator scripts against your design document. This ensures expansion packs remain independent and externalizes configuration before any new feature code implementation begins.

Does this architecture validation approach require specific dependencies or environment setup?

This architecture validation approach requires the pyyaml dependency to function. You need to prepare your architectural design documents and configuration files to satisfy the externalization requirements before running the validation scripts.

When should I not use multi-agent validation for refactoring tasks?

You should not use multi-agent validation for simple, non-structural code changes that do not impact system modularity. The process is designed for structural system changes, complex refactoring, and new feature development where architectural drift is a risk.