---
title: Discovery Questions Framework
description: Guided project definition workflow for Basecamp projects - 8 phases covering vision, success criteria, timeline, team, communication, tools, risks, and review
type: reference
version: 1.0
last_updated: 2025-04-27
---

# Discovery Questions Framework

Leitet User durch 8 Phasen der Projekt-Definition, ähnlich dem brainstorming Skill. Jede Phase kann übersprungen werden; Multiple-Choice-Fragen haben "Anderes"-Fallback.

---

## Phase 1: Vision & Goals

```yaml
phase:
  id: 1
  name: "Vision & Goals"
  description: "Kläre das Ziel und den Zweck des Projekts"
  skippable: true
  questions:
    - id: "project_goal"
      text: "Was ist das Ziel dieses Projekts?"
      type: "freetext"
      required: true
      prompt: "Beschreibe in einem Satz, was wir erreichen wollen"
      
    - id: "problem_solved"
      text: "Welches Problem löst dieses Projekt?"
      type: "freetext"
      required: false
      placeholder: "Welchen Schmerzpunkt oder welches Bedürfnis adressieren wir?"
```

### Beispiel-Prompts

**Frage:** Was ist das Ziel dieses Projekts?
**Prompt:** Beschreibe in einem Satz, was wir erreichen wollen.

**Antwort-Beispiel:** "Wir wollen die interne Dokumentation von Prozessen verbessern, damit new Joiner schneller produktiv werden."

---

## Phase 2: Success Criteria

```yaml
phase:
  id: 2
  name: "Success Criteria"
  description: "Definiere messbare Kriterien für Projekterfolg"
  skippable: true
  questions:
    - id: "success_indicators"
      text: "Woran erkennen wir, dass das Projekt erfolgreich war?"
      type: "multiple_choice_checkbox"
      required: false
      options:
        - label: "Funktional fertig"
          description: "Alle geplanten Features wurden implementiert"
          value: "functional_complete"
        - label: "Zeitnah geliefert"
          description: "Deadline wurde eingehalten"
          value: "on_time"
        - label: "Qualitätsziele erreicht"
          description: "Tests, Reviews und QA bestanden"
          value: "quality_met"
        - label: "Stakeholder zufrieden"
          description: "Feedback von Auftraggebern eingeholt und positiv"
          value: "stakeholder_happy"
        - label: "Budget eingehalten"
          description: "Kosten blieben im geplanten Rahmen"
          value: "on_budget"
        - label: "Andere"
          description: "Eigene Erfolgskriterien definieren"
          value: "other"
          freetext: true
          freetext_label: "Andere Erfolgskriterien:"
          freetext_placeholder: "z.B. 95% Adoption Rate nach Launch"
          
    - id: "kpis"
      text: "Welche messbaren KPIs definieren Erfolg?"
      type: "freetext"
      required: false
      multiline: true
      placeholder: "z.B. Response Time < 200ms, Coverage > 80%, NPS > 50"
```

### UI-Darstellung

```
Woran erkennen wir, dass das Projekt erfolgreich war?
☐ Funktional fertig (alle Features implementiert)
☐ Zeitnah geliefert (Deadline eingehalten)
☐ Qualitätsziele erreicht (Tests, Reviews bestanden)
☐ Stakeholder zufrieden (Feedback eingeholt)
☐ Budget eingehalten
☑ Andere: ___95% Adoption Rate nach Launch___
```

---

## Phase 3: Timeline & Milestones

```yaml
phase:
  id: 3
  name: "Timeline & Milestones"
  description: "Definiere Start, Ende und wichtige Zwischenmeilensteine"
  skippable: true
  questions:
    - id: "start_date"
      text: "Wann soll das Projekt starten?"
      type: "date"
      required: true
      parse_natural: true
      examples:
        - "nächsten Montag"
        - "2025-06-01"
        - "Mitte Juni"
        - "sofort"
        
    - id: "end_date"
      text: "Wann soll das Projekt abgeschlossen sein?"
      type: "date"
      required: true
      parse_natural: true
      examples:
        - "Ende Q2"
        - "2025-08-15"
        - "in 3 Monaten"
        
    - id: "milestones"
      text: "Welche wichtigen Zwischenmeilensteine gibt es?"
      type: "dynamic_list"
      required: false
      item_template:
        - id: "name"
          type: "freetext"
          placeholder: "Meilenstein Name"
        - id: "date"
          type: "date"
          required: false
          parse_natural: true
          placeholder: "Datum (optional)"
      add_button: "+ Meilenstein hinzufügen"
      min_items: 0
      max_items: 10
```

