When to invoke
Invoke when the user says "I decided X", "let's go with Y", "the answer is Z", "go ahead with", "approved", or otherwise resolves a parked card. The Andon-cord lowering action — pull-card raises the gate; this skill is the human's one-action handoff so pull-card can resume.
Decide a card
The Andon-cord loop: the pull-card skill raises human_gate
(none → decision / session) when it hits a question only a human
can answer; this skill lowers the gate back to none in one cheap
action. The card comes out open — one parked while active
(pull-card claims before it works) is released back to the queue —
so the next pull-card claims and implements per the recorded
decision. Humans resolve the cause;
agents wield the wrench — and an agent that can cite the project
rubric MAY decide on its own behalf (lazy Andon, below).
Edge cases live in reference.md — a sibling file in this
skill's directory. Read the named section only when the situation
actually applies:
| Situation |
reference.md section |
| Presenting labeled options via AskUserQuestion |
Mirroring labeled options |
| The decision reverses / re-scopes a stated verdict |
Re-scope reconciliation |
| An agent recorded a decision it shouldn't have |
Rewinding an agent decision |
| Why the cord must be cheap to lower |
Rationale |
What this skill does to the card
Body. Replaces the ## Decision required section (or appends
a fresh ## Decision section) with:
## Decision
*Resolved YYYY-MM-DD:* <one-line decision>
*Reasoning:* <one-line why>
log.md. Appends up to two entries, timeline-ordered: first an
archive of the prior ## Decision required content (the options
and trade-offs the README rewrite would otherwise lose), then the
resolution (<decision> — <reason>. Gate <prior> → none.).
Frontmatter. Flips human_gate: decision (or session) →
none. An open card stays open. An active card (parked
mid-work) returns to open with its worker kept, because
active + gate none reads as a live claim that no queue lists;
to keep working it in the same session, re-claim it with
goc status <title> active.
Refuses (exit 2, nothing written) if the gate is already
none, the title doesn't exist, or --decision / --because is
blank.
Workflow
Read the card body (goc show <title>). Confirm the decision
actually answers the parked question: if ## Decision required
enumerates options A/B/C, the user's free-text decision should map
onto one (or explicitly reject all and propose D). When eliciting
the pick with AskUserQuestion, mirror the body's option labels and
order verbatim — do not reorder or rephrase (reference.md
§ Mirroring labeled options).
Then check advanced_by for unclosed prerequisites, and read any
you find before recording. An advances edge does not record
whether it is strict, so the only way to learn that a prerequisite
reframes this card is to open it. Lowering the gate is what makes
the card autonomously pullable, so a decision taken over an unread
prerequisite is one an unattended worker may act on before any human
sees the card again. goc decide prints the same advisory
(non-blocking — it names the prerequisites and lowers the gate
anyway), but it prints it as the decision lands, which is too late
to inform it.
Run the CLI.
goc decide <title> \
--decision "<one-line what>" \
--because "<one-line why>"
Commit follows repo policy. goc decide honors
.game-of-cards/config.yaml workflow.auto_commit (default
true), committing body + log + gate flip as
decide: <title> — <decision>. Override per invocation with
--no-commit / --commit.
If the decision reverses or re-scopes a verdict the card already
states, goc decide only writes the ## Decision block — every
other surface still asserting the old verdict is now stale. Reconcile
by hand: the summary: frontmatter, any > ⚠ body banner, DoD
wording, and mentions in neighbor cards. The CLI prints a reminder on
re-scope language and goc validate flags
DECISION_CONTRADICTS_VERDICT. For a true re-scope, prefer
supersede + create over an in-place rewrite. Full checklist:
reference.md § Re-scope reconciliation.
When an agent invokes this skill (lazy Andon)
An agent may decide on its own only after consulting the consuming
repo's project-specific rubric:
cat .game-of-cards/hooks/decide-card.md 2>/dev/null || true
- Cite the rubric.
--because MUST start with a clause naming
the rubric consulted and what it returned (citation form per the
hook above).
- Cite the primary source when the answer rests on literature:
DOI/PMID, textbook chapter, or project-doc section.
- No agent-decide for human-judgement questions — resource
allocation, scope splits, deadlines, stakeholder alignment, taste
calls. Raise the gate instead.
- Default to human when ambiguous. If the rubric doesn't give a
clean answer, raise the gate; don't guess.
A decision recorded in violation of this contract can be rewound —
reference.md § Rewinding an agent decision.
When NOT to use this skill
- Card needs implementation, not a decision. If you're ready to
do the work yourself, just do the work.
- Decision changes scope. "Scope this differently / split /
reframe" is not a resolution — use
the
advance-card skill (with <title> superseded) +
the create-card skill for the replacement.
- Gate is
session and the session never happened. Capturing a
real session's outcome is valid; shortcutting a session that
never took place is not — schedule the session instead.
What this skill does NOT do
- Does NOT implement the card (that's
pull-card's next round).
- Does NOT close the card (that's the
finish-card skill's DoD-gated
contract).
- Does NOT mutate
status, except to release a parked claim
(active → open, above).
Cross-references
reference.md (this skill's directory) — edge cases routed above.
- the
scan-deck skill — surfaces parked cards; its "decisions to make"
Q&A calls this skill per card.
- the
advance-card skill — status machine + waiting_on overlay; gate
≠ status.
- the
card-schema skill — human_gate enum and the ## Decision required body convention.
Sibling files on this host
This skill ships reference.md alongside its body. If a direct file read fails (sandboxed sessions cannot see the plugin install path), fetch the file through the goc tool: {verb: "skill", args: ["decide-card", "<file>"]}.
1---2name: decide-card-33description: Record a decision (what + why) on a parked card and lower the human gate from decision or session to none. AUTO-INVOKE on "I decided X", "let's go with Y", "approved", or any resolution of a parked card — the human's one-action handoff so pull-card can resume. If the catalog location path is unreadable, fetch the body via the goc tool verb "skill", args ["decide-card"].4metadata:5 source: https://skillmd.com/skills/zauberzeug/decide-card-36---78## When to invoke910Invoke when the user says "I decided X", "let's go with Y", "the answer is Z", "go ahead with", "approved", or otherwise resolves a parked card. The Andon-cord lowering action — pull-card raises the gate; this skill is the human's one-action handoff so pull-card can resume.1112# Decide a card1314The Andon-cord loop: the `pull-card` skill raises `human_gate`15(`none → decision` / `session`) when it hits a question only a human16can answer; this skill lowers the gate back to `none` in one cheap17action. The card comes out `open` — one parked while `active`18(pull-card claims before it works) is released back to the queue —19so the next `pull-card` claims and implements per the recorded20decision. Humans resolve the cause;21agents wield the wrench — and an agent that can cite the project22rubric MAY decide on its own behalf (lazy Andon, below).2324**Edge cases live in `reference.md`** — a sibling file in this25skill's directory. Read the named section only when the situation26actually applies:2728| Situation | `reference.md` section |29|---|---|30| Presenting labeled options via AskUserQuestion | Mirroring labeled options |31| The decision reverses / re-scopes a stated verdict | Re-scope reconciliation |32| An agent recorded a decision it shouldn't have | Rewinding an agent decision |33| Why the cord must be cheap to lower | Rationale |3435## What this skill does to the card36371. **Body.** Replaces the `## Decision required` section (or appends38 a fresh `## Decision` section) with:3940 ```41 ## Decision4243 *Resolved YYYY-MM-DD:* <one-line decision>4445 *Reasoning:* <one-line why>46 ```47482. **log.md.** Appends up to two entries, timeline-ordered: first an49 archive of the prior `## Decision required` content (the options50 and trade-offs the README rewrite would otherwise lose), then the51 resolution (`<decision> — <reason>. Gate <prior> → none.`).52533. **Frontmatter.** Flips `human_gate: decision` (or `session`) →54 `none`. An `open` card stays `open`. An `active` card (parked55 mid-work) returns to `open` with its `worker` kept, because56 `active` + gate `none` reads as a live claim that no queue lists;57 to keep working it in the same session, re-claim it with58 `goc status <title> active`.59604. **Refuses** (exit 2, nothing written) if the gate is already61 `none`, the title doesn't exist, or `--decision` / `--because` is62 blank.6364## Workflow65661. **Read the card body** (`goc show <title>`). Confirm the decision67 actually answers the parked question: if `## Decision required`68 enumerates options A/B/C, the user's free-text decision should map69 onto one (or explicitly reject all and propose D). When eliciting70 the pick with AskUserQuestion, mirror the body's option labels and71 order verbatim — do not reorder or rephrase (`reference.md`72 § Mirroring labeled options).7374 **Then check `advanced_by` for unclosed prerequisites, and read any75 you find before recording.** An `advances` edge does not record76 whether it is strict, so the only way to learn that a prerequisite77 *reframes* this card is to open it. Lowering the gate is what makes78 the card autonomously pullable, so a decision taken over an unread79 prerequisite is one an unattended worker may act on before any human80 sees the card again. `goc decide` prints the same advisory81 (non-blocking — it names the prerequisites and lowers the gate82 anyway), but it prints it as the decision lands, which is too late83 to inform it.84852. **Run the CLI.**8687 ```bash88 goc decide <title> \89 --decision "<one-line what>" \90 --because "<one-line why>"91 ```92933. **Commit follows repo policy.** `goc decide` honors94 `.game-of-cards/config.yaml` `workflow.auto_commit` (default95 `true`), committing body + log + gate flip as96 `decide: <title> — <decision>`. Override per invocation with97 `--no-commit` / `--commit`.9899If the decision **reverses or re-scopes a verdict the card already100states**, `goc decide` only writes the `## Decision` block — every101other surface still asserting the old verdict is now stale. Reconcile102by hand: the `summary:` frontmatter, any `> ⚠` body banner, DoD103wording, and mentions in neighbor cards. The CLI prints a reminder on104re-scope language and `goc validate` flags105`DECISION_CONTRADICTS_VERDICT`. For a true re-scope, prefer106supersede + create over an in-place rewrite. Full checklist:107`reference.md` § Re-scope reconciliation.108109## When an agent invokes this skill (lazy Andon)110111An agent may decide *on its own* only after consulting the consuming112repo's project-specific rubric:113114`cat .game-of-cards/hooks/decide-card.md 2>/dev/null || true`1151161. **Cite the rubric.** `--because` MUST start with a clause naming117 the rubric consulted and what it returned (citation form per the118 hook above).1192. **Cite the primary source** when the answer rests on literature:120 DOI/PMID, textbook chapter, or project-doc section.1213. **No agent-decide for human-judgement questions** — resource122 allocation, scope splits, deadlines, stakeholder alignment, taste123 calls. Raise the gate instead.1244. **Default to human when ambiguous.** If the rubric doesn't give a125 clean answer, raise the gate; don't guess.126127A decision recorded in violation of this contract can be rewound —128`reference.md` § Rewinding an agent decision.129130## When NOT to use this skill131132- **Card needs implementation, not a decision.** If you're ready to133 do the work yourself, just do the work.134- **Decision changes scope.** "Scope this differently / split /135 reframe" is not a resolution — use136 the `advance-card` skill (with `<title> superseded`) +137 the `create-card` skill for the replacement.138- **Gate is `session` and the session never happened.** Capturing a139 real session's outcome is valid; shortcutting a session that140 never took place is not — schedule the session instead.141142## What this skill does NOT do143144- Does NOT implement the card (that's `pull-card`'s next round).145- Does NOT close the card (that's the `finish-card` skill's DoD-gated146 contract).147- Does NOT mutate `status`, except to release a parked claim148 (`active` → `open`, above).149150## Cross-references151152- `reference.md` (this skill's directory) — edge cases routed above.153- the `scan-deck` skill — surfaces parked cards; its "decisions to make"154 Q&A calls this skill per card.155- the `advance-card` skill — status machine + `waiting_on` overlay; gate156 ≠ status.157- the `card-schema` skill — `human_gate` enum and the `## Decision158 required` body convention.159160## Sibling files on this host161162This skill ships `reference.md` alongside its body. If a direct file read fails (sandboxed sessions cannot see the plugin install path), fetch the file through the goc tool: `{verb: "skill", args: ["decide-card", "<file>"]}`.