This directory contains CI/CD workflows that automate code quality, conflict detection, and deployment.
Triggers: Every PR to master
Jobs:
| Job | Description |
|---|---|
| 🚫 Poison Check | Blocks PRs that include forbidden files |
| 🔨 Build | TypeScript type check + Vite build |
| 🎨 Lint | ESLint code style |
| 🧪 Tests | Vitest test suite |
Features:
- Runs all jobs in parallel
- Cancels previous runs when new commits are pushed
- Blocks merge until all checks pass
Triggers: When CI workflow fails
What it does:
- Detects the failure
- Invokes Jules (AI coding agent) with the failure context
- Jules analyzes the logs and pushes a fix
- CI re-runs on the fixed code
Requires: JULES_API_KEY secret
Triggers:
- Every 4 hours (scheduled)
- After every push to
master - Manual dispatch
What it does:
- Gets all open PRs
- Compares which files each PR modifies
- Detects line-level overlaps between PRs
- Posts comments with resolution instructions
Why it exists: Prevents merge conflicts before they happen by alerting PRs that are working on the same code.
Triggers: Push to master
What it does:
- Installs dependencies (
npm ci) - Builds production bundle (
npm run build) - Deploys to GitHub Pages
| Secret | Purpose |
|---|---|
GEMINI_API_KEY |
AI features in the game |
JULES_API_KEY |
Auto-fix workflow |
These files MUST NOT be committed - they cause merge conflicts:
package-lock.jsonpnpm-lock.yamltsconfig.tsbuildinfotsconfig.node.tsbuildinfodist/
The CI workflow will fail if any of these are in a PR.
See .jules/_ROSTER.md for:
- Persona definitions
- Code signature requirements
- Deferred work process
- Full list of guides