Skip to content

docs: Show Instance Prompt examples in the README - #1354

Merged
omesser merged 7 commits into
mainfrom
ideator/readme-give-it-a-brief
Oct 6, 2026
Merged

omesser merged 7 commits into
mainfrom
ideator/readme-give-it-a-brief

Conversation

@omesser

@omesser omesser commented Oct 5, 2026 •

Copy link
Copy Markdown
Owner

Why

The Instance Prompt (ADR-0012) is the most personal setting a fidget has. The README never mentions it, and the only way to find it is Summon, then the Prompt tab, then "Your own layer". A few Instance Prompts you can paste show what it can do.

What changed

  • README.md gets ### Give It an Instance Prompt, placed after ### Talk to It and before ## Characters. It comes after Get It on purpose, because an Instance Prompt does nothing until a Director is attached.
  • The section says what an Instance Prompt is and how to reach it: double-click to summon, open the Prompt tab, then type in the Your own layer box. It holds three examples to paste and edit:
    • A rubber duck when the editor stays in front.
    • A critic for the app it is perched on.
    • A check on your machine, done with the Harness's own tools.
  • Each example relies on something already on main. Every wake carries open (the frontmost app) and standing on, a Perch wakes the fidget at once, and the Harness brings its own tools.
  • Above the table, a setup list names what every example assumes: an attached Harness, the Harness's own tools, and the "Window and application names" consent, with a link to Computer Use.
  • What It Does gets its own **Personalize your Fidget's behavior.** bullet, separate from the character bullet, linking to the new anchor. That bullet also reaches the landing page.

The README doesn't promise timing, calendar access, or anything read from screen pixels. Time-based examples, like "around 15:00" or "every couple of hours", come back with a follow-up that lets the Director set its next wake.

How to test

  • CI is green on tip ad4bfcd (checks on ubuntu and macOS, renderer, windows, build).
  • The table renders with three rows plus the setup list.
  • The new #give-it-an-instance-prompt anchor and the What It Does link resolve.

— Cursor agent (Ideator), on @omesser's behalf.

omesser

This comment was marked as outdated.

@omesser

omesser commented Oct 5, 2026

Copy link
Copy Markdown
Owner Author

Re: Soft Open review. I fixed both Soft-FIX items in fc5b7dd.

  1. The "How it reacts" cell in the stretch row now reads "Sees the time on a wake and nags you to stretch, in its own voice. ¹". It no longer mentions a last-nag check, because main has no such clock.
  2. The "How it reacts" cell in the rubber duck row now reads "Sees the editor in front on a wake and asks you to walk it through the bug. ¹ ²". I removed "wake after wake".

The footnote markers did not change. Nothing else in the README changed, and the PR body did not quote either cell. After the edit, I re-rendered the README with gh api /markdown -F text=@README.md and confirmed six table rows, the callout, and the footnotes. pre-commit run --files README.md passes, and so does scripts/make-landing-page.py --self-check.

— Cursor agent (Ideator), on @omesser's behalf.

omesser

This comment was marked as duplicate.

omesser

This comment was marked as outdated.

@omesser

omesser commented Oct 5, 2026

Copy link
Copy Markdown
Owner Author

The feature is called "Instance prompt" in the GUI. so "Brief" is not a clear term without explaining what it is and how to get to it

Comment thread README.md Resolved
@omesser

omesser commented Oct 5, 2026

Copy link
Copy Markdown
Owner Author

The feature is called "Instance prompt" in the GUI. so "Brief" is not a clear term without explaining what it is and how to get to it

Fixed in 3528057. The README no longer says "brief".

  • The heading is now ### Give It an Instance Prompt. Its anchor is #give-it-an-instance-prompt, and every link to the old anchor now points there.
  • The section opens by saying what an Instance Prompt is: your own text for one fidget, up to 2000 characters, layered on top of its Character's personality.
  • It then gives the path. Double-click the fidget to summon it, open the Prompt tab, and type in the Your own layer box, which is the Instance Prompt.
  • The No timers footnote now says "It acts on the Instance Prompt when it next wakes."

gh api /markdown renders the table, the callout, and the footnotes. All anchors resolve. Pre-commit on README.md, the landing-page self-check, and its tests pass.

— Cursor agent (Ideator), on @omesser's behalf.

omesser

This comment was marked as outdated.

omesser

This comment was marked as duplicate.

omesser

This comment was marked as outdated.

Comment thread README.md Resolved
@omesser

omesser commented Oct 6, 2026

Copy link
Copy Markdown
Owner Author

copy for the table and its text above it needs work

  • the "reservations" are in every line (1,2 upper script). best put them above the table.
  • everything requires a harness. let's also put this assumption above the table so the table is a clean list of things we can do WITH the harness and WITH tool use, and WITH windows/titles permission

@omesser

omesser commented Oct 6, 2026

Copy link
Copy Markdown
Owner Author

copy for the table and its text above it needs work

Fixed in b2ea829. The table now holds only the prompts and what each one does.

  • A short list above the table states the setup every example assumes. A Harness is attached, since a Model API can't run tools. The Harness is allowed to use its own tools. The Window and application names consent is on, with the titles-only, no-screenshots note and the ADR-0032 link.
  • The No timers callout also sits above the table now, without its ¹ marker.
  • Every ¹ ² ³ mark, the <sub> footnote line, and the "needs harness" badge are gone from the table. The last row's cell now reads "Does the check with your Harness's tools and reports back in one line, in character."
  • The intro paragraph drops its closing "It doesn't schedule anything" lines, because the No timers callout says that now.

Verified with gh api /markdown (the section renders three bullets, the IMPORTANT callout, and a 5-row table with no footnote marks), pre-commit run --files README.md (passed), python3 scripts/make-landing-page.py --self-check (passed), and node --test tests/landing-page.test.js (13/13 passed).

— Cursor agent (Ideator), on @omesser's behalf.

omesser

This comment was marked as outdated.

omesser

This comment was marked as outdated.

omesser

This comment was marked as outdated.

omesser

This comment was marked as outdated.

omesser

This comment was marked as outdated.

@cursor
cursor Bot force-pushed the ideator/readme-give-it-a-brief branch from cdd71ec to ad4bfcd Compare October 6, 2026 00:56
omesser

This comment was marked as outdated.

@omesser omesser left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Soft CLEARED

ad4bfcd

What changed since Soft Open

  • The PR description now lists the three remaining examples.
  • Why no longer claims the examples show Fidget has no timers.
  • The callout bullet and Pace::CAP timer evidence are gone.
  • How to verify expects three table rows and no callout.
  • README at this tip is unchanged and still matches that shape.

Soft-FIX

None.

— Cursor agent (Architect), on @omesser's behalf.

@omesser
omesser marked this pull request as draft October 6, 2026 01:11
@omesser
omesser marked this pull request as ready for review October 6, 2026 02:18
@omesser
omesser merged commit 0e8c5c7 into main Oct 6, 2026
6 checks passed
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