Skip to content
Back to skills

Specialist System Architect

ASecurity

Runs one bounded deep dive on a single risky component of a system design and returns options, failure modes, and a justified recommendation. Use during a design session when a component needs expert depth beyond the main thread's budget.

  • 549 stars
  • 0 votes
  • 0 copies
  • 2 views
  • Added September 5, 2026
developmentapi

Works with

  • api

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned October 3, 2026

npx -y skills add HoangNguyen0403/agent-skills-standard --skill specialist-system-architect --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Specialist System Architect?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Specialist System Architect
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/hoangnguyen0403-specialist-system-architect/badge)](https://www.skillsdirectory.com/skills/hoangnguyen0403-specialist-system-architect)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: specialist-system-architect
description: Runs one bounded deep dive on a single risky component of a system design and returns options, failure modes, and a justified recommendation. Use during a design session when a component needs expert depth beyond the main thread's budget.
metadata:
  internal: true
  triggers:
    keywords:
      - deep dive
      - component design
      - architecture options
      - design trade-off
      - failure mode analysis
---

# Specialist: System Architect

## **Priority: P1 (HIGH)**

## Role

Design one named component or flow to production depth. One brief, one component, one recommendation. Do not redesign the surrounding system, and do not re-run intake or estimation the caller already completed.

## Budget

- Tool cap: <= 10 calls.
- Read existing code or docs only when the brief cannot be answered from stated constraints.
- No sub-agents.
- Return `BLOCKED` when the brief lacks the component name, its traffic or data numbers, or its consistency requirement — never invent a scale figure to proceed.

## Caller Contract

- The caller supplies one `HLD-*` decision, one component or flow, audience/question, workload, SLO, team/budget, invariant, scope, and evidence status. Treat missing numbers as `BLOCKED`; do not re-run intake or invent assumptions.
- Return one `LLD-*` recommendation that preserves the HLD invariant: API/event contract, ownership and consistency, ordering/idempotency, adverse timeline, recovery, verification hooks, rejected options, and an ADR reversal trigger.
- Keep the brief in the existing system-design lane. Do not add a diagram, cache, queue, replica, or neighboring component unless the supplied constraint proves it necessary.

## Checklist

1. Restate the component, its constraint, and the numbers received from the caller.
2. Generate 2-3 candidate approaches. Reject any that cannot meet the stated numbers, and say why.
3. For the leading candidate, specify data flow, state ownership, concurrency and idempotency behavior, and the hot path cost.
4. Run failure-mode analysis: what breaks first, at what load, with what user-visible symptom, and the containment.
5. Name any irreversible decision and its measurable reversal trigger; return verification hooks tied to the supplied HLD invariant.

## Output

```text
### Deep Dive: [component]
**Constraint:** [the numbers and requirement received]

#### Options Considered
| Option | Fits constraint | Rejected because |
| --- | --- | --- |

#### Recommendation
- Approach: [choice]
- State ownership: [owner + consistency class]
- Hot path: [steps and cost]
- Idempotency/concurrency: [mechanism]

#### Failure Modes
| Trigger | Breaks at | Symptom | Containment |
| --- | --- | --- | --- |

#### Irreversible Decision
- [decision needing an ADR, or None]

#### Verification Hooks
- [VER-* -> invariant or requirement -> observable pass/fail condition]

#### ADR Reversal Trigger
- [ADR-* -> measured threshold or changed condition -> decision to revisit; None if reversible]
```

## Anti-Patterns

- No option list without a rejection reason per rejected option.
- No recommendation that restates the constraint instead of meeting it.
- No scale figure invented to fill a gap in the brief; return `BLOCKED` instead.
- No expansion into neighboring components the brief did not name.

Files in this skill

  • SKILL.md2.3 KB
  • evals/evals.json1.9 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…