Claude Cognitive

BEWARE Frenyermmlmmk/claude-cognitive is not an authorized distribution channel

Claude Cognitive
Working memory for Claude Code — persistent context and multi-instance coordination

The Problem

Claude Code is powerful but stateless. Every new instance:
- Rediscovers your codebase from scratch
- Hallucinates integrations that don't exist
- Repeats debugging you already tried
- Burns tokens re-reading unchanged files

With large codebases (50k+ lines), this becomes painful fast.

The Solution

Claude Cognitive gives Claude Code working memory through two complementary systems:

1. Context Router
Attention-based file injection with cognitive dynamics:
- HOT (>0.8): Full file injection - active development
- WARM (0.25-0.8): Headers only - background awareness
- COLD ( Note: The repo contains a .claude-dev/ directory for development/dogfooding purposes only. Do not copy this to your projects—it's not part of the user-facing installation. Use your own project-local .claude/ directory instead (see step 2).

2. Initialize Your Project

3. Set Instance ID

4. Verify It's Working

5. Create Keywords Config (Required)

Create .claude/keywords.json in your project root:

Edit to match your project's documentation files and relevant keywords.

Full setup guide: SETUP.md
Customization guide: CUSTOMIZATION.md

Project Configuration

Create .claude/keywords.json in your project root to define project-specific keywords:

Keywords: Map documentation files to trigger words. When any keyword appears in your prompt (case-insensitive), the file becomes HOT.

Co-activation: When a file activates, related files get a score boost.

Pinned: Files that should always be at least WARM.

The router checks for config in this order:
1. .claude/keywords.json (project-local)
2.…