OpenParable
Skip to content
← Back to skills

Gm Accept

Productivity
gm-accept

Gm Accept is an Agent Skill for productivity published in the RandallLiuXin/GodotMaker repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Present final results to the user for acceptance. Shows evaluation results, evaluator screenshots, and asks for confirmation. Explicit invocation only — use /gm-accept.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/RandallLiuXin/GodotMaker/blob/HEAD/skills/core/gm-accept/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gm-accept, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

GodotMaker Accept

$ARGUMENTS

You are presenting the current tag's completed work to the user for acceptance. This is a per-tag gate — accepting now does NOT mean the whole game is done; it means this tag (vX.Y.Z) is ready to be sealed, archived, and git-tagged by /gm-finalize. The user can choose to continue to the next tag (/gm-gdd again) or stop the project here.

Session Setup

FIRST ACTION — before anything else: Write accept to .godotmaker/current_role.

Resume Check

Read .godotmaker/stage.jsonl (treat as empty if missing) — each line is {"role": X, "ts": Y}. Also read .godotmaker/evaluation.json.

  • If no event with role == "evaluate" exists anywhere in the file OR evaluation.json does not exist → STOP. Tell user to run /gm-evaluate first.
  • If evaluation.json result is "reject" → STOP. Tell user to run /gm-fixgap first.
  • If the last event has role == "accept" AND its decision == "accept" → STOP. Tell the user:

    "Accept already recorded at {timestamp}. Recommended next: /gm-finalize. If you need to redo this step or have other plans, just tell me."

  • Otherwise → proceed (re-invocation is valid if the previous accept event recorded a fix or done decision).

Process

1. Gather Results

Read these files:

  • .godotmaker/evaluation.json — evaluator results (mandatory)
  • PLAN.md — task completion status
  • MEMORY.md — known issues and discoveries
  • GDD.md — original requirements

2. Collect Screenshots

Do NOT capture new screenshots. Use the screenshots already captured by the Evaluator:

  • Look in e2e/screenshots/ for scene_{name}.png files
  • These correspond to reference images in references/scene_{name}.png
  • If no evaluator screenshots exist, note this as a gap

3. Present to User

Format a clear summary:

## Tag Summary — {Tag from PLAN.md}

**Project:** {name}
**Tag delivers:** {one-liner from ROADMAP.md entry for this tag}

### What This Tag Built
- {N} new systems, {M} new components added in this tag
- Tag mechanics delivered: {Tag Mechanics list from PLAN.md, all PASS per evaluation.json `tag_mechanics`}
- Inherited mechanics still passing: {list each `<prev>-MN: pass` from evaluation.json `inherited_mechanics`}

### Test Results
- Unit tests: {from gm-verify results or PLAN.md}
- E2E suite: {evaluation.json `e2e_tests.passed`/`e2e_tests.total` — single suite covering both this tag's mechanics and inherited mechanics}

### Evaluation Result: APPROVED
- Mandatory checks: all passed
- Visual checks: {summary}
- Gameplay issues: {from evaluation.json, or "none"}

### Known Limitations
- {from MEMORY.md and evaluation minor_issues}

### Reviewer Triage Decisions for This Tag

(Read MEMORY.md "Reviewer Triage Log" section, filter to entries whose
Tag matches the current tag from PLAN.md. If none → write "(none)".)

| Time | File/Area | Severity | Decision | Finding | Reason | Citation |
|------|-----------|----------|----------|---------|--------|----------|
| ...  | ...       | ...      | ...      | ...     | ...    | ...      |

(If the user thinks any REJECT or SKIP was wrong, they choose "Fix
issues" in Step 4 and tell me which finding to revisit; gm-fixgap will
pick it up.)

### How to Run
{instructions}

### Screenshots
{show evaluator screenshots side-by-side with references}

### What's Next
- After /gm-finalize this tag will be archived to docs/tags/{Tag}/ and `git tag {Tag}` will be created.
- Remaining tags in ROADMAP.md: {list of unshipped tags}
- To start the next tag, re-run /gm-gdd; to stop here, just don't.

4. Ask for Decision

Use AskUserQuestion to ask:

  • Accept → I'll record acceptance and recommend /gm-finalize.
  • Fix issues → tell me what to fix and I'll dispatch /gm-fixgap.
  • Done for now → progress is saved; you can resume any time."

Do NOT proceed until the user replies. Their reply drives the When Done branch below.

When Done

Always append a trace event to .godotmaker/stage.jsonl recording the user's decision, regardless of which branch was chosen. From the project root run:

python tools/append_stage_event.py accept --decision=<accept|fix|done>

This appends a {"role": "accept", "ts": "<server-generated UTC>", "decision": "<accept|fix|done>"} line. Do NOT hand-write the JSON or the timestamp — the helper exists so the timestamp comes from the system clock, not your own output.

Then: git add -A && git commit -m "chore(accept): <Tag> <decision>".

Then, based on the decision:

  • accept → Inform the user: Accepted. Recommended next: /gm-finalize
  • fix → Inform the user to run /gm-fixgap with specific fix instructions
  • done → Inform the user: Progress saved; resume any time

Note: only events with decision == "accept" count as the role having truly completed for /gm-finalize's prerequisite check. The fix and done events are kept as audit trail.