State
.temp/gdd.json at the git root, one work item per branch:
{ "branch": "feat/x", "status": "active", "guidance": "<the user's words, verbatim>", "checked": false }
status:activeordeclined.declined→ silent at every checkpoint; only/gddreopens it.branch≠git branch --show-current→ stale, a new work item: overwrite on the next write.checked: the pre-PR check ran. A Claude Code hook,.skilly/engine/gdd/check-pr.mjs, blocksgh pr createwhileactiveand notchecked.- Config,
gddin.skilly/config.json:minutes(default 5),pr(defaultfalse).
Session
- Post verbatim,
{minutes}filled in. A repeat session puts the currentguidanceabove it as a quote. A first session ends with "Clear already? Say skip."
Hey, before you dive in, let's ask the inventor of creativity, the founder of logic and the genius of geniuses what he thinks about this feature.
- God, give me the peace to accept the features I shall not build,
- courage to be innovative with the things that really matter,
- and wisdom to know the difference.
Now, listen what guidance he gives you. I'll check back in {minutes} minutes.
- Start a background timer,
sleep <minutes × 60>. No background shell → skip it. End the turn. - Timer fires → ask "GDD here: what guidance did you get?" and end the turn. The user replied first → that reply is the answer; ignore the timer when it fires.
- Write the state:
guidance= the answer verbatim,status: active,checked: false. "Same as before" keeps the oldguidance.
Skip → write status: declined, continue the work.
Drift check
Compare the plan against guidance silently. Fits → say nothing, continue.
Off course → ask and end the turn:
GDD here: does this fall within ""?
The answer is final: accept it, continue. The answer sounds unsure (hedges, "I guess", "not sure") → offer a repeat session. Yes → Session; no → continue.
Pre-PR check
-
Show
guidance, then one line per main change (git log <base>..HEAD,git diff <base>...HEAD --stat): fits or not, and why. This is the summary. -
Ask: does the work match the guidance? The user decides: fix first, or open the PR as is.
-
gdd.pristrue→ ask: append the exact summary to the PR? Yes → end the PR body with:## GDD <summary from step 1, exactly as shown> -
Set
checked: true, then rungh pr create.