Skip to content

Capture three rollout-process lessons in BACKLOG#4

Merged
Gimpleberry merged 1 commit into
mainfrom
backlog-rollout-lessons
Apr 29, 2026
Merged

Capture three rollout-process lessons in BACKLOG#4
Gimpleberry merged 1 commit into
mainfrom
backlog-rollout-lessons

Conversation

@Gimpleberry
Copy link
Copy Markdown
Owner

Captures three patch-script-template improvements surfaced during the validate.sh / CI lint parity rollout (PR #3):

  1. Sandbox must include kai.shared so Tenet 1 violations in generated Python files surface during pre-delivery QC.
  2. Patch scripts that create Python files should run ruff format on them as a final edit step.
  3. Parity-test pattern generalizes per CI workflow with a local mirror; defer meta-test until 2nd pair exists.

All three are PRIORITY: triggered by next applicable patch, not by clock time.

Summary

Captures three patch-script-template improvements surfaced during PR #3 (validate.sh / CI lint parity rollout). Pure documentation change, no functional impact.

Changes

  • path/to/file.py — what changed and why

Linked work

Follow-up to PR #3. No BACKLOG item closed (this PR adds to BACKLOG rather than completing an item).

  • Closes #
  • Backlog: <name of phase + item>
  • ADR: (if this introduces an architectural change)

Validation checklist (Tenet 5)

  • 1. Lint — ruff check + format --check clean on every modified file
  • 2. shared.py uniqueness — no symbol duplicated outside shared.py
  • 3. Encoding sweep — no non-ASCII in Python source
  • 4. Plugin registry — every entry has start()/stop()
  • 5. Import chain — no circular imports
  • 6. Lifecyclemain.py --check passes
  • 7. Docs present — README/CHANGELOG/DECISIONS/BACKLOG/PROJECT_KNOWLEDGE
  • 8. Config validkai validate-taxonomy passes
  • 9. Unit tests — all green
  • 10. Integration bootmain.py --boot-order works

scripts/validate.sh summary:

Passed: __ / 10

Documentation updated

  • CHANGELOG.md entry added under appropriate version
  • PROJECT_KNOWLEDGE.txt updated if architecture or folder map changed
  • DECISIONS.md ADR added if this is a non-trivial architectural choice
  • BACKLOG.md updated (phase items moved/completed/added)
  • In-app Help section added/updated if user-facing behavior changed

Screenshots / log excerpts

Risk + rollback plan

Pure documentation. git revert is a clean undo. No code, schema, or behavior changes.

Captures three patch-script-template improvements surfaced during the
validate.sh / CI lint parity rollout (PR #3):

1. Sandbox must include kai.shared so Tenet 1 violations in generated
   Python files surface during pre-delivery QC.
2. Patch scripts that create Python files should run ruff format on
   them as a final edit step.
3. Parity-test pattern generalizes per CI workflow with a local mirror;
   defer meta-test until 2nd pair exists.

All three are PRIORITY: triggered by next applicable patch, not by
clock time.
@Gimpleberry Gimpleberry merged commit 61428a4 into main Apr 29, 2026
4 checks passed
@Gimpleberry Gimpleberry deleted the backlog-rollout-lessons branch April 29, 2026 04:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant