Stitch Session Manager
Quick Start
Start a new Stitch session for [project] → creates .google-stitch/sessions/<project>/session.json.Add a screen called [name] with this brief: ... → optimizes prompt via authoring-stitch-prompts, saves Markdown to .google-stitch/prompts/<slug>-###-prompt.md, and logs metadata as <slug>-###.json.Summarize my current Stitch session → returns screen list, visual patterns, next-step suggestions.Generate a new prompt for [screen] using current session style → reuses stored cues before calling the authoring skill.End this Stitch session and export summary → writes Markdown summary under the session folder.
Output Structure
.google-stitch/sessions/<project>/session.json: metadata (session_name, timestamps, style guide notes, prompt index)..google-stitch/sessions/<project>/screen-log/<slug>-###.json: individual prompt payloads (raw brief, status, references) plus the path of the saved Markdown prompt..google-stitch/prompts/<slug>-###-prompt.md: source-of-truth prompt text produced by authoring-stitch-prompts..google-stitch/sessions/<project>/summary.md: exportable brief for reviews or handoffs.
Commands & Triggers
| Command |
Trigger phrases |
Result |
session:new |
"start a new Stitch session" |
Initialize directories + base metadata. |
session:add |
"add screen", "log prompt", "iterate screen" |
Capture new screen, call authoring skill, persist JSON. |
session:list |
"show session screens" |
Return ordered list of screens + status. |
session:summary |
"summarize session", "what have we made" |
Produce textual summary + style cues. |
session:style |
"reuse style", "match previous look" |
Extract palette, typography, tone for new prompts. |
session:export |
"export session", "end session" |
Finalize summary.md with totals + next steps. |
Workflow
Follow the abbreviated loop: initialize → add/update screens → reference session memory → export.
See WORKFLOW.md for detailed branching logic, file formats, and pseudo-commands.
Prompt Storage Alignment
- Reuse the same slug + zero-padded index rules from
authoring-stitch-prompts when calling the authoring Skill.
- Pass the computed path (
.google-stitch/prompts/<slug>-###-prompt.md) to the logger so summaries and exports can link directly to the Markdown file.
- Never duplicate prompt text inside the JSON logs—store pointers only to keep history lightweight.
Style Memory & Integration
- Before writing a new prompt, the Skill scans existing
session.json + latest screen logs to extract design cues (color, typography, density, component patterns).
- It then calls
authoring-stitch-prompts with:
- Original user brief.
- Session style payload (palette, layout bias, voice).
- Optional constraints (responsive targets, export needs).
- Returned prompt is saved back to the log and surfaced to the user for immediate Stitch use.
- When no stylistic precedent exists, fall back to user-provided cues and update session metadata once the first screen is logged.
Examples
Representative transcripts for starting sessions, logging iterations, and exporting summaries live in EXAMPLES.md. Use them to mirror tone, prompt framing, and file naming.
Common Issues
High-level fixes are below; detailed diagnosis (including directory repair scripts) is in TROUBLESHOOTING.md.
- Missing session folder → re-run
session:new or point to existing .google-stitch/sessions/<project>.
- Style drift → run
session:style to restate cues before adding new screens.
- Duplicate screen names → the Skill auto-increments suffixes; confirm desired slug before export.
Version History
- v1.0.0 (2025-02-10): Initial release — session management companion to
authoring-stitch-prompts.
1---2name: stitch-session-manager3description: Manages multi-screen Google Stitch design sessions by tracking prompts, screens, and shared style language. Use when you need continuity across Stitch prompts, want to append or summarize sessions, or must export screen histories for reviews. Triggers on phrases like "start/continue Stitch session", "log screen", or "summarize Stitch progress".4---5
6# Stitch Session Manager
7
8## Quick Start
9- `Start a new Stitch session for [project]` → creates `.google-stitch/sessions/<project>/session.json`.
10- `Add a screen called [name] with this brief: ...` → optimizes prompt via `authoring-stitch-prompts`, saves Markdown to `.google-stitch/prompts/<slug>-###-prompt.md`, and logs metadata as `<slug>-###.json`.
11- `Summarize my current Stitch session` → returns screen list, visual patterns, next-step suggestions.
12- `Generate a new prompt for [screen] using current session style` → reuses stored cues before calling the authoring skill.
13- `End this Stitch session and export summary` → writes Markdown summary under the session folder.
14
15## Output Structure
16- `.google-stitch/sessions/<project>/session.json`: metadata (`session_name`, timestamps, style guide notes, prompt index).
17- `.google-stitch/sessions/<project>/screen-log/<slug>-###.json`: individual prompt payloads (raw brief, status, references) plus the path of the saved Markdown prompt.
18- `.google-stitch/prompts/<slug>-###-prompt.md`: source-of-truth prompt text produced by `authoring-stitch-prompts`.
19- `.google-stitch/sessions/<project>/summary.md`: exportable brief for reviews or handoffs.
20
21## Commands & Triggers
22| Command | Trigger phrases | Result |
23| --- | --- | --- |
24| `session:new` | "start a new Stitch session" | Initialize directories + base metadata. |
25| `session:add` | "add screen", "log prompt", "iterate screen" | Capture new screen, call authoring skill, persist JSON. |
26| `session:list` | "show session screens" | Return ordered list of screens + status. |
27| `session:summary` | "summarize session", "what have we made" | Produce textual summary + style cues. |
28| `session:style` | "reuse style", "match previous look" | Extract palette, typography, tone for new prompts. |
29| `session:export` | "export session", "end session" | Finalize summary.md with totals + next steps. |
30
31## Workflow
32Follow the abbreviated loop: initialize → add/update screens → reference session memory → export.
33See [WORKFLOW.md](WORKFLOW.md) for detailed branching logic, file formats, and pseudo-commands.
34
35## Prompt Storage Alignment
36- Reuse the same slug + zero-padded index rules from `authoring-stitch-prompts` when calling the authoring Skill.
37- Pass the computed path (`.google-stitch/prompts/<slug>-###-prompt.md`) to the logger so summaries and exports can link directly to the Markdown file.
38- Never duplicate prompt text inside the JSON logs—store pointers only to keep history lightweight.
39
40## Style Memory & Integration
41- Before writing a new prompt, the Skill scans existing `session.json` + latest screen logs to extract design cues (color, typography, density, component patterns).
42- It then calls **`authoring-stitch-prompts`** with:
43 - Original user brief.
44 - Session style payload (palette, layout bias, voice).
45 - Optional constraints (responsive targets, export needs).
46- Returned prompt is saved back to the log and surfaced to the user for immediate Stitch use.
47- When no stylistic precedent exists, fall back to user-provided cues and update session metadata once the first screen is logged.
48
49## Examples
50Representative transcripts for starting sessions, logging iterations, and exporting summaries live in [EXAMPLES.md](EXAMPLES.md). Use them to mirror tone, prompt framing, and file naming.
51
52## Common Issues
53High-level fixes are below; detailed diagnosis (including directory repair scripts) is in [TROUBLESHOOTING.md](TROUBLESHOOTING.md).
54- Missing session folder → re-run `session:new` or point to existing `.google-stitch/sessions/<project>`.
55- Style drift → run `session:style` to restate cues before adding new screens.
56- Duplicate screen names → the Skill auto-increments suffixes; confirm desired slug before export.
57
58## Version History
59- v1.0.0 (2025-02-10): Initial release — session management companion to `authoring-stitch-prompts`.
majiayu000