aimeat-protocol: Skill for Claude Code

Verifying a finished frontend change

Do not write or run the .spec.ts Playwright suite (pnpm test:playwright:*). It is unreliable. Drive a real browser through the Playwright MCP server (.mcp.json) instead.

Trigger: a completed change to public/views/, public/components/, public/js/, public/css/, locales/, or a *.html page, or a published single-file AIMEAT app (aimeat_app_publish). Mid-development is not the trigger; done is.

Against your own sandbox node (pnpm sandbox, port 40600 upward, owners and passwords in aimeat/.sandbox.json; restart it to pick up a backend change), not the shared dev server on 40050, which belongs to the developer and may be restarted by another session: navigate to the page, reach the authenticated state, perform the real interactions, and confirm the expected result actually happens. Elements appear, data persists, edits and deletes take effect.

A published app is checked signed in, in the sandbox, before anyone sees it in production. Publish it to the sandbox (POST /v1/apps with an owner token from .sandbox.json) and open <baseUrl>/v1/apps/<owner>/<file>?mode=inline: it redirects to the app's own origin, <name>.apps.localhost:<port>, where the pill's Sign In opens the same grant window as on aimeat.io; sign in there with a sandbox owner. Until 2026-09-29 the sandbox ran apps in an opaque frame whose sign-in the browser refused, and Postinjalostamo's corrections were found by Jouni in production instead.

An HTML page of a workspace is checked in its frame, in the sandbox. The sandbox runs the page host at pages.localhost:<port>, as aimeat.io runs it at pages.aimeat.io: open the page in the workspace view (<baseUrl>/v1/profile?tab=organisms), or share and publish it and open its viewer link. The page loads only inside the frame; opened in a tab of its own it goes to the viewer, so a direct load of a pages.localhost address proves nothing.

An app that reads mail or asks a model is checked on the sandbox's stand-ins. The first owner is connected to a test mailbox (19 sample messages, a PDF invoice with a text layer and a scanned one, and one request for a quote that a definition with its own class quote sorts; the connection id is mailbox in .sandbox.json), and the node's decision model and completion model are local stand-ins that answer each sample with the class and fields a person would give it. A batch, a classification or an extraction therefore runs in the sandbox with no paid key, and its result is known before you look. Speech to text has a stand-in too: every recording is answered with one short Finnish meeting note, so a recorder's path from audio to text can be run. Sending mail has none: the sandbox sends nothing, and a send answers that mail is off. A spent AI allowance is seen by starting the sandbox with AIMEAT_SANDBOX_FREE_MODEL=openrouter/free (and AIMEAT_GOOSE_BIN for the chat) and spending the stand-in's key with POST http://127.0.0.1:<port+100>/sandbox/ai-key {"limit":0.01,"usage":0.02}; {} takes the limit away again.

A page about agents and the machines that run them is checked with pnpm sandbox:machines. It leaves two stand-in machines on the sandbox while it runs (one connected, one away), agents on them that work by the clock, when asked and when written to, one agent that waits for the absent machine and one proposal that waits for the owner, and it puts the first owner on the finished home. The completion stand-in also answers the home's "new agent" sentence with a draft. Sign in with the password, as pnpm sandbox does for every owner: its tokens come from the password sign-in and last a day, so a browser sign-in in between changes nothing for them. A page as it reads on a node that takes no computers (the connector tunnel off, as on innokas.aimeat.io on 2026-10-14) is checked on a sandbox started with AIMEAT_SANDBOX_TUNNEL=false pnpm sandbox.

An app built from an approved drawing is compared with it before Jouni sees it: pnpm ui:compare. Publish the approved genre (or the page he approved) to the sandbox beside the app, then, from aimeat/: