skills/build-3d-game-rooms/references/lessons.json

{
  "schema": "game-room.room-lessons.v1",
  "lessons": [
    {
      "id": "architecture-communicates-function",
      "status": "approved",
      "sourceRoom": "anonymized-production-review",
      "observation": "A dominant form that visually promised a function but did not provide it made the room feel wrong even when collision checks passed.",
      "rule": "Make architectural function readable before ornament.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["function", "form"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "openings-need-destination-or-depth",
      "status": "approved",
      "sourceRoom": "anonymized-production-review",
      "observation": "A decorative surround terminated at a flat wall and read as a blocked doorway.",
      "rule": "Use arches only for passages or unmistakably deep, complete, purpose-built alcoves.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {"minimumAlcoveDepth": "max(0.35 m, 15% of opening height)"},
      "scope": "all-room-families",
      "pipelineStages": ["function", "form"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "procedural-substrate-decorative-dressing",
      "status": "approved",
      "sourceRoom": "anonymized-production-review",
      "observation": "Decorative modules alone made continuity, collision, and openings harder to control.",
      "rule": "Use procedural geometry for sealed walls, floors, and ceilings; Boolean structural openings; use imported or generated assets as detailed dressing.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["form"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "physical-and-screen-clearance",
      "status": "approved",
      "sourceRoom": "anonymized-production-review",
      "observation": "Objects were physically separated but still formed distracting camera-space tangencies.",
      "rule": "Validate independent props with both world-space BVH or distance checks and production-camera screen-space gaps.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["form", "runtime"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "runtime-camera-is-authoritative",
      "status": "approved",
      "sourceRoom": "anonymized-production-review",
      "observation": "An authoring-tool proxy could not prove the live runtime hero's contact, viewport fit, or interaction.",
      "rule": "Use fixed authoring views for geometry QA, but use the loaded production camera as authority for hero fit and interaction.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["runtime"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "review-suite-ceiling-coverage",
      "status": "approved",
      "sourceRoom": "anonymized-multi-room-review",
      "observation": "Corner photos did not provide a useful view of ceilings.",
      "rule": "Include one center-up ceiling view and two opposed ceiling obliques that reveal ceiling form, attachments, lighting, and wall junctions.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {"minimumCeilingViews": 3, "requiredViews": ["center-up", "opposed-oblique-a", "opposed-oblique-b"]},
      "scope": "all-room-families",
      "pipelineStages": ["form", "runtime"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "floor-plan-complete-and-semantic",
      "status": "approved",
      "sourceRoom": "anonymized-multi-room-review",
      "observation": "Plans omitted entrance details and used ambiguous unlabeled masses.",
      "rule": "A review floor plan must cover the full entrance and room, show every feature or labeled prop group, and use distinct labeled styles.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["function", "form"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "declared-symmetry-controls-composition",
      "status": "approved",
      "sourceRoom": "anonymized-multi-room-review",
      "observation": "The shell declared a strong symmetry while placed objects ignored the same order.",
      "rule": "Declared symmetry must organize architecture, barriers, circulation, and repeated props; record every exception.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["function", "form"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "display-floor-marker-flat-centered",
      "status": "approved",
      "sourceRoom": "anonymized-display-gallery-review",
      "observation": "Floor markers were tilted or offset instead of lying directly beneath their display heroes.",
      "rule": "A display-gallery floor marker must lie flat, use its largest face horizontally, align to the hero anchor in plan, and read directly beneath the hero in the production camera.",
      "evidence": ["references/families/display-gallery.md"],
      "metrics": {},
      "scope": "display-gallery",
      "pipelineStages": ["function", "form", "runtime"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "attachment-face-orients-to-support",
      "status": "approved",
      "sourceRoom": "anonymized-multi-room-review",
      "observation": "Some floor and wall objects were attached using arbitrary faces or faced away from the room.",
      "rule": "Mount an object by its declared attachment face or largest suitable planar face; orient its semantic front upward on a floor or inward from a wall.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["form"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "open-colonnades-no-wall-infill",
      "status": "approved",
      "sourceRoom": "anonymized-multi-room-review",
      "observation": "Opaque walls between freestanding columns blocked the intended exterior view.",
      "rule": "Keep freestanding colonnade bays open to a visible exterior with explicit containment; use pilasters when a solid wall is intended.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["function", "form", "runtime"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "radial-rooms-radial-circulation",
      "status": "approved",
      "sourceRoom": "anonymized-multi-room-review",
      "observation": "Barriers and circulation fought the circular room language instead of reinforcing it.",
      "rule": "Circular rooms must use strongly radial barriers and circulation expressed as concentric rings, spokes, or repeated radial bays.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["function", "form"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    },
    {
      "id": "architectural-openings-require-booleans",
      "status": "approved",
      "sourceRoom": "anonymized-multi-room-review",
      "observation": "Architectural openings did not consistently correspond to actual holes in the wall substrate.",
      "rule": "Every arch, door, and window on a wall must reference an opening-schedule entry and an evaluated Boolean aperture before its surround is placed.",
      "evidence": ["references/design-doctrine.md"],
      "metrics": {},
      "scope": "all-room-families",
      "pipelineStages": ["function", "form"],
      "proposedAt": "2026-09-02",
      "decidedAt": "2026-09-02",
      "approvedBy": "maintainers",
      "supersedes": null,
      "supersededBy": null
    }
  ]
}