Skip to content

docs(agents): document the real release procedure and where the cloud tracker is - #1388

Merged
ajianaz merged 1 commit into
developfrom
docs/agents-release-procedure
Oct 8, 2026
Merged

ajianaz merged 1 commit into
developfrom
docs/agents-release-procedure

Conversation

@ajianaz

@ajianaz ajianaz commented Oct 8, 2026

Copy link
Copy Markdown
Collaborator

What

AGENTS.md:

  • replace "POST-RELEASE SYNC IS MANDATORY" (a main→develop PR) with what is actually possible and done: no sync PR, the divergence is resolved in each release branch;
  • replace "Conflicts at release time" with a complete Release procedure (develop → main): pre-flight (owner-approved version, CORE contract check, mutation gate), release-prep PR (the 11-file shape), release branch with git merge -s ours origin/main after proving main has no unique content, squash PR into main, annotated tag only after the merge, and the post-tag steps (Homebrew tap PR, brew upgrade, crates.io/Docker checks, production uteke verify);
  • state that a Cora "empty result" is a blocker and that the job now diffs against the PR base (ci: pass the PR base branch to the Cora review action #1386);
  • note that uteke-cloud's tracker is Gitea (the GitHub repo is a stale mirror).

Why

The documented sync cannot be performed: the repository rejects merge commits and main only gets squash commits (#1381 was closed for that reason), so following the old rule was impossible and every release re-derived the real procedure. This writes down what v0.20.0 actually did (#1379, #1380, tag v0.20.0), including the traps hit on the way (tag-before-merge, Cora empty result, Homebrew PR format).

Testing

… tracker is

- the mandatory main->develop sync PR cannot be merged (merge commits are rejected,
  squash/rebase drop the -s ours merge, #1381): replace the rule with the per-release
  'merge main with the develop side' branch actually used for v0.20.0
- write the release procedure end to end (pre-flight, prep PR, release branch,
  squash to main, tag after merge, Homebrew tap, production verify)
- Cora: a real verdict is required; the job now diffs against the PR base (#1386)
- uteke-cloud's tracker is Gitea, the GitHub repo is a stale mirror

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@ajianaz ajianaz added the documentation Improvements or additions to documentation label Oct 8, 2026
@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown

🔍 Cora AI Code Review

✅ No issues found. Code looks good!


Review powered by cora-code · BYOK · MIT

@ajianaz
ajianaz merged commit 93e8145 into develop Oct 8, 2026
15 checks passed
@ajianaz
ajianaz deleted the docs/agents-release-procedure branch October 8, 2026 08:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant