Files
settled-reach/docs/assets/README.md
T
jpmschweitzerandClaude Fable 5 2ca70d0228 docs(assets): PR #211 review fixes — ratified glazing tokens, D-257, manifest skip contract
Review round (Hoshe + Tyre, both REQUEST_CHANGES) fully addressed:
palette.md's glass carve-out re-keyed from retired never-shipped tokens
(precision_glass/smart_facade) to the ratified glass_curtain_wall (wall)
+ industrial_glazing (facade); the toon/PBR treatment promoted from a
docs-only ruling to D-257 (architecture, cross-refs D-235/D-244/D-043/
D-044/D-033) with palette.md §2 now citing it as authority; D-149 +
D-257 added to decision_refs; manifest.json _comment gains the explicit
underscore-prefix loader skip contract; master pipeline table Visual row
Stub -> Active; conventions.md mask pointer Section 3 -> 5; pre-existing
broken D-066 links in the mood-board transcript repaired (leave-cleaner).

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

3.4 KiB

title, description, type, status
title description type status
Asset Pipeline Index Master index linking all asset pipelines (audio, visual, video) with structure and conventions design active

Asset Pipeline Index

Centralized tracking for all production assets across pipelines. Each pipeline has its own index, palette (style bible), and per-category asset tables.

Pipelines

Pipeline Index Palette Status
Audio audio/README.md audio/palette.md Active — Sprint 7
Visual visual/README.md visual/palette.md Active — catalog + style bible instantiated (T-1050/T-1052)
Video video/README.md video/palette.md Stub

Structure

docs/assets/
  README.md              # This file — master index
  _templates/
    audio.md             # Row template + detailed entry template for audio
    sprite.md            # LEGACY object-sprite row template (D-244 retired sprites; model/texture/artwork rows are inline in each visual/*.md file, T-1050)
    video.md             # Row template + detailed entry template for video
  audio/
    README.md            # Audio pipeline index — categories, status summary
    palette.md           # Sonic palette, aesthetic guide, generation approach
    ambient.md           # All ambient loops (station, planet, biome, weather)
    sfx.md               # All SFX (footsteps, doors, impacts, events)
    ui.md                # All UI sounds (cursor, chimes, insert-tech)
  visual/                # 3D models + textures + flat artwork (D-244 — no per-object sprites)
    README.md            # Visual pipeline index
    palette.md           # Art direction, "the angle", color relationships
    models.md            # 3D objects/props (.glb via Trellis /glb-gen)
    textures.md          # PBR surface maps (BaseColor/Normal/Roughness) for 3D models
    artwork.md           # Flat 2D art — paintings, flags, billboards, signage (via /sprite-gen)
    icons.md             # UI icons, status indicators (UI layer)
    effects.md           # Shaders, particles, overlays
    conventions.md       # Model naming, mask sidecars, D-235-keyed texture naming, footprint metadata (T-1050)
  video/
    README.md            # Video pipeline index
    palette.md           # Motion/editing style guide
    trailers.md          # Marketing / Steam page trailers
    cutscenes.md         # In-game narrative moments

Conventions

  • One .md per category — asset table with one row per asset, detailed entries below for complex items
  • palette.md per pipeline — the style bible. Aesthetic baseline, theme, generation approach.
  • Status values: planned | in-progress | placeholder | final
  • Templates: _templates/{type}.md — row format + detailed entry format
  • Asset files live in client/assets/{type}/ — these docs track design and production metadata
  • Category splitting: When a category file grows too long, split by domain (e.g., furniture-station.md, furniture-colony.md)

Cross-References

  • Decision files: decisions/ (D-038 audio scope, D-033 entity colors, D-019 camera angle)
  • Art direction workshop: docs/workshops/art-direction-mood-board/
  • Sprint briefings: docs/sprints/sprint-N/{team}.md