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: Skill(pull-card) 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
Skill(advance-card) <title> superseded +
Skill(create-card) 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
Skill(finish-card)'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.
Skill(scan-deck) — surfaces parked cards; its "decisions to make"
Q&A calls this skill per card.
Skill(advance-card) — status machine + waiting_on overlay; gate
≠ status.
Skill(card-schema) — human_gate enum and the ## Decision required body convention.
1---2name: decide-card-23description: 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.4argument-hint: <title> --decision "<one-line what>" --because "<one-line why>"5metadata:6 source: https://skillmd.com/skills/zauberzeug/decide-card-27---89## When to invoke1011Invoke 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.1213# Decide a card1415The Andon-cord loop: `Skill(pull-card)` raises `human_gate`16(`none → decision` / `session`) when it hits a question only a human17can answer; this skill lowers the gate back to `none` in one cheap18action. The card comes out `open` — one parked while `active`19(pull-card claims before it works) is released back to the queue —20so the next `pull-card` claims and implements per the recorded21decision. Humans resolve the cause;22agents wield the wrench — and an agent that can cite the project23rubric MAY decide on its own behalf (lazy Andon, below).2425**Edge cases live in `reference.md`** — a sibling file in this26skill's directory. Read the named section only when the situation27actually applies:2829| Situation | `reference.md` section |30|---|---|31| Presenting labeled options via AskUserQuestion | Mirroring labeled options |32| The decision reverses / re-scopes a stated verdict | Re-scope reconciliation |33| An agent recorded a decision it shouldn't have | Rewinding an agent decision |34| Why the cord must be cheap to lower | Rationale |3536## What this skill does to the card37381. **Body.** Replaces the `## Decision required` section (or appends39 a fresh `## Decision` section) with:4041 ```42 ## Decision4344 *Resolved YYYY-MM-DD:* <one-line decision>4546 *Reasoning:* <one-line why>47 ```48492. **log.md.** Appends up to two entries, timeline-ordered: first an50 archive of the prior `## Decision required` content (the options51 and trade-offs the README rewrite would otherwise lose), then the52 resolution (`<decision> — <reason>. Gate <prior> → none.`).53543. **Frontmatter.** Flips `human_gate: decision` (or `session`) →55 `none`. An `open` card stays `open`. An `active` card (parked56 mid-work) returns to `open` with its `worker` kept, because57 `active` + gate `none` reads as a live claim that no queue lists;58 to keep working it in the same session, re-claim it with59 `goc status <title> active`.60614. **Refuses** (exit 2, nothing written) if the gate is already62 `none`, the title doesn't exist, or `--decision` / `--because` is63 blank.6465## Workflow66671. **Read the card body** (`goc show <title>`). Confirm the decision68 actually answers the parked question: if `## Decision required`69 enumerates options A/B/C, the user's free-text decision should map70 onto one (or explicitly reject all and propose D). When eliciting71 the pick with AskUserQuestion, mirror the body's option labels and72 order verbatim — do not reorder or rephrase (`reference.md`73 § Mirroring labeled options).7475 **Then check `advanced_by` for unclosed prerequisites, and read any76 you find before recording.** An `advances` edge does not record77 whether it is strict, so the only way to learn that a prerequisite78 *reframes* this card is to open it. Lowering the gate is what makes79 the card autonomously pullable, so a decision taken over an unread80 prerequisite is one an unattended worker may act on before any human81 sees the card again. `goc decide` prints the same advisory82 (non-blocking — it names the prerequisites and lowers the gate83 anyway), but it prints it as the decision lands, which is too late84 to inform it.85862. **Run the CLI.**8788 ```bash89 goc decide <title> \90 --decision "<one-line what>" \91 --because "<one-line why>"92 ```93943. **Commit follows repo policy.** `goc decide` honors95 `.game-of-cards/config.yaml` `workflow.auto_commit` (default96 `true`), committing body + log + gate flip as97 `decide: <title> — <decision>`. Override per invocation with98 `--no-commit` / `--commit`.99100If the decision **reverses or re-scopes a verdict the card already101states**, `goc decide` only writes the `## Decision` block — every102other surface still asserting the old verdict is now stale. Reconcile103by hand: the `summary:` frontmatter, any `> ⚠` body banner, DoD104wording, and mentions in neighbor cards. The CLI prints a reminder on105re-scope language and `goc validate` flags106`DECISION_CONTRADICTS_VERDICT`. For a true re-scope, prefer107supersede + create over an in-place rewrite. Full checklist:108`reference.md` § Re-scope reconciliation.109110## When an agent invokes this skill (lazy Andon)111112An agent may decide *on its own* only after consulting the consuming113repo's project-specific rubric:114115!`cat .game-of-cards/hooks/decide-card.md 2>/dev/null || true`1161171. **Cite the rubric.** `--because` MUST start with a clause naming118 the rubric consulted and what it returned (citation form per the119 hook above).1202. **Cite the primary source** when the answer rests on literature:121 DOI/PMID, textbook chapter, or project-doc section.1223. **No agent-decide for human-judgement questions** — resource123 allocation, scope splits, deadlines, stakeholder alignment, taste124 calls. Raise the gate instead.1254. **Default to human when ambiguous.** If the rubric doesn't give a126 clean answer, raise the gate; don't guess.127128A decision recorded in violation of this contract can be rewound —129`reference.md` § Rewinding an agent decision.130131## When NOT to use this skill132133- **Card needs implementation, not a decision.** If you're ready to134 do the work yourself, just do the work.135- **Decision changes scope.** "Scope this differently / split /136 reframe" is not a resolution — use137 `Skill(advance-card) <title> superseded` +138 `Skill(create-card)` for the replacement.139- **Gate is `session` and the session never happened.** Capturing a140 real session's outcome is valid; shortcutting a session that141 never took place is not — schedule the session instead.142143## What this skill does NOT do144145- Does NOT implement the card (that's `pull-card`'s next round).146- Does NOT close the card (that's `Skill(finish-card)`'s DoD-gated147 contract).148- Does NOT mutate `status`, except to release a parked claim149 (`active` → `open`, above).150151## Cross-references152153- `reference.md` (this skill's directory) — edge cases routed above.154- `Skill(scan-deck)` — surfaces parked cards; its "decisions to make"155 Q&A calls this skill per card.156- `Skill(advance-card)` — status machine + `waiting_on` overlay; gate157 ≠ status.158- `Skill(card-schema)` — `human_gate` enum and the `## Decision159 required` body convention.