feat: archive zoo_backup for home sync

2026-06-24 19:27:05 +02:00
parent 02844e4c4a
commit 038e546963
133 changed files with 19953 additions and 0 deletions
@@ -0,0 +1,185 @@
+# 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
+
+```python
+# 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
+
+```bash
+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
+
+```python
+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
+
+```bash
+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`:
+
+```markdown
+# 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
+
+```python
+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