# Build Framework Decision Matrices

Technical teams often need to compare frameworks with clear criteria and evidence. This skill turns analysis notes into structured matrices, trade-off summaries, and recommendations.

## Install

```bash
npx skillstore add dowwie/comparative-matrix
```

## Metadata

- Status: approved
- Slug: dowwie-comparative-matrix
- Skillstore revision: r1
- Version status: missing
- Tree hash: db80428b70de3d9f0a81065f58414df92c8f687090beb28efa3871039aa54d2f
- Author: Dowwie
- GitHub username: Dowwie
- License: MIT
- Repository: https://github.com/Dowwie/agent\_framework\_study/tree/main/.claude/skills/comparative-matrix
- Ref: 72d5025b022c77f7a51bdf5c1637c689c80e89d1
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/dowwie-comparative-matrix
- Manifest: https://skillstore.pages.dev/api/skills/dowwie-comparative-matrix/manifest

## Capabilities

- Creates side-by-side matrices for multiple frameworks or approaches.
- Normalizes findings into shared dimensions such as typing, async design, state, configuration, and extensibility.
- Applies decision heuristics for scalability, developer experience, and production readiness.
- Produces recommendation narratives with rationale and documented trade-offs.
- Organizes comparison outputs into summary, detailed analysis, recommendation, and trade-off sections.

## Use Cases

- Compare Agent Frameworks: Create a matrix that compares typing, async support, state handling, tools, and observability.
- Document Architecture Choices: Turn research notes into a recommendation document with clear rationale and trade-offs.
- Align Technical Stakeholders: Summarize competing options in a format that supports review meetings and final decisions.

## Prompt Templates

### Compare Two Options

```
Compare these two frameworks using typing, async support, state handling, configuration, and extensibility. Recommend one option for the stated project goals.
```

### Build a Selection Matrix

```
Create a decision matrix for these frameworks. Include shared dimensions, evidence for each option, recommendations per dimension, and a short final recommendation.
```

### Synthesize Prior Analysis

```
Use the provided analysis notes to normalize findings across frameworks. Produce a summary matrix, detailed dimension notes, and a trade-off log.
```

### Prepare an Architecture Decision

```
Create a recommendation report for a production architecture decision. Weight scalability, developer experience, operational risk, and migration cost, then explain the recommended path.
```

## Limitations

- Requires source analysis or user-provided findings before it can compare options.
- Does not validate claims against live documentation or benchmarks by itself.
- Does not choose a framework without stated goals, constraints, and priorities.
- Best suited to technical architecture choices, not general product reviews.

## Best Practices

- Provide evidence for each framework before asking for a recommendation.
- State the decision priorities before weighting trade-offs.
- Keep recommendations tied to specific project constraints.

## Anti Patterns

- Do not compare options using different criteria for each option.
- Do not ask for a final choice without describing goals and constraints.
- Do not treat the matrix as proof when the input evidence is incomplete.

## Security Audit

- Audited at: 2026-07-06T12:00:03.453\+00:00
- Summary: All static findings were reviewed against SKILL.md and are false positives caused by Markdown fences, inline artifact names, or comparison-table prose. No executable shell commands, system reconnaissance behavior, prompt injection, or malicious intent were found.

## Stats

- Views: 221
- Downloads: 9
- Favorites: 0
- Popularity score: 0