cache-expert

Covers Dagger Engine caching internals including cache key derivation, invalidation, and the immutable DAG model. Use when debugging cache misses, unexpected invalidations, or implementing caching-related engine features.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/cache-expert

SKILL.md

Cache Expert

High-Level Architecture

The Dagger Engine serves a GraphQL-based API for building and executing DAG workflows.

Each operation takes immutable objects/scalar values as inputs and produces an immutable object/scalar value as output. "Mutability" is simulated as a DAG of these operations on immutable values, similar to functional programming.

This enables caching: since inputs are immutable and operations are deterministic, cache keys can be derived from the operation and its inputs.

DAGs of operations can be serialized as IDs, which have associated digests that serve as the operations' cache keys.

Quick Reference

Jump to the right doc for your task:

Task	Read
Understand how IDs encode operations	ids.md
Understand the GraphQL server implementation	dagql-api-server.md
Understand how results are cached	cache-storage.md
Debug a cache miss	debugging.md

Core References

To build deep experitise, read these in order:

ids.md - How IDs encode operations and derive digests
dagql-api-server.md - The dagql GraphQL server implementation
cache-storage.md - How dagql results are cached

Optional References

Load on-demand for specific tasks:

debugging.md - Techniques for diagnosing cache misses and unexpected invalidations