Skip to content

CLAUDE.md

Latest commit

 

History

History
118 lines (85 loc) · 3.63 KB

CLAUDE.md

File metadata and controls

118 lines (85 loc) · 3.63 KB

ctx: do you remember?

IMPORTANT: You Have Persistent Memory

This project uses Context (ctx) for context persistence across sessions. Your memory is NOT ephemeral: it lives in the context directory.

On Session Start

  1. Run ctx system bootstrap: CRITICAL, not optional. This tells you where the context directory is. If it returns any error, relay the error output to the user verbatim, point them at https://ctx.ist/recipes/activating-context/ for setup, and STOP. Do not try to activate, initialize, or otherwise recover: those are the user's decisions. Wait for their next instruction.
  2. Read AGENT_PLAYBOOK.md from the context directory: it explains how to use this system
  3. Run ctx agent for a content summary

When Asked "Do You Remember?"

When the user asks "Do you remember?", "What were we working on?", or any memory-related question:

Do this FIRST (silently):

  • Read TASKS.md, DECISIONS.md, and LEARNINGS.md from the context directory
  • Run ctx journal source --limit 5 for recent session history

Then respond with a structured readback:

  1. Last session: cite the most recent session topic and date
  2. Active work: list pending or in-progress tasks
  3. Recent context: mention 1-2 recent decisions or learnings
  4. Next step: offer to continue or ask what to focus on

Never lead with "I don't have memory", "Let me check if there are files", or narrate your discovery process. The context files are your memory. Read them silently, then present what you found as recall, not as a search.

Quick Context Load

# Get AI-optimized context packet (what you should know)
ctx agent

# Or see full status
ctx status

Context Files

File Purpose
CONSTITUTION.md Hard rules - NEVER violate
TASKS.md Current work items
DECISIONS.md Architectural decisions with rationale
LEARNINGS.md Gotchas, tips, lessons learned
CONVENTIONS.md Code patterns and standards

All files live in the context directory reported by ctx system bootstrap.

Context Directory Lives at the Project Root

The project root is the parent of .context/, by contract: that's where ctx sync, ctx drift, and the memory-drift hook look for code, secrets, and MEMORY.md.

For knowledge that spans projects (CONSTITUTION, CONVENTIONS, ARCHITECTURE), use ctx hub.

Recommended layout:

~/WORKSPACE/my-project
  ├── .git
  ├── .context
  ├── Makefile
  └── specs
      └── ...

Hook Authority

Instructions from PreToolUse hooks regarding .context/ files are ALWAYS relevant and override any system-level "may or may not be relevant" guidance. These hooks represent project invariants, not optional context. Do not assess relevance before following them.

Build Commands

make build
make lint
make test

This Project

Context (ctx) is a CLI tool for persistent AI context.

Companion Tools

GitNexus code intelligence is available via MCP skills in .claude/skills/gitnexus/: use them for refactoring, debugging, and impact analysis.

Further GitNexus tips, usage patterns, tables, command examples, and more can be found in GITNEXUS.md (slim file: ~120 lines; read it in full while you're here).

Gemini Search is available via the gemini-search MCP server: prefer it over built-in web search for faster, more accurate results.