固定資産税ナレッジ管理フロー定義書¶

作成日: 2026-03-17
最終更新: 2026-03-17
ステータス: v1.0

1. 概要¶

固定資産税の課税・評価実務に関するナレッジを、Markdownファイルで体系的に管理する。個人の学習・参照用として運用し、MkDocs + Cloudflare Pages でホスティングする。

1.1 管理方針¶

項目	方針
対象領域	固定資産税（課税・評価実務の全般）
利用範囲	個人の学習・参照用
ホスティング	MkDocs Material + Cloudflare Pages
アクセス制御	Cloudflare Access（個人限定）
ソース管理	GitHub プライベートリポジトリ
エディタ	Zed + Claude Code
AI連携	Claude（知識の蓄積 + ナレッジを用いた質問応答）

1.2 重視するポイント¶

検索性 — MkDocs の全文検索 + タグによる横断検索
体系的な分類 — 知識基盤・業務プロセス・法令制度の3層構造
更新・追記のしやすさ — テンプレート駆動 + フロントマターによるメタデータ管理
AI連携 — Claudeとの会話から知識を蓄積し、蓄積したナレッジをClaudeに読ませて活用

1.3 分類設計の考え方¶

固定資産税の実務は大きく3つの層で整理できる。加えて、年度別のまとめページが各層を横断する時間軸のビューとなる。

┌──────────────────────────────────────────────────────────┐
│  【知識基盤】 評価                                         │
│   土地・家屋・償却資産それぞれの評価基準・算定手順           │
│   → 最も深い専門知識。他の業務すべての土台となる             │
├──────────────────────────────────────────────────────────┤
│  【業務プロセス】                                          │
│   賦課 ─ 減免 ─ 統計 ─ 登記所連携 ─ eLTAX ─ システム      │
│   → 日常の実務フローや手続き。資産横断の業務が多い           │
├──────────────────────────────────────────────────────────┤
│  【法令・制度基盤】                                        │
│   地方税法・評価基準・通達 ─ 判例・裁決例                    │
│   → 評価にも業務にも横断的に関わる法令・判例の知識           │
├──────────────────────────────────────────────────────────┤
│  【年度別まとめ】                                          │
│   課税年度別（毎年） ─ 評価替年度別（3年ごと）              │
│   → 上記3層の情報を年度の時間軸で集約するハブページ          │
└──────────────────────────────────────────────────────────┘

この3層＋年度別まとめをディレクトリ構成に反映する。

2. ディレクトリ構成¶

