# ln-21-system-design-baseline-builder

Adopt this skill: https://proskills.md/skills/other/levnikolaevich-claude-code-skills-plugins-architecture-suite-skills-ln-21-system

Page: https://proskills.md/skills/other/levnikolaevich-claude-code-skills-plugins-architecture-suite-skills-ln-21-system
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: plugins/architecture-suite/skills/ln-21-system-design-baseline-builder/SKILL.md
size: 8000
upstream: https://github.com/levnikolaevich/claude-code-skills/blob/master/plugins/architecture-suite/skills/ln-21-system-design-baseline-builder/SKILL.md

```text
---
name: ln-21-system-design-baseline-builder
description: "Defines measurable architecture drivers and constraints before system design; edits architecture docs only."
---

# System Design Baseline Builder

**Goal:** Create or update one durable source of truth for the project's architecture-driving requirements and constraints. Change only the approved architecture document; do not design the solution, review a plan, audit implementation, edit product code, or invent missing targets.

**Execution contract:** The checklist defines completion. Track each item internally as `PENDING`, `PROVEN` with evidence, `CLEARED` with evidence its condition is absent, or `UNPROVEN` with a gap; reading, delegation, tool failure, a zero exit status, or a self-reported success is not proof; only the observed outcome is. Reconcile after each section. Before returning, resolve all `PENDING`, count only `PROVEN` and `CLEARED`, and apply verdict and approval rules to every gap.
Preserve intent, scope, and existing authorization. Continue authorized work; ask only for consequential unresolved choices or required external approval. When no one can answer during the run, state the exact question and apply the skill's verdict for the remaining gap instead of waiting or guessing. Scale depth to material risk without skipping checks. Preserve dependency and safety order; otherwise choose an appropriate verification method.
Accept equivalent user or repository evidence; no other skill, named artifact, or complete lifecycle is required. Preserve source requirement and decision IDs. Bind reused evidence to relevant source versions, dirty changes, configuration, and environment; invalidate only affected claims.
On continuation, reconcile task, authorization, current state, and unresolved evidence. For long work, return a compact continuation record or update an already authorized artifact; read-only skills do not persist it. Distinguish artifact readiness, verified behavior, and external-action authority.
Prepare authorized work before required approval. If blocked by an instruction, cite its exact source and unresolved boundary; do not invent approval gates from caution.

## Tool Routing

| Need | Preferred capability | Fallback |
|---|---|---|
| Repository rules and document conventions | Native file reads plus focused search | User-provided convention with an explicit limitation |
| Existing requirements and architecture artifacts | Narrow repository search and direct reads | Conversation evidence marked with its source |
| Current workload or service evidence | Metrics, dashboards, logs, manifests, or checked-in reports | Mark `UNKNOWN`; never manufacture production numbers |
| Current external limits or standards | Official documentation or specifications | Mark the claim `UNVERIFIED` |
| Document mutation | Minimal patch to the approved Markdown artifact | Return `BLOCKED` if no safe writable path is authorized |

Use external research only when a time-sensitive fact changes a constraint. Do not browse for values that must come from product owners, operators, the repository, or measured workload.

## Artifact Rules

- Prefer an existing unambiguous architecture-requirements document.
- Otherwise use `docs/architecture/system-design-baseline.md`.
- Read before writing, preserve unrelated content, and update facts in place instead of creating parallel truth.
- Classify applicability separately as `APPLICABLE` or `NOT_APPLICABLE`, with evidence for exclusions.
- Rank each applicable item as `DRIVER`, `SUPPORTING`, or `INFORMATIONAL`.
- Classify evidence separately as `CONFIRMED`, `ASSUMED`, or `UNKNOWN`.
- Separate observed current values, required targets, hard limits, and future evolution triggers.
- Express quality attributes through observable scenarios and response measures; record undecided targets as missing decisions rather than inventing numbers.
- Treat the baseline as versioned project knowledge, not an immutable promise.

## Checklist

### 1. Establish Scope and Destination

- [ ] Resolve the project, business outcome, intended readers, approved documentation scope, and language.
- [ ] Read applicable repository instructions and inspect Git state so unrelated changes remain untouched.
- [ ] Search for existing requirement, architecture, SLO, recovery, security, cost, and ownership documents.
- [ ] Select one canonical artifact: reuse a clear equivalent or choose the default path; explain why no duplicate will be created.
- [ ] Return `BLOCKED` if the destination is ambiguous and choosing one could split project truth.

### 2. Build the Evidence Ledger

- [ ] Collect business goals, actors, journeys, scope, non-goals, and decision horizon with their sources and confidence for the driver analysis; do not create a second context inventory.
- [ ] Record sources for current workload, data volume, service behavior, platform limits, and existing commitments.
- [ ] Separate repository facts from stakeholder choices and estimates.
- [ ] Detect contradictions between documents, code, configuration, and stated requirements; preserve both claims until resolved.
- [ ] Ask only for choices whose absence materially changes architecture; mark all other gaps `UNKNOWN`.

### 3. Define and Prioritize Architecture Drivers

- [ ] **Business and scope:** Record actors, critical journeys, business horizon, scope, non-goals, and externally committed outcomes.
- [ ] **Demand and data scale:** Record current and target users, rates, concurrency, payloads, growth, retention, and forecast horizon where relevant.
- [ ] **User-observable service quality:** Define SLIs and SLOs for availability, latency, throughput, error rate, correctness, or freshness with measurement windows.
- [ ] **Data semantics and recovery:** Define consistency, ordering, idempotency, reconciliation, durability, backup, RTO, RPO, and acceptable data loss at affected boundaries.
- [ ] **Security, privacy, and compliance:** Define trust boundaries, data classification, residency, access, audit, and destructive-action constraints.
- [ ] **Operations and economics:** Define ownership, operational capacity, cost envelope, supported regions, delivery cadence, and platform or vendor constraints.
- [ ] **Evolution:** Record thresholds, business events, or evidence that justify revisiting an assumption, target, or deferred capability.
- [ ] Separate applicability, criticality, and evidence status; do not use `UNKNOWN` to mean unimportant or `NOT_APPLICABLE`.
- [ ] Prioritize the few scenarios most likely to shape architecture and express each as source/stimulus/environment/artifact/response/measure.

### 4. Write the Baseline

- [ ] Create or update the artifact with: identity and status; business context; scope and non-goals; critical scenarios; workload and data; quality targets; recovery; consistency; security; cost and operations; constraints; assumptions and unknowns; review triggers.
- [ ] Give material parameters their theme, applicability, criticality, evidence status, value/range, source, owner, as-of date, and review trigger. State shared metadata once with explicit inheritance; use `UNKNOWN` for missing ownership or values.
- [ ] Keep calculations reproducible and label estimates separately from observed measurements.
- [ ] Link shared architecture artifacts only by repository path or document title; never require a particular workflow or tool.
- [ ] Preserve historical context needed to understand changed requirements instead of silently rewriting prior commitments.

### 5. Validate and Report

- [ ] Re-read the written artifact and verify that no unknown was converted into a confident fact.
- [ ] Check that targets are measurable, internally consistent, and proportionate to the evidenced business horizon.
- [ ] Check that every architecture-critical gap has an owner or exact next evidence action.
- [ ] Link architecture drivers to their source product requirements; preserve the product source as owner of function
```

