| name | architecture-review |
| description | Review high-level design choices in the home-ops repository. Use when evaluating tradeoffs, compare implementation approaches, assess whether a proposed change fits existing repo principles, or recommend a direction before any manifests, Terraform, or Just recipes are edited. Do not use this skill for direct implementation work. |
Home Ops Architecture Review
Overview
Use this skill for design review, not implementation. Focus on fit with repo principles, operational burden, failure modes, and reuse of existing patterns.
Workflow
- Read the root guide and the nearest subtree guide for the area being discussed.
- Rebuild the current local pattern before proposing anything new.
- Load only the needed reference:
references/evaluation.mdreferences/output.md
- Present 2-3 viable options when the decision is non-trivial.
- Recommend one option and explain why.
Scope Boundaries
- Do not write the implementation as part of this skill.
- Use this skill before editing when the user is asking what should be built, not how to patch the files.
- When the user wants the change carried out, switch to the appropriate domain skill after the design is settled.
