aped-design-twice

Generate two structurally distinct architecture designs with a trade-off matrix.

2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/yabafre/aped-claude --skill aped-design-twice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aped-design-twice
Source: https://github.com/yabafre/aped-claude/tree/main/src/templates/skills/aped-design-twice
Command: npx skills add https://github.com/yabafre/aped-claude --skill aped-design-twice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents premature design lock-in by forcing you to explore two structurally different, viable options before you choose a direction.

Core Features & Use Cases

  • Dual design exploration: generates Design A as the obvious first pass and then Design B as a forced alternative on a different structural axis.
  • Trade-off matrix: compares complexity, performance, maintainability, migration risk, and team familiarity to make the choice explicit.
  • Clear user decision: recommends one option while making it unambiguous that the user selects which design to proceed with.
  • Architecture handoff: writes the chosen result into {{OUTPUT_DIR}}/architecture.md (or feeds it to aped-arch) and records the rejected option for future reference.

Quick Start

Run aped-method in your Claude Code project and invoke this skill when you want a second design option for the same requirement.

Frequently Asked Questions about aped-design-twice

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

FAQPage Schema
How do I avoid premature architecture lock-in when designing a new system?

To avoid premature lock-in, force a dual architectural design exploration that generates two structurally distinct options before committing. This approach produces a trade-off matrix comparing complexity, performance, and maintainability to make the choice explicit.

What is a trade-off matrix for architectural decision making?

A trade-off matrix for architectural decision making compares viable designs across complexity, performance, maintainability, migration risk, and team familiarity. It makes the structural differences between designs explicit so users can make an informed selection.

How do I document a second opinion architecture review for a single requirement?

Document a second opinion architecture review by producing two viable and structurally distinct designs for the same requirement, capturing the user's explicit selection, and writing the chosen design to an output file while recording the rejected alternative for future reference.

Can I use dual design exploration for alternative architecture proposals?

Yes, you can use dual design exploration for alternative architecture proposals. It generates an obvious first pass design and then a forced alternative on a different structural axis, requiring no external dependencies to produce both viable options for comparison.

What's the best way to compare trade-offs in software design?

The best way to compare trade-offs in software design is generating two structurally distinct architectures and evaluating them via a matrix covering complexity, performance, maintainability, migration risk, and team familiarity to guide the final selection.

Does dual architecture design exploration require any specific frameworks or dependencies?

No, dual architecture design exploration requires no external dependencies or specific frameworks. It operates by reading relevant requirement artifacts and producing two structurally distinct viable designs with a comparative trade-off matrix.