skills.rest
learnn-com
learnn-comOFFICIAL
Explore all skills by this author →
WebsiteGitHub

capability-assess-architecture

Assess and adopt a system architecture pattern using a resolution cascade and guidelines.

Updated Mar 31, 2026
Search Tags:#architecture#microservices#decision record#adr#hexagonal#assessment#adoption
One-click install
npx skills add https://github.com/learnn-com/engineering-kb --skill capability-assess-architecture-learnn-com
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capability-assess-architecture
Source: https://github.com/learnn-com/engineering-kb/tree/main/.skills/capability-assess-architecture
Command: npx skills add https://github.com/learnn-com/engineering-kb --skill capability-assess-architecture-learnn-com

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Choosing and documenting a system architecture pattern is often inconsistent and undocumented. This Skill evaluates architecture options against project constraints, writes an adoption file, and records the decision as an ADR so the choice is traceable and idempotent. ## Core Features & Use Cases - Resolution Cascade: Resolves the architecture via explicit argument override, existing adoption file, or a full assessment from guidelines. - Guideline-Driven Assessment: Scores candidate patterns (e.g., Modular Monolith, Hexagonal, Microservices) using a complexity matrix weighted by project constraints. - Adoption & ADR Recording: Writes the adoption file at adoption/tech/architecture.md and composes /capability-record-decision to create an architecture ADR. - Use Case: During project bootstrap, run the assessment to pick Hexagonal architecture, persist the adoption file, and automatically generate the corresponding ADR. ## Quick Start Ask the assistant to assess and adopt an architecture pattern for the project, optionally passing a choice like hexagonal to skip the full assessment.

Frequently Asked Questions about capability-assess-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose a software architecture pattern for a new project?▼

Run the assessment, which reads architecture guidelines and scores candidate patterns on implementation complexity, team skill, maintenance, and scalability. It presents a recommendation with trade-offs and, after approval, writes the adoption file and records an ADR.

How do I skip the architecture assessment and use a specific pattern?▼

Pass the pattern name as the $choice argument, for example hexagonal. The skill confirms the override with you, warns if a different adoption already exists, then writes the adoption file and records the decision.

What happens if an architecture adoption file already exists?▼

The skill detects the existing adoption, confirms it is current, and exits without re-running the assessment. If the matching ADR is missing, it backfills the decision record via /capability-record-decision.

Does the architecture assessment work without a PRD?▼

Yes. If no PRD exists, the skill warns that it relies on developer-provided constraints and proceeds with the assessment using your input on team size, scale, and compliance needs.

What if the architecture guidelines are missing?▼

The skill degrades gracefully to a minimal decision framework, asking you to choose between Modular Monolith, Hexagonal, and Microservices based on team size and scale requirements.

Related Skills

Explore More Software Engineering Skills→
beliciobcardosobeliciobcardoso

architecture

Guides architecture decisions through requirements analysis, trade-off evaluation, and ADR documentation.

Community
Intermediate
foomakersfoomakers
6

pair-capability-record-decision

Record technical decisions as ADRs or ADLs and update adoption files.

Official
Advanced
Hopin-incHopin-inc
3

new-domain

Generate a DDD domain scaffold with standardized folder layout and template files.

Official
Advanced
david-driscolldavid-driscoll
1

architecture-review

Score proposed technology additions against a homelab architecture framework.

Community
Basic