Skip to content

Eys-55/ace-workflows / .agents/skills/review-project-state

review-project-state

Verified

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, or prepare to initiate or continue a task.

Review 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:

  1. Read root AGENTS.md.
  2. Read .agents/skills/initiate-task/SKILL.md.
  3. Read references/matt-pocock-skills.md.
  4. Read registry/agents-md.json.

Inputs

Require:

  • project:<slug>

If missing, ask for the project and stop.

Load Everything

Load, load, load, load, load.

  1. Read projects/<project-slug>/project.json.
  2. Read projects/<project-slug>/AGENTS.md.
  3. Read projects/<project-slug>/tasks/index.json.
  4. Query the registered project-instruction state through the read-only state helper when available.
  5. Query the project task list through the same helper when available.
  6. Read every task JSON listed in the index whose status is not done.
  7. Read recently completed task summaries from the index.
  8. 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.

planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall