Game design workspace

State of the Game

A clear view of the current prototype, working references, and the system supporting them.
How Game Brain works

No blocking warnings from v1 checks

Limited checks only; this is not a freshness guarantee.

For Review

2 non-blocking item(s)
  • Latest session S-2026-07-12-shared-vault-private-portal.md has a not-promoted task: Complete Will's Obsidian Sync activation, invitation, initial download, cross-device edit, and version-recovery test
  • Latest session S-2026-07-12-shared-vault-private-portal.md has a not-promoted task: Refine the portal design, layout, and appearance without adding panels or changing source-of-truth boundaries
Current view

State of the Game

A short shared summary of where the game's development stands.

Not yet recorded.
Designed world

World Bible

Explore all

The people, groups, places, events, story threads, concepts, and encounters that make up the designed world.

0 proposed or developing · 0 accepted or locked.

Current Development Target

The main question or uncertainty the current work is meant to resolve.

Not yet recorded.

Test Readiness

Playtest Center

Shows whether a playable version, matching rules, and a test plan have been recorded.

PrototypeNot recorded
Rules versionNot recorded
Planned tests0
Open risks0

This reports recorded facts; it does not declare the game ready.

Next Creative Steps

The next creative actions explicitly chosen by Blake and Will.

Not yet recorded.

Open Design Questions

Important game questions that Blake and Will have not resolved yet.

No open design questions recorded.

Current Prototype Status

The latest recorded version that can be built or played.

No prototype versions recorded yet — the ledger is at 02-Areas/prototypes/prototype_version_ledger.md.

Recent Design Movement

What changed across the most recent prototype versions.

No prototype movement recorded yet.

Recent Design Decisions

Creative choices that were formally recorded, with their current status.

No game-design decisions recorded yet.

Rules & Mechanics Reference

The current written instructions and system references used to play the prototype.

No rules files yet. They will appear here as 02-Areas/rules/ gains content.

Playtest Pulse

The newest observed evidence from testing a specific prototype.

No prototype-linked playtest observations recorded yet.

Latest Handoff

Read the session handoff

What the previous work session completed, preserved, and left for the next session.

Objective: refine the private hosted portal's design, layout, and appearance while preserving its Design/System information architecture and trust layer.

Read first:

- `_meta/index.md`
- `_meta/current_state.md`
- `_meta/open_questions.md`
- this session log
- `03-Resources/scripts/build_portal.py`

Decisions to respect:

- DEC-0001: the shared Obsidian Sync vault is canonical; GitHub is background infrastructure.
- DEC-0002: the portal remains private at `gamebrain.clover-hg.com` for Blake and Will.
- Creative design belongs to Blake and Will; portal styling must not invent game canon or mechanics.

Non-goals:

- Do not add portal panels or features unless Blake explicitly expands scope.
- Do not weaken the freshness, warning, For Review, or authentication layers.

Known omissions:

- Will's Obsidian Sync onboarding and cross-device recovery test are still pending.

Boundary: Do not invent canon. Output is advisory until reconciled.

Verbatim from S-2026-07-12-shared-vault-private-portal.md.

Templates & Prompts

Reusable starting points for recording work consistently.

Templates

Prompts (copy to clipboard)

fable_adversarial_review_prompt.md (source)
# Fable Adversarial Review Prompt

Review Game Brain as an operating model, not as game design.

Do not invent lore, mechanics, factions, characters, campaign structure, or creative content.

Rank risks by damage. Focus on silent drift, duplicate truth, lost tasks, false portal confidence, AI-created canon leakage, and process load for a two-person team.

Return:

1. Executive verdict.
2. Top risks by damage.
3. What to cut or defer.
4. What must not be deferred.
5. Minimum viable v1 changes.
6. Specific edits to framework, structure, and portal.
7. Open questions for Blake and Will.
handoff_generation_prompt.md (source)
# Handoff Generation Prompt

Create a compact Game Brain handoff.

Include:

- objective
- read-first files
- decisions to respect
- open questions
- non-goals
- known omissions / not loaded
- creative-boundary warning

Use links or paths instead of copying large source text.

Do not promote summary language into canon.
model_output_reconciliation_prompt.md (source)
# Model Output Reconciliation Prompt

Reconcile the provided model output into Game Brain.

Do not accept all recommendations automatically.

For each recommendation choose:

- accept
- reject
- defer
- ask Blake/Will

Accept requires a rationale and a canonical file or GitHub Issue actually changed.

Reject/defer may be batched when not creative. Deferred items need a review trigger.

Creative material and approval-policy changes require Blake and Will.
session_closeout_prompt.md (source)
# Session Closeout Prompt

Close this Game Brain session.

Read `_meta/index.md`, `_meta/current_state.md`, `_meta/open_questions.md`, the
current/raw session notes, and any voice transcripts linked to the session.

Extract:

- decisions or "no decisions"
- witnessed approvals while Blake and Will were both present
- open questions or "none"
- tasks, each promoted to GitHub Issues or marked `not-promoted`
- next action
- current-state update only if current state is now wrong
- a concise, human-authored `State of the Game` update when the design state changed
- the current evidence-gathering `Current Development Target`, or `Not yet recorded.`
- concise `Next Creative Steps` selected by Blake and Will, or `Not yet recorded.`
- voice transcripts reviewed, reconciled, or explicitly left pending

The three design-facing blocks belong in `_meta/current_state.md`. Do not infer or
invent their content. Preserve the prior text when the session provides no new
human-authored design state or next step.

Do not promote creative material to canon without approval evidence from both Blake and Will.

A native voice transcript is working evidence, not canon or approval evidence.
Preserve the original transcript, mark unclear speech or uncertain speakers
instead of guessing, and reconcile extracted items into their proper canonical
files or GitHub Issues. Never delete source audio automatically. After the
transcript is reconciled, ask Blake or Will for explicit confirmation before
deleting it and record who confirmed and when.

Prepare a handoff block for the next assistant.

Voice Transcript Queue

Recordings sent from a phone that still need human review or reconciliation. Transcript content is kept out of the Design view.

No voice transcripts waiting in the inbox.

Audio is never deleted automatically; deletion requires explicit confirmation.

Health Strip

Counts that reveal missing reviews, unresolved work, or aging records.

0
Blocking warnings
2
Needs review
0
Unreconciled model output
0
Decisions pending both approvals
2
Not-promoted tasks (latest session)
1
Open questions
0
Voice transcripts pending
1
Days since last session

Computed counts only. No aggregate status light: the absence of warnings is not a freshness guarantee.

Approval Queue

Decisions that still require review, agreement, or prototype testing.

No proposed, prototype, or disputed decisions found.

Decision & Change History

2 recorded decision(s)

The chronological record of formal choices and their approval status.

IDTitleStatusDomainApproversDateSource
DEC-0002Private portal hostingAcceptedoperationsBlake, Will2026-07-12source
DEC-0001Blake/Will collaboration surfaceAcceptedoperationsBlake, Will2026-07-12source

Current State

Full canonical state note

The canonical written summary of the project and supporting system.

# Current State

## State of the Game

Not yet recorded.

## Current Development Target

Not yet recorded.

## Next Creative Steps

Not yet recorded.

## System State

Game Brain v1 scaffold is initialized and committed. The framework was Fable-reviewed and reconciled into a reduced v1: one ritual, a small register set, model-output quarantine, GitHub Issues for tasks, and one generated portal page. The placeholder smoke test passed on 2026-07-09.

The Blake/Will collaboration surface is resolved (DEC-0001): both edit the canonical Game Brain vault directly in Obsidian, Obsidian Sync provides encrypted remote synchronization and version recovery, the portal displays the game's current state, and GitHub runs in the background as backup and automation rather than a human editing surface. Google Drive remains optional for simultaneous drafting or large source material. Blake's encrypted `Game Brain` remote vault is active and fully synchronized; Will's Sync activation, invitation, and cross-device test remain pending.

