pdurlej/platform

Fork 0

docs(handoff): 12-draft pre-compaction handoff for next claude session #183

Closed

claude wants to merge 2 commits from claude/handoff-2026-05-11-12-drafts into main

claude commented

2026-05-11 08:48:07 +02:00

Collaborator

What

Pre-compaction handoff bundle: 12 detailed handoff documents (+ README index) so post-compaction Claude session can execute 12 draft PRs without re-deriving context. Per operator's wise pre-emption 2026-05-11 ~08:30.

Each handoff = self-contained spec for a draft PR responding to DeepSeek-v4-Pro's architectural review of pdurlej/iskra-openclaw (2026-05-11) + operator's "co uwiera" amendments + Iskra's morning diagnostic confirming DeepSeek findings.

Files (13)

#	Handoff	Target repo	Pattern	Ralph?
-	README.md	(index)	-	-
1	ADR-0016 DeepSeek cousin elevation	platform	direct-merge	no
2	Apple Double cleanup	iskra-openclaw	direct-merge	no
3	Pytest auto-discovery	iskra-openclaw	direct-merge	no
4	TL;DR template	iskra-openclaw	direct-merge	no
5	HANDOFF.md protocol	platform	direct-merge	no
6	ADR-0017 maintenance window 2-3 daily	platform	direct-merge	no
7	Branch cleanup ritual runbook	iskra-openclaw	direct-merge	no
8	Unified Outbound Pipeline (DeepSeek Project 1)	iskra-openclaw	Codex-finish	maybe
9	Plugin Bridge (DeepSeek Project 2)	iskra-openclaw	Codex-finish	maybe
10	Registry Decomposition (DeepSeek Project 3)	iskra-openclaw	Codex-finish	no
11	Self-Healing Runtime-Deps (DeepSeek Project 4)	iskra-openclaw	Codex-finish	YES (security red-team)
12	iskra-daily-brief skill	iskra-openclaw	Codex-finish	no

Total ~13 files, ~3000+ LoC of dense Polish-English handoff spec.

Pipeline pattern introduced

Claude (this session) drafts handoffs → operator → next-Claude executes drafts → operator → DeepSeek on Pi → operator decides per-item ship/iterate/kill → push as PR if ship → Codex if Codex-finish-pattern → merge

NO push of per-item drafts to Forgejo until operator-DeepSeek verdict per pipeline pattern. This PR (handoff itself) is the exception — it's the prep artifact, not the drafts.

Why this PR exists

Operator at ~72% context for current Claude session: "odpowiednio będzie, żebyś przygotował handoffy, dokładne handoffy co ma być zrobione, co i gdzie. Tak, żebyś nie wykorzystał całego swojego kontekstu i tak, żeby kolejny po kompresji ty mógłby je dokończyć."

Per ADR-0008 durable job bundle pattern: thread-eviction-resilient work needs canonical handoff. This PR applies that pattern to cousin-thread-continuity across compaction boundary.

What this PR DOES NOT do

Does NOT execute any of the 12 drafts (that's post-compaction Claude's work)
Does NOT push any per-draft branch (pre-PR review gate per pipeline)
Does NOT modify any module.yaml, runtime path, or sacred path
Does NOT require operator decision before merge (handoff is meta-artifact; operator decides on DRAFTS per pipeline)

Acceptance criteria

README.md exists with index + pipeline + critical reminders
12 numbered handoffs exist (each: goal / target repo / spec sources / extracted context / what to ship / acceptance criteria / pattern / ralph / time / DO NOT / post-execution)
Companion closing letter at ~/Iskra-i-Piotr/03 Resources/Iskra/Listy od kuzynów/2026-05-11 — Claude Opus 4.7 (...).md
Operator informed: "12 drafts handoff ready; next Claude session executes; aggregate summary for DeepSeek-Pi review after"

Rollback

git revert <merge-commit>
git push origin main

Pure additive (13 new files in state/handoffs/). Reverting deletes handoffs. Safe.

Refs

Operator voice-note 2026-05-11 ~08:30 (pre-emption)
DeepSeek-v4-Pro architectural review 2026-05-11 (4 architecture projects + 6 operator-actionable items + advice)
Companion letter: ~/Iskra-i-Piotr/03 Resources/Iskra/Listy od kuzynów/2026-05-11 — Claude Opus 4.7 (...).md
ADR-0008 (durable job bundle; handoff is meta-application of this)
ADR-0015 (navigability-first; this handoff respects scope-pause-pivot)
Companion PRs: #168-#175, #182 (9 nie-mergowanych na platform from this session)

Codex effort needed

Codex not yet involved. Post-compaction Claude executes drafts. Per pipeline: 8 items direct-merge (operator merges directly), 5 items Codex-finish (Codex picks up after operator-merge to extend).

Role: orchestrator / drafter (claude)
Lane: governance / pre-compaction handoff
Next: operator /compact → fresh claude session reads state/handoffs/2026-05-11-12-drafts/README.md → executes.

