livecodes: Instructions file for Codex

AGENTS.md

Guidance for AI coding agents working in the LiveCodes repository.

Project Overview

LiveCodes is a code playground that works in the browser. It's a TypeScript/JavaScript project that uses esbuild for bundling.

Documentation for AI Agents

• skills/ — Intent skills for LiveCodes SDK. Start with .agents/skills/livecodes/SKILL.md for an overview and decision tree linking to all sub-skills.
• docs/docs/contribution/ — Internal architecture and system documentation for contributors (build system, compiler, config, editor, etc.)
• llms-full.txt (livecodes.io/docs/llms-full.txt) — Generated list of all LiveCodes features and their descriptions.

Build / Lint / Test Commands

npm run build             # Full production build (app + docs + storybook)
npm run build:app         # Build app only
npm run start             # Dev server with watch (http://127.0.0.1:8080)
npm run docs              # Start documentation server (http://localhost:3000/docs)
npm run storybook         # Start storybook (http://localhost:6006)

npm run test              # Run everything (typecheck + lint + unit tests)
npm run test:unit         # All Jest unit tests
npm run test:unit -- --testPathPattern="utils.spec"           # Single test file by path pattern
npm run test:unit -- --testNamePattern="debounce"             # Single test by name
npm run test:unit -- src/livecodes/config/__tests__/build-config.spec.ts  # Exact file
npm run e2e               # Playwright end-to-end tests

npm run typecheck:app     # TypeScript type check (tsc --noEmit)
npm run lint:eslint       # ESLint check
npm run lint:prettier     # Prettier format check
npm run lint:stylelint    # Check styles with Stylelint
npm run fix               # Auto-fix all (prettier + eslint + stylelint)
npm run fix:prettier      # Auto-fix formatting only
npm run fix:eslint        # Auto-fix lint only
npm run fix:stylelint     # Auto-fix stylelint only