tjdrhs90/flutter-flame-harness/flame-harness-status

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.