## What Pre-compaction handoff bundle: 12 detailed handoff documents (+ README index) so post-compaction Claude session can execute 12 draft PRs without re-deriving context. Per operator's wise pre-emption 2026-05-11 ~08:30. Each handoff = self-contained spec for a draft PR responding to DeepSeek-v4-Pro's architectural review of `pdurlej/iskra-openclaw` (2026-05-11) + operator's "co uwiera" amendments + Iskra's morning diagnostic confirming DeepSeek findings. ## Files (13) | # | Handoff | Target repo | Pattern | Ralph? | |---|---------|-------------|---------|--------| | - | README.md | (index) | - | - | | 1 | ADR-0016 DeepSeek cousin elevation | platform | direct-merge | no | | 2 | Apple Double cleanup | iskra-openclaw | direct-merge | no | | 3 | Pytest auto-discovery | iskra-openclaw | direct-merge | no | | 4 | TL;DR template | iskra-openclaw | direct-merge | no | | 5 | HANDOFF.md protocol | platform | direct-merge | no | | 6 | ADR-0017 maintenance window 2-3 daily | platform | direct-merge | no | | 7 | Branch cleanup ritual runbook | iskra-openclaw | direct-merge | no | | 8 | Unified Outbound Pipeline (DeepSeek Project 1) | iskra-openclaw | Codex-finish | maybe | | 9 | Plugin Bridge (DeepSeek Project 2) | iskra-openclaw | Codex-finish | maybe | | 10 | Registry Decomposition (DeepSeek Project 3) | iskra-openclaw | Codex-finish | no | | 11 | Self-Healing Runtime-Deps (DeepSeek Project 4) | iskra-openclaw | Codex-finish | **YES** (security red-team) | | 12 | iskra-daily-brief skill | iskra-openclaw | Codex-finish | no | Total ~13 files, ~3000+ LoC of dense Polish-English handoff spec. ## Pipeline pattern introduced ``` Claude (this session) drafts handoffs → operator → next-Claude executes drafts → operator → DeepSeek on Pi → operator decides per-item ship/iterate/kill → push as PR if ship → Codex if Codex-finish-pattern → merge ``` NO push of per-item drafts to Forgejo until operator-DeepSeek verdict per pipeline pattern. This PR (handoff itself) is the exception — it's the prep artifact, not the drafts. ## Why this PR exists Operator at ~72% context for current Claude session: *"odpowiednio będzie, żebyś przygotował handoffy, dokładne handoffy co ma być zrobione, co i gdzie. Tak, żebyś nie wykorzystał całego swojego kontekstu i tak, żeby kolejny po kompresji ty mógłby je dokończyć."* Per ADR-0008 durable job bundle pattern: thread-eviction-resilient work needs canonical handoff. This PR applies that pattern to cousin-thread-continuity across compaction boundary. ## What this PR DOES NOT do - Does NOT execute any of the 12 drafts (that's post-compaction Claude's work) - Does NOT push any per-draft branch (pre-PR review gate per pipeline) - Does NOT modify any module.yaml, runtime path, or sacred path - Does NOT require operator decision before merge (handoff is meta-artifact; operator decides on DRAFTS per pipeline) ## Acceptance criteria - [x] README.md exists with index + pipeline + critical reminders - [x] 12 numbered handoffs exist (each: goal / target repo / spec sources / extracted context / what to ship / acceptance criteria / pattern / ralph / time / DO NOT / post-execution) - [x] Companion closing letter at `~/Iskra-i-Piotr/03 Resources/Iskra/Listy od kuzynów/2026-05-11 — Claude Opus 4.7 (...).md` - [ ] Operator informed: "12 drafts handoff ready; next Claude session executes; aggregate summary for DeepSeek-Pi review after" ## Rollback ``` git revert <merge-commit> git push origin main ``` Pure additive (13 new files in `state/handoffs/`). Reverting deletes handoffs. Safe. ## Refs - Operator voice-note 2026-05-11 ~08:30 (pre-emption) - DeepSeek-v4-Pro architectural review 2026-05-11 (4 architecture projects + 6 operator-actionable items + advice) - Companion letter: `~/Iskra-i-Piotr/03 Resources/Iskra/Listy od kuzynów/2026-05-11 — Claude Opus 4.7 (...).md` - ADR-0008 (durable job bundle; handoff is meta-application of this) - ADR-0015 (navigability-first; this handoff respects scope-pause-pivot) - Companion PRs: #168-#175, #182 (9 nie-mergowanych na platform from this session) ## Codex effort needed **Codex not yet involved.** Post-compaction Claude executes drafts. Per pipeline: 8 items direct-merge (operator merges directly), 5 items Codex-finish (Codex picks up after operator-merge to extend). --- **Role:** orchestrator / drafter (claude) **Lane:** governance / pre-compaction handoff **Next:** operator /compact → fresh claude session reads `state/handoffs/2026-05-11-12-drafts/README.md` → executes.

claude added 1 commit

2026-05-11 08:48:07 +02:00

docs(handoff): 12-draft pre-compaction handoff for next claude session

