// Instruction-to-skill navigation map. Use when routing tasks to the right instruction and skill files or migrating legacy guidance to the split-doc model.
Use ADB to connect devices, install Android debug builds, and troubleshoot deployment failures. Use for device detection errors, install failures, launch failures, package selection across flavors, and first-pass process checks. For deeper runtime investigation, prefer the Argent workflow.
Investigate Android runtime bugs with evidence-first Argent workflows. Use for emulator targeting, runtime console/network inspection, UI hierarchy capture, optional native traffic inspection, and root-cause analysis before changing code.
Capture quick Android UI evidence with explicit launches, UIAutomator dumps, and adb screenshots for fast visual debugging and reproducible repro notes.
Step-by-step module creation checklist. Use when adding a new Gradle module and wiring build, DI, and architecture integration correctly.
Android platform/helper layer guide for AniTrend. Use when working in `:android:*` modules or deciding whether to reuse or extend existing Android-side helpers for configuration/theme, context or fragment utilities, notification permission flows, deep links, drawer/app-shell behavior, or other platform APIs.
Diagnose and fix silent empty-UI bugs caused by CacheRequest enum collisions in AniTrend. Use when a new offline-first source variant produces blank UI with no crash, no exception, and the Room tables have zero rows. Covers: cache_log collision diagnosis, ADB Room database forensics, WAL checkpoint, Chucker traffic check, CacheRequest isolation fix, and Koin factory update pattern.
| name | reference-map |
| description | Instruction-to-skill navigation map. Use when routing tasks to the right instruction and skill files or migrating legacy guidance to the split-doc model. |
This repository moved from monolithic instruction files to a split model:
The goal is to reduce documentation drift and avoid brittle SHA-pinned GitHub links.
Use repo-relative paths only, then run .github/scripts/audit-instruction-refs.sh.
The concrete example inventory lives in
layer-example-matrix.md. Use it when you need stable file
anchors across android, app, feature, common, task, domain, data, and buildSrc.
.github/instructions/*.instructions.md).| Legacy topic | Primary instruction | Primary skill |
|---|---|---|
| Compose screen planning and product-heavy UI refinement | .github/instructions/context.instructions.md | .github/skills/product-designer/SKILL.md |
| Architecture boundaries | .github/instructions/context.instructions.md | .github/skills/data-state-pattern/SKILL.md |
| Layered module plumbing | .github/instructions/context.instructions.md | .github/skills/layered-module-patterns/SKILL.md |
| UI navigation architecture | .github/instructions/context.instructions.md | .github/skills/navigation-architecture/SKILL.md |
| Android platform/helper reuse | .github/instructions/context.instructions.md | .github/skills/android-platform-patterns/SKILL.md |
| Runtime UI capture with ADB, explicit launch intents, UIAutomator dumps, and screenshots | .github/instructions/guides.instructions.md | .agents/skills/android-ui-automator-preview/SKILL.md |
| Build system conventions | .github/instructions/build-system.instructions.md | .github/skills/new-module-checklist/SKILL.md |
| DataState / UiState behavior | .github/instructions/guides.instructions.md | .github/skills/data-state-pattern/SKILL.md |
| Koin DI wiring | .github/instructions/context.instructions.md | .github/skills/koin-module-wiring/SKILL.md |
| Room entity + migration pattern | .github/instructions/guides.instructions.md | .github/skills/room-entity-pattern/SKILL.md |
| CacheRequest collision / empty UI with no crash | .github/instructions/guides.instructions.md | .github/skills/cache-request-isolation/SKILL.md |
GraphQL controller lifecycle, @GraphQuery, @GRAPHQL, QueryContainerBuilder, Response<GraphQLResponse<*>> | .github/instructions/guides.instructions.md | .github/skills/graphql-query-pattern/SKILL.md |
Data Android infrastructure role, ControllerStrategy, OnlineStrategy, OfflineStrategy, ScopeExtensions, graphQLController Koin wiring | .github/instructions/guides.instructions.md | .github/skills/data-android-infrastructure/SKILL.md |
| GraphQL fragment-to-model mapping and remote source wiring | .github/instructions/guides.instructions.md | .github/skills/mapping-graphql-models/SKILL.md |
| String naming and POEditor context | .github/instructions/guides.instructions.md | .github/skills/string-resources-convention/SKILL.md |
| Test strategy and commands | .github/instructions/guides.instructions.md | .github/skills/testing-guidelines/SKILL.md |
| Library stack and integrations | .github/instructions/project-scope.instructions.md | .github/skills/key-libraries/SKILL.md |
| If your task is... | Read this first | Then read |
|---|---|---|
| Plan or refine a Compose screen, settings surface, or interaction-heavy UI | .github/instructions/context.instructions.md | .github/skills/product-designer/SKILL.md |
| Add a new feature module | .github/instructions/context.instructions.md | .github/skills/new-module-checklist/SKILL.md |
| Evaluate or add domain/data/feature/task plumbing | .github/instructions/context.instructions.md | .github/skills/layered-module-patterns/SKILL.md |
| Trace or add screen navigation | .github/instructions/context.instructions.md | .github/skills/navigation-architecture/SKILL.md |
| Reuse or extend an internal Android helper API | .github/instructions/context.instructions.md | .github/skills/android-platform-patterns/SKILL.md |
| Work on deep-link entry or parser registration | .github/instructions/context.instructions.md | .github/skills/android-platform-patterns/SKILL.md |
| Work on drawer or app-shell navigation helpers | .github/instructions/context.instructions.md | .github/skills/android-platform-patterns/SKILL.md |
| Capture emulator/device UI evidence (XML + PNG) for repro/debug handover | .github/instructions/guides.instructions.md | .agents/skills/android-ui-automator-preview/SKILL.md |
| Work on theme, configuration, notification, context, or fragment helpers | .github/instructions/context.instructions.md | .github/skills/android-platform-patterns/SKILL.md |
| Add a new repository or source | .github/instructions/guides.instructions.md | .github/skills/data-state-pattern/SKILL.md |
| Convert a fixed-size detail read to offline-first | .github/instructions/guides.instructions.md | .github/skills/data-state-pattern/SKILL.md |
| Add DI bindings | .github/instructions/context.instructions.md | .github/skills/koin-module-wiring/SKILL.md |
| Add or update Room entities | .github/instructions/data.guides.instructions.md | .github/skills/room-entity-pattern/SKILL.md |
| Debug empty-UI / silent cache bypass | .github/instructions/guides.instructions.md | .github/skills/cache-request-isolation/SKILL.md |
| Add or change GraphQL query flow | .github/instructions/guides.instructions.md | .github/skills/graphql-query-pattern/SKILL.md |
Understand ControllerStrategy, choose OnlineStrategy vs OfflineStrategy, or understand ScopeExtensions / Data Android infrastructure | .github/instructions/guides.instructions.md | .github/skills/data-android-infrastructure/SKILL.md |
| Add or change GraphQL fragments, model variants, or remote source wiring | .github/instructions/guides.instructions.md | .github/skills/mapping-graphql-models/SKILL.md |
| Update user-facing strings | .github/instructions/context.instructions.md | .github/skills/string-resources-convention/SKILL.md |
| Add tests for data/domain logic | .github/instructions/guides.instructions.md | .github/skills/testing-guidelines/SKILL.md |
| Update dependencies or build logic | .github/instructions/build-system.instructions.md | .github/skills/key-libraries/SKILL.md |
These support-arch prompt packs are repo-local execution playbooks for autonomous operational work.
Use them alongside the .github instructions and skills when the task is broader than one module.
docs/support-arch/instructions/ci-pipeline-intervention.md and
docs/support-arch/prompts/ci-pipeline-intervention.mddocs/support-arch/instructions/room-migration-failsafe.md and
docs/support-arch/prompts/room-migration-failsafe.mddocs/support-arch/instructions/graphql-schema-contract-audit.md and
docs/support-arch/prompts/graphql-schema-contract-audit.mddocs/support-arch/instructions/qa-license-autofix.md and
docs/support-arch/prompts/qa-license-autofix.mdUse these as concrete implementation references. For the curated cross-layer list, open layer-example-matrix.md.
android/core/src/main/kotlin/co/anitrend/android/core/koin/Modules.ktandroid/core/src/main/kotlin/co/anitrend/android/core/settings/helper/config/ConfigurationHelper.ktandroid/core/src/main/kotlin/co/anitrend/android/core/extensions/ContextExtensions.ktandroid/core/src/main/kotlin/co/anitrend/android/core/helpers/notification/NotificationExtensions.ktandroid/core/src/main/kotlin/co/anitrend/android/core/ui/theme/Theme.ktandroid/navigation/src/main/kotlin/co/anitrend/android/navigation/drawer/koin/Modules.ktandroid/navigation/src/main/kotlin/co/anitrend/android/navigation/drawer/provider/FeatureProvider.ktandroid/deeplink/src/main/kotlin/co/anitrend/android/deeplink/koin/Modules.ktandroid/deeplink/src/main/kotlin/co/anitrend/android/deeplink/component/screen/DeepLinkScreen.ktdomain/src/main/kotlin/co/anitrend/domain/tag/data/src/main/kotlin/co/anitrend/data/tag/domain/src/main/kotlin/co/anitrend/domain/media/data/src/main/kotlin/co/anitrend/data/media/domain/src/main/kotlin/co/anitrend/domain/medialist/data/src/main/kotlin/co/anitrend/data/medialist/domain/src/main/kotlin/co/anitrend/domain/review/data/src/main/kotlin/co/anitrend/data/review/domain/src/main/kotlin/co/anitrend/domain/favourite/data/src/main/kotlin/co/anitrend/data/favourite/task/medialist/src/main/kotlin/co/anitrend/task/medialist/task/review/src/main/kotlin/co/anitrend/task/review/task/favourite/src/main/kotlin/co/anitrend/task/favourite/data/android/src/main/kotlin/co/anitrend/data/android/controller/graphql/GraphQLController.ktapp/src/main/kotlin/co/anitrend/component/screen/MainScreen.ktapp/core/src/main/kotlin/co/anitrend/core/koin/Modules.ktapp/core/src/main/kotlin/co/anitrend/core/ui/UiExtensions.ktbuildSrc/src/main/java/co/anitrend/buildSrc/module/Modules.ktbuildSrc/src/main/java/co/anitrend/buildSrc/plugins/components/ProjectDependencies.ktdata/schemas/github.com/.../blob/<sha>/...#L.. links..github/scripts/audit-instruction-refs.sh before merging.