retirement-syncing

退職口座の同期

データソース：CSV のみ（ライブ経路はまだありません）

ほかの同期スキルとは異なり、退職口座では 同期優先＋DB 読み取り のパターンを使用しません。Vanguard の IRA／証券口座と Fidelity の 401(k) は、SnapTrade で認可されていません（config/snaptrade-accounts.yaml で連携されているのは、課税対象の Fidelity マージン口座 1 つのみです）。そのため、これらの口座について family_office.db に更新できるライブ API スナップショットはなく、CSV エクスポートが引き続き唯一のデータソースです。これは、共通の 同期優先＋DB 読み取り パターンに対する、意図的に文書化された例外です。

ライブ経路を利用するための前提条件（このスキルを DB 対応にする前に必要です）：

1. Vanguard と Fidelity の退職口座を SnapTrade で認可します。
2. 認可によって追加された各口座を config/snaptrade-accounts.yaml に追加し、role を設定して enabled: true にします。
3. ポジション同期（または退職口座専用の同期）を拡張して、これらの口座を DB に書き込むようにしたうえで、このスキルをステップ 0 の更新＋DB 読み取りに書き換えます。

3 つすべてが完了するまでは、ライブ経路をでっち上げず、以下の CSV ワークフローを使用してください。

目的

Vanguard と Fidelity の退職口座の CSV エクスポートを解析し、現在の保有銘柄と数量を報告します。

⚠️ このスキルには現在、永続的な保存先がありません。 以前書き込み先として使用していた Google Sheets DataHub は 2026-07-31 に廃止されており、これらの口座は SnapTrade に登録されていないため、family_office.db に退職口座のテーブルはありません。上記の 3 つの前提条件が満たされるまでは、このスキルは解析と報告のみを行います。保有銘柄がどこかに「同期された」と主張しないでください。

使用するタイミング

次の場合にこのスキルを使用します：

• imports/retirement/ から退職口座のポジションを同期するとき
• ユーザーが「sync retirement」「update retirement」「vanguard sync」「401k update」「IRA sync」と言及したとき
• imports/retirement/ ディレクトリ内のファイルを扱うとき

ソースファイル

場所：imports/retirement/

ファイル	ソース	内容
OfxDownload.csv	Vanguard IRA	口座 <ira-1> と <ira-2> の保有銘柄
OfxDownload (1).csv	Vanguard 証券口座	口座 <brokerage-1> と <brokerage-2> の保有銘柄
Portfolio_Positions_*.csv	Fidelity 401(k)	{employer_name} 401(k) プランの保有銘柄

CSV 形式

Vanguard OFX 形式（OfxDownload.csv）

Account Number,Investment Name,Symbol,Shares,Share Price,Total Value,
<account-number>,VANGUARD S&P 500 INDEX ETF,VOO,18.1817,629.3,11441.74,

主なフィールド：

• 列 3：銘柄記号
• 列 4：株数（数量）

Fidelity 401k 形式（Portfolio_Positions_*.csv）

Account Number,Account Name,Symbol,Description,Quantity,Last Price,...
86689,{employer_name} 401(K) PLAN,FGCKX,FID GROWTH CO K,4.447,$50.04,...

主なフィールド：

• 列 3：銘柄記号
• 列 5：数量

既知の退職口座の銘柄記号

Vanguard の IRA、Vanguard 証券口座、Fidelity 401(k) で確認された保有銘柄： VOO、VUG、VTSAX、SCHG、PLTR、NVDA、TSLA、VB、ARKK、VMFXX、FGCKX、FXAIX。

Mary の Goucher 403(b) と Principal 401(k) の配分は、別途 user-profile.yaml と戦略ドキュメントで管理されており、このスキルでは扱いません。

基本的なワークフロー

1. すべての CSV ファイルを読み込む

# Read Vanguard files
vanguard_1 = read_csv("imports/retirement/OfxDownload.csv")
vanguard_2 = read_csv("imports/retirement/OfxDownload (1).csv")

# Read latest Fidelity file (by date in filename)
fidelity = read_csv("imports/retirement/Portfolio_Positions_*.csv")

2. 銘柄記号ごとに保有数量を集計する

同じ銘柄記号が複数の口座に含まれることがあるため、数量をすべて合計します：

holdings = {}
for file in [vanguard_1, vanguard_2, fidelity]:
    for row in file:
        ticker = row['Symbol']
        shares = float(row['Shares'] or row['Quantity'])
        holdings[ticker] = holdings.get(ticker, 0) + shares

想定される集計：

• VOO：口座間で合計（IRA＋証券口座）
• VUG：口座間で合計
• PLTR：口座間で合計（<brokerage-1>＋<brokerage-2>）
• SCHG：口座間で合計
• VMFXX：口座間で合計（すべてのマネーマーケット口座）
• VTSAX：口座間で合計

3. 集計した保有銘柄を報告する

銘柄記号と合計数量を表にして回答に記載します。書き込み先はないため、報告そのものが成果物です。

安全性の確認

報告する前に：

• imports/retirement/ に CSV ファイルが 3 つすべて存在することを確認します
• 各 CSV のエクスポート日を確認し、30 日を超えて古いものがあればその旨を示します
• 既知の銘柄記号リストにない銘柄があれば指摘します

大幅な変動の警告（20% 超）： 前回報告した数値から数量が 20% を超えて変動している場合は、差分を示し、その数値を正確なものとして扱う前にユーザーに確認します。

更新後の検証

確認項目：

• すべての数量が正しく更新されている
• C列以降の数式が引き続き機能している
• 退職資産の合計額がCSVの合計額の合算とおおむね一致している
• 数式エラーが新たに発生していない

概要の記録：

Updated 12 retirement positions:
- VOO: NNN.NNNN shares
- VUG: NN.NNNN shares
- VTSAX: NNN.NNN shares
...
Total Retirement Value: sum of updated position values

重要なルール

書き込み可能な列

• B列：数量のみ

変更禁止

• A列：ティッカー（設定済み）
• C～S列：すべて数式

行の対応

退職セクションは46行目から始まります（45行目のヘッダーの後）。 46～62行目は退職資産の保有項目用に確保されています。

トリガーキーワード

• 「sync retirement」
• 「update retirement」
• 「retirement accounts」
• 「vanguard sync」
• 「401k update」
• 「IRA sync」
• 「retirement quantities」

---

教育目的のみです。投資助言ではありません。ここに記載されている退職資産の保有状況は、ブローカーのCSVエクスポートを解析したもので、エクスポート時点の情報に限られます。実際に行動する前に、プラン提供者に確認してください。資格を持つ金融および税務の専門家に相談してください。

スキルの種類：ドメイン（ワークフローガイダンス） 適用レベル：提案 優先度：中