# Architect

> Designs system architecture for new features. Defines data flow, component boundaries, threading/concurrency model, and key design decisions. Use when making architecture decisions, adding new systems, or evaluating design patterns.

- **Type:** Skill
- **Install:** `agentstack add skill-pvnarp-agent-skills-architect`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [pvnarp](https://agentstack.voostack.com/s/pvnarp)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [pvnarp](https://github.com/pvnarp)
- **Source:** https://github.com/pvnarp/agent-skills/tree/main/skills/architect

## Install

```sh
agentstack add skill-pvnarp-agent-skills-architect
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# System Architecture

## System Diagram

Before proposing architecture, map the current system. Create or update a diagram like:

```
┌──────────────────────────────────────┐
│           Entry Point / UI           │
│  (routes, views, controllers)        │
├──────────────────────────────────────┤
│          Business Logic              │
│  (services, domain models, rules)    │
├──────────┬───────────┬───────────────┤
│ Module A │ Module B  │   Module C    │
├──────────┴───────────┴───────────────┤
│          Data Layer                  │
│  (repositories, APIs, persistence)   │
├──────────────────────────────────────┤
│        Infrastructure                │
│  (DB, cache, queues, external APIs)  │
└──────────────────────────────────────┘
```

Adapt to the actual project structure. The goal is a single visual that shows where new code lives.

## Concurrency Model

Document how the system handles concurrent operations:
- Which thread/process owns which state?
- How do components communicate? (queues, events, shared memory, atomics?)
- Where are the synchronization boundaries?
- What is the locking strategy?

## Key Principles

1. **Single source of truth** for each piece of state. Never duplicate authoritative data.
2. **Separation of concerns** - each module has one job. UI doesn't contain business logic. Data layer doesn't know about presentation.
3. **Dependency direction** - dependencies point inward (UI → Business Logic → Data). Never the reverse.
4. **Explicit boundaries** - module interfaces are well-defined. Internal implementation is hidden.

## Anti-Patterns to Reject

- God objects that know about everything
- Circular dependencies between modules
- Business logic in UI/controller layer
- Over-engineering (DI frameworks, abstractions for single implementations, repository pattern for trivial storage)
- Premature optimization of architecture before understanding the problem

## Design Decision Template

When proposing architectural changes:

```
DECISION: [what]
CONTEXT: [why this is needed]
OPTIONS CONSIDERED:
  1. [option] - pros / cons
  2. [option] - pros / cons
CHOSEN: [which and why]
TRADE-OFFS: [what we give up]
REVERSIBILITY: [easy / moderate / hard to change later]
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [pvnarp](https://github.com/pvnarp)
- **Source:** [pvnarp/agent-skills](https://github.com/pvnarp/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-pvnarp-agent-skills-architect
- Seller: https://agentstack.voostack.com/s/pvnarp
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.