Anexim/Mana-Loop
1
1
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

[High] [Task] [Meta] Spec audit summary: 18 inconsistencies found across AGENTS.md, GAME_BRIEFING.md, and spec files #284

New Issue
Closed
opened 2026-06-05 02:17:15 +02:00 by Anexim · 0 comments
Anexim commented 2026-06-05 02:17:15 +02:00
Owner
Copy Link
Copy Source

Type: Meta / Audit summary
Priority: High

This issue summarizes the findings from a comprehensive spec audit comparing AGENTS.md, GAME_BRIEFING.md, and all files in docs/specs/ and subfolders.

Critical Issues (High Priority)

  1. Incursion start day: AGENTS.md says day 20, GAME_BRIEFING says day 5 — massive gameplay impact
  2. Pact persistence: AGENTS.md says pacts persist through prestige, pact-system-spec says they don't (code bug)
  3. Fabricator discipline count: AGENTS.md says 2, all other docs say 5
  4. Golem count: AGENTS.md says 12 (with 2 "advanced"), all other docs say 10
  5. Victory condition: AGENTS.md says "floor 100 + pact signed", GAME_BRIEFING says "floor 100 guardian + sign the pact" — unclear if floor 100 pact specifically is required
  6. pactBinding upgrade: Referenced in code but not defined in PRESTIGE_DEF constants
  7. Golemancy system: Fully spec'd but completely disconnected from combat pipeline (WIP)
  8. DoT/debuff system: Fully spec'd but "No runtime" implementation (WIP)
  9. Enemy defenses: Armor/barrier/dodge data exists but not applied in combat pipeline (WIP)

Medium Priority Issues

  1. Discipline counts: AGENTS.md and GAME_BRIEFING disagree on non-attunement discipline pool sizes (22 vs 47)
  2. Guardian Tier 2 pact data: GAME_BRIEFING and pact-system-spec disagree on pact costs and times
  3. Guardian Tier 3 exotic floors: Floor 200/210/220 elements differ between docs
  4. Room type frequencies: Swarm 12% vs 15%, puzzle deterministic vs probabilistic
  5. Elemental matchups: Lightning→water vs Lightning→Earth, missing Miasma/ShadowGlass opposites
  6. Mana conversion spec: Complete system defined but unclear if implemented; contradictory "removed" vs "kept as no-ops"

Low Priority Issues

  1. Prestige upgrade count: Both docs say 14 but only list 13
  2. Equipment type count: AGENTS.md says 50, GAME_BRIEFING breakdown sums to 47
  3. Golem stat discrepancies: Sand/Prism/Quicksilver golem stats differ between golemancy-spec and GAME_BRIEFING

Recommendations

  1. Immediate: Fix incursion start day discrepancy — this affects all game balance
  2. Immediate: Reconcile discipline counts by auditing actual data files
  3. Short-term: Fix pact persistence bug, define missing prestige upgrades
  4. Short-term: Complete golemancy and DoT/debuff implementation
  5. Ongoing: Create a single source of truth for numeric values (guardian stats, golem stats, etc.)
**Type:** Meta / Audit summary **Priority:** High This issue summarizes the findings from a comprehensive spec audit comparing AGENTS.md, GAME_BRIEFING.md, and all files in `docs/specs/` and subfolders. ## Critical Issues (High Priority) 1. **Incursion start day**: AGENTS.md says day 20, GAME_BRIEFING says day 5 — massive gameplay impact 2. **Pact persistence**: AGENTS.md says pacts persist through prestige, pact-system-spec says they don't (code bug) 3. **Fabricator discipline count**: AGENTS.md says 2, all other docs say 5 4. **Golem count**: AGENTS.md says 12 (with 2 "advanced"), all other docs say 10 5. **Victory condition**: AGENTS.md says "floor 100 + pact signed", GAME_BRIEFING says "floor 100 guardian + sign the pact" — unclear if floor 100 pact specifically is required 6. **pactBinding upgrade**: Referenced in code but not defined in PRESTIGE_DEF constants 7. **Golemancy system**: Fully spec'd but completely disconnected from combat pipeline (WIP) 8. **DoT/debuff system**: Fully spec'd but "No runtime" implementation (WIP) 9. **Enemy defenses**: Armor/barrier/dodge data exists but not applied in combat pipeline (WIP) ## Medium Priority Issues 10. **Discipline counts**: AGENTS.md and GAME_BRIEFING disagree on non-attunement discipline pool sizes (22 vs 47) 11. **Guardian Tier 2 pact data**: GAME_BRIEFING and pact-system-spec disagree on pact costs and times 12. **Guardian Tier 3 exotic floors**: Floor 200/210/220 elements differ between docs 13. **Room type frequencies**: Swarm 12% vs 15%, puzzle deterministic vs probabilistic 14. **Elemental matchups**: Lightning→water vs Lightning→Earth, missing Miasma/ShadowGlass opposites 15. **Mana conversion spec**: Complete system defined but unclear if implemented; contradictory "removed" vs "kept as no-ops" ## Low Priority Issues 16. **Prestige upgrade count**: Both docs say 14 but only list 13 17. **Equipment type count**: AGENTS.md says 50, GAME_BRIEFING breakdown sums to 47 18. **Golem stat discrepancies**: Sand/Prism/Quicksilver golem stats differ between golemancy-spec and GAME_BRIEFING ## Recommendations 1. **Immediate**: Fix incursion start day discrepancy — this affects all game balance 2. **Immediate**: Reconcile discipline counts by auditing actual data files 3. **Short-term**: Fix pact persistence bug, define missing prestige upgrades 4. **Short-term**: Complete golemancy and DoT/debuff implementation 5. **Ongoing**: Create a single source of truth for numeric values (guardian stats, golem stats, etc.)
Anexim added the ai:todo label 2026-06-05 02:17:15 +02:00
n8n-gitea was assigned by Anexim 2026-06-05 02:17:15 +02:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ai:blocked
ai:done
ai:in-progress
ai:priority:high
priority
 ai:review
ai:todo
No Label ai:todo
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
n8n-gitea zhipu Anexim
No Assignees n8n-gitea
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Anexim/Mana-Loop#284
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?