7.3 KiB
Dual-Track Workflow Execution Plan (Revised)
For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
Goal: Re-seed workflow planning from a clean base branch (not the temporary branch), then execute isolated 86 and 80 tracks with real-operation-confirmed closeout and related Gitea issue closure.
Architecture: Start from feature/v3-session-policy-stream and create base/ouroboros-workflow-20260302. Bring only two workflow plan docs as one squashed seed commit. Branch task/86... and task/80... from that base with strict file-scope separation. For 80, update audit only after real-operation confirmation, then close related Gitea issues (children before parent). Final promotion happens by merging the validated stream to main.
Tech Stack: Git CLI, Gitea (tea) issue/PR workflow, Markdown docs (docs/ouroboros, docs/plans)
Task 1: Freeze temporary branch and identify export scope
Files:
- Modify: none
- Create: none
- Test: none
Step 1: Inspect temporary branch state
Run: git status --short --branch
Expected: current temporary branch with local changes listed.
Step 2: Preserve changes using stash (recommended)
Run: git stash push -u -m "tmp-before-workflow-reseed-2026-03-02"
Expected: stash created with tracked/untracked changes.
Step 3: Define transferable artifacts
Run: keep only these for reseed:
docs/plans/2026-03-02-ouroboros-dual-track-workflow-design.mddocs/plans/2026-03-02-dual-track-workflow-execution-plan.mdExpected: transfer scope fixed to two files.
Step 4: Verify clean working tree
Run: git status --short --branch
Expected: no local changes.
Step 5: Commit
# no commit in this task (stash-only preservation)
Task 2: Create clean official base and seed one commit
Files:
- Modify:
docs/plans/2026-03-02-ouroboros-dual-track-workflow-design.md - Modify:
docs/plans/2026-03-02-dual-track-workflow-execution-plan.md - Test: none
Step 1: Switch to canonical base
Run: git checkout feature/v3-session-policy-stream
Expected: branch switch successful.
Step 2: Update local base
Run: git pull --ff-only origin feature/v3-session-policy-stream
Expected: up-to-date or fast-forward update.
Step 3: Create staging base branch
Run: git checkout -b base/ouroboros-workflow-20260302
Expected: new branch created from updated feature base.
Step 4: Restore only two plan docs from temporary branch commits
Run (example): git checkout <temp-branch> -- docs/plans/2026-03-02-ouroboros-dual-track-workflow-design.md docs/plans/2026-03-02-dual-track-workflow-execution-plan.md
Expected: only two files restored in working tree.
Step 5: Create one squashed seed commit
Run: git add docs/plans/2026-03-02-ouroboros-dual-track-workflow-design.md docs/plans/2026-03-02-dual-track-workflow-execution-plan.md && git commit -m "docs: seed revised dual-track workflow plan"
Expected: single commit with two files only.
Step 6: Verify seed scope
Run: git show --name-only --oneline HEAD
Expected: exactly the two plan docs listed.
Step 7: Push official base
Run: git push -u origin base/ouroboros-workflow-20260302
Expected: remote tracking set.
Task 3: Open Track A (86) branch and initial PR
Files:
- Modify:
docs/ouroboros/86_peak_probability_model_plan.md - Test: none
Step 1: Create Track A branch
Run: git checkout -b task/86-peak-probability-plan
Expected: branch created from official base.
Step 2: Stage only 86 document
Run: git add docs/ouroboros/86_peak_probability_model_plan.md
Expected: only 86 doc staged.
Step 3: Commit initial PR seed
Run: git commit -m "docs: seed peak probability model plan (#86)"
Expected: one-document commit.
Step 4: Push branch
Run: git push -u origin task/86-peak-probability-plan
Expected: remote branch created.
Step 5: Open PR-A
Run: tea pr create --base base/ouroboros-workflow-20260302 --head task/86-peak-probability-plan --title "docs: seed peak probability model plan (#86)" --description "Initial planning PR for iterative concretization."
Expected: PR URL returned.
Task 4: Open Track B (80) branch for operation-confirmed closeout
Files:
- Modify:
docs/ouroboros/80_implementation_audit.md - Test: operation observation evidence (outside unit-test scope)
Step 1: Return to staging base
Run: git checkout base/ouroboros-workflow-20260302
Expected: branch switch successful.
Step 2: Create Track B branch
Run: git checkout -b task/80-implementation-audit-closeout
Expected: branch created.
Step 3: Apply closeout edits only after real-operation confirmation
Run: edit docs/ouroboros/80_implementation_audit.md
Expected: status/evidence sections updated with observed behavior, confirmation timestamp, and operational proof summary.
Step 4: Commit closeout update
Run: git add docs/ouroboros/80_implementation_audit.md && git commit -m "docs: close out implementation audit items after operation confirmation (#80)"
Expected: single-scope commit.
Step 5: Push and open PR-B
Run: git push -u origin task/80-implementation-audit-closeout
Expected: remote branch created.
Run: tea pr create --base base/ouroboros-workflow-20260302 --head task/80-implementation-audit-closeout --title "docs: close out implementation audit items (#80)" --description "Closeout based on real-operation confirmation."
Expected: PR URL returned.
Task 5: Close related Gitea issues after 80 confirmation
Files:
- Modify:
docs/ouroboros/80_implementation_audit.md(reference linkage only) - Test: issue parent-child completeness check
Step 1: Build related issue set from updated 80 audit
Run: parse issue references from 80 updated sections.
Expected: target open issue list prepared.
Step 2: Close child issues first
Run: tea issues close <child-issue-number> for each confirmed child.
Expected: all qualifying child issues closed.
Step 3: Close parent issues only when all children are closed
Run: tea issues close <parent-issue-number>
Expected: parent closes only after dependency check passes.
Step 4: Record closure summary in PR comment
Run: add PR comment with closed issue IDs and parent-child resolution note. Expected: auditable trace for closeout.
Task 6: Validate branch hygiene and merge path
Files:
- Modify: none
- Test: git diff/log checks
Step 1: Verify PR-A scope
Run: git diff --name-only base/ouroboros-workflow-20260302...task/86-peak-probability-plan
Expected: only docs/ouroboros/86_peak_probability_model_plan.md (and intentional related plan files if any).
Step 2: Verify PR-B scope
Run: git diff --name-only base/ouroboros-workflow-20260302...task/80-implementation-audit-closeout
Expected: only docs/ouroboros/80_implementation_audit.md (and intentional related plan files if any).
Step 3: Merge both PRs into staging base
Run: GitHub merge flow for PR-A and PR-B Expected: staging base includes both tracks without cross-file contamination.
Step 4: Promote validated stream to main
Run: open PR from feature/v3-session-policy-stream (or its validated promotion branch) to main
Expected: merge-based history preservation with no cherry-pick/rebase surgery.
Step 5: Commit
# no additional commit required in this task