Pool Protocol Technical Specification

December 31, 2025 ยท View on GitHub

Status: Coming soon based on beta feedback

This reference will provide the technical specification for the instance pool protocol.

Placeholder Topics

We plan to document:

  • JSONL entry schema (complete specification)
  • Relevance scoring algorithm (exact formula)
  • TTL enforcement rules
  • Deduplication strategy
  • Concurrency guarantees
  • File format versioning
  • Error handling specifications
  • Hook integration contract

Current Implementation

See working code in:

  • ~/.claude/scripts/pool-loader.py
  • ~/.claude/scripts/pool-extractor.py
  • ~/.claude/scripts/pool-query.py

Help Shape This Spec

What technical details do you need?

  • Writing custom pool tools?
  • Integrating with other systems?
  • Need formal schema validation?
  • Want protocol extensions?

Discuss in: GitHub Discussions

For now, see: