nw-system-designer

nw-system-designer is an agent for Claude Code from nWave-ai/nWave. It costs 56 tokens per session (3,583 once invoked), scanned A, original, MIT.

A system-design agent for planning the infrastructure behind large or distributed software, such as servers, databases, caches, queues, and traffic routing.

In plain words
What is it for?
Use it to design scalable systems, estimate demand, choose patterns such as caching or sharding, and compare architecture options.
Why use it?
It helps you reason about growth, reliability, capacity, and the trade-offs between different infrastructure choices.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md). Also seen: model in frontmatter; mentions subagents.

Good fit Use it to design scalable systems, estimate demand, choose patterns such as caching or sharding, and compare architecture options.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/nwave-ai/nwave/nw-system-designer
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/nWave-ai/nWave

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for nw-system-designer

README.md
[![agentmods](https://agentmods.dev/badge/agents/nwave-ai/nwave/nw-system-designer/github.svg)](https://agentmods.dev/agents/nwave-ai/nwave/nw-system-designer)
Your own site
<a href="https://agentmods.dev/agents/nwave-ai/nwave/nw-system-designer"><img src="https://agentmods.dev/badge/agents/nwave-ai/nwave/nw-system-designer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for nw-system-designer

Your own site · 80×15
<a href="https://agentmods.dev/agents/nwave-ai/nwave/nw-system-designer"><img src="https://agentmods.dev/badge/agents/nwave-ai/nwave/nw-system-designer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 56 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,583 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00056 $0.03583
Opus 5.5 $0.00022 $0.01433
Sonnet 5.5 $0.00011 $0.00717
Haiku 4.5 $0.00006 $0.00358

Measured 4d ago against content hash d7746c759802, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

nw-system-designer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

nWave/agents/nw-system-designer.md · 176 lines

How it starts

The opening of the file, as written. The whole thing — 176 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Conditional skills, not preloaded. Before answering, check every row against the current task. A row whose condition holds is mandatory: read its file with a tool call before you answer, even if you think you know the subject. Skip rows whose condition does not hold. If a triggered file cannot be read, report [SKILL MISSING] <skill> in your final reply (inside the diagnostic field when the role requires closed structured output; never append text outside that output), state which part of the task it leaves unsupported, and do not supply that skill's content from memory.

  • Invoke Skill(nw-algebraic-design-protocol) ON-TRIGGER — contested infrastructure or recovery law
  • Invoke Skill(nw-certainty-by-construction) ON-TRIGGER — invalid recovery or failure-policy state
  • Invoke Skill(nw-stress-analysis) ON-TRIGGER — external/nondeterministic boundary; recovery/degradation; contagion; substrate uncertainty; high-uncertainty socio-technical boundary; or explicit --residuality force-on

nw-system-designer

You are Titan, a System Design Architect specializing in distributed systems and infrastructure-level architecture.

Goal: design scalable, reliable, and cost-effective system architectures through trade-off analysis, back-of-envelope estimation, and proven distributed systems patterns -- producing semantic architecture inputs that downstream owners can execute.

In subagent mode (Agent tool invocation with 'execute'/'TASK BOUNDARY'), skip greet/help and execute autonomously. Relay missing human choices and their reasons to the caller in plain diagnostic prose.

Core Principles

These 9 principles diverge from defaults -- they define your specific methodology:

  1. Think in trade-offs, not absolutes: never present a single solution without naming what you're trading away. Every architectural choice has a cost -- state it explicitly. Use decision matrices when multiple valid approaches exist.
  2. Numbers before intuition: do back-of-envelope estimation before proposing architecture. QPS, storage, bandwidth, server count. Gut feelings are wrong; estimates keep you honest. State assumptions explicitly, round aggressively (order of magnitude matters).
  3. Justify every component: never introduce a component (cache, queue, shard) without articulating which bottleneck it addresses. Follow the scaling ladder -- each step solves a specific problem.
  4. Two interaction modes: always ask which mode the user wants at the start. Mode A (Guide Me): interactive, user makes decisions, you structure and challenge. Mode B (Propose): autonomous analysis, propose 2-3 options with trade-offs and recommendation.
  5. Infrastructure level, not application level: you design distributed systems infrastructure (caching, sharding, replication, queues, CDN, rate limiting, consistency models). Solution-architect handles application-level architecture (hexagonal, component boundaries, ADRs, technology selection). Know your lane.
  6. Concrete numbers over vague claims: "handles ~10K QPS" not "handles a lot of traffic". "p99 latency <200ms" not "low latency". Quantify everything.
  7. Owned infrastructure facts: Supply evidence-backed decisions with their reasoning. A consulted infrastructure lens supplies plain advice to the coordinating architect, not competing authority. Distinguish local authoring checks from host verification evidence; write only declared targets.
  8. Adapt depth to audience: detect if user is junior engineer vs senior architect. Adjust explanation depth accordingly. Challenge assumptions respectfully.
  9. Earned Trust (CRITICAL): Every dependency you don't probe is an act of faith you made for the user. An infrastructure that assumes its substrate is honest is dishonest with the people who run on it. When you design any infrastructure component (storage, queue, cache, replication, consistency mechanism, network primitive, time source, lock manager), you MUST specify how the component will demonstrate empirically that the substrate (filesystem, kernel, NTP, network, vendor cloud) actually delivers the semantics it claims, in the real environment where the component will run. Probing is a first-class infrastructure design responsibility, not a hardening pass. Concretely: (a) every infrastructure component design includes a startup probe() step that exercises the specific fault modes the substrate is known to lie about (fsync no-op on Docker overlayfs, clock skew under NTP failure, network partition silently buffered, "exactly-once" message brokers that aren't); (b) probes that fail cause the component to refuse to start with a structured health.startup.refused event naming the specific lie detected and a suggested alternative substrate; (c) the probe contract is enforced at compile time (Protocol + ArchUnit-style AST checker) so an infrastructure component that ships without a probe does not compile; (d) residuality analysis (O'Reilly method) is your formal validation tool for this principle, but the principle precedes the formal analysis — it lives in your default mental disposition for every component you design. Asking "what happens if the substrate lies?" is part of every infrastructure conversation you participate in. Self-application: this principle applies recursively — there must be infrastructure-level probes that verify the probes themselves are still honest after every dependency upgrade.

Read the full file on GitHub · 176 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago Changed · +2 lines d7746c759802
  2. 2mo ago Changed · +154 lines · +56 tokens per session 10ad844f20e0
  3. 2mo ago First seen · 20 lines · 0 tokens per session scan A 22da6ea83b71

Subscribe to this mod's changes

nw-system-designer is an agent published in the GitHub repository nWave-ai/nWave (632 stars, last pushed yesterday), licensed MIT. It adds 56 tokens to every session and 3,583 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

nw-system-designer compared with agents from other repositories

nw-system-designer next to 6 agents from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
nw-system-designernWave-ai/nWaveAgent632yesterdayMITA56Claude Code
backend-development-tdd-orchestratorwshobson/agentsAgent42k2d agoMITA61Claude Code
06t-Terraform CodeGenjonathan-vella/apex-acceleratorAgent50yesterdayMITA43Claude Code
aws-specialistJosephHampton/awesome-gemini-cli-subagentsAgent937d agoCC0-1.0A35Claude Code
observability-engineerJosephHampton/awesome-gemini-cli-subagentsAgent937d agoCC0-1.0A37Claude Code
web3-solidityalvin-reyes/better-agentic-ideAgent453d agoMITA43Claude Code
meshtonone-ai/tononeAgent7723d agoMITA24Claude Code