review-project-state
Load and review the complete JSON state for a workflow project before task work. Use when the user asks to review project state, inspect active tasks, see blocked or in-progress work, check conflicts,
SKILL.md.agents/skills/review-project-state/SKILL.md
GitHubReview Project State
Use this skill to inspect a workflow project before task work. This is the project dashboard: load everything before recommending or editing anything. Use it as mandatory preflight when a project already exists, the task is risky, or the next action could conflict with unfinished work.
Skill-First Runtime Rule
Follow root AGENTS.md: this foundry operates through skill-first workflow
surfaces for Codex and other agent runtimes. Query helpers may be used to inspect
JSON state, but they do not replace $skill-name task flow.
Required Reading
Before acting:
- Read root
AGENTS.md. - Read
.agents/skills/initiate-task/SKILL.md. - Read
references/matt-pocock-skills.md. - Read
registry/agents-md.json.
Inputs
Require:
project:<slug>
If missing, ask for the project and stop.
Load Everything
Load, load, load, load, load.
- Read
projects/<project-slug>/project.json. - Read
projects/<project-slug>/AGENTS.md. - Read
projects/<project-slug>/tasks/index.json. - Query the registered project-instruction state through the read-only state helper when available.
- Query the project task list through the same helper when available.
- Read every task JSON listed in the index whose status is not
done. - Read recently completed task summaries from the index.
- Check missing task files, invalid states, dependency conflicts, stale linked artifacts, and tasks in the same Matt phase.
Output Contract
Report:
PROJECT
- slug
- project_state
- goal / domain
- ECC concepts applied
- registered AGENTS.md path
TASK STATE
- active
- blocked
- in-progress
- todo
- tracker-maintenance
- recently completed
CONFLICTS
- dependency conflicts
- related task conflicts
- missing artifacts or task files
- unregistered or misplaced AGENTS.md files
NEXT SAFE ACTION
- one exact skill: $initiate-task, $continue-task, $setup-workflow-project,
or a tracker-state fix
Do not edit project state from this skill unless the user explicitly asks for a fix after reviewing the report.