docs(D1): rewrite README pair for pre-launch#50
Merged
Conversation
Standard-level plan for pre-launch consolidation covering 7 directions: - D2: Output enhancement system (rule-driven, not template piling) - D3: Command surface convergence (~go exec removal) - D5: Engineering audit fixes (17 items, 4 blocking) - D1: README rewrite + visual asset upgrade - D4: First-touch UX optimization - D6: Promotional content matrix - D7: Runtime Phase 2 shrink (design only) Wave strategy: - Wave 1 (D2+D3+D5): Internal cleanup, no README - Wave 2 (D1+D4): README full rewrite + first-touch - Wave 3 (D6): Promotional content - Wave 4 (D7): Runtime design only Includes 2 SVG architecture diagrams and competitive analysis.
- .gitignore: add .env, .venv/, dist/, build/, .claude/settings.local.json, .agents/history/, reports/ - git rm --cached .claude/settings.local.json (untrack local config) - bootstrap_workspace.py: remove ~summary residual regex from blocked patterns - bootstrap.sh: remove dead init parameter handling
Remove ~go exec as a user-facing command. Bare ~go now auto-detects active plans and routes to exec_plan internally. Typing the old ~go exec command returns a migration hint instead of silently entering a workflow with body 'exec'. Key changes: - router.py: remove ~go exec pattern, add snapshot-based active plan detection on bare ~go, add ~go finalize explicit route, add ~go exec migration hint - entry_guard.py: empty bypass blocked commands (no more ~go exec) - output.py: update exec_handoff / next_exec messages (zh-CN + en-US) - clarification.py: update bodyless command set - develop SKILL.md: activation condition reflects ~go auto-routing - header templates / README / blueprint: remove ~go exec from docs - 658 tests pass, including new migration hint test Context-Checkpoint: B
- docs: remove ghost path .github/instructions/sopify.instructions.md (actual install target is .github/copilot-instructions.md) - install.sh: add python3 → python → py -3 fallback chain (align with install.ps1) - tests: delete ~compare dead tests (command removed, 656 tests pass) - tasks.md: mark 3.11/3.12/3.15 done, skip 3.14 (script exists)
- Rewrite both EN and zh-CN READMEs (tagline, stories, install) - Add animated SVG demo (Claude Code + Codex CLI scenes) - Redesign architecture SVG (3 real hosts + skill workflow layer) - Generate new EN/CN cover images (notebook metaphor) - Add 3 scene images for zh-CN stories - Remove logo from README headers, shrink cover to 660px - Remove obsolete sopify-architecture-cn.jpg - Polish language: 13 micro-edits from independent review - Update header.md.template copyright lines
Release-Sync: yes Release-Version: 2026-05-30.193318 Release-Date: 2026-05-30
…26-05-30.193318 The previous regen commit (7ed1cc5) bumped templates but the snapshot file in that commit retained the old hashes, causing CI to fail. This commits the actually-regenerated hashes.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Rewrites both README.md and README.zh-CN.md for external-facing pre-launch quality.
Key changes
Assets added/replaced
assets/demo-en.svgassets/sopify-architecture.svgassets/sopify-cover-cn.jpgassets/readme-visuals/sopify-scene-ask.jpgassets/readme-visuals/sopify-scene-cross-host.jpgassets/readme-visuals/sopify-scene-decision.jpgNot included (follow-up)
sopify-architecture-cn.jpg,logo.svgreferenceCommits in this PR