decision-interview

Asks targeted decision questions and records locked engineering decisions in DECISIONS.md using EARS templates.

6|Updated Jul 10, 2026
One-click install
npx skills add https://github.com/Mozurok/fhorja.dev --skill decision-interview-mozurok
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decision-interview
Source: https://github.com/Mozurok/fhorja.dev/tree/main/.claude/skills/decision-interview
Command: npx skills add https://github.com/Mozurok/fhorja.dev --skill decision-interview-mozurok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering tasks often stall or go wrong because key behavioral, data-integrity, rollout, or test decisions were never explicitly made. This Skill surfaces the minimum set of high-value decision questions before planning, and persists approved answers as canonical, auditable decisions on disk. ## Core Features & Use Cases - Decision-focused interviewing: Separates genuine decisions (multiple viable alternatives) from facts, and asks only questions that affect correctness, runtime behavior, data integrity, test strategy, or rollout safety. - Canonical decision persistence: Records locked decisions in DECISIONS.md using EARS requirement templates with SHA-256 verification logging, and updates TASK_STATE.md accordingly. - Lock-signal handling: Recognizes explicit user lock signals (e.g. "D2 [LOCK]", "approved") to persist decisions in the same turn, and stalls safely in unattended runs. - Use Case: Before planning a payment retry feature, run the interview to confirm how refunds, retries, and chargebacks behave across flows, then lock the answers as EARS-shaped decisions that planning and implementation must follow. ## Quick Start Run the decision-interview skill on my active task to identify and lock the open behavioral decisions before implementation planning.

Frequently Asked Questions about decision-interview

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

FAQPage Schema
How do I lock engineering decisions before implementation planning?▼

Run the decision interview on your active task folder. It reads TASK_STATE.md and related artifacts, asks targeted questions about behavior, data integrity, rollout, and testing, then persists your approved answers as EARS-formatted entries in DECISIONS.md.

What is the difference between a decision and a fact in task planning?▼

A decision has two or more viable alternatives with different tradeoffs, while a fact has only one reasonable answer given the codebase and spec. Facts belong in SOURCE_OF_TRUTH.md; only genuine decisions are recorded in DECISIONS.md.

When should I not use a decision interview?▼

Skip it when missing information is purely factual, when decisions are already locked in code or approved artifacts, or when the task is already in implementation with no correctness-critical ambiguity. In those cases it returns a no-op and routes onward.

Can a decision interview run unattended without a human?▼

It can run, but it will not self-answer or lock anything. Open questions are recorded as PROPOSED blocks with candidate defaults, and the run stalls until a human provides an explicit lock signal in a later session.

How are locked decisions protected against tampering?▼

Each write to DECISIONS.md adds a transaction header and appends a JSON line to a verification log with SHA-256 digests of the section before and after the write. Superseded decisions are preserved via new entries rather than edited in place.