one-three-one-rule

Structure technical decisions into one problem, three options, and one recommendation.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/zerwiz/wayofpi --skill one-three-one-rule-zerwiz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: one-three-one-rule
Source: https://github.com/zerwiz/wayofpi/tree/main/.hermes/hermes-agent/optional-skills/communication/one-three-one-rule
Command: npx skills add https://github.com/zerwiz/wayofpi --skill one-three-one-rule-zerwiz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you make and communicate technical decisions when several valid approaches exist and the trade-offs are not obvious.

Core Features & Use Cases

  • Decision Framing: Reduces complex choices to one clear problem statement.
  • Option Comparison: Presents exactly three viable approaches with practical pros and cons.
  • Actionable Recommendation: Concludes with one recommended path, a definition of done, and an implementation plan.
  • Use Case: Use it for architecture decisions, tool selection, refactoring strategies, migration planning, or stakeholder proposals.

Quick Start

Ask for a 1-3-1 analysis of your decision and include the alternatives you are considering.

Frequently Asked Questions about one-three-one-rule

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

FAQPage Schema
How do I structure a technical recommendation for architecture trade-offs?

Structure technical recommendations by defining one problem statement, comparing three viable options with pros and cons, and concluding with one recommendation, a definition of done, and an implementation plan.

What is the best way to present tool selection options to stakeholders?

The best way to present tool selection to stakeholders is a 1-3-1 format: one concise problem statement, three distinct approaches with practical pros and cons, and a single actionable recommendation with an implementation plan.

How do I write a migration proposal when multiple viable paths exist?

Write a migration proposal by framing the decision as one problem, presenting exactly three options with trade-offs, and selecting one recommendation with a definition of done and an implementation plan.

Can I use this approach for refactoring strategies, or is it only for architecture choices?

Yes, you can use this approach for refactoring strategies, architecture choices, tooling trade-offs, and migration planning whenever multiple viable paths exist and trade-offs are not obvious.

When do I need a formal decision-making format for technical choices?

You need a formal decision-making format when several valid technical approaches exist and the trade-offs between them are not obvious, requiring structured comparison to reach an actionable recommendation.

Does the one-three-one format require an implementation plan for the recommended option?

Yes, the one-three-one format requires an implementation plan for the recommended option, along with a definition of done, to ensure the technical decision translates into actionable steps.