Skip to content

docs: define topic branch lifecycle - #10

Merged
tensornull merged 1 commit into
mainfrom
agent/document-branch-lifecycle
Jul 23, 2026
Merged

docs: define topic branch lifecycle#10
tensornull merged 1 commit into
mainfrom
agent/document-branch-lifecycle

Conversation

@tensornull

Copy link
Copy Markdown
Contributor

What changed

  • Document dedicated short-lived topic branches and keep dev as the clean landing branch.
  • Require successful pull-request checks and a squash merge on origin/main before closing a topic lifecycle.
  • Define fail-closed --ff-only synchronization of main and dev.

Why

The repository contract did not explicitly define how an agent returns from merged task work to a clean, synchronized dev branch. The new rules make the accepted lifecycle and stop conditions auditable without destructive Git operations.

Validation

  • Independent standards review: no findings after revision
  • Independent spec review: no findings after revision
  • git diff --check
  • uv lock --check
  • uv run python scripts/check_version.py --require-public-preview-docs
  • uv run python scripts/check_secrets.py

@tensornull
tensornull marked this pull request as ready for review July 23, 2026 03:56
@tensornull
tensornull merged commit 7d9a3d7 into main Jul 23, 2026
10 checks passed
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