neon-sprawl/docs/decomposition/modules/E2_M3_MasteryAndPerkUnlocks.md

E2.M3 — MasteryAndPerkUnlocks

Summary

Field	Value
Module ID	E2.M3
Epic	Epic 2 — Skills and Progression Framework
Stage target	Pre-production
Status	Planned (see dependency register)

Purpose

Mastery tracks and perk unlock state so skill builds have expressive identity beyond raw level curves.

Responsibilities

• Progress MasteryTrack data; emit PerkUnlockEvent and persist PerkState.

Key contracts

Contract	Role
MasteryTrack	Branch progress per design.
PerkUnlockEvent	Unlocks for UI and combat/craft hooks.
PerkState	Current unlocked perks per character.

Module dependencies

• E2.M2 — XpAwardAndLevelEngine.

Dependents (by design)

• Gameplay systems that gate abilities or recipes on perks (integration per content).

Related implementation slices

Epic 2 Slice 4 — at least one mastery path unlocks a perk without blocking other skills.

Source anchors

• Master plan: neon_sprawl_vision.plan.md — Epic 2.
• Module dependency register