# Cog — Cognitive Architecture for Claude Code

> Cog gives Claude Code persistent memory, self-reflection, and foresight. It's a set of conventions — CLAUDE.md + memory/ + skills — that give Claude Code a persistent inner life. No server, no runtime, no dependencies. Everything is plain text.

Cog is not an application. It's a cognitive architecture: three-tier memory (hot/warm/glacier), memory consolidation, self-improving pipeline skills, and a Zettelkasten-inspired thread framework. Clone it, run /setup, start talking. Claude remembers what matters, learns from its mistakes, and anticipates what's coming next.

## Docs

- [Architecture](https://lab.puga.com.br/cog/#/architecture): How Cog works — interface-agnostic design, skills, domain registry, design principles
- [Memory](https://lab.puga.com.br/cog/#/memory): Three-tier memory system, memory consolidation, L0 headers, threads, wiki-links, SSOT
- [Cowork](https://lab.puga.com.br/cog/#/cowork): Using Cog with Claude Desktop's agentic mode
- [Pipeline Overview](https://lab.puga.com.br/cog/#/pipeline): Housekeeping, reflect, evolve, foresight — memory maintenance skills
- [Housekeeping](https://lab.puga.com.br/cog/#/pipeline/housekeeping): Archive, prune, link audit, glacier index
- [Reflect](https://lab.puga.com.br/cog/#/pipeline/reflect): Mine conversations, consolidate patterns, detect threads
- [Evolve](https://lab.puga.com.br/cog/#/pipeline/evolve): Audit architecture, propose rule changes
- [Foresight](https://lab.puga.com.br/cog/#/pipeline/foresight): Cross-domain strategic nudge
- [Scenarios](https://lab.puga.com.br/cog/#/pipeline/scenarios): Decision simulation with timeline overlay

## About

- [Why Text](https://lab.puga.com.br/cog/#/why-text): Why plain text over databases — observability, simplicity, the bet
- [Credits & Inspiration](https://lab.puga.com.br/cog/#/credits): RLM, A-MEM, OpenViking, Zettelkasten, Zep/Graphiti, Mem0

## Source

- [GitHub Repository](https://github.com/marciopuga/cog): Source code, CLAUDE.md, memory structure, skill definitions

## Optional

- [Development Journal](https://lab.puga.com.br/cog/#/journal): 21 entries documenting Cog's evolution from first boot to Unix toolbox orientation