Initialize calm game project
This commit is contained in:
@@ -0,0 +1,45 @@
|
||||
# AGENTS.md
|
||||
|
||||
SvelteKit + TypeScript family quiz game.
|
||||
|
||||
This file is the durable project contract for AI coding agents. Keep reusable
|
||||
agent workflow guidance here or under `development/_reference/ai/`.
|
||||
|
||||
## Workflow
|
||||
|
||||
- Codex is the orchestrator, verifier, reviewer, and committer.
|
||||
- Use `npm run agent:loop -- --task "<concrete task>"` when Codex delegates
|
||||
implementation to the Pi worker harness.
|
||||
- Worker agents receive one concrete task. They must not broaden scope, commit,
|
||||
push, deploy, rewrite git history, or edit agent workflow files unless the task
|
||||
explicitly asks.
|
||||
- Progress is captured through reviewed git checkpoint commits, not through
|
||||
long-lived execution logs.
|
||||
- Technical run artifacts live in `.codex/logs/agent-runs/` and are ignored.
|
||||
|
||||
## Verification
|
||||
|
||||
Run the narrowest relevant checks after changes:
|
||||
|
||||
- `npm run check` for Svelte/TypeScript changes.
|
||||
- `npm run build` for production-build confidence.
|
||||
- Use a real local browser smoke for visible UI behavior changes.
|
||||
|
||||
Never claim work is done until there is a code diff and observed verification.
|
||||
|
||||
## Project Shape
|
||||
|
||||
- `src/lib/types.ts` holds domain types.
|
||||
- `src/lib/question-sets/` holds question data.
|
||||
- `src/lib/stores/game.ts` owns game state and localStorage persistence.
|
||||
- `src/lib/components/` holds UI components.
|
||||
- `src/routes/+page.svelte` orchestrates screens.
|
||||
|
||||
## Product Rules
|
||||
|
||||
- Keep the game calm, family-friendly, and host-led.
|
||||
- Preserve the separation between question data, state, and UI.
|
||||
- Do not add backend, auth, database, multiplayer, or an editor unless explicitly
|
||||
requested.
|
||||
- Keep user-facing copy consistent with the language and tone of the touched UI.
|
||||
- Prefer small, focused changes and checkpoint commits.
|
||||
Reference in New Issue
Block a user