# Project State Manager

> Reads and updates the durable project state used to resume Fusion implementation workflows across sessions.

- Skill: `oracle/project-state-manager` (Agent Skill)
- Install (CLI): `npx get-skill add oracle/project-state-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oracle/project-state-manager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Oracle (https://skillmd.com/u/oracle)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/oracle/project-state-manager

---


# Project State Manager

## Purpose

Reads and updates the durable project state used to resume Fusion implementation workflows across sessions.

## When to Use

Use this skill whenever a router, shared, core, or pillar skill produces output that changes the current implementation objective, scope, sequence, baseline, decision, blueprint, validation, or report state.

## Inputs

- `project_state`
- `state_update`
- `skill_run`

## Outputs

- `updated_project_state`
- `state_change_summary`

## Implementation Notes

State updates must be deterministic and auditable. Record the skill run reference that caused each state transition so a future session can reconstruct how the project reached its current state.

Any activity that creates or updates files under `project/{project_id}` must log
token usage by default at:

```text
project/{project_id}/artifacts/shared/token-usage/current/token-usage-log.md
```

Use `core/project-mgmt/scripts/token_usage_logger.py` for repository scripts and
include the same estimate in the skill-run record when one is written. Estimates
are operational planning values, not billing-grade counts. Exclude secrets,
token-cache contents, and credential properties from token estimates.