fpt-knowledge/                      # リポジトリルート
├── mkdocs.yml
├── docs/
│   ├── index.md                    # トップページ
│   │
│   │  ═══════════════════════════
│   │  【第1層】知識基盤 — 評価
│   │  ═══════════════════════════
│   │
│   ├── valuation/                  # ── 評価（知識基盤） ──
│   │   ├── index.md                # 評価セクション概要
│   │   │
│   │   ├── land/                   # 土地評価
│   │   │   ├── index.md
│   │   │   ├── 001-route-price-method.md       # 路線価方式
│   │   │   ├── 002-lot-calculation.md          # 画地計算法
│   │   │   └── ...
│   │   │
│   │   ├── building/               # 家屋評価
│   │   │   ├── index.md
│   │   │   ├── 001-replacement-cost.md         # 再建築費評点基準表
│   │   │   ├── 002-depreciation-correction.md  # 経年減点補正率
│   │   │   └── ...
│   │   │
│   │   ├── depreciable/            # 償却資産評価
│   │   │   ├── index.md
│   │   │   ├── 001-acquisition-cost.md         # 取得価額の算定
│   │   │   ├── 002-useful-life.md              # 耐用年数
│   │   │   └── ...
│   │   │
│   │   └── common/                 # 評価共通
│   │       ├── index.md
│   │       ├── 001-revaluation-cycle.md        # 評価替えの仕組み
│   │       └── ...
│   │
│   │  ═══════════════════════════
│   │  【第2層】業務プロセス
│   │  ═══════════════════════════
│   │
│   ├── levy/                       # ── 賦課業務 ──
│   │   ├── index.md                #   調定・課税台帳・納税通知書 等
│   │   ├── 001-assessment-flow.md
│   │   └── ...
│   │
│   ├── exemption/                  # ── 減免・非課税・課税免除 ──
│   │   ├── index.md
│   │   ├── 001-tax-exemption-types.md
│   │   └── ...
│   │
│   ├── statistics/                 # ── 統計 ──
│   │   ├── index.md                #   概要調書・各種統計報告 等
│   │   ├── 001-summary-report.md
│   │   └── ...
│   │
│   ├── registry/                   # ── 登記所連携 ──
│   │   ├── index.md                #   登記通知・地目変更・所有権移転 等
│   │   ├── 001-registration-notice.md
│   │   └── ...
│   │
│   ├── eltax/                      # ── eLTAX連携 ──
│   │   ├── index.md                #   電子申告・電子通知 等
│   │   ├── 001-electronic-filing.md
│   │   └── ...
│   │
│   ├── system/                     # ── システム ──
│   │   ├── index.md                #   基幹システム運用・データ管理 等
│   │   ├── 001-master-data-management.md
│   │   └── ...
│   │
│   │  ═══════════════════════════
│   │  【第3層】法令・制度基盤
│   │  ═══════════════════════════
│   │
│   ├── laws/                       # ── 法令・通達 ──
│   │   ├── index.md
│   │   ├── chihouzeihou/           # 地方税法
│   │   │   ├── 001-article-341.md  #   例: 第341条（固定資産税に関する用語の意義）
│   │   │   └── ...
│   │   ├── hyouka-kijun/           # 固定資産評価基準
│   │   │   └── ...
│   │   └── tsuuchi/                # 通達・通知
│   │       └── ...
│   │
│   ├── cases/                      # ── 判例・裁決例・Q&A ──
│   │   ├── index.md
│   │   ├── 001-xxxxx.md
│   │   └── ...
│   │
│   │  ═══════════════════════════
│   │  【年度別まとめ】
│   │  ═══════════════════════════
│   │
│   ├── annual/                     # ── 年度別まとめ ──
│   │   ├── index.md                # 年度別まとめの概要・一覧
│   │   │
│   │   ├── taxation/               # 課税年度別（法令改正・特例等）
│   │   │   ├── index.md            # 課税年度一覧
│   │   │   ├── r06.md              # 令和6年度
│   │   │   ├── r07.md              # 令和7年度
│   │   │   └── ...
│   │   │
│   │   └── revaluation/            # 評価替年度別（評価基準の改正内容）
│   │       ├── index.md            # 評価替年度一覧
│   │       ├── r06.md              # 令和6年度評価替え
│   │       ├── r09.md              # 令和9年度評価替え（次回）
│   │       └── ...
│   │
│   │  ═══════════════════════════
│   │  【横断】参照・メタ情報
│   │  ═══════════════════════════
│   │
│   ├── glossary.md                 # 用語集
│   ├── references.md               # 参考文献・リンク集
│   ├── tags.md                     # タグ一覧（自動生成）
│   │
│   └── meta/                       # メタ情報
│       ├── management-flow.md      # 本ドキュメント
│       ├── templates.md            # テンプレート一覧
│       └── changelog.md            # サイト全体の変更履歴（ナレッジの追加・構造変更等）
│
├── templates/                      # テンプレートファイル（docs外）
│   ├── valuation-note.md           # 評価ナレッジ用
│   ├── process-note.md             # 業務プロセス用
│   ├── law-note.md                 # 法令・通達メモ用
│   ├── case-note.md                # 判例・裁決例用
│   ├── annual-taxation.md          # 課税年度別まとめ用
│   └── annual-revaluation.md       # 評価替年度別まとめ用
│
├── scripts/
│   └── new-note.sh                 # 新規ノート作成スクリプト
│
└── .claude/
    └── CLAUDE.md                   # プロジェクトコンテキスト

2.1 セクション一覧と説明¶

層	ディレクトリ	日本語名	主な内容
知識基盤	`valuation/land/`	土地評価	路線価方式、標準地比準、画地計算、地目認定
	`valuation/building/`	家屋評価	再建築費評点、経年減点補正、部分別評価
	`valuation/depreciable/`	償却資産評価	取得価額、耐用年数、減価残存率
	`valuation/common/`	評価共通	評価替えの仕組み、価格決定プロセス
業務プロセス	`levy/`	賦課業務	調定、課税台帳、納税通知書、縦覧、税額算定、特例措置
	`exemption/`	減免等	減免、非課税、課税免除の要件・手続き
	`statistics/`	統計	概要調書、統計報告、データ集計方法
	`registry/`	登記所連携	登記通知の処理、地目変更、所有権移転、表題登記
	`eltax/`	eLTAX連携	電子申告受付、電子通知、データ連携仕様
	`system/`	システム	基幹システム運用、データ管理、バッチ処理、移行
法令・制度	`laws/chihouzeihou/`	地方税法	各条文の要約・解釈メモ
	`laws/hyouka-kijun/`	固定資産評価基準	評価基準の各章・節の要約・解釈メモ
	`laws/tsuuchi/`	通達・通知	取扱通知、事務連絡等の要約・解釈メモ
	`cases/`	判例・裁決等	判例、裁決例、審査申出事例、Q&A
年度別まとめ	`annual/taxation/`	課税年度別	各年度の法令改正・特例措置・税制改正の概要と詳細ナレッジへのリンク
	`annual/revaluation/`	評価替年度別	各評価替年度の評価基準改正内容の概要と詳細ナレッジへのリンク

2.2 ファイル命名規則¶

{連番3桁}-{簡潔な英語スラッグ}.md

連番はディレクトリ内での表示順制御用。一意識別はフロントマターの id で行う。

例:

valuation/land/001-route-price-method.md
levy/001-assessment-flow.md
laws/chihouzeihou/001-article-341.md
cases/001-landmark-case-lot-calculation.md

例外: 年度別まとめ — annual/ 配下は連番ではなく和暦略称で命名する。

annual/taxation/r06.md（令和6年度）
annual/revaluation/r06.md（令和6年度評価替え）

2.3 分類の判断ガイド¶

ナレッジをどのディレクトリに置くか迷った場合の判断基準。

迷うケース	判断基準	配置先
路線価の算定手順 → 評価？賦課？	「価格を求める知識」は評価	`valuation/land/`
税額の算定（税率適用・特例） → 評価？賦課？	「価格→税額の業務」は賦課	`levy/`
非課税の根拠条文 → 法令？減免？	条文の解釈なら法令、適用手続きなら減免	`laws/` or `exemption/`
登記地目と課税地目の違い → 評価？登記所？	評価判断の知識なら評価、連携手続きなら登記所	`valuation/land/` or `registry/`
償却資産の電子申告 → 償却？eLTAX？	申告内容の知識なら評価、電子手続きならeLTAX	`valuation/depreciable/` or `eltax/`

原則: 迷ったら tags と related で横断リンクを張る。 1つのファイルは1箇所にしか置けないが、タグとrelatedで他の文脈からもたどり着ける。

3. フロントマター仕様¶

すべてのナレッジファイルに以下のフロントマターを付与する。

---
id: valuation-land-001                 # 一意識別子
title: "路線価方式による土地評価"          # タイトル
section: valuation                      # セクション（第1層分類）
asset: land                             # 資産区分（該当する場合）
content_type: knowledge                 # コンテンツ種別
tags:                                   # 検索用タグ
  - 路線価
  - 画地計算
  - 奥行価格補正
status: draft                           # draft | review | published
created: 2026-03-17
updated: 2026-03-17
source: "固定資産評価基準 第1章第3節"      # 根拠・出典
related:                                # 関連ナレッジID
  - laws-chihouzeihou-001
  - levy-003
---

法令ナレッジ（content_type: law-summary）の場合は、以下の項目を追加する:

---
id: laws-chihouzeihou-001
title: "第349条の3（固定資産税の課税標準等の特例）"
section: laws
asset: common
content_type: law-summary
tags:
  - 地方税法
  - 課税標準特例
  - 負担調整措置
effective_date: 2024-04-01              # 現行規定の施行日
last_amended_by: "令和6年法律第4号"       # 直近改正の根拠法令
has_transitional_measure: true          # 経過措置の有無
status: published
created: 2026-03-17
updated: 2026-03-17
source: "地方税法第349条の3"
related:
  - levy-002
  - valuation-land-003
---

3.1 フロントマター項目の説明¶

全ナレッジ共通:

項目	必須	説明
`id`	○	一意識別子。下記の命名規則を参照
`title`	○	ナレッジのタイトル
`section`	○	所属セクション（下表参照）
`asset`	△	資産区分。該当する場合のみ（`land` / `building` / `depreciable` / `common`）
`content_type`	○	コンテンツ種別（下表参照）
`tags`	○	検索用タグ。最低1つ
`status`	○	`draft` → `review` → `published`
`created`	○	作成日（YYYY-MM-DD）
`updated`	○	内容を実質的に更新した日付（YYYY-MM-DD）。typo修正やメタデータ変更のみの場合は変更しない。詳細は7.1節参照
`source`	△	根拠法令・文献等。可能な限り記載
`related`	−	関連ナレッジのID

id の命名規則:

セクション	形式	例
評価	`valuation-{asset}-{連番}`	`valuation-land-001`
業務プロセス	`{section}-{連番}`	`levy-001`, `exemption-003`
法令	`laws-{法令区分}-{連番}`	`laws-chihouzeihou-001`, `laws-tsuuchi-005`
判例	`cases-{連番}`	`cases-001`
年度別まとめ	`annual-{種別}-{年度}`	`annual-taxation-r07`, `annual-revaluation-r06`

source の使い分け:

source はこのナレッジが依拠する一次情報の出典を記載する（例: "固定資産評価基準第1章第3節"）
法令テンプレートの本文内「対象条文」はナレッジが扱う条文の特定に使う
法令ナレッジでは、source = 対象条文となることが多いが、解釈メモの場合は参考にした文献を source に書いてもよい

法令ナレッジ追加項目（content_type: law-summary の場合）:

項目	必須	説明
`effective_date`	○	現行規定の施行日（YYYY-MM-DD）
`last_amended_by`	○	直近改正の根拠法令・通達番号。新規制定の場合は制定法令を記載
`has_transitional_measure`	○	経過措置の有無（`true` / `false`）

