blueprint-ask-answer

Answer from the documents

.blueprint/answers.json names the documents (documents, one path per line), the questions (questions, one per line) and whether to keep the answers (keep). The person may not know the documents well: answer in their language and in plain words.

Change nothing in the repository: this step only reads. Write only under .blueprint/; the person reads the answers before anything is kept.

How to answer

• Only from the documents. Not from general knowledge, not from what such documents usually say. If the documents do not answer a question, the answer is that they do not — and what they do say nearby, if it helps.
• Find where it is written. chaff tree <document> (through the base pack's wrapper, sh <base pack>/checks/chaff.sh tree <document>) shows the document's addresses — articles, sections, items — so an answer can say "第4条第2項" or "Section 3.1". Read the whole relevant part, including exceptions and definitions elsewhere that change its meaning.
• When provisions disagree, say so and quote both rather than choosing one.

Write .blueprint/replies.json

{
  "replies": [
    {
      "question": "委託料はいつまでに払う？",
      "found": true,
      "answer": "検収後30日以内です（第4条第2項）。",
      "citations": [{ "source": "contract.txt", "address": "第4条第2項", "quote": "成果物の検収後30日以内に" }]
    },
    {
      "question": "消費税は含まれる？",
      "found": false,
      "answer": "文書には書かれていません。第4条第1項は「金50万円」とだけ定めています。",
      "citations": [{ "source": "contract.txt", "address": "第4条第1項", "quote": "委託料として金50万円を支払う" }],
      "searched": ["消費税", "税", "税込", "税別"]
    }
  ]
}

• question: the question exactly as it is in questions. One reply per question, none extra.
• found: true when the documents answer it. Then at least one citation.
• citations: source is the document's path as documents names it; address is where; quote is copied character for character — the check runs chaff cite on every one. Name every cited place in the answer text so the person can open the document there: an article or item as the document numbers it (第4条第2項, Section 3.1), and a section of a Markdown document by its heading, word for word, in 「」 (「作業用フォルダを信頼しておく」; in an English answer, "Getting started") — the check looks for it in those marks. chaff's index for a section (h1.3) goes in address only — it means nothing to the person.
• searched: when found is false, the words and places you looked for.