Skip to content

feat: add the planner and implementer document handoff - #4

Merged
igorjs merged 3 commits into
mainfrom
feat/restructure-skills-for-codex-s4-planner-and-implementer-contract
Nov 14, 2026
Merged

igorjs merged 3 commits into
mainfrom
feat/restructure-skills-for-codex-s4-planner-and-implementer-contract

Conversation

@igorjs

@igorjs igorjs commented Nov 13, 2026

Copy link
Copy Markdown
Member

Summary

Adds a document storage contract (docs/playbook/<type>/, one Status: line per document) that the planner writes and the implementer reads. The implementer runs only approved plans and specs, and returns design questions to the planner instead of deciding them. Checks 8 to 10 keep the two contract copies identical and guard the template status lines and the stop rule.

Notes for reviewers

The contract file exists in both skills, byte for byte, so each skill still works when someone copies it alone. check.sh and test-check.sh pass on this branch. The smoke test passes for both hosts: sh scripts/smoke-install.sh; echo "exit=$?" printed exit=0.

@igorjs
igorjs force-pushed the feat/restructure-skills-for-codex-s4-planner-and-implementer-contract branch 2 times, most recently from dbdbe00 to 133265e Compare November 14, 2026 01:40
@igorjs
igorjs force-pushed the test/restructure-skills-for-codex-s3-verification-tooling branch from 0851e1a to 1609341 Compare November 14, 2026 01:40
Add references/document-storage.md with the default folders, the status
line form and the statuses per document type. The planner SKILL.md,
documentation and handover workflows use it, and every template now has
one Status line.

Signed-off-by: igorjs <2278164+igorjs@users.noreply.github.com>
Copy the storage contract into the implementer, gate execution on an
approved Status line, and stop and return design questions to the
planner instead of deciding them.

Signed-off-by: igorjs <2278164+igorjs@users.noreply.github.com>
Add checks 8 to 10: the two contract copies match, each planner template
has its expected Status line, the workflows link the contract, and the
execution workflow keeps its status gate and stop rule.

Signed-off-by: igorjs <2278164+igorjs@users.noreply.github.com>
@igorjs
igorjs force-pushed the feat/restructure-skills-for-codex-s4-planner-and-implementer-contract branch from 133265e to be250c0 Compare November 14, 2026 01:42
@igorjs
igorjs changed the base branch from test/restructure-skills-for-codex-s3-verification-tooling to main November 14, 2026 01:42
@igorjs
igorjs marked this pull request as ready for review November 14, 2026 01:44
@igorjs
igorjs merged commit 2a475e6 into main Nov 14, 2026
1 check passed
@igorjs
igorjs deleted the feat/restructure-skills-for-codex-s4-planner-and-implementer-contract branch November 14, 2026 03:01
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