Feature Proposal: Add Structured Battle Analysis Study Guides Based on Military Academy Frameworks

[zhub9006]

Summary

I'd like to propose the addition of structured battle analysis study guides to Global Threat Map, drawing on the pedagogical frameworks used by institutions like the U.S. Army Command and General Staff College (CGSC), West Point's Modern War Institute, and the British Army's Staff Ride programme. These guides would transform the existing historical conflict data into an educational resource for students, analysts, and military professionals.

---

Background: Key Teaching Frameworks

After researching how modern military academies teach battle analysis, three major frameworks emerge that could be adapted into structured, interactive study guides:

1. CGSC Battle Analysis Methodology (4-Step Framework)

The U.S. Army Command and General Staff College developed a systematic methodology to structure studies of battles and campaigns. It comes in two forms — Basic and Advanced — both built on the same four steps:

Step	Title	Description
1	Define the Subject / Evaluate the Sources	Identify the battle (who, where, when), select research sources (books, articles, primary documents, oral histories), and evaluate each source for content relevance and bias.
2	Review the Setting (Set the Stage)	Establish the strategic/operational overview (war aims, campaign context), study the area of operations using OAKOC terrain analysis (Observation & fields of fire, Avenues of approach, Key terrain, Obstacles, Cover & concealment), and compare the principal antagonists across 8 dimensions: size/composition, technology, logistical systems, C3 (command/control/communications), intelligence, doctrine & training, condition & morale, and leadership.
3	Describe the Action	Chronicle the battle itself in phases — identifying key events, decisions, and turning points. Map the flow of operations and highlight critical moments where the outcome hung in the balance.
4	Assess the Significance	Derive "lessons learned" by analyzing cause-and-effect relationships, relating findings to current doctrine, and identifying principles that transcend the specific battle.

The Advanced version adds deeper strategic analysis, including the political and economic dimensions of the conflict.

2. The Staff Ride Methodology (3-Phase Framework)

Used by the U.S. Army Center of Military History, West Point's MWI, NATO allies, and the Canadian Army, the Staff Ride is the signature experiential-learning method for battle study:

Phase	Title	Description
1	Preliminary Study	Systematic research: reading assignments, map studies, doctrinal context, and facilitated discussions to prepare participants before visiting the battlefield.
2	Field Study	Walking the actual terrain (or a virtual terrain tour), with participants delivering stand-up briefings at key stands on the battlefield — analyzing decisions, terrain effects, and unit actions in situ.
3	Integration	After-action review and synthesis: participants draw lessons, connect historical events to modern doctrine, and discuss leadership, tactics, and operational art takeaways.

3. The Principles of War / Estimate of the Situation Framework

Used at Sandhurst and across NATO academies, this analytical lens evaluates battles against enduring principles — objective, offensive, mass, economy of force, maneuver, unity of command, security, surprise, simplicity — and uses the "estimate of the situation" process (mission analysis, enemy analysis, terrain/weather analysis, troops available, courses of action) as a decision-making scaffold.

---

Proposed Feature: Interactive Battle Analysis Study Guides

Building on these frameworks and the existing Global Threat Map infrastructure, I propose a new "Study Guides" feature that would:

Content Structure

• Per-conflict study guide pages that follow the CGSC 4-step format, auto-populated where possible from existing conflict data (adversaries, dates, locations, outcomes)
• OAKOC terrain analysis section leveraging Mapbox to annotate key terrain features, avenues of approach, and obstacles directly on the map
• Phase-by-phase battle narrative with timeline markers that can be scrubbed on the map (reusing the existing timeline scrubber component)
• "Lessons Learned" synthesis section with structured prompts derived from the Principles of War

Interactive / Virtual Staff Ride Mode

• Virtual Staff Ride mode using the existing Mapbox map to create a guided tour of battlefield stands with pop-up briefings at each stand (leveraging the country-conflicts modal pattern)
• Preliminary Study checklist — reading list, doctrinal references, and pre-visit discussion prompts
• Integration/Reflection panel — structured after-action review template for users or groups

Data & Extensibility

• Study guide content stored as structured JSON/Markdown under a new guides/ directory
• Community-contributable: open PRs for new battle guides following a standardized template
• Template generator CLI or web form that scaffolds a new guide from the CGSC format

---

Why This Fits Global Threat Map

• The repo already surfaces historical conflicts per country with dates, adversaries, and outcomes — this is the raw material for Step 1 (Define the Subject) and Step 2 (Review the Setting)
• The Mapbox integration is perfectly suited for terrain analysis (OAKOC) and virtual staff ride stand placements
• The timeline scrubber component can be extended for phase-by-phase battle narratives
• The Intel Dossiers feature demonstrates the pattern for rich, structured analytical content — study guides would be a natural companion

---

Suggested Implementation Path

1. Create a battle analysis guide template (JSON schema + Markdown template) based on the CGSC 4-step format
2. Build a /guides route with a directory of available study guides
3. Implement a guide viewer that renders the template sections with map integration for terrain and phase markers
4. Pilot with 2–3 well-known battles (e.g., Kasserine Pass — the CGSC's own case study, Gettysburg, Stalingrad) as reference implementations
5. Add virtual staff ride mode as an enhancement to the guide viewer
6. Open community contributions with a CONTRIBUTING.md section on the guide template

---

I'd be happy to help build the initial template and pilot guides if there's interest. Thoughts?