godot-rea

Turn a GDAS-reader ledger into a Godot 4.7 project. The project is a scaffold of stubs. It is not a port of machine code.

When to use

Run this after read_artifact.py has written ledger.json and the honesty rubric in GDAS-reader scores at least 3. Then open the Domain Skill named on each stub before writing gameplay.

python skills/gdas-reader/scripts/read_artifact.py P:\artifact --out P:\work\ledger.json
python skills/godot-rea/scripts/emit_project.py P:\work\ledger.json --out P:\work\godot-project
python skills/godot-rea/scripts/emit_project.py --self-test

What gets written

Path	Role
project.godot	Godot 4.7 project. Features are 4.7 and Forward Plus. Renderer is forward_plus. Main scene is res://scenes/main.tscn. The scene file has no uid:// line. The editor writes UIDs on import.
scenes/main.tscn	One child node per ledger entry. The node name is the ledger id, not the display name, so two entries cannot share a sibling name.
scripts/<id>.gd	Stub. Comment carries ledger id, status, evidence path, and the Godot skill to load. _ready is pass.
placeholders/ or assets/	Placeholders when the license is unspecified. Copied bytes when --allow-assets and the ledger license are both set.
COVERAGE.md	Limits plus one line per entry.

--allow-assets copies bytes into assets/<ledger-id>.<ext> when that entry's license is not blank or unspecified. It prefers the reader's copied path, then source_path. Without that pair, the emitter writes placeholders/ and leaves the bytes alone.

Expert Knowledge Delta

• A confirmed declaration means the name exists in the artifact. It does not mean the Godot function should reproduce that body. Load the suggested skill and re-implement the behavior you are allowed to write.
• A partial string from a PE or ELF scan is a hint. The reader does not walk the import table, so a .dll string is not a confirmed import. Wiring it to health or a signal without a second source of truth fails the honesty rubric.
• unknown entries still get a node so coverage stays visible. Leaving them out makes the project look finished.
• Headless ResourceSaver does not write UIDs. The emitter omits uid:// because uid://rea_main is illegal: ResourceUID text is a-z and 0-9 only, and an underscore returns INVALID_ID. After import, godot-builder runs godot -e --headless --import.
• config/features must include both 4.7 and Forward Plus, and renderer/rendering_method must be forward_plus. A features array that is only 4.7 loses the renderer tag the next time the editor saves the project.
• The text loader sets owner to the scene root when a node has parent="." and no owner field. parent is not that assignment. Node.duplicate() does not copy owner. A later PackedScene.pack drops children whose owner is unset, so that step must set_owner on the copy and each child.
• Godot 4.7 new projects stretch with canvas_items and expand once the editor rewrites settings. The emitter does not pin stretch. See references/migration-notes.md and references/ledger-contract.md.

NEVER

• NEVER invent damage formulas, scene flow, or input maps that the ledger does not state. A partial or unknown row is not a mechanic. Band 0 is that failure.
• NEVER mark a stub done by deleting pass and guessing a method body. The stub is done when the named Domain Skill replaces it.
• NEVER copy asset bytes unless --allow-assets is set and that entry's license is not blank or unspecified. An unspecified license means the bytes are not cleared to vendor into the project.
• NEVER decompile the original binary to fill a stub. The reader did not prove a function body, and a disassembly is not a Godot function.
• NEVER link this skill to GDAS-reader with a relative ../gdas-reader path. A single-skill install has no sibling folder. Use the GitHub URL in Related Skills.
• NEVER add a ## Godot 4.7 Baseline section here. Hop text stays in references/migration-notes.md.

Honesty rubric

Band	Rule
0	Emitted GDScript implements a mechanic the ledger marked partial or unknown.
1	COVERAGE.md omits limits or drops unknown ids.
2	Stubs exist but comments omit the skill name.
3	Every entry has a script, a coverage line, and a pass body. Comments are single lines.
4	Feature tags are 4.7 and Forward Plus. Suggested skills match the ledger. Assets are placeholders, or a licensed copy named from the ledger id when --allow-assets was set.

Ship at band 4.

Available Scripts

emit_project.py

Reads ledger JSON and writes the project tree. --self-test checks the Forward Plus feature tag, a comment that cannot become a statement, a placeholder when the license is unspecified, and a licensed copy under --allow-assets.

Field table and scene header: references/ledger-contract.md.

Reference

Official Documentation

• Godot projects — Project file and main scene the emitter writes.
• Scenes and nodes — Node tree the main scene uses for one stub per entry.
• GDScript basics — Typed _ready stubs.
• Upgrading to Godot 4.7 — Feature tag and stretch defaults.

Related Skills

Prerequisites

• gdas-reader — Writes the ledger this skill emits.
• godot-project-foundations — Folder and project conventions for the scaffold.
• godot-builder — Headless import after the files exist.

Complements

• godot-composition — Fill entity-shaped stubs.
• godot-combat-system — Fill combat-shaped symbols.
• godot-input-handling — Fill input entries.
• godot-ui-containers — Fill UI entries.
• godot-save-load-systems — Fill save entries.

Downstream / consumers

• godot-testing-patterns — Tests for stubs once a skill replaces pass.

Master

• godot-master — Router when a stub's suggested skill is the wrong chain.