FoundationChat: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

FoundationChat is a SwiftUI application demonstrating Apple's Foundation Models framework for on-device AI. The project targets iOS 26.0+ and showcases chat functionality using Apple Intelligence.

Framework Overview

Apple's Foundation Models framework provides on-device large language models that power Apple Intelligence. It's available on iOS 26.0+, iPadOS 26.0+, macOS 26.0+, and visionOS 26.0+.

Key Documentation Files

1. EXAMPLES/FOUNDATION_MODELS_RULES.md

When to use: Start here for understanding core framework principles

• Availability checking patterns
• Session management rules
• Performance optimization guidelines
• Safety implementation requirements
• Platform requirements and limitations

2. EXAMPLES/QUICK_REFERENCE.md

When to use: For quick code snippets and common patterns

• Import statements
• Basic usage patterns
• Error handling snippets
• Common configurations

3. EXAMPLES/01_Basic_Usage.md

When to use: For simple text generation tasks

• Creating sessions
• Basic prompting
• Handling availability states
• Error handling basics
• Multi-turn conversations

4. EXAMPLES/02_Structured_Output.md

When to use: When you need structured data from the model

• @Generable macro usage
• @Guide annotations
• Complex nested structures
• Optional properties
• Performance considerations

5. EXAMPLES/03_Streaming_Responses.md

When to use: For real-time UI updates during generation

• Basic streaming implementation
• Streaming with structured output
• Progress tracking
• Error handling in streams
• SwiftUI integration

6. EXAMPLES/04_Tool_Calling.md

When to use: When the model needs external data/actions

• Tool protocol implementation
• Integration with system frameworks (Contacts, Calendar, etc.)
• Stateful tools
• Multiple tool usage

7. EXAMPLES/05_Performance_and_Safety.md

When to use: For optimization and safety implementation

• Prewarming strategies
• Schema optimization
• Safety boundaries
• Context management
• Performance monitoring