architect

architect is a skill for Claude Code, Codex from donald-ada/workinggenius. It costs 57 tokens per session (865 once invoked), scanned A, original, MIT.

A workflow for deciding whether to build something or use an existing solution, then designing one architecture for the chosen approach. Architecture is the overall structure of a software system and how its parts fit together.

In plain words
What is it for?
Use it for new projects or major changes that shape a system's structure, especially when existing tools or services might already meet the need.
Why use it?
It reduces unfocused design debates and makes the reasons for building, adopting, or rejecting an approach explicit.

Skill for Claude CodeCodex

Part of the workinggenius plugin — 19 skills, 1 agent shipped together

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 skills/donald-ada/workinggenius/architect
Any agent
npx skills add donald-ada/workinggenius --skill architect
Clone the repo
git clone --depth 1 https://github.com/donald-ada/workinggenius

Made for: Claude Code, Codex.

Or install workinggenius, the plugin that ships this one along with the rest of its 19 skills, 1 agent.

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/skills/donald-ada/workinggenius/architect.svg)](https://agentmods.dev/skills/donald-ada/workinggenius/architect)
Your own site
<a href="https://agentmods.dev/skills/donald-ada/workinggenius/architect"><img src="https://agentmods.dev/badge/skills/donald-ada/workinggenius/architect.svg" alt="Measured on agentmods" height="20"></a>
Per session 57 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 865 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.00057 $0.00865
Opus 5 $0.00028 $0.00432
Sonnet 5 $0.00011 $0.00173
Haiku 4.5 $0.00006 $0.00086

Measured 4d ago against content hash d3e60138e151, 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 4d 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.

skills/architect/SKILL.md · 20 lines

What it actually says

Architect

Greenfield's territory is the field — the systems that already solved this problem. But the field is not there to be copied: it answers one question and stress-tests another. An architecture assembled from references is a worse copy of something the user could just install.

The concept: first ask whether to build at all; then design one architecture that is genuinely yours, and let the field attack it.

  • Build-or-adopt is the first fork, and it belongs to the user. Study the field honestly enough to answer: does something existing already cover this? If adopting — using, forking, wrapping — covers the need, recommending it is a successful outcome. What justifies building is the delta between what the user needs and what exists: name it, put the fork to the user with your recommendation and its price, and if building wins, the delta becomes the design's spine — the part that makes this system worth existing. That is Wardley Mapping's doctrine, applied: build only what differentiates; adopt what's commodity.
  • Design one architecture, committed — never a menu. A row of reference-flavored options is theater when the user can't tell them apart: they take your recommendation anyway and the ceremony bought nothing. Design from your own understanding of the confirmed problem, at the professional default — a system a senior engineer expects to still be maintaining in three years; the user buys down, never up — and stand behind it. Original decisions need reasons, not citations: the sourcing rule binds facts, never thinking — a claim about what an existing system does carries its source; your own design carries its reasoning. And commitment is not momentum: the default stack — the one you'd recommend for any problem — was chosen for none. A stack is a fork the user's world decides, so ask — the team's hands, the ops that already exist, the load that is real. Every technology in the design then names what selected it, and a choice that can't name its selector is the template designing instead of you.
  • The field attacks the design; it doesn't write it. Where serious systems converged, diverging needs a stated reason — "every one of them checkpoints transfer state; yours doesn't. Deliberate, or blind?" Where they diverged, real builders disagreed: a fork the user's world decides goes to the user (recommendation attached, price stated); a fork that's pure engineering is yours to decide, with the reason recorded. The stance is Residuality Theory's: stress the design from every direction, and what survives — the residue — is the architecture. A new subsystem landing in an old project has a second attacker: the decisions already recorded there (the decision-record skill's index in .genius/DECIDED.md, past work, and records that predate this plugin — docs/adr/, wherever the repo keeps them) — contradict one and the design either loses or says which decision it overturns and why.
  • The user confirms consequences, not diagrams. Play the architecture back as behavior — "a transfer dies at 80%: here's what this design does" — until the user says that's what they want. A confirmation of behavior they can evaluate beats approval of boxes and arrows they can't.

Record the study and the decisions where the project keeps its records — a confirmed design a future stranger would re-fight gets its line in the decision index (decision-record skill), the rest stays with the work — so the next session reads the record instead of re-deriving it. One study per piece of work: a study already on record is consumed, not redone — research only what it genuinely doesn't cover. The confirmed architecture is the deliverable; what happens next is the user's to type — nothing here advances anything for them.

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. 4d ago First seen · 20 lines · 57 tokens per session scan A d3e60138e151

Subscribe to this mod's changes

architect is a skill published in the GitHub repository donald-ada/workinggenius (5 stars, last pushed 6d ago), licensed MIT. It adds 57 tokens to every session and 865 once invoked, about $0.0003 per session on Opus 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-08-31.