architecture-review

Assess architecture proposals against stack fit, cost, and failure modes.

24|3|Updated Mar 31, 2022
One-click install
npx skills add https://github.com/ionfury/homelab --skill architecture-review-ionfury
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/ionfury/homelab/tree/main/.claude/skills/architecture-review
Command: npx skills add https://github.com/ionfury/homelab --skill architecture-review-ionfury

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Architecture evaluation criteria and technology standards for the homelab. Preloaded into the designer agent to ground design decisions in established patterns and principles.

Core Features & Use Cases

  • Comprehensive evaluation criteria covering Principle Alignment, Stack Fit, Operational Cost, Complexity Budget, Alternative Analysis, and Failure Modes.
  • Applicable during technology additions, architecture reviews, and stack-fit assessments to promote reproducible, GitOps-friendly decisions.
  • See references for rationale and patterns used to guide decisions across Talos-based and Kubernetes-based environments.

Quick Start

Use the framework to assess a technology proposal and generate a structured decision rationale.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I standardize architecture review criteria for Kubernetes infrastructure proposals?

Standardize architecture review criteria by applying a formal evaluation framework assessing principle alignment, stack fit, operational cost, complexity budget, alternative analysis, and failure modes to generate reproducible decision rationale for Kubernetes infrastructure proposals.

What evaluation framework should I use for technology additions in GitOps environments?

Use an extensible architecture evaluation framework to assess technology additions in GitOps environments. It evaluates proposals against defined principles, stack compatibility, operational costs, alternative options, and specific failure modes to ensure reproducible decisions.

Does this architecture governance framework work for Talos-based bare-metal stacks?

Yes, this architecture governance framework explicitly supports Talos-based bare-metal stacks. It applies stack-fit assessments and evaluation criteria to standardize design rationale and operational costs across Talos and Kubernetes-based environments.

How do I evaluate operational cost and complexity budget for a new infrastructure component?

Evaluate operational cost and complexity budget by running the proposed infrastructure component through a formal architecture review. The framework enforces assessment of these factors alongside stack fit and failure modes to generate structured decision rationale.

When should I use a formal decision framework for stack-fit assessments?

Use a formal decision framework for stack-fit assessments during technology additions and architecture reviews. It grounds design decisions in established patterns, enforcing alternative analysis and failure mode evaluation to maintain reproducible, GitOps-friendly infrastructure standards.