3.2 `section` の値¶

値	対応ディレクトリ
`valuation`	`valuation/`
`levy`	`levy/`
`exemption`	`exemption/`
`statistics`	`statistics/`
`registry`	`registry/`
`eltax`	`eltax/`
`system`	`system/`
`laws`	`laws/`
`cases`	`cases/`
`annual`	`annual/`

3.3 `content_type` の値¶

値	説明	使いどころ
`knowledge`	概念・基準・手順の解説	評価基準の解説、制度の説明
`procedure`	業務フロー・手順書	実務の手順を記述
`calculation`	計算例・算定例	具体的な数値による計算過程
`law-summary`	法令・通達の要約	条文の要約と解釈（新規制定・改正とも）
`case-study`	判例・裁決・Q&A	事例の分析
`reference`	一覧表・対照表・早見表	補正率表、耐用年数表等
`operation`	システム操作・運用手順	基幹システムの操作手順
`annual-summary`	年度別まとめ	課税年度別・評価替年度別の改正概要と詳細リンク集

4. テンプレート¶

4.1 評価ナレッジ（valuation-note）¶

---
id: valuation-{asset}-{連番}
title: ""
section: valuation
asset:                  # land | building | depreciable | common
content_type: knowledge # knowledge | calculation | reference
tags: []
status: draft
created: YYYY-MM-DD
updated: YYYY-MM-DD
source: ""
related: []
---

# {タイトル}

## 概要

- **対象**: 
- **評価方式**: 
- **根拠**: 

## 評価の考え方

（制度趣旨・基本的な考え方を記述）

## 算定手順

### ステップ1: 
### ステップ2: 
### ステップ3: 

## 計算例

> **前提条件**
> （具体的な数値・条件）

（計算過程を段階的に記述）

## 特例・例外

（特例措置、適用除外、経過措置 等）

## 評価替え・基準改正の影響

> 評価替え（3年ごと）や評価基準の改正で内容が変わった場合、  
> 変更前の内容を以下に記録してから上部セクションを最新に更新する。

<!-- 例:
### R6評価替え（基準年度: 令和6年度）
- **変更内容**: 
- **変更前**: 
- **根拠**: 
-->

## よくある間違い・注意点

- 

## 関連ナレッジ

（related に記載したナレッジへの補足説明）

## 出典・参考

-

4.2 業務プロセスノート（process-note）¶

---
id: {section}-{連番}
title: ""
section:                # levy | exemption | statistics | registry | eltax | system
asset:                  # 該当する場合のみ
content_type: procedure # procedure | operation
tags: []
status: draft
created: YYYY-MM-DD
updated: YYYY-MM-DD
source: ""
related: []
---

# {タイトル}

## 業務の概要

- **目的**: 
- **実施時期**: 
- **根拠法令**: 
- **対象資産**: （全資産 / 土地 / 家屋 / 償却資産）

## 業務フロー

> フロー図は mermaid 記法で記述する（MkDocs Material でレンダリングされる）。

```mermaid
flowchart TD
    A[手順1] --> B[手順2]
    B --> C[手順3]

詳細手順¶

手順1:¶

手順2:¶

手順3:¶

注意点・Tips¶

出典・参考¶

### 4.3 法令・通達メモ（law-note）

```markdown
---
id: laws-{法令区分}-{連番}
title: ""
section: laws
asset:                              # 該当する場合のみ
content_type: law-summary
tags: []
effective_date: YYYY-MM-DD          # 現行規定の施行日
last_amended_by: ""                 # 直近改正の根拠法令・通達番号
has_transitional_measure: false     # 経過措置の有無
status: draft
created: YYYY-MM-DD
updated: YYYY-MM-DD
source: ""
related: []
---

# {タイトル}

## 条文・通達の概要

- **対象条文**: 
- **法令区分**: 地方税法 / 評価基準 / 通達
- **趣旨**: 

> 現行規定の施行日はフロントマターの `effective_date` で管理する。

## 現行規定の要点

（現行の条文・通達の内容を箇条書きで整理）

## 解釈メモ

（自分の理解・解釈・注意点）

## 実務への影響

（どの業務プロセスに影響するか。関連するセクションを明示）

---

## 改正履歴

> 新しい改正を上に追記する（降順）。改正があった場合、「現行規定の要点」を
> 最新の内容に更新し、旧規定はこの改正履歴セクションに保存する。

### 制定（施行日: YYYY-MM-DD）

- **制定法令・通達番号**: 
- **制定の趣旨**: （なぜこの規定が設けられたか）

<!-- 改正があった場合、この上に降順で追記していく -->
<!-- 改正エントリの記載方法は「改正エントリの記載テンプレート」を参照 -->

---

## 出典・参考

-

法令テンプレートの運用ルール:

現行規定を常に上部に維持する — ファイルを開いたとき、まず最新の内容が目に入る構造にする
改正時は「追記」が基本 — 旧規定の内容を削除せず、改正履歴セクションに降順で追記する
フロントマターを同時に更新する — effective_date、last_amended_by、has_transitional_measure を改正に合わせて更新する
経過措置は必ず記録する — 有無にかかわらず明示する。経過措置ありの場合は適用期間を必ず記載する
改正の影響先を確認する — 改正に伴い、related で紐づいた他のナレッジにも更新が必要かを確認する

改正エントリの記載テンプレート:

改正が発生した場合、以下を「制定」エントリの上に追記する。

### {改正年月日} 改正（施行日: YYYY-MM-DD）

- **改正法令・通達番号**: 
- **改正の概要**: （何がどう変わったか）
- **旧規定の内容**: （改正前の条文・内容の要約）
- **新規定の内容**: （改正後の条文・内容の要約）
- **経過措置**:
    - 有無: あり / なし
    - 内容: （経過措置の具体的な内容）
    - 適用期間: （いつからいつまで）
- **実務への影響**: （この改正により実務がどう変わるか）

4.4 判例・裁決例・Q&A（case-note）¶

---
id: cases-{連番}
title: ""
section: cases
asset:                  # 該当する場合のみ
content_type: case-study
tags: []
status: draft
created: YYYY-MM-DD
updated: YYYY-MM-DD
source: ""
related: []
---

# {タイトル}

## 事案の概要

- **種別**: 判例 / 裁決例 / 審査申出事例 / Q&A
- **日付**: 
- **事件番号・出典**: 
- **対象資産**: 

## 争点

（何が問題になったか）

## 当事者の主張

### 納税者側

### 課税庁側

## 判断の要旨

（裁判所・審査委員会等の判断内容）

## 実務上のポイント

（この事例から得られる教訓・実務への反映事項）

## 関連ナレッジ

（related に記載したナレッジへの補足説明）

## 出典・参考

-

4.5 課税年度別まとめ（annual-taxation）¶

---
id: annual-taxation-{年度（例: r07）}
title: "令和○年度 課税に関する法令改正・特例まとめ"
section: annual
content_type: annual-summary
tags:
  - R○年度
status: draft
created: YYYY-MM-DD
updated: YYYY-MM-DD
source: ""
related: []
---

# 令和○年度 課税に関する法令改正・特例まとめ

## 年度概要

- **課税年度**: 令和○年度
- **賦課期日**: 令和○年1月1日
- **基準年度区分**: 基準年度 / 第二年度 / 第三年度

## 税制改正の概要

（この年度に適用される税制改正の全体像を簡潔に記述）

## 法令改正

### 改正1: {改正の名称}

- **改正法令**: 
- **施行日**: 
- **概要**: 
- **詳細**: [→ 該当する法令ナレッジへのリンク](../laws/chihouzeihou/xxx.md)

### 改正2: {改正の名称}

- **改正法令**: 
- **施行日**: 
- **概要**: 
- **詳細**: [→ 該当する法令ナレッジへのリンク](../laws/chihouzeihou/xxx.md)

## 特例措置

### 新設された特例

| 特例名 | 根拠条文 | 対象 | 内容概要 | 詳細リンク |
|-------|---------|------|---------|-----------|
|  |  |  |  | [→](../laws/xxx.md) |

### 延長・変更された特例

| 特例名 | 根拠条文 | 変更内容 | 適用期間 | 詳細リンク |
|-------|---------|---------|---------|-----------|
|  |  |  |  | [→](../laws/xxx.md) |

### 廃止・期限切れの特例

| 特例名 | 根拠条文 | 廃止・期限切れ日 | 経過措置 | 詳細リンク |
|-------|---------|----------------|---------|-----------|
|  |  |  |  | [→](../laws/xxx.md) |

## 課税標準・税率の変更

（該当がある場合のみ記述）

## 減免・非課税の変更

（該当がある場合のみ記述。詳細は exemption/ 配下のナレッジにリンク）

## その他の実務上の変更点

（通達の発出、eLTAX仕様変更、システム対応 等。詳細は各セクションにリンク）

## 出典・参考

-

4.6 評価替年度別まとめ（annual-revaluation）¶

---
id: annual-revaluation-{年度（例: r06）}
title: "令和○年度評価替え 改正内容まとめ"
section: annual
content_type: annual-summary
tags:
  - R○評価替え
status: draft
created: YYYY-MM-DD
updated: YYYY-MM-DD
source: ""
related: []
---

# 令和○年度評価替え 改正内容まとめ

## 評価替えの概要

- **基準年度**: 令和○年度
- **価格調査基準日**: 令和○年1月1日
- **適用期間**: 令和○年度〜令和○年度（3年間）

## 評価基準の改正概要

（この評価替えにおける固定資産評価基準の改正の全体像を簡潔に記述）