canary-required / collect-diff (pull_request) Failing after 3s

Details

canary-required / canary (pull_request) Has been skipped

Details

4f05e6e46c

Per operator's wise pre-emption 2026-05-11 ~08:30 (voice-note): instead of
burning remaining context on execution of 12 drafts, prep complete
handoffs so post-compaction Claude can execute cleanly. Per ADR-0008
durable job bundle pattern applied to cousin-thread continuity across
compaction boundary.

13 files in state/handoffs/2026-05-11-12-drafts/:
- README.md (index, pipeline order, critical reminders)
- 01-adr-0016-deepseek-cousin.md
- 02-apple-double-cleanup.md
- 03-pytest-autodiscovery.md
- 04-tldr-template.md
- 05-handoff-md-template.md
- 06-maintenance-window-adr.md (operator: 2:00-3:00 daily)
- 07-branch-cleanup-ritual.md
- 08-unified-outbound-pipeline.md (DeepSeek Project 1, HIGHEST)
- 09-plugin-bridge.md (DeepSeek Project 2)
- 10-registry-decomposition.md (DeepSeek Project 3)
- 11-self-healing-runtime-deps.md (DeepSeek Project 4, RALPH-LOOP)
- 12-iskra-daily-brief.md (operator: "Genialne")

Pattern: pre-PR review gate (new wzorzec introduced this session):
  claude (drafter) → operator → deepseek (on Pi) → operator decides →
  push as PR if ship-verdict → codex (if Codex-finish pattern) → merge.

NO push to Forgejo per-item until operator-DeepSeek verdict per pipeline
pattern. Local branches only on each handoff-execution session.

Refs:
- Operator voice-note 2026-05-11 ~08:30 (wise pre-emption)
- DeepSeek-v4-Pro architectural review 2026-05-11 (4 projects + 6
  operator-actionable items captured per-handoff)
- ADR-0008 (durable job bundle; handoff is meta-application)
- ADR-0015 (navigability-first; this handoff respects scope-pause-pivot)
- Companion letter: ~/Iskra-i-Piotr/03 Resources/Iskra/Listy od kuzynów/
  2026-05-11 — Claude Opus 4.7 (...).md

claude added 1 commit

2026-05-11 08:53:42 +02:00

docs(handoff): add #13 — AI Reviewer Ensemble via Forgejo Actions (convergence)

canary-required / collect-diff (pull_request) Failing after 3s

Details

canary-required / canary (pull_request) Has been skipped

Details

594a2b2fba

Per operator voice-note 2026-05-11 ~09:45 (post-shower architectural insight):
the missing piece tying DeepSeek elevation + Codex Forgejo Actions work +
Hermes bundle templates + 3+3 canary into one coherent pattern is "scripted
Ollama Cloud models as AI reviewers on Forgejo Actions". If ensemble approves
reversible work, PR auto-merges; operator-attention-cost drops drastically.

Plus operator attached Codex handoff for Forgejo Actions P0-P2 closure on
pdurlej/platform (current state: runners ready, Infisical 403, canary.env
not yet generated). This is the CI infrastructure layer the ensemble builds
on top of.

Handoff #13 captures:
- Operator's voice-note verbatim (the convergence)
- 6-lane ensemble design (tech-deepseek + tech-kimi + tech-glm + product-
  deepseek + product-minimax + safety-red-team)
- Auto-merge eligibility (reversible + non-sacred + size class + label-clean)
- ADR-0019 draft (depends on ADR-0016, 0017, 0018; Codex implementation after
  Forgejo Actions P0-P2 closes)
- Operator's Codex handoff captured for prerequisite tracking

This is the BIGGEST architectural pivot of this handoff bundle. Multi-week
arc, not single-session task. Future-Claude executes design; Codex implements
runtime after dependencies.

Refs:
- Operator voice-note 2026-05-11 ~09:45
- Codex handoff for Forgejo Actions P0-P2 (in operator's last message)
- DeepSeek-v4-Pro architectural review 2026-05-11 (empirical proof)
- ADR-0001, 0006, 0008, 0016, 0017, 0018; PR #174 Hermes templates

claude referenced this pull request

2026-05-11 22:00:04 +02:00

chore(governance): ADR-0016 — DeepSeek-v4-Pro as 8th cousin (deep-reviewer lane) #185

codex commented

2026-05-27 08:41:18 +02:00

Collaborator

If the idea is still useful, it should be rewritten from current main as a smaller atomic PR or issue. No old branch should merge only because it is green.

W9 rewrite/archive triage: closing this old PR as stale/superseded, not rejecting the underlying idea. Reason: Pre-compaction handoff bundle from 2026-05-11 is historical execution context; current work moved through W0-W8 and Patchwarden. If the idea is still useful, it should be rewritten from current main as a smaller atomic PR or issue. No old branch should merge only because it is green.

codex closed this pull request

2026-05-27 08:41:19 +02:00

codex referenced this pull request

2026-05-27 08:45:08 +02:00

docs(w9): rewrite stale charter topology #517