solution-architecture

solution-architecture is a skill for Claude Code from stanislavnianko/product-discovery-claude-skills. It costs 84 tokens per session (1,930 once invoked), scanned A, original, MIT.

A discovery-stage software architecture process that turns a defined product scope into a high-level technical plan. It focuses on estimating effort, identifying risks, and explaining major choices rather than detailed implementation design.

In plain words
What is it for?
Reviewing discovery context and scope, describing system boundaries and integrations, recording assumptions and risks, and preparing work for estimation.
Why use it?
It helps teams avoid vague architecture discussions and exposes missing requirements and technical uncertainties early.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the discovery-phase plugin — 25 skills shipped together

Good fit Reviewing discovery context and scope, describing system boundaries and integrations, recording assumptions and risks, and preparing work for estimation.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/stanislavnianko/product-discovery-claude-skills/solution-architecture
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.

Any agent
npx skills add stanislavnianko/product-discovery-claude-skills --skill solution-architecture
Clone the repo
git clone --depth 1 https://github.com/stanislavnianko/product-discovery-claude-skills

Made for: Claude Code.

Or install discovery-phase, the plugin that ships this one along with the rest of its 25 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-architecture

README.md
[![agentmods](https://agentmods.dev/badge/skills/stanislavnianko/product-discovery-claude-skills/solution-architecture/github.svg)](https://agentmods.dev/skills/stanislavnianko/product-discovery-claude-skills/solution-architecture)
Your own site
<a href="https://agentmods.dev/skills/stanislavnianko/product-discovery-claude-skills/solution-architecture"><img src="https://agentmods.dev/badge/skills/stanislavnianko/product-discovery-claude-skills/solution-architecture/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 solution-architecture

Your own site · 80×15
<a href="https://agentmods.dev/skills/stanislavnianko/product-discovery-claude-skills/solution-architecture"><img src="https://agentmods.dev/badge/skills/stanislavnianko/product-discovery-claude-skills/solution-architecture.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 84 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,930 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.00084 $0.01930
Opus 5 $0.00042 $0.00965
Sonnet 5 $0.00017 $0.00386
Haiku 4.5 $0.00008 $0.00193

Measured 12d ago against content hash eeba6a051b67, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

solution-architecture 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 12d 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/discovery-phase/skills/solution-architecture/SKILL.md · 145 lines

How it starts

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

Solution Architecture

Part of the discovery-phase skill pack · scoping group · reads scope-doc.md (run feature-scoping first if missing) and feeds estimation.

Produces a discovery-grade architecture: enough detail to estimate effort, surface technical risks, and explain choices to the client — but not detailed design. Detailed design happens in delivery, not here. Where the BA isn't a tech lead, this skill is best run pair-mode with an architect; otherwise it produces vague boxes-and-arrows.

Step 1 — Read context + scope

Read discovery-context.md (sections 2. Product / Initiative, 6. Constraints, 7. Tech Context), then scope-doc.md (or mvp-definition.md if MVP track), then risk-assumption-map.md.

If scope-doc.md is missing, recommend feature-scoping first — architecture without a defined scope drifts into "general platform" territory and stops being useful for estimation.

If discovery-context.md is missing, ask inline: "(a) any client-mandated tech constraints (cloud, language, vendor)? (b) integration list — what must this connect to? (c) team's existing stack expertise?" — tag unknowns [ASSUMED].

Step 2 — System context (one diagram, in text)

Write a single system context diagram in text or Mermaid: the system in the middle, actors on one side, external systems on the other. This is the C4 "Level 1" view — no internals.

flowchart LR
  user[End User]
  admin[Admin]
  system[<<system under discovery>>]
  payment[Payment Provider]
  crm[Client CRM]

  user --> system
  admin --> system
  system --> payment
  system --> crm

Explicitly state what's out of scope for this system (e.g., "billing UI is consumed from existing client portal, not built here"). Out-of-scope boundaries are where most estimation surprises hide.

Step 3 — Logical components (3-7)

Decompose the system into 3-7 logical components — single-responsibility boxes. For each:

  • Name<component> (e.g., auth-service, event-ingestion, report-generator)
  • Responsibility — one sentence, one job
  • Owns data? — yes / no / shared
  • Talks to — which other components / external systems
  • New or existing? — building from scratch / extending existing client component / adopting a library

Read the full file on GitHub · 145 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 12d ago First seen · 145 lines · 84 tokens per session scan A eeba6a051b67

Subscribe to this mod's changes

solution-architecture is a skill published in the GitHub repository stanislavnianko/product-discovery-claude-skills (1 stars, last pushed 4mo ago), licensed MIT. It adds 84 tokens to every session and 1,930 once invoked, about $0.0004 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

jtbd-extractor

Turn raw research into Jobs-to-be-Done statements showing what users are really trying to accomplish. Use when: extract jobs, jtbd analysis, jobs to be done, what job is the user hiring, underlying user needs.

varunk130/ai-customer-discovery-skills · 50 tokens

assumption-mapper

Surfaces the assumptions a product or strategy depends on, classifies them by criticality and evidence quality, and produces a prioritized test plan. Use when: assumption mapping, identify assumptions, what could go wrong, leap-of-faith assumptions, riskiest assumption test, RAT, assumption inventory, validate before…

varunk130/ai-customer-discovery-skills · 68 tokens

competitive-analyzer

Structured competitive teardown for product discovery - surface the 4-6 dimensions buyers actually weigh, score every competitor on each, and identify exploitable gaps. Use when: competitive analysis, competitor teardown, market positioning, where do we win, where do we lose, competitive gap analysis, competitor audit.

varunk130/ai-customer-discovery-skills · 63 tokens

feedback-prioritizer

Triages a backlog of raw customer feedback into a ranked list of opportunities scored on reach, severity, strategic fit, and confidence. Outputs a prioritized list with explicit "do not act" callouts for vocal-minority signals. Use when: triage feedback, prioritize feature requests, customer feedback backlog, what…

varunk130/ai-customer-discovery-skills · 82 tokens

north-star-metric-finder

Identifies a candidate North Star Metric (NSM) for a product - the single metric that captures the value the product delivers to its customers and predicts long-term business growth. Tests candidates against five criteria and surfaces input metrics that move it. Use when: north star metric, NSM, single metric that…

varunk130/ai-customer-discovery-skills · 86 tokens

prd-taskmaster

Zero-config goal-to-tasks engine (the Atlas engine). Takes any goal (software, pentest, business, learning), runs adaptive discovery via brainstorming, generates a validated spec, parses into TaskMaster tasks, and hands off to execution. Use when user says "PRD", "product requirements", "I want to build", invokes…

anombyte93/prd-taskmaster · 80 tokens