## 土地評価の改正

### 改正1: {改正の名称}

- **概要**: 
- **改正箇所**: 固定資産評価基準 第○章第○節
- **影響**: 
- **詳細**: [→ 該当する評価ナレッジへのリンク](../valuation/land/xxx.md)

### 改正2: {改正の名称}

- **概要**: 
- **改正箇所**: 
- **影響**: 
- **詳細**: [→ 該当する評価ナレッジへのリンク](../valuation/land/xxx.md)

## 家屋評価の改正

### 再建築費評点基準表の改正

- **概要**: 
- **主な変更点**: 
- **詳細**: [→ 該当する評価ナレッジへのリンク](../valuation/building/xxx.md)

### 経年減点補正率の改正

- **概要**: 
- **主な変更点**: 
- **詳細**: [→ 該当する評価ナレッジへのリンク](../valuation/building/xxx.md)

### その他の家屋評価改正

（該当がある場合のみ記述）

## 償却資産評価の改正

（該当がある場合のみ記述）

- **詳細**: [→ 該当する評価ナレッジへのリンク](../valuation/depreciable/xxx.md)

## 経過措置・据置措置

| 対象 | 措置内容 | 適用条件 | 期間 | 詳細リンク |
|------|---------|---------|------|-----------|
|  |  |  |  | [→](../laws/xxx.md) |

## 関連する通達・通知

| 通達番号 | 名称 | 概要 | 詳細リンク |
|---------|------|------|-----------|
|  |  |  | [→](../laws/tsuuchi/xxx.md) |

## 実務上の留意点

（この評価替えにおいて特に注意すべき実務上のポイント）

## 出典・参考

-

年度別まとめテンプレートの運用ルール:

まとめページはハブとして機能する — 個々の法令改正・評価基準改正の詳細は各セクション（laws/, valuation/ 等）のナレッジに記述し、年度別まとめページからリンクで参照する
課税年度別は毎年度作成する — 改正がない年度でも「改正なし」を明記したページを作成し、確認済みであることを記録する
評価替年度別は3年ごとに作成する — 基準年度（令和6年度、令和9年度…）のタイミングで作成する
ファイル命名は年度のみ — r06.md, r07.md のように和暦の略称を使う。連番は使わない

5. ワークフロー¶

5.1 ナレッジ蓄積フロー¶

flowchart TD
    INPUT["インプット\n・業務中の気づき・疑問\n・法令改正・通達の発出\n・研修・勉強会での学び\n・Claudeとの会話で得た知識"]
    CLASSIFY{"どの層に属するか？"}
    VAL["評価の知識\n→ valuation/"]
    BIZ["業務の手順\n→ levy/ 等"]
    LAW["法令・判例\n→ laws/ cases/"]
    TEMPLATE["テンプレート選択\n+ ファイル作成"]
    DRAFT["下書き作成\nstatus: draft"]
    REVIEW["確認・推敲\nstatus: review"]
    PUBLISH["確定\nstatus: published"]
    GIT["Git commit + push"]

    INPUT --> CLASSIFY
    CLASSIFY --> VAL
    CLASSIFY --> BIZ
    CLASSIFY --> LAW
    VAL --> TEMPLATE
    BIZ --> TEMPLATE
    LAW --> TEMPLATE
    TEMPLATE --> DRAFT
    DRAFT --> REVIEW
    REVIEW --> PUBLISH
    PUBLISH --> GIT

5.2 ステータス遷移ルール¶

遷移	タイミング	基準
`draft` → `review`	初稿完了時	テンプレートの主要セクションに内容が記入されている
`review` → `published`	確認完了時	出典が明記されている。内容の正確性を確認済み
`published` → `review`	改訂時	法令改正、評価替え等で見直しが必要になった場合

5.3 更新・メンテナンスフロー¶

トリガー	アクション	主な対象セクション
評価替え（3年ごと）	評価基準関連を全面レビュー。評価替年度別まとめページを作成	`valuation/`, `annual/revaluation/`
新年度（毎年）	課税年度別まとめページを作成。前年度の税制改正・特例を整理	`annual/taxation/`
法令改正・通達発出	下記「法令改正時の更新手順」に従う。該当年度のまとめページにも追記	`laws/` → 全セクション, `annual/taxation/`
判例・裁決の公表	事例を追加、関連ナレッジにリンク	`cases/`
eLTAX仕様変更	連携手順を更新	`eltax/`
システム改修	操作手順・データ仕様を更新	`system/`
日常の気づき	`draft` で随時追加、週次でレビュー	全セクション

5.4 法令改正時の更新手順¶

法令改正・通達発出があった場合、以下の手順でナレッジを更新する。 過去の情報を削除せず、履歴として蓄積することが最も重要。

