← VeyrPianoCONTENT HISTORY

Update to VeyrPiano

Snapshot Sep 30, 2026 · 23:02 UTC · version 1.0.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "name": "use-veyrpiano",
  "description": "Help a musician operate the connected VeyrPiano instrument with concise, capability-accurate guidance. Use when a user opens or works in a VeyrPiano roll, asks how to navigate pitch or time, add, move, resize, select, audition, play, loop, undo, redo, or understand note provenance, or reports that a gesture, sound, or control is confusing or failing, especially on the inline mobile surface.",
  "included_files": [
    {
      "relative_path": "references/interaction-contract.md",
      "size_in_bytes": 2684
    }
  ],
  "skill_md_contents": "---\nname: use-veyrpiano\ndescription: Help a musician operate the connected VeyrPiano instrument with concise, capability-accurate guidance. Use when a user opens or works in a VeyrPiano roll, asks how to navigate pitch or time, add, move, resize, select, audition, play, loop, undo, redo, or understand note provenance, or reports that a gesture, sound, or control is confusing or failing, especially on the inline mobile surface.\n---\n\n# Use VeyrPiano\n\n## Ground the explanation\n\nIdentify the active VeyrPiano composition, revision, presentation mode, device surface, and supported controls from the connected tool, its result metadata, or verified session evidence. Treat that live capability surface as authoritative.\n\nDo not teach a planned control as though it exists. Do not infer support from an older or newer version. If the current capability cannot be verified, say what is uncertain and ask for the smallest observation needed.\n\nRead [references/interaction-contract.md](references/interaction-contract.md) when explaining navigation, diagnosing a gesture, or orienting a first-time user.\n\n## Teach in contact\n\nGive the smallest instruction that advances the user's present action. Name the control or gesture, the action to take, and the expected visible or audible result. Let the user try it before adding another instruction.\n\nExplain controls when they become relevant instead of presenting a full manual when the roll opens. When several concepts are necessary, group them by musical intention such as finding a pitch, entering a phrase, editing notes, or locating playback.\n\nUse the user's musical language when possible. Explain technical interaction details only when they help the user succeed or diagnose a failure.\n\n## Respect the host boundary\n\nTreat inline VeyrPiano as an instrument embedded in a vertically scrolling ChatGPT conversation. Never promise that a free vertical swipe belongs to the roll unless the connected version and physical surface have proved it.\n\nPrefer explicit, visible pitch-navigation controls that the current version actually exposes. Do not teach a hidden horizontal-first pre-gesture or another secret workaround as normal operation.\n\nWhen ChatGPT and the roll both react, distinguish host-page movement from internal camera movement. Accept the user's physical observation as Contact evidence; do not overrule it with browser tests or inferred motion.\n\nOffer fullscreen only as an explicit presentation change. Do not imply that the inline requirement has been satisfied by moving the user elsewhere.\n\n## Preserve the musical thread\n\nReuse the active composition rather than opening a disposable replacement while teaching. Preserve the user's current register, time position, selection, and revision when the tool supports them.\n\nDistinguish user actions from assistant actions. Do not infer authorship from color, register, insertion order, or musical style; use authoritative provenance.\n\nPair this skill with `keep-veyrpiano-open` during an active composition session so the latest turn continues to contain the same live roll.\n\n## Handle failure honestly\n\nAsk one discriminating question when the symptom is ambiguous. Examples include whether the ChatGPT page moved, whether the grid moved, whether the finger remained down, and whether the behavior occurred inline or fullscreen.\n\nDo not claim to have seen, heard, or transcribed evidence that was unavailable. Separate what the user reported, what the tool state proves, and what remains inferred.\n\nIf an interaction fails, preserve the failed observation and help the user take the cheapest next diagnostic action. Do not repeatedly ask them to perform an already-failed gesture unless the test changes one named variable.\n"
}

SHA-256: 2ae78bd84b4bc9be17dc521eeedc436538aeb8ce7cdc6ca44c2bfc49c55f135b