[Sowmya Malayanur (somalaya)]

Summary

Add grounded Tier 1 context and validation/test entry points for the android-complete multi-repository integration workspace.

• Add root AGENTS.md with repository boundaries, setup, private-feed prerequisites, concrete build/test commands, and additional static-analysis/device/network/UI layers.
• Add scripts/verify.ps1 for core ADAL, Common, MSAL and Broker local-debug assembly, unit tests and lint (12 Gradle tasks in one invocation).
• Link the guide from README and existing Copilot instructions without replacing domain guidance.
• Explicitly distinguish independent ignored checkouts from Git submodules and document optional Authenticator/OneAuth scope.

No application code, dependencies, Gradle configuration, CI, publishing behavior, or nested-repository revisions are changed. No Tier 2 work is included.

Validation

• PowerShell syntax, git diff --check and all 20 local AGENTS links passed.
• Controlled script execution confirmed all 12 task arguments, repository-root execution, working-directory restoration on success/failure, and propagation of a nonzero Gradle exit.
• Attempted the actual verification gate: Gradle stopped evaluating settings.gradle:75 because vstsMavenAccessToken/private-feed credentials are missing. No build, unit-test or lint pass is claimed.
• This isolated root worktree does not contain the independent Android checkouts. A populated integration workspace and approved SDK/feed setup are required before executing the real tasks.
• Device, network/lab, UI, native integrity, optional-project and consumer tests were not run.

Northstar Tier 1 remains subject to reassessment after merge; documented commands do not certify execution or coverage.

Tracking

Related shared tracking: All Repos to Tier 1 — 3805178. This PR covers android-complete only and must not close that cross-repository item.

Fixes AB#3817124 — android-complete-specific implementation task, parented under 3805178. Merging this PR should complete only the child task; the shared parent remains open for other repositories and reassessment.

Risk

Low: documentation and an opt-in verification script only. Existing work in the original checkout was preserved.

[azure-pipelines]

Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

[github-actions]

❌ Work item link check failed. Description does not contain AB#{ID}.

Click here to Learn more.

[github-actions]

✅ Work item link check complete. Description contains link AB#3817124 to an Azure Boards work item.