Skip to content

docs: correct composition syntax in primer and book; add scene guidance and a pixelsrc skill - #37

Merged
scbrown merged 5 commits into
mainfrom
hammond/primer-scenes
Nov 15, 2026
Merged

scbrown merged 5 commits into
mainfrom
hammond/primer-scenes

Conversation

@scbrown

@scbrown scbrown commented Nov 12, 2026 •

Copy link
Copy Markdown
Owner

The primer and composition guide showed layer syntax that the renderer rejects. Use the actual sprites key map, map layers and cell_size grid, and add scene, recoloring and isometric guidance to the primer and authoring skill.

Scope the parse-recovery, nested-composition and inherited-palette limitations to released 0.3.1. Current source now includes the corresponding fixes; the guide distinguishes those fixes from an installed 0.3.1 executable. The symptom table follows the same version distinction.

Validation: the original composition examples were rendered with 0.3.1 and seven primer tests passed. The current source statements were checked against the landed parse-recovery, nested-rendering and inherited-token implementations and their regression controls. The latest follow-up changes prose only; whitespace checks pass. Fresh hosted CI and an independent non-author review remain required for this head.

Four other book pages still contain the older position syntax: personas/sprite-artist.md, getting-started/concepts.md, ai-generation/examples.md and ai-generation/system-prompts.md. They remain outside this guide/primer/skill change.

Demo: the rewritten composition guide provides the concrete runnable example. No behavior or installed executable changes in the prose follow-up; no runtime recording is claimed.

…idance and a pixelsrc skill

The primer and the composition page documented layers as { sprite, x, y } / position. The renderer
rejects that with 'missing field sprites'; compositions take a sprites key map and map layers.
Both now show the real form, with examples rendered on pxl 0.3.1.

Adds to the primer: recolouring by variant or by source + palette, building scenes (anchors,
far-to-near layers, alpha shadows, full-canvas sprites) and a 2:1 isometric recipe.
Adds skills/pixelsrc/SKILL.md, the first agent skill for the repo.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014TTLD9BXsReLisPj4eMGeJ
@scbrown
scbrown merged commit 7f76afe into main Nov 15, 2026
17 checks passed
@github-actions github-actions Bot mentioned this pull request Nov 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant