docs: add RESUME.md and push integration/release branches for smooth restart
Some checks failed
CI / checks (push) Has been cancelled

This commit is contained in:
2025-09-10 16:25:46 -05:00
parent ba2eeb086e
commit 28fa3dd385
7 changed files with 53 additions and 0 deletions

0
.githooks/commit-msg Executable file → Normal file
View File

0
.githooks/pre-commit Executable file → Normal file
View File

0
.githooks/pre-push Executable file → Normal file
View File

53
RESUME.md Normal file
View File

@@ -0,0 +1,53 @@
Resume Guide
Purpose
- Quick checklist to pick up work after restarting Codex CLI with expanded permissions.
Branches on remote
- main (default), integration, release, bootstrap, bootstrap-cicd
1) Pull latest
- git fetch --all --prune
- git switch bootstrap && git pull
- git switch bootstrap-cicd && git pull
- git switch integration && git pull
2) Ensure Docker is available
- Start Docker Desktop/daemon as needed
3) Install hooks locally
- make hooks-setup
4) Run local checks (Docker-only)
- git switch bootstrap && make quick && make build
- git switch bootstrap-cicd && make quick && make build
- Optional full pass: make check
5) Open PRs (when branches are green locally)
- bootstrap → integration: https://git.knownelement.com/KNEL/LLMScaffolding/pulls/new/bootstrap
- bootstrap-cicd → integration: https://git.knownelement.com/KNEL/LLMScaffolding/pulls/new/bootstrap-cicd
6) Merge to integration
- Use squash merge, allow auto-merge on green where configured
7) Release to main
- Open PR: integration → main (require 1 approval)
- After merge, tag manually (until CI runners are enabled):
- git switch main && git pull
- TAG=$(date -u +"v%Y.%m.%d-%H%M")
- git tag -a "$TAG" -m "Release $TAG"
- git push origin "$TAG"
- Optional: fast-forward release branch pointer:
- git branch -f release main && git push -f origin release
8) Docs & parity
- Git workflow: instructions/git-workflow.md
- Local CI parity: instructions/bootstrap-cicd.md
9) Defer CI enablement for two weeks
- Track in TODO.md: Revisit enabling runners and protected checks on 2025-09-24
10) Next tasks
- Answer any outstanding questions in questions/*
- On approval, implement further proposals and update instructions/*

0
scripts/ci Executable file → Normal file
View File

0
scripts/commitlint-hook Executable file → Normal file
View File

0
scripts/setup-hooks Executable file → Normal file
View File