oliverv/caro / .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 | 9.9 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/stakeholder-synthesis.md
View on GitHub# Stakeholder Synthesis Protocol
Consult stakeholder agents only when the decision is cross-cutting enough to justify the cost.
## Consultation Thresholds
### Solo Analysis
Use when:
- single module or local subsystem
- no major cross-domain effects
- decision can be made from direct code/context analysis
### Targeted Consultation
Consult 1-3 agents when:
- the decision affects multiple layers
- tradeoffs are real but bounded
- specific specialist input is needed
Typical pairings (agent ids, not skill names — see the mapping table in `.agents/workflows/orchestrate.md`):
- `pm`: business constraints, scope, product priorities
- `backend`: service/API/domain concerns
- `db`: data ownership, schema, consistency
- `tf-infra`: deployment and operational architecture
- `qa`: risk, performance, security, testability
- `frontend` / `mobile`: client integration and complexity costs
### Full Stakeholder Sweep
Use when:
- architecture is system-wide
- multiple teams/domains are materially affected
- the decision will constrain future roadmap work
## Dispatch Mechanics
Consultation is a real subagent call, not an imagined persona.
1. Resolve dispatch per the project's Per-Agent Dispatch rules (`target_vendor_for_agent` in `.agents/oma-config.yaml`):
- same vendor as the current runtime → the runtime's native subagent path (e.g., Claude Code Agent tool)
- different vendor, or no native subagent support → `oma agent spawn <agent>` for that agent only
2. Give each consulted agent a bounded charter:
- the decision in one sentence
- constraints that are already fixed (not up for debate)
- the specific question for that specialty
- expected output: position plus top risk, 10 lines or fewer
3. One round only by default; a second round requires a named unresolved conflict.
4. Cost bound: targeted consultation is 1-3 agents. A full sweep must state its cross-cutting justification in the artifact.
## Synthesis Rules
1. Capture perspectives as inputs, not votes
2. Separate:
- agreements
- conflicts
- assumptions
3. Name the real tradeoff behind disagreements
4. Make an explicit recommendation even if perspectives differ
5. If user decision is required, present framed options rather than an unstructured summary
## Output Section
Include a section like:
```md
## Stakeholder Perspectives
- PM: ...
- Backend: ...
- DB: ...
## Agreements
- ...
## Tensions
- ...
## Recommendation
- ...
```
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 |