This repository uses lightweight, explicit releases.
- Prefer small, intelligible releases over large rewrites
- Keep snapshots immutable once published
- Update doctrine before changing public workflow claims
- Release only after both baseline and Ralph Loop paths still validate
Use simple semantic-ish tags:
v0.x.ywhile the project is still evolving quickly- bump:
- patch for doc or small scaffold fixes
- minor for meaningful scaffold or doctrine improvements
- major only if the skill’s public behavior changes in a breaking way
- Validate the current skill:
python C:\Users\Seven\.codex\skills\.system\skill-creator\scripts\quick_validate.py .\skills\harness-engineer- Validate any included snapshots that remain public.
- Compile-check the scaffold script.
- Smoke-test:
- baseline scaffold
- Ralph Loop scaffold if the preset or runner logic changed
- Update:
README.mdREADME.zh-CN.mdversions.jsonROADMAP.mdif priorities changed
- Create a release note that explains:
- what changed
- whether doctrine, scaffold logic, or both changed
- whether a new snapshot was added
Create a new snapshot when:
- the scaffold behavior changes materially
- the Ralph Loop preset meaningfully changes shape
- a rollback point would be useful for users or maintainers
Do not create snapshots for every tiny README edit.
Keep these areas in sync with the actual repository:
- description
- homepage
- topics
- latest release notes
Recommended topics:
codexcodex-skillharness-engineeringai-agentsralph-loopscaffoldinglong-running-agents