The portal builder is Python (`03-Resources/scripts/build_portal.py`, stdlib-only), replacing the retired PowerShell builder. It emits the main `index.html`, the `PORTAL.md` fallback, generated World Bible pages under `world/`, and dedicated Prototype and Playtest centers under `prototype/` and `playtests/`. A shared primary navigation shell connects Design, World, Prototype, Playtests, and System. Design remains the default immersive view and now includes State of the Game, Current Development Target, factual test-readiness indicators, World Bible, next creative steps, design questions, prototype movement, creative decisions, rules, and playtest evidence. System contains the operational handoff, Game Brain tools, health, operational decisions, full state, reconciliation, and process content. The compact freshness banner and warnings remain above the Design/System tabs so trust signals are never hidden. World Bible pages are canonical Markdown under `01-World/`; the portal derives category navigation, entity pages, forward links, and reverse links without creating another truth surface. Proposed and accepted canon receive visibly different treatments, disputed material is always marked, and encounters map outcomes to story threads and designed state changes. Prototype pages bind purpose, scope, rules version, known breakages, and questions to a specific playable build. Playtest pages bind objectives and evidence to exact prototype and rules versions, while `_meta/development_risks.md` tracks evidence-backed risks without replacing GitHub Issues. The primary URL hashes remain `#design` / `#system`, with legacy `#dev` / `#analysis` aliases retained. Panels show verbatim register data or an explicit empty state, nothing machine-synthesized. A `--link-base` flag rewrites source links to absolute GitHub blob URLs for hosted builds; local builds and `PORTAL.md` keep relative links. Component inventory remains gated until real component counts exist, and balance tooling remains gated until numeric tuning begins. Session close remains the single portal writer; CI validates independently. The portal is privately hosted through Cloudflare Access for Blake and Will.

Voice capture now uses deliberately submitted native iPhone Voice Memos
transcripts. Working transcript notes live in `00-Inbox/voice/transcripts/`, are
reviewed before reconciliation, and remain visible only in the portal's System
space. Original audio is retained until reconciliation and is never deleted
without explicit confirmation from Blake or Will.

Portal v2's Grok-brief assessment is reconciled (MOR-0001 in `_meta/model_output_reconciliation.md`, partially_accepted): Phase A and private hosting from Phase B are implemented; the Issues snapshot and Phase C data-gated sections remain deferred behind their gates. Private hosting is accepted in DEC-0002; the default tab, Issues-snapshot compromise, and open-questions tag format remain routed to Blake + Will.

Register hygiene from the 2026-07-09 upgrade session: the V1 closeout now starts with commit+push (step 0); `PORTAL.md` is registered as Will's browser read surface; DEC-0001 names a scribe-model fallback and an extended review trigger; and a Cloudflare hosting go/no-go is tracked in open questions.

A GitHub scaffold is prepared but not yet applied: issue templates, a 10-label manifest, and `.github/gh-setup.ps1`. GitHub could not be reached from this session, so it is unrun.

Next action: dial in the hosted portal's design, layout, and appearance without changing its source-of-truth boundaries or adding new panels. After Will activates Obsidian Sync, invite him to the encrypted `Game Brain` remote vault and complete a cross-device edit plus version-recovery test. The GitHub remote is HTTPS.

Changed Since Last Session

Files edited after the newest session record, which may need review or closeout.

By file modified time, relative to S-2026-07-12-shared-vault-private-portal.md. Excludes .git, .obsidian, and the portal itself.

No files changed since the latest session log (S-2026-07-12-shared-vault-private-portal.md).

Model Output Quarantine

Assistant suggestions waiting for a human decision. They are not game truth or canon.

No unreconciled advisory model output found.

Reconciliation Metrics

How many assistant recommendations were accepted, partly accepted, rejected, or deferred.

accepted: 1partially_accepted: 5

Parsed from the Output Status Table in model_output_reconciliation.md.

Open Questions and Tasks

Unresolved project questions plus a link to the active task register.

  • Should the first portal export for Will be shared through Google Drive manually, or should Drive export wait until after the first real session? (The private hosted portal now covers the browser-view need; Drive remains optional for source material.)

Active tasks live in GitHub Issues: chg488/game_brain/issues