mbrucedogs/ai-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: improve navigation and routing

Browse Source
This commit is contained in:
Matt Bruce 2026-02-11 10:31:47 -06:00
parent b00f480802
commit f4eebb604e
10 changed files with 50 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/ai/android.md
View File

@ -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).

5
docs/ai/cross-platform.md
View File

@ -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).

4
docs/ai/governance.md
View File

@ -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).

12
docs/ai/index.md
View File

@ -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

4
docs/ai/ios-xcodebuildmcp.md
View File

@ -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).

5
docs/ai/ios.md
View File

@ -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).

5
docs/ai/overview.md
View File

@ -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).

4
docs/ai/skills.md
View File

@ -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).

4
docs/ai/troubleshooting.md
View File

@ -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).

4
docs/ai/usage-tokens.md
View File

@ -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).