> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metacogna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MetaCogna Suite Documentation

> Thinking About Thinking - Documentation for MetaCogna's cognitive tools, architectures, and agents

## Thinking About Thinking

MetaCogna builds systems that think about thinking. We are motivated by the quiet awe of the universe, the strange joy of discovering how things really behave, and the belief that better thinking leads to better outcomes.

<Card title="Explore on GitHub" icon="github" href="https://github.com/metacogna-lab" horizontal>
  View our source code, contribute, and explore the MetaCogna Suite repositories.
</Card>

## The MetaCogna Suite

A collection of cognitive tools, architectures, and agents designed to augment human reasoning through structured intelligence.

<CardGroup cols={2}>
  <Card title="Gateway API" icon="route" href="/gateway-api/overview">
    Central authentication and routing gateway for all MetaCogna services. JWT-based authentication and intelligent request proxying.
  </Card>

  <Card title="MetaCogna RAG" icon="brain" href="/metacogna-rag/overview">
    Retrieval-Augmented Generation system with knowledge graphs, document management, and multi-agent reasoning capabilities.
  </Card>

  <Card title="MetaCogna.ai Landing" icon="globe" href="/metacogna-ai-landing/overview">
    Marketing website and client portal showcasing MetaCogna's services and methodology.
  </Card>

  <Card title="Parti Architecture" icon="sitemap" href="/parti-architecture/overview">
    Prompt-driven architecture generation using AI agents to create complete system architectures from natural language descriptions.
  </Card>
</CardGroup>

## Design System

<Card title="Paper UI Design System" icon="palette" href="/design/system" horizontal>
  Digital Paper, Hard Edges, High Contrast. Documentation for our design system philosophy and component library.
</Card>

## Quick Navigation

<CardGroup cols={2}>
  <Card title="Get Started" icon="rocket" href="/quickstart">
    Begin working with the MetaCogna Suite. Installation, setup, and core concepts.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Complete API documentation with interactive examples and endpoint specifications.
  </Card>

  <Card title="Development Guide" icon="wrench" href="/development">
    Setup your local development environment and start contributing.
  </Card>

  <Card title="Design Guide" icon="brush" href="/design/guide">
    Writing guidelines, component usage, and design patterns for documentation.
  </Card>
</CardGroup>

## Philosophy

We treat thinking as a **system**, not a personality trait. MetaCogna Labs is intentionally small. That is not a limitation; it is a feature. It allows fast iteration without institutional drag, and lets ideas be tested before they harden into dogma.

Our systems operate on principles of:

* **Visible Construction** - Metadata, IDs, and technical details are visible UI elements
* **Hard Edges** - Minimal border radius, clear boundaries, defined structures
* **High Contrast** - Strict polarity between concepts, clear hierarchies
* **Multi-Agent Coordination** - Specialized agents that critique, synthesize, and build upon ideas

## Core Concepts

### Systems Architecture

MetaCogna systems are built on Cloudflare Workers, using:

* **JWT Authentication** - Secure token-based access control
* **Service Bindings** - Secure inter-worker communication
* **R2 Storage** - Object storage for documents and assets
* **D1 Databases** - Serverless SQLite for structured data
* **Vectorize** - Vector databases for semantic search

### Cognitive Augmentation

Our tools enhance reasoning through:

* **RAG (Retrieval-Augmented Generation)** - Context-aware responses from knowledge bases
* **Knowledge Graphs** - Entity and relationship extraction
* **Multi-Agent Systems** - Coordinated, specialized agents with distinct roles
* **Metacognitive Simulation** - Systems that think about their own thinking processes

## Resources

<CardGroup cols={3}>
  <Card title="GitHub" icon="github" href="https://github.com/metacogna-lab">
    Source code and repositories
  </Card>

  <Card title="Website" icon="globe" href="https://metacogna.ai">
    Learn more about MetaCogna Labs
  </Card>

  <Card title="Documentation" icon="book" href="/quickstart">
    Get started with our documentation
  </Card>
</CardGroup>

<Note>
  **New to MetaCogna?** Start with the [Quickstart Guide](/quickstart) to understand our architecture and begin working with the suite. For API integration, see the [Gateway API Overview](/gateway-api/overview) or [API Reference](/api-reference/introduction).
</Note>