plan-cache-lookup

Look up cached plan templates by task signature during the plan phase.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/paulingham/.claude --skill plan-cache-lookup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-cache-lookup
Source: https://github.com/paulingham/.claude/tree/main/skills/plan-cache-lookup
Command: npx skills add https://github.com/paulingham/.claude --skill plan-cache-lookup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cache plan templates and route the pipeline accordingly, reducing repeated planning work by detecting existing cached plans for a given task signature.

Core Features & Use Cases

  • Look up cached plan templates using task_class, repo_hash, tier, and critical.
  • Emit MISS vs HIT signals to drive pipeline flow (recon/architect on MISS, adapter path on HIT).
  • Honor CLAUDE_PLAN_CACHE_MODE to control caching behavior and safety.

Quick Start

Invoke the plan-cache lookup with the current task_class, repo_hash, tier, and critical to determine if a cached plan exists.

Frequently Asked Questions about plan-cache-lookup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I skip redundant planning steps in a workflow automation pipeline?

A plan cache lookup finds cached templates for a task signature during the pipeline plan phase. It emits HIT or MISS signals to route the workflow, bypassing redundant planning when a matching template exists.

How do I cache and retrieve plan templates using a task signature?

You cache and retrieve plan templates by invoking the lookup with task_class, repo_hash, tier, and critical parameters. It computes a plan-cache-key from these values to locate any matching cached templates.

What happens when a cached plan template is missing during the plan phase?

When a cached plan template is missing, the lookup emits a MISS signal that drives the pipeline flow to fall through to the recon or architect path. This ensures a new plan is generated when no cache exists.

Do I need specific environment variables to control plan cache behavior?

Yes, you need CLAUDE_PLAN_CACHE_MODE and CLAUDE_PROJECT_HASH environment variables set. CLAUDE_PLAN_CACHE_MODE controls caching behavior and safety, while the project hash helps compute the repo-hash for template lookups.

How does a plan cache lookup integrate with an orchestrator during the plan phase?

The plan cache lookup integrates with an orchestrator by applying once per pipeline run during the plan phase. It uses state lookup helpers to evaluate task signatures and route the workflow based on cache hits or misses.