README.md

Retold Documentation

This directory separates player-facing design information from detailed developer references.

Public Project Documents

• design-overview.md — world premise and design pillars
• element-ritual.md — current Dragon Egg ritual, six sacrifices, and guardian direction
• ../ROADMAP.md — concise public priorities
• ../CHANGELOG.md — released and unreleased changes
• ../SUPPORT.md — help and problem reporting
• ../CONTRIBUTING.md — contribution workflow
• compatibility.md — supported datapack extension tags and integration boundaries

Developer And Technical Documents

Technical implementation material lives under internal/:

• ../AGENTS.md — organized entry point and working rules for AI coding agents
• internal/README.md — technical index and documentation roles
• internal/retold_mod_system.md — system architecture
• internal/retold_mob_ai_system.md — mob behavior architecture
• internal/mob_ai_work_report_2026-08-03.md — consolidated mob/faction implementation record
• internal/mob_ai_handoff_prompt.md — copy-paste continuation prompt
• internal/mob_tps_benchmark.md — per-species performance baseline
• internal/design_implementation_status.md — implementation tracker
• internal/retold_roadmap.md — detailed working roadmap
• internal/retold_design_risks.md — risks and unresolved decisions
• internal/retold_issues.md — confirmed internal issues

These are working documents. They are developer-maintained, may be AI-assisted, and do not override current code, tests, release notes, or direct developer decisions.