blumeops/docs/how-to
Erich Blume 9b4951bf94 Improve Mikado process: cycle discipline, reset rigor, --resume enhancements (#261)
## Summary
- **End-of-cycle prompting:** After closing a leaf node and pushing, the agent should prompt the user to review and suggest ending the session rather than rushing into the next leaf
- **Reset rigor:** Reinforced that errors during impl should trigger a branch reset + plan update (not fix-forward). Documented the `git log --oneline --not main` → `git reset --hard` → `git cherry-pick` pattern with clear threshold guidance
- **`--resume` shows PR number:** Queries the Forgejo API for open PRs matching the branch, displays number/title/URL and a hint to run `pr-comments`
- **`--resume` checks git stash:** Shows stash entries as a non-presumptive hint — informs without assuming they apply

## Test plan
- [ ] `mise run docs-mikado --resume` runs without errors (no active chains case)
- [ ] On a mikado branch with an open PR, verify PR info is shown
- [ ] With stashed work, verify stash entries are displayed
- [ ] Review agent-change-process.md for clarity

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/261
2026-02-23 21:03:27 -08:00
..
authentik Review deploy-authentik: rewrite as process guide (#257) 2026-02-23 14:35:39 -08:00
configuration Rename containers/forgejo-runner to runner-job-image 2026-02-23 17:44:51 -08:00
deployment Adopt commit-based container tags (#232) 2026-02-20 22:56:20 -08:00
forgejo-runner Upgrade k8s forgejo-runner from v6.3.1 to v12.7.0 (#251) 2026-02-22 17:43:39 -08:00
grafana C2: Upgrade Grafana to 12.x with Nix container and Kustomize (#260) 2026-02-23 18:07:18 -08:00
knowledgebase Replace indri-runner-logs with general-purpose runner-logs Typer CLI (#244) 2026-02-22 10:20:11 -08:00
operations Review gandi-operations doc and reorganize how-to guides (#200) 2026-02-17 07:29:33 -08:00
plans Review Grafana: replace Helm upgrade plan with C2 Mikado chain (#258) 2026-02-23 15:06:00 -08:00
ringtail Update ringtail flake inputs, add flake-update pipeline (#240) 2026-02-22 08:17:52 -08:00
zot Docs pass: update zot Mikado chain for completion 2026-02-21 15:32:34 -08:00
agent-change-process.md Improve Mikado process: cycle discipline, reset rigor, --resume enhancements (#261) 2026-02-23 21:03:27 -08:00
how-to.md Formalize C0/C1/C2 change classification (#259) 2026-02-23 16:19:54 -08:00