engineering-expert

Evaluate software architecture design decisions using ATAM-Lite and fitness-function frameworks.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/felixgeelhaar/skills --skill engineering-expert
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: engineering-expert
Source: https://github.com/felixgeelhaar/skills/tree/main/engineering-expert
Command: npx skills add https://github.com/felixgeelhaar/skills --skill engineering-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a practical, rigorous framework for evaluating software architecture using Socratic questioning, structured reviews, and evolutionary design principles to surface risks and trade-offs early.

Core Features & Use Cases

  • Socratic evaluator: prompts explicit reasoning, surfaces assumptions, and challenges architectural decisions.
  • Architecture reviewer: conducts ATAM-Lite style assessments, identifies risks, trade-offs, and fitness-function coverage.
  • Pairing partner: supports cross-domain thinking across product, UX, and AI architecture; integrates domain knowledge for better decisions.
  • Governance and guidance: supports ADR/RFC evaluation and ongoing architectural evolution in production.

Quick Start

Provide a system description and objectives, then ask me to perform an architecture assessment using Socratic questioning.

Frequently Asked Questions about engineering-expert

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

FAQPage Schema
What is ATAM-Lite architecture assessment and when do I need it?▼

Socratic questioning is a technique that prompts explicit reasoning and challenges architectural assumptions. It works by surfacing hidden trade-offs during design reviews, ensuring fitness function coverage and production-readiness considerations are addressed early.

How do I evaluate architecture trade-offs and risks for a multi-service platform?▼

You evaluate architecture trade-offs by providing a system description and objectives, then requesting a Socratic assessment. The process identifies quality attribute risks, documents explicit trade-offs, and analyzes failure modes using structured frameworks like Five Whys and fitness functions.

Can I use this for architecture governance and ADR reviews on single services?▼

Yes, this supports architecture governance and ADR reviews for single services. The evaluation framework applies to system designs at any scale, from single services to multi-service platforms, supporting ongoing architectural evolution and production-readiness checks.

What's the best way to document fitness functions for evolutionary architecture?▼

The best way to document fitness functions is through structured design reviews identifying required quality attributes and trade-offs. This ensures explicit coverage of production-readiness considerations and supports ongoing architectural governance and evolution.

Why does my architecture review miss failure modes and production-readiness risks?▼

Your architecture review likely misses failure modes because it lacks structured Socratic questioning and fitness-function frameworks. Applying ATAM-Lite assessments forces explicit trade-off documentation and surfaces hidden assumptions before production deployment.