/input-mapper

name: input-mapper
description: |
  Manage Godot input action mappings in project.godot.
  Use when adding input actions, changing key bindings, setting up controls
  for a new genre, or validating that all referenced actions exist.
  Called by project-scaffold (initial setup), workers (new mechanics),
  and the dispatching role (GDD changes requiring new inputs).

Input Mapper

$ARGUMENTS

Read the GDD or user request, determine which input actions are needed, and write the correct `[input]` section entries into `project.godot`.

Step 1 — Extract Required Actions

Source actions from one of:

1. **GDD Mechanics table** — each mechanic implies input actions (e.g., "Player can jump" → `jump` action). 2. **Genre preset** — use a preset from Step 3 as a starting point. 3. **Explicit request** — user or dispatching role specifies exact actions.

For each action, determine: action name (snake_case), bound keys/buttons.

Step 2 — Write to project.godot [input] Section

For Object() serialization format, templates (keyboard, mouse, gamepad button, gamepad axis), and key code table, read `references/serialization.md`.

Step 3 — Genre Presets

Use these as starting points. Add gamepad bindings if the GDD mentions controller support.

Platformer

| Action | Keys | |--------|------| | `move_left` | A, Left Arrow | | `move_right` | D, Right Arrow | | `jump` | Space, W, Up Arrow |

Top-down

| Action | Keys | |--------|------| | `move_up` | W, Up Arrow | | `move_down` | S, Down Arrow | | `move_left` | A, Left Arrow | | `move_right` | D, Right Arrow |

Shooter (top-down or twin-stick)

| Action | Keys / Buttons | |--------|---------------| | `move_up` | W, Up Arrow | | `move_down` | S, Down Arrow | | `move_left` | A, Left Arrow | | `move_right` | D, Right Arrow | | `shoot` | LMB (mouse button 1) | | `reload` | R |

UI (add to all genres)

| Action | Keys | |--------|------| | `pause` | Escape |

Note: `ui_accept`, `ui_cancel`, `ui_left`, `ui_right`, `ui_up`, `ui_down` are built-in Godot actions — do NOT redefine them in `[input]` unless overriding defaults.

Step 4 — Validation

Check that every `Input.is_action_*("action_name")` and `event.is_action("action_name")` call in `.gd` files has a matching entry in `project.godot [input]` or is a built-in Godot action (prefixed with `ui_`).

To validate:

1. Grep all `.gd` files for `is_action\w*\("([^"]+)"\)` — extract action names. 2. Parse `project.godot` `[input]` section for defined actions. 3. Built-in actions (do not need definition): `ui_accept`, `ui_cancel`, `ui_select`, `ui_left`, `ui_right`, `ui_up`, `ui_down`, `ui_focus_next`, `ui_focus_prev`, `ui_page_up`, `ui_page_down`, `ui_home`, `ui_end`, `ui_text_*`, `ui_filedialog_*`, `ui_graph_*`, `ui_copy`, `ui_cut`, `ui_paste`, `ui_undo`, `ui_redo`. 4. Report any action referenced in code but missing from project.godot.