chore: add AGENTS.md and .agents/ for Codex agent configuration

.agents/skills/legado-compose-review/references/review-checklist.md

@@ -0,0 +1,117 @@
+# Legado Compose Review Checklist
+
+## Files to Read
+
+For a feature review, inspect the smallest complete slice:
+
+- `FeatureScreen.kt` and any `FeatureSheets.kt` / `FeatureDialogs.kt`.
+- `FeatureViewModel.kt`.
+- `FeatureContract.kt` if present.
+- Host route in `MainActivity.kt` or retained `FeatureActivity.kt`.
+- Koin registration in `di/appModule.kt`.
+- Repositories/usecases used by the feature.
+- Old View caller or XML/adapters only when still used for compatibility or behavior comparison.
+
+Use current examples as references:
+
+- `ui/main/MainActivity.kt` for Navigation3 route ownership.
+- `ui/book/info/BookInfoContract.kt`, `BookInfoViewModel.kt`, `BookInfoScreen.kt` for behavior-heavy MVI/UDF.
+- `ui/book/search/SearchContract.kt`, `SearchViewModel.kt`, `SearchScreen.kt` for route-level search state.
+- `ui/widget/components/...` and `ui/theme/...` for shared UI conventions.
+
+## Architecture Checks
+
+Flag issues when:
+
+- A new Compose-first screen is implemented as a standalone Activity instead of a `MainActivity` destination without a compatibility reason.
+- A retained Activity contains feature business logic instead of acting as a thin Android `Intent` compatibility host.
+- Business rules, repository calls, DAO calls, persistence writes, or service orchestration live in composables.
+- ViewModel exposes mutable state directly, exposes `MutableStateFlow`, or lets UI mutate domain objects.
+- UI state is split across Activity fields, composable `remember` state, adapter state, and ViewModel state in a way that can diverge.
+- One-shot events such as navigation, result codes, file opening, permission requests, or clipboard writes are represented as persistent `UiState` fields that can replay incorrectly.
+- MVI `FeatureIntent` user actions are confused with Android `Intent` launch/extras.
+- Domain/usecase boundaries are bypassed in new screens when a meaningful business action exists.
+- A migration introduces new domain abstractions for a single trivial UI action without reducing real complexity.
+
+## UDF and State Checks
+
+Flag issues when:
+
+- `Screen` functions own business state instead of receiving `state` and callbacks.
+- `remember` / `rememberSaveable` stores source-of-truth data that should survive process or route recreation through ViewModel state.
+- `LaunchedEffect` keys are unstable or cause repeated data loading, duplicate navigation, duplicate toasts, or repeated service calls.
+- Flows are collected without lifecycle awareness in UI routes where `collectAsStateWithLifecycle()` should be used.
+- List items lack stable keys where mutation, selection, or animation can make state attach to the wrong row.
+- Selection, search query, sorting, filtering, loading, and error states are not represented in a single coherent `UiState`.
+- Derived values are recomputed expensively on every recomposition instead of living in ViewModel state or `remember(key)`.
+
+## Navigation and Compatibility Checks
+
+Flag issues when:
+
+- New Compose destinations skip `MainActivity` Navigation3 route registration.
+- Legacy Android `Intent` extras or result codes change without an explicit compatibility plan.
+- A migrated screen is reachable both through `MainActivity` and a retained Activity with inconsistent state initialization.
+- Navigation is performed directly inside nested composables instead of through callbacks/effects.
+- Activity Result launchers, file pickers, permission requests, or Android DialogFragments are hidden inside reusable UI composables.
+- Back behavior bypasses ViewModel decisions when unsaved changes, selection mode, add-to-shelf prompts, or confirmation dialogs exist.
+
+## UI and Project Convention Checks
+
+Flag issues when:
+
+- Raw Material components ignore `LegadoTheme` or existing shared components where the project already has a wrapper.
+- A screen recreates shared UI already present under `ui/widget/components`.
+- User-facing text is hardcoded instead of using string resources, except for temporary debug-only text.
+- Compose UI keeps ViewBinding, adapter, or XML assumptions after migration.
+- Dialogs and bottom sheets use inconsistent project components when `AppAlertDialog`, `AppModalBottomSheet`, or existing option sheets fit.
+- Image loading bypasses existing Coil cover/image helpers where cover behavior, cache, SVG, or GIF handling matters.
+
+## Clean Architecture Checks
+
+For new screens, expect:
+
+- Compose renders state and emits user actions.
+- ViewModel owns state, intent handling, and effect emission.
+- Usecases own reusable business actions.
+- Repositories mediate data access.
+- DAOs remain behind repositories unless adding a boundary would be disproportionate and local project patterns already allow direct use.
+
+For migrated screens, allow pragmatic intermediate code only when:
+
+- It preserves behavior.
+- It is isolated behind a clear compatibility boundary.
+- It does not spread View-era assumptions into new Compose-first code.
+
+## Output Template
+
+Use this shape unless the user asks for another format:
+
+```text
+Findings
+- [P1] Title
+  file:line
+  Impact: ...
+  Fix: ...
+
+Open Questions
+- ...
+
+Notes
+- No issues found in ... / Tests not run ...
+```
+
+When using Codex inline review comments, emit one directive per finding with tight line ranges:
+
+```text
+::code-comment{title="[P2] Keep route state in ViewModel" body="..." file="/absolute/path/FeatureScreen.kt" start=42 end=45 priority=2 confidence=0.8}
+```
+
+## Verification Suggestions
+
+Recommend verification based on the reviewed change:
+
+- Kotlin-only review/fix: `.\gradlew.bat :app:compileAppDebugKotlin`.
+- Resource/XML/manifest impact: `.\gradlew.bat :app:assembleAppDebug`.
+- Navigation or compatibility changes: manually open both `MainActivity` route and any retained legacy Android `Intent` entry point.
+- Behavior-heavy ViewModel changes: add or run focused tests only where the project has a practical test seam.