jpmschweitzer/settled-reach
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(visual): Sprint 14 visual spec suite — 6 design documents #48

Merged
jpmschweitzer merged 5 commits from visual into main 2026-02-20 19:28:39 +01:00
Conversation 1 Commits 5 Files Changed 9
+1674 -1
jpmschweitzer commented 2026-02-20 18:49:00 +01:00
Owner
Copy Link
Copy Source

Summary

Sprint 14 visual team deliverables — 6 design specification documents authored by Araminta, covering the full visual language for The Settled Reach's entity rendering, text display, sound indicators, and NPC behavioral expression.

New specs

  • docs/design/entity-color-system.md — #304: D-033 relationship-to-player color model with hex values, transition animations, color blindness analysis
  • docs/design/text-display-hierarchy.md — #316: 4 content pipelines (dialogue, monologue, observation, environmental) with screen positions, z-layers, font specs
  • docs/design/sound-indicator-visual.md — #317: Fog-edge pulse design for D-018 three-range sound model with direction encoding and range differentiation
  • docs/design/the-friend-visual-treatment.md — #318: 3-phase visual treatment for Kael Davan and Sera Venn (THE FRIEND pattern)
  • docs/design/environmental-text-standards.md — #334: Signage, terminal, and news ticker rendering with bilingual Concordat/Krenn treatment
  • docs/design/tell-visual-expression.md — #251: 5 tell categories mapped to 6 Tier 2 behavioral animations with scope boundaries for Dudley and Mellanie

Carry-over from Sprint 13

  • docs/design/monologue-display-spec.md — #315: Previously merged to main, included in diff

All specs include hex values, pixel dimensions, z-layer assignments, animation durations, and quick-reference tables. Self-contained for Stig to implement from docs alone.

Tickets

#304 (critical), #251, #316, #317, #318, #334

Test plan

  • All spec files render correctly in markdown
  • Hex values cross-referenced against D-033 canonical palette
  • Z-layer assignments consistent with D-049 stack
  • No contradictions between specs (entity-color ↔ THE FRIEND, text-hierarchy ↔ monologue-display)
## Summary Sprint 14 visual team deliverables — 6 design specification documents authored by Araminta, covering the full visual language for The Settled Reach's entity rendering, text display, sound indicators, and NPC behavioral expression. ### New specs - `docs/design/entity-color-system.md` — #304: D-033 relationship-to-player color model with hex values, transition animations, color blindness analysis - `docs/design/text-display-hierarchy.md` — #316: 4 content pipelines (dialogue, monologue, observation, environmental) with screen positions, z-layers, font specs - `docs/design/sound-indicator-visual.md` — #317: Fog-edge pulse design for D-018 three-range sound model with direction encoding and range differentiation - `docs/design/the-friend-visual-treatment.md` — #318: 3-phase visual treatment for Kael Davan and Sera Venn (THE FRIEND pattern) - `docs/design/environmental-text-standards.md` — #334: Signage, terminal, and news ticker rendering with bilingual Concordat/Krenn treatment - `docs/design/tell-visual-expression.md` — #251: 5 tell categories mapped to 6 Tier 2 behavioral animations with scope boundaries for Dudley and Mellanie ### Carry-over from Sprint 13 - `docs/design/monologue-display-spec.md` — #315: Previously merged to main, included in diff All specs include hex values, pixel dimensions, z-layer assignments, animation durations, and quick-reference tables. Self-contained for Stig to implement from docs alone. ## Tickets #304 (critical), #251, #316, #317, #318, #334 ## Test plan - [ ] All spec files render correctly in markdown - [ ] Hex values cross-referenced against D-033 canonical palette - [ ] Z-layer assignments consistent with D-049 stack - [ ] No contradictions between specs (entity-color ↔ THE FRIEND, text-hierarchy ↔ monologue-display)
jpmschweitzer added 4 commits 2026-02-20 18:49:00 +01:00
docs(visual): monologue display system visual spec (#315) 2eb887c75f 
Typography, positioning, stacking rules (max 3 lines), priority
system (observation > atmosphere > tutorial), fade animation,
character-differentiated color (detective cool, smuggler warm),
and 80-character line length constraint for copy team.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
chore(meta): update changelog 1fa04c3e89 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
chore: resolve CHANGELOG.md merge conflict from main 14cd16f33a
docs(visual): Sprint 14 visual spec suite — 6 design documents 0b5952a107 
Completes all Sprint 14 visual tickets (#304, #316, #317, #318, #334, #251).

- entity-color-system.md (#304): Full D-033 relationship→color spec. Hex values,
  runtime derivation from VisibleEntity.relationship, 0.5s transition behavior,
  fog edge cases, static object definition, color blindness assessment (deuteranopia
  and protanopia gaps flagged for v0.1.2+). Implementation notes for Stig.

- text-display-hierarchy.md (#316): Four content pipelines — dialogue, monologue,
  overheard/observation, environmental text. Screen positions, z-layers, font sizes,
  hex values, passive panel mode for D-078 overheard conversation.

- sound-indicator-visual.md (#317): Fog-edge pulse spec. Three color codes, direction
  encoding, three range-distance alpha levels, 2.5s pulse animation target, suppression
  rules, current vs target implementation delta for Stig.

- the-friend-visual-treatment.md (#318): Phase 1/2/3 visual states for Kael Davan
  and Sera Venn. Earned visual detail principle, 0.5s green→amber transition, staging
  requirement (first relationship color change in session), animation tier transition
  point. Cross-references entity-color-system.md.

- environmental-text-standards.md (#334): Signage, terminals, news tickers. Character
  limits, z-layers, two-state terminal model, bilingual Concordat Standard/Krenn
  vernacular treatment (D-036), scroll behavior, copy team and Stig quick-reference tables.

- tell-visual-expression.md (#251): 5 tell categories mapped to 6 Tier 2 behavioral
  patterns. Tile-level appearance descriptions, intensity scaling, server implementation
  notes for Dudley, monologue layer spec for Mellanie. THE FRIEND tell trajectory
  for Kael and Sera included.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
jpmschweitzer commented 2026-02-20 19:01:13 +01:00
Author
Owner
Copy Link
Copy Source

PR Review: visual -> main (type: visual)

Hoshe (QA): REQUEST_CHANGES

Well-structured documents with consistent formatting. Several reference accuracy issues.

# File Severity Issue
1 sound-indicator-visual.md S2 warning Cites "D-069 color codes" — D-069 is audio dip profiles, not colors. Should cite D-033/D-048.
2 entity-color-system.md S4.3 warning Attributes peripheral rendering to D-046 (lighting model) — should be D-015.
3 CHANGELOG.md warning Only lists monologue spec (#315) — missing entries for 5 other Sprint 14 design docs.
4 sound-indicator-visual.md S1 vs S7 warning S1 says medium range ~3-8 tiles, S7 defines sub-tiers up to 20 tiles. Contradiction.
5 entity-color-system.md Appendix B suggestion "At end of" cognitive delay vs D-060's "within" — wording could be tighter.
6 the-friend-visual-treatment.md App B suggestion D-063 title slightly off from canonical.
7 tell-visual-expression.md S2 suggestion Claims "D-024 specifies 5 tell categories" but D-024 only names the axis.
8 monologue-display-spec.md header suggestion Sprint 13 header while all other docs say Sprint 14.

Araminta (Art Direction): REQUEST_CHANGES

Color palette perfectly consistent across all 7 documents — every hex cross-checks cleanly. Z-layer stack consistent with D-049. Two issues need fixing.

# File Severity Issue
1 sound-indicator-visual.md S1 vs S7 critical Medium range ~3-8 tiles in S1 but sub-tiers extend to 20 tiles in S7. Ambiguous outer boundary for implementation.
2 visual-grammar-v01.md S5.2 warning Dialogue max-width still says "~70% screen width" — D-076 fixed to 640px (~33%). Source-of-truth doc is stale.
3 monologue-display-spec.md header warning Sprint 13 header in Sprint 14 PR bundle — version inconsistency.
4 entity-color-system.md S6.3 suggestion Accessibility mitigation deferred but no ticket tracked.
5 the-friend-visual-treatment.md App B suggestion D-063 citation title slightly off.
6 sound-indicator-visual.md App B suggestion Quick-reference has dual values in one row — split for clarity.
7 environmental-text-standards.md S3.1 suggestion Terminal visibility "~4 visual tiles" — specify tile unit for implementer.

Verdict: CHANGES REQUESTED

## PR Review: visual -> main (type: visual) ### Hoshe (QA): REQUEST_CHANGES Well-structured documents with consistent formatting. Several reference accuracy issues. | # | File | Severity | Issue | |---|------|----------|-------| | 1 | `sound-indicator-visual.md` S2 | warning | Cites "D-069 color codes" — D-069 is audio dip profiles, not colors. Should cite D-033/D-048. | | 2 | `entity-color-system.md` S4.3 | warning | Attributes peripheral rendering to D-046 (lighting model) — should be D-015. | | 3 | `CHANGELOG.md` | warning | Only lists monologue spec (#315) — missing entries for 5 other Sprint 14 design docs. | | 4 | `sound-indicator-visual.md` S1 vs S7 | warning | S1 says medium range ~3-8 tiles, S7 defines sub-tiers up to 20 tiles. Contradiction. | | 5 | `entity-color-system.md` Appendix B | suggestion | "At end of" cognitive delay vs D-060's "within" — wording could be tighter. | | 6 | `the-friend-visual-treatment.md` App B | suggestion | D-063 title slightly off from canonical. | | 7 | `tell-visual-expression.md` S2 | suggestion | Claims "D-024 specifies 5 tell categories" but D-024 only names the axis. | | 8 | `monologue-display-spec.md` header | suggestion | Sprint 13 header while all other docs say Sprint 14. | ### Araminta (Art Direction): REQUEST_CHANGES Color palette perfectly consistent across all 7 documents — every hex cross-checks cleanly. Z-layer stack consistent with D-049. Two issues need fixing. | # | File | Severity | Issue | |---|------|----------|-------| | 1 | `sound-indicator-visual.md` S1 vs S7 | critical | Medium range ~3-8 tiles in S1 but sub-tiers extend to 20 tiles in S7. Ambiguous outer boundary for implementation. | | 2 | `visual-grammar-v01.md` S5.2 | warning | Dialogue max-width still says "~70% screen width" — D-076 fixed to 640px (~33%). Source-of-truth doc is stale. | | 3 | `monologue-display-spec.md` header | warning | Sprint 13 header in Sprint 14 PR bundle — version inconsistency. | | 4 | `entity-color-system.md` S6.3 | suggestion | Accessibility mitigation deferred but no ticket tracked. | | 5 | `the-friend-visual-treatment.md` App B | suggestion | D-063 citation title slightly off. | | 6 | `sound-indicator-visual.md` App B | suggestion | Quick-reference has dual values in one row — split for clarity. | | 7 | `environmental-text-standards.md` S3.1 | suggestion | Terminal visibility "~4 visual tiles" — specify tile unit for implementer. | ### Verdict: CHANGES REQUESTED
jpmschweitzer added 1 commit 2026-02-20 19:04:06 +01:00
fix(visual): address PR #48 review comments 3c4304f745 
- sound-indicator-visual: D-069 → D-033/D-048 color reference, reconcile
  medium range S1 (3-8) vs S7 (3-20) contradiction, split dual values in
  quick-reference table
- entity-color-system: D-046 → D-015 for peripheral rendering, tighten
  cognitive delay wording, add accessibility ticket tracking note
- visual-grammar-v01: dialogue max-width corrected from ~70% to 640px
  per D-076
- the-friend-visual-treatment: D-063 citation title corrected
- tell-visual-expression: soften D-024 attribution (axis, not categories)
- environmental-text-standards: specify tile unit for terminal visibility
- monologue-display-spec: header updated to reflect Sprint 14 inclusion
- CHANGELOG: add entries for all 6 Sprint 14 design docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
jpmschweitzer merged commit b2559d5467 into main 2026-02-20 19:28:39 +01:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
jpmschweitzer (Jeroen Schweitzer)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: jpmschweitzer/settled-reach#48