reference-map - SKILL.md Agent Skill

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.'

Skill: Instruction-to-Skill Reference Map

Why this file exists

This repository now routes repository policy through AGENTS.md and keeps implementation depth in skills:

AGENTS.md provides stable, high-level policy and architecture constraints.
Skills provide focused, task-oriented deep dives.

The goal is to reduce documentation drift and avoid brittle SHA-pinned GitHub links. Use repo-relative paths only.

Routing precedence: use the Task-first routing table for new work, use the Legacy topic map only when migrating existing documentation, and use AI-Native SDLC Packs only for cross-module operational tasks that span at least two distinct layer boundaries or affect repository-wide infrastructure.

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.

How to use the split

Start from AGENTS.md.
Jump to the linked skill file for implementation details. If a linked skill file cannot be resolved, stop and report the missing path before proceeding.
Open layer-example-matrix.md when you need concrete cross-layer examples or stable file anchors.
Validate any changed references and formatting before opening a PR.

Legacy topic to new location map

Legacy topic	Repository policy	Primary skill
Compose screen planning and product-heavy UI refinement	`AGENTS.md`	`.agents/skills/anitrend-product-designer/SKILL.md`
Architecture boundaries	`AGENTS.md`	`.agents/skills/data-state-pattern/SKILL.md`
Layered module plumbing	`AGENTS.md`	`.agents/skills/layered-module-patterns/SKILL.md`
UI navigation architecture	`AGENTS.md`	`.agents/skills/navigation-architecture/SKILL.md`
Android platform/helper reuse	`AGENTS.md`	`.agents/skills/android-platform-patterns/SKILL.md`
Runtime UI capture with ADB, explicit launch intents, UIAutomator dumps, and screenshots	`AGENTS.md`	`.agents/skills/android-ui-automator-preview/SKILL.md`
Build system conventions	`AGENTS.md`	`.agents/skills/new-module-checklist/SKILL.md`
DataState / UiState behavior	`AGENTS.md`	`.agents/skills/data-state-pattern/SKILL.md`
Koin DI wiring	`AGENTS.md`	`.agents/skills/koin-module-wiring/SKILL.md`
Room entity + migration pattern	`AGENTS.md`	`.agents/skills/room-entity-pattern/SKILL.md`
CacheRequest collision / empty UI with no crash	`AGENTS.md`	`.agents/skills/cache-request-isolation/SKILL.md`
GraphQL controller lifecycle, `@GraphQuery`, `@GRAPHQL`, `QueryContainerBuilder`, `Response<GraphQLResponse<*>>`	`AGENTS.md`	`.agents/skills/graphql-query-pattern/SKILL.md`
Data Android infrastructure role, `ControllerStrategy`, `OnlineStrategy`, `OfflineStrategy`, `ScopeExtensions`, `graphQLController` Koin wiring	`AGENTS.md`	`.agents/skills/data-android-infrastructure/SKILL.md`
GraphQL fragment-to-model mapping and remote source wiring	`AGENTS.md`	`.agents/skills/mapping-graphql-models/SKILL.md`
String naming and POEditor context	`AGENTS.md`	`.agents/skills/string-resources-convention/SKILL.md`
Test strategy and commands	`AGENTS.md`	`.agents/skills/testing-guidelines/SKILL.md`
Library stack and integrations	`AGENTS.md`	`.agents/skills/key-libraries/SKILL.md`

Task-first routing

