diff --git a/README.md b/README.md index fbe70e2..f21f06b 100644 --- a/README.md +++ b/README.md @@ -198,7 +198,7 @@ The [complete skills reference](./docs/guide/skills.md) lists all 59 discoverabl | [`/ketchup`](./skills/ketchup/SKILL.md) | Catch up on this chat with real visuals and every waiting user decision, including older waiting items. Do not replace an item list with a count. | | [`/correct`](./skills/correct/SKILL.md) | Fix repeated agent mistakes at the highest enforceable level, with architecture first and documentation last. Pair each rule with its enforcement. | | [`/benchmark-checklist`](./skills/benchmark-checklist/SKILL.md) | Vet a measured number for its limiter, tuning, errors, repeatability, end-to-end relevance, and whether the timed work ran. | -| [`/statechart`](./skills/statechart/SKILL.md) | Check a TLA+ state model with TLC and draw a Mermaid chart. Report a shortest path per broken invariant or deadlock rule and TLC counterexamples for temporal properties. | +| [`/statechart`](./skills/statechart/SKILL.md) | Check a TLA+ state model with TLC and draw a Mermaid chart. Mark each state that breaks a rule and give the shortest path to it. | | [`/ketchup-video`](./skills/ketchup-video/SKILL.md) | Catch up with a short subtitled video and waiting decisions. Deliver a file link or attachment when the client cannot embed video. | The 0.15.36 upstream port replaces the `orch` helper with agent-driven orchestration through native tasks and durable tracker files. `/interrogate` now reports only findings demonstrated by a run and verified by the parent. `/statechart` ships the upstream skill and its tests byte for byte. By default it needs `mise` on `PATH`. mise installs TLC 1.7.4 and Temurin 25 Java when they are missing, which needs network access. Setting `TLA2TOOLS` bypasses mise. Root `tsc` skips `skills/statechart/scripts`, which keeps upstream's own `tsconfig.json`. Video generation uses available rendering tools outside the repository. diff --git a/docs/guide/06-verify-and-ship.md b/docs/guide/06-verify-and-ship.md index b8477aa..42235b4 100644 --- a/docs/guide/06-verify-and-ship.md +++ b/docs/guide/06-verify-and-ship.md @@ -123,7 +123,7 @@ A counterexample in model terms convinces you. The PM or designer who owns the b /statechart what the user sees when they edit a note offline ``` -[`/statechart`](../../skills/statechart/SKILL.md) draws a Mermaid statechart of what the user sees, generated from a TLA+ model, so the picture and the checked model can't drift apart. The reader's rules ("you never see Synced while you're offline") become invariants. The chart marks states that break rules. The report gives a shortest path per broken invariant or deadlock rule in the reader's words, and TLC counterexamples for temporal properties. Before the hand-off, the agent reproduces each bug path in the real code, so a modeling error doesn't reach the reader as a bug. +[`/statechart`](../../skills/statechart/SKILL.md) draws a Mermaid statechart of what the user sees, generated from a TLA+ model, so the picture and the checked model can't drift apart. The reader's rules ("you never see Synced while you're offline") become invariants. The chart marks each state that breaks a rule, and the report gives the shortest path to it in the reader's words. Before the hand-off, the agent reproduces each bug path in the real code, so a modeling error doesn't reach the reader as a bug. ## Open the PR diff --git a/skills/create-formal-verification-skill/SKILL.md b/skills/create-formal-verification-skill/SKILL.md index f3b8d57..9379e19 100644 --- a/skills/create-formal-verification-skill/SKILL.md +++ b/skills/create-formal-verification-skill/SKILL.md @@ -32,7 +32,7 @@ Pick the tool that answers the question at the lowest cost: a model checker, a p Follow the placement rules in [`omp-create-skill`](../poteto-mode/references/omp-create-skill.md#placement). Write a project-local skill with frontmatter that names the area and says when to use it. Without frontmatter, the skill never registers. From the skill alone, the next agent must be able to tell whether a change touches the verified code, run the check, tell a real bug from a modeling error, and update the verification when a change is intended. Put the coverage record and the sync commit in the skill, and tell the next agent to move the sync commit forward only after it confirms that the verification describes the code at the new commit. Use this repo's real commands, paths, and nouns, and leave no placeholders. -If the check is a TLA+ model, tell the next agent to read every result with the pstack [`/statechart`](../statechart/SKILL.md) skill. It reports a shortest path per broken invariant or deadlock rule in plain words, and TLC counterexamples for temporal properties. When the check passes and the model fits the chart budget of 500 states, `/statechart` draws how the system moves between states. Above that budget, a passing check produces a report without a chart. Refer to `/statechart` by name. Its commands, options, and file paths change between releases and machines, so copy none of them into the generated skill or its scripts. +If the check is a TLA+ model, tell the next agent to read every result with the pstack [`/statechart`](../statechart/SKILL.md) skill. It shows each invariant violation the checker finds as its shortest path in plain words. When the check passes, `/statechart` draws a chart of how the system moves between states. Refer to `/statechart` by name. Its commands, options, and file paths change between releases and machines, so copy none of them into the generated skill or its scripts. ## Prove it before you hand off diff --git a/skills/poteto-help/SKILL.md b/skills/poteto-help/SKILL.md index a646387..1a99949 100644 --- a/skills/poteto-help/SKILL.md +++ b/skills/poteto-help/SKILL.md @@ -83,7 +83,7 @@ The default answer is `/poteto-mode`, which runs most of the others when its ste | Bring a verification skill and its feature map back in line with the app | [`/maintain-verification-skill`](../maintain-verification-skill/SKILL.md) | | Formally verify a race, invariant, or other property that tests rarely reach | [`/create-formal-verification-skill`](../create-formal-verification-skill/SKILL.md) | | Bring a formal verification back in line after the code it covers changed, and learn whether a failure is drift or a bug | [`/maintain-formal-verification-skill`](../maintain-formal-verification-skill/SKILL.md) | -| Show a PM or designer a chart checked by a TLA+ model, with a shortest path per broken invariant or deadlock rule and TLC counterexamples for temporal properties | [`/statechart`](../statechart/SKILL.md) | +| Show a PM or designer what the user sees as a chart checked by a TLA+ model, with the shortest path to each state that breaks a rule | [`/statechart`](../statechart/SKILL.md) | | Vet a performance number before reporting or acting on it | [`/benchmark-checklist`](../benchmark-checklist/SKILL.md) | | Run a large or cross-cutting change, or one to review after stepping away | [`/figure-it-out`](../figure-it-out/SKILL.md) | | Keep a decision log during a run, and review it afterward | [`/show-me-your-work`](../show-me-your-work/SKILL.md) | diff --git a/upstream.json b/upstream.json index 6c5169e..4d1203f 100644 --- a/upstream.json +++ b/upstream.json @@ -47,7 +47,7 @@ "target": "README.md", "mode": "100644", "adaptation": { - "reason": "README identity, editorial voice, credits, and presentation distinguish this independently maintained OMP plugin adaptation from upstream P Stack by Lauren Tan (poteto), link the original source, retain its MIT notice, attribute poteto-mode's style to its creator, point to pinned provenance in upstream.json, and feature original Astra-generated watercolor artwork of Jrecos and OMP robot agents instead of upstream character art.; Install section: /add-plugin pstack replaced with omp plugin marketplace add https://github.com/Jrecos/omp-pstack + omp plugin install omp-pstack@omp-pstack.; 'turns cursor into'/'cursor gives you' reworded to agent/omp; cursor's /loop attributed to omp's built-in /loop.; poteto-agent and Comment Sicko spawn recipes translated to native task agent names; 'substituting generalPurpose' reworded.; 'not shipped here' (cursor-team-kit, /create-skill, /babysit) replaced by a host-adaptations section naming the packaged references omp-deslop.md, omp-control-cli.md, omp-control-ui.md, omp-create-skill.md.; Plan-mode section references omp native plan mode; benny setup path .cursor/automations/benny/ changed to .omp/automations/benny/ and 'point cursor' to 'point the agent'.; Added explicit optional official Spec Kit Feature setup, pinned provenance, and security limits. Pin OMP18.10.2 and link the measured native-capability assessment while preserving original attribution and native installation. Describe statechart's per-rule safety paths separately from temporal counterexamples, its default mise bootstrap and offline TLA2TOOLS/JAVA alternative, and its minimal strict-TypeScript compatibility fixes with root fast-check 4.5.3. These source-backed documentation corrections do not claim measured behavioral equivalence.", + "reason": "README identity, editorial voice, credits, and presentation distinguish this independently maintained OMP plugin adaptation from upstream P Stack by Lauren Tan (poteto), link the original source, retain its MIT notice, attribute poteto-mode's style to its creator, point to pinned provenance in upstream.json, and feature original Astra-generated watercolor artwork of Jrecos and OMP robot agents instead of upstream character art.; Install section: /add-plugin pstack replaced with omp plugin marketplace add https://github.com/Jrecos/omp-pstack + omp plugin install omp-pstack@omp-pstack.; 'turns cursor into'/'cursor gives you' reworded to agent/omp; cursor's /loop attributed to omp's built-in /loop.; poteto-agent and Comment Sicko spawn recipes translated to native task agent names; 'substituting generalPurpose' reworded.; 'not shipped here' (cursor-team-kit, /create-skill, /babysit) replaced by a host-adaptations section naming the packaged references omp-deslop.md, omp-control-cli.md, omp-control-ui.md, omp-create-skill.md.; Plan-mode section references omp native plan mode; benny setup path .cursor/automations/benny/ changed to .omp/automations/benny/ and 'point cursor' to 'point the agent'.; Added explicit optional official Spec Kit Feature setup, pinned provenance, and security limits. Pin OMP18.10.2 and link the measured native-capability assessment while preserving original attribution and native installation. Describe statechart as the upstream skill shipped byte for byte, its default mise bootstrap, its root tsc exclusion, and its test-time renderer installs with root fast-check 4.5.3. These source-backed documentation corrections do not claim measured behavioral equivalence.", "verification": { "kind": "omp/cli scenario", "artifacts": [ @@ -345,7 +345,7 @@ "target": "docs/guide/06-verify-and-ship.md", "mode": "100644", "adaptation": { - "reason": "Generated verify skill path changed to .omp/skills/verify-/. Correct the statechart report description to one shortest path per broken invariant or deadlock rule and TLC counterexamples for temporal properties. Images and example links are untouched.", + "reason": "Generated verify skill path changed to .omp/skills/verify-/. Images and example links are untouched.", "verification": { "kind": "pinned-byte/link inspection", "artifacts": [ @@ -1644,7 +1644,7 @@ "target": "skills/poteto-help/SKILL.md", "mode": "100644", "adaptation": { - "reason": "Describe this OMP adaptation: marketplace install, session-branch mode persistence, pool-first /setup-pstack via pstack_models with no default models, native task agents, OMP /loop semantics, and repository links. Correct the statechart route to promise per-rule shortest invariant/deadlock paths and TLC temporal counterexamples, not a shortest path to every violating state.", + "reason": "Describe this OMP adaptation: marketplace install, session-branch mode persistence, pool-first /setup-pstack via pstack_models with no default models, native task agents, OMP /loop semantics, and repository links.", "verification": { "kind": "pinned-byte/link inspection", "artifacts": [ @@ -1755,7 +1755,7 @@ "target": "skills/create-formal-verification-skill/SKILL.md", "mode": "100644", "adaptation": { - "reason": "Generate skills in existing OMP-discoverable project roots according to the native authoring reference. Correct statechart guidance to distinguish per-rule shortest invariant/deadlock paths from TLC temporal counterexamples and qualify charts on passing checks by the 500-state budget.", + "reason": "Generate skills in existing OMP-discoverable project roots according to the native authoring reference.", "verification": { "kind": "pinned-byte/link inspection", "artifacts": [