| name | flame-harness-status |
| description | Show the current flame-harness pipeline state — phase, round, scores — read-only. |
| argument-hint | |
| allowed-tools | ["Read","Bash","Glob"] |
flame-harness-status
Read-only status reporter for the flutter-flame-harness pipeline. Reads state.md,
build-log.md, and pipeline-log.md and prints a summary of the current pipeline state.
All file schemas (state.md, build-log.md, pipeline-log.md) are defined in
docs/harness-protocol.md — refer to that document as the single source of truth.
Do not redefine schemas here.
This skill is strictly read-only. It must never modify state.md or any other harness file.
Input
Locate docs/harness/state.md relative to the current project root (the directory that contains
docs/harness/). If state.md does not exist, print:
flame-harness-status: no active pipeline found (docs/harness/state.md missing).
Run /flame-harness <idea> to start a new pipeline.
Then exit without error.
Procedure
1. Read state.md
Read docs/harness/state.md and extract the following fields per the schema in
docs/harness-protocol.md §2:
status — running | paused | completed
current_phase — name of the currently executing phase
current_round — integer round counter
next_role — skill role that runs next
pause_reason — "" | rate_limit | manual_action | error
updated_at — ISO-8601 timestamp of last write
resume_attempts — integer
2. Read build-log.md (if present)
Read docs/harness/build-log.md per the schema in docs/harness-protocol.md §6. Extract the
latest row to obtain the most recent QA score (PASS | FAIL | PARTIAL) and the round number
it corresponds to. If the file is absent or has no data rows, set latest_score to —.
3. Read pipeline-log.md (if present)
Read docs/harness/pipeline-log.md per the schema in docs/harness-protocol.md §6. Extract the
last 3 rows to give a recent event summary. If the file is absent or empty, skip.
4. Print status report
Print the following formatted report (adapt spacing for readability):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
flame-harness pipeline status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Status : <status>
Current phase : <current_phase>
Round : <current_round>
Next role : <next_role>
Latest QA : <latest_score>
Last updated : <updated_at>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
If status is paused, append:
⚠ Paused — reason: <pause_reason>
Resume attempts: <resume_attempts>
Run /flame-harness --resume (or /flame-harness-resume) to continue.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
If status is completed, append:
Pipeline completed successfully.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
If there are recent pipeline-log rows, append:
Recent events:
<time> <event> <phase> <details>
<time> <event> <phase> <details>
<time> <event> <phase> <details>
Constraints
- Read-only: this skill must never call
Write, Edit, or any Bash command that modifies a
file. It reads state.md, build-log.md, and pipeline-log.md only.
- Do not modify
state.md under any circumstances, including error paths.
- If any file is unreadable, skip it silently and note "(unavailable)" in the report.