Codex GoC Command
When this skill says goc ..., resolve the executable before running the
command:
- In the
game-of-cards source checkout, use uv run goc ....
- If
goc is already on PATH, use goc ....
- If this skill is loaded from the Game of Cards Codex plugin, use the
bundled helper at
<plugin-root>/skills/_goc-bootstrap.sh ...; the plugin
root is the parent directory that contains both skills/ and bin/.
- If the plugin root is not obvious from the loaded skill path, locate the
helper with:
GOC_BOOTSTRAP=$(find "$HOME/.codex/plugins/cache" -path '*/game-of-cards/*/skills/_goc-bootstrap.sh' -type f -perm -111 -exec ls -t {} + 2>/dev/null | head -n 1)
test -n "$GOC_BOOTSTRAP" || { echo "GoC Codex plugin bootstrap not found" >&2; exit 127; }
"$GOC_BOOTSTRAP" --help
Use that helper path in place of bare goc for the rest of the skill. Do not
edit deck files directly just because goc is not on PATH.
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-card3description: "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."4metadata:5 source: https://skillmd.com/skills/zauberzeug/decide-card6---78## Codex GoC Command910When this skill says `goc ...`, resolve the executable before running the11command:1213- In the `game-of-cards` source checkout, use `uv run goc ...`.14- If `goc` is already on `PATH`, use `goc ...`.15- If this skill is loaded from the Game of Cards Codex plugin, use the16 bundled helper at `<plugin-root>/skills/_goc-bootstrap.sh ...`; the plugin17 root is the parent directory that contains both `skills/` and `bin/`.18- If the plugin root is not obvious from the loaded skill path, locate the19 helper with:2021```bash22GOC_BOOTSTRAP=$(find "$HOME/.codex/plugins/cache" -path '*/game-of-cards/*/skills/_goc-bootstrap.sh' -type f -perm -111 -exec ls -t {} + 2>/dev/null | head -n 1)23test -n "$GOC_BOOTSTRAP" || { echo "GoC Codex plugin bootstrap not found" >&2; exit 127; }24"$GOC_BOOTSTRAP" --help25```2627Use that helper path in place of bare `goc` for the rest of the skill. Do not28edit deck files directly just because `goc` is not on `PATH`.293031## When to invoke3233Invoke 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.3435# Decide a card3637The Andon-cord loop: `Skill(pull-card)` raises `human_gate`38(`none → decision` / `session`) when it hits a question only a human39can answer; this skill lowers the gate back to `none` in one cheap40action. The card comes out `open` — one parked while `active`41(pull-card claims before it works) is released back to the queue —42so the next `pull-card` claims and implements per the recorded43decision. Humans resolve the cause;44agents wield the wrench — and an agent that can cite the project45rubric MAY decide on its own behalf (lazy Andon, below).4647**Edge cases live in `reference.md`** — a sibling file in this48skill's directory. Read the named section only when the situation49actually applies:5051| Situation | `reference.md` section |52|---|---|53| Presenting labeled options via AskUserQuestion | Mirroring labeled options |54| The decision reverses / re-scopes a stated verdict | Re-scope reconciliation |55| An agent recorded a decision it shouldn't have | Rewinding an agent decision |56| Why the cord must be cheap to lower | Rationale |5758## What this skill does to the card59601. **Body.** Replaces the `## Decision required` section (or appends61 a fresh `## Decision` section) with:6263 ```64 ## Decision6566 *Resolved YYYY-MM-DD:* <one-line decision>6768 *Reasoning:* <one-line why>69 ```70712. **log.md.** Appends up to two entries, timeline-ordered: first an72 archive of the prior `## Decision required` content (the options73 and trade-offs the README rewrite would otherwise lose), then the74 resolution (`<decision> — <reason>. Gate <prior> → none.`).75763. **Frontmatter.** Flips `human_gate: decision` (or `session`) →77 `none`. An `open` card stays `open`. An `active` card (parked78 mid-work) returns to `open` with its `worker` kept, because79 `active` + gate `none` reads as a live claim that no queue lists;80 to keep working it in the same session, re-claim it with81 `goc status <title> active`.82834. **Refuses** (exit 2, nothing written) if the gate is already84 `none`, the title doesn't exist, or `--decision` / `--because` is85 blank.8687## Workflow88891. **Read the card body** (`goc show <title>`). Confirm the decision90 actually answers the parked question: if `## Decision required`91 enumerates options A/B/C, the user's free-text decision should map92 onto one (or explicitly reject all and propose D). When eliciting93 the pick with AskUserQuestion, mirror the body's option labels and94 order verbatim — do not reorder or rephrase (`reference.md`95 § Mirroring labeled options).9697 **Then check `advanced_by` for unclosed prerequisites, and read any98 you find before recording.** An `advances` edge does not record99 whether it is strict, so the only way to learn that a prerequisite100 *reframes* this card is to open it. Lowering the gate is what makes101 the card autonomously pullable, so a decision taken over an unread102 prerequisite is one an unattended worker may act on before any human103 sees the card again. `goc decide` prints the same advisory104 (non-blocking — it names the prerequisites and lowers the gate105 anyway), but it prints it as the decision lands, which is too late106 to inform it.1071082. **Run the CLI.**109110 ```bash111 goc decide <title> \112 --decision "<one-line what>" \113 --because "<one-line why>"114 ```1151163. **Commit follows repo policy.** `goc decide` honors117 `.game-of-cards/config.yaml` `workflow.auto_commit` (default118 `true`), committing body + log + gate flip as119 `decide: <title> — <decision>`. Override per invocation with120 `--no-commit` / `--commit`.121122If the decision **reverses or re-scopes a verdict the card already123states**, `goc decide` only writes the `## Decision` block — every124other surface still asserting the old verdict is now stale. Reconcile125by hand: the `summary:` frontmatter, any `> ⚠` body banner, DoD126wording, and mentions in neighbor cards. The CLI prints a reminder on127re-scope language and `goc validate` flags128`DECISION_CONTRADICTS_VERDICT`. For a true re-scope, prefer129supersede + create over an in-place rewrite. Full checklist:130`reference.md` § Re-scope reconciliation.131132## When an agent invokes this skill (lazy Andon)133134An agent may decide *on its own* only after consulting the consuming135repo's project-specific rubric:136137!`cat .game-of-cards/hooks/decide-card.md 2>/dev/null || true`1381391. **Cite the rubric.** `--because` MUST start with a clause naming140 the rubric consulted and what it returned (citation form per the141 hook above).1422. **Cite the primary source** when the answer rests on literature:143 DOI/PMID, textbook chapter, or project-doc section.1443. **No agent-decide for human-judgement questions** — resource145 allocation, scope splits, deadlines, stakeholder alignment, taste146 calls. Raise the gate instead.1474. **Default to human when ambiguous.** If the rubric doesn't give a148 clean answer, raise the gate; don't guess.149150A decision recorded in violation of this contract can be rewound —151`reference.md` § Rewinding an agent decision.152153## When NOT to use this skill154155- **Card needs implementation, not a decision.** If you're ready to156 do the work yourself, just do the work.157- **Decision changes scope.** "Scope this differently / split /158 reframe" is not a resolution — use159 `Skill(advance-card) <title> superseded` +160 `Skill(create-card)` for the replacement.161- **Gate is `session` and the session never happened.** Capturing a162 real session's outcome is valid; shortcutting a session that163 never took place is not — schedule the session instead.164165## What this skill does NOT do166167- Does NOT implement the card (that's `pull-card`'s next round).168- Does NOT close the card (that's `Skill(finish-card)`'s DoD-gated169 contract).170- Does NOT mutate `status`, except to release a parked claim171 (`active` → `open`, above).172173## Cross-references174175- `reference.md` (this skill's directory) — edge cases routed above.176- `Skill(scan-deck)` — surfaces parked cards; its "decisions to make"177 Q&A calls this skill per card.178- `Skill(advance-card)` — status machine + `waiting_on` overlay; gate179 ≠ status.180- `Skill(card-schema)` — `human_gate` enum and the `## Decision181 required` body convention.