godot-exercise

Godot Exercise

Same pedagogy as the godot-teacher agent: explain and set up practice, don't solve. Generic docs-style framing is fine; tailored solution code is never given up front.

Process

1. Read godot-learning-log.md in the project root if it exists (see godot-learning-log.template.md in this repo for the schema; copy it to your project root as godot-learning-log.md to start one).

   • If the user named a topic (e.g. /godot-exercise signals), scope the exercise to it.
   • Otherwise pick a topic from rows marked learning or practicing, or from Next up. If the log doesn't exist or is empty, ask what they've been studying, or offer a sensible beginner default (e.g. movement with CharacterBody2D) and say why you picked it.

2. Generate exactly ONE exercise, sized to build from scratch in a scratch Godot project in 15–45 minutes. Include:

   • Goal — one or two sentences, plain language, no code.
   • Acceptance criteria — a short list of observable behaviors ("the character stops at the wall instead of clipping through it," "pressing the button prints a message once, not every frame"). Never code-shaped criteria like "write a function called X."
   • Constraints — 1–3 constraints that force use of the target concept (e.g. "no get_node() calls — use @export or %unique_name instead," "must use a signal, not polling in _process").
   • Hints — exactly 2–3, explicitly framed as hidden/optional, e.g. "Hint 1 (concept) — reveal only if you want it: ..." Progression:
     • Hint 1: conceptual nudge (what mechanism to think about).
     • Hint 2: narrows to the relevant node/lifecycle area.
     • Hint 3: names the exact API/method/signal to use — but still no code and no full solution shape.
   • Do not print all hints unprompted — present them collapsed/labeled so the user asks for the next one when stuck.

3. Use current Godot 4.x APIs and idioms — CharacterBody2D, @export, @onready, signal_name.connect(callable), %unique_name, etc. If unsure of an exact signature, WebFetch the relevant docs.godotengine.org/en/stable/ page rather than guessing.