Break the README into focused docs pages

docs/gameplay.md

@@ -0,0 +1,61 @@
+# Gameplay
+
+The complete design rationale also lives in [`PLAN.md`](../PLAN.md); this page keeps the playable mechanics close to the README.
+
+## Game Overview
+
+A typical shift lasts 10–15 minutes. The player:
+
+1. Watches the entrance, steps, queue, and surrounding sidewalk.
+2. Determines why each person is approaching.
+3. Uses simple gestures or polite directions first.
+4. Verifies authorized access using recognition, wristbands, credentials, tickets, or guest lists.
+5. Escalates only when a person refuses directions, attempts unauthorized entry, or presents a genuine threat.
+6. Records the incident through body-camera and radio systems.
+7. Finishes the shift with a performance review based on safety, judgment, and professionalism.
+
+The game rewards calm resolutions rather than aggressive behavior. Emergency assistance and armed responders are rare last-resort systems with meaningful consequences.
+
+## Venues
+
+### Hollywood Boulevard Building
+
+The original scenario places the guard at the top of the steps outside a fictional building. Tourists, street performers, influencers, confused visitors, intoxicated pedestrians, trespassers, people experiencing a mental-health crisis, and rare violent threats may approach the entrance.
+
+Authorized people must either be recognized by the guard or present a valid wristband. Wristbands can have different colors, patterns, dates, or event markings. They may be valid, expired, counterfeit, or missing.
+
+### The Joke Shop
+
+The Joke Shop is a comedy-club scenario. The door person checks IDs, tickets, reservations, and guest-list status, then uses a handheld security wand according to venue policy. The player must interpret wand alerts rather than treating every alert as proof of a weapon; keys, belts, phones, and other harmless objects can trigger false alarms.
+
+### Hollywood Boulevard Late Night TV Studio
+
+This scenario combines the previously defined NPC types with a busy television-studio entrance. The player manages audience members, production staff, performers, guests, deliveries, celebrity arrivals, tourists, street performers, influencers, confused visitors, intoxicated pedestrians, trespassers, people experiencing a mental-health crisis, and rare violent threats.
+
+The studio uses wristbands, credentials, tickets, guest-list confirmation, and personal recognition to authorize entry. Crowd control, filming boundaries, following authorized guests through the door, and counterfeit credentials are key events.
+
+## Escalation Model
+
+The common escalation model has six levels:
+
+0. **Observation** — Decide whether intervention is necessary.
+1. **Simple deterrence and polite direction** — Raise an open hand, make eye contact, point toward the sidewalk or check-in area, shake the head, or give a short instruction.
+2. **Formal warning** — Clearly explain the rule and request compliance.
+3. **Blocking and physical positioning** — Secure the entrance, maintain distance, preserve an escape route, and deny access without starting a fight.
+4. **Radio for security assistance** — Request a supervisor, second guard, building management, or other appropriate support.
+5. **Emergency response** — Hold the emergency-radio button and confirm only when there is an immediate threat, such as a weapon, assault, forced entry, or serious threat to occupants.
+
+An off-duty law-enforcement officer or armed emergency responder may arrive during a valid emergency. This character is not intended to be a routine stronger attack. Their role is crisis control, evacuation, restraint, arrest, or other appropriate intervention, with force governed by the situation and meaningful consequences for unjustified calls.
+
+## Core Systems
+
+- **NPC behavior:** NPCs have different motivations, temperaments, compliance levels, and reactions to the player’s approach.
+- **Access verification:** Recognition, wristbands, IDs, tickets, credentials, and guest lists determine who may enter.
+- **Nonverbal deterrence:** Small actions such as raising a hand can resolve low-risk situations without dialogue or force.
+- **Dialogue:** Polite directions and warnings affect outcomes; simple gestures can resolve low-risk situations without dialogue.
+- **Escalation:** The player chooses the lowest effective response.
+- **Radio assistance:** Calls require useful information and may take time to arrive.
+- **Evidence:** Body-camera records support shift review and accountability.
+- **Crowd reaction:** Aggressive behavior, visible weapons, and emergency response can create panic or attract a crowd.
+- **Reputation:** Peaceful resolutions, accurate reports, low property damage, and justified calls improve performance; unnecessary confrontations and false reports reduce it.
+- **Shift review:** The player receives feedback on access decisions, escalation choices, public complaints, injuries, and security outcomes.