What is the benefit of the TOON format over JSON?

TOON (Token-Optimized Object Notation) is designed specifically for AI models to read more data with fewer tokens. In Aura Frog, it results in a 73% reduction in state-related token costs.

Can I use this for non-TDD projects?

Yes, while it excels in structured TDD workflows, its state-saving and context-persistence features can be applied to any complex development task in Claude Code.

How does the session handoff work?

The skill generates a structured markdown document and TOON state files that describe the current task, completed steps, and next actions, allowing Claude to resume exactly where it left off.

Where are the state files stored?

State is stored locally in your project's .claude/ directory, ensuring that your workflow history and project conventions remain within your codebase.

Aura Frog State Persistence

Name: Aura Frog State Persistence
Author: nguyenthienthanh

bynguyenthienthanh

•

生产力与工作流

Manages development workflow state and session handoffs using token-efficient TOON formatting to ensure project continuity.

关于

Aura Frog State Persistence is a specialized capability for Claude Code designed to overcome context window limitations and enable long-running development tasks. By saving session context, architectural decisions, and TDD workflow progress into the optimized TOON format, it reduces token consumption by up to 73% compared to JSON. This skill allows developers to pause, restart, or hand off complex coding tasks without losing critical project conventions or progress, making it essential for structured, multi-session AI development.

主要功能

Local project context and convention management
1 GitHub stars
Multi-phase TDD workflow tracking and persistence
Automated session handoff document generation
Real-time token usage monitoring and handoff alerts
Token-efficient TOON format for state storage

使用场景

Resuming complex feature development after a session restart or context reset
Maintaining strict architectural consistency across a multi-day coding project
Handing off tasks between different developers or AI instances while maintaining context

关于

主要功能

Local project context and convention management
1 GitHub stars
Multi-phase TDD workflow tracking and persistence
Automated session handoff document generation
Real-time token usage monitoring and handoff alerts
Token-efficient TOON format for state storage

使用场景

Resuming complex feature development after a session restart or context reset
Maintaining strict architectural consistency across a multi-day coding project
Handing off tasks between different developers or AI instances while maintaining context