Files
settled-reach/docs/assets/_templates/asset-brief.md
T
jpmschweitzerandClaude Fable 5 2bac820c77 docs(assets): per-class production briefs + template + formal deferral register (T-1049)
The asset-brief template (scope/visual-reference/naming/gen-path/
acceptance, one page) and five real briefs — station walls, rural walls,
doors, floors, furniture/props — each citing its D-235 axis tokens and
palette.md register rows (or the D-257 toon default), conventions.md
naming/mask/footprint rules, and the image-gen -> glb-gen -> promotion
path with concrete acceptance counts. Doors carry the negative
no-state-frame-files constraint (runtime mechanism stays Phase 5);
furniture/props' first acceptance is promoting the three unpromoted
spike GLBs. deferred.md is the formal register for the T-1051 four
(lamp posts, barns, TVs, billboards) + cars/Q-067, with rationale and
revisit triggers — satisfying T-1051's own 'or record formal deferral'
deliverable. Child stories under T-961 are created lead-side at merge.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-25 23:00:51 +02:00

3.0 KiB

title, description, type, status, ticket, decision_refs, author, created, updated
title description type status ticket decision_refs author created updated
Asset Brief — {Class Name} {One-line: which manifest category and D-235 axis (if any) this class covers} design active
Araminta YYYY-MM-DD YYYY-MM-DD

Asset Brief — {Class Name}

One page. Gates the story below — a story with no linked brief does not enter in_progress. Cite standing conventions/palette rows; do not restate them.


1. Scope

{Which manifest category (furniture | props, or "N/A — building-exterior texture, no manifest entry") and which D-235 ObjectTag axis (wall/roof/facade/ street), if any. State plainly what this class IS and is NOT — e.g. "station walls, not rural walls" — so the story can't scope-creep into a sibling brief's territory.}

2. Visual Reference

{Cite palette.md §3's register row(s) for the relevant D-235 token(s) — hue range, grain, weathering baseline — by tag name, no restating the table. For classes with no D-235 token, cite palette.md §2 (toon default) or the D-257 glazing carve-out if the class includes glass/polished metal. Note any mood/reference touchstone specific to this class if palette.md doesn't already cover it.}

3. Naming

{Cite conventions.md §1 (<category>_<descriptor>.glb model naming), §2 (mask sidecar, single-channel vs RGBA multi-region) if tintable, §4 (footprint_tiles manifest field) if multi-tile. Give 1-2 concrete example filenames for this class. Note any class-specific naming wrinkle (e.g. door state handling — §5's negative constraint) rather than inventing new rules.}

4. Generation Path

{The standing path: /image-gen concept → /glb-gen (Trellis) → Blender postprocess → promotion into client/assets/models/{furniture,props}/ + manifest.json entry. Note class-specific concept-prompt guidance only if it differs from the standard /image-gen style-guide block (toon-shaded, near-white base, plain dark background, 3/4 front view). Note whether this class instead runs the textures.md (PBR standalone) or artwork.md (flat 2D) pipeline if it's not a .glb model.}

5. Acceptance

{N starter assets entering models.md (or textures.md/artwork.md) and manifest.json at planned status. List them by name if known, or state the count + selection principle (e.g. "the generic fallback parent + 2 specific tokens"). Note the Q-119 milestone-0 caveat if relevant: generic parents are milestone-0 IF Q-119 resolves yes — do not resolve Q-119 here.}


Cross-References

  • docs/assets/visual/conventions.md — naming/mask/footprint rules
  • docs/assets/visual/palette.md — D-235 color/material register, toon/PBR treatment
  • docs/assets/visual/models.md (or textures.md/artwork.md) — the catalog this brief feeds
  • client/assets/models/manifest.json — the machine-readable registry
  • .claude/skills/glb-gen/SKILL.md, .claude/skills/image-gen/SKILL.md — production pipeline