pi_mcps/zoo_backup/work/rules/skills/skill-generate-handover.md

Skill: generate-handover

Generate handover document for session or person transfer.

Invoked by

📝 DocGen mode (or 🪃 Orchestrator delegating to DocGen)

Required Inputs

Input	Source	Example
TICKET_KEY	Jira issue key	ESIDEPAISY-12081
MODULE	PAISY module name	eau, eubp, svmeldungen
SESSION_ID	BigMind session to hand over (optional)	d8a0f4fa-59ee-48c0-b863-a51bc6294331

Output

Markdown file: docs/<MODULE>/<TICKET_KEY>/<TICKET_KEY>-handover-<date>.md

Steps

1. Read BigMind session context

# If SESSION_ID provided, get the full session detail
memory_get_session_detail(session_id=SESSION_ID)

# Also search for all facts related to this ticket
memory_search_facts("<TICKET_KEY>")
memory_search_chunks("<TICKET_KEY>")

2. Read git status

cd /Users/pplate/git/paisy-<TICKET_KEY>
git branch --show-current
git status
git log origin/current..HEAD --oneline
git diff origin/current --stat

3. Read Jira ticket status

ticket = retrieve_ticket_details(TICKET_KEY)
# Extract: status, assignee, summary, checklist state
checklist = get_checklist(TICKET_KEY)
comments = retrieve_ticket_comments(TICKET_KEY)

4. Read existing documentation

ls docs/<MODULE>/<TICKET_KEY>/

Read all available docs:

• Assessment (*-assessment.md)
• Plan (*-plan.md)
• Test plan (*-testplan.md)
• Solution doc (*-solution.md)
• Review (*-review.md)

5. Analyze what's done vs. remaining

Cross-reference:

• Jira checklist items (done vs. open)
• Git commits (what's been implemented)
• Test plan status (which tests pass/fail/pending)
• Plan document (which steps are complete)

6. Generate handover document

Write docs/<MODULE>/<TICKET_KEY>/<TICKET_KEY>-handover-<YYYY-MM-DD>.md:

# Handover: <TICKET_KEY> — <Summary>

**Datum:** <today>
**Modul:** <MODULE>
**Autor:** Roo (DocGen)
**BigMind Session:** `<SESSION_ID>`
**Branch:** <current branch>

---

## 1. Aktueller Stand

**Jira-Status:** <status>
**Fortschritt:** <X>/<Y> Checklist-Punkte erledigt

<1-3 sentence summary of where things stand>

## 2. Erledigte Arbeiten

| # | Beschreibung | Dateien | Commit |
|---|-------------|---------|--------|
| 1 | <what was done> | `<file1>`, `<file2>` | `<short hash>` |
| 2 | <what was done> | `<file3>` | `<short hash>` |

## 3. Offene Arbeiten

| # | Beschreibung | Priorität | Geschätzter Aufwand |
|---|-------------|-----------|-------------------|
| 1 | <what remains> | Hoch/Mittel/Niedrig | <estimate> |
| 2 | <what remains> | Hoch/Mittel/Niedrig | <estimate> |

## 4. Offene Fragen / Blocker

| # | Frage/Blocker | Kontext | Ansprechpartner |
|---|-------------|---------|----------------|
| 1 | <question or blocker> | <context> | <who can help> |

## 5. Wichtige Entscheidungen

<Key decisions made during this work, extracted from BigMind chunks>

| Entscheidung | Begründung | Datum |
|-------------|-----------|-------|
| <decision> | <rationale> | <date> |

## 6. Technische Hinweise

<Important technical context the next person needs to know:>
- <Pattern used, gotcha, workaround, etc.>
- <Environment setup needed>
- <Test data requirements>

## 7. Kontext-Wiederherstellung

Für die Weiterarbeit:
- **Worktree:** `/Users/pplate/git/paisy-<TICKET_KEY>`
- **Branch:** `<branch name>`
- **BigMind Session:** `<SESSION_ID>` — `memory_get_session_detail("<SESSION_ID>")` für Details
- **Relevante BigMind Facts:** <list fact IDs if available>
- **Dokumentation:** `docs/<MODULE>/<TICKET_KEY>/`

7. Store in BigMind

memory_store_fact(
    category="codebase",
    fact=f"{TICKET_KEY}: Handover doc created at docs/{MODULE}/{TICKET_KEY}/{TICKET_KEY}-handover-{date}.md. Status: {done}/{total} items done."
)
memory_append_chunk(
    session_id=SESSION_ID,
    content=f"Handover for {TICKET_KEY}: <summary of state and remaining work>",
    flag_reason="handover documentation"
)

Expected Output

• Handover document at docs/<MODULE>/<TICKET_KEY>/<TICKET_KEY>-handover-<date>.md
• Complete picture of done/remaining work
• Context recovery instructions for the next person/session
• BigMind fact stored for traceability

Error Handling

Error	Resolution
No BigMind session found	Generate handover from git + Jira only — note missing session context
No worktree found	Check if work was done in main repo with branch checkout
No plan/assessment docs	Generate handover from Jira ticket + git history only
Empty git history	Branch may not have diverged from current yet — note "no commits"

When to Use

Scenario	Trigger
End of day	Capture progress before stopping work
Person transfer	Handing ticket to another developer
Session recovery	After IDE crash, use to restore context
Long pause	Before vacation or multi-day break
Mode switch	When Orchestrator hands off between modes

Language

• Document content: German
• Technical terms (class names, branch names, BigMind IDs): English as-is
• Section headers: German