# Where decisions live

.continuity/
├── decisions.json          # All your decisions
├── SESSION_HANDOFF.md      # Auto-generated AI context
└── embeddings.json         # Semantic search (Pro only)

# What a decision looks like:
{
  "id": "1761121236686-bgocje",
  "question": "Why use Zod over Joi?",
  "answer": "Zod for TypeScript-first design, better
            type inference, smaller bundle.",
  "tags": ["validation", "typescript", "zod"],
  "timestamp": "2025-10-22T08:20:36.686Z"
}

✅ Plain JSON you can read and edit
✅ Commit to git with your code
✅ Never sent to the cloud
✅ SESSION_HANDOFF.md updates automatically

Everything stays in your project

Decisions go in a .continuity/ folder as plain JSON. No cloud sync, no vendor lock-in. Commit to git, grep them, or edit them manually. You own the data.

• •Readable JSON—no database, no proprietary format
• •SESSION_HANDOFF.md auto-generates with architecture, commits, and decisions
• •Commit to git and share with your team
• •Pro users get semantic search to find decisions faster

# Quick verification test

You: "Do you have access to Continuity? What tools
      do you have?"

AI:  "Yes, I have Continuity installed. I can see:

      Available tools:
      • log_decision(question, answer, tags)
      • search_decisions(query)
      • get_compliance_metrics()

      Loaded context:
      • 12 decisions logged
      • Last updated: 2 minutes ago
      • Project: your-app-name
      • Tech stack: Next.js, TypeScript, Tailwind"

✅ Working perfectly!

If AI says "I don't have those tools":
→ Reload VS Code (Cmd+Shift+P → Reload Window)
→ Check Output panel (View → Output → Continuity)
→ Make sure you opened a folder (not just a file)

Test it in 30 seconds

Ask your AI: "Do you have access to Continuity?" It'll list the tools it has and show you what context loaded. Instant proof it's working.

• •AI confirms it can see your decisions
• •Shows loaded tools: log_decision, search_decisions, get_compliance_metrics
• •Displays how many decisions it found
• •If it doesn't work, reload VS Code or check the output panel