Agon Ātrium theme
Read the repository’s AGENTS.md and agent guidance, then the guidance matching the task. Use development setup for layout, commands, and helper ownership.
Choose the owner of a change before editing: shared behavior and theme belong in src/atrium/, sample domain workflows in src/showcase/, the portable template in src/starter/, and shared local publication infrastructure in src/publisher/. Shared code must remain usable by both consumers.
Use the showcase site skill for demonstration pages and public demo artifacts, and the documentation site skill for the separate documentation renderer and publication workflow.
For components and routes, read architecture and component contracts. Use the build-generated lazy page registry and optional controller registration modules. Preserve one route root, CSP-compatible providers, cancellation, lifecycle cleanup, keyboard interaction, and JSDoc contracts.
For styles and layout preferences, read theming. Extend tokens and component SCSS while preserving responsive sidebar behavior, RTL, theme palettes, and header/sidebar layout modes.
For backend adoption or package exports, read integration. Keep domain adapters and authorization enforcement in the consumer/backend. Verify all four archives, both installed template publication commands, and both generated applications when exports or layout change.
For GitLab pipeline or publication work, read CI guidance and the release procedure. Keep local verification separate from hosted delivery. Use yarn version:bump <major|minor|patch|tiny> for an authorized version increment and --dry-run for inspection. Review the generated unreleased section and preserve existing notes. Install the locked Python quality tools with yarn python:setup before the repository-wide yarn check gate. Local pre-commit installation remains optional.
Use the verification procedure for production browser checks. Update the changelog and affected documentation. Follow the prose punctuation rules and yarn lint:prose gate in coding standards.
Follow the format-specific metadata rules in those coding standards. Reserve @author and @version for JavaScript and CSS/SCSS. Other source formats use Author: Laurent Declercq <l.declercq@agon-innovation.ch> and Version: YYYYMMDD. When changing Python CI, preserve its dedicated Python 3.14 runtime, direct Poetry commands, and warmup-before-consumer cache graph from the CI procedure.
Author
Laurent Declercq l.declercq@agon-innovation.ch
License
Unless otherwise stated all source code is licensed under LGPL 2.1 and has the following copyright:
© 2026, Agon Partners Innovation AG, All rights reserved.The design material and the “Agon Ātrium” trademark is the property of their authors. Reuse of them without prior consent of their respective authors is strictly prohibited.
Version
Version: 20260923