architect

architect is a command for Claude Code from MadAppGang/magus. It costs 18 tokens per session (6,812 once invoked), scanned A, original, MIT.

An architecture-planning command that designs technical solutions while adjusting its process to the complexity of the problem. It can use deeper reasoning and additional model review when needed.

In plain words
What is it for?
Use it to plan systems, services, and cross-cutting concerns such as security, performance, scalability, and conflicting requirements.
Why use it?
It helps turn a broad architecture question into an appropriate planning process instead of applying the same level of analysis to every task. It also detects signs that a design needs reconsideration.

Command for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: mentions subagents; names the AskUserQuestion tool; mentions Claude Code.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the dev plugin — 19 skills, 15 commands, 12 agents shipped together

Good fit Use it to plan systems, services, and cross-cutting concerns such as security, performance, scalability, and conflicting requirements.

Compare 6 commands from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add MadAppGang/magus
Claude Code
/plugin install dev

Made for: Claude Code.

Or install dev, the plugin that ships this one along with the rest of its 19 skills, 15 commands, 12 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for architect

README.md
[![agentmods](https://agentmods.dev/badge/commands/madappgang/magus/architect/github.svg)](https://agentmods.dev/commands/madappgang/magus/architect)
Your own site
<a href="https://agentmods.dev/commands/madappgang/magus/architect"><img src="https://agentmods.dev/badge/commands/madappgang/magus/architect/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for architect

Your own site · 80×15
<a href="https://agentmods.dev/commands/madappgang/magus/architect"><img src="https://agentmods.dev/badge/commands/madappgang/magus/architect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 18 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 6,812 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00018 $0.06812
Opus 5.5 $0.00007 $0.02725
Sonnet 5.5 $0.00004 $0.01362
Haiku 4.5 $0.00002 $0.00681

Measured 20d ago against content hash c4e66520e524, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, 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 20d ago.

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.

plugins/dev/commands/architect.md · 723 lines

How it starts

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

<user_request> $ARGUMENTS </user_request>

This triage determines the right level of process for the architecture task.

**Step 1: Detect retry attempts**

Check if this is a second (or later) attempt at the same architecture problem:
```bash
# Look for existing architecture sessions with similar topic
TOPIC_SLUG=$(echo "$ARGUMENTS" | tr '[:upper:] ' '[:lower:]-' | sed 's/[^a-z0-9-]//g' | head -c30)
ls -d ai-docs/sessions/dev-arch-*${TOPIC_SLUG}* 2>/dev/null || echo "NO_PREVIOUS_SESSIONS"
```

Also check for retry signals in the user's request:
- "again", "retry", "different approach", "rethink", "reconsider"
- "didn't work", "failed", "not happy with", "let's try"
- References to a previous design or session

**Step 2: Assess complexity signals**

| Signal | Weight | Example |
|--------|--------|---------|
| Multiple systems/services | HIGH | "design auth across API + frontend + mobile" |
| Novel domain (no existing patterns) | HIGH | "design real-time collaboration engine" |
| Cross-cutting concerns | HIGH | "security + performance + multi-tenancy" |
| Conflicting requirements | HIGH | "fast AND highly consistent AND cheap" |
| Large blast radius | MEDIUM | "redesign the entire data layer" |
| Multiple viable approaches | MEDIUM | unclear best path forward |
| Single component, clear pattern | LOW | "add caching to the user service" |
| Well-understood domain | LOW | "standard CRUD API for products" |

Score: HIGH = 2 points, MEDIUM = 1, LOW = 0; sum every signal present.
0 = Simple, 1-2 = Moderate, 3+ = Complex. So one MEDIUM or one HIGH is Moderate,
and one HIGH plus one MEDIUM, or two HIGH, is Complex.

**Step 3: Route based on assessment**

| Assessment | Is Retry? | Route |
|------------|-----------|-------|
| Simple | No | Direct architecture design (Phase 0-6) |
| Simple | Yes | Offer /team — "Previous attempt exists. Want multi-model perspectives?" |
| Moderate | No | Plan mode reasoning first, then architecture design |
| Moderate | Yes | Recommend /team — "This needs fresh perspectives" |
| Complex | No | Plan mode reasoning + offer /team before architecture |
| Complex | Yes | Strongly recommend /team — "Multi-model brainstorming before redesign" |

**When /team is recommended, present the option:**

```yaml
AskUserQuestion:
  questions:
    - question: "This looks like a {complex problem | second attempt}. How should we approach it?"
      header: "Architecture Approach"
      multiSelect: false
      options:
        - label: "Multi-model brainstorm (/team)"
          description: "Get diverse perspectives from multiple AI models before designing. Best for complex or retry scenarios."
        - label: "Plan mode reasoning"
          description: "Use Claude's extended reasoning to think through the design space, then proceed with single-model architecture."
        - label: "Direct architecture"
          description: "Skip to architecture design. Good when you already know the general direction."
```

Read the full file on GitHub · 723 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. 20d ago Changed · +4 lines c4e66520e524
  2. 22d ago Changed · -18 lines 64fd1be063fd
  3. 1mo ago Changed · -2 lines 297ccf4ed750
  4. 1mo ago Changed · +2 lines ee3253f93d80
  5. 1mo ago First seen · 737 lines · 18 tokens per session scan A 12384f7230ee

Subscribe to this mod's changes

architect is a command published in the GitHub repository MadAppGang/magus (13 stars, last pushed today), licensed MIT. It adds 18 tokens to every session and 6,812 once invoked, about $0.0001 per session on Opus 5.5. 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-09-04.