pharaoh-decide

Record design decisions as sphinx-needs directives with decided_by, alternatives, and rationale.

24|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/useblocks/pharaoh --skill pharaoh-decide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pharaoh-decide
Source: https://github.com/useblocks/pharaoh/tree/main/skills/pharaoh-decide
Command: npx skills add https://github.com/useblocks/pharaoh --skill pharaoh-decide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Record design decisions as traceable sphinx-needs decision directives. Each decision captures the chosen option, rejected alternatives, rationale, and explicit links to the requirements or specifications it affects.

Core Features & Use Cases

  • Record decision with decided_by, alternatives, and rationale fields to support full traceability.
  • Link decisions to related needs and specifications to maintain a coherent decision history.
  • Reuse in workflows driven by pharaoh:spec to codify design outcomes and rationale.

Quick Start

Draft and store a new decision with a title, affected needs, decided_by, alternatives, and rationale to create a new decision entry.

Frequently Asked Questions about pharaoh-decide

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

FAQPage Schema
How do I record design decisions with traceability to requirements?

To record design decisions with traceability, you create sphinx-needs decision directives that capture the chosen option, rejected alternatives, and rationale, while explicitly linking to affected requirements or specifications to maintain a coherent decision history.

What is the best way to document rejected alternatives and rationale in Sphinx?

Documenting rejected alternatives and rationale in Sphinx requires creating decision directives that provide dedicated fields for alternatives and rationale, ensuring design outcomes and the reasoning behind them are fully codified for auditability.

How do I link design decisions to affected needs or specifications for auditability?

Linking design decisions to affected needs or specifications for auditability involves applying decision directives that establish explicit connections to those requirements, capturing who made the decision in the decided_by field to support full traceability.

Can I use sphinx-needs to track who made a design decision and why?

Yes, you can use sphinx-needs to track who made a design decision and why by utilizing the decided_by field to record the decision maker and the rationale field to document the reasoning, supporting complete auditability.

When do I need explicit decision directives for my project documentation?

You need explicit decision directives for project documentation when your project requires full traceability and auditability, ensuring that chosen options, rejected alternatives, and rationale are explicitly linked to affected needs and specifications.

Does pharaoh-decide work with sphinx-needs workflows to codify design outcomes?

Yes, pharaoh-decide works with sphinx-needs workflows by allowing you to draft and store decision entries that codify design outcomes, capturing the chosen option, alternatives, and rationale directly within pharaoh-driven workflows.