blueprint-polish-report · diff
git:20260927.0b35de5 to git:20260928.34ca53f
20 added, 2 removed. Audit A to A.
---
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; findings that could not be fixed
- without changing the meaning; files over the agreed number, for another run.
+ - `## 直さずに残したもの` / `## 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.