archive

Lunenburg 予算プロジェクト

マサチューセッツ州ルーネンバーグの町および学校の予算に関する、独立した検証可能なアーカイブです。 51 の町の委員会にわたる 44,463 件の文書、319 件のデータセット、12,252 件の議題および 議事録を収録しています。ルーネンバーグ町、学校委員会、学区とは無関係です。

サイトは https://lunenburgbudgetproject.org です。このリポジトリには、そのすべての基盤が含まれています。

まずはこちらをご覧ください：データ API · MCP サーバー · 公開済みのすべてのアドレス · エージェント向けガイド。

---

エージェントの場合は、ここから始めてください

まず fy28/public/llms.txt を読んでください。 これはエージェント向けに書かれています。 このアーカイブに何が含まれ、何が含まれないか、またデータから確信を持って誤った回答を導き出す具体的な方法について説明しています。

サイトにアクセスできる場合は、サイトをご利用ください。以下の各アドレスには稼働中の同等のページがあり、サイトではより小さくインデックス化された形式で提供しています。GitHub にしかアクセスできない場合は、クローンせずに raw ファイルを直接取得してください。

https://raw.githubusercontent.com/tjloughlin16/lunenburgbudgetapp/main/<path>

必要なもの	取得先
収録内容とその制限	fy28/public/llms.txt
行数とサイズを含む全データセット	fy28/public/api/tables.json — 122 件
すべてのテーブルの粒度と注意点	fy28/public/api/schema.json
サイトが算出するすべての数値	fy28/public/data/model/index.json — 38 セクション、各セクション 1 ファイル
sha256 付きの全原資料	sources/data/archive-manifest.csv
ある単語に言及している会議文書	fy28/public/minutes/find/README.txt

fy28/public/api/ 内のファイルは、1 回の取得で入手できます。 それを超えるサイズになるファイルは分割されています — staff_roster_entries.json はインデックスで、staff_roster_entries/2022.json がその年のデータです。

文書そのものはこのリポジトリにありません。 44,463 件のファイル（1.47 GB）は公開オブジェクトストアにあり、 sources/data/archive-manifest.csv に sha256 付きで各ファイルが記載されています。python3 scripts/sync_archive.py --pull で取得できます。抽出済みのテキストは sources/*/text/ 以下にあり、分析ではこのテキストを読み込みます。

各種ファイルの場所

sources/	文書がどのように届いたかを基準に整理されたアーカイブ — sources/README.txt を参照
sources/data/	それらの文書から抽出した 319 件のデータセット（CSV）
sources/analyses/	検証スクリプト付きの分析文書
model/	投影データ — python3 model/export.py を実行すると fy28/src/data/model.json が生成されます
scripts/	抽出、検証、公開用スクリプト
fy28/	サイト：React アプリ、Cloudflare Pages Functions、および公開されるすべてのファイル
notes/	作業メモ。notes/reference/ は生成されます
plans/	構築中のものとその理由

このプロジェクトが従うルール

CLAUDE.md にすべて記載されています。どのルールも、このプロジェクトで間違いを犯して学んだことから生まれました。データを読む人にとって特に重要な4つを紹介します。

1. 1つの計算で予算と実績を混在させないでください。 一部の項目では最大59％異なります。一方からもう一方への成長率には、成長だけでなく両者の差も含まれます。
2. 予算項目は純額で、単位はドルです。 補助金、手数料、州の支援を差し引いた後に町が調達する必要のある金額であり、対象の費用ではありません。また、人数を数えたものでもありません。
3. 事実として述べるのは事実だけです。 データから算出した数値は事実です。それが変動した理由の説明は仮説であり、そのように明記します。
4. すべての数値はモデルから補間し、文章に手入力しません。 このファイルに記載されている件数も同様です。

実行方法

npm install --prefix fy28
python3 scripts/sync_archive.py --pull      # ドキュメント。対象はマニフェストを参照
python3 model/export.py                     # -> fy28/src/data/model.json
npm run --prefix fy28 build:site            # -> fy28/dist

CLAUDE.md にすべてのチェック項目が記載されています。このファイルの記述内容を検証するチェック項目は次のとおりです。

python3 scripts/build_readme.py --check       # このファイルとリポジトリを照合
python3 scripts/build_api.py                  # すべてのデータセットを取得可能にする
node fy28/scripts/check-agents.mjs            # 公開しているすべてのURLが応答し、読み取り可能であることを確認
python3 scripts/check_archive_storage.py      # アーカイブとマニフェストを照合

---

scripts/build_readme.py によって生成されます。編集する場合は、このファイルではなくそちらを編集してください。