docs: add automation and encounter design implementation plans - #47
Merged
Conversation
prodmodfour
marked this pull request as ready for review
July 26, 2026 11:22
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds the complete implementation sequence that follows the existing Ability automation plan without changing or interrupting that work:
ABILITY_AUTOMATION_PLAN.mdfinishes as currently defined.AUTOMATION_PRESENTATION_CONTRACT_PLAN.mdestablishes the source-agnostic action, passive, choice, pending-response, explanation, accepted-presentation, privacy, realtime, and recovery contracts.CAPABILITY_AUTOMATION_PLAN.mdcovers the full canonical capability catalog, including valued movement, passive facts, activated/contextual rules, geometry, senses, forms, crafting, campaign time, and typed GM adjudication.EDGE_AUTOMATION_PLAN.mdseparately covers Trainer Edges and a newly frozen app-owned Poké Edge catalog, with prerequisite/build validation, typed instances, grants, passives, triggers, campaign operations, and migration.FEATURE_AUTOMATION_PLAN.mdcovers source repair, classes/branches/ranks, AP Bind/Drain, Orders, Training, triggers, Stratagems, Weapon Features, permanent grants, capture, crafting, research, social, travel, and downtime.ENCOUNTER_UI_UX_PLAN.mdimplements the Battle Cockpit, source-agnostic action dock, decision layer, resolution stack, battle stage, progressive spatiality, tactical lens, GM Director layer, Encounter Builder, accessibility, responsive design, performance, rollout, and retirement of map-first live play.Also adds
DESIGN.mdas the normative product and visual-design authority. It defines Rotom Table as a living field terminal; establishes Field Guide, Workshop, and Live Encounter contexts; and specifies semantic colour, surfaces, shape grammar, typography, component anatomy, encounter choreography, motion, accessibility, responsive behaviour, authority/latency presentation, forbidden patterns, and governance.Planning guarantees
Files
AUTOMATION_PRESENTATION_CONTRACT_PLAN.mdCAPABILITY_AUTOMATION_PLAN.mdEDGE_AUTOMATION_PLAN.mdFEATURE_AUTOMATION_PLAN.mdENCOUNTER_UI_UX_PLAN.mdDESIGN.mdValidation
main: six added documentation files, 2,105 lines, no runtime-code changes, and no branch divergence.