@synapta/skills 0.1.0 → 0.1.2

package/skills/drive-status-renderer/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: drive-status-renderer
+description: Render Synapta session/backlog/incident/deploy state as glanceable cards for iOS Widgets, Live Activities, and CarPlay templates. Voice-first phrasing — no source code, no terminal logs in card content.
+triggers: [synapta drive render, Live Activity render, Widget timeline, CarPlay status card]
+network: off
+tools: [Read, Write]
+source:
+  origin: authored-by-synapta
+  reason: "Synapta-specific iOS/CarPlay status renderer; no community equivalent."
+  citation_patterns:
+    - "WidgetKit documentation (Apple Developer)"
+    - "ActivityKit documentation (Apple Developer)"
+    - "CarPlay Programming Guide — list/alert/information templates"
+---
+
+# Drive: Status Renderer
+
+Map gateway state (sessions, backlog items, deploy runs, incidents) to glanceable iOS surfaces. Voice-first phrasing. Never include source code, raw tool output, or terminal logs.
+
+## Surfaces
+
+| Surface | Constraints |
+|---|---|
+| WidgetKit (Home / Lock / StandBy) | budgeted timeline; ≤ 30 lines; no interactive elements beyond a single deep link |
+| Live Activity (Dynamic Island) | minimal=1 glyph, compact=phase, expanded=phase + 1–2 buttons |
+| CarPlay `CPListTemplate` | one row = one entity, no images beyond an SF Symbol tint |
+| CarPlay `CPAlertTemplate` | one paragraph max, voice-readable |
+| CarPlay `CPInformationTemplate` | label/value pairs, no prose paragraphs |
+
+## Renderable entities
+
+| Entity | Card title | Subtitle | Trailing |
+|---|---|---|---|
+| Session | session label | mode + last phase | status dot |
+| Backlog item | item title | epic name | estimate |
+| Deploy run | "Deploy to <provider>" | env + ref | status |
+| Incident brief | "Incident: <service>" | severity + age | status |
+| Approval request | action + target | summary, expiresAt | "Approve / Reject" |
+
+## Phrasing rules
+
+- Short sentences. Voice-readable.
+- Numbers spelled or shorthanded for screens (`12` not "twelve"), spoken naturally if read aloud.
+- No code identifiers (camelCase, snake_case, paths). Translate `engine_codex.startSession` → "Codex engine starting a session."
+- No URLs except a single deep link target.
+- Time relative: "2m ago", "in 30s", "expires in 4m"
+- Avoid jargon: "rolling back" not "executing rollback procedure".
+
+## Output schema
+
+```ts
+type StatusCard = {
+  id: string;
+  surface: 'widget' | 'liveactivity' | 'carplay-list' | 'carplay-alert' | 'carplay-info';
+  title: string;
+  subtitle?: string;
+  trailing?: { kind: 'status'; value: 'pending' | 'running' | 'success' | 'failed' | 'rolledback' };
+  actions?: Array<{ id: string; label: string; intent: string }>;
+  deepLink?: string;
+  voiceCopy?: string;  // when surface=carplay-alert or read aloud
+};
+```