docs(orchestrator): add §12 PR retrospective lessons (validated 2026-05-02) #24

Merged
pdurlej merged 1 commit from claude/docs/retro-lessons-codification into main 2026-05-02 10:55:55 +02:00
Collaborator

Summary

Per operator request 2026-05-02 ~09:25 CEST: "zaimplementuj retro lessions i zapamiętaj to".

Codifies 8 rules from .sisyphus/research/pr-retrospective-2026-05-02.md (GLM autoresearch output, 10.7 KB) as permanent §12 in state/CLAUDE_SELF_INSTRUCTIONS.md.

Rules baked in

Do more (4): canary-driven dev / GLM-5.1 for docs+prompts / REST API + dedicated PAT MANDATE / subsumed-PR pattern

Stop (2): MCP Forgejo for PR creation (admin-token problem) / mixing scope in single PRs

Process (2): pre-flight git log origin/main / bootstrap-paradox detection for charter PRs

Plus:

  • Operator pre-auth A/B/C/D pattern (validated 2026-05-02 night session)
  • Failure-mode note: ScheduleWakeup silent-fail at ~03:30 CEST, do not rely on <<autonomous-loop-dynamic>> for time-bounded resume

Scope (per charter §3)

Small impact: docs-only, single-file, +44 LOC, no charter touch, no behavior change → push directly per operator pre-auth A. Pre-MERGED via operator's "pry klepnięte" approval.

Co-authors

  • GLM-5.1 (pr-retrospective autoresearch, 8 rules source)
  • Operator (validation + "zapamiętaj to" trigger)
  • Claude Opus 4.7 (1M context)
## Summary Per operator request 2026-05-02 ~09:25 CEST: *"zaimplementuj retro lessions i zapamiętaj to"*. Codifies 8 rules from `.sisyphus/research/pr-retrospective-2026-05-02.md` (GLM autoresearch output, 10.7 KB) as permanent §12 in `state/CLAUDE_SELF_INSTRUCTIONS.md`. ## Rules baked in **Do more (4):** canary-driven dev / GLM-5.1 for docs+prompts / REST API + dedicated PAT MANDATE / subsumed-PR pattern **Stop (2):** MCP Forgejo for PR creation (admin-token problem) / mixing scope in single PRs **Process (2):** pre-flight `git log origin/main` / bootstrap-paradox detection for charter PRs **Plus:** - Operator pre-auth A/B/C/D pattern (validated 2026-05-02 night session) - Failure-mode note: `ScheduleWakeup` silent-fail at ~03:30 CEST, do not rely on `<<autonomous-loop-dynamic>>` for time-bounded resume ## Scope (per charter §3) **Small impact**: docs-only, single-file, +44 LOC, no charter touch, no behavior change → push directly per operator pre-auth A. Pre-MERGED via operator's "pry klepnięte" approval. ## Co-authors - GLM-5.1 (pr-retrospective autoresearch, 8 rules source) - Operator (validation + "zapamiętaj to" trigger) - Claude Opus 4.7 (1M context)
Per operator's request 2026-05-02 ~09:25 CEST after reviewing GLM autoresearch
output `.sisyphus/research/pr-retrospective-2026-05-02.md` (10.7 KB):

> "zaimplementuj retro lessions i zapamiętaj to"

Codifies 8 rules from PR retrospective + 1 operator-pre-auth pattern + 1
failure-mode note (ScheduleWakeup silent fail) into CLAUDE_SELF_INSTRUCTIONS §12:

What to do more (4 rules):
1. Canary-driven development works — keep frequency high for code PRs
2. GLM-5.1 viable for docs/prompts — default delegate, claude reviews
3. REST API + dedicated PAT = identity solution — MANDATE for tool-originated PRs
4. Subsumed-PR pattern is clean — standardize for rebase conflicts

What to stop (2 rules):
5. STOP opening PRs via MCP Forgejo tool (admin-token identity problem)
6. STOP mixing scope in single PRs (PR #6 canonical anti-example)

Process improvements (2 rules):
7. Pre-flight `git log --oneline origin/main` before branch creation
8. Bootstrap paradox detection for charter PRs (open loop)

Plus operator pre-auth pattern (A/B/C/D from this night session validated).
Plus failure-mode note: ScheduleWakeup silent fail at ~03:30 CEST,
do not rely on `<<autonomous-loop-dynamic>>` for time-bounded resume.

Per charter §3: small impact (docs only, single-file, +63 LOC, no charter touch,
no behavior change) → push directly per operator pre-auth A.

Co-authored-by: GLM-5.1 (autoresearch pr-retrospective-2026-05-02.md, 8 rules source)
Co-authored-by: Operator (validation + "zapamiętaj to" trigger)
Co-authored-by: Claude Opus 4.7 (1M context)
Sign in to join this conversation.
No reviewers
No labels
W6d-automerge-calibration
agent/claude-code
agent/codex
agent/hermes
agent/iskra
agent/ollama
agent/patchwarden
automerge-candidate
class/security-sensitive
cutover-gate
dependency/blocked
dependency/blocks-others
dependency/cross-repo
dependency/needs-confirmation
domain:agents
domain:ci
domain:docs
domain:forgejo
domain:infra
domain:memory
domain:runtime
domain:signal
domain:ux
flow/architecture
flow/blocked
flow/deployed
flow/done
flow/implementation
flow/intake
flow/maintained
flow/observed
flow/ready
flow/refining
flow/retired
flow/review
iterating
judge/codex-candidate
judge/hermes-candidate
judge/low-confidence
judge/needs-refinement
judge/operator-needed
judge/p0
judge/p1
judge/p2
judge/p3
judge/park
judge/patchwarden-candidate
judge/stale-priority
kind/adr
kind/bug
kind/chore
kind/feature
kind/infra
kind/ops
kind/refactor
kind/research
large-impact
merge/auto
merge/manual
merge/manual-dependency-conflict
merge/manual-failing-tests
merge/manual-merge-conflict
merge/manual-missing-review
merge/manual-operator-preference
merge/manual-red-zone
merge/manual-security-sensitive
merge/manual-unclear-scope
merge/manual-unknown
meta
mode:operator-only
mode:patchwarden-iskra-approved
mode:safe-auto
needs-operator-decision
needs-triage
not-ready
observed/erroring
observed/needs-followup
observed/pending
observed/retire-candidate
observed/unused
observed/used
operator-emotional
owner-attention
phase/02
phase/03
priority:p0
priority:p1
priority:p2
priority:p3
proposed
ready-for-agent
ready-for-operator
recovery
review:claude-reviewed
review:codex-reviewed
review:dziadek-reviewed
review:needs-human
risk/exposure
risk/process
risk/product
risk/runtime
safety:external-write
safety:no-prod-mutation
safety:prod-impact
safety:secret-touch
size/large
size/medium
size/small
size/tiny
size/unknown
source/adr
source/agent-generated
source/manual
source/operator-chat
source/voice-note
status:blocked
status:codex-ready
status:merged:pending-evidence
status:needs-evidence
status:operator-needed
status:parked
tier/full
tier/lite
tier/stacked
tier:0-platform-substrate
tier:1-iskra-value-layer
tier:2-tools-products-modules
type:bug
type:chore
type:docs
type:feat
type:policy
type:research
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
pdurlej/platform!24
No description provided.