Story Editor - Quick Reference

What is it?

Transform technical process flows into readable stories.

Pattern

{step#} {source} {action} {dataobject} {then action} {target}

Example

Step 10: Customer submits Order then sends to Order Management System
Step 20: Order Management System validates Order then forwards to Warehouse

Key Rules

1. Stories start with: Actor, Timer, Process, or Feature
2. Data objects are: Always intermediate (never story starters)
3. Step numbering: [source→data] = N, [data→target] = N+1
4. Parallel flows: Same step# = "Meanwhile"

Access

1. Open a process in Korgraph
2. Click 📖 Story Editor button (top toolbar)

Current Features

✅ View stories in narrative format ✅ See parallel flows grouped with "Meanwhile" ✅ Drag & drop to reorder stories ✅ Renumber all stories automatically ✅ Color-coded elements (source, action, data, target)

Toolbar Actions

• 🔗 Merge Selected: Group stories (coming soon)
• ✂️ Split Story: Separate flows (coming soon)
• 🔢 Renumber All: Update step numbers based on order

Drag & Drop

1. Click and hold the ⋮⋮ handle
2. Drag story up or down
3. Release to drop
4. Click "Renumber All" to update step numbers

Color Legend

• 🔵 Source - Who starts the action
• 🟢 Action - What they do
• 🟡 Data Object - What's being processed
• 🟣 Target - Where it goes

Parallel Flows

When multiple stories have the same step number:

Story 1: Customer submits Order...
Meanwhile: Customer checks Status...

Future Features

• Edit stories inline
• Add/delete stories
• Save changes to process
• Export to documentation
• Split/merge implementation

Testing Focus

This is a testing version for feedback on:

• Story readability
• Visual clarity
• Drag & drop UX
• Grouping logic

Feedback Welcome!

Let us know:

• What works well?
• What's confusing?
• What features are needed most?
• How would you use this?

---

Version: 1.0 (Testing) Status: Read-only visualization with basic reordering