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.