Simone Systems Research Browse the lessons

Inside an AI agent / 01

How an AI agent
checks its work.

Play the shell game, follow its recorded AI-assisted build, and try the checks that caught lost progress.

Recorded build. Playable result.
A small corner of the ocean

One otter. One good pebble. A game to make.

The thing we’re making

Shell pairs

Preview

0 of 4 pairs

0 moves

Use Tab or the arrow keys to move between shells. Enter or Space turns one over.

The shells are here. The game isn’t wired up yet.

The build, replayed

Recorded steps. No live AI.

  1. 1 Model requests
  2. 2 Tool acts
  3. 3 Result returns to the model
Start with a request

“Make a shell-matching game.”

You give the model a task. It can ask tools to edit or check something. The software around it runs allowed requests and sends back what happened. That surrounding software is called a harness.

A condensed account of this game’s development, with checks you can run.

The useful bit

How tool results guide the next edit

The helper needs to see what happened before deciding its next step. A failed check can lead to another edit. A limit on turns stops it from trying forever.

Download the shell game

Save one HTML file to play offline and edit.

The finished game, not an AI agent. No account or API key.

What is real here?

You can play the game and run its checks here. The build story retells an earlier session made with AI assistance. It is not a live AI conversation and does not write new code as you watch.

The saved-score change began as a second task. Review then caught a real bug: the upgrade reset an active round. A browser reproduction was returned to the author, who added a failing regression test and corrected the code. The replay summarizes that exchange; it does not show private model reasoning.

The harness is the software around a model: it supplies tools, runs allowed requests and sends results back. These teaching panels describe that relationship; they do not run a model harness.

Created by Jonathan Simone with AI assistance. Original artwork and game. Technical background: Building effective agents and the action and observation cycle.