IntentTodo

IntentTodo

App Intents 中心設計に基づいたマルチプラットフォーム Todo アプリです。

特徴

• App Intents 中心設計: すべてのアクションを App Intent として定義し、Button(intent:) で統一的に実行
• SwiftData: モダンなデータ永続化（CloudKit対応）
• マルチプラットフォーム: iOS / iPadOS / macOS（ネイティブ）/ watchOS / visionOS 対応
• Extension対応: Widget / Live Activity / Control Center / Complication / Siri Shortcuts / Spotlight / 集中モード
• WWDC 2026 の App Intents 要素を網羅検証: App Schema / Visual Intelligence / AppIntentsTesting / UndoableIntent / LongRunningIntent / SyncableEntity など（採用状況は docs/APP_INTENTS_API_COVERAGE.md）
• TDD: テスト駆動開発で実装

要件

• iOS 27.0+ / macOS 27.0+ / watchOS 27.0+ / visionOS 27.0+
• Xcode 27.0+
• Swift 6.0+

App Intents 中心設計の適応状況

プラットフォーム別

5 プラットフォームとも出荷済み（1.1.4）で、各面を一通り触っている。 下の「検証状況」は画面とアクションが実機で動いていることを指す。 Siri の音声経路 / Spotlight の実 UI での見え方 / 通知の cold start など、 出荷しただけでは分からないものは #30 に残っている。

Extension別

定義済み AppIntent 一覧（25 本）

すべての Intent を TodoAppIntents SPM パッケージに集約。Extension からも import TodoAppIntents で参照する。 SwiftData を書き換える Intent は allowedExecutionTargets = [.main] を宣言する（表の「本体固定」列）。

Entity / Query

アーキテクチャ

IntentTodo/
├── IntentTodo/                  # アプリターゲット (App.init で AppDependencyManager 登録)
│   ├── TodoAppShortcuts.swift   # ★AppShortcutsProvider はここ必須（パッケージ不可）
│   └── SceneDelegate.swift      # AppIntentSceneDelegate（cold start のナビゲーション）
├── IntentTodoWidget/            # Widget + Control Center (WidgetBundle.init でも登録)
├── IntentTodoLiveActivity/      # Live Activity
├── IntentTodoWatchApp/          # watchOS アプリ + Complication
├── IntentTodoUITest/            # XCUITest + AppIntentsTesting（Intent の実経路テスト）
└── Packages/
    ├── Domain/                  # データモデル（SwiftData @Model）, ActivityAttributes
    ├── Repository/              # データアクセス層
    ├── TodoAppIntents/          # ★コア：全 Intent + TodoService + Entity / Query + ヘルパー
    ├── UI/                      # iOS/iPadOS/macOS/visionOS の Views, ViewModels
    ├── LiveActivity/            # ActivityKit 管理 + ロック画面 View（iOS 限定）
    ├── WidgetUI/                # ホームウィジェットの View
    └── WatchUI/                 # watchOS の View + Complication View（watchOS 限定）

依存関係

Domain ← Repository ← TodoAppIntents ← UI / LiveActivity / WidgetUI / WatchUI ← App / Extensions

DI パターン

@Dependency var todoService: TodoService / @Dependency var navigationModel: NavigationModel で Intent から共有状態にアクセス。AppDependencyManager.shared.add(dependency:) を App.init() と WidgetBundle.init() で同期登録することで、各プロセスで @Dependency が解決される。

登録漏れはクラッシュせず「無音の失敗」になる（stderr に Failed to retrieve dependency of type X が出るだけで、Button(intent:) 経由では画面が何も変わらない）。そのプロセスで走る Intent が触る依存は全部登録する。

設計思想

従来の MVVM では ViewModel や UseCase にビジネスロジックを配置しますが、本プロジェクトでは App Intent がアプリ機能の唯一の入口 です。UseCase 層をパッケージとして持たない代わりに、ユースケースの宣言（名前・引数・戻り値）を App Intent が、実装（手続き・不変条件・副作用）を TodoService が受け持ちます。

Layered / Clean Architecture との対比（対応表・砂時計図・コードの置き場を決める判定ルール）は docs/APP_INTENT_DRIVEN_DESIGN.md にまとめています。

役割分担

Button(intent:) による宣言的なIntent実行

import AppIntents  // ← 必須

