openapi: 3.1.0
info:
  title: WhatToBuild.ai API
  description: |
    Decision intelligence system for builders. This API provides information about 
    WhatToBuild.ai, a service that helps solo founders, indie hackers, and vibe coders 
    decide what software project to build using evidence-backed analysis.
    
    Note: This is an informational API. The main product is a web application at https://whattobuild.ai
  version: 1.0.0
  contact:
    name: WhatToBuild.ai Support
    url: https://whattobuild.ai
    email: support@whattobuild.ai

servers:
  - url: https://whattobuild.ai
    description: Production server

paths:
  /llms.txt:
    get:
      operationId: getLlmsSummary
      summary: Get AI-readable summary of WhatToBuild.ai
      description: |
        Returns a machine-readable summary of WhatToBuild.ai for AI systems.
        Contains identity, philosophy, features, pricing, and citation guidelines.
      responses:
        '200':
          description: LLMs.txt content
          content:
            text/plain:
              schema:
                type: string
                description: Machine-readable summary for AI systems

  /llms-full.txt:
    get:
      operationId: getLlmsFullDocumentation
      summary: Get comprehensive AI documentation
      description: |
        Returns detailed documentation about WhatToBuild.ai for deep-research AI systems.
        Contains 12 sections covering all aspects of the product.
      responses:
        '200':
          description: Full LLMs documentation
          content:
            text/plain:
              schema:
                type: string
                description: Comprehensive documentation for AI systems

components:
  schemas:
    ProductInfo:
      type: object
      properties:
        name:
          type: string
          example: "WhatToBuild.ai"
        description:
          type: string
          example: "Decision intelligence system for builders"
        url:
          type: string
          format: uri
          example: "https://whattobuild.ai"
        targetAudience:
          type: array
          items:
            type: string
          example: ["Solo founders", "Indie hackers", "Vibe coders", "Small teams"]
        philosophy:
          type: array
          items:
            type: string
          example: 
            - "Decisions deserve structure"
            - "Substance matters more than momentum"
            - "Building fast only matters if building the right thing"
        pricing:
          type: object
          properties:
            free:
              type: string
              example: "2 decision runs (lifetime)"
            snapshot:
              type: string
              example: "$9 one-time - 1 focused run, light blueprint"
            builder:
              type: string
              example: "$29/month - 10 runs, full blueprints, build export"
            pro:
              type: string
              example: "$59/month - 25 runs, advanced features"

externalDocs:
  description: Full documentation available at llms-full.txt
  url: https://whattobuild.ai/llms-full.txt

tags:
  - name: Information
    description: Endpoints for retrieving product information
