architecture-review

Score proposed technology additions against a homelab architecture framework.

1|Updated Apr 6, 2025
One-click install
npx skills add https://github.com/david-driscoll/stargate-command-cluster --skill architecture-review-david-driscoll
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/david-driscoll/stargate-command-cluster/tree/main/.agents/skills/architecture-review
Command: npx skills add https://github.com/david-driscoll/stargate-command-cluster --skill architecture-review-david-driscoll

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents ad-hoc technology decisions by providing a consistent, production-style evaluation framework for additions and architecture changes.

Core Features & Use Cases

  • Principle-aligned scoring: Scores changes against enterprise-at-home standards like GitOps readiness, automation, and reuse.
  • Stack fit and overlap checks: Ensures new components integrate with the existing Flux-based GitOps workflow and avoids duplicating overlapping tools.
  • Operational and failure-mode requirements: Enforces day-1 observability expectations and requires a recovery story for failure scenarios.
  • Anti-pattern enforcement: Flags common mistakes like “monitoring later,” cloud-only dependencies, and unmonitored one-off containers.

Quick Start

Use the architecture-review skill to review a proposed component and receive a structured, criteria-based recommendation before committing changes.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I evaluate if a new technology fits my Kubernetes homelab stack?

To evaluate if a new technology fits your Kubernetes homelab stack, use an architecture review framework that scores additions across principle alignment, stack fit, operational cost, and failure modes. This prevents ad-hoc design choices by enforcing production-style guardrails.

What is architecture review for bare-metal Kubernetes environments?

Architecture review for bare-metal Kubernetes environments is a consistent evaluation framework that audits design decisions for multi-cluster, Flux-driven setups. It scores proposed technology additions against enterprise-at-home standards like GitOps readiness, automation, and reuse to ensure stack compatibility.

How do I check a proposed component against Flux GitOps anti-patterns?

To check a proposed component against Flux GitOps anti-patterns, apply an architecture review that explicitly flags missing day-1 monitoring, cloud-only vendor lock-in, and unmonitored one-off containers. This ensures new tools integrate with existing workflows without duplicating overlapping tools.

Does my homelab design decision require a failure mode analysis?

Your homelab design decision requires a failure mode analysis if it involves adding technology to a multi-cluster Kubernetes stack. An architecture review enforces day-1 observability expectations and requires a recovery story for failure scenarios before you commit changes.

What is the best way to compare technologies for a homelab architecture?

The best way to compare technologies for a homelab architecture is to score alternatives against a complexity budget and operational cost. An architecture review framework provides a structured, criteria-based recommendation by analyzing alternatives and checking for stack overlap before committing.

When should I not use an architecture review framework for stack changes?

You should not skip an architecture review framework for stack changes when managing multi-cluster, Flux-driven Kubernetes environments, as it prevents unmonitored containers. However, for trivial changes well within your existing complexity budget, a full criteria-based evaluation may be unnecessary.