# Working in This Repo — Start Here

**TLDR:** Build with the solution defaults, validate UI changes live on a simulator, keep
spec-doc timestamps honest (the pre-commit hook checks), never write bare `#<number>` in
anything that lands in Azure DevOps, and know which branches auto-merge before you set
auto-complete. Everything else below routes you to the depth you need.

## Find your topic by role

| You are… | Read |
|---|---|
| **App developer** (C#/Razor/CSS) | [Engineering Conventions](ENGINEERING-CONVENTIONS.md) → then [Git & DevOps](GIT-DEVOPS-CONVENTIONS.md) |
| **Anyone opening PRs or touching work items** | [Git & DevOps Conventions](GIT-DEVOPS-CONVENTIONS.md) |
| **Docs author** (component specs, detail docs) | [Doc Standards](DOC-STANDARDS.md) |
| **Tester** | [tester-guide.html](tester-guide.html) — onboarding to the in-app readiness dashboard + [Tester Walkthroughs](walkthroughs/) (screenshot smoke tests per feature) · [testing.html](testing.html) for the automated Appium/NUnit suite and beta groups |
| **Backend / integration** | Backend Handoff Tracker in [backend-api-mapping-report.html](../component-specifications/backend-api-mapping-report.html) |
| **Designer** | [design-questions.html](../component-specifications/design-questions.html) (open questions) · component specs under `docs/component-specifications/` |

## Operational references (task-specific)

| Task | Doc |
|---|---|
| Build / run / environment setup | [development.html](development.html) |
| NuGet feed auth (Credential Provider / fallback token) for `ALPAShared` restores | [Git & DevOps Conventions § NuGet feed authentication](GIT-DEVOPS-CONVENTIONS.md#nuget-feed-authentication) |
| Unit + UI test suites | [testing.html](testing.html) |
| Crash investigation (Sentry, logcat, dSYMs) | [crash-investigation-workflow.html](crash-investigation-workflow.html) |
| Performance profiling (xctrace) | [profiling.html](profiling.html) |
| Figma → spec sync procedure | [figma-sync-procedure.html](figma-sync-procedure.html) |
| Spec → shared component library reconciliation | [component-library-reconciliation-procedure.html](component-library-reconciliation-procedure.html) |
| Pending-work inventory for a feature area (chain before panels / graduations / builds) | [preflight-readiness-check.html](preflight-readiness-check.html) |
| Multi-agent fresh-context UX scrutiny pass | [fresh-eyes-panel-procedure.html](fresh-eyes-panel-procedure.html) |
| Layer rules & project structure | [N-TIER-ARCHITECTURE.md](N-TIER-ARCHITECTURE.md) |
| Per-feature GAP + N-Tier alignment audit | [FEATURE-ALIGNMENT-CHECK.md](FEATURE-ALIGNMENT-CHECK.md) |
| Dynamic UI first stop — pipeline walkthrough with screenshots, links to every layer | [dynamic-ui-hub.html](dynamic-ui-hub.html) |
| Server-driven (dynamic feed) UI architecture | [dynamic-ui-architecture.html](dynamic-ui-architecture.html) |
| What the app does today / what's planned | [features.html](features.html) · [roadmap.html](roadmap.html) |
| Push payload contract · NH testing plan | [push-notification-payload.html](push-notification-payload.html) · [azure-nh-testing-plan.html](azure-nh-testing-plan.html) |
| Plans & assessments (migration, infra split, WI-1908) | [dotnet10-migration.html](dotnet10-migration.html) · [infrastructure-split-plan.html](infrastructure-split-plan.html) · [UI-READINESS-1908.md](UI-READINESS-1908.md) · [BACKEND-HANDOFF-1908-CAN-REST.md](BACKEND-HANDOFF-1908-CAN-REST.md) |
| FTDT rest-rules sync data-integrity test plan (AB#2219) | [FTDT-REST-RULES-TEST-PLAN.md](FTDT-REST-RULES-TEST-PLAN.md) |

Each conventions doc opens with its own TLDR box — read that first; drill into the detail
sections only when the task at hand needs them.