Skip to content

docs(readme): restructure around reproducing the demo video - #375

Merged
plind-junior merged 1 commit into
testfrom
docs/readme-video-flow
Jul 6, 2026
Merged

docs(readme): restructure around reproducing the demo video#375
plind-junior merged 1 commit into
testfrom
docs/readme-video-flow

Conversation

@plind-junior

Copy link
Copy Markdown
Member

cuts the readme down to the one path that matters: a new user lands, installs, and ends up with exactly the loop docs/vouch-how-it-works.mp4 shows — capture, gate, approve, compile, recall. removed: 30-second tour, object model, file layout, cli surface, mcp method list, jsonl shape, bundles, neighbour table, openclaw packaging section, stale pre-1.0 status (superseded by SPEC.md, docs/, and --help).

the new 7-step walkthrough was verified command-by-command against the released 1.2.1 artifacts (fresh $HOME, latin-1 locale) earlier today; relative links checked against the tree.

@coderabbitai

coderabbitai Bot commented Jul 6, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: b817e59f-0af0-44fc-9036-fc7e06d22cb9

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/readme-video-flow

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added docs documentation, specs, examples, and repo guidance size: XS less than 50 changed non-doc lines labels Jul 6, 2026
the readme accumulated sections a new user doesn't need on the way to
their first working loop — 30-second tour, object model, file layout,
cli surface, mcp method list, jsonl envelope shape, bundles, neighbour
comparison, openclaw packaging, a stale pre-1.0 status note. all of
that lives in SPEC.md, docs/, or --help output already.

what remains maps one-to-one onto docs/vouch-how-it-works.mp4: install,
wire claude code (init + install-mcp), set compile.llm_cmd, work a
session, approve at the gate (review / review-ui), compile the wiki,
recall in the next session, commit .vouch/. plus the three invariants
underneath and a going-further link list.

every command and claim in the new walkthrough was verified against
the released 1.2.1 artifacts earlier today; all relative links checked
against the tree.
@plind-junior
plind-junior force-pushed the docs/readme-video-flow branch from 1981a06 to 289b2d9 Compare July 6, 2026 05:18
@plind-junior
plind-junior merged commit c5337d3 into test Jul 6, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs documentation, specs, examples, and repo guidance size: XS less than 50 changed non-doc lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant