Code-Savvy Manifesto: How Japan’s Local-System Standardization Can Be Made Dev-Friendly

IT Policy Proposals
Code-Savvy Manifesto: How Japan’s Local-System Standardization Can Be Made Dev-Friendly

どうも〜おかむーです! Hi, Okamu here — today let’s dig into Japan's push to standardize local government core systems from a coder's perspective. エンジニア的に言うと、政策は仕様書と同じ。コードで語るマニフェスト、いきますよ〜

  • National push to require standard-compliant local government systems (Digital Agency / MIC)
  • PDF-heavy docs vs machine-readable needs: AI-ready society demands API-first, not PDF-first
  • Practical fixes: open schemas, reference implementation, conformance tests and migration tooling

結論

政策は正しい方向に向かっている!でも実装で詰まるポイントが山ほどある。要するに、法律や省令で「標準準拠」を義務化するだけじゃ足りない。エンジニアリングで言うと、仕様(schema)、テスト、CI、サンプルデータ、移行ツールがない状態は“仕様だけのリリース”で、現場が死ぬんですよね。

Report: what I looked at and what it means

Sources: Digital Agency local_governments page (https://www.digital.go.jp/policies/local_governments), MIC standardization page (https://www.soumu.go.jp/...), Cabinet Office WG doc (PDF) and the March 24, 2026 ordinance notice.

What the policy does

  • Mandates use of standard-compliant systems for specified core operations (about 20 ops flagged in public material).
  • Emphasizes machine-readable, AI-ready administrative data (Cabinet Secretariat guidance).

Where the gaps appear (technical view)

  • Data formats: many official outputs remain PDF or proprietary DB dumps. PDFs kill automation. 要するに、人間向けドキュメントはあるが機械向けが弱いということです。
  • API coverage: no single, documented, versioned API spec across municipalities. Some municipalities expose CSV, others nothing.
  • Conformance: no public suite of automated tests or reference implementations to prove a system is "標準準拠".
  • Migration: legacy systems, vendor lock-in, and opaque data models make porting expensive.

Concrete technical proposals

  • Publish JSON Schema / OpenAPI for each of the 20 standardized operations; place them in a public Git repo with semantic versioning.
  • Provide reference implementations (Node/Python) and SDKs to lower adoption cost.
  • Ship a conformance test harness (CI-friendly) that vendors/municipalities can run.
  • Standardize serialization choices: JSON (application/json), JSON-LD for semantics, and CSV with header metadata for tabular exports.
  • Mandate machine-readable statistical tables (not PDF). Use DCAT for cataloging datasets.
  • Funding: tie rollout tranches to migration grants and mandatory test reports.

Small code examples

PDF-to-CSV quick extract (for when you only get PDFs):

import tabula

dfs = tabula.read_pdf('report.pdf', pages='all', multiple_tables=True)

then clean with pandas

Validate API response against JSON Schema (sketch):

import requests, jsonschema

r = requests.get('https://city.example.jp/api/resident')

schema = {...} # published JSON Schema

jsonschema.validate(r.json(), schema)

Impact analysis: targets vs reality

The policy's numerical target (standardize core systems across municipalities) is ambitious and necessary. But operational reality: many local governments lack in-house engineers, budgets vary, and vendors may resist interoperable open specs. That means the policy risk is uneven rollout and continued fragmentation unless the central government provides concrete engineering artifacts and funding.

Improvements road map (12-24 months)

  • Month 0–3: Publish machine-readable specs + sample data
  • 3–9: Release reference impls, SDKs, and conformance tests
  • 6–18: Migration grants + vendor certification program
  • 12–24: Centralized data catalog, API gateway options for smaller municipalities

まとめ

政策の方向性は良いが、現場が動けるように“コードとツール”をセットで出すこと。PDFじゃなくてAPI、仕様だけでなくテスト、移行ツールと資金。エンジニア的に言うと、インフラとCIを用意してあげれば、自治体のDXは一気に進むはず!

おかむーから一言

Techで行政を変えるのは筋トレみたいなもので、継続と道具立てが命。リファレンスとテスト、オープンなサンプルデータがあれば、変化は加速しますよ!