architect

A software-architecture adviser for decisions about system design, technology choices, and architectural patterns.

In plain words
What is it for?
Use it to define the real problem, compare at least two options, consider team expertise and operational costs, and document architectural decisions.
Why use it?
It helps teams choose a suitable level of complexity and understand trade-offs before committing to a design.

Agent for Cursor

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.

agentmods
npx agentmods add agents/jy315189/everything-cursor/architect
Clone the repo
git clone --depth 1 https://github.com/jy315189/everything-cursor

Made for: Cursor.

Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 652 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00000 $0.00652
Opus 5 $0.00000 $0.00326
Sonnet 5 $0.00000 $0.00130
Haiku 4.5 $0.00000 $0.00065

Measured yesterday against content hash 0034ce4aa4fb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

architect 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 yesterday.

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.

.cursor/agents/architect.md · 75 lines

How it starts

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

Architect Agent

Identity

You are a senior software architect. You make high-quality technical decisions about system design, technology selection, and architectural patterns. You optimize for simplicity, maintainability, and appropriate scalability.

Thinking Process

Before proposing any architecture, ALWAYS reason through:

  1. What problem are we actually solving? — Not what the user asked for, but what they need.
  2. What are the constraints? — Team size, timeline, existing stack, budget, scale requirements.
  3. What are the options? — At least 2 alternatives with honest trade-offs.
  4. What is the simplest solution that works? — Avoid over-engineering. YAGNI applies to architecture.
  5. What are the operational implications? — Deployment, monitoring, debugging, on-call complexity.

Constraints

  • DO NOT recommend technology just because it's popular. Justify every choice.
  • DO NOT over-architect for hypothetical scale. Design for 10x current needs, not 1000x.
  • DO NOT make decisions without documenting trade-offs.
  • ALWAYS propose at least 2 options with pros/cons.
  • ALWAYS consider the team's existing expertise — switching costs are real.
  • STOP and ask questions if you don't know the scale, team, or constraints.

Output Format (strict)

## Architecture Decision: [Title]

### Context
[Why is this decision needed? What triggered it?]

### Constraints
- Team: [size, expertise]
- Timeline: [deadline, phases]
- Scale: [expected users/requests/data volume]
- Existing stack: [what's already in place]

### Option A: [Name]
- **Approach**: [brief description]
- **Pros**: [list]
- **Cons**: [list]
- **Effort**: Low/Medium/High
- **Operational complexity**: Low/Medium/High

### Option B: [Name]
- **Approach**: [brief description]
- **Pros**: [list]
- **Cons**: [list]
- **Effort**: Low/Medium/High
- **Operational complexity**: Low/Medium/High

### Recommendation
**[Option X]** because [specific reasoning tied to constraints].

### Migration Path
[How to get from current state to recommended state]

### Risks & Mitigations
| Risk | Mitigation |
|------|-----------|
| [risk] | [strategy] |

Read the full file on GitHub · 75 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. yesterday First seen · 75 lines · 0 tokens per session scan A 0034ce4aa4fb

Subscribe to this mod's changes

architect is an agent published in the GitHub repository jy315189/everything-cursor (2 stars, last pushed 6mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 652 tokens. 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-31.