eagle0/docs/SMALL_EAGLE_TODO.md

The Small Eagle TODO

Goals

Be able to support a small (10-50 user) private alpha, including with strangers.

Larger set of goals in The Big Eagle TODO, but most of that is not necessary for MVP.

Current priority order

1. Finish tutorial & first-session onboarding, especially the clear first-session goal and guided first scenario.
2. Fix the basic Shardok AI issues that can make tactical battles feel broken or unfair.
3. Publish a known issues doc so alpha testers do not repeatedly report the same rough edges.
4. Verify the existing game-ended flow, then mark the win condition done if "all other factions defeated" works end-to-end.
5. Add mid-game progression events where the King recognizes the player as they gain power.
6. Add account-linking when provider switching or account recovery becomes important for alpha support.
7. Leave terms of service and Windows code signing deferred until they matter for public release or broader distribution.

Required

Gameplay Productionization

• All functionality works on production eagle / shardok servers
• Acceptable latency in all regions
• Shardok performance similar to QA
• Error logging & alerting
• Fix long disconnects on deployments
• Fix the Mac installer
• Still not reconnecting after deployments
• Notify about client updates, button to come directly back
• Generatedtext healing
• Kill outstanding shardok requests when game is deleted

Other Productionization

• Oauth sign-in
  • Add Google, others?
• User management
  • Invite codes
  • Link accounts
  • Choose display name
  • Just do account setup from the landing page?
• Download client directly from DO, avoid basic auth/my home network
• Support plan (Discord + in-client bug reporting + email contact)

Alpha Tester Support

• Feedback channel (Discord server)
• Bug report form in Unity client (Settings > Report Bug, sends to Discord webhook)
• Known issues doc (so testers don't report the same things)

IP / Legal

• Document and make available licenses for art & music (attributions panel)
• Required open source disclosures (attributions panel)
• Audit assets for anything we don't have rights to and replace it
• Replace heroes that are based on real 20th or 21st century people or IP
• Privacy policy (collecting accounts, OAuth data, gameplay data) (alpha notice on invite page/email)
• Terms of service (basic liability protection) - defer until public release
• Data deletion capability (user requests account removal) (accounts.eagle0.net)

Basic Gameplay

• Tutorial & first-session onboarding
  • In the Your Warlord panel, say what the profession is
  • And separate panels for each profession when you encounter one
  • Command tutorial for each command the first time it's clicked
  • Time to recruit / expand
    • And how expansion works
  • Province events
  • Running low on food
  • Time to swear brotherhood
    • When you get large, or
    • When you get a good candidate
  • Shardok tutorial!
  • Narrative hook in first few minutes - why should I care about my warlord?
  • Clear first-session goal ("try to capture your first province" or similar)
  • Early small victory to build momentum
  • Guided first scenario vs. overwhelming sandbox?
• Basic Shardok AI stuff fixed
• Lobby fixes
• Have goals / ending
  • Win condition: all other factions defeated
  • Mid-game progression: King recognizes you as you gain power (generated events)

Nice to have

• "What's new" changelog (fetch JSON, show entries since last launch)
• Windows code signing (Azure Artifact Signing, ~$10/mo) to eliminate SmartScreen "unknown publisher" warning