Skip to content

gracefullight/pkgs / .agents/skills/oma-architecture

oma-architecture

Verified

Evaluate system boundaries and architectural tradeoffs. Use for architecture decisions, design reviews, and ADRs.

resources/methodology-selection.md

View on GitHub
# Methodology Selection Guide

Choose the lightest method that fits the problem.

## 1. Diagnostic Mode

Use when:
- the complaint is vague
- the user feels pain but cannot name the architecture issue
- it is unclear whether the problem is architecture, planning, QA, or debugging

Output:
- clarified problem statement
- why this is an architecture concern
- recommended next mode

## 2. Recommendation Mode

Use when:
- the decision is concrete
- the user wants an architectural direction
- the analysis does not require formal quality-attribute scenarios

Output:
- options
- tradeoff comparison
- recommendation

## 3. Design-Twice Mode

Use when:
- the decision is structural and likely to harden into the codebase
- the first obvious option may anchor the team too early
- interface, boundary, or decomposition choices are material

Output:
- two or more materially different options
- comparison and synthesis

## 4. ATAM-style Mode

Use when:
- the user asks for architecture review, tradeoffs, risks, or quality attributes
- reliability, performance, modifiability, security, or operability are central
- scenario-based evaluation is needed

Output:
- scenarios
- sensitivity points
- tradeoff points
- risks and non-risks

## 5. CBAM-style Mode

Use when:
- the user asks what to prioritize or invest in first
- the decision is economic or sequencing-oriented
- multiple architecture improvements compete for time and budget

Output:
- cost/benefit comparison
- sequencing recommendation

## 6. ADR Mode

Use when:
- the analysis is done and the team needs a portable record
- a concise decision artifact is the deliverable

Output:
- context
- decision
- alternatives
- consequences

## Recommendation vs Design-Twice

Both modes compare options; the difference is where the discipline sits:

- **Recommendation Mode** starts from options that already exist or are obvious — the work is the comparison and the call.
- **Design-Twice Mode** exists to *generate* a genuinely different second design before comparing — use it when the obvious first option would anchor the team too early.

Litmus test: if you cannot name a materially different second decomposition, you are in Recommendation Mode.

## Selection Heuristics

- Start with Diagnostic Mode if the problem is fuzzy
- Default to Recommendation Mode if the decision is clear and moderate in scope
- Upgrade to Design-Twice Mode for material structural choices
- Upgrade to ATAM-style Mode for quality-attribute and risk-heavy reviews
- Upgrade to CBAM-style Mode for investment prioritization
- Finish with ADR Mode when a durable decision record is useful
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall