solution-design

solution-design is a skill for Claude Code, Codex from rpraharaj/forward-deployed-engineer. It costs 103 tokens per session (1,822 once invoked), scanned A, original, MIT.

A decision-making method for comparing several approaches to a substantial change. It records the options considered, including doing nothing or solving the problem elsewhere, and why one was chosen.

In plain words
What is it for?
Use it before committing to an architecture or when a change has more than one plausible implementation.
Why use it?
It reduces the risk of accepting the first workable design or importing a pattern that does not fit the organisation's constraints.

Skill for Claude CodeCodex

Part of the fde-core plugin — 30 skills 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/rpraharaj/forward-deployed-engineer/solution-design
Any agent
npx skills add rpraharaj/forward-deployed-engineer --skill solution-design
Clone the repo
git clone --depth 1 https://github.com/rpraharaj/forward-deployed-engineer

Made for: Claude Code, Codex.

Or install fde-core, the plugin that ships this one along with the rest of its 30 skills.

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 solution-design

README.md
[![agentmods](https://agentmods.dev/badge/skills/rpraharaj/forward-deployed-engineer/solution-design.svg)](https://agentmods.dev/skills/rpraharaj/forward-deployed-engineer/solution-design)
Your own site
<a href="https://agentmods.dev/skills/rpraharaj/forward-deployed-engineer/solution-design"><img src="https://agentmods.dev/badge/skills/rpraharaj/forward-deployed-engineer/solution-design.svg" alt="Measured on agentmods" height="20"></a>
Per session 103 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,822 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.00103 $0.01822
Opus 5 $0.00051 $0.00911
Sonnet 5 $0.00021 $0.00364
Haiku 4.5 $0.00010 $0.00182

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

Security

Grade A, and why

solution-design 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.

fde-core/skills/solution-design/SKILL.md · 164 lines

How it starts

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

Solution design

Choosing an approach, and recording why.

Why this exists

Two failure modes, and an FDE is exposed to both.

The first is the single-option design: the first workable approach becomes the approach, because it works and time is short. Nobody compared it to anything, so nobody knows if it was good — including you, when it turns out badly in month three.

The second is the imported default. An FDE arrives with patterns that worked elsewhere and applies them without checking whether the constraints that made them right still hold. This is the specific way outside expertise goes wrong, and the team can see it happening even when you can't.

The defence for both is the same: generate real alternatives, evaluate against this organization's constraints, and write down why you rejected the others. That last part matters most, because the rejected options are what a future engineer needs — otherwise they'll propose one of them in a year, and nobody will remember why it doesn't work.

When this applies

  • More than one plausible approach
  • A design decision arrived pre-made in the requirements and deserves checking
  • Before committing to an architecture, a contract, or a dependency
  • The change is expensive to reverse

When it doesn't

  • One obvious implementation — don't manufacture alternatives for ceremony
  • Reversible, local changes
  • The decision has genuinely already been made by someone with the authority to make it. Record it as a constraint and move on.

Prerequisites

  • .fde/03-requirements.md — what must be true
  • .fde/04-feasibility.md — what the code can actually support, and the alternatives it spotted
  • .fde/03b-nfrs.md if it exists, .fde/02b-ownership.md for who must agree

Procedure

1. State the decision precisely

One sentence, in the form of a question. "How should refund currency be resolved?" not "Refund currency design."

If you can't state it as a single question, you have several decisions bundled together. Split them — bundled decisions get approved or rejected as a unit, which means the good parts fail with the bad.

Read the full file on GitHub · 164 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. 4d ago First seen · 164 lines · 103 tokens per session scan A 233f9a71cf02

Subscribe to this mod's changes

solution-design is a skill published in the GitHub repository rpraharaj/forward-deployed-engineer (5 stars, last pushed 17d ago), licensed MIT. It adds 103 tokens to every session and 1,822 once invoked, about $0.0005 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.

Related

Other skills, from other repositories

html-ppt

For consulting delivery work: turn diagnosis, frameworks, and project work into a client-adoptable action plan. Built around the core query "consulting-final-deck", with engagement manager judgment, buyer-ready proof, and this outcome: accept the recommendation and commit owners to the roadmap.

nexu-io/open-design · 61 tokens

html-ppt-zhangzara-mat

A margin-recovery diagnosis for a regional grocery chain — the governing thought, the driver tree, the priorities, and the roadmap. Built as a decision-grade consulting deck for client sponsor, steering committee.

nexu-io/open-design · 51 tokens

html-ppt-zhangzara-soft-editorial

A digital-transformation roadmap for a legacy insurer — the diagnosis, the sequenced bets, and the operating rhythm to land them. Built as a decision-grade consulting deck for client executives.

nexu-io/open-design · 49 tokens

huashu-golden-circle

A brand-repositioning strategy for a heritage coffee chain — why, how, what — the governing idea and the moves to prove it. Built as a decision-grade consulting deck for client CMO, board.

nexu-io/open-design · 49 tokens

huashu-luxe-whitespace

A market-entry study for a luxury skincare brand entering Asia — segmentation, positioning, channel, and the phased plan. Built as a decision-grade consulting deck for client leadership.

nexu-io/open-design · 42 tokens

ppt-keynote

An operating-model redesign for a scaling logistics firm — the diagnosis, the target model, and the transition roadmap. Built as a decision-grade consulting deck for client sponsor, ops leaders.

nexu-io/open-design · 40 tokens