# ShowRunner Engineering Plan (Now and Next)

## North Star

Build the fastest developer workflow documentation loop in the market:

- Record to share in under 60 seconds for common workflows.
- Minimal manual cleanup before publishing.
- Trustworthy output with deterministic artifacts and privacy controls.

## Now (0-8 weeks)

### Track A: Reliability and Data Contracts

1. Lock `events.ndjson` schema as `v1` and document required fields.
2. Add fixture based replay checks for 10 core dev flows:
   - terminal commands
   - browser app workflows
   - IDE + file edits
3. Add conversion failure telemetry and top error reporting.

Success criteria:

- Replay and artifact generation succeed on >95% of golden flows.
- Capture or conversion crash rate stays below 1%.

### Track B: Step Quality and Editor Throughput

1. Add confidence scoring to generated steps.
2. Improve deterministic post processing:
   - collapse noisy micro steps
   - enforce stable naming patterns
3. Make editor cleanup faster with high leverage controls:
   - merge, split, reorder, rename
   - strong undo reliability

Success criteria:

- Median manual edits per session is 3 or fewer.
- At least 70% of sessions are publishable without timeline scrubbing.

### Track C: Record to Share UX

1. Ship one polished share path:
   - direct link
   - markdown snippet
   - embed snippet
2. Add command center UX in library:
   - quick resume latest ready session
   - visibility into conversion backlog
3. Tighten status and feedback:
   - clear conversion complete messages
   - actionable error states

Success criteria:

- Median record to share time under 60 seconds.
- Share completion rate improves week over week.

### Track D: Privacy and Safety Baseline

1. Manual redaction available before publish.
2. Secret pattern checks before export/share.
3. Retention controls for local artifacts.

Success criteria:

- Zero known secret leaks in QA corpus.

## Next (2-6 months)

### Team and Platform

1. Team library, search, and lightweight permissions.
2. Version history and change trail for published guides.
3. Read APIs for sessions, steps, and events.
4. Webhooks (`run_completed`, `export_ready`) and API key management.

### Guided Execution

1. Guided playback mode with step validation.
2. Off path detection and recovery hints.
3. Better onboarding runbooks for engineering and support teams.

### Governance and Enterprise Readiness

1. Auto redaction improvements.
2. Policy based retention.
3. Audit logs for export/share activity.
4. Foundations for SSO and RBAC pilots.

### Insights

1. Step duration, drop-off, and error hotspots.
2. Rule based workflow improvement suggestions before heavy ML.
3. Clear quality score shown per session.

## UX Quality Bar (Must Hold)

1. Every main action has immediate feedback within 100ms.
2. No dead-end states; each error offers a next action.
3. Critical flows are keyboard friendly.
4. Defaults are production safe.
5. Visual hierarchy stays consistent across library, recording, and share surfaces.

## Explicit Deprioritization (Now and Next)

1. AR/VR capture.
2. AI avatar narration and cinematic effects.
3. Broad integration surface before one channel proves sticky.
4. Mobile capture before desktop loop quality is excellent.
5. Autonomous replay execution in production before guided mode is stable.