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.