Internal Apps Ideation

December 24, 2025 ยท View on GitHub

This repository demonstrates a voice-to-implementation workflow โ€” a process for turning informal voice notes into structured specifications and implementation plans using AI tools.

Workflow Diagram

flowchart TD
    subgraph Input["๐Ÿ‘ค User"]
        A[๐ŸŽ™๏ธ Voice Note]
    end

    subgraph Processing["๐Ÿค– AI Processing"]
        B[๐Ÿ“ Raw Transcript]
        C[โœจ Cleaned Transcript]
        D[๐Ÿ“‹ Formal Spec]
        E[๐Ÿ—๏ธ Implementation Plan]
    end

    subgraph Output["๐Ÿ“„ Output"]
        F[PDF Report]
    end

    A -->|"Gemini MCP"| B
    B -->|"Gemini 2.5 Flash"| C
    C -->|"Claude Opus 4.5"| D
    D -->|"Claude Opus 4.5"| E
    E -->|"WeasyPrint"| F

    style A fill:#f0fdf4,stroke:#16a34a
    style B fill:#fffbeb,stroke:#f59e0b
    style C fill:#fffbeb,stroke:#f59e0b
    style D fill:#faf5ff,stroke:#7c3aed
    style E fill:#faf5ff,stroke:#7c3aed
    style F fill:#f0f9ff,stroke:#0284c7

Workflow Stages

Each stage of the workflow is preserved in this repository:

StageSourceToolFile
1. Voice NoteUserโ€”View
2. Raw TranscriptUserAI (Gemini Transcription MCP)View
3. Cleaned TranscriptUserAI (Gemini 2.5 Flash)View
4. Formal SpecificationAI (Claude Opus 4.5)AI (Claude Code)View
5. Implementation PlanAI (Claude Opus 4.5)AI (Claude Code)View

Final Output

The complete workflow โ€” from raw voice note to implementation plan โ€” is compiled into a single document:

๐Ÿ“„ View PDF


The Project Idea

The voice note explores building a unified "AI workspace" โ€” a shell/wrapper that bundles together small AI-powered utilities (whiteboard cleanup, end-of-day logging, etc.) with shared authentication and environment variables.

Tools Used

ToolPurpose
Gemini Transcription MCPVoice-to-text transcription
Gemini 2.5 FlashTranscript cleanup and formatting
Claude Code (Opus 4.5)Specification extraction and implementation planning
WeasyPrintPDF generation from HTML

Repository Structure

โ”œโ”€โ”€ input/
โ”‚   โ”œโ”€โ”€ notes.mp3                                       # Original voice recording
โ”‚   โ”œโ”€โ”€ voice-note-on-custom-ai-workflow-deployment.md  # Raw transcript
โ”‚   โ”œโ”€โ”€ workflow-ideas-for-ai-powered-productivity.md   # Cleaned transcript
โ”‚   โ””โ”€โ”€ SPEC.md                                         # Formal specification
โ”œโ”€โ”€ output/
โ”‚   โ”œโ”€โ”€ internal-tools-ideation-flow.pdf                # Final compiled document
โ”‚   โ”œโ”€โ”€ internal-tools-ideation-flow.html               # Source HTML
โ”‚   โ””โ”€โ”€ turns/                                          # Intermediate AI outputs
โ””โ”€โ”€ CLAUDE.md                                           # Project context