Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 10 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,12 +45,20 @@ No new editor, no new CLI. Install into the host you already use — Codex, Clau

[See the workflow diagram, checkpoints, and resume flow →](./docs/how-sopify-works.en.md)

## See It In Action
## Sopify in a Real Codex Workflow

This archived workflow shows Sopify running inside Codex, not a scripted terminal demo. A complex request became a tracked plan; an audit concern triggered a decision checkpoint; after the user approved a minimal fix, the verification evidence was recorded and the plan was archived.

<p align="center">
<img src="./assets/demo-en.svg" alt="Sopify demo — Analysis on Claude Code, then resume on Codex CLI" width="900" />
<img src="./assets/readme-visuals/codex-dogfood.gif" alt="Sopify in a real Codex workflow: a request becomes a plan, an audit concern stops for the user's decision, and the minimal fix and verification evidence are recorded before archive" width="900" />
</p>

- **Plan first** — Codex did not start coding immediately; it first captured the goal, boundaries, and verification steps in a tracked plan.
- **Stop for a decision** — the first audit found one concern; work paused for the user, then only a minimal identity check was added.
- **Close with evidence** — the second audit found no open risk; 5 protocol checks and 55 targeted tests with 48 subtests were recorded before archive.

The real task was an optional verifier integration. The animation explains how Sopify managed it; the archived files show what happened: [plan](./.sopify/history/2026-07/20260718_evidentloop_optional_audit_integration/plan.md) · [verification receipt](./.sopify/history/2026-07/20260718_evidentloop_optional_audit_integration/receipts/verify_001.json) · [final receipt](./.sopify/history/2026-07/20260718_evidentloop_optional_audit_integration/receipts/final.json).

## Quick Start

```bash
Expand Down
12 changes: 10 additions & 2 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,12 +45,20 @@ Sopify 把方案和验证收据保存在 `.sopify/` 中,作为可纳入 git

[查看工作流图、checkpoint 与恢复流程 →](./docs/how-sopify-works.md)

## 实战演示
## Sopify 在真实 Codex 任务中如何运行

下面展示的是 Sopify 在一次真实 Codex 任务中的运行过程,不是编排好的终端演示。复杂需求先沉淀为方案;审计发现问题时流程停车;用户裁定后再做最小修正,并把验证结果写入收据后归档。

<p align="center">
<img src="./assets/demo-en.svg" alt="Sopify 演示 — 在 Claude Code 分析设计,然后在 Codex CLI 恢复开发" width="900" />
<img src="./assets/readme-visuals/codex-dogfood.gif" alt="Sopify 在真实 Codex 任务中的运行过程:需求形成方案,审计发现问题后等待用户裁定,最小修正和验证证据写入收据后再归档" width="900" />
</p>

- **先形成方案** — Codex 没有直接改代码,而是先把目标、边界和验证步骤写入可追踪方案。
- **发现问题就停车** — 首次审计发现一项风险;流程等待用户裁定,随后只补最薄的身份校验。
- **有证据再收口** — 复审确认没有开放风险;最终收据记录 5 项协议检查、55 项定向测试和 48 项子测试,随后才归档。

真实任务是一次可选验证器接入。动效解释 Sopify 如何管理这项工作,归档文件记录实际过程:[方案](./.sopify/history/2026-07/20260718_evidentloop_optional_audit_integration/plan.md) · [验证收据](./.sopify/history/2026-07/20260718_evidentloop_optional_audit_integration/receipts/verify_001.json) · [最终收据](./.sopify/history/2026-07/20260718_evidentloop_optional_audit_integration/receipts/final.json)。

## 快速开始

```bash
Expand Down
170 changes: 0 additions & 170 deletions assets/demo-en.svg

This file was deleted.

Binary file added assets/readme-visuals/codex-dogfood.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading