> ## 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.

# PR 313 Split Release Plan

> Status: Active Source PR: #313

**Status:** Active\
**Source PR:** [#313](https://github.com/Encore-OS/encoreos/pull/313)

## Goal

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

## Branching Sequence

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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.
