Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

Status: Active
Source PR: #313

​
Goal

Replace the single large development -> production PR with smaller, production-safe PRs built from a fresh production-based integration branch.

​
Branching Sequence

git fetch origin --prune
git checkout -b release/pr313-integration origin/production
git merge --no-ff origin/development
Resolve conflicts only once on release/pr313-integration, then split by scope below.

​
Scope Buckets

Use this helper to generate current bucket files: 
node scripts/ci/split-pr313-scopes.mjs
Recommended release waves:
  1. release/pr313-wave1-infra-agent-config
    • .cursor/**, .github/agents/**, .github/instructions/**, .codex/**, .agents/**, .claude/**
  2. release/pr313-wave2-cl-features
    • src/cores/cl/**, CL-related supabase/functions/**, specs/cl/**
  3. release/pr313-wave3-fw-runtime
    • src/cores/fw/**, automation runtime surfaces, related platform forms
  4. release/pr313-wave4-docs-specs
    • remaining docs/spec/report-only changes

​
Implementation Procedure

For each wave: 
git checkout -b <wave-branch> release/pr313-integration
# Stage only bucket files for the wave:
git reset
git add <paths-for-wave>
git commit -m "<wave-specific message>"
git push -u origin <wave-branch>
gh pr create --base production --head <wave-branch> --title "<title>" --body "<body>"

​
Merge Order

Merge waves in this order:
  1. infra/agent-config
  2. CL feature/runtime
  3. FW/runtime
  4. docs/spec reconciliation
After each merge: 
git checkout development
git pull --ff-only origin development
git merge --no-ff origin/production
git push origin development

​
Exit Criteria

  • No production PR exceeds reviewable scope.
  • All required checks pass on each wave.
  • development is back-merged from production after each wave.
  • PR #313 is superseded and can be closed once all wave PRs are merged.