feat: add prestige system and skill upgrades with comprehensive documentation

2026-05-01 15:18:09 +02:00
parent 3691aa4acc
commit 03815f27ee
52 changed files with 4056 additions and 873 deletions
@@ -0,0 +1,56 @@
+# Task 19 (5a) Context: New Insight Upgrade Proposals
+
+## 1. Existing Insight Upgrades
+Sourced from `docs/GAME_BRIEFING.md` Prestige/Loop System section. These are permanent upgrades purchased with Insight when prestiging (looping), persisting across all subsequent loops.
+
+| Upgrade | Max Level | Cost (Insight) | Effect |
+|---------|-----------|----------------|--------|
+| Mana Well | 5 | 500 | +500 starting max mana |
+| Mana Flow | 10 | 750 | +0.5 permanent regen per level |
+| Deep Memory | 5 | 1000 | +1 memory slot per level |
+| Insight Amp | 4 | 1500 | +25% insight gain per level |
+| Spire Key | 5 | 4000 | Start at floor +2 per level |
+| Temporal Echo | 5 | 3000 | +10% mana generation per level |
+| Steady Hand | 5 | 1200 | -15% durability loss per level |
+| Ancient Knowledge | 5 | 2000 | Start with blueprint per level |
+| Elemental Attune | 10 | 600 | +25 element cap per level |
+| Spell Memory | 3 | 2500 | Start with random spell per level |
+| Guardian Pact | 5 | 3500 | +10% pact multiplier per level |
+| Quick Start | 3 | 400 | +100 starting mana per level |
+| Elem. Start | 3 | 800 | +5 each unlocked element per level |
+
+*Note: In-game core skills (e.g., `mana` category skills like Mana Well, Mana Flow) are distinct from these Prestige/Insight upgrades, which are purchased with Insight across loops.*
+
+## 2. Insight Upgrade Philosophy
+Insight upgrades are **permanent cross-loop advantages that accelerate early-loop ramp-up**. They are designed to:
+- Persist indefinitely across all loops (permanent)
+- Apply universally to every new loop (cross-loop)
+- Reduce the time/effort required to reach mid/late game in each subsequent loop (accelerate early-loop ramp-up)
+
+Examples of existing upgrades aligning with this philosophy:
+- `Quick Start`: Grants starting mana to immediately begin actions
+- `Elem. Start`: Unlocks elemental mana types earlier, bypassing early-game grinds
+- `Spire Key`: Skips low-level floors to reach higher content faster
+
+## 3. Specific Proposal Directions (Task 19 / 5a)
+New Insight upgrade proposals to expand early-loop acceleration options:
+
+1. **Unlocked mana type capacity**
+   - Effect: Start with access to unlocked mana types + small capacity bonus
+   - Goal: Reduce early-game mana type unlock grind, provide immediate elemental mana access
+
+2. **Reduced attunement conversion cost at loop start**
+   - Effect: Lower raw mana cost for converting to elemental mana via attunements early in the loop
+   - Goal: Speed up elemental mana accumulation in first few days of each loop
+
+3. **Start with N floors of Spire progress cleared**
+   - Effect: Begin each loop with N floors of Spire progress already completed (similar to Spire Key, but more granular)
+   - Goal: Skip repetitive early floor climbs, focus on higher content sooner
+
+4. **Guardian Pact memory**
+   - Effect: Retain one pact bonus (from a previously signed Guardian) across loops
+   - Goal: Maintain powerful Guardian boons without re-signing pacts every loop
+
+5. **Skill head-start**
+   - Effect: Start each loop with 1 level in a chosen skill category (e.g., mana, study, enchant)
+   - Goal: Reduce early-game skill grind, immediately access core skill bonuses