通勤認定エクセルツール対応13 M1 対応2

AGENTS.md

@@ -25,13 +25,46 @@
 - ❌ Forbidden: hardcoded file paths or connection strings. Use config sheet or constants module
 - ❌ Forbidden: non-English comments (Chinese / Japanese / Korean)
 
-## Project Structure
+### Code Review Checklist
+
+**Before editing**
+- Read the entire function from first line to last line (not just the lines you plan to change)
+- Find all call sites that reference the function or data structure you are about to modify
+
+**After editing**
+- Read the entire function from first line to last line again
+- Verify: are all variables declared, are scopes correct, is the logic complete
+- Go through every call site one by one to confirm compatibility
+
+**When the user asks "Are you sure?"**
+- Actually re-read the relevant code instead of saying "looks fine"
+- grep all references and verify them one by one
+
+**Key principle**
+- Never skip context — do not look at only the diff and call it done
+- The compiler cannot catch logic errors or missing variable declarations — only human review can
+- Read the whole function, read all call sites — no exceptions
+
+## Design Document
+
+**Primary reference**: `documents/Tukin_Design_Document.md`
+
+Before editing any sheet class or cache logic, **read the design document first**. It contains:
+- Sheet column layouts with HeaderRow/StartRow/StartCol/EndCol per `RefreshSheetDict`
+- Cache key/value structures for every CACHE_* constant
+- Data flow diagrams for C1 editing cascade and CSV import
+- Column layout reference (C1 has 58 columns, C to BG)
+- All known issues and their fix status
+
+**Rule**: Do not guess sheet layout or cache structure. Look it up in the design document.
 
 vba/
   AGENTS.md, README.md, .gitignore, LICENSE
   通勤手当テンプレート2026xxxx.xlsm  (latest date version)
   data/                     CSV master data (14 files)
-  documents/                design docs (3 files)
+  documents/                design docs
+    Tukin_Design_Document.md  — master design doc: sheet layouts, cache architecture, column reference, data flow
+    checklist-2026-05-27.md  — audit checklist (historical)
   sql/                      DB definitions (4 files)
   src/sh/
     juk/                    address module
@@ -55,13 +88,13 @@ vba/
         M2.cls (400 lines) - section detail master
         O1.cls (5 lines) - address master
         O2.cls (6 lines) - sender master (507)
-        O3.cls (61 lines) - master 225
+        O3.cls (61 lines) - (220) notification reason
         T1.cls (54 lines) - commutation pass master
         T2.cls (114 lines) - ticket master
         T3.cls (74 lines) - master 246
         Z1.cls (64 lines) - transport master (222)
         Z2.cls (54 lines) - decision master (223)
         Z3.cls (57 lines) - monthly amount decision master (224)
-        Z4.cls - master Z4
+        Z4.cls - (221) route station name
 
 Sheet class prefixes: C=commuter editing, M=section master, O=other, T=commuter route, Z=master config