multi-approach-architecture

Document 2–3 architectural trade-off options in ai-work.md for non-trivial subtasks.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/KingSharkG/ai-agents-workflow --skill multi-approach-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: multi-approach-architecture
Source: https://github.com/KingSharkG/ai-agents-workflow/tree/main/skills/multi-approach-architecture
Command: npx skills add https://github.com/KingSharkG/ai-agents-workflow --skill multi-approach-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surface multiple architectural trade-offs for non-trivial subtasks to prevent premature commitment and accelerate consensus before drafting a TEP.

Core Features & Use Cases

  • Enumerates 2–3 competing approaches with explicit trade-offs rather than silently selecting one.
  • Anchors decisions to existing codebase patterns and prior exploration-notes to ensure coherence.
  • Produces an architecture-options fragment appended to ai-work.md to guide TEPlike drafting.

Quick Start

Provide 2–3 architecture options for the given subtask and append the architecture-options block to the subtask's ai-work.md.

Frequently Asked Questions about multi-approach-architecture

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

FAQPage Schema
How do I present architectural trade-offs for complex subtasks?

To present architectural trade-offs, enumerate 2–3 competing approaches with explicit risk, coupling, and abstraction differences rather than silently selecting one. This surfaces viable patterns to prevent premature commitment before drafting technical proposals.

What is the best way to document architecture options before committing to a design?

Documenting architecture options requires appending an architecture-options block to your ai-work.md file. This fragment captures competing approaches and their TEPlike implications, anchoring decisions to existing codebase patterns and prior exploration-notes.

When do I need to evaluate multiple architecture patterns for a subtask?

You need to evaluate multiple architecture patterns when subtask complexity is medium or hard and multiple viable patterns exist. Applying this process to simple tasks with an obvious solution introduces unnecessary overhead.

How do I justify architectural design decisions in a technical proposal?

Justify architectural design decisions by relying on exploration-notes and existing codebase patterns to validate option choices. Clearly define each approach's risk, coupling, and abstraction axes to enable informed TEPlike consensus.

Why should I avoid picking a single architecture pattern early in subtask planning?

Avoiding early single pattern selection prevents premature commitment and accelerates team consensus. Enumerating 2–3 trade-off paths up front exposes TEPlike implications and architectural constraints before drafting final technical proposals.

Can I use existing codebase patterns to guide architectural trade-off analysis?

Yes, existing codebase patterns are essential for guiding architectural trade-off analysis. Anchoring enumerated options to prior exploration-notes and established patterns ensures coherence and validates the risk, coupling, and abstraction axes of each approach.