Update Controller Handoff docs to use compact default format #108

New Issue

2026-07-02T17:55:57-05:00

sysadmin commented

2026-07-02 17:55:57 -05:00

Summary

#101/#102 codified a long-form Controller Handoff Summary required at the end of every task. For routine work this is noisy. Make a compact handoff the default and reserve the long form for high-risk/complex tasks.

Compact default format

## Controller Handoff

- Task:
- Repo/state:
- Issues/PRs:
- Changed:
- Validation:
- Blockers:
- Review:
- Next:
- Safety:

Safety line usually: no self-review; no self-merge; no tags; no secrets; no prod

Long form still required when

merge/tag/release happened
validation failed
permissions/profile gates blocked work
secrets or production access were involved
an owner decision is complicated
the task involved multiple repos or cross-issue state
the owner explicitly asks for the full format

Docs to update

skills/llm-project-workflow/SKILL.md (§K)
docs/llm-workflow-runbooks.md
skills/llm-project-workflow/templates/start-issue.md
skills/llm-project-workflow/templates/review-pr.md

Acceptance criteria

Compact handoff documented as the default.
Long handoff reserved for the high-risk/complex cases above.
States the compact handoff is for controller-LLM readability, not a full human status report.
Safety confirmations are never omitted.
Clarifies PR bodies still need full review detail (the handoff does not replace PR documentation).

Documentation only; no code behavior changes.

## Summary #101/#102 codified a long-form `Controller Handoff Summary` required at the end of every task. For routine work this is noisy. Make a **compact** handoff the default and reserve the long form for high-risk/complex tasks. ## Compact default format ```md ## Controller Handoff - Task: - Repo/state: - Issues/PRs: - Changed: - Validation: - Blockers: - Review: - Next: - Safety: ``` Safety line usually: `no self-review; no self-merge; no tags; no secrets; no prod` ## Long form still required when * merge/tag/release happened * validation failed * permissions/profile gates blocked work * secrets or production access were involved * an owner decision is complicated * the task involved multiple repos or cross-issue state * the owner explicitly asks for the full format ## Docs to update * `skills/llm-project-workflow/SKILL.md` (§K) * `docs/llm-workflow-runbooks.md` * `skills/llm-project-workflow/templates/start-issue.md` * `skills/llm-project-workflow/templates/review-pr.md` ## Acceptance criteria * Compact handoff documented as the default. * Long handoff reserved for the high-risk/complex cases above. * States the compact handoff is for controller-LLM readability, not a full human status report. * Safety confirmations are never omitted. * Clarifies PR bodies still need full review detail (the handoff does not replace PR documentation). Documentation only; no code behavior changes.

sysadmin added the status:in-progress label 2026-07-02 17:56:10 -05:00

jcwalker3 referenced this issue from a commit

2026-07-02 17:59:27 -05:00

docs: compact Controller Handoff as default format (#108)

jcwalker3 referenced a pull request that will close this issue

2026-07-02 18:32:41 -05:00

docs: compact Controller Handoff as default format (#108) #115

sysadmin referenced this issue

2026-07-02 18:48:11 -05:00

docs: compact Controller Handoff as default format (#108) #115

sysadmin closed this issue

2026-07-02 18:48:35 -05:00