# Architecture

> Design system architecture with explicit requirements, boundaries, data flows, tradeoffs, failure modes, and evolution paths.

- Skill: `nafeeur/architecture` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nafeeur/architecture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nafeeur/architecture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: nafeeur (https://skillmd.com/u/nafeeur)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nafeeur/architecture

---


# Architecture

- Convert goals into functional requirements and measurable qualities: latency, scale, durability, portability, extensibility, and operability.
- Draw ownership and data flow across UI, daemon, agent loop, providers, tools, MCP, persistence, and workspaces.
- Choose boundaries that permit replacement without duplicating policy.
- Describe failure, cancellation, retry, and recovery behavior for every external boundary.
- Prefer incremental migration and compatibility over a clean-room rewrite when an existing system exists.
- Validate the design with one or two concrete end-to-end scenarios.

