AI-Assisted Development

You: "Add a favorites feature. Users should be able to bookmark conversations
     and see them in a dedicated tab."

Claude Code:
  - Reads AGENTS.md / docs/CLAUDE.md and the existing module structure
  - Creates SwiftData model in Storage package
  - Adds FavoritesRepository with protocol
  - Builds FavoritesViewModel (@Observable) following MVVM pattern
  - Creates FavoritesView using DesignSystem tokens
  - Wires dependencies through CompositionRoot
  - Runs build to verify compilation

You: "Create a new chat settings view"

Cursor generates code with:
  - DSColors, DSTypography, DSSpacing (DesignSystem tokens)   ✅
  - Protocol-based dependencies (testable)                    ✅
  - Under 400 lines (properly composed)                       ✅
  - Loading and error states                                  ✅
  - Accessibility labels                                       ✅

struct ProfileView: View {
  @State var user: User?

  var body: some View {
    VStack {
      Image(systemName: "person.circle")
        .font(.system(size: 80))
        .foregroundColor(.blue)  // ❌ Hardcoded color

      Text(user?.name ?? "")
        .font(.title)  // ❌ Not from DesignSystem

      Button("Sign Out") {  // ❌ No error handling
        AuthManager.shared.signOut()  // ❌ Direct dependency
      }
      .padding()
      .background(Color.red)  // ❌ Hardcoded color
    }
  }
}

import SwiftUI
import DesignSystem
import Auth
import Core

struct ProfileView: View {
  @State private var viewModel: ProfileViewModel

  var body: some View {
    ScrollView {
      VStack(spacing: DSSpacing.lg) {
        Circle()
          .fill(DSColors.primary)
          .frame(width: 80, height: 80)
          .overlay {
            Text(viewModel.user?.name?.prefix(1).uppercased() ?? "")
              .font(DSTypography.titleL)
              .foregroundStyle(.white)
          }

        VStack(spacing: DSSpacing.sm) {
          Text(viewModel.user?.name ?? "Loading...")
            .font(DSTypography.titleM)

          if let email = viewModel.user?.email {
            Text(email)
              .font(DSTypography.body)
              .foregroundStyle(DSColors.textSecondary)
          }
        }

        SAIButton("Sign Out", style: .secondary, layout: .block) {
          Task { await viewModel.signOut() }
        }
        .padding(.top, DSSpacing.lg)
      }
      .padding(DSSpacing.lg)
    }
    .navigationTitle("Profile")
    .alert("Error", isPresented: Binding(
      get: { viewModel.errorMessage != nil },
      set: { if !$0 { viewModel.errorMessage = nil } }
    )) {
      Button("OK") { viewModel.errorMessage = nil }
    } message: {
      Text(viewModel.errorMessage ?? "")
    }
    .task { await viewModel.load() }
  }
}

@MainActor
@Observable
final class ProfileViewModel {
  var user: AuthUser?
  var isLoading = false
  var errorMessage: String?

  private let authClient: any AuthClient

  init(authClient: any AuthClient) {
    self.authClient = authClient
  }

  func load() async {
    isLoading = true
    defer { isLoading = false }
    user = await authClient.currentUser()
  }

  func signOut() async {
    isLoading = true
    errorMessage = nil
    defer { isLoading = false }

    do {
      try await authClient.signOut()
      AppLogger.info("User signed out", category: AppLogger.auth)
    } catch {
      errorMessage = AppError.from(error).localizedUserMessage
      AppLogger.error("Sign out failed: \(error)", category: AppLogger.auth)
    }
  }
}

{
  "chatModes": {
    "my-mode": {
      "name": "My Mode",
      "description": "What this mode does",
      "systemPrompt": "Instructions for AI",
      "context": ["paths/to/focus/on"],
      "tools": ["codeGeneration", "fileManagement"]
    }
  }
}