Where is the project state actually stored?

All state information is stored locally within your project directory at .framework-blueprints/00-project-state.json.

What specifically is tracked in a 'checkpoint'?

Checkpoints capture environment variables, port numbers, non-standard file paths, API quirks, and exact variable names to prevent AI hallucinations or architectural drift.

How does this skill solve Claude's context window limitations?

It implements a 'File-Based Memory' system, moving critical details from volatile chat memory to persistent JSON and Markdown files that are explicitly read before updates.

Can I resume a project after a long break?

Yes, the skill includes a Resume Process that reads the state file and checkpoint summaries to provide a full context refresh for Claude when you return.

Does it support backups of the project state?

Yes, the skill creates automatic backups during phase transitions, before destructive operations, and upon manual request to ensure data safety.

Project State Management

Name: Project State Management
Author: Ankurjain1121

byAnkurjain1121

0•

Productivity & Workflow

Persists and tracks project progress, architectural decisions, and critical technical details across Claude Code sessions to prevent context loss.

Project State Management is a specialized skill designed to solve the challenge of context drift and memory loss during long-running AI coding sessions. By implementing a robust file-based memory system, it ensures that Claude maintains a single source of truth for workflow phases, agent handoffs, and specific technical configurations like ports, environment variables, and non-standard paths. This skill provides a structured framework for checkpointing and state validation, allowing developers to pause and resume complex projects with total continuity and architectural alignment.

Key Features

01Persistent state tracking via a centralized .framework-blueprints JSON file

02Read-Modify-Write pattern to prevent accidental state overwrites

03Automated checkpointing protocol to mitigate AI context window compaction

04Critical detail registry for environment variables, ports, and API quirks

050 GitHub stars

06Automated session resumption with status summaries and validation

Use Cases

01Facilitating handoffs between different AI agents or development sessions

02Maintaining architectural consistency across long sessions where context might drift

03Managing complex multi-phase software development lifecycles with Claude Code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ankurjain1121/dev-workflow-skills project-state-management

For use in Claude.ai and ChatGPT

Download Skill