### Beispiel-Liste

```
Welche wichtigen Zwischenmeilensteine gibt es?

┌─────────────────────────────────────────────────────┐
│ 1. Discovery Phase                                  │
│    Datum: 2025-05-15                                │
├─────────────────────────────────────────────────────┤
│ 2. Design Approval                                  │
│    Datum: Ende Mai                                  │
├─────────────────────────────────────────────────────┤
│ 3. Beta Release                                    │
│    Datum: —                                        │
├─────────────────────────────────────────────────────┤
│ [+ Meilenstein hinzufügen]                          │
└─────────────────────────────────────────────────────┘
```

---

## Phase 4: Team & Roles

```yaml
phase:
  id: 4
  name: "Team & Roles"
  description: "Definiere Team-Mitglieder und Rollen"
  skippable: true
  questions:
    - id: "team_members"
      text: "Wer ist am Projekt beteiligt?"
      type: "basecamp_people_lookup"
      required: false
      source: "basecamp people list --json"
      fallback: "freetext"
      fallback_label: "Person hinzufügen (nicht in Basecamp):"
      
    - id: "roles_needed"
      text: "Welche Rollen brauchen wir?"
      type: "multiple_choice_checkbox"
      required: false
      options:
        - label: "Projektleitung"
          value: "project_lead"
        - label: "Entwicklung"
          value: "development"
        - label: "Design"
          value: "design"
        - label: "QA/Testing"
          value: "qa"
        - label: "Stakeholder/Product Owner"
          value: "stakeholder"
        - label: "Externe Dienstleister"
          value: "external"
        - label: "Andere"
          value: "other"
          freetext: true
          freetext_label: "Andere Rolle:"
          
    - id: "progress_reporting"
      text: "Soll regelmäßig über Fortschritt berichtet werden?"
      type: "yes_no"
      required: false
      default: true
      trigger: "creates_checkins"
```

### Basecamp People Lookup Flow

```
Wer ist am Projekt beteiligt?

[🔍 Basecamp Team durchsuchen...]

Verfügbare Personen:
┌────────────────────────────────────────────────────┐
│ 👤 Alice Müller         Projektleitung              │
│ 👤 Bob Schmidt         Entwicklung                 │
│ 👤 Carol Weber         Design                      │
│ 👤 Dave Fischer        QA                          │
└────────────────────────────────────────────────────┘

[✓] Alice Müller
[✓] Bob Schmidt
[ ] Carol Weber
[ ] Dave Fischer

[+ Person hinzufügen (nicht in Basecamp)]

oder manuell eingeben:
Anderer Name: ___________
```

---

## Phase 5: Communication Preferences

```yaml
phase:
  id: 5
  name: "Communication Preferences"
  description: "Definiere Kommunikationskanäle und -rhythmus"
  skippable: true
  questions:
    - id: "communication_channels"
      text: "Wie soll hauptsächlich kommuniziert werden?"
      type: "multiple_choice_checkbox"
      required: false
      options:
        - label: "Täglicher Standup"
          description: "Kurze tägliche Updates im Chat-Kanal"
          value: "daily_standup"
        - label: "Wöchentliches Sync-Meeting"
          description: "Regelmäßiges Meeting für Fortschritt und Blocker"
          value: "weekly_sync"
        - label: "Ad-hoc bei Bedarf"
          description: "Kommunikation nur wenn nötig"
          value: "ad_hoc"
        - label: "Async-First"
          description: "Primär Messages und Documents, seltene Meetings"
          value: "async_first"
        - label: "Video-Calls für Meetings"
          description: "Meetings per Video-Call statt vor Ort"
          value: "video_calls"
          
    - id: "escalation_mentions"
      text: "Sollen @mentions für Eskalation genutzt werden?"
      type: "yes_no"
      required: false
      default: true
      hint: "Bei @mention wird derjenige sofort benachrichtigt"
```

### UI-Darstellung

```
Wie soll hauptsächlich kommuniziert werden?
☐ Täglicher Standup (Chat-Kanal)
☑ Wöchentliches Sync-Meeting
☑ Async-First (primär Messages/Documents)
☐ Video-Calls für Meetings

Sollen @mentions für Eskalation genutzt werden?
[JA] Nein
```

---

## Phase 6: Tools & Workflows

