type: claude-session · area: taiganjp · tags: auto-capture
session 2026 07 04 72183ab1
Claude Session Summary — TaiganJP site build & scaffolding (2026-07-04)
Auto-captured from a Claude Code session (cwd:
...\Temp\claude\...\72183ab1\scratchpad\gsc). Review, then file or delete. Note: this is the long-running parent of the 2026-07-05 continuation; heavy overlap — dedupe on review.
Session Purpose
The multi-week TaiganJP engine session: SEO/schema hardening, content-gap roadmap, glossary expansion, LM compliance guardrails, guide-scaffolding infrastructure, and a registry sync of guides/tools against watched-facts.yaml.
Decisions Made
| Decision | Rationale |
|---|---|
| Emit FAQPage JSON-LD on each guide (reuse getGuideQuestions()) | Comprehension + "People Also Ask" + AI Overview/LLM citation; low effort |
| Add /llms.txt curated index | Forward-looking for answer-engine era (ChatGPT/Perplexity/Google AI) |
| Split datePublished from lastVerified | Fix original-source freshness attribution vs scrapers |
| Backfill publishDate = lastVerified for now | All content is new, so equal dates are safe |
| /about leans on lived expertise + primary-source method, never names employer | E-E-A-T within LM compliance guardrails |
| AUDIT-FIRST mode: check if already implemented before redoing | Never restyle completed work; flag uncertain tax/immigration numbers as VERIFY |
Key Facts Established
- Guardrails: apply LM compliance to site + social — no employer branding, general educational only, VERIFY markers on any uncertain tax/legal number.
- Business Manager visa reform (¥30M) and treaty 183-day rule flagged for glossary/coverage.
- Guide scaffolding system built as infrastructure only (studied fbar-japan, sofa-retirement-tax-timing, marriage-in-japan-us-citizen as models) — no new guide content invented.
- Registry sync mapped VA cluster, working-remotely, WEP/GPO repeal, inheritance tool, /recommended hub figures into watched-facts.yaml.
Action Items
- Confirm http→https and www/apex redirects enforced (GSC saw an http:// variant)
- Run DRY_RUN=1 fact checker when ANTHROPIC_API_KEY available
Files / Artifacts Created
- content-gap-roadmap.md; guide-scaffolding system; watched-facts.yaml registry entries; per-guide FAQ schema; /llms.txt