architecture-foundations

Interviews architects to capture constraints, shared domain models, interface contracts, and authority models.

22|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/handarbeit/fabrik --skill architecture-foundations-handarbeit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-foundations
Source: https://github.com/handarbeit/fabrik/tree/main/plugin/entwurf/skills/architecture-foundations
Command: npx skills add https://github.com/handarbeit/fabrik --skill architecture-foundations-handarbeit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Specifications written weeks apart drift silently: two specs model the same entity differently, state vocabularies diverge, and nobody owns shared fields. This Skill interviews the technical architect to capture immovable constraints, a shared domain model with per-field ownership, interface contracts, and an authority model before experience design begins. ## Core Features & Use Cases - Constraint capture: Records existing systems, regulatory obligations, platform commitments, team reality, and non-negotiables, each with what it forces. - Shared domain model derivation: Runs three passes over specs (declared entities, undeclared nouns, contested fields) to assign field ownership and flag entities no feature could own as missing specifications. - Authority and contract modeling: Documents disclosure classes per authority type and cross-feature handoffs naming the triggering state. - Living document management: Amends .specify/memory/architecture.md in place on re-runs, preserving stage-5 sections, ratification footers, and prior checklist evaluations. - Use Case: After the first few feature specs exist, run this to produce a versioned architecture baseline that later specs anchor to, then re-run it whenever a new spec introduces an entity, state, or authority. ## Quick Start Ask the assistant to run the architecture-foundations interview against the existing specs to draft the shared domain model and constraints document.

Frequently Asked Questions about architecture-foundations

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

FAQPage Schema
How do I keep multiple feature specifications from drifting on shared entities?

Run this interview to build a shared domain model that records, for every field, which feature owns it, which write it, and which only read it. Entities used by more than one spec but defined by none are flagged as missing specifications addressed to the product owner.

When should the architecture foundations interview run?

Run it as soon as the first few specifications exist, before experience design begins. Re-run it whenever a new specification introduces an entity, a state, or an authority, leading with what changed rather than starting over.

What topics does the architecture interview cover?

Ten topics: existing systems, regulatory obligations, platform commitments, team reality, non-negotiables, the shared domain model, shared state vocabularies, interface contracts, the authority model with disclosure classes, and where the design is free.

Does this skill decide technology stacks, budgets, or build order?

No. Budgets, mechanisms chosen for qualities like performance or scale, build order, and fitness functions are deliberately deferred to stage 5, because they depend on the experience baseline that does not exist yet.

What happens on a re-run after the architecture document is ratified?

Foundations are edited in place without touching stage-5 design sections or the sign-off footer. If the document was Ratified, an amendment note records which version the sign-off covers, and stage 5 must re-run to restore coverage.