# Architecture Designer

> Designs system-level structures including modules, services, data flow, and scaling strategy before implementation begins

- **Type:** Skill
- **Install:** `agentstack add skill-razaib-khan-forgeweave-architecture-designer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Razaib-khan](https://agentstack.voostack.com/s/razaib-khan)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Razaib-khan](https://github.com/Razaib-khan)
- **Source:** https://github.com/Razaib-khan/ForgeWeave/tree/main/src/forgeweave/templates/qwen/.qwen/skills/architecture-designer

## Install

```sh
agentstack add skill-razaib-khan-forgeweave-architecture-designer
```

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

## About

# Architecture Designer

## Purpose

Design system-level architecture before any code is written. Produces module boundaries, service decomposition, data flow diagrams, and scaling strategy. Ensures the architecture is coherent, testable, and aligned with project constraints.

## When to Use

- Starting a new project or major subsystem
- The current architecture cannot support upcoming requirements
- Performance, scalability, or reliability concerns need addressing at the architectural level
- Multiple services or modules need to be designed together

## When Not to Use

- The change is contained within a single module — use `planner` + `code-builder`
- The user just needs a quick code pattern — not architectural design
- The architecture is already documented and just needs implementation

## Inputs

| Input | Type | Required | Description |
|---|---|---|---|
| `requirements` | string | Yes | Functional and non-functional requirements |
| `constraints` | string | No | Technical, organizational, or timeline constraints |
| `existing_architecture` | string | No | Description of existing system if extending it |

## Expected Outputs

| Output | Description |
|---|---|
| Module decomposition | List of modules with responsibilities |
| Data flow | How data moves between modules and external systems |
| Scaling strategy | How the system handles growth |
| Technology decisions | Key tech choices with rationale |

## Exact Workflow Steps

1. Understand requirements and constraints thoroughly
2. Identify bounded contexts and module boundaries
3. Define interfaces and data flow between modules
4. Design for failure: error handling, retries, fallbacks
5. Plan scaling strategy (horizontal vs vertical, caching, sharding)
6. Document technology decisions with alternatives considered
7. Review with planner to create execution plan

## Required Checks

- [ ] Every requirement is addressed by the architecture
- [ ] Module boundaries are clear and non-overlapping
- [ ] Data flow is documented with direction and format
- [ ] Failure modes are identified per module

## Failure Modes

| Failure Condition | Response |
|---|---|
| Requirements are too vague | Ask clarifying questions before designing |
| Architecture contradicts existing system | Document trade-offs and seek user input |
| Too many modules for scope | Consolidate into coarser boundaries |

## References

| Reference | Path |
|---|---|
| Planner skill | `../planner/SKILL.md` |
| Code Builder skill | `../code-builder/SKILL.md` |

## Source & license

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

- **Author:** [Razaib-khan](https://github.com/Razaib-khan)
- **Source:** [Razaib-khan/ForgeWeave](https://github.com/Razaib-khan/ForgeWeave)
- **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-razaib-khan-forgeweave-architecture-designer
- Seller: https://agentstack.voostack.com/s/razaib-khan
- 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%.