docs: tier-references aufräumen + ROADMAP komprimieren#57
Merged
Conversation
Nach Public-Flip haben externe Besucher die Doku nicht mit dem Tier- System im Kopf gelesen. Tier-Nummern in den How-Tos klingen wie offene Action-Items, und 280 Zeilen abgeschlossener Tier 0-4 Detail in ROADMAP machen die offenen Phasen unsichtbar. Sven hat den Doku-Refactor gefragt. **How-Tos + Schema-Doku: Tier-Klammern entfernt** - `HOWTO-MINIGAME.md` — "Tier 3 hat 5 Mechanik-Patterns" -> aktueller Stand (8 Patterns, alle 8 Tasks gemapped). - `HOWTO-SABOTAGE.md` — 5 Tier-Mentions raus. `# Tier 2.7 object-binding` Kommentar -> "object-binding (Convention)". Map-Anchor-Section ohne "Tier 4"-Prefix. - `HOWTO-ROLE.md` — "Tier 6.7 in der Roadmap nennt Kandidaten" -> Link auf ROADMAP. `# Tier 3.5 ability` Code-Kommentar zu generisch. - `maps.md` — "Tier 4 props" -> "props with collision", "Tier-4/Godot extras" -> "Godot/3D extras", "Tier 2.7 sabotage trigger binding" -> "sabotage trigger binding". - `DEV.md` — stale "Multi-Map kommt mit Tier 1.8" raus (Multi-Map ist live), Branch-Konvention auf "Roadmap-Slice". - `DEPLOY.md` — `## LLM-Secrets (Tier 3.9)` -> ohne Tier-Prefix. Backref auf Tier 3.9.2.1 durch funktionale Beschreibung ersetzt. **Stand-Updates (Tier 4 ist durch)** - `GAME_OVERVIEW.md` — Stand-Satz auf 2026-05-15 (beide Clients feature- vollstaendig). "Was offen ist"-Bulletpoints von Tier 3.9.x/4.x auf prosa Beschreibungen ohne Tier-Nummern, mit Verweis auf ROADMAP. - `ASSET_SPEC.md` — Header "Tier 4.0.2 in progress" raus, jetzt "Pipeline ist live (25/25 Kinds gestaged)". Single-Source-of-Truth- Verweis ohne Tier-3.8.7-Klammer. - `ARCHITECTURE.md` — 10 Tier-Mentions in ASCII-Diagrams und Decision- Hints generischer formuliert. "Tier 3.9.2.1, PR #38" -> "PR #38 nach Live-Incident". Reconnect-Mechanismus als "live" statt "Tier 0.10". **ROADMAP.md: 433 -> 160 Zeilen (-63 %)** - Stand-Sektion komprimiert: vorher 12 Tabellen-Reihen + 14 Bulletpoints mit live-spielbar-Details (~32 Zeilen), jetzt 6 Tabellen-Reihen + 1 Absatz (~12 Zeilen). Aktueller Daten-Stand: Repo public, 717+109+22 Tests, Tier 0-4 done. - Tier 0-4 Detail-Sektionen (vorher ~280 Zeilen mit kompletten Subtask- Tabellen) in einen <details>-Block kollabiert mit per-Tier 1-Zeilen- Highlights. Detail-Plaene sind ohnehin im git log/tags. - "Was als naechstes konkret zu tun ist" auf Post-Public-Flip-Realitaet aktualisiert: Live-Test-Sweep, Public-Repo-Polish, Editor-QoL, AI-Backlog. Public-Flip-Phase-Bulletpoints raus (sind durch). - GODOT_HANDOFF-Doku-Pointer korrigiert: nicht mehr "Tier-4-Onboarding fuer externen Godot-Entwickler", sondern "Architektur-Referenz". Prettier 3.3.3 (CI-Pin) OK. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Post-Public-Flip Doku-Refactor: Tier-Nummern aus den How-Tos und Schema-Docs raus, ROADMAP von 433 auf 160 Zeilen komprimiert (Tier 0–4 als
Details
-Block, Tier 5–7 prominent).Changed
Why
Externe Besucher haben das Tier-System nicht im Kopf. Tier-Nummern in How-Tos klingen wie offene Action-Items, 280 Zeilen abgeschlossener Tier 0-4 Detail in ROADMAP machen die offenen Phasen unsichtbar.
Diff
Test plan
🤖 Generated with Claude Code