Clueless AI Meeting Assistant Development Helper

This skill provides comprehensive guidance for working with Clueless, an AI-powered meeting assistant that provides real-time transcription, intelligent analysis, and action item extraction from conversations.

Project Context

Clueless is a single-user desktop application built with Laravel 12 (PHP 8.2+) backend, Vue 3 with TypeScript frontend, and NativePHP/Electron for desktop deployment. It uses OpenAI's Realtime API for voice conversations with a direct WebSocket architecture for optimal performance.

Tech Stack

Architecture Overview

Directory Structure

Key Architectural Patterns

1. **Inertia.js Integration**: SPA-like experience without API endpoints

2. **Direct WebSocket Architecture**: Frontend connects directly to OpenAI Realtime API for lower latency

3. **Dual Database Setup**: Two SQLite databases (default + nativephp)

4. **No Authentication**: Single-user desktop app

5. **Theme Support**: Dark/light mode via composables

6. **Service Architecture**: Business logic separated into service classes

Real-time Architecture

```

Frontend Audio Capture → Backend (ephemeral key generation) → Frontend → OpenAI (direct WebSocket)

```

**Key files**:

Instructions for AI Agent

When working with this codebase:

1. Development Workflow

**Running the application**:

```bash

Full development environment

composer dev

Desktop application mode

composer native:dev

Frontend only

npm run dev

```

**Code quality**:

```bash

Format code

npm run format

php artisan pint

Linting

npm run lint

```

**Testing**:

```bash

Run all tests

composer test

Specific test file

php artisan test tests/Feature/DashboardTest.php

Test types

php artisan test --testsuite=Unit

php artisan test --testsuite=Feature

```

2. Database Operations

**CRITICAL**: This application uses TWO databases. ALWAYS run migrations on BOTH:

```bash

Default database

php artisan migrate

NativePHP database (REQUIRED!)

php artisan migrate --database=nativephp

```

When debugging database issues, check both `database/database.sqlite` and `database/nativephp.sqlite`.

3. Creating New Features

**Adding a new page**:

1. Create Vue component in `/resources/js/pages/`

2. Add route in `/routes/web.php` returning `Inertia::render()`

3. Use TypeScript types from `@/types`

**Adding UI components**:

**Adding services**:

4. Working with Real-time Features

5. API Key Management

6. Environment Setup

```bash

Initial setup

cp .env.example .env

php artisan key:generate

touch database/database.sqlite

touch database/nativephp.sqlite

php artisan migrate

php artisan migrate --database=nativephp

```

Configure OpenAI API key either:

7. Documentation Access

**IMPORTANT**: Always use Context7 MCP tool for documentation, not web search. We're in 2025 and web results may be outdated.

Examples:

8. Code Standards

9. AI Team Specialists (Use When Available)

| Task | Specialist |

|------|------------|

| Laravel backend | @agent-laravel-backend-expert |

| Database/Eloquent | @agent-laravel-eloquent-expert |

| Vue components | @agent-vue-component-architect |

| State management | @agent-vue-state-manager |

| Styling/UI | @agent-tailwind-frontend-expert |

| API design | @agent-api-architect |

| Documentation | @agent-documentation-specialist |

| Code review | @agent-code-reviewer |

| Performance | @agent-performance-optimizer |

**YOU MUST USE subagents when available for the task.**

10. Important Constraints

11. Common Debugging Patterns

When investigating issues:

1. Check both SQLite databases

2. Review Laravel logs in `storage/logs/`

3. Check WebSocket connection status in browser DevTools

4. Verify OpenAI API key configuration

5. Ensure ephemeral keys are being generated correctly

6. Check audio capture permissions for desktop app

12. Build and Deployment

```bash

Build frontend

npm run build

Build with SSR

npm run build:ssr

Desktop app build (NativePHP)

composer native:dev

```

Key Configuration Files

Summary

When working with Clueless:

1. Always remember the dual database setup

2. Use direct WebSocket architecture for real-time features

3. Follow Inertia.js patterns for routing and pages

4. Leverage the UI component library for consistency

5. Use Context7 for up-to-date documentation

6. Delegate to specialist agents when available

7. Maintain code quality with Prettier, ESLint, and Pint

8. Test thoroughly with Pest PHP