Skip to content

Add onboarding guide with screenshots for starter READMEs #70

@justinmadison

Description

@justinmadison

Problem

When a developer (especially Andrew) opens a starter and runs python run.py, the server starts but there's no guidance on what to do next on the Godot side. The READMEs say "open Agent Arena game" and "connect to localhost:5000" but don't explain:

  • Which .tscn scene to open (foraging.tscn)
  • How to verify the connection is working
  • What success looks like (agent moving, logs appearing)
  • How to configure the port if needed

This is the #1 blocker for a developer who wants to focus purely on AI agent code.

Acceptance Criteria

  • Each starter README (beginner, intermediate, llm) has a step-by-step "Running Your Agent" section
  • Screenshots showing: Godot scene selection, pressing play, agent connected and moving
  • Troubleshooting section for common issues ("agent doesn't move", "connection refused")
  • Clear description of what the terminal output should look like on both sides (Python + Godot)

Estimated Effort

Half day

Context

Identified during infrastructure readiness review — this is Priority 1 of 4 items needed to enable pure AI-focused development.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    Status

    Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions