Eys-55/ace-workflows / .agents/skills/review-project-state
review-project-state
VerifiedLoad 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.3 KB |
| agents/openai.yaml | config | 219 B |
SKILL.md
View on GitHub---
name: review-project-state
description: 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:
```text
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 119k | Updated | Claude CodeCodex | Verified | Install |
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |