diff --git a/docs/ai/android.md b/docs/ai/android.md index 520d2ef..48b28e6 100644 --- a/docs/ai/android.md +++ b/docs/ai/android.md @@ -61,3 +61,8 @@ Refactor this file to reduce duplication without changing behavior. - Copilot access not provisioned for the GitHub account. - VS Code extension disabled after an update. - Multiple AI extensions competing for suggestions. + +## Next Steps +- For workflow patterns, read [Cross-Platform AI Usage](cross-platform.md). +- For safety rules, read [Governance, Privacy, and Policy](governance.md). +- For cost guidance, read [Usage and Token Budgeting](usage-tokens.md). diff --git a/docs/ai/cross-platform.md b/docs/ai/cross-platform.md index 14066e9..501fe1c 100644 --- a/docs/ai/cross-platform.md +++ b/docs/ai/cross-platform.md @@ -155,3 +155,8 @@ Use the build MCP tool to run the build and summarize any errors. ### Where To Learn More - iOS examples: see [iOS Setup](ios.md) - Android examples: see [Android Setup](android.md) + +## Next Steps +- If you need skills guidance, read [Skills Library](skills.md). +- For safety rules, read [Governance, Privacy, and Policy](governance.md). +- If setup is not working, follow [Troubleshooting and FAQ](troubleshooting.md). diff --git a/docs/ai/governance.md b/docs/ai/governance.md index a893801..23e51ea 100644 --- a/docs/ai/governance.md +++ b/docs/ai/governance.md @@ -44,3 +44,7 @@ Example prompt: ```text Is it ok to share this log snippet with user IDs in Copilot? ``` + +## Next Steps +- For day-to-day workflows, read [Cross-Platform AI Usage](cross-platform.md). +- For cost guidance, read [Usage and Token Budgeting](usage-tokens.md). diff --git a/docs/ai/index.md b/docs/ai/index.md index 9f44704..1ba047e 100644 --- a/docs/ai/index.md +++ b/docs/ai/index.md @@ -14,6 +14,12 @@ Follow the steps in order. Do not skip ahead if this is your first time. 3. Skim [Usage and Token Budgeting](usage-tokens.md) 4. Return to [Cross-Platform AI Usage](cross-platform.md) +## Guided Paths (Pick One) +- New to AI: [AI Overview](overview.md) -> [Cross-Platform AI Usage](cross-platform.md) -> [Usage and Token Budgeting](usage-tokens.md) +- iOS setup: [AI Overview](overview.md) -> [iOS Setup](ios.md) -> [XcodeBuildMCP (iOS)](ios-xcodebuildmcp.md) +- Android setup: [AI Overview](overview.md) -> [Android Setup](android.md) -> [Cross-Platform AI Usage](cross-platform.md) +- Contributors: [AI Overview](overview.md) -> [Governance, Privacy, and Policy](governance.md) -> [Troubleshooting and FAQ](troubleshooting.md) + ## If You Are New 1. Read the overview to understand terms and guardrails. 2. Follow the setup guide for your platform. @@ -28,12 +34,14 @@ If you will edit these docs, start with the "Key Repo Files" section in the over - [iOS Setup](ios.md) - [Android Setup](android.md) -## Usage Guides +## Use AI Day-To-Day - [Cross-Platform AI Usage](cross-platform.md) - Agents, instructions, prompting patterns, MCP overview, and workflow tips - [Skills Library](skills.md) + +## Safety And Cost +- [Governance, Privacy, and Policy](governance.md) - [Usage and Token Budgeting](usage-tokens.md) - [Troubleshooting and FAQ](troubleshooting.md) -- [Governance, Privacy, and Policy](governance.md) ## iOS MCP Details - [XcodeBuildMCP (iOS)](ios-xcodebuildmcp.md) - Full MCP setup and usage for Xcode workflows diff --git a/docs/ai/ios-xcodebuildmcp.md b/docs/ai/ios-xcodebuildmcp.md index b833013..f9bd59f 100644 --- a/docs/ai/ios-xcodebuildmcp.md +++ b/docs/ai/ios-xcodebuildmcp.md @@ -170,3 +170,7 @@ Apple announced that Xcode 26.3 exposes Xcode capabilities through the Model Con ### Source https://www.apple.com/newsroom/2026/02/xcode-26-point-3-unlocks-the-power-of-agentic-coding/ + +## Next Steps +- For iOS setup basics, read [iOS Setup](ios.md). +- For cross-platform usage patterns, read [Cross-Platform AI Usage](cross-platform.md). diff --git a/docs/ai/ios.md b/docs/ai/ios.md index cfc851a..7c1b973 100644 --- a/docs/ai/ios.md +++ b/docs/ai/ios.md @@ -82,3 +82,8 @@ The detailed MCP setup and XcodeBuildMCP guidance is in a dedicated page: - Copilot access not provisioned for the GitHub account. - Xcode plugin disabled after update. - Multiple AI plugins competing for suggestions. + +## Next Steps +- For workflow patterns, read [Cross-Platform AI Usage](cross-platform.md). +- For MCP automation, read [XcodeBuildMCP (iOS)](ios-xcodebuildmcp.md). +- For safety rules, read [Governance, Privacy, and Policy](governance.md). diff --git a/docs/ai/overview.md b/docs/ai/overview.md index 339517d..2a33e42 100644 --- a/docs/ai/overview.md +++ b/docs/ai/overview.md @@ -198,6 +198,11 @@ Example prompt: Refactor only the validation logic in this file. Keep behavior the same and list tests to update. ``` +## Next Steps +- If you have not set up an editor yet, go to [iOS Setup](ios.md) or [Android Setup](android.md). +- For day-to-day usage patterns, read [Cross-Platform AI Usage](cross-platform.md). +- For safety and cost guidance, read [Governance, Privacy, and Policy](governance.md) and [Usage and Token Budgeting](usage-tokens.md). + ## Getting Help - Ask your team lead or the AI docs owner. - Use the escalation guidance in [Troubleshooting and FAQ](troubleshooting.md). diff --git a/docs/ai/skills.md b/docs/ai/skills.md index f77e3cc..9f59918 100644 --- a/docs/ai/skills.md +++ b/docs/ai/skills.md @@ -86,3 +86,7 @@ Do not list every skill in this guide. Instead, point readers to a single repo t ### Link To The Assets Repo - Repo: (link) +## Next Steps +- For day-to-day workflows, read [Cross-Platform AI Usage](cross-platform.md). +- For setup issues, follow [Troubleshooting and FAQ](troubleshooting.md). + diff --git a/docs/ai/troubleshooting.md b/docs/ai/troubleshooting.md index e372ea7..2391b3d 100644 --- a/docs/ai/troubleshooting.md +++ b/docs/ai/troubleshooting.md @@ -60,3 +60,7 @@ Copilot suggestions stopped in VS Code 1.92 after extension update. Restarted, s - Account access issues after setup. - Consistent failures across multiple editors. - Policy or security concerns. + +## Next Steps +- For setup steps, read [AI Overview](overview.md). +- For safe usage rules, read [Governance, Privacy, and Policy](governance.md). diff --git a/docs/ai/usage-tokens.md b/docs/ai/usage-tokens.md index ddc2b9c..d787fa7 100644 --- a/docs/ai/usage-tokens.md +++ b/docs/ai/usage-tokens.md @@ -196,3 +196,7 @@ Agent: Refactor these two files, update tests, and summarize results. - Is the request specific and scoped? - Do I need the whole file or just a section? - Can I ask for a plan first? + +## Next Steps +- For workflow patterns, read [Cross-Platform AI Usage](cross-platform.md). +- For troubleshooting, read [Troubleshooting and FAQ](troubleshooting.md).