Mana-Loop/AGENTS.md

Mana Loop — Agent Guide

Browser incremental/idle game. Next.js 16 + Zustand, no backend.

🔑 Git

https://n8n-gitea:tkF9HFgxL2k4cmT@gitea.tailf367e3.ts.net/Anexim/Mana-Loop.git

git config --global user.name "n8n-gitea"
git config --global user.email "n8n-gitea@anexim.local"

Workflow

cd /home/user/repos/Mana-Loop && git pull origin master
# ... work ...
git add -A && git commit -m "type: desc" && git push origin master

Session Start

1. docs/project-structure.txt
2. docs/dependency-graph.json
3. get_repo_summary → resume in-progress or pick top todo
4. update_issue_status → ai:in-progress
5. Work, log with add_comment, then update_issue_status → ai:done

Labels

ai:todo | ai:in-progress | ai:review | ai:blocked | ai:done

Terminal Tool

Always pair run_command → get_process_status in same turn. Use wait: 120 for long tasks.

Sub-Agents

Use for 3+ sequential independent calls. Zero context from parent — paste everything needed.

Architecture

• Stack: Next.js 16, TS 5, Tailwind 4 + shadcn/ui, Zustand+persist, Vitest/Playwright, Bun
• Active stores: src/lib/game/stores/{game,mana,combat,prestige,skill,ui}Store.ts
• Legacy (migrating): src/lib/game/store/ and store-modules/
• Crafting: 3-step flow — Design → Prepare → Apply via crafting-actions/
• Skills v2: constants/skills-v2.ts + computeStats() in effects
• Effects: All stat mods through getUnifiedEffects() — never read skill levels directly

Adding Effects

1. data/enchantment-effects.ts
2. effects.ts → computeEquipmentEffects()
3. Access via getUnifiedEffects(state)

Adding Skills

1. constants/skills-v2.ts
2. computeStats() mapping

Adding Spells

1. constants/spells.ts
2. data/enchantment-effects.ts
3. constants/skills-v2.ts research skill
4. EFFECT_RESEARCH_MAPPING

Banned

Lifesteal/healing, scroll crafting, ascension skills, LabTab, pause, mana types: life, blood, wood, mental, force

File Limit

400 lines max (pre-commit hook enforces).

Mana Types

Base (7): Fire 🔥 Water 💧 Air 🌬️ Earth ⛰️ Light ☀️ Dark 🌑 Death 💀 Utility (1): Transference 🔗 Compound (3): Fire+Earth=Metal, Earth+Water=Sand, Fire+Air=Lightning Exotic (3): Sand+Sand+Light=Crystal, Fire+Fire+Light=Stellar, Dark+Dark+Death=Void