Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

License: MIT Python 3.10+ Status: MVP Validated

AI Shift Handover System

Status: ✅ MVP Validated | Phase: Implementation (Phase 2, July 2026)

An AI-powered system that automatically transforms unstructured shift notes into structured management reports with Root Cause Analysis. Tested and validated on real production data.


Problem

Shift handovers in manufacturing lose critical information:

  • Today: "It was difficult" → Manager confused
  • Reality: Motor failure + 700 defects + near-miss safety incident → Needs immediate escalation

Information gaps cause:

  • Double-processing of problems
  • Repeated failures
  • Delayed decisions
  • Lost institutional knowledge

Solution

A two-step AI workflow that turns raw shift notes into actionable intelligence:

1. SBAR Report (Structured Handover)

Input: Shift notes (free text, 500-1000 words)

Output: Management-ready report

SITUATION       → Production status, KPIs, problems
BACKGROUND     → Why problems occurred (6M analysis)
ASSESSMENT     → Severity, risk, business impact
RECOMMENDATION → Concrete next steps (not generic advice)

Max 2 minutes to read. Executive-ready.

2. Root Cause Analysis (RCA)

Input: Quality problems from shift notes

Output: 5-Why analysis with containment & prevention

Categorizes problems by 6M (Maschine, Material, Methode, Milieu, Mensch, Messung)


MVP Validation Results

3 Test Cases on real production data. All PASS (12/12 criteria met).

Criteria Test 1: Standard Test 2: Incomplete Data Test 3: Critical Incident Result
Accuracy (100% correct numbers) 3/3 PASS
No Hallucinations (marks missing data) 3/3 PASS
Critical Event Detection (prioritizes risks) 3/3 PASS
Readability (< 2 min) 3/3 PASS
Concrete Recommendations (not generic) 3/3 PASS
Management Trust (would forward to leadership) 3/3 PASS

Examples:

  • ✅ "Increase pressure by 2 bar, sort 150 pieces TODAY" (not "review process")
  • ✅ "Motor replaced, 700+ defects sorted IMMEDIATELY" (actionable, time-bound)
  • ✅ "[NOT DOCUMENTED]" (marks missing data instead of guessing)

Architecture

Shift Notes (Markdown)
    ↓
[Claude 3 Sonnet API]
    ↓
    ├─→ SBAR Report (structured, 1 page)
    └─→ RCA Analysis (6M + 5-Why)
    ↓
[n8n Workflow] (Phase 2)
    ↓
    ├─→ Slack notification to manager
    ├─→ Archive to knowledge base
    └─→ Trigger downstream workflows

Repository Structure

ai-shift-handover-system/
├── README.md (this file)
├── LICENSE (MIT)
├── /prompts/
│   ├── sbar-prompt.md (Claude SBAR generation prompt)
│   └── rca-prompt.md (Claude RCA generation prompt)
├── /examples/
│   ├── 01-standard-case/
│   │   ├── input.md (shift notes)
│   │   ├── sbar-output.md (generated report)
│   │   └── rca-output.md (generated analysis)
│   ├── 02-incomplete-data/
│   │   └── ...
│   └── 03-critical-incident/
│       └── ...
├── /docs/
│   ├── ARCHITECTURE.md (system design)
│   ├── MVP-VALIDATION.md (test results & methodology)
│   ├── CLAUDE-INTEGRATION.md (API setup)
│   └── FUTURE-ROADMAP.md (Phase 2-3 plans)
└── /workflows/
    └── shift-handover-n8n.json (n8n workflow template - Phase 2)

Quick Start

Use the Prompts

  1. Get your shift notes (template in /examples/)
  2. Copy sbar-prompt.md from /prompts/
  3. Send shift notes + prompt to Claude API (or chat.anthropic.com)
  4. Get structured SBAR report in 10 seconds

See Example Outputs

Check /examples/01-standard-case/ for a complete end-to-end example:

  • Input: Raw shift notes from real production
  • Output: SBAR report + RCA analysis
  • Validation: How it was scored against 6 criteria

Integrate with n8n (Phase 2)

Workflow template coming July 2026:

  • Auto-detect new shift notes
  • Call Claude API
  • Post to Slack
  • Archive to Obsidian vault

Key Features

Accuracy: Tested on real manufacturing data. 100% factual.

Hallucination-Resistant: Explicitly marks missing data. No speculation.

Criticality-Aware: Prioritizes safety, production issues, escalations.

Lean & Fast: Generates in seconds. Read in 2 minutes.

Actionable: Specific recommendations with owners & deadlines.

Framework-Agnostic: Works with your existing systems (SAP, ERP, MES).


Business Value

  • Time Savings: 75% reduction in handover time (20 min → 5 min)
  • Accuracy: 0% information loss vs. 15% today
  • Escalation Speed: Immediate vs. 45+ minutes
  • Consistency: Same structure every shift, every facility
  • Training: New shift leads learn from documented standards

Technology Stack

  • AI Model: Claude 3 Sonnet (Anthropic)
  • Workflow Engine: n8n (Phase 2)
  • Knowledge Base: Obsidian + Markdown
  • Deployment: Docker + Kubernetes (optional)
  • Notification: Slack, Email
  • Language: Deutsch / English

Roadmap

Phase Milestone Status Target
Phase 1 MVP Validation ✅ DONE 2026-06-04
Phase 2 n8n Integration + Production 🔄 In Progress 2026-07-31
Phase 3 SAP OData Integration 🔄 Planned 2026-09-30
Phase 4 Multi-Shift + Historical Analysis 🔄 Planned 2026-12-31

For Recruiters / Companies

This repo demonstrates:

  • AI Integration: How to integrate Claude API into production workflows
  • Validation Methodology: How to test AI systems against measurable criteria
  • Domain Expertise: 30+ years of manufacturing + modern automation
  • End-to-End Thinking: From problem definition to implementation

Interested in Smart Operations AI automation? See Portfolio or LinkedIn.


License

MIT License - See LICENSE file


Created: 2026-06-04
Updated: 2026-06-04
Maintainer: Mario Bergsch
Status: Active Development

About

AI-powered shift handover automation with SBAR/RCA — saves 15 min per shift

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors