compose-performance · git:20260818.ded78ab · 2026-08-18 · sha256 e8ffd5d184dfa964
compose-performance git:20260818.ded78abA
Immutable. This exact content never changes and is served at /api/v1/blob/e8ffd5d184dfa964.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_iozsilofkott4kig/e8ffd5d184dfa964d7add97c060ea814656a43f53faaf816ab9e095a63babfca.json
Then /plugin install compose-performance@markdownregistry-iozsilofkott4kig in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: compose-performance description: Use when investigating Jetpack Compose recomposition cost, compiler stability reports, skippability, unstable parameters, frame-rate State reads, cross-phase snapshot back-writing, or @ReadOnlyComposable contracts. --- # Compose performance ## Core principle Measure one user-visible transition, identify the runtime axis that causes the work, then apply the smallest correction at the phase or boundary where that axis begins. ## Procedure 1. Reproduce one concrete transition and capture the observable evidence: recomposition counts, compiler reports, profiler data, or a clear trace. 2. Classify the primary axis: parameter stability and skipping, State read phase, or snapshot state written back into an earlier phase. 3. Check for a false lead: a real data change, a correctness defect, or an unchanged lazy item that is expected to recompose. 4. Read the corresponding focused reference before proposing a change. 5. For review work, pair every finding with the smallest evidence-supported repair. For a false stability promise, explicitly say to replace mutable non-snapshot properties with immutable data or snapshot-observable state, verify that contract, and only then decide whether an annotation remains needed. For a phase problem, name the layout or draw consumer where the changing read or calculation should move. Do not stop at diagnosis. 6. Change one axis at a time and re-measure the same transition. 7. Finish when the evidence improves at the observed boundary without hiding state changes, caching stale values, or moving work to a less correct owner. ## Topic router | Signal | Read | |---|---| | Cause is unknown, or several axes may interact | [Diagnosis](references/diagnosis.md) | | `classes.txt`, `composables.txt`, strong skipping, unstable parameters, or collection stability | [Stability](references/stability.md) | | Scroll, animation, gesture, layout, or draw State read at frame rate; measured state fed back into composition | [Deferred reads](references/deferred-reads.md) | | A composable only reads composition locals or accessor-style values | [Composition contracts](references/composition-contracts.md) | | State ownership or effect lifecycle is the root cause | [Compose state and effects](../compose-state-and-effects/SKILL.md) | ## RED/GREEN agent scenarios 1. RED blames unstable parameters for unchanged lazy rows that recompose during a focus transition. GREEN checks composition and layout back-writing first. 2. Novel case: an animation value controls only drawing. RED identifies the composition read but stops at diagnosis. GREEN moves the State read and its geometry calculation into the draw or layout consumer. 3. Counterexample: a screen visibly recomposes because its displayed model actually changed. GREEN does not add stability wrappers or caches merely to lower a count.