Plan

The phased implementation plan for the repo.

Design Reference · /home/jonas/social-carousel-codex/docs/plan.md

Last modified: 2026-03-29T09:14:42.440Z

# Phased Plan

## Scope Guardrails

- Keep the existing OpenClaw system live and untouched.
- Reuse only the patterns that still make sense.
- Prefer one main Codex workflow with explicit file state.
- Do not implement Slack until an approved later phase.

## Phase 1: Environment Setup And Audit

Status: complete on 2026-03-29

- inspect the relevant OpenClaw workspace, app, and Caddy patterns
- choose an isolated Codex-owned project path
- initialize a clean Git repository
- create planning, audit, and handoff docs
- scaffold placeholder app, state, artifact, and bootstrap structure

## Phase 2: Workflow Audit And Codex-Native Design

Status: complete on 2026-03-29

Goal: reconstruct the real OpenClaw carousel workflow and translate it into a simpler Codex-native design

- inspect the OpenClaw workflow artifacts, helper scripts, and preview app
- document the actual current stages, approvals, state transitions, and failure points
- decide what to preserve, remove, and migrate
- define the one-thread Codex-native workflow, state model, and app migration approach

## Phase 3: Local Runtime Skeleton

Status: complete on 2026-03-29

Goal: prove the core repo-local control plane and preview migration path without touching the live system

- implement atomic helper-backed ledger, checkpoint, log, and DLQ behavior
- scaffold `apps/carousel-web/` with the frozen `fact` contract and separate preview routes
- persist preview artifacts under `artifacts/previews/`
- add a deterministic fixture-driven dry run for intake through preview verification
- keep reruns restart-safe and side-by-side with the live app

## Phase 4: Workflow Hardening

Goal: make the workflow reliable enough for real use

- implement QC and revision classification rules from the workflow spec
- add explicit replay, rollback, and bounded retry handling around material revisions
- tighten preview verification beyond artifact-write checks
- document operator recovery procedures and side-by-side smoke tests

## Phase 5: Skill Layer

Status: complete on 2026-03-29

Goal: encode the business workflow as a repo-local Codex skill without replacing deterministic scripts

- add the main `carousel-workflow` skill
- add the supporting `carousel-literature-review` skill
- keep repo-local state, scripts, and the preview app as the execution layer

## Phase 6: Deterministic Workflow Helpers

Status: complete on 2026-03-29

Goal: replace manual stage transitions with explicit helper commands

- add helper-backed intake, angle, research, draft, revision, QC, preview-binding, and final-approval commands
- keep checkpoints, logs, and restart safety explicit
- align the skill layer with the real helper surface

## Phase 7: Research Wrapper And Verification Refresh

Status: complete on 2026-03-29

Goal: close the remaining adapter and verification gaps

- add a repo-local wrapper around the OpenClaw literature-review search capability
- strengthen preview verification with bounded HTTP checks
- rewrite the dry run around the real helper flow and include a blocked QC path

## Phase 8: Optional Integrations

Goal: add only the integrations still justified after the Codex-native path is stable

- evaluate whether Slack is still needed
- evaluate whether Airtable or other systems stay in scope
- wire integrations only after the local deterministic workflow is proven

Ready