beginner course repo for the GitHub Copilot app. The canonical sample is `samples/book-app-web`: a frontend-only book collection used to practice review, tests, browser preview, issues, and pull requests
name in commit messages.
- **Contract-first**: Read `docs/contracts/{module}.contract.ts` before implementing any endpoint.
## Frontend Rules (Non-Negotiable)
- **Zero raw HTML in pages**: Never write raw ` `, ` `, ` ` directly in page files
state should reflect the MCP server's state — avoid duplicating business logic in the frontend
## Prompt Writing Principles
These apply whenever any agent writes or updates a prompt (agent file
interaction, layout, or
information-architecture pattern before building it →
`agents/ui-ux-researcher.md` — hands the recommendation to `frontend-dev`
(or `skills/html-css/SKILL.md`) next.
- UI/component/page/client-state work → `agents/frontend-dev.md`.
- Raw HTML/CSS authoring or review with no framework
mandatory; other fields are optional metadata
// Category naming convention: lowercase, single word (ai, backend, frontend, etc.)
// Skill naming convention: lowercase, hyphen-separated (my-skill-name)
// All skills go under .claude/skills
documentation lead | Documentation, a report, a README, or an ADR needs writing |
| **Pixel** | Frontend Developer in Eric's pod | React, TypeScript, or Tailwind UI components must be built |
| **Diesel** | Backend
Protocol (MCP) servers from OpenAPI/Swagger schemas. The system uses a microservices architecture with separate frontend, backend API, background worker, Redis queue, and PostgreSQL database - all orchestrated via Docker Compose.
## Architecture
variables. NEVER place secrets in client-side code, config files committed to git, or frontend bundles.
- Confidential data (email, PII, private messages) MUST be encrypted at rest and in transit
Example tasks:
- "Get last 50 lines from the backend container"
- "Summarize incidents for the frontend container"
- "Run triage_incident on backend"
## Workflow Examples
**Incident response (full flow):**
1. Call `docker
Design System & Frontend Guidelines
> **Drop-in file.** Place this `CLAUDE.md` in a project root (or merge it into an existing one) and Claude Code will load it automatically. It defines