source of truth
for tokens (color, type, spacing).
2. **COMMIT to an aesthetic — `frontend-design`.** Do not sample the safe center of the
training distribution. Answer four questions first — *purpose
CLAUDE.md
The frontend agent guidance lives in [AGENTS.md](AGENTS.md) so it is shared across coding agents (Claude Code, Codex, and others). Claude Code imports it below.
@AGENTS.md
wide purge is its own task, not a side effect of an unrelated PR.
- **Frontend Tests — MUST READ**: [Frontend Testing Guidelines](docs/references/testing/frontend-testing.md).
- **Test Mocking**: Use the unified mock system
rest of the work.
- If the task touches `web/`, also Read `web/AGENTS.md` before editing frontend files.
- If the task touches billing as defined under **Billing rules (mandatory read gate
local
services are ready. In this repo, the key readiness signals are:
- frontend healthcheck responds on `http://localhost:8000/api/v2/healthcheck`
- Spanner emulator is reachable on `localhost:9010`
- required Kubernetes pods
discovery, observability, and governance — a
multi-module project with a Java backend, a React/TypeScript frontend, a Python ingestion framework,
and Docker infrastructure.
## Stack at a glance
- **Backend**: Java 21 + Dropwizard
agent-orchestrator** — do **not** re-flag old design-reference mismatches.
When showing or demoing frontend changes, run `ao preview [url]` from inside the
session so the change renders
integration / end-to-end cases under `tests/` |
The main repo has no frontend stack, so no `frontend-dev` is provided; TypeScript sub-projects under `apps/` use their own AI configuration
project is a web-based NGINX management interface built with Go backend and Vue.js frontend.
## Package Manager
- **Use Bun exclusively** for all frontend package management operations
- Commands: `bun install
/.config/dev.humanlayer.wui/logs/`
Logs include output from the WUI backend, daemon stderr (prefixed with [Daemon]), and frontend console logs (prefixed with [Console]). The log files automatically rotate at 50MB. The application
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.