---
name: blueprint-polish-report
description: "Report what was polished, what was checked, and what was left as it was."
---

# Report

Write `.blueprint/polish-report.md` for the person, in their language and in plain words:

- `## 整えたもの` / `## What was polished` — every polished file, with how many findings it had before and
  after, and one line on the kind of change. The check looks for each file's path.
- `## 確かめたこと` / `## What was checked` — for every polished file, the headings, the structure's
  addresses, code blocks and link targets are unchanged, and chaff reports nothing under the style. The
  originals are in `.blueprint/originals/`; in a git repository, `git diff` shows every change.
- `## 直さずに残したもの` / `## Left as it was` — skipped files and why; every finding set aside
  (`dismissed`), **one line each**, giving the file, the rule, the line number and its `why` quoted word for
  word, and whether chaff misread the text or fixing it would have changed the meaning (the check looks for a
  line per dismissal with its rule, line number and `why`); files over the agreed number, for another
  run.

## Drafts for chaff

First run `node <usecase pack>/checks/feedback.mjs` (with `BLUEPRINT_BASE` and `BLUEPRINT_USECASE` set). It
drafts one report to chaff for each finding set aside because chaff misread the text (`"because": "wrong"`),
with `chaff feedback`, which sends nothing and puts only a few lines of the document in each draft. The drafts
are `.blueprint/chaff-feedback/<id>.md`; `index.json` beside them lists them.

- When `index.json` says `"supported": true` and there are drafts, add `## chaff への報告の下書き` /
  `## Drafts for chaff`. Name each draft file, say in one line what chaff misread, and say that **nothing was
  sent**. The person may read a draft, remove anything they do not want to share, and file it at
  https://github.com/isamu/lab/issues/new, or not at all. Do not send one yourself.
- When it says `"supported": false`, mention in one line under `## 直さずに残したもの` / `## Left as it was`
  that the chaff in use cannot draft reports.
- When nothing was set aside because chaff misread it, leave the section out.