Developer guide

Everything needed to work on AMW itself: how it is built, how to run and test it, and how changes get from an issue to a release.

• Architecture

  ---

  Components and request flow, with diagrams.

• Code layout

  ---

  Where each part lives and which files to touch for a change.

• Development environment

  ---

  Dev container, ./start.sh dev, npm run dev and npm scripts.

• Tests & quality

  ---

  Unit tests and coverage thresholds, API and browser end-to-end tests, lint.

• Contributing

  ---

  Issue → branch → pull request, Conventional Commits, comment guidelines.

• CI/CD and releases

  ---

  GitHub Actions workflows and the release process.

The rules for humans and AI coding agents are summarized in AGENTS.md; security issues follow the security policy.