gracefullight/pkgs / .agents/skills/oma-architecture
oma-architecture
VerifiedEvaluate system boundaries and architectural tradeoffs. Use for architecture decisions, design reviews, and ADRs.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.0 KB |
| resources/api-evolution.md | markdown | 4.1 KB |
| resources/checklist.md | markdown | 1.7 KB |
| resources/execution-protocol.md | markdown | 5.2 KB |
| resources/methodology-selection.md | markdown | 2.6 KB |
| resources/migration-patterns.md | markdown | 2.8 KB |
| resources/output-templates.md | markdown | 2.1 KB |
| resources/stakeholder-synthesis.md | markdown | 2.4 KB |
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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |