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

docs(copy): Sprint 3 Know — content design foundation #15

Closed
jpmschweitzer wants to merge 0 commits from copy into main
pull from: copy
merge into: :main
Conversation 1 Commits - Files Changed -
jpmschweitzer commented 2026-02-12 18:18:31 +01:00
Owner
Copy Link
Copy Source

Summary

Sprint 3 "Know" — 15 tickets building the content design foundation for v0.1. All documentation/content work, no code changes. 39 files changed, ~5,100 lines added.

Wave 0 — Wiki Maintenance

  • Renamed Hael → Naia Tamm across 16 wiki files
  • Applied canonical full names to 11 single-name NPCs
  • Standardized location shortcodes (hub_m_ → terminal_m_)

Wave 1 — Critical Blockers

  • Content directory structure design doc (blocks server #385, #386)
  • Entity attributes updated to 16 keys with 4 role-perspective keys
  • Nils Davan off-stage NPC stub (GHOST + HANDLER)

Wave 2 — Design Documents

  • Dual Lens Authoring Guide (7 chapters, unblocks 11 downstream tickets)
  • THE MIRROR pattern spec with Naia Tamm reference implementation
  • NPC pattern/motivation mapping applied to all 18 NPCs
  • v0.1 wow moments checklist
  • Interaction verb spec (7 verbs)

Wave 3 — Unblocked Work

  • Triangle 1 Hub Power Volume Escalation fork (3 paths, ~41 dialogue lines)
  • PC-as-NPC unified spec (9-step conversion, v0.1 briefs)
  • Drin Rosta expanded from Tier 3 to Tier 2

Wave 4 — Double-Blocked

  • Smuggler voice card (register, anchors, anti-patterns, paired comparisons)
  • Smuggler moral arc (4 phases, FactId gates, Kael intersection)

Tickets closed

#261, #371, #372, #374, #375, #376, #377, #380, #381, #382, #384, #396, #397, #400, #402

Test plan

  • All markdown files render correctly
  • Internal cross-references resolve (relative links between design docs and wiki)
  • No stale "Hael" references in wiki (grep -r '\bHael\b' docs/wiki/ returns 0)
  • No stale hub_m_ shortcodes in monologue guide
  • NPC index roster table has 18 rows with Pattern + Motivation columns

🤖 Generated with Claude Code

## Summary Sprint 3 "Know" — 15 tickets building the content design foundation for v0.1. All documentation/content work, no code changes. 39 files changed, ~5,100 lines added. **Wave 0 — Wiki Maintenance** - Renamed Hael → Naia Tamm across 16 wiki files - Applied canonical full names to 11 single-name NPCs - Standardized location shortcodes (hub_m_ → terminal_m_) **Wave 1 — Critical Blockers** - Content directory structure design doc (blocks server #385, #386) - Entity attributes updated to 16 keys with 4 role-perspective keys - Nils Davan off-stage NPC stub (GHOST + HANDLER) **Wave 2 — Design Documents** - Dual Lens Authoring Guide (7 chapters, unblocks 11 downstream tickets) - THE MIRROR pattern spec with Naia Tamm reference implementation - NPC pattern/motivation mapping applied to all 18 NPCs - v0.1 wow moments checklist - Interaction verb spec (7 verbs) **Wave 3 — Unblocked Work** - Triangle 1 Hub Power Volume Escalation fork (3 paths, ~41 dialogue lines) - PC-as-NPC unified spec (9-step conversion, v0.1 briefs) - Drin Rosta expanded from Tier 3 to Tier 2 **Wave 4 — Double-Blocked** - Smuggler voice card (register, anchors, anti-patterns, paired comparisons) - Smuggler moral arc (4 phases, FactId gates, Kael intersection) ## Tickets closed #261, #371, #372, #374, #375, #376, #377, #380, #381, #382, #384, #396, #397, #400, #402 ## Test plan - [ ] All markdown files render correctly - [ ] Internal cross-references resolve (relative links between design docs and wiki) - [ ] No stale "Hael" references in wiki (`grep -r '\bHael\b' docs/wiki/` returns 0) - [ ] No stale `hub_m_` shortcodes in monologue guide - [ ] NPC index roster table has 18 rows with Pattern + Motivation columns 🤖 Generated with [Claude Code](https://claude.com/claude-code)
jpmschweitzer added 6 commits 2026-02-12 18:18:31 +01:00
docs(wiki): rename Hael to Naia Tamm, apply canonical full names, standardize shortcodes 64fea5139a 
Wave 0 wiki maintenance for Sprint 3:
- #372: Rename Hael → Naia Tamm across 16 living wiki files (phonetic collision fix)
- #371: Apply canonical full names to 11 single-name NPC headers and roster table
- #375: Replace hub_m_ → terminal_m_ shortcodes, add shortcode reference table,
  situation overlap rules, and mood exclusivity rules to monologue guide

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
docs(design): add content directory structure, update entity attributes, stub Nils Davan 5fdb7f9c53 
Wave 1 critical blockers for Sprint 3:
- #384: Content directory structure design doc (10 sections + 2 appendices,
  defines canonical IDs, 8 JSON schemas, 3-tier validation pipeline, migration path)
- #374: Update entity-attributes.md (14→16 keys, secret→leverage rename,
  add 4 role-perspective keys, archetype interpretation note)
- #376: Nils Davan off-stage NPC stub (GHOST+HANDLER pattern, lattice messages,
  Triangle 1 role, relationship to Kael)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
docs(design): add dual lens guide, MIRROR spec, interaction verbs, wow moments checklist, NPC pattern mapping 58c7d882bc 
Wave 2 of Sprint 3 "Know":
- #261: Dual Lens Authoring Guide (7 chapters, smuggler/detective voice registers)
- #380: THE MIRROR pattern spec with Naia Tamm reference implementation
- #396: Pattern/Motivation sections added to all 18 NPC wiki pages + index
- #400: v0.1 wow moments checklist mapping 6 D-039 moments to deliverables
- #402: Interaction verb spec (7 verbs, priority resolution, architecture)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
docs(wiki): add Triangle 1 fork, PC-as-NPC spec, expand Drin to Tier 2 d9448b5af0 
Wave 3 deliverables:
- Triangle 1 Hub Power Volume Escalation fork (#377): 3-path smuggler
  decision (escalate/stabilize/mediate), NPC state changes, ~41 dialogue lines
- PC-as-NPC unified spec (#381): starting knowledge/relationship graphs,
  tell inversion, orientation monologue, 9-step conversion checklist,
  v0.1 smuggler + detective briefs (29 items each)
- Drin Rosta Tier 2 expansion (#397): full 10-axis profile, 6 voice lines,
  formalized Triangle 2 + Triangle 5 roles

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
docs(design): add smuggler voice card and moral arc spec d06c0e0f4e 
Wave 4 deliverable for #382 (subsumes #310):
- Voice card: register parameters, 5 anchors, 4 anti-patterns, paired
  comparison examples, display constraints, authoring checklist
- Moral arc: 4 phases (Comfort→Doubt→Reckoning→Compromise), FactId
  gates, monologue trigger rules, Kael intersection mapping

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
chore(meta): update changelog e6bf06fb40 
Sprint 3 "Know" deliverables: dual lens guide, MIRROR spec, smuggler
voice card + moral arc, PC-as-NPC spec, Triangle 1 fork, content
directory structure, interaction verbs, wow moments checklist, NPC
pattern mapping, entity attribute updates, wiki maintenance.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
jpmschweitzer commented 2026-02-12 19:03:58 +01:00
Author
Owner
Copy Link
Copy Source

Review: copy -> main (type: copy)

Hoshe (QA): APPROVE

Well-organized PR with 38 files, 5k+ lines. Hael->Naia Tamm rename executed cleanly across all wiki and design files. Cross-references verified (50+ links), formatting consistent, NPC profile structure uniform across all tiers. No broken links, no spelling errors, no orphaned files.

No issues found.

Paula (Narrative Depth): APPROVE

Exceptional character work. Voice discipline is strong (smuggler fragments vs. detective complete sentences). Moral arc's 4-phase progression creates genuine emotional stakes. Triangle 1 fork produces real consequences across all 3 paths. Naia as MIRROR is devastating in her honesty. PC-as-NPC neutral path elegantly solves second-playthrough recognition.

# File Severity Issue
1 smuggler-moral-arc.md ~sec4 suggestion Kael Contradiction Discovery dual-fire sequence (15-30s delay) -- flag as tuning target to avoid feeling like one event
2 npc-patterns/the-mirror.md ~sec6 suggestion Clarify edge case: MIRROR NPCs can be wrong (lied to) without being dishonest
3 triangle-1-hub-power.md ~sec3c suggestion Path C creates deferred follow-up fork -- flag in implementation ticket or accept unresolved tension
4 pc-as-npc-spec.md ~sec11 suggestion 5 public-tier detective-NPC lines may feel thin on replay -- consider rotation variants post-v0.1
5 entity-attributes.md moral_weight suggestion Clarify whether detective uses moral_weight with same or different criteria than smuggler

Miri (World Consistency): REQUEST_CHANGES

Excellent internal consistency across 18+ NPC files, triangles, and design specs. Ring structure, entity attributes, naming conventions, and dual-lens framework all verified clean. IP is original. However, stale "Hael" references remain in decisions/content.md -- the canonical source of truth.

# File Severity Issue
1 decisions/content.md ~line 55 (D-034) critical "trying to exit the ring to protect partner Hael" -- should be "partner Naia"
2 decisions/content.md ~line 56 (D-034) critical "protecting friend Hael" -- should be "protecting friend Naia"
3 decisions/content.md ~line 90 (D-036) critical Krenn naming example list includes "Hael" alongside "Naia" -- confusing since Hael is no longer an active NPC name. Remove or annotate.

Verdict: CHANGES REQUESTED

The copy branch content itself is clean and production-ready. Three stale "Hael" references remain in decisions/content.md (D-034 and D-036) on main. These should be fixed on main before or after merge -- the copy team cannot fix files outside their branch.

Paula's 5 suggestions are non-blocking improvements for future content passes.

## Review: copy -> main (type: copy) ### Hoshe (QA): APPROVE Well-organized PR with 38 files, 5k+ lines. Hael->Naia Tamm rename executed cleanly across all wiki and design files. Cross-references verified (50+ links), formatting consistent, NPC profile structure uniform across all tiers. No broken links, no spelling errors, no orphaned files. No issues found. ### Paula (Narrative Depth): APPROVE Exceptional character work. Voice discipline is strong (smuggler fragments vs. detective complete sentences). Moral arc's 4-phase progression creates genuine emotional stakes. Triangle 1 fork produces real consequences across all 3 paths. Naia as MIRROR is devastating in her honesty. PC-as-NPC neutral path elegantly solves second-playthrough recognition. | # | File | Severity | Issue | |---|------|----------|-------| | 1 | `smuggler-moral-arc.md` ~sec4 | suggestion | Kael Contradiction Discovery dual-fire sequence (15-30s delay) -- flag as tuning target to avoid feeling like one event | | 2 | `npc-patterns/the-mirror.md` ~sec6 | suggestion | Clarify edge case: MIRROR NPCs can be wrong (lied to) without being dishonest | | 3 | `triangle-1-hub-power.md` ~sec3c | suggestion | Path C creates deferred follow-up fork -- flag in implementation ticket or accept unresolved tension | | 4 | `pc-as-npc-spec.md` ~sec11 | suggestion | 5 public-tier detective-NPC lines may feel thin on replay -- consider rotation variants post-v0.1 | | 5 | `entity-attributes.md` moral_weight | suggestion | Clarify whether detective uses moral_weight with same or different criteria than smuggler | ### Miri (World Consistency): REQUEST_CHANGES Excellent internal consistency across 18+ NPC files, triangles, and design specs. Ring structure, entity attributes, naming conventions, and dual-lens framework all verified clean. IP is original. However, stale "Hael" references remain in `decisions/content.md` -- the canonical source of truth. | # | File | Severity | Issue | |---|------|----------|-------| | 1 | `decisions/content.md` ~line 55 (D-034) | critical | "trying to exit the ring to protect partner Hael" -- should be "partner Naia" | | 2 | `decisions/content.md` ~line 56 (D-034) | critical | "protecting friend Hael" -- should be "protecting friend Naia" | | 3 | `decisions/content.md` ~line 90 (D-036) | critical | Krenn naming example list includes "Hael" alongside "Naia" -- confusing since Hael is no longer an active NPC name. Remove or annotate. | ### Verdict: CHANGES REQUESTED The copy branch content itself is clean and production-ready. Three stale "Hael" references remain in `decisions/content.md` (D-034 and D-036) on main. These should be fixed on main before or after merge -- the copy team cannot fix files outside their branch. Paula's 5 suggestions are non-blocking improvements for future content passes.
jpmschweitzer added 2 commits 2026-02-12 19:07:29 +01:00
Merge remote-tracking branch 'origin/main' into copy 16ee660b5d 
# Conflicts:
#	CHANGELOG.md
docs(copy): address PR #15 review feedback 010c4158f9 
Miri (critical):
- Fix 3 stale "Hael" references in decisions/content.md (D-034, D-036)

Paula (suggestions):
- Flag dual-fire 15-30s delay as tuning target in smuggler moral arc
- Clarify MIRROR NPCs can be wrong (lied to) without being dishonest
- Add implementation note for Path C deferred follow-up fork
- Note detective-NPC dialogue rotation variants for post-v0.1
- Clarify detective vs smuggler moral_weight criteria in entity attributes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
jpmschweitzer closed this pull request 2026-02-12 19:15:14 +01:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
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#15