flowchart TD
    A["法令改正の把握\n（官報・通知等）"]
    B["該当する法令ナレッジを特定"]
    C["改正履歴セクションに追記\n・改正法令番号を記録\n・施行日を記録\n・旧規定の内容を保存\n・新規定の内容を記載\n・経過措置の有無と内容を記録"]
    D["「現行規定の要点」を最新に更新\nフロントマターも更新:\n・effective_date\n・last_amended_by\n・has_transitional_measure"]
    E["related で紐づいた\n他ナレッジへの影響を確認\n→ 影響があれば該当ナレッジも更新"]
    F["Git commit + push\n（commitメッセージに\n改正法令番号を含める）"]

    A --> B --> C --> D --> E --> F

コミットメッセージ例:

update: 地方税法349条の3 課税標準特例（令和6年法律第4号による改正）
update: 評価基準第2章第3節経年減点補正率（R6評価替え対応）

6. AI連携フロー¶

6.1 会話 → ナレッジ蓄積（Claude → Markdown）¶

flowchart LR
    A["Claudeに質問\n（学習・調査）"] --> B["回答を精査\n（法令と照合）"] --> C["Markdownに整形\nテンプレートに\n沿って保存"]

手順:

Claudeに固定資産税に関する質問をする
回答内容を法令・公式資料と照合して正確性を確認する
適切なテンプレートを選択し、Markdownファイルとして作成する
フロントマターを記入する（特に source を必ず明記）
status: draft で Git commit + push
確認後に review → published へ遷移

Claude Code活用:

.claude/CLAUDE.md にプロジェクトコンテキストを記述しておく
「○○についてナレッジを作成して」と指示するとテンプレートに沿ったファイルを自動生成
生成後は必ず内容を精査してから published にする

6.2 ナレッジ → 質問応答（Markdown → Claude）¶

flowchart LR
    A["ナレッジファイルを\nコンテキストとして選択"] --> B["Claudeに渡す\n+ 質問する"] --> C["回答・分析を得る"]

活用パターン:

パターン	方法	使いどころ
深掘り	特定ファイルを指定して質問	評価基準の詳細な解釈
横断比較	複数セクションのファイルを渡す	土地・家屋・償却の比較検討
棚卸し	ディレクトリ全体を読ませて不足を指摘	定期メンテナンス
計算検証	計算例を渡して別条件での試算を依頼	算定手順の応用
業務フロー設計	複数の手順ノートを渡して改善案を相談	業務改善

6.3 CLAUDE.md の記載内容（案）¶

# 固定資産税ナレッジベース

## プロジェクト概要
固定資産税の課税・評価実務に関するナレッジをMarkdownで管理するMkDocsサイト。

## ディレクトリ構成（3層構造）

### 知識基盤（評価）
- `docs/valuation/land/` — 土地評価
- `docs/valuation/building/` — 家屋評価
- `docs/valuation/depreciable/` — 償却資産評価
- `docs/valuation/common/` — 評価共通

### 業務プロセス
- `docs/levy/` — 賦課業務
- `docs/exemption/` — 減免・非課税・課税免除
- `docs/statistics/` — 統計
- `docs/registry/` — 登記所連携
- `docs/eltax/` — eLTAX連携
- `docs/system/` — システム

### 法令・制度基盤
- `docs/laws/chihouzeihou/` — 地方税法
- `docs/laws/hyouka-kijun/` — 固定資産評価基準
- `docs/laws/tsuuchi/` — 通達・通知
- `docs/cases/` — 判例・裁決例・Q&A

### 年度別まとめ
- `docs/annual/taxation/` — 課税年度別（法令改正・特例のまとめ。毎年度作成）
- `docs/annual/revaluation/` — 評価替年度別（評価基準改正のまとめ。3年ごと作成）

## ファイル作成ルール
- テンプレート: `templates/` 配下を使用
- 命名: `{連番3桁}-{英語スラッグ}.md`
- フロントマター: id, title, section, content_type, tags, status, created, updated は必須
- status は `draft` で作成 → 確認後 `review` → `published`

## 注意事項
- 法令・制度の記述は `source` に必ず根拠を明記
- AI生成内容は必ず法令・公式資料と照合してから published にする
- 1ファイル1テーマを原則とし、関連は `related` でリンクする

## 法令ナレッジの時点管理ルール
- 法令ナレッジは「現行規定 + 改正履歴」を1ファイルで管理する
- 改正時は旧規定を削除せず、改正履歴セクションに降順で追記する
- フロントマターの `effective_date`, `last_amended_by`, `has_transitional_measure` を改正に合わせて更新する
- 経過措置は有無にかかわらず明示する

## 記述ルール
- フロー図・処理手順・判断分岐は mermaid 記法で記述する（ASCIIアート不可）
- 1ファイル1テーマを原則とする

7. MkDocs 設定方針¶

7.1 テーマ・プラグイン¶

項目	選定	理由
テーマ	Material for MkDocs	検索機能が強力。タグ対応。日本語対応
検索	組み込み search プラグイン	日本語の全文検索に対応
タグ	tags プラグイン	フロントマターの tags による横断検索
日付表示	git-revision-date-localized	最終更新日を自動表示
図表	mermaid（Material 組み込み）	フロー図・シーケンス図をMarkdown内で記述・レンダリング

フロー図の記述ルール:
業務フロー、処理手順、判断分岐等の図は mermaid 記法 で記述する。Material for MkDocs に組み込みの mermaid レンダリングを利用する（mkdocs.yml で pymdownx.superfences の custom fences として設定）。ASCII アートによるフロー表現は使用しない。

updated フロントマターと Git プラグインの使い分け:
git-revision-date-localized はサイト上の表示用として Git のコミット日を自動取得する。一方、フロントマターの updated は内容を実質的に更新した日付を手動で記録する。typo修正やメタデータ変更のみの場合は updated を変更しない。この区別により、「内容が最後に見直された日」を正確に追跡できる。

7.2 ナビゲーション構造¶

nav:
  - ホーム: index.md

  - 評価（知識基盤）:
    - 概要: valuation/index.md
    - 土地評価:
      - 概要: valuation/land/index.md
    - 家屋評価:
      - 概要: valuation/building/index.md
    - 償却資産評価:
      - 概要: valuation/depreciable/index.md
    - 評価共通:
      - 概要: valuation/common/index.md

  - 賦課業務:
    - 概要: levy/index.md

  - 減免・非課税・課税免除:
    - 概要: exemption/index.md

  - 統計:
    - 概要: statistics/index.md

  - 登記所連携:
    - 概要: registry/index.md

  - eLTAX連携:
    - 概要: eltax/index.md

  - システム:
    - 概要: system/index.md

  - 法令・通達:
    - 概要: laws/index.md
    - 地方税法: laws/chihouzeihou/
    - 固定資産評価基準: laws/hyouka-kijun/
    - 通達・通知: laws/tsuuchi/

  - 判例・裁決例:
    - 概要: cases/index.md

  - 年度別まとめ:
    - 概要: annual/index.md
    - 課税年度別:
      - 一覧: annual/taxation/index.md
    - 評価替年度別:
      - 一覧: annual/revaluation/index.md

  - 参照:
    - 用語集: glossary.md
    - 参考文献: references.md
    - タグ一覧: tags.md

  - メタ情報:
    - 管理フロー: meta/management-flow.md
    - テンプレート: meta/templates.md
    - 変更履歴: meta/changelog.md

8. タグ運用ルール¶

8.1 タグの粒度ガイドライン¶

レイヤー	例	説明
資産区分	`土地`, `家屋`, `償却資産`	資産をまたいで使う場合に付与
制度・概念	`路線価`, `再建築費`, `耐用年数`, `免税点`	固定資産税の主要概念
法令	`地方税法`, `評価基準`, `取扱通知`	根拠法令の区分
業務	`賦課`, `縦覧`, `審査申出`, `申告`, `減免`	業務プロセスの名称
外部連携	`登記所`, `eLTAX`, `総務省`	連携先の機関
評価替え年度	`R6評価替え`, `R9評価替え`	評価替えサイクルに紐づく情報

8.2 タグの命名規則¶

日本語で記述する（検索利便性のため）
表記揺れを避けるため glossary.md の用語表記と統一する
新しいタグを追加したら tags.md の一覧にも反映する（Material for MkDocs のタグプラグインで自動生成可能）

9. Git 運用ルール¶

9.1 コミットメッセージ規約¶

{操作}: {対象の概要}

プレフィックス	用途
`add`	新規ナレッジの追加
`update`	既存ナレッジの更新
`fix`	誤りの修正
`refactor`	構造の変更（分割・統合・移動）
`meta`	管理系ファイルの更新

例:

add: 路線価方式の算定手順（valuation-land-001）
update: 賦課業務フローにeLTAX連携の手順を追記
fix: 経年減点補正率表の数値誤り修正

9.2 ブランチ戦略¶

個人利用のため main ブランチ単一運用とする。

10. 今後の拡張計画¶

フェーズ	内容	時期
Phase 1	基盤構築（リポジトリ、MkDocs設定、テンプレート配置）	初期
Phase 2	コンテンツ蓄積（評価の知識基盤から優先的に着手）	継続
Phase 3	AI連携強化（Claude Code ワークフロー最適化）	Phase 2と並行
Phase 4	業務プロセス領域の拡充	Phase 2以降
Phase 5	チーム共有への移行検討（必要に応じて）	将来

変更履歴¶

本セクションはこの管理フロー定義書自体の変更履歴。
サイト全体のナレッジ追加・構造変更の履歴は meta/changelog.md に記録する。

日付	バージョン	変更内容
2026-03-17	v1.0	初版作成

固定資産税ナレッジ 管理フロー定義書¶