If your task is...	Read this first	Then read
Plan or refine a Compose screen, settings surface, or interaction-heavy UI	`AGENTS.md`	`.agents/skills/anitrend-product-designer/SKILL.md`
Add a new feature module	`AGENTS.md`	`.agents/skills/new-module-checklist/SKILL.md`
Evaluate or add domain/data/feature/task plumbing	`AGENTS.md`	`.agents/skills/layered-module-patterns/SKILL.md`
Trace or add screen navigation	`AGENTS.md`	`.agents/skills/navigation-architecture/SKILL.md`
Reuse or extend an internal Android helper API	`AGENTS.md`	`.agents/skills/android-platform-patterns/SKILL.md`
Work on deep-link entry or parser registration	`AGENTS.md`	`.agents/skills/android-platform-patterns/SKILL.md`
Work on drawer or app-shell navigation helpers	`AGENTS.md`	`.agents/skills/android-platform-patterns/SKILL.md`
Capture emulator/device UI evidence (XML + PNG) for repro/debug handover	`AGENTS.md`	`.agents/skills/android-ui-automator-preview/SKILL.md`
Work on theme, configuration, notification, context, or fragment helpers	`AGENTS.md`	`.agents/skills/android-platform-patterns/SKILL.md`
Add a new repository or source	`AGENTS.md`	`.agents/skills/data-state-pattern/SKILL.md`
Convert a fixed-size detail read to offline-first	`AGENTS.md`	`.agents/skills/data-state-pattern/SKILL.md`
Add DI bindings	`AGENTS.md`	`.agents/skills/koin-module-wiring/SKILL.md`
Add or update Room entities	`AGENTS.md`	`.agents/skills/room-entity-pattern/SKILL.md`
Debug empty-UI / silent cache bypass	`AGENTS.md`	`.agents/skills/cache-request-isolation/SKILL.md`
Add a new GraphQL-backed repository or source	`AGENTS.md`	`.agents/skills/data-state-pattern/SKILL.md` then `.agents/skills/graphql-query-pattern/SKILL.md`
Add or change GraphQL query flow	`AGENTS.md`	`.agents/skills/graphql-query-pattern/SKILL.md`
Understand `ControllerStrategy`, choose `OnlineStrategy` vs `OfflineStrategy`, or understand `ScopeExtensions` / Data Android infrastructure	`AGENTS.md`	`.agents/skills/data-android-infrastructure/SKILL.md`
Add or change GraphQL fragments, model variants, or remote source wiring	`AGENTS.md`	`.agents/skills/mapping-graphql-models/SKILL.md`
Update user-facing strings	`AGENTS.md`	`.agents/skills/string-resources-convention/SKILL.md`
Add tests for data/domain logic	`AGENTS.md`	`.agents/skills/testing-guidelines/SKILL.md`
Update dependencies or build logic	`AGENTS.md`	`.agents/skills/key-libraries/SKILL.md`

AI-Native SDLC Packs

These support-arch prompt packs are repo-local execution playbooks for autonomous operational work. Use them alongside AGENTS.md and repo-local skills when the task spans two or more distinct layer boundaries, requires coordination across unrelated modules, or affects repository-wide infrastructure.

CI/CD pipeline intervention: docs/support-arch/instructions/ci-pipeline-intervention.md and docs/support-arch/prompts/ci-pipeline-intervention.md
Room migration fail-safes: docs/support-arch/instructions/room-migration-failsafe.md and docs/support-arch/prompts/room-migration-failsafe.md
GraphQL contract auditing: docs/support-arch/instructions/graphql-schema-contract-audit.md and docs/support-arch/prompts/graphql-schema-contract-audit.md
QA and license autofix: docs/support-arch/instructions/qa-license-autofix.md and docs/support-arch/prompts/qa-license-autofix.md

Canonical code anchors

Use 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.kt
android/core/src/main/kotlin/co/anitrend/android/core/settings/helper/config/ConfigurationHelper.kt
android/core/src/main/kotlin/co/anitrend/android/core/extensions/ContextExtensions.kt
android/core/src/main/kotlin/co/anitrend/android/core/helpers/notification/NotificationExtensions.kt
android/core/src/main/kotlin/co/anitrend/android/core/ui/theme/Theme.kt
android/navigation/src/main/kotlin/co/anitrend/android/navigation/drawer/koin/Modules.kt
android/navigation/src/main/kotlin/co/anitrend/android/navigation/drawer/provider/FeatureProvider.kt
android/deeplink/src/main/kotlin/co/anitrend/android/deeplink/koin/Modules.kt
android/deeplink/src/main/kotlin/co/anitrend/android/deeplink/component/screen/DeepLinkScreen.kt
domain/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.kt
app/src/main/kotlin/co/anitrend/component/screen/MainScreen.kt
app/core/src/main/kotlin/co/anitrend/core/koin/Modules.kt
app/core/src/main/kotlin/co/anitrend/core/ui/UiExtensions.kt
buildSrc/src/main/java/co/anitrend/buildSrc/module/Modules.kt
buildSrc/src/main/java/co/anitrend/buildSrc/plugins/components/ProjectDependencies.kt
data/schemas/

Maintenance checklist for docs changes

Keep architecture intent in AGENTS.md.
Keep implementation detail in skill files.
Prefer adding concrete examples to layer-example-matrix.md instead of repeating large file inventories across multiple skills.
Prefer adding links to this map instead of duplicating long prose.
Never add SHA-pinned github.com/.../blob/<sha>/...#L.. links.