docs: add RESUME.md and push integration/release branches for smooth restart
Some checks failed
CI / checks (push) Has been cancelled
Some checks failed
CI / checks (push) Has been cancelled
This commit is contained in:
0
.githooks/commit-msg
Executable file → Normal file
0
.githooks/commit-msg
Executable file → Normal file
0
.githooks/pre-commit
Executable file → Normal file
0
.githooks/pre-commit
Executable file → Normal file
0
.githooks/pre-push
Executable file → Normal file
0
.githooks/pre-push
Executable file → Normal file
53
RESUME.md
Normal file
53
RESUME.md
Normal 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
0
scripts/ci
Executable file → Normal file
0
scripts/commitlint-hook
Executable file → Normal file
0
scripts/commitlint-hook
Executable file → Normal file
0
scripts/setup-hooks
Executable file → Normal file
0
scripts/setup-hooks
Executable file → Normal file
Reference in New Issue
Block a user