What is faber-state used for?

It provides a standardized way to manage the state of FABER workflows, tracking progress across different phases like framing, architecting, building, and evaluating.

How does it handle file corruption?

The skill uses atomic writes to ensure state files are preserved and never partially written, maintaining data integrity during frequent updates.

Where is the state data stored?

State is stored locally within the .fractary/plugins/faber/ directory, organized by specific run IDs to prevent data collision between different tasks.

Does this skill make decisions about my code?

No, faber-state is a focused utility for state management only. It records what happens but does not make decisions about workflow logic or code implementation.

Can I resume a workflow after an error?

Yes, by using the update-step-progress operation, the skill tracks exactly which steps were completed, allowing the agent to resume from the exact position of failure.

Faber Workflow State Manager

Name: Faber Workflow State Manager
Author: fractary

$fractary$ byfractary

•

Productivity & Workflow

Manages persistent workflow state for the FABER automation framework through structured CRUD operations and atomic file updates.

Faber State is a specialized utility designed to handle the state management lifecycle of FABER workflows within Claude Code. It ensures deterministic tracking of complex automation tasks by managing phase transitions, step-level progress, artifact recording, and error logging in a structured JSON format. By providing atomic writes and per-run directory management, it enables reliable workflow resumes, precise debugging, and consistent state synchronization across the entire developer automation pipeline, ensuring that long-running agents maintain a clear source of truth for their current context.

Key Features

012 GitHub stars

02Detailed tracking of phases, steps, and artifacts like specs and PRs

03Atomic state writes to prevent data corruption during updates

04Deterministic CRUD operations for workflow state files

05Native support for per-run isolation and legacy state structures

06Exact-step resume capabilities for long-running automation tasks

Use Cases

01Resuming interrupted developer workflows from the exact point of failure

02Tracking the lifecycle of automated coding tasks from framing to release

03Managing artifacts and metadata across multi-phase automation pipelines

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fractary/claude-plugins faber-state

For use in Claude.ai and ChatGPT

Download Skill