flowchart TD
    subgraph feature ["Feature Definition Structure"]
        F[feature.md<br/>Core definition]
        M[mvp.md<br/>MVP scope & phases]
        P0[phase_0.md<br/>Foundation]
        P1[phase_1.md<br/>Enhancement]
        P2[phase_2.md<br/>Advanced]
        N[nice_to_have.md<br/>Future ideas]
        O[out_of_scope.md<br/>Explicit exclusions]
    end

    F --> M
    M --> P0
    M --> P1
    M --> P2
    M -.-> N
    F --> O

docs/definitions/features/
├── global_search/
│   ├── feature.md              # Core feature definition
│   ├── mvp.md                  # MVP scope and phase inclusion
│   ├── phase_0.md              # Phase 0: Foundation/Core
│   ├── phase_1.md              # Phase 1: Enhanced
│   ├── phase_2.md              # Phase 2: Advanced
│   ├── nice_to_have.md         # Future enhancements
│   ├── out_of_scope.md         # Explicit exclusions
│   ├── dependencies.md         # Technical dependencies
│   ├── user_stories.md         # User stories (optional)
│   ├── wireframes/             # Visual designs (optional)
│   │   ├── search_modal.png
│   │   └── results_list.png
│   ├── .version
│   ├── .approved
│   └── .approved_by_product
│
├── user_authentication/
│   ├── feature.md
│   ├── mvp.md
│   ├── phase_0.md
│   ├── phase_1.md
│   ├── out_of_scope.md
│   └── .version
│
└── campaign_manager/
    ├── feature.md
    ├── mvp.md
    ├── phase_0.md
    ├── phase_1.md
    ├── phase_2.md
    ├── phase_3.md
    ├── nice_to_have.md
    ├── out_of_scope.md
    └── .version

flowchart LR
    subgraph lifecycle ["Feature Definition Lifecycle"]
        D[draft] --> R[review]
        R --> A[approved]
        R --> REJ[rejected]
        REJ --> D
        A --> IP[in_progress]
        IP --> DONE[completed]
        A --> DEP[deprecated]
    end

    style D fill:#fef3c7
    style R fill:#e0e7ff
    style A fill:#d1fae5
    style REJ fill:#fecaca
    style IP fill:#dbeafe
    style DONE fill:#a7f3d0
    style DEP fill:#e5e7eb

{feature_slug}/
├── feature.md
├── mvp.md
├── phase_0.md
├── .version
└── .draft

{feature_slug}/
├── feature.md
├── mvp.md
├── phase_0.md
├── phase_1.md
├── .version
├── .approved
└── .approved_by_product

{feature_slug}/
├── feature.md
├── mvp.md
├── phase_0.md
├── phase_1.md
├── .version
├── .approved
├── .in_progress
├── .current_phase              # Content: "0" or "1" etc.
└── .implementation_started_at

{feature_slug}/
├── feature.md
├── mvp.md
├── phase_0.md
├── phase_1.md
├── .version
├── .approved
├── .completed
├── .completed_at
└── .verified

undefined

---

undefined

undefined

undefined

---

undefined

// front/services/search-index.ts
interface SearchIndexService {
  initialize(): Promise<void>;
  search(query: string): SearchResult[];
  addDocument(doc: Searchable): void;
  removeDocument(id: string): void;
}

// front/components/features/GlobalSearchModal.tsx
interface GlobalSearchModalProps {
  isOpen: boolean;
  onClose: () => void;
  onSelect: (result: SearchResult) => void;
}

flowchart TD
    subgraph init ["Initialization"]
        A[App boots] --> B[SearchIndexService.initialize]
        B --> C[Fetch all content]
        C --> D[Build MiniSearch index]
    end

    subgraph search ["Search Flow"]
        E[User types] --> F[SearchIndexService.search]
        F --> G[MiniSearch query]
        G --> H[Return ranked results]
    end

    subgraph select ["Selection Flow"]
        I[User clicks result] --> J[onSelect callback]
        J --> K[Router navigation]
        K --> L[Modal closes]
    end

---

undefined

stateDiagram-v2
    [*] --> Closed
    Closed --> Open: Ctrl+K
    Open --> Searching: User types
    Searching --> Results: Search complete
    Searching --> NoResults: No matches
    Searching --> Error: Search failed
    Results --> Selected: Arrow key
    Selected --> Results: Arrow key
    Selected --> Navigating: Enter
    Navigating --> Closed: Navigation complete
    Open --> Closed: Escape
    Results --> Closed: Escape
    NoResults --> Closed: Escape
    Error --> Searching: Retry

---

undefined

---

undefined

---

undefined

---

undefined

undefined

undefined

---

flowchart TD
    A[Feature idea] --> B[Create feature folder]
    B --> C[Write feature.md]
    C --> D[Write mvp.md with DoD]
    D --> E[Write phase_0.md]
    E --> F[Write out_of_scope.md]
    F --> G[Add .draft signal]
    G --> H{Review meeting}
    H -->|Approved| I[Add .approved signal]
    H -->|Changes needed| C
    I --> J[Create tasks from phases]
    J --> K[Implement Phase 0]
    K --> L[Verify Phase 0]
    L --> M[Implement Phase 1]
    M --> N[Verify Phase 1]
    N --> O[MVP Verification]
    O --> P[Add .completed signal]

mkdir -p docs/definitions/features/{feature_slug}

echo '{"schema": "1.0", "created": "'$(date -Iseconds)'"}' > .version
touch .draft

rm .draft
touch .ready_for_review

rm .ready_for_review
touch .approved
touch .approved_by_product