@cratis/pi 7.122.2 → 7.123.0

package/package/corpus/skills/cratis-screenplay-discovery/SKILL.md

@@ -206,7 +206,7 @@ Read [references/neighbouring-skills.md](references/neighbouring-skills.md) when
 - `references/interview-questions.md` - questions by topic, why, follow-ups.
 - `references/storming-loop.md` - the loop, edit kinds, a compiled discovery skeleton.
 - `references/event-naming.md` - naming rules, not-an-event filter, repairs.
-- `references/personas-and-causes.md` - role catalogue, Cannot resolved to executable gates.
+- Read `references/personas-and-causes.md` when cataloging roles, capturing persona goals, placing personas or sticky notes on the personas canvas, or resolving Cannot lines to executable gates.
 - `references/divergent-sweep.md` - lenses for the wide pass.
 - `references/document-intake.md` - read when the source is a document or a package of documents: rigor rules, the facts file, reading long sources, fact kind to declaration, the blueprint summary.
 - `references/domain-analysis-template.md` - read when requirements arrive as prose and a person must confirm your reading before you model: the note shape, requirement checks, expert questions.

package/package/corpus/skills/cratis-screenplay-discovery/references/personas-and-causes.md

@@ -3,6 +3,7 @@
 ## Contents
 
 - Role catalogue on `persona`
+- Persona goals and canvas notes
 - What a Cannot line becomes
 - Cannot resolved to an executable gate
 - Checks while building
@@ -52,6 +53,45 @@ persona Harbourmaster
 Parent document: the complete example under "Cannot resolved to an executable gate" below
 declares the same policies and persona with the one-line form.
 
+## Persona goals and canvas notes
+
+Requires Screenplay 4.239.0 or later (`screenplay --version`); older compilers reject the canvas directives. Defer goals, layout and sticky-note syntax until the compiler is upgraded; keep ordinary persona declarations.
+
+Read this when capturing what a persona wants or arranging the personas canvas.
+After the optional `description` (first body line), a persona can have repeated
+`goal "<text>"` lines, policy lines, then optional `position <x> <y>` and
+`size <width> <height>`. Each pair uses integers: position may be negative;
+size must be nonnegative.
+
+Use a top-level `sticky note on personas` for context, pain points or open
+questions about the personas. Its `description` and `position` are required;
+write description first, optional `colour`, position, then optional size.
+The grammar token is `colour`, with `yellow` (default), `pink`, `green` or `blue`;
+size uses the same nonnegative integer pair. A description can be a quoted line
+or a fenced block. This canvas note does not replace an anchored `question`
+note required for discovery handoff.
+
+```screenplay
+persona Shopper
+  description "Browses the catalog and buys"
+  goal "Find the right product quickly"
+  position 0 0
+  size 300 180
+
+sticky note on personas
+  description "Pain point: the checkout asks for too much"
+  colour pink
+  position 340 0
+  size 220 140
+```
+
+Goals, layout and sticky notes are authoring-only: they do not change executable
+semantic model (ESM) bytes or revision. A goal is not an enforceable rule or an
+authorization gate; persona policy and denial guidance below still applies.
+Malformed goals, invalid coordinate or size pairs, invalid `colour` values,
+and missing required sticky-note fields report `PLAY0030`. Unknown directives,
+including the incorrect spelling `color`, report `PLAY0032`.
+
 ## What a Cannot line becomes
 
 The persona block is report-only: Screenplay neither binds nor enforces it, and no rendered

package/package/corpus/skills/cratis-screenplay-discovery/verification.json

@@ -4,6 +4,8 @@
   "fixtures": [],
   "assertions": [
     { "kind": "play-compiles" },
+    { "kind": "skill-contains", "value": "Goals, layout and sticky notes are authoring-only", "file": "references/personas-and-causes.md" },
+    { "kind": "skill-contains", "value": "sticky note on personas", "file": "references/personas-and-causes.md" },
     { "kind": "skill-contains", "value": "record the open question and assumption as a `question` note" },
     { "kind": "skill-contains", "value": "`refs: [{ \"id\": \"D123\" }]`", "file": "references/plotting-and-handoff.md" },
     { "kind": "skill-contains", "value": "`by: \"external-decision\"`", "file": "references/plotting-and-handoff.md" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cratis/pi",
-  "version": "7.122.2",
+  "version": "7.123.0",
   "description": "Configuration-aware Cratis AI integration for Pi",
   "type": "module",
   "files": [