# system-design

system-design enforces Clean Architecture and DDD standards for coding agents. Steers models away from reinventing common utilities.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 218 installs · ★ 50 repo stars
- Author: qodex-ai
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/system-design/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/qodex-ai-system-design

## What it does

This skill configures the agent to follow domain-driven design and Clean Architecture patterns. It isolates business workflows from infrastructure layers, banning database queries in controllers and keeping UI components free of domain logic. Generic dump files like `helpers.js` or `utils.js` are prohibited in favor of explicit domain concepts such as `InvoiceGenerator`.

The guidelines mandate a library-first strategy. The model must check npm or existing services before drafting custom logic. For instance, retry loops should pull in existing packages like `cockatiel` instead of hand-rolled helpers. Writing custom routines is restricted to domain-specific business rules, critical performance paths, or strict security needs.

Stylistic constraints keep the codebase lean. Files longer than 200 lines must be split into separate modules, and individual functions should remain under 50 lines. Deep nesting is capped at three tiers. Keep in mind that this skill carries a proprietary license.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/system-design/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/system-design/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/system-design/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/system-design/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/system-design
```

2. **Manually: put the files in place**
- File: `.github/skills/system-design/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/system-design
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/system-design/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/system-design/SKILL.md

## When to use it
- isolate business workflows from infrastructure code
- prevent bloated `utils` and `helpers` dump files
- replace ad-hoc helper scripts with tested npm packages
- split overgrown files longer than 200 lines

## Example prompts
- Design the billing module following domain-driven design guidelines.
- Review this controller and pull database queries out into separate use cases.
- Refactor our retry logic to use an established npm library instead of custom helpers.

## Similar
- [architect-review](https://affpapa.org/en/nevibecode/skills/rmyndharis-architect-review.md) — skill · 154 installs
- [comprehensive-review-architect-review](https://affpapa.org/en/nevibecode/agents/comprehensive-review-architect-review.md) — subagent · ★ 42780 repo stars
- [design-code-architecture](https://affpapa.org/en/nevibecode/skills/design-code-architecture.md) — skill · 2700 installs
- [system-design-generator](https://affpapa.org/en/nevibecode/skills/system-design-generator.md) — skill · 284 installs
- [system-design-from-scratch](https://affpapa.org/en/nevibecode/skills/system-design-from-scratch.md) — skill · ★ 541 repo stars
- [architecture-patterns](https://affpapa.org/en/nevibecode/skills/architecture-patterns.md) — skill · 24144 installs

## Other versions with the same name
- [system-design · anthropics](https://affpapa.org/en/nevibecode/skills/system-design.md) — 7900 installs
- [system-design · wondelai](https://affpapa.org/en/nevibecode/skills/wondelai-system-design.md) — 6800 installs
- [system-design · jwynia](https://affpapa.org/en/nevibecode/skills/jwynia-system-design.md) — 661 installs

From the same set: [qodex-ai/ai-agent-skills](https://affpapa.org/en/nevibecode/by/qodex-ai/ai-agent-skills.md) — 42 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
