docs: Update AGENTS.md workflow tools and synchronize expanded mana types #248

New Issue

2026-06-01T12:39:58+02:00

Anexim commented

2026-06-01 12:39:58 +02:00

Overview

The AGENTS.md file currently contains outdated workflow instructions and stale architectural data. This issue tracks the necessary updates to ensure that future autonomous AI agent sessions do not fail due to invalid tool calls or stale game definitions.

Required Changes

1. Fix Outdated Tooling in "Session Start"

Locate the Session Start protocol section in AGENTS.md.
Remove the reference to gitea_get_project_boards, as this tool has been deprecated and completely removed from the agent's environment.
Replace step 3 and step 4 with instructions to utilize gitea_start_session to fetch active registry issues and tasks.

2. Audit and Update "Mana Types"

The Mana Types section currently only maps out specific Base, Utility, Composite, and Exotic types.
Review the source code files defining mana structures to identify all newly added mana types that are missing from the documentation.
Update the list to explicitly reflect all current valid options in the codebase.
Verify that the Banned mana types list (life, blood, wood, mental, force) is still accurate or if any need to be unbanned/adjusted.

3. General Codebase Alignment Check

Zustand Stores: Verify that the 7 active Zustand stores listed (useGameStore, useManaStore, etc.) still accurately map to the core state architecture.
File Limit: Ensure the reminder about the 400-line pre-commit hook file limit remains prominently highlighted.

Acceptance Criteria

AGENTS.md no longer references gitea_get_project_boards.
gitea_start_session is integrated into the step-by-step onboarding protocol.
Every new mana type currently implemented in the codebase is documented in the Mana Types section.
The modified AGENTS.md file passes the 400-line pre-commit hook constraints.

## Overview The `AGENTS.md` file currently contains outdated workflow instructions and stale architectural data. This issue tracks the necessary updates to ensure that future autonomous AI agent sessions do not fail due to invalid tool calls or stale game definitions. --- ## Required Changes ### 1. Fix Outdated Tooling in "Session Start" * Locate the **Session Start** protocol section in `AGENTS.md`. * Remove the reference to `gitea_get_project_boards`, as this tool has been deprecated and completely removed from the agent's environment. * Replace step 3 and step 4 with instructions to utilize **`gitea_start_session`** to fetch active registry issues and tasks. ### 2. Audit and Update "Mana Types" * The **Mana Types** section currently only maps out specific Base, Utility, Composite, and Exotic types. * Review the source code files defining mana structures to identify all newly added mana types that are missing from the documentation. * Update the list to explicitly reflect all current valid options in the codebase. * Verify that the **Banned** mana types list (`life`, `blood`, `wood`, `mental`, `force`) is still accurate or if any need to be unbanned/adjusted. ### 3. General Codebase Alignment Check * **Zustand Stores:** Verify that the 7 active Zustand stores listed (`useGameStore`, `useManaStore`, etc.) still accurately map to the core state architecture. * **File Limit:** Ensure the reminder about the 400-line pre-commit hook file limit remains prominently highlighted. --- ## Acceptance Criteria * [ ] `AGENTS.md` no longer references `gitea_get_project_boards`. * [ ] `gitea_start_session` is integrated into the step-by-step onboarding protocol. * [ ] Every new mana type currently implemented in the codebase is documented in the **Mana Types** section. * [ ] The modified `AGENTS.md` file passes the 400-line pre-commit hook constraints.

Anexim added the ai:todo label 2026-06-01 12:39:58 +02:00

Anexim commented

2026-06-01 12:41:20 +02:00

also update README.md and docs/GAME_BRIEFING.md assume those files are completely outdated and incorrect.

Anexim commented

2026-06-01 13:01:06 +02:00

Starting work on issue #248: Updating AGENTS.md workflow tools and synchronizing expanded mana types. Will also update README.md and docs/GAME_BRIEFING.md as requested.

n8n-gitea referenced this issue from a commit

2026-06-01 13:55:19 +02:00

fix: bugs #238,#240,#244,#246 + docs #248 update

Anexim closed this issue

2026-06-01 13:56:07 +02:00

Anexim commented

2026-06-01 13:56:07 +02:00

✅ Completed all documentation updates:

AGENTS.md: Removed gitea_get_project_boards, added gitea_start_session to session start protocol, updated to 8 Zustand stores, updated mana types list (22 total), updated guardian tier info
README.md: Removed all Prisma/SQLite/database references, updated mana types (7+1+8+6=22), corrected guardian tiers and discipline counts
GAME_BRIEFING.md: Updated to 8 stores, 22 mana types, 64 disciplines, 8-tier guardian system (base 10-80, composite 90-160, exotic 170-240, combo 250+), corrected code architecture section

✅ Completed all documentation updates: - AGENTS.md: Removed gitea_get_project_boards, added gitea_start_session to session start protocol, updated to 8 Zustand stores, updated mana types list (22 total), updated guardian tier info - README.md: Removed all Prisma/SQLite/database references, updated mana types (7+1+8+6=22), corrected guardian tiers and discipline counts - GAME_BRIEFING.md: Updated to 8 stores, 22 mana types, 64 disciplines, 8-tier guardian system (base 10-80, composite 90-160, exotic 170-240, combo 250+), corrected code architecture section

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Anexim/Mana-Loop#248