| 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, generated GraphQLOperationRequest<...Variables> with carried documents, KotlinxGraphQLTransportCodec and GraphQLConverterFactory wiring, shared AniTrendConverterFactory mixed-protocol boundary, Response<GraphQLResponse<*>> | AGENTS.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 | |
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.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/core/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.kt
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.
