Files
settled-reach/docs/assets
jpmschweitzerandClaude Fable 5 f77e15d075 docs(assets): 3D-model+texture catalog, glb-gen production path, conventions (T-1050)
Instantiates the five D-244 catalog files (models/textures/artwork/icons/
effects — icons carries the 13 as-built SVGs, stance icons traced to their
consumer and marked final), creates client/assets/models/{furniture,props}
with a schema-documented manifest.json mirroring the character manifest,
fixes glb-gen SKILL.md's stale 'path does not exist' paragraph, and authors
docs/assets/visual/conventions.md: category-first model naming (araminta
ruling), mask sidecars per the character convention, D-235-token-keyed
texture naming, footprint_tiles as manifest metadata. Door-state and
TileSet conventions are recorded as explicit deferrals (Phase-5 owned).
visual/README.md carries both this ticket's count/link updates and
T-1052's palette-section rewrite (shared file, committed here).

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

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 Stub
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