master-architect

A senior software-design reviewer that evaluates how an application should be structured. It challenges unnecessary complexity, compares design options, and recommends simpler choices that are easier to maintain.

In plain words
What is it for?
Use it to review system designs, choose between a single application and multiple services, select patterns, and assess dependencies, maintainability, and failure handling.
Why use it?
It helps avoid architecture decisions that are difficult to understand, costly to change, or dependent on too many external components. It provides a second opinion before major design choices become expensive to undo.

Agent

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/nxtg-ai/forge-plugin/master-architect
Clone the repo
git clone --depth 1 https://github.com/nxtg-ai/forge-plugin
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 1,931 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.01931
Opus 5 $0.00000 $0.00966
Sonnet 5 $0.00000 $0.00386
Haiku 4.5 $0.00000 $0.00193

Measured 2d ago against content hash fbf9688a18e3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

master-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 2d 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.

docs/agents/master-architect.md · 138 lines

How it starts

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

Master Architect

The senior technical authority who says "no, don't build it that way" -- and then explains exactly why and what to do instead, backed by decades of patterns for systems that survive production.

Level L1 Vibe Coder
Category Engineering Leadership
Model Opus

What It Does

The Master Architect is the senior engineer who has seen systems fail and succeed at scale. It reviews, challenges, and shapes every system design decision through a lens of radical simplicity: if a junior developer cannot understand it in 10 minutes, it is too complex. Complexity is not sophistication -- it is insufficient thought.

It operates on eight core principles, in priority order: simple beats clever, boring technology wins, one-way door decisions deserve deliberation, optimize for deletion not extension, YAGNI, Conway's Law is real, every dependency is a liability, and failure is a feature. These are not theoretical -- they are the principles that keep systems maintainable at 2 AM when something breaks.

The agent covers the full architecture surface: system design pattern selection (monolith vs. microservices vs. event-driven, with honest guidance on when each applies), Architecture Decision Records, database selection and query optimization, REST/GraphQL/gRPC/WebSocket API design, security architecture (zero-trust checklist, OAuth 2.0, RBAC), performance architecture (4-layer caching, connection pooling, load patterns), infrastructure decisions, monorepo vs. polyrepo trade-offs, technical debt assessment with prioritization scoring, and migration planning using the strangler fig pattern. Every recommendation includes the trade-off -- the cost of the recommendation, not just its benefit.

When to Use It

  • System design decisions: When choosing between architectures (monolith vs. microservices), databases (PostgreSQL vs. SQLite vs. MongoDB), or deployment strategies (serverless vs. containers).
  • Architecture review: When a design needs senior-level critique before implementation begins, with specific findings rated by severity.
  • API design: When designing REST, GraphQL, or gRPC interfaces that need to be correct, versioned, and maintainable long-term.
  • Technical debt assessment: When accumulated debt needs to be scored, prioritized, and scheduled for paydown based on impact and compounding rate.
  • Migration planning: When migrating between frameworks, databases, or architectures and you need a phased plan with rollback checkpoints.

Read the full file on GitHub · 138 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. 2d ago First seen · 138 lines · 0 tokens per session scan A fbf9688a18e3

Subscribe to this mod's changes

master-architect is an agent published in the GitHub repository nxtg-ai/forge-plugin (5 stars, last pushed 12d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,931 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.