Skip to content

[positioning] Record the demo GIF and place it above the fold #71

@SUaDtL

Description

@SUaDtL

Source: positioning review (upheld under challenge — highest-leverage missing asset, pure execution).

Problem: The README's whole "friction is the feature" credibility play is asserted in prose with no motion proof. README.md:18-19 still carries the commented-out DEMO TODO; docs/demo.gif does not exist.

It's ready to shoot: docs/demo-script.md is a complete 186-line shot list ending at the exact BLOCK -> resolve -> green beat, prescribing terminalizer with a point-and-click fallback. Follow the existing spec.

Do: record per the spec, drop docs/demo.gif, uncomment the README embed. Add an honest "dogfooded: codeArbiter builds itself through its own gates" line as founding proof until real users exist.

Effort: M (execution only, no design debate).

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationmarket-evalFrom the 2026-06 multi-agent market-readiness evaluation

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions