AlexandrAI AGENTS.md
agents-md

Thinklogi Build Test Static App Agent Guide

Agent guide for static build, required public assets, tests, and local run commands.

AGENTS.md

Guidance for coding agents working on Thinklogi Build Test Static App in the thinklogi project.

Project overview

This guide covers scripts/build.mjs, package scripts, and the current Node test suite. The app is a static public directory copied into dist after required assets are verified. Tests run with the built-in Node test runner against decision logic and harness behavior.

Primary source files

  • scripts/build.mjs validates required public assets and copies public to dist.
  • package.json defines dev, build, test, and harness commands.
  • tests/decisionLogic.test.mjs covers voting helpers.
  • tests/harness.test.mjs covers autonomous harness behavior.
  • public/index.html, public/styles.css, public/app.js, public/decisionLogic.mjs, and public/harnessSnapshot.json are required build inputs.

Setup commands

npm run harness:init npm run harness:tick npm run harness:run npm test npm run build npm run dev

Change rules

  • Keep build input requirements explicit.
  • Clean dist before copying public assets.
  • Do not make build depend on a live server.
  • Keep tests runnable with node --test.
  • Keep generated dist artifacts out of source-of-truth changes unless release packaging requires them.

Testing

Run npm test before npm run build. For app interaction changes, run the static dev server and manually verify feed, create, mine, and agents tabs.

PR checklist

  • Required public assets exist before build.
  • npm test and npm run build pass.
  • Harness snapshot is present for the Agent screen.