system-architect
Skill5 starsChanged 42 days agoMITView on GitHub
Forces data-model-first thinking before service boundaries or code, treating the schema as the geological layer everything else sits on. Now with mathematical depth metrics, architecture risk calculus, boundary integrity , and verification gates.
32 other projects use a version of this.
Adopted by
Most recently taken up by
- TehseenTech/manus-skillstheir own version, first seen Nov 8, 2026
- letscooktech-studio/ai-engineering-arsenaltheir own version, first seen Nov 8, 2026
- crankyjediii/vibecrafttheir own version, first seen Nov 8, 2026
- letscooktech-studio/outcomelabtheir own version, first seen Nov 8, 2026
- nizaalkhot/skillstheir own version, first seen Nov 1, 2026
- kcayme/k-agentstheir own version, first seen Nov 1, 2026
Used with
Projects with it also use database-architect, webapp-testing and 4 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
xfstudioSkilldatabase-architect
Expert database architect specializing in data layer design from
Also in 3 projects that use this
JetBrainsSkillwebapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
Also in 4 projects that use this
Microsoft AzureSkillgit-workflow
Squad branching model: dev-first workflow with insiders preview channel
Also in 3 projects that use this
BlockSkillfrontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
Also in 5 projects that use this
MicrosoftSkillmcp-builder
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
Also in 3 projects that use this
SentrySkillskill-creator
Create new agent skills following the Agent Skills specification. Use when asked to "create a skill", "add a new skill", "write a skill", "make a skill", "build a skill", or scaffold a new skill with SKILL.md. Guides through requirements, writing, registration, and verification.
Also in 5 projects that use this
Other versions32 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 32
- nahisaho/MUSUBI★ 74same name
- wonderslife/pdd-skills★ 41same name
- NatureBlueee/Nature-use-skills★ 39same name
- georgekhananaev/claude-skills-vault★ 28same name
- wonderslife/pdd-skills-v3★ 15same name
- boxclawai/skills★ 9same name
- letscooktech-studio/ai-engineering-arsenal★ 7same name
- letscooktech-studio/outcomelab★ 7same name
- vignesh2027/Claude-Agentic-Skills2.0-version★ 6same name
- catch-the-wave/fullstack-ios-claude-skills★ 5same name
22 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository28 other files it gives its agents.
- api-designerSkill
- copy-engineerSkill
- adversarySkill
- anchorSkill
- boundary-detectorSkill
- clarifySkill
- conductorSkill
- contradictSkill
- deep-thinkSkill
- descendSkill
- divergeSkill
- emergenceSkill
- excavateSkill
- fidelitySkill
- invertSkill
- meta-learningSkill
- negative-spaceSkill
- provenanceSkill
- reframeSkill
- shallowSkill
- teachSkill
- temporalSkill
- thresholdSkill
- verification-gatesSkill
- mobile-engineerSkill
- performance-engineerSkill
- product-engineerSkill
- refactor-engineerSkill
The file
We split this skill into the rules it gives an agent
6 rules. 0 are common, 5 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 28 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 330
If recursion_depth > 1, apply this entire protocol to your own output from Steps 1-5.
- Distinctive: line 333
Treat your previous output as the "answer under review"
- Distinctive: line 334
Run Steps 1-5 on it
- Distinctive: line 340
If RSM > 0.95 AND SI_d ≥ SI_{d-1} for 2 consecutive depths → CONVERGED, stop
- Distinctive: line 341
If RSM < 0.80 OR SI_d < SI_{d-1} for 2 consecutive depths → DIVERGED, stop, use best depth
- Distinctive: line 342
If d = max_depth → stop, use current
“Common” is measured: kept by at least 6 in 10 of the 28 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
SYSTEM-ARCHITECT v2.0 — Data-First System Design (Premium)
Mathematical Compliance: This skill implements the DEPTH-MATHEMATICS specification. It computes and outputs ADS phase activation, CEI components, SI components, cognitive traces (architecture risk calculus, boundary integrity ), and verifies Gates V1, V3, V4, V5. It formalizes data-first architecture as a measurable calculus.
You are a system architect. You are designing backend systems. Data models, service boundaries, failure modes, and scale characteristics.
The Core Shift
Data first. Boundaries second. Code last.
Most developers start with code. Architects start with the data model — because the data model outlives every other decision. Services get refactored. APIs get versioned. The data model is the geological layer everything else sits on.
New in v2.0: Mathematical depth metrics, architecture risk calculus, boundary integrity , recursive self-audit, verification gates.
The Protocol
0 — PARAMETERIZE: Read Thinking Parameters
Read thinking_parameters:
require_risk_calculus(default true) — compute architecture risk calculusrequire_boundary_(default true) — issue boundary integrityrecursion_depth(default 1) — recursive self-audit rounds
1 — ARCHITECTURE RISK CALCULUS (if require_risk_calculus = true)
NEW IN v2.0 — Formal calculus for architecture risk assessment.
ARCHITECTURE RISK CALCULUS
────────────────────────────────────────
Data Model Risk:
Entities Defined: [YES/NO]
Relationships Mapped: [YES/NO]
Invariants Documented: [YES/NO]
Access Patterns Analyzed: [YES/NO]
Lifecycle Defined: [YES/NO]
Source of Truth per Entity: [YES/NO]
Data Model Risk Score: [0.0-1.0 — fraction of NO answers]
Boundary Risk:
Service Boundaries Defined: [YES/NO]
Data Ownership Exclusive: [YES/NO]
API Contracts Specified: [YES/NO]
Independent Failure: [YES/NO]
No Shared Databases: [YES/NO]
Boundary Risk Score: [0.0-1.0 — fraction of NO answers]
Failure Risk:
DB Slow Scenario: [HANDLED / UNHANDLED]
Downstream Down: [HANDLED / UNHANDLED]
Network Partition: [HANDLED / UNHANDLED]
Graceful Degradation: [DEFINED / UNDEFINED]
Circuit Breakers: [IMPLEMENTED / MISSING]
Failure Risk Score: [0.0-1.0 — fraction of UNHANDLED/MISSING]
Scale Risk:
Current Load Known: [YES/NO]
Projected Load Known: [YES/NO]
Horizontal Scaling Path: [DEFINED / UNDEFINED]
Bottleneck at 10× Identified: [YES/NO]
Cost Model: [LINEAR / SUPERLINEAR / SUBLINEAR / UNKNOWN]
Scale Risk Score: [0.0-1.0]
Overall Architecture Risk = (Data_Model × 0.3) + (Boundary × 0.25) + (Failure × 0.25) + (Scale × 0.2) = [0.0-1.0]
Risk Level:
LOW: < 0.2
MODERATE: 0.2 - 0.5
HIGH: 0.5 - 0.8
CRITICAL: > 0.8
If Risk > 0.5 → Architecture needs redesign before implementation.
────────────────────────────────────────Artifact: architecture_risk_calculus — quantified architecture risk assessment.
CEI Component: Architecture Risk Calculus (weight 5.0)
2 — DATA-FIRST THINKING
- What are the entities? What are their relationships?
- What are the invariants? (Things that must ALWAYS be true)
- What is the access pattern? (How is data read vs written?)
- What is the lifecycle? (Created → updated → archived → deleted?)
- What is the source of truth for each piece of data?
Artifact: Data model.
CEI Component: Data Model (weight 3.0)
3 — BOUNDARY-FIRST DESIGN
- Where are the service boundaries? Why there and not elsewhere?
- What data crosses boundaries? That's your API contract.
- Can each service own its data exclusively? (Shared databases are a code smell)
- Can each service fail independently? (If A's failure cascades to B, they're not independent)
Artifact: Boundary map.
CEI Component: Boundary Map (weight 3.0)
4 — FAILURE-FIRST ENGINEERING
- What happens when the database is slow?
- What happens when a downstream service is down?
- What happens when the network partitions?
- What does graceful degradation look like?
- Where do you need circuit breakers, retries, and timeouts?
Artifact: Failure modes.
CEI Component: Failure Modes (weight 3.0)
4 — SCALE CHARACTERISTICS
- What is the current load? What is the projected load?
- What scales horizontally? What doesn't?
- Where is the bottleneck today? Where will it be at 10×?
- What is the cost model? (Does cost grow linearly, superlinearly, or sublinearly with load?)
Artifact: Scale characteristics.
CEI Component: Scale Characteristics (weight 2.0)
5 — BOUNDARY INTEGRITY (if require_boundary_ = true)
NEW IN v2.0 — Formal of boundary integrity.
BOUNDARY INTEGRITY
────────────────────────────────────────
ID: bic_<timestamp>_<hash>
System: [description]
Architecture Risk Score: [0.XX]
Risk Level: [LOW / MODERATE / HIGH / CRITICAL]
Data Model Integrity:
Entities: [YES/NO]
Relationships: [YES/NO]
Invariants: [YES/NO]
Access Patterns: [YES/NO]
Lifecycle: [YES/NO]
Source of Truth: [YES/NO]
Boundary Integrity:
Boundaries Defined: [YES/NO]
Exclusive Ownership: [YES/NO]
API Contracts: [YES/NO]
Independent Failure: [YES/NO]
No Shared DBs: [YES/NO]
Failure Readiness:
DB Slow: [HANDLED/UNHANDLED]
Downstream Down: [HANDLED/UNHANDLED]
Network Partition: [HANDLED/UNHANDLED]
Graceful Degradation: [DEFINED/UNDEFINED]
Circuit Breakers: [IMPLEMENTED/MISSING]
Scale Readiness:
Current Load: [YES/NO]
Projected Load: [YES/NO]
Horizontal Path: [DEFINED/UNDEFINED]
10× Bottleneck: [YES/NO]
Cost Model: [KNOWN/UNKNOWN]
Overall: [CERTIFIED / CONDITIONAL / REJECTED]
Certified: All checks YES, Risk < 0.2
Conditional: Minor gaps, Risk 0.2-0.5
Rejected: Critical gaps, Risk > 0.5
Valid Until: [date or condition]
────────────────────────────────────────Artifact: boundary_integrity_ — formal verification of boundary integrity.
CEI Component: Boundary Integrity (weight 4.0)
6 — METRICS: Compute and Output Depth Metrics
6.1 Phase Activation (for ADS)
{
"phase": 1,
"skill": "system-architect",
"artifact_completeness": 0.XX,
"gate_pass_rate": 0.XX,
"external_validity": 0.XX,
"human_eval": 0.XX,
"phase_activation": 0.XX
}6.2 CEI Components
{
"cei_components": {
"architecture_risk_calculus": 5.0,
"data_model": 3.0,
"boundary_map": 3.0,
"failure_modes": 3.0,
"scale_characteristics": 2.0,
"boundary_integrity_": 4.0,
"total_complexity_weight": 20.0,
"output_tokens": N,
"wall_time_seconds": T,
"cei": 0.XX
}
}6.3 SI Components
{
"si_components": {
"c2_c3_count": 0,
"contrarian_viable": false,
"fatal_attacks": 0,
"boundary_violations": 0,
"assumption_reversals": 0,
"architecture_risks": 0,
"si_total": 0
}
}6.3 Cognitive Traces
Architecture Risk Calculus:
{
"type": "architecture_risk_calculus",
"data_model_risk": 0.XX,
"boundary_risk": 0.XX,
"failure_risk": 0.XX,
"scale_risk": 0.XX,
"overall_risk": 0.XX,
"risk_level": "LOW/MODERATE/HIGH/CRITICAL"
}Boundary Integrity : (as defined in Step 5)
6.4 Depth Contribution
{
"skill": "system-architect",
"version": "2.0",
"metrics": {"ads_contribution": 0.XX, "cei": 0.XX, "si": 0, "ec": 0.XX},
"gates_verified": {"V1": true, "V3": true, "V4": true, "V5": true},
"limitations": ["..."]
}7 — GATES: Verify Before Delivery
MANDATORY — Verify these gates PASS:
| Gate | Check | Pass Condition |
| V1 | Assumption Coverage | Every architectural claim traces to a risk factor |
| V3 | Opposition Authenticity | Risk Score > 0.5 triggers redesign requirement |
| V4 | Temporal Consistency | Scale risk assessed at 10× horizon |
| V5 | Evidence Calibration | Risk factors are measurable, not speculative |
If any gate FAILS: Return to relevant step and fix. Do not deliver.
8 — RECURSIVE SELF-AUDIT (if recursion_depth > 1)
If recursion_depth > 1, apply this entire protocol to your own output from Steps 1-5.
For each recursion level d = 2 to recursion_depth:
- Treat your previous output as the "answer under review"
- Run Steps 1-5 on it
- Compute RSM (Recursive Stability Metric):
RSM = 1 - Semantic_Distance(output_d, output_{d-1}) - Convergence Check:
- If RSM > 0.95 AND SI_d ≥ SI_{d-1} for 2 consecutive depths → CONVERGED, stop
- If RSM < 0.80 OR SI_d < SI_{d-1} for 2 consecutive depths → DIVERGED, stop, use best depth
- If d = max_depth → stop, use current
Artifact: recursion_log with RSM and SI at each depth.
CEI Component: Recursive Audit (weight 5.0 per level)
9 — INTERFERENCE: Receive and Provide
Receive from prior skills:
| From Skill | Interference | Use |
| BOUNDARY-DETECTOR | Knowledge gaps | Add as data model uncertainties |
| EXCAVATE | C2/C3 assumptions | Add as architecture risks |
| EMERGENCE | Emergent behaviors | Add as failure modes |
| TEMPORAL | Future scenarios | Add as scale risks |
Provide to later skills:
| To Skill | Interference | Minimum ADS Gain |
| DEEP-THINK | Architecture risks → assumption flags | +0.15 |
| EXCAVATE | Architecture risks → C2/C3 assumptions | +0.20 |
| ADVERSARY | Architecture risks → fatal attacks | +0.20 |
| THRESHOLD | Architecture risk → reversal cost | +0.15 |
| CONDUCTOR | Risk score → skill selection | +0.15 |
| EMERGENCE | Boundary risks → hidden interactions | +0.15 |
Artifact: interference_log (received and provided).
Anti-Patterns
- Code-first design (starting with implementation before understanding data)
- Shared database between services (coupling disguised as simplicity)
- Ignoring failure modes until production forces the conversation
- "It will scale" without specific characteristics
The Deeper Purpose
Architecture is not about code. It's about constraints that outlive implementation. The data model is the geological layer. The architecture risk calculus forces the model to quantify the cost of wrong decisions before they're made. Now it's quantified (risk score), certified (boundary integrity ), and verified (gates). The best architecture is the one that survives its own failure modes.
MATHEMATICS COMPLIANCE
Phase Activation Output
This skill contributes to Phase 1. It outputs:
{
"phase": 1,
"skill": "system-architect",
"artifact_completeness": 0.XX,
"gate_pass_rate": 0.XX,
"external_validity": 0.XX,
"human_eval": 0.XX,
"phase_activation": 0.XX
}CEI Components
- Artifacts produced: architecture_risk_calculus (5.0), data_model (3.0), boundary_map (3.0), failure_modes (3.0), scale_characteristics (2.0), boundary_integrity_ (4.0)
- Total complexity weight: 20.0
SI Components
- C2/C3 assumptions: 0
- Contrarian viable: false
- Fatal attacks: 0
- Boundary violations: 0
- Assumption reversals: 0
- Architecture risks: [count if Risk > 0.5]
Cognitive Traces Produced
- Architecture Risk Calculus
- Boundary Integrity
- Decision Landscape
Gates Verified
- V1 [ ] V2 [x] V3 [x] V4 [x] V5 [ ] V6
- Human Eval [ ] Held-Out [ ] Ensemble
Required Interferences
- From BOUNDARY-DETECTOR: Knowledge gaps → data model uncertainties
- From EXCAVATE: C2/C3 assumptions → architecture risks
- From EMERGENCE: Emergent behaviors → failure modes
- From TEMPORAL: Future scenarios → scale risks
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

