Development
Plugin
sopify
Resumable AI coding — ask first, plans stay with the repo AI coding tools are fast. But when they jump to code before the facts are clear, speed turns into rework.
Plugin Signal70/100Solid
maintained90
capable50
documented75
adopted55
Install
$ npx -y skills add evidentloop/sopify --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
What's inside
Skills
10/analyzeAnalyze phase entry. Aggregates scoring, follow-up, and scope-check rules; loads references/assets/scripts on demand./designDesign phase entry. Aggregates plan-level selection, task breakdown, and package output rules; loads references/assets/scripts on demand./developDevelop phase entry; routes task execution, state updates, KB sync, and plan close-out through references/assets/scripts./kbManage long-lived `.sopify/` knowledge, including bootstrap, progressive materialization, reads, retention, and knowledge_sync policy./templatesKnowledge-base document templates, loaded when long-lived knowledge files are created or materialized./analyze需求分析阶段入口；聚合评分、追问与范围判定规则，按需加载 references/assets/scripts。
README
1Sopify
Resumable AI coding — ask first, plans stay with the repo
English · 简体中文 · Quick Start · Contributors
AI coding tools are fast. But when they jump to code before the facts are clear, speed turns into rework. Sopify is a development process protocol layer for AI coding: in managed workflows, the host asks before coding when requirements are incomplete or a decision still needs you.
Sopify stores plans and verification receipts in .sopify/ as project files tracked by git. Only the local resume pointers stay out of git. In the same repo, explicitly ask to continue or use ~go to resume managed work from those files on any supported host.
No new editor, no new CLI. Install into the host you already use — Codex, Claude, Qoder, or Copilot.
Design principles:
- Stop when unsure — score every requirement; ask before assuming
- Resume from anywhere — plans and verification receipts are tracked in
.sopify/; open the repo on any host and pick up where you left off - Trace every decision — plans, choices, and reviews persist in
.sopify/
What Sopify prevents:
- Premature coding — AI starts changing code before missing facts or decisions are resolved
- Lost context — switching hosts, machines, or teammates forces the work to be re-explained
- Forgotten decisions — important tradeoffs disappear into chat history instead of becoming project artifacts
See the workflow diagram, checkpoints, and resume flow →
See It In Action
Quick Start
curl -fsSL https://github.com/evidentloop/sopify/releases/latest/download/install.sh | bash -s -- --target codex:en-US
Sopify requires Python 3.11 or newer; the installer checks before downloading. This command installs Sopify only.
Optional: append --with-evidentloop to the same command to install EvidentLoop; see
Installation.
After install, use ~go to start a managed workflow. See Installation for other hosts, Windows, and how to review the installer before running it.
Already in a Sopify-managed repo? Explicitly ask to continue or use ~go to resume the current plan. Ordinary questions and small fixes are handled directly without automatically entering the previous plan workflow.
Why Sopify?
When requirements are unclear, it stops to plan first.
You say "add a caching layer." Sopify doesn't start coding — it plans first: analyze, design, split into tasks, then save to .sopify/plan/. Only after you confirm the plan does it write code. Every line changed traces back to a decision.
Your teammate picks up where you left off.
You start a feature in Codex, finish the design, and implement two of four tasks. Next week your teammate opens the same repo in Claude, types ~go. Sopify reads the checkpoint and continues from task 3 — no handoff doc, no re-explaining context.
Every decision leaves a trace.
A month later, someone asks why the cache key includes the user ID. The answer is in .sopify/plan/ — the requirement that prompted the decision, the design that resolved it, the review that approved it.
Product Form
The host LLM executes. Sopify supplies shared workflow rules and preserves plans, decisions, and verification evidence as project files in .sopify/. Local resume pointers remain on the machine.
Sopify does three things:
- Shared workflow rules — supported hosts load the same Sopify workflow rules, so switching hosts does not change the process and boundaries you already confirmed
- Git-tracked project record — plans, decisions, and verification evidence travel with the repository; local pointers do not
- Explicit resume and closeout — ask to continue or use
~gobefore the host resumes;~go finalizearchives the plan only after delivery evidence is ready
Architecture Details
For readers who want the internal layering behind the product form, the technical structure is below.
Installation
Review before running:
curl -fsSL -o sopify-install.sh https://github.com/evidentloop/sopify/releases/latest/download/install.sh
less sopify-install.sh # review before running
bash sopify-install.sh --target codex:en-US
Windows PowerShell:
iwr https://github.com/evidentloop/sopify/releases/latest/download/install.ps1 -OutFile sopify-install.ps1
Get-Content sopify-install.ps1 | more
.\sopify-install.ps1 --target codex:en-US
Host support:
| Host | Tier | Target | Notes |
|---|---|---|---|
| Codex | PROTOCOL_VERIFIED | codex:en-US / codex:zh-CN | Full capability continuation |
| Claude | PROTOCOL_VERIFIED | claude:en-US / claude:zh-CN | Full capability continuation |
| Qoder | PROTOCOL_VERIFIED | qoder | Validated on Qoder CLI |
| Copilot | BASELINE_SUPPORTED | copilot:en-US / copilot:zh-CN | Prompt-only; payload uplift planned |
Pass --workspace <path> to target another repo, --language <lang> to control output language.
EvidentLoop is an optional code-change audit
tool. It turns a local Git diff into an interactive report, ties audit findings to changed
lines, and lets users update the report through feedback. To install the current official
CLI and Skill with Sopify, or reuse healthy existing components, pass
--with-evidentloop explicitly:
bash sopify-install.sh --target codex:en-US --with-evidentloop
Healthy existing components are reused without automatic upgrades. The Copilot Skill is project-scoped; Sopify does not commit or update it. See Getting Started for prerequisites, host-specific paths, and the local/cloud boundary.
For the full setup guide, see Getting Started. For a step-by-step demo, see External Repo Quickstart.
Command Reference
| Command | Description |
|---|---|
~go | Automatically route and run the full workflow (auto-resumes if active plan exists) |
~go plan | Plan only |
~go finalize | Close out the active plan |
Most users only need ~go and ~go plan; maintainer validation commands live in CONTRIBUTING.md.
Configuration
cp examples/sopify.config.yaml ./sopify.config.yaml
brand: auto
language: en-US
workflow:
mode: adaptive # strict | adaptive | minimal
require_score: 7
Directory Structure
sopify/
├── scripts/ # install, diagnostics, and maintainer scripts
├── examples/ # configuration examples
├── docs/ # workflow guides and developer references
├── sopify_writer/ # protocol asset writer library
├── sopify_contracts/ # schema definitions and shared data structures
├── skills/ # prompt-layer source of truth
├── installer/ # host adapters and install orchestration
└── .sopify/ # project protocol root
├── blueprint/ # protocol spec, design baseline, reduction targets
├── plan/ # active plans + receipts
└── history/ # archived plans + receipts
See How Sopify Works for the full workflow, checkpoints, and knowledge layout.
Version History
- See CHANGELOG.md for the detailed history
License
- Code and config: Apache 2.0, see LICENSE
- Documentation: CC BY 4.0, see LICENSE-docs
Contributing
For user-visible behavior changes, update both README.md and README.zh-CN.md when needed, then follow CONTRIBUTING.md for validation.
File tree
437evidentloop/sopifyView on GitHub
.githooks/
commit-msg
pre-commit
.github/
ISSUE_TEMPLATE/
bug_report.md
feature_request.md
workflows/
ci.yml
.gitignore
.nojekyll
.sopify/
blueprint/
architecture-decision-records/
ADR-013.md
ADR-016.md
ADR-017.md
README.md
background.md
design.md
protocol.md
README.md
skill-standards-refactor.md
tasks.md
history/
2026-03/
20260317_design_decision_confirmation/
background.md
design.md
tasks.md
20260320_helloagents_integration_enhancements/
background.md
design.md
future_directions.md
tasks.md
20260320_kb_layout_v2/
background.md
design.md
tasks.md
20260320_preferences-preload-v1/
background.md
design.md
tasks.md
20260320_prompt_runtime_gate/
background.md
design.md
tasks.md
20260321_go-plan/
background.md
design.md
evidence_archive_notice.md
issue_meta_review_no_new_plan.md
issue_raise_plan_reuse_fix_to_8_5.md
issue_single_active_plan_reuse_with_topic_key.md
pilot_review_rubric.md
pilot_round1_review_sheet.md
pilot_sample_matrix.md
tasks.md
trigger_matrix.md
20260323_models-tests-refactor/
background.md
design.md
tasks.md
20260323_plan_registry_governance/
background.md
design.md
tasks.md
20260323_readme-about-changelog/
background.md
design.md
tasks.md
20260323_runtime-gate-diagnostics/
background.md
design.md
tasks.md
20260323_runtime-session-lease-session-scoped-review-stat/
background.md
design.md
tasks.md
20260324_develop-quality-loop/
background.md
design.md
tasks.md
20260324_task/
background.md
design.md
tasks.md
20260325_one-liner-distribution/
background.md
design.md
tasks.md
20260326_5-plan-20260326-phase1-2-3-plan-plan-20260326-ph/
background.md
design.md
tasks.md
20260326_phase1-2-3-plan/
background.md
design.md
tasks.md
20260326_planning-materialization-decoupling/
background.md
design.md
tasks.md
20260327_hotfix/
background.md
design.md
tasks.md
2026-04/
20260403_plan-a-risk-adaptive-interruption/
background.md
critical-reference-notes.md
design.md
machine-contract-overview.md
tasks.md
20260413_trae_host_adapter/
background.md
design.md
tasks.md
20260417_ux_perception_tuning/
background.md
design.md
tasks.md
20260429_host_prompt_governance/
design.md
tasks.md
20260429_standard-archive-finalize-archive-checkpoint/
background.md
design.md
tasks.md
2026-05/
20260428_action_proposal_boundary/
design.md
tasks.md
20260429_legacy_feature_cleanup/
design.md
tasks.md
20260501_blueprint-truth-cutover/
background.md
design.md
tasks.md
20260501_convention_smoke/
host_b_instructions.md
plan.md
receipt.md
20260504_subject_identity_binding/
design.md
plan.md
tasks.md
20260505_p15_advance_slices/
background.md
design.md
receipt.md
tasks.md
20260505_p15_plan_materialization_auth/
background.md
design.md
receipt.md
tasks.md
20260506_p15_authorization_contract_spec/
background.md
design.md
receipt.md
tasks.md
20260506_p15_reject_surface/
background.md
design.md
receipt.md
tasks.md
20260506_p15_verifier_normative_slice/
background.md
design.md
receipt.md
tasks.md
20260506_p2_local_action_contracts/
background.md
design.md
receipt.md
tasks.md
20260507_p3a_contract_aligned_surface_cleanup/
background.md
design.md
tasks.md
20260508_p3b_perimeter_cleanup/
background.md
design.md
tasks.md
20260509_host_capability_governance/
background.md
design.md
tasks.md
20260509_p4a_external_surface_freeze/
background.md
design.md
tasks.md
20260509_p4b_runtime_surface_consolidation/
background.md
design.md
tasks.md
20260510_p4b5_runtime_optionality_audit/
background.md
design.md
tasks.md
20260510_p4c_host_consumption_governance/
background.md
design.md
tasks.md
20260519_p4d_copilot_cli_pilot/
background.md
design.md
receipt.md
tasks.md
20260520_p5_contract_surface_shrinkage/
background.md
design.md
provisional_adjudication.md
receipt.md
shadow_writer_analysis.md
surface_inventory.md
tasks.md
20260520_p6_canonical_writer_cutover/
background.md
design.md
receipt.md
tasks.md
writer_input_contract.md
20260522_p7_payload_only_onboarding_mainline/
background.md
copilot_instruction_spike.md
design.md
receipt.md
tasks.md
20260522_runtime_slimming_kernel_extraction/
background.md
design.md
kernel-architecture.svg
receipt.md
tasks.md
20260526_pre_launch_host_and_bundle_unification/
background.md
design.md
golden-snapshots.json
tasks.md
20260527_skill_writing_quality/
background.md
design.md
tasks.md
20260528_output_contract_enforcement/
background.md
design.md
tasks.md
2026-06/
20260529_pre_launch_consolidation/
background.md
design.md
direction-dependencies.svg
receipt.md
sopify-architecture-simplified.svg
tasks.md
20260605_p8_protocol_kernel_runtime_retirement/
assets/
cross-host-continuation.svg
host-prompt-protocol-entry.md
registry-lifecycle-snapshot.md
state-and-host-flow.svg
w33-proof-transcript.md
design.md
plan.md
receipt.md
receipts/
final.json
tasks.md
2026-07/
20260626_mcp_tool_plane_pilot/
background.md
design.md
plan.md
receipt.md
receipts/
final.json
verify_001.json
verify_002.json
tasks.md
20260717_sopify_entry_preflight/
assets/
entry-preflight-flow.svg
background.md
design.md
plan.md
receipt.md
receipts/
exec_001.json
exec_002.json
final.json
verify_001.json
verify_002.json
verify_003.json
verify_004.json
verify_005.json
verify_006.json
tasks.md
20260718_evidentloop_optional_audit_integration/
audits/
plan/
audit.html
audit.json
design.md
plan.md
receipt.md
receipts/
final.json
verify_001.json
tasks.md
20260720_plain_language_output/
audits/
plan/
audit.html
audit.json
plan.md
receipt.md
receipts/
final.json
verify_001.json
tasks.md
index.md
project.md
sopify.json
user/
feedback.jsonl
preferences.md
assets/
demo-en.svg
logo.svg
readme-visuals/
sopify-scene-ask-en.jpg
sopify-scene-ask.jpg
sopify-scene-cross-host-en.jpg
sopify-scene-cross-host.jpg
sopify-scene-decision-en.jpg
sopify-scene-decision.jpg
sopify-architecture.svg
sopify-cover-cn.jpg
sopify-cover.jpg
sopify-harness-cn.png
sopify-harness.png
sopify-og-en.jpg
sopify-og-zh-CN.jpg
sopify-plan-lifecycle-cn.png
sopify-plan-lifecycle.png
sopify-product-form-release-en.svg
sopify-product-form-release.svg
sopify-site.css
sopify-site.js
sopify-workflow-cn.svg
sopify-workflow.svg
bootstrap.sh
CHANGELOG.md
CONTRIBUTING_CN.md
CONTRIBUTING.md
CONTRIBUTORS.md
docs/
dev/
development-guidelines.md
release-process.md
getting-started.md
how-sopify-works.en.md
how-sopify-works.md
examples/
external-repo-quickstart/
README.md
sopify.json.example
sopify.config.yaml
index.html
install.ps1
install.sh
installer/
__init__.py
bootstrap_workspace.py
distribution.py
evidentloop.py
hosts/
__init__.py
base.py
claude.py
codex.py
copilot.py
qoder.py
inspection.py
models.py
outcome_contract.py
payload.py
sopify_bundle.py
validate.py
LICENSE
LICENSE-docs
README.md
README.zh-CN.md
scripts/
_yaml_subset.py
check-enhancement-declaration.py
check-install-payload-bundle-smoke.py
... 200 moreFAQ
sopify is a Claude Code plugin with 10 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes analyze, design, develop. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is sopify?
- Resumable AI coding — ask first, plans stay with the repo AI coding tools are fast. But when they jump to code before the facts are clear, speed turns into rework.
- How do I install sopify?
- Run these in Claude Code: npx -y skills add evidentloop/sopify --agent claude-code. Then prompt normally.
- Does sopify auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is sopify free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.