// ✅ 推奨: Button(intent:) を直接使用
Button(intent: ToggleTodoCompletionIntent(todo: entity)) {
    Image(systemName: "checkmark.circle")
}

// フォーム入力が必要な場合は Computed Property で動的生成
private var addTodoIntent: AddTodoIntent {
    AddTodoIntent(title: title, dueDate: dueDate)
}

Button(intent: addTodoIntent) {
    Text("Add")
}

• Siri/ショートカットと同じ実行経路
• Task/async のボイラープレートが不要
• SwiftData の @Query と組み合わせてリアクティブな更新

セットアップ

1. リポジトリをクローン

git clone https://github.com/touyou/IntentTodo.git
cd IntentTodo

2. Xcode でプロジェクトを開く

open IntentTodo.xcodeproj

3. ビルド & 実行

テスト

3 層で分担している（詳細は docs/TESTING.md）。

cd Packages/Domain && swift test
cd Packages/Repository && swift test
cd Packages/TodoAppIntents && swift test
cd Packages/UI && swift test

提出用スクリーンショット

./scripts/capture_screenshots.sh              # 全プラットフォーム × ja / en
./scripts/capture_screenshots.sh iphone       # 一部だけ撮り直す

DEBUG 限定の ScreenshotFixture（Domain）が in-memory ストアに ja / en それぞれのサンプルを 流し込むので、何度撮っても同じ画面になる。出力は Screenshots/<platform>/<locale>/（gitignore）。

いずれも App Store Connect が受け付ける寸法。ASC へ入れる文言は docs/APP_STORE_LISTING.md。

App Shortcuts

8 件を IntentTodo/TodoAppShortcuts.swift（アプリターゲット直下）で定義。 フレーズにはできるだけパラメータ（AppEntity / AppEnum）を埋め込んでいる。

Agent Skills として配布

このリポジトリは、本プロジェクトで蓄積した App Intent 中心設計の知見を Agent Skills として再利用できる形で同梱しています。Claude Code / Codex / Gemini CLI / GitHub Copilot / Cursor で同じファイルが動きます。

• 配布物: skills/ 配下の 9 skill + plugin.json（Agent Plugins）/ .claude-plugin/ / .agents/plugins/ のマニフェスト
• 場面ごとに分割されていて、「ウィジェットにボタンを付けたい」「押しても何も起きない」「訳が反映されない」のようにやりたいこと / 症状で発火する
• 各 skill の分担とスクリプトは skills/README.md、エージェント別のインストールと公開手順は skills/INSTALL.md を参照

ドキュメント

現在のルール

• AGENTS.md - エージェント / 開発者向けの入口（環境・非交渉ルール・全ドキュメントの目次）
• docs/AGENTS.md - App Intents 中心設計ガイド（思想・核心原則・実装時に確認すること）
• docs/APP_INTENT_DRIVEN_DESIGN.md - 関連概念の整理と比較（Layered / Clean Architecture との対比）
• docs/CODING_GUIDELINES.md - Swift / SwiftUI / ローカライズ / コメントの規約
• docs/TESTING.md - テストの 3 層と「緑になる嘘テスト」を避けるルール
• docs/INSIGHTS.md - 開発中に得られた技術的インサイト（目次→7トピック別ファイル）

API の地図

• docs/APP_INTENTS_API_COVERAGE.md - App Intents API の採用状況マップ（採用済み / 意図的不使用 / 対象外 / 未採用候補）
• docs/WWDC_APP_INTENTS_SESSIONS.md - WWDC 2022〜2026 のセッション別 API 一覧と非推奨タイムライン
• docs/APP_INTENTS_CENTRIC_PLAN.md - WWDC 2026 要素の検証結果（何をどこまで検証したか）
• docs/PLAN.md - 開発計画（要件・マルチプラットフォーム展開マトリクス）

経緯と残タスク

• docs/devlog/ - 各ルールがどういう調査・失敗・再検証を経て今の形になったか
• GitHub issues - これからやること（実機検証 #30 / GM SDK 棚卸し #57 / 未採用 API の消化 #68）
• docs/presentation/ - 登壇用のスライド骨子と想定スクリプト

ドキュメントは「現在のルール（docs）/ 経緯（devlog）/ 残タスク（issue）」の三分割で運用している。 詳細は AGENTS.md の「ドキュメント運用」。

ライセンス

MIT License - 詳細は LICENSE を参照してください。