## File: README.md
upstream: https://github.com/levnikolaevich/claude-code-skills/blob/master/README.md

````text
# Claude-Codex Skills

Open-source standalone agent skills, distributed as plugins for Claude Code and OpenAI Codex, help turn product ideas, code fixes, architecture reviews and deployments into scoped work with a verifiable result. Each workflow defines what to check, what it may change, and how to report evidence and remaining gaps.

[Project page](https://levnikolaevich.com/projects/claude-code-skills) · [Install](#install) · [Full catalog](#lifecycle-and-plugins)

## Choose a route

Choose by the result you need. Each skill works independently.

| Your task | Plugin | Result |
|---|---|---|
| Is this idea worth building? | `product-discovery-suite` | Opportunity assessment, requirements, or interaction design. |
| How should this system change? | `architecture-suite` | System map, design decision, or migration plan. |
| Is this plan ready to implement? | `delivery-planning-suite` | Reviewed plan, ordered work, and test strategy. |
| Fix, upgrade, simplify, or speed up this code. | `implementation-suite` | Scoped change with behavior and benefit checks. |
| Set up lint, type or architecture checks that enforce project rules. | `implementation-suite` | Verified quality gates, with project compliance reported separately. |
| What could go wrong with this delivery or codebase? | `quality-assurance-suite` | Evidence-backed findings or scoped acceptance tests. |
| Get this change published or deployed. | `delivery-suite` | Authorized publication or deployment, verified at its destination. |
| Why did this fail, or did the feature help? | `operations-suite` | Incident diagnosis or product outcome assessment. |
| Can I trust the instructions in this skill? | `skill-maintenance-suite` | Skill boundaries, consistency, and distribution review. |
| Prepare Docker containers, configuration, access control or recovery. | `engineering-foundation-suite` | Native technical contracts and verified changes. |

## Install

For a feature or fix, start with `implementation-suite`. Replace it with another plugin from [Choose a route](#choose-a-route) for a different task.

Claude Code:

```text
/plugin marketplace add levnikolaevich/claude-code-skills
/plugin install implementation-suite@levnikolaevich-skills-marketplace
/reload-plugins
```

Codex:

```text
codex plugin marketplace add levnikolaevich/claude-code-skills
codex plugin add implementation-suite@levnikolaevich-skills-marketplace
```

Invoke a skill by its full name: `/implementation-suite:ln-41-surgical-change-implementer` in Claude Code or `$ln-41-surgical-change-implementer` in Codex, followed by your task. For example: “Fix the total calculation when an item has a discount. Preserve the current rounding rules.”

For personal defaults shared by Claude Code and Codex, use the optional [user instructions template and connection guide](templates/user-instructions/README.md). Personalize and merge it into your existing configuration; plugin installation does not change global instructions.

## Lifecycle and plugins

### Product Discovery Suite

Decide what is worth building, who it serves, and what a useful first version must do.

| Index | Skill | Purpose |
|---:|---|---|
| 11 | [Opportunity Evaluator](plugins/product-discovery-suite/skills/ln-11-opportunity-evaluator/SKILL.md) | Evaluates new product opportunities through demand, channels and economics before committing to build. |
| 12 | [Product Requirements Builder](plugins/product-discovery-suite/skills/ln-12-product-requirements-builder/SKILL.md) | Defines product requirements, business rules and acceptance criteria for a committed intent; edits product docs only. |
| 13 | [Interaction Design Builder](plugins/product-discovery-suite/skills/ln-13-interaction-design-builder/SKILL.md) | Designs user flows, interaction states and mockups for a defined product scope; does not implement UI code. |

### Architecture Suite

Understand the system you have and choose changes with clear boundaries, tradeoffs, and recovery paths.

| Index | Skill | Purpose |
|---:|---|---|
| 21 | [System Design Baseline Builder](plugins/architecture-suite/skills/ln-21-system-design-baseline-builder/SKILL.md) | Defines measurable architecture drivers and constraints before system design; edits architecture docs only. |
| 22 | [Current Architecture Documenter](plugins/architecture-suite/skills/ln-22-current-architecture-documenter/SKILL.md) | Documents current architecture from implementation evidence; does not propose a target or audit fitness. |
| 23 | [System Design Proposal Builder](plugins/architecture-suite/skills/ln-23-system-design-proposal-builder/SKILL.md) | Designs target system boundaries, contracts and tradeoffs from requirements; does not plan tasks or implement. |
| 24 | [Architecture Decision Recorder](plugins/architecture-suite/skills/ln-24-architecture-decision-recorder/SKILL.md) | Records one architecture decision with alternatives, consequences and status; does not design the whole system. |
| 25 | [Architecture Diagram Builder](plugins/architecture-suite/skills/ln-25-architecture-diagram-builder/SKILL.md) | Creates evidence-backed current or target architecture diagrams; not UI design. |
| 26 | [Architecture Migration Planner](plugins/architecture-suite/skills/ln-26-architecture-migration-planner/SKILL.md) | Plans architecture migrations with compatibility, data safety, rollout and recovery; does not execute them. |

### Delivery Planning Suite

Find missing decisions and risky dependencies before they become implementation rework.

| Index | Skill | Purpose |
|---:|---|---|
| 31 | [Delivery Plan Builder](plugins/delivery-planning-suite/skills/ln-31-delivery-plan-builder/SKILL.md) | Builds dependency-ordered delivery plans from requirements and repository evidence; read-only. |
| 32 | [Test Strategy Planner](plugins/delivery-planning-suite/skills/ln-32-test-strategy-planner/SKILL.md) | Plans risk-based test portfolios and acceptance evidence; does not write or execute tests. |
| 33 | [Plan Reviewer](plugins/delivery-planning-suite/skills/ln-33-plan-reviewer/SKILL.md) | Reviews a concrete implementation plan for missing decisions, feasibility and risk before execution; read-only. |

### Implementation Suite

Fix the cause, reuse what already works, and keep changes focused on a verified outcome.

| Index | Skill | Purpose |
|---:|---|---|
| 41 | [Surgical Change Implementer](plugins/implementation-suite/skills/ln-41-surgical-change-implementer/SKILL.md) | Implements one scoped product feature or fix using existing contracts; not upgrades, performance tuning or establishing cross-cutting technical foundations. |
| 42 | [Dependency Upgrader](plugins/implementation-suite/skills/ln-42-dependency-upgrader/SKILL.md) | Upgrades dependencies in reversible batches with version-specific compatibility and regression checks. |
| 43 | [Code Modernizer](plugins/implementation-suite/skills/ln-43-code-modernizer/SKILL.md) | Modernizes a bounded capability to reduce demonstrated maintenance cost; not routine upgrades or performance tuning. |
| 44 | [Performance Optimizer](plugins/implementation-suite/skills/ln-44-performance-optimizer/SKILL.md) | Profiles and improves a measured performance bottleneck; retains only verified improvements. |
| 45 | [Benchmark Comparator](plugins/implementation-suite/skills/ln-45-benchmark-comparator/SKILL.md) | Compares tools or implementations through controlled benchmarks and independent correctness checks. |
| 46 | [Quality Gate Engineer](plugins/implementation-suite/skills/ln-46-quality-gate-engineer/SKILL.md) | Configures and verifies lint, type, architecture and other engineering checks; not product cleanup, policy invention or deployment redesign. |

### Quality Assurance Suite

Find gaps that could break a release, mislead a maintainer, or make a passing test meaningless.

| Index | Skill | Purpose |
|---:|---|---|
| 51 | [Acceptance Test Builder](plugins/quality-assurance-suite/skills/ln-51-acceptance-test-builder/SKILL.md) | Builds, upda
````