```yaml
phase:
  id: 6
  name: "Tools & Workflows"
  description: "Wähle Basecamp-Tools und Workflow-Konfiguration"
  skippable: true
  questions:
    - id: "basecamp_tools"
      text: "Welche Basecamp-Tools sollen aktiv genutzt werden?"
      type: "multiple_choice_checkbox"
      required: false
      default_checked:
        - "message_board"
        - "todos"
        - "chat"
        - "checkins"
        - "documents"
      options:
        - label: "Message Board"
          description: "Kickoff-Nachrichten, Entscheidungen, Updates"
          value: "message_board"
        - label: "To-Dos"
          description: "Aufgaben und Meilensteine"
          value: "todos"
        - label: "Schedule"
          description: "Kalender-Events für Meilensteine"
          value: "schedule"
        - label: "Chat"
          description: "Kommunikation und Standups"
          value: "chat"
        - label: "Cards/Kanban"
          description: "Visuelles Task-Board (Alternative zu To-Dos)"
          value: "cards"
        - label: "Check-ins"
          description: "Automatische Abfragen zu Fortschritt"
          value: "checkins"
        - label: "Documents"
          description: "Specs, Referenzen, Entscheidungen"
          value: "documents"
        - label: "Gauges"
          description: "Fortschritts-Indikatoren"
          value: "gauges"
        - label: "Files"
          description: "Dateien und Anhänge"
          value: "files"
          
    - id: "progress_gauge"
      text: "Soll ein Gauge mit Fortschritts-Indikator erstellt werden?"
      type: "yes_no"
      required: false
      conditional_on: "basecamp_tools includes 'gauges'"
      default: false
```

### UI-Darstellung mit Vorauswahl

```
Welche Basecamp-Tools sollen aktiv genutzt werden?

☑ Message Board (Kickoff, Entscheidungen)
☑ To-Dos (Aufgaben, Meilensteine)
☐ Schedule (Kalender-Events)
☑ Chat (Kommunikation, Standups)
☐ Cards/Kanban (Alternative zu To-Dos)
☑ Check-ins (Automatische Abfragen)
☑ Documents (Specs, Referenzen)
☐ Gauges (Fortschritts-Tracking)
☐ Files (Dateien, Anhänge)

Soll ein Gauge mit Fortschritts-Indikator erstellt werden?
[Ja] Nein
```

---

## Phase 7: Risks & Dependencies

```yaml
phase:
  id: 7
  name: "Risks & Dependencies"
  description: "Identifiziere Risiken und Abhängigkeiten"
  skippable: true
  questions:
    - id: "known_risks"
      text: "Gibt es bekannte Risiken?"
      type: "freetext"
      required: false
      multiline: true
      placeholder: "z.B. Abhängigkeit von externem API, limitierte Testumgebung, kritische Abhängigkeit von Key Person"
      
    - id: "dependencies"
      text: "Welche Abhängigkeiten gibt es?"
      type: "freetext"
      required: false
      multiline: true
      placeholder: "z.B. Wartet auf Approval von Legal, Abhängig von Datenbank-Migration, Braucht Zugang zu Prod-System"
      
    - id: "external_stakeholders"
      text: "Wer sind externe Stakeholder?"
      type: "freetext"
      required: false
      multiline: true
      placeholder: "z.B. Externe Agentur für Design, Kunde für Feedback, Vendor für Integration"
```

---

## Phase 8: Review

```yaml
phase:
  id: 8
  name: "Review"
  description: "Zusammenfassung aller Antworten zur Bestätigung"
  skippable: false
  questions:
    - id: "summary"
      type: "review_summary"
      sections:
        - "vision_goals"
        - "success_criteria"
        - "timeline"
        - "team"
        - "communication"
        - "tools"
        - "risks"
      actions:
        - label: "Alles korrekt"
          value: "confirm"
          next: "create_project"
        - label: "Bearbeiten"
          value: "edit"
          next: "phase_picker"
```

### Review-Darstellung

