reference-map

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

1. Start from AGENTS.md.
2. 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.
3. Open layer-example-matrix.md when you need concrete cross-layer examples or stable file anchors.
4. 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.