← All craftbooks

Monthly Recording Review

Media: audio and videoevalv1.0.0released 2026-06-05workflow: build-loop

Sit with the month's recordings the way a teacher would: compare each against last month's marks, hear the progress your own ears stopped noticing, and pick next month's one focus — proof over impression, once a month. Locks the review criteria FIRST (every recording assessed, deltas versus last month, exactly one focus), then assesses each recording with evidence, then writes the month's review. Use for monthly practice reviews, listening back to recordings, progress checks, and 'how did this month go'.

Steps

Entry step: scope. Each step names the specialist role it wants; the full working prompt is expandable.

  1. Scope the reviewcoachentry

    recording inventory, comparison baseline, review rules

    Show working prompt
    Frame the review before listening back. Step 1: read recordings/index.json from the workspace — the month's recordings with their dates and pieces — and the previous month's review from the reviews folder if one exists. Step 2: confirm the comparison baseline with the owner: last month's marks per piece, and what last month's single focus was. Step 3: lock the review rules — every recording in the index gets assessed; every assessment names concrete observations (tempo held, voicing, rushing at a named spot — things a teacher would point at); each piece gets a delta versus last month; and the review ends with exactly ONE next-month focus. Step 4: write the acceptance-criteria checklist from those rules, call write_task_note with the recording count + baseline, and write notes/scope.md.
  2. Assess each recordingreviewer

    per-recording assessment with concrete observations

    Show working prompt
    Assess each recording the way a teacher would. Step 1: for every recording in the index, work through its notes and the piece's history — what is concretely better, steadier, or cleaner than last month, and what regressed or plateaued. Step 2: name the evidence per observation — the passage, the tempo, the habit — never a bare 'sounds better'. Step 3: check last month's focus: did the month's work actually move it? Say so plainly. Step 4: write the per-recording assessments to notes/review.md and call write_task_note with the biggest improvement and the biggest concern.
  3. Write the month's reviewcopywriter

    deltas per piece, verdict on last month's focus, one next focus

    Show working prompt
    Write the month's review from the assessments. Step 1: open with what the month proved — the progress the owner's own ears stopped noticing, with the recording that shows it. Step 2: per piece, the delta versus last month in a line or two, honest in both directions. Step 3: the verdict on last month's focus — moved, stalled, or abandoned. Step 4: close with exactly one next-month focus, chosen from the evidence, with why this one and not the runner-up. Step 5: warm, specific, and honest — proof over impression. Write report.md and call write_task_note with the focus chosen.
  4. Evaluatereviewer

    Grade the deliverable against every acceptance criterion. All pass → finish; any fail → loop back and fix the gap.

    Show working prompt
    Open report.md and notes/review.md and verify every criterion from notes/scope.md: every recording in recordings/index.json is assessed (count them), every assessment carries concrete observations with evidence, every piece has a last-month delta, last month's focus gets an explicit verdict, and exactly one next-month focus is named — not two, not zero. Write PASS/FAIL per criterion; on any failure, name the gap and loop back to report.
    
    Then route — this is the whole point of the loop:
    
    - **Every criterion PASSES →** call `advance_task_step({ ref, stepId: "evaluate", next: "finish" })`.
    - **Any criterion FAILS →** write the specific gaps to notes, then call `advance_task_step({ ref, stepId: "evaluate", next: "report" })` to loop back. The builder fixes exactly those gaps.
    
    Never route to `finish` while any criterion is unmet. The build phase's completion gate already blocked a grossly-incomplete deliverable; your job is the judgment an automated check cannot make (does it actually work, read well, look right). After ~3 unproductive loops, stop and report DONE_WITH_CONCERNS so the user can step in.
  5. Finishdeveloper

    All acceptance criteria met. Stamp a short summary and report DONE.

    Show working prompt
    Every acceptance criterion passed. Write a one-paragraph DONE summary to task notes via `write_task_note`: what was built, the deliverable path(s), and a one-line confirmation that each criterion is met. Then report DONE.

Triggers

Phrases that suggest this craftbook to a crew.

Source

View this craftbook on GitHub · MIT license