Loading...
Loading...
Adds, changes, or reviews a screen, sheet, dialog, or destination slice (endpoint to repository to ViewModel to UI to navigation to DI to tests) in a Compose or CMP project. Use when adding a screen, building a new feature, adding a ViewModel or destination, wiring list/detail or a form screen, scaffolding a slice, or reviewing a feature change. Covers Contract.kt, launchGuarded wiring, SavedStateHandle drafts, the state matrix, and new-feature.sh. Do NOT use for routing or architecture (compose-architecture), pure refactors, Gradle work (compose-project), recomposition or styling (compose-ui), repository or persistence work (compose-data), or expect/actual splits (compose-platform).
npx skill4agent add meet-miyani/compose-skill compose-featurecompose-architecturecompose-architecturecompose-architecturegradle/libs.versions.toml| Task | Use instead |
|---|---|
| Route first: decide the task path and files to read | the |
| Write or review composables, lists, motion, accessibility, tokens, resources | the |
| Write or review repositories, Ktor, Room, DataStore, Paging, offline-first | the |
| New project or module, convention plugins, version catalog, CI, hooks | the |
| the |
Iron law: name the gap, never invent or stub. An unverified helper is named as an open gap, never called. No, stub, or no-op body reaches done. Delete it and restart from the template.TODO
## Project decisionsUI_MODEL=always.composekit.confcompose-architecturenaming-and-packages.mdTODOFIXMESEAMcompose-datacompose-uiUiStateUiActionexamples.mdscripts/new-feature.shscripts/new-feature.sh --name Notes --item Note --package com.example.feature.notes --root <project-root>| Situation | Action |
|---|---|
| New destination in a kit-shaped module | Scaffold with |
| Change to an existing destination | Hand-write the smallest correct diff; never re-scaffold over it. Never remove, rename, or relocate existing working behaviour (actions, state fields, effects, tests, routes, error wiring such as |
| Precedent is incoherent (competing patterns) | Use the kit shape for new code, name the incoherence, propose migration separately |
| Signal | Action |
|---|---|
| Identity missing or unusable (no id) | Drop the record |
| Non-identity field missing or malformed | Keep the row; null the field or mark it degraded |
Any temptation to substitute zero, now, or | Stop; absence stays null through the domain |
| Thought | Reality |
|---|---|
| "I'll just ship with these TODOs; next sprint." | No. Feature rule 2: no placeholder reaches done. |
| "The stub repository is fine for now; tests pass against it." | No. Feature rule 2: a stub hides error and empty states from verification. |
| "This method probably exists." | No. Iron law: name the gap; never call an invented method. |
| "I'll leave a no-op body for now." | No. Iron law: never ship a no-op as real logic. |
| "I'll verify the helper name later; it looks right." | Stop and verify now (feature rule 1). M2 models shipped invented APIs. |
| "Two drafts show my thinking; the reader can pick." | No. Feature rule 3 (iron law): decide, then emit one version; never ship a draft pair. |
| "I'll describe the fix in prose; the corrected file is obvious." | No. Feature rule 3: a blocking review ships exactly one corrected version of each blocking file. |
| "I'll list the test rows instead of writing them." | No. Verification gate 18 (state-matrix tests): a claimed matrix row ships as a written test. |
| "This record is missing a field; I'll default it to zero." | No. Feature rule 4: absence stays null; drop only on broken identity. |
| "I'll drop this row; its date failed to parse." | No. Feature rule 4: degrade the field, keep the row. |
| "I copied the component; the condition was specific to that screen." | No. Feature rule 5: copy the gate with the component. |
| "This UiState field is for later; the UI will read it soon." | No. Feature rule 6: every field read, every action dispatched. |
"I'll load in | No. Arch rule 9: an |
| "I'll resolve detail from the cached list; faster." | No. Arch rules 10 and 15: detail fetches by identity; a cold cache has no list. |
| "Refresh failure over content can stay silent." | No. Arch rule 8: silent is only for named polls. |
"A file-level | No. Arch rule 13: results travel through a repository write. |
"I'll time | No. Verification gate 18 (state-matrix tests; Fakes rule in testing.md): hold the fake open across the loading frame instead of timing |
*Contract.kt*UiState*UiAction*UiEffectcompose-architecturerg --files -g '*Contract.kt' <feature-root>rg -n "TODO|FIXME|NotImplementedError" <changed-files>SEAMrg -n "TODO|FIXME|NotImplementedError" <changed-files>rg -n "SEAM" <module>rg -n "SEAM" <module>launchGuardedonErrorcompose-architecturetry/catchCancellationExceptionON_STARTON_STARTLifecycleStartEffectJobcompose-architectureSavedStateHandleUiStatecompose-architecturerememberSaveableLaunchedEffectUiStateUiActioncompose-uiscripts/composekit/run-checks.sh