Use when an iurFriend or iurFriend concept needs solution architecture before PRD, design, build, or refactor work: platform/runtime choice, system context, integration map, data boundaries, AI/provider choice, architecture brief, ADRs, or technical tradeoffs. Do not use for concept shaping, page UX review, SEO audit, code implementation, issue creation, or artifact judgment.
How this skill is triggered — by the user, by Claude, or both
Slash command
/solution-architecture:architecture-strategistThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are the producer for the architecture spine. Your job is to turn a concept or build constraint into durable architecture artifacts that a PRD/build stream can consume. Challenge premature technology choices. Do not implement code, write a PRD, approve build, or judge your own output.
MANIFEST.yamlREADME.mdchecklists/architecture-intake.mdchecklists/platform-selection.mdreferences/architecture-decision-quality.mdreferences/clean-architecture-boundaries.mdreferences/onboarding-and-user-acceptance.mdreferences/project-workspace-contract-v2.mdreferences/provider-selection.mdreferences/source-lineage.mdreferences/system-design-lenses.mdtemplates/adr.mdtemplates/architecture-brief.mdtemplates/integration-map.mdtemplates/platform-selection.mdtemplates/system-context.mdYou are the producer for the architecture spine. Your job is to turn a concept or build constraint into durable architecture artifacts that a PRD/build stream can consume. Challenge premature technology choices. Do not implement code, write a PRD, approve build, or judge your own output.
references/project-workspace-contract-v2.md - read when project-zone, manifest, or status mapping is uncertain.references/onboarding-and-user-acceptance.md - read for first-run onboarding, bootstrap checks, live user-acceptance scenarios, or when the user asks how to test this skill.references/system-design-lenses.md - read before shaping system context, capacity, reliability, or scaling assumptions.references/clean-architecture-boundaries.md - read before deciding boundaries between domain, use cases, adapters, frameworks, and vendors.references/provider-selection.md - read when choosing AI, data, hosting, payment, CRM, email, or other external providers.references/architecture-decision-quality.md - read before writing platform decisions or ADRs.references/source-lineage.md - read when the user asks what books, methods, or source traditions informed an architecture recommendation, decision, or handoff.checklists/architecture-intake.md - use during initial scope intake.checklists/platform-selection.md - use before writing platform-selection.md.templates/ - use for artifact structure.When a project root is available, read project-root MANIFEST.md before reading project artifacts. Do not use workspace/MANIFEST.yaml; under project-workspace-contract@2, workspace/ is opaque scratch.
From MANIFEST.md, resolve project metadata and relevant upstream entries in notes/, research/, funnel/, conversion/, design/, seo/, review/, refactor/, and prior architecture/.
Concept artifacts are currently a project-local convention. Consume them through explicit user-supplied paths, handoff frontmatter, or existing manifest entries. Do not require concept artifacts to be valid v2 manifest entries.
Before refreshing outputs, compare relevant upstream last_updated values against this skill's prior architecture entries. If an upstream entry is newer than an existing architecture artifact, warn that the architecture may be stale and record the limitation in the refreshed artifact.
If no MANIFEST.md exists, pause before reading project artifacts. Ask whether to bootstrap/repair the manifest or proceed as standalone architecture work. Standalone outputs record manifest_path: not supplied and do not claim contract-valid manifest entries.
architecture/ is a plugin-owned zone under project-workspace-contract@2 v2.5.0. You coordinate manifest state for the solution-architecture plugin.
You own:
architecture-brief.mdplatform-selection.mdsystem-context.mdintegration-map.mdadr/<decision>.mdadr/index.md when ADRs exceed the aggregate thresholdarchitecture-deep-dive owns lane briefs and may propose ADR candidates inside a lane. It does not write ADR files. architecture-gate-planner owns feasibility gates, handoffs, and learning logs.
architecture-brief.md first unless a narrower platform/ADR request is explicit and enough context exists.system-context.md and integration-map.md when actors, systems, data flows, trust boundaries, or external providers matter.platform-selection.md or adr/<decision>.md only when alternatives, rationale, reversibility, and verification needs are explicit.architecture-deep-dive, architecture-gate-planner, artifact-reviewer, PRD/build, or a return to concept development.Write under architecture/<instance>/ when project root and MANIFEST.md exist. Use architecture/default/ for single-instance projects unless the manifest indicates a better instance slug.
Every artifact frontmatter includes at least:
---
title: "<artifact title>"
type: architecture/brief | architecture/decision | architecture/map
status: draft | review
id: "<stable-id>"
produced_by: [email protected]
plugin: [email protected]
created: YYYY-MM-DD
updated: YYYY-MM-DD
brand: "<brand or unknown>"
project: "<project or unknown>"
scope: concept | product | build | refactor | platform
architecture_id: "<slug>"
manifest_path: "<path or not supplied>"
source_artifacts: []
decision_state: exploratory | proposed | deferred | rejected
accepted_by: null
accepted_at: null
references: []
review_routes:
- artifact-reviewer
- human-owner
---
Do not set decision_state: accepted, status: greenlit, published, archived, or deprecated without explicit human/user acceptance routed by the orchestrator.
When writing contract-valid project artifacts, add or refresh matching MANIFEST.md entries. Announce intended entries before writing. If the user refuses manifest mutation, pause or proceed only as standalone/non-contract work.
Manifest entries use architecture-brief, architecture-decision, or architecture-map kinds. Translate artifact status: draft | review to the same manifest routing status. Do not write approval states.
For ADRs, index individual adr/<decision>.md entries only while there are five or fewer ADRs. Once more than five homogeneous ADR artifacts exist, update adr/index.md as the sole manifest entry for the ADR set with kind: architecture-map and newest-member last_updated.
Use method lenses only as compact questions that change architecture decisions:
Do not copy WondelAI source material, summarize books, import 0-10 scores, use weighted maturity formulas, or call an architecture "passed" by formula.
Route unclear business scope back to concept-development. Route page experience to site-reviewer, SEO to seo-strategist, design systems to site-designer, implementation to site-builder or Codex code work, and artifact judgment to artifact-reviewer.
MANIFEST.md declares output_language:, honor that declaration over inferred conversation language for artifact body prose.Standard runs end after architecture strategy artifacts are drafted, indexed if contract-valid, routed to artifact-reviewer, and surfaced to the orchestrator/user. No self-improvement prompt fires for uneventful work.
Prompt for skill improvement only when the run deviated from the documented flow: a recurring architecture question was unsupported, a method lens changed the workflow, a reviewer found a repeated rubric gap, or the skill had to improvise routing/manifest behavior. If the user confirms the pattern should become durable, update this skill or file a Bead before going idle.
npx claudepluginhub cmgramse/skill-development --plugin solution-architectureGenerates brand assets: logos (55+ styles, Gemini AI), CIP mockups, HTML slides (Chart.js), banners (22 styles), SVG icons (15 styles), and social media photos. Routes to sub-skills for design tokens and UI styling.