architecture-baseline

Interviews the architect to produce a ratified architecture baseline with budgets and fitness functions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before any code is written, parallel feature implementations tend to invent divergent patterns — different models of the same entity, different error conventions, different answers to failure cases. This Skill converts the user-facing guarantees from an experience baseline into binding system guarantees, so every feature built afterwards follows the same architecture. ## Core Features & Use Cases - Structured architect interview: Walks through seven sections — foundations re-check, stack and boundaries, cross-cutting mechanisms, non-functional budgets, build order, fitness functions, and deliberate deferrals — each recording the divergence it prevents. - Guarantee conversion: Translates experience-baseline promises (e.g., offline capture loses nothing) into concrete system mechanisms, budgets with hedges and sources, and checkable fitness functions. - Gate and ratification workflow: Writes a completeness/checkability/coherence checklist, enforces marker rules ([NEEDS DECISION], [NEEDS LOOKUP], etc.), and manages Draft/Ratified status with a decision register. - Use Case: After product specs, technical constraints, and an experience baseline exist for a project, run this Skill to finalize the architecture document at .specify/memory/architecture.md before the build starts. ## Quick Start Ask the assistant to run the architecture-baseline skill to finalize the project's architecture now that the specifications, constraints, and experience baseline are complete.

Frequently Asked Questions about architecture-baseline

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

FAQPage Schema
How do I finalize a software architecture before writing code?▼

Run this Skill after product specifications, technical constraints, and an experience baseline exist. It interviews the architect through seven sections — foundations, stack, cross-cutting mechanisms, budgets, build order, fitness functions, and deferrals — and writes a ratifiable architecture document.

What is an architecture fitness function?▼

A fitness function is an invariant written so a violation can be detected by reading a diff, running a test, or grepping a tree, such as "no request handler reaches storage directly." Invariants that cannot be automated are recorded separately with the non-automated control that substitutes.

Can I run the architecture baseline without an experience baseline?▼

No. The Skill stops if the experience baseline is missing, because it converts user-facing guarantees into system guarantees and would otherwise invent them. It offers to run the experience-baseline skill first, and proceeds only if the architect explicitly accepts guessed figures.

What happens to unresolved decisions in the architecture document?▼

Blocking markers like [NEEDS DECISION] or [NEEDS LOOKUP] must be resolved or parked under Deliberately deferred with a reopening trigger, named fetcher, and due date. Unparked blocking markers prevent the document from being ratified.

When should the architecture baseline be amended?▼

Amend it whenever building reveals the baseline is wrong, recording each change as a supersession in the decision register and bumping the version. If a later gate evaluation fails, the document returns to Draft status rather than staying falsely ratified.