```
═══════════════════════════════════════════════════════
                    PROJEKT-ZUSAMMENFASSUNG
═══════════════════════════════════════════════════════

📌 VISION & GOALS
   Ziel: Interne Dokumentation verbessern
   Problem: New Joiner brauchen zu lange zur Einarbeitung

🎯 SUCCESS CRITERIA
   ☑ Funktional fertig
   ☑ Zeitnah geliefert
   ☐ Qualitätsziele erreicht
   ☑ Stakeholder zufrieden
   KPI: 95% Adoption Rate nach Launch

📅 TIMELINE
   Start: 2025-06-01
   Ende: 2025-08-15 (11 Wochen)
   Meilensteine:
     • Discovery Phase — 2025-05-15
     • Design Approval — Ende Mai
     • Beta Release — (ohne Datum)

👥 TEAM
   Alice Müller (Projektleitung)
   Bob Schmidt (Entwicklung)
   Carol Weber (Design)
   
   Rollen: Projektleitung, Entwicklung, Design
   ✓ Regelmäßige Fortschrittsberichte

💬 KOMMUNIKATION
   Async-First, wöchentliche Sync-Meetings
   ✓ @mentions für Eskalation aktiviert

🛠 TOOLS (aktiviert)
   Message Board, To-Dos, Chat, Check-ins, Documents

⚠️ RISIKEN & ABHÄNGIGKEITEN
   Risiken: —
   Abhängigkeiten: Wartet auf Approval von Legal
   Externe Stakeholder: Kunde für Feedback

═══════════════════════════════════════════════════════

[ ✅ Alles korrekt — Projekt erstellen ]
[ ✏️ Zurück zu Phase: [Vision ▼] ]
```

---

## Nutzung im Skill Workflow

### Discovery Flow Integration

Der Discovery-Fragen-Katalog wird verwendet wenn:

1. **Kein Plan vorhanden** — User möchte Projekt von Grund auf definieren
2. **Vor dem Drafting** — Als strukturierter Einstieg vor dem eigentlichen Planning
3. **Ergänzung zu bestehendem Plan** — Falls wichtige Felder fehlen

### Flow-Integration

```
User: "Ich will ein neues Projekt in Basecamp erstellen"
  ↓
Skill: "Lass uns das Projekt gemeinsam definieren."
       "Wir gehen durch 8 kurze Phasen."
  ↓
[Phase 1-8 durchlaufen]
  ↓
Zusammenfassung anzeigen
  ↓
User bestätigt → Erstelle Projekt
User möchte ändern → Springe zur Phase
```

### Abspeichern der Answers

```python
# Struktur für gesammelte Answers
discovery_answers = {
    "project_goal": "...",
    "problem_solved": "...",
    "success_indicators": [...],
    "kpis": "...",
    "start_date": "2025-06-01",
    "end_date": "2025-08-15",
    "milestones": [
        {"name": "Discovery", "date": "2025-05-15"},
        {"name": "Design Approval", "date": "..."},
    ],
    "team_members": [
        {"id": "123", "name": "Alice Müller", "role": "project_lead"}
    ],
    "roles_needed": ["project_lead", "development", "design"],
    "progress_reporting": True,
    "communication_channels": ["async_first", "weekly_sync"],
    "escalation_mentions": True,
    "basecamp_tools": ["message_board", "todos", "chat", "checkins", "documents"],
    "progress_gauge": False,
    "known_risks": "...",
    "dependencies": "...",
    "external_stakeholders": "...",
}
```

### Mapping zu Basecamp Structure

| Discovery Field | Basecamp Creation |
|-----------------|-------------------|
| project_goal, problem_solved | Kickoff Message |
| start_date, end_date | Schedule (oder Project Description) |
| milestones | To-Do Lists + Schedule Entries |
| team_members | Project People |
| communication_channels | Chat Channel Topic + PM Setup |
| basecamp_tools | Aktiviert/Deaktiviert im Project |
| progress_gauge | Gauge Creation |
| known_risks, dependencies | Message Board Post |

---

## Natural Language Date Parsing

Der Skill unterstützt flexible Datumsangaben:

| Input | Parsed Output |
|-------|---------------|
| "nächsten Montag" | 2025-05-05 (wenn gerade April) |
| "Ende Q2" | 2025-06-30 |
| "Mitte Juni" | 2025-06-15 |
| "in 3 Wochen" | +21 Tage von heute |
| "2025-06-01" | 2025-06-01 |
| "sofort" | today's date |
| "ASAP" | today's date |

---

## Implementation Notes

1. **Jede Phase ist überspringbar** — User kann "Weiter" oder "Überspringen" sagen
2. **Multiple Choice mit Freitext-Fallback** — "Andere" öffnet Freitext-Eingabe
3. **Datum-Parsing** — Akzeptiere natürliche Sprache mit Fallback auf direkte Eingabe
4. **Basecamp People Lookup** — Nutze `basecamp people list --json` für Team-Auswahl
5. **Review-Phase ist Pflicht** — Zeigt Zusammenfassung vor Projekt-Erstellung
6. **Answers werden gesammelt** — Bis zur Bestätigung in Discovery-Objekt gespeichert