Define learning accessibility rules

AGRARIAN_DEVELOPMENT_ROADMAP.md

@@ -884,7 +884,7 @@ Target deliverable: A small group can join a server, spawn into one biome, gathe
 - [x] Add first contextual learning prompts for fire safety, potable water, exposure, shelter placement, injury care, and resource identification. Added first contextual prompt specs to `Docs/KnowledgeAndSkillFoundation.md` for fire safety, potable water, exposure, shelter placement, injury care, and resource identification, with trigger examples, prompt intent, sample wording, and the rule that prompts explain immediate risk without pausing the game or forcing a quiz.
 - [x] Design optional knowledge checks that appear when relevant to the action instead of interrupting basic play. Added optional knowledge-check rules to `Docs/KnowledgeAndSkillFoundation.md`, defining inline/skippable presentation, action-relevant timing, calm review moments, non-punitive wrong answers, and the rule that checks deepen understanding without gating the first survival loop.
 - [x] Add player-facing feedback that explains why an action failed or produced poor results. Added failed-action and poor-result feedback rules to `Docs/KnowledgeAndSkillFoundation.md`, requiring short messages that say what happened, name one likely cause, offer one useful next step, avoid blame, and avoid revealing hidden formulas.
-- [ ] Define accessibility rules for the learning system: hints, retries, readable wording, no hard lockout from basic survival, and non-punitive practice paths.
+- [x] Define accessibility rules for the learning system: hints, retries, readable wording, no hard lockout from basic survival, and non-punitive practice paths. Added learning accessibility rules to `Docs/KnowledgeAndSkillFoundation.md`, covering reusable hints, retries, readable wording, non-color-only warnings, no lockout from basic survival, safer practice paths, and diminishing returns to prevent exploit loops.
 - [ ] Define the first subject content format: topic, concepts, difficulty tier, prerequisite concepts, in-game effect, practice action, and source note.
 - [ ] Add a small MVP question bank for elementary survival knowledge.
 - [ ] Define when deeper questions should matter: quality improvements, safer work, complex crafting, teaching others, and advanced branches.

Docs/KnowledgeAndSkillFoundation.md

@@ -338,3 +338,44 @@ Example messages:
 
 Feedback rule: poor results should teach the player what to try next without
 turning every failure into a lecture.
+
+## Learning Accessibility Rules
+
+The learning system should support different players without making Agrarian
+feel shallow. Accessibility here means readable, repeatable, and fair.
+
+Hints:
+
+- Hints should be available for basic survival concepts.
+- Hints should become less frequent after the player demonstrates the concept.
+- Players should be able to re-open important survival hints from a journal,
+  help panel, or camp review surface.
+
+Retries:
+
+- Basic survival learning should allow retries after mistakes.
+- Retrying should cost time, materials, stamina, safety, or opportunity where
+  appropriate, but should not trap the player in a dead-end tutorial state.
+
+Readable wording:
+
+- Use plain language before technical vocabulary.
+- Keep prompt text short during active play.
+- Put deeper explanation in review/journal surfaces.
+- Avoid color-only meaning for warnings and result quality.
+
+No hard lockout from basic survival:
+
+- Low knowledge should not block gathering, drinking, fire attempts, basic
+  shelter attempts, or first aid attempts.
+- Knowledge can improve safety and quality, but basic survival remains playable.
+
+Non-punitive practice paths:
+
+- Players should have safer ways to practice common concepts near camp, shelter,
+  or low-risk resources.
+- Practice can produce weaker outcomes without severe punishment.
+- Practice should still avoid infinite exploit loops through diminishing returns.
+
+Accessibility rule: learning should make players more capable without making
+them feel trapped, shamed, or forced into a classroom flow.

Scripts/verify_learning_accessibility_rules.py

@@ -0,0 +1,40 @@
+#!/usr/bin/env python3
+"""Verify learning accessibility rules are documented."""
+
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+DOC = ROOT / "Docs" / "KnowledgeAndSkillFoundation.md"
+ROADMAP = ROOT / "AGRARIAN_DEVELOPMENT_ROADMAP.md"
+
+REQUIRED = {
+    DOC: [
+        "## Learning Accessibility Rules",
+        "Hints:",
+        "Retries:",
+        "Readable wording:",
+        "No hard lockout from basic survival:",
+        "Non-punitive practice paths:",
+        "Accessibility rule:",
+    ],
+    ROADMAP: [
+        "[x] Define accessibility rules for the learning system: hints, retries, readable wording, no hard lockout from basic survival, and non-punitive practice paths.",
+    ],
+}
+
+
+def main() -> None:
+    missing: list[str] = []
+    for path, snippets in REQUIRED.items():
+        text = path.read_text(encoding="utf-8")
+        for snippet in snippets:
+            if snippet not in text:
+                missing.append(f"{path.relative_to(ROOT)} missing {snippet!r}")
+    if missing:
+        raise SystemExit("FAILED: " + "; ".join(missing))
+    print("OK: learning accessibility rules are documented.")
+
+
+if __name__ == "__main__":
+    main()