Add AI recipe documentation

docs/ai/RECIPE.md

@@ -0,0 +1,62 @@
+# iOS lyrics view with RTC media
+
+## Overview
+
+Render synchronized lyrics in an iOS RTC audio experience for karaoke, music, or live media apps.
+
+Use this recipe when you want a working reference for iOS UI, lyrics rendering, RTC audio, synchronization.
+
+Repository: [AgoraIO-Community/LrcView-iOS](https://github.com/AgoraIO-Community/LrcView-iOS)
+
+## Prerequisites
+
+- An Agora account and project App ID.
+- The platform toolchain required by this repository.
+- A test device, simulator, browser, or runtime that supports the sample's audio/video path.
+- A second RTC client or sample instance for validating remote publish and subscribe behavior.
+
+## Configure
+
+Create or update the project configuration with:
+
+- `AGORA_APP_ID`
+
+For local testing, some Agora projects allow tokenless joins when App Certificate is disabled. For production, generate RTC tokens on a trusted server and renew them before expiration.
+
+For iOS, include camera and microphone usage descriptions and handle permission prompts before joining.
+
+## Run The Sample
+
+Open the iOS project, configure the Agora App ID, install dependencies if the README requires CocoaPods or Swift Package Manager, then run on a physical device or simulator that supports the sample flow. Join from a second client to verify remote media.
+
+## What To Check
+
+- The app registers Agora RTC event handlers before joining a channel.
+- Local media preview or local audio state appears after permissions are granted.
+- Remote users are rendered or heard when they publish audio/video.
+- `user-published` or native user-joined callbacks are handled for each media type the sample supports.
+- Leaving the channel stops local capture and releases RTC resources.
+
+## Production Notes
+
+- Never ship an App Certificate or privileged token generator in a client app.
+- Renew tokens from the SDK expiration callback before the current token expires.
+- Use subscriber/audience roles for users who should not publish media.
+- Keep UID types consistent across clients in the same channel.
+- For browser-based samples, deploy over HTTPS except when testing on `localhost`; for native samples, validate camera, microphone, and audio routing permissions on target devices.
+
+## Implementation Prompt
+
+```text
+You are working in `AgoraIO-Community/LrcView-iOS`. Add or adapt this sample so a developer can run the ios lyrics view with rtc media end to end with Agora RTC.
+
+Goals:
+- Preserve the existing sample architecture and README commands.
+- Configure Agora credentials through environment variables or the platform-native configuration already used by the repo.
+- Register RTC event handlers before joining the channel.
+- Join a test channel, publish local media when the sample role allows it, and subscribe to remote users.
+- Clean up RTC resources when leaving the channel or closing the app.
+- Add production notes for token generation, renewal, and audience-only subscriber roles where applicable.
+
+Validate by running the project-specific build or launch command from the README and testing with a second client in the same channel.
+```