ハクソク

世界を動かす技術を、日本語で。

IRSの直接ファイル（Direct File）をGitHubで

355日前原文(chrisgiven.com)

概要

IRS が Direct File の大部分のソースコードを GitHub で公開 SHARE IT Act の要件を予定より早く達成 オープンソース化による 透明性 と 信頼性 の向上 納税者の利益を最大化するための設計方針 今後もさらなる 公開 と 信頼構築 への期待

IRSのDirect Fileコード、GitHubで公開

  • IRS が Direct File のソースコードを GitHub でオープンソースとして公開

  • 米国政府の著作物であるため、 パブリックドメイン として誰でも利用可能

  • SHARE IT Act に基づく公開義務を 3週間前倒し で達成

  • 公開リポジトリ: IRS-Public/direct-file

    • Direct File のオープンソース化は長期的に計画されていた事項
    • 税金で開発されたソフトウェアのさらなる公開に対する期待感の高まり

オープンソース化の意義と背景

  • Direct File のオープンソース化は 透明性 と 独立した評価 を可能にする施策
  • チームは「納税者が利用可能な全ての税制優遇を受けられるように設計」
  • ソースコードの公開で コミットメント を外部に示すことが可能
  • 納税者との信頼構築 を最重要課題とし、設計・開発を推進
    • 正確性の高い申告手段の提供
    • 誰でもアクセスできる税務サービスの実現
    • 納税者データの セキュリティ確保
    • ソースコード公開による 信頼性 強化

今後への期待と個人的立場

  • Direct File が先例となり、今後さらに多くの IRSコード の公開が期待される状況
  • 納税者の資金で開発されたソフトウェアの 公共利用促進
  • 筆者は2週間前に IRSを退職 し、個人の立場で意見を表明
  • 公式リポジトリ: https://github.com/IRS-Public/direct-file

Hackerたちの意見

ソースコード自体はIRSがこれを一般公開する上での難しい部分じゃないと思うけど、収入システムとの相互運用性や、現行の税法にちゃんと従ってるかが問題だよね。ソースコードが公開されても、そういう部分は行政に潰されちゃう可能性があるんじゃない？

└

そうだね、税務申告ロビーのために働いてる政治家や役人が、ソフトウェアを無意味にするような変更を税法に加えることができるかもしれない。

└

うん、まさにその通り。参考までに、リポジトリにはこう書いてあるよ：「Direct Fileはアメリカの内国歳入法（26 USC）を平易な言葉の質問として解釈し、その答えは納税者が外部の指示や出版物なしで知っているべきものです。納税者の回答は標準の税フォームに変換され、IRSの現代化されたe-File（MeF）APIに送信されます。これは公的に認可された使用が可能です。」理論的には今は役立つけど、言う通り簡単に変わる可能性もあるね。

└

ビジネスチャンスっぽいね。

└

付け加えると、「難しい部分」には、税務準備ロビーがアメリカ市民の福祉を犠牲にしてビジネスの利益を守ってきた数十年の成功も含まれていると思う。去年よりも無料の直接申告を提供する州の数は増えたけど、今は25州に比べてずっと少なかったのを覚えてる。残りの25州、特に俺が住んでるDCの問題は何なのかは不明だね。

興味がある人のためにリポジトリ見つけたよ。 https://github.com/IRS-Public/direct-file

└

イデオロギーに取り憑かれた誰かが削除して、見た人を投獄すると脅す前に、さっさとフォークしといた方がいいね。

こちらが主なエンジニアの一人からの発表だよ。 https://chrisgiven.com/2025/05/direct-file-on-github/

└

ありがとう！上のURLをhttps://www.404media.co/directfile-open-source-irs-tax-filin...から変更したよ。後者はサインアップしないといけないからね。

リポジトリが2つのコミットしかなくて、どっちも「初回コミット」っていうのが面白い。

└

初回のコミットで必要なファイルを忘れたときにやったことあるよ。忘れたファイルを追加しても、メッセージを変える必要がないから、自分がうっかり者だったって分かるし、コミットは同じものとして考えられるんだ。既存のコミットに追加ファイルを加える方法を調べるより、ずっと早いし、実際にやる手間も省ける。俺のgitの使い方はadd/commit/push/clone/switch/fetchだよ。その後は、100%調べるだけで、SOのスレッドを追ってリポジトリを壊さないことを祈る感じ。

先週の関連する議論：IRS Direct File - https://news.ycombinator.com/item?id=44131901 - 2025年5月（コメント62件）

https://deepwiki.com/IRS-Public/direct-fileにはいい洞察があるよ。「ファクトグラフについて教えて」ってね。

残念ながら、このプログラムは今の管理者によって潰されそうだね。このリポジトリは素晴らしいよ。Scalaのファクトグラフはすごく neat だし、チュートリアルを作るのにかなりの気遣いがあったのが明らかだね。

└

これに関わっているみんなは、コードの最初の行を書く前から運命が決まっていることを知っていたと思うし、次の(R)が担当になったらすぐに潰されるって分かってたんじゃないかな。そうなる前に動くソフトウェアをリリースできたのは素晴らしい成果だけど、誰もそれが続くとは思ってなかったと思う。税金を払わせるロビーは強すぎて腐敗してるからね。

俺たちの中で、ファイルを実際にコミットする代わりにサブモジュールのポインタだけで新しいリポジトリを作っちゃった人はいないの？ https://github.com/IRS-Public/direct-file/commit/2f3ebd66932... しかも、これがアメリカのもので、CC0をそのまま使えないから、世界的なCC0とは別にパブリックドメインである必要があるっていうのも面白いよね。

└

別の言い方をすると、カリフォルニアに本拠を置くクリエイティブ・コモンズは、国内の大手ソフトウェア著作者の一人が使えるライセンスを公開していません。ちょっと皮肉っぽく言うと、そこに何か違和感を感じますね。

Direct Fileは、未完成の情報、例えば部分的に記入された税申告書について推論するために設計された、宣言的なXMLベースのナレッジグラフデータ構造であるFact Graphを取り入れています。Fact GraphはScalaプログラミング言語で書かれていて、バックエンドではJVM上で動作し、クライアント側ではScala.jsを通じてトランスパイルされています。Direct FileのFact Graphは特定のドメインに依存せず、税務機関やビジネスルールエンジンの実装の参考として役立つかもしれません。

└

面白いですね、もっとこのことについて読みたいです。

コード以外にも、/docs/designの下に素晴らしいデザイン文書やメモがたくさんあります[0]。多くのユーザーフローの詳細なプロセス図も含まれています（残念ながら、zipファイルの中にあるのでオンラインで直接見ることはできません；flow1.zipとflow2.zipを参照）。0: https://github.com/IRS-Public/direct-file/tree/main/docs/des...