Skip to content

docs: record cubic platform mechanics and PR-batch merge playbook - #1086

Merged
lfnovo merged 1 commit into
mainfrom
docs/cubic-mechanics-and-merge-playbook
Jul 11, 2026
Merged

docs: record cubic platform mechanics and PR-batch merge playbook#1086
lfnovo merged 1 commit into
mainfrom
docs/cubic-mechanics-and-merge-playbook

Conversation

@lfnovo

@lfnovo lfnovo commented Jul 11, 2026

Copy link
Copy Markdown
Owner

Moves operational knowledge out of session notes into the repo:

  • cubic.yaml: header comments now document the platform mechanics an editor needs — 5-agent cap, shared 10k-char limit with silent truncation for file_paths, config precedence chain, reply-to-teach memory, and context files (inform) vs custom agents (enforce). No config values changed.
  • docs/7-DEVELOPMENT/maintainer-guide.md: new "Merging PR Batches" section covering squash-merge policy, resolving the recurring CHANGELOG [Unreleased] conflicts, force-with-lease pushes to contributor forks, redirecting fixes away from code scheduled for replacement (refactor: migrate database layer to lfnovo/surreal-basics #1031), and checking for competing PRs before merging.
  • CHANGELOG one-liner under [Unreleased] / ### Added.

Review in cubic

@lfnovo
lfnovo merged commit 8fb0816 into main Jul 11, 2026
12 checks passed
@lfnovo
lfnovo deleted the docs/cubic-mechanics-and-merge-playbook branch September 2, 2026 22:03
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