$craft:decision-make

Usage:

• $craft:decision-make <question> makes one decision.
• $craft:decision-make <decision id> --revisit reopens a recorded decision against new facts.

Scope: one decision, from question to recorded choice, including the research it rests on,
done through $craft:research. Not in scope: implementing the choice.

Inputs: the question in one sentence, the drivers forcing it, and any research already done.
Output: a decision with context, prior art, options, criteria, choice, consequences,
and reopen conditions, ready to record.

Steps

1. Write the question as a choice between concrete alternatives. Name the drivers that force
   it now and the standards or principles that bound it.

2. Check the recorded decisions for one that already answers it. If one does, stop and point
   at it, or switch to --revisit.

3. Research with $craft:research, reusing research already done when it still holds. Cover
   two things:

   • Facts the choice rests on: current behaviour, constraints and limits, each verified
     against code, docs or a run, or marked inferred.
   • Prior art: how existing tools, libraries, standards and this repo's own past decisions
     solve the same problem, and which distinct patterns they use. Prefer primary sources;
     record each with its URL or path and the date read.

   Write a Prior art section: one row per system or pattern, what it does, and whether you
   adopt it, borrow from it or reject it, with the reason. When nothing applies, keep the section
   and write None found: with why.

4. Write the criteria before the options, each one measurable or at least checkable.

5. Write two to four options. Include at least one pattern found in step 3 that differs from
   your first idea, or say that none was found. For each option: what it is in one paragraph,
   what it costs, what it forecloses, and how it scores against each criterion.

6. Choose. Say why the others lost in one line each. Say what new fact would reopen the
   choice.

7. Write the consequences: what changes now, what work it creates, and which entities it
   supersedes or amends.

Grading

• The question names concrete alternatives, and the drivers are entities or named pressures.
• Facts the choice rests on are marked verified or inferred.
• A Prior art section names the systems or patterns surveyed, each with a source and a
  verdict: adopt, borrow or reject.
• At least one option comes from prior art, or the decision says none was found.
• The criteria appear before the options.
• Every option has a cost, a foreclosure, and a score per criterion.
• The choice names what would reopen it.
• The consequences name the entities they touch.

Test environment

A scratch corpus with one driver and one standard. Make a decision the standard constrains,
and confirm the standard appears in step 1 and rules out at least one option. Add one recorded
decision that solved a similar problem another way, and confirm it appears in Prior art.