archify-review

Review issues, pull requests, and code changes through value, cost, and impact analysis.

83.7k|5.7k|Updated Apr 15, 2026
Ready to run
npx skills add https://github.com/tt-a1i/archify --skill archify-review-tt-a1i
💬 Prompt for ChatGPT / Claude Chat▼
Please help me install this Agent Skill.
Skill: archify-review
Source: https://github.com/tt-a1i/archify/tree/main/.agents/skills/archify-review
Command: npx skills add https://github.com/tt-a1i/archify --skill archify-review-tt-a1i

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers often struggle to decide whether an issue is worth fixing or a change is worth merging. This Skill provides a structured, evidence-based framework for triaging issues, reviewing pull requests, and assessing code quality so maintenance decisions are grounded in facts rather than intuition. ## Core Features & Use Cases - Three-Dimension Evaluation: Judges every problem and approach through Value (who benefits, how often, consequences), Cost (implementation, verification, and long-term maintenance effort), and Impact (affected behavior, coupling, future constraints). - Evidence-Based Reasoning: Distinguishes direct verification from existing evidence and assumptions, and selects checks that resolve the key uncertainties before drawing conclusions. - Decision-Oriented Output: Explains whether the work is worthwhile, the approach's cost and impact, better alternatives, and unresolved questions that matter to the decision. - Use Case: When a contributor opens a PR adding a new feature, use this Skill to weigh its real user value against the maintenance burden it introduces, then produce a reasoned review verdict. ## Quick Start Review the open pull request for the new diagram export feature and assess whether it is worth merging based on value, cost, and impact.

Frequently Asked Questions about archify-review

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

FAQPage Schema
How do I review a pull request for maintainability?▼

Evaluate the change across three dimensions: value (the real problem and who benefits), cost (implementation and future maintenance effort), and impact (affected behavior and coupling). Ground each judgment in verified evidence rather than assumptions.

How to triage GitHub issues before fixing them?▼

Identify the real problem, who benefits, how often it occurs, and its consequences to decide if it is worth addressing now. Then weigh the fix's implementation cost against its long-term maintenance burden before committing.

What criteria should code review decisions be based on?▼

Base decisions on value, cost, and impact, considering maintainability, complexity, compatibility, and performance within those dimensions. Verify the target revision and relevant facts, and distinguish direct verification from assumptions.

When should a proposed change be rejected during review?▼

Reject a change when its cost and impact outweigh its value, such as when it adds coupling or constraints disproportionate to the problem it solves. Prefer existing capabilities and solutions proportional to the problem.

Does this review approach work for any repository?▼

The value-cost-impact framework applies generally to issue triage and change reviews. For repository-specific requirements, it defers to the project's REVIEWING.md and CONTRIBUTING.md documents.