Skip to content

docs: simplify upgrade SOP for AI agent execution#391

Merged
thepagent merged 1 commit intomainfrom
docs/simplified-upgrade-sop
Apr 16, 2026
Merged

docs: simplify upgrade SOP for AI agent execution#391
thepagent merged 1 commit intomainfrom
docs/simplified-upgrade-sop

Conversation

@thepagent
Copy link
Copy Markdown
Collaborator

Summary

Replaces the verbose upgrade SOP (~600 lines) with a streamlined guide (~260 lines) designed for AI agent execution.

Before vs After

Before After
Lines ~600 ~260
Backup steps 7 separate steps 3 items (values, secret, $HOME)
Verification gates Multiple with exit codes 1 simple check
Rollback helm rollback + manual PVC restore Uninstall → fresh install → restore
Human gates 2 (pre-release + post-upgrade) None — agent decides from smoke test
Pod label selector app.kubernetes.io/name=$DEPLOYMENT (wrong) app.kubernetes.io/component=kiro (correct)

Design principles

  1. Agent-first — every step is a concrete command, no ambiguous instructions
  2. Self-healing — failure at any point has a defined recovery path
  3. Minimal — 3 things to backup, 1 command to upgrade, 1 test to decide

Key improvements

  • Uses -f values.yaml (not --reuse-values) to avoid Helm: discord.enabled not set on upgrade from 0.7.6 causes CrashLoopBackOff #383 (missing discord.enabled on upgrade)
  • Uninstall + fresh install rollback is simpler than helm rollback which doesn't revert PVC data anyway
  • Version override built into the flow (supports both stable and beta targets)
  • Fixed pod label selector that was broken in the original SOP

Flow

RESOLVE → BACKUP → UPGRADE → SMOKE TEST → DONE ✅
                                    ↓ fail
                               ROLLBACK
                          (uninstall → reinstall → restore)

@github-actions github-actions bot added the closing-soon PR missing Discord Discussion URL — will auto-close in 3 days label Apr 16, 2026
@github-actions
Copy link
Copy Markdown

⚠️ This PR is missing a Discord Discussion URL in the body.

All PRs must reference a prior Discord discussion to ensure community alignment before implementation.

Please edit the PR description to include a link like:

Discord Discussion URL: https://discord.com/channels/...

This PR will be automatically closed in 3 days if the link is not added.

@thepagent thepagent force-pushed the docs/simplified-upgrade-sop branch 2 times, most recently from 6d02a78 to 561a290 Compare April 16, 2026 05:26
Replace the verbose 600+ line SOP with a streamlined 260 line guide
designed for AI agent execution:

- 5 clear sections: resolve → backup → upgrade → smoke test → rollback
- 3 backup items (values.yaml, secret, full $HOME) instead of 7 steps
- Uses -f values.yaml (not --reuse-values) to avoid #383
- Uninstall + fresh install rollback instead of helm rollback
- No human confirmation gates — agent decides from smoke test
- Fixed pod label selector (component=kiro, not name=$DEPLOYMENT)
@thepagent thepagent force-pushed the docs/simplified-upgrade-sop branch from 561a290 to 83760e4 Compare April 16, 2026 05:28
@thepagent thepagent merged commit 7a4ad82 into main Apr 16, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

closing-soon PR missing Discord Discussion URL — will auto-close in 3 days

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants