Skip to content

docs(s16): March-feel ideal chapter + maintainer readability standard - #514

Draft
CrazyBoyM wants to merge 11 commits into
mainfrom
cursor/s16-workflow-runtime-rewrite-06d4
Draft

docs(s16): March-feel ideal chapter + maintainer readability standard#514
CrazyBoyM wants to merge 11 commits into
mainfrom
cursor/s16-workflow-runtime-rewrite-06d4

Conversation

@CrazyBoyM

@CrazyBoyM CrazyBoyM commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Ideal v19 demo rewrite of s16_workflow_runtime (EN/中文/日本語) following the maintainer readability / March-feel standard.

按维护者文档的 ideal v19 示范章:把 s16 拉回「短讲义卡片」节奏(问题 → ASCII/图 → 最小代码 → 试一试),深度进 <details>;并新增 docs/maintainers/MARCH_FEEL_AND_READABILITY.md 作为文风权威约束。

Files

  • s16_workflow_runtime/README.md / README.zh.md / README.ja.md
  • docs/maintainers/MARCH_FEEL_AND_READABILITY.md (new)

Notes

  • Draft kept.
  • Other chapters untouched.
  • ZH (README.zh.md) rewritten for natural spoken Chinese (v20).

Retell the Runtime lesson as a progressive story (two doors, kitchen
primitives, null-isolation, longest-prefix resume) in EN/ZH/JA, and align
the mini-runtime with Claude Code / Pi semantics so the docs and code agree.

Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 12, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
❌ Deployment failed
View logs
learn-claude-code c9e1803 Aug 12 2026, 07:33 PM

cursoragent and others added 4 commits August 12, 2026 13:47
Ground the progressive chapter in why custom harnesses exist, the three
single-window failure modes, dynamic vs static, tasteful patterns, when
not to use workflows, and sharp neighbors (s06/s13/s15/s17).

Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Rewrite EN/ZH/JA for tea-conversation cadence: soft transitions, insight
before jargon, fewer checklist piles — same design spine, warmer prose.

Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Introduce Classify-And-Act through Loop Until Done after primitives,
map each onto agent/parallel/pipeline, show review-changes as a
fanout+verify composition, and add a matching six-panel SVG.

Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Full rewrite of EN/ZH/JA as a progressive essay with harness-essay spine,
six-pattern toolbox, neighbor comparisons, and SVG-first figures
(dynamic-vs-static, primitives, six patterns). Keep null-isolation and
longest-prefix resume in the teaching runtime; bump translation-sync to v15.

Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
@cursor cursor Bot changed the title Rewrite s16 Workflow Runtime: progressive docs + teaching fidelity Rebirth s16 Workflow Runtime from the Agent Writing Brief Aug 12, 2026
cursoragent and others added 4 commits August 12, 2026 13:59
Pull Anthropic essay PNGs (primitives, dynamic-vs-static, six patterns,
quarantine triage) into images/, wire them into EN/ZH/JA with captions,
and add a short untrusted-input beat. Drop substitute SVGs for those four.

Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Add critical-path figures with captions, ASCII topology sketches,
labeled teaching-code vs code.py snippets, and details collapses for
optional depth. Recompress official PNGs; keep essay spine visible.

Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Compress ZH/EN/JA essay into problem → ASCII/figure → minimal code →
try it. Move pattern grid, quarantine, primitives card, and overview
SVG into details; bump translation-sync to v18.

Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
@CrazyBoyM CrazyBoyM changed the title Rebirth s16 Workflow Runtime from the Agent Writing Brief docs(s16): March-feel ideal chapter + maintainer readability standard Aug 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants