review-pr
Skill654 starsChanged 28 days agoMITView on GitHub
Comprehensive PR review for flutter_edge_ai. Runs 10 specialized reviewers in parallel (4 platform-specific + 6 general). Use when reviewing PRs or before merging.
185 other projects use a version of this.
Adopted by
Most recently taken up by
- ayoubben18/ab-methodtheir own version, first seen Nov 15, 2026
- jameswyse/skillstheir own version, first seen Nov 15, 2026
- connext-solutions/flowctltheir own version, first seen Nov 15, 2026
- atomicinnovation/acceleratortheir own version, first seen Nov 14, 2026
- suitedaces/dorabottheir own version, first seen Nov 14, 2026
- AMD-AGI/Hyperloomtheir own version, first seen Nov 12, 2026
Used with
Projects with it also use diagnose-ci-failures, docs-loop and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
zerx-labSkilldiagnose-ci-failures
Diagnose CI failures for a PR using the GitHub CLI, extract error logs, and generate a plan to fix them. Use when the user asks to check CI status, pull CI issues, triage test failures, or investigate PR build failures.
Also in 3 projects that use this
GeiserXSkilldocs-loop
Use when the user asks to audit docs, check documentation for stale claims, or verify docs against the code.
Also in 3 projects that use this
GeiserXSkillfull-loop
Drive a repository to done with sergio-loop, then keep improving it with refine-loop at a descending theta. Use only when the user explicitly invokes full-loop.
Also in 3 projects that use this
n24q02mSkillreview-delta
Review only changes since last commit using impact analysis. Token-efficient delta review with automatic blast-radius detection.
Also in 3 projects that use this
n24q02mSkillbuild-graph
Build or update the code review knowledge graph. Run this first to initialize, or let hooks keep it updated automatically.
Also in 3 projects that use this
- +7 more from GeiserX
Other versions185 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 185
- denoland/deno★ 109ksame name
- ToolJet/ToolJet★ 41ksame name
- remix-run/remix★ 33ksame name
- tirth8205/code-review-graph★ 33ksame name
- alpinejs/alpine★ 32ksame name
- nrwl/nx★ 29ksame name
- PrefectHQ/fastmcp★ 29ksame name
- jlowin/fastmcp★ 29ksame name
- livewire/livewire★ 24ksame name
- microsoft/fluentui★ 20ksame name
175 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository6 other files it gives its agents.
- AGENTS.mdAGENTS.md
- build-nativeSkill
- ci-statusSkill
- ddp-device-testSkill
- releaseSkill
- upgrade-genkitSkill
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 6 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 178 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 9
Run comprehensive PR review with 10 parallel agents — 4 platform-specific + 6 general-purpose.
- Distinctive: line 85
Put this in every agent prompt, verbatim.
- Distinctive: line 140
Read the neighbours: If you change state, grep every reader of that state.
- Distinctive: line 175
Every path named in an agent prompt below was verified to exist.
- Very specific: line 381
Not the copilot CLI. That binary is GitHub Copilot, billed against a different quota entirely, and it answers 402 You have exceeded your …
- Very specific: line 435
If no PR number, detect via: gh pr list --head $(git branch --show-current) --json number -q '.[0].number'
- Distinctive: line 453
Prompt: Check all changed files for silent failures, inadequate error handling, catch blocks that swallow errors, and inappropriate …
- Distinctive: line 459
After all agents complete:
“Common” is measured: kept by at least 6 in 10 of the 178 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Flutter Edge AI PR Review
Run comprehensive PR review with 10 parallel agents — 4 platform-specific + 6 general-purpose.
Usage
/review-pr 198 # Review PR by number
/review-pr # Review current branch vs mainProcess
Step 1: Get the diff
If PR number provided:
gh pr view {number} --json title,body,files --jq '.title'
gh pr diff {number} > /tmp/pr-{number}.diffIf no PR number:
BRANCH=$(git branch --show-current)
PR_NUMBER=$(gh pr list --head "$BRANCH" --json number -q '.[0].number')
if [ -n "$PR_NUMBER" ]; then
gh pr diff "$PR_NUMBER" > /tmp/pr-branch.diff
else
git diff main...HEAD > /tmp/pr-branch.diff
fiStep 2: Identify changed areas
This is a Dart pub workspace monorepo — all code lives under packages/<pkg>/.
From the diff, detect which package(s)/area(s) are affected:
Packages (packages/<pkg>/):
flutter_edge_ai/— core: registry, contracts, shells, ModelSource, slim native plugin (itsandroid/ios/host only the bundled channel)flutter_edge_ai_litertlm/—.litertlmFFI engine;native/litert_lm/build scripts,lib/src/ffi/,hook/build.dartflutter_edge_ai_embeddings/— embedding tokenizers (pure Dart; the app registers them)flutter_edge_ai_mediapipe/—.taskMediaPipe; owns pigeon (lib/pigeon.g.dart) + Kotlin/Swift + web JSflutter_edge_ai_rag/— instance-scoped RAG orchestration and contracts. It may depend on core for the default active-embedder adapter; it must not depend on either storage provider.flutter_edge_ai_qdrant/— native RAG over the officialqdrant_edgeUniFFI SDK. Since 1.4.0 the package owns NO native code and NO hook: the engine and its Native Assets hook live in the SDK. It depends onflutter_edge_ai_rag, never directly on core.lib/src/only.flutter_edge_ai_sqlite/— sqlite-vecvec0KNN on all six platforms; native viapackage:sqlite3FFI, web viapackage:sqlite3/wasm.dart(wa-sqlite was dropped in flutter_gemma_rag_sqlite 1.1.0) It depends onflutter_edge_ai_rag, never directly on core in its published dependency graph.flutter_edge_ai_speech/— opt-in STT (moonshine / Whisper / Parakeet) + TTS (Matcha / Qwen3 / Inflect) over the LiteRT C API; shares the litertlm bundleflutter_edge_ai_agent/— opt-in SKILL.md agent skills over the function-calling loop (no Web)flutter_edge_ai_builtin_ai/— OS models: Gemini Nano (Android), Apple Foundation Models (iOS/macOS), Windows AI Foundry, Chrome Prompt API (Web). Pure Dart since 0.3.0: no native sources and no pigeon of its own — it adapts theflutter_local_aiplugin, which owns every backend.flutter_edge_ai_diagnostics/— memory diagnostics (MemorySnapshot) read from the OS on Android, iOS, macOS, Linux and Windows throughdart:io/dart:ffi. No native sources, no dependency on core. A failed read must throwMemoryReadException; null is reserved for a value the platform does not have.genkit_flutter_edge_ai/,genkit_hybrid/— Genkit integration packages (Dart; no native)flutter_edge_ai/example/— example app +integration_test/E2E
Native (per package): packages/<pkg>/android/, ios/, windows/, native/, hook/build.dart
Web: packages/*/lib/src/web/, packages/*/web/ (JS interop, WASM)
Desktop: packages/flutter_edge_ai/lib/src/desktop/ + FFI in flutter_edge_ai_litertlm
Site: website/ — Jaspr landing + docs (deployed to flutteredge.ai; CI .github/workflows/firebase-hosting-merge.yml)
Repo-level: .github/workflows/, .claude/skills/, root pubspec.yaml (workspace + melos)
For RAG diffs, review these invariants explicitly: core exposes no RAG facade or
vector-store contracts; providers depend only on flutter_edge_ai_rag; every
persistent index is bound to a stable embedding profile and one document
modality (VectorStoreBinding), the version-1 profile record is always written
and an image/audio binding stores the U+001F-qualified id there so older
releases refuse it (tool/rag_store_compat/run_downgrade_harness.sh);
raw-vector creation cannot infer an identity; legacy adoption is explicit,
text-only and dimension-checked; Web SQLite has one live owner per location;
open is single-flight; and indexes are disposed before their borrowed
core/custom embedder.
Ground rules for every agent — REVIEWERS DO NOT WRITE
Put this in every agent prompt, verbatim. It is not boilerplate; it is the lesson from a review round that had to be redone from scratch.
READ-ONLY. Do not write, create, edit, delete, move or rename ANY file in the
repository — including test files, scratch files and probe files. Do not run
mutation testing. Do not run `flutter test`, `flutter analyze`, `dart format`
or `flutter pub get` (they write into .dart_tool and build outputs). Do not run
git add / restore / checkout / stash / clean / commit. Reading is unlimited:
cat, sed, grep, find, `git show`, `git diff`, `git log`, and ~/.pub-cache.
If you want something verified by execution, DESCRIBE THE EXPERIMENT precisely
— setup, the call, what to print — and stop. The caller will run it and hand
you the output.What this prevents. Reviewers told to "verify by mutation and restore
afterwards" did exactly that, in the shared working tree, on top of
UNCOMMITTED fixes. Those fixes were silently overwritten twice; one agent's
mid-mutation state got picked up by a git add, so git diff showed the
agent's revert as if it were HEAD, and it was nearly committed. It was caught
only because the file's md5 changed twice in twenty seconds while nothing was
being edited. Every test result taken during that window was meaningless.
Two more rules that follow from it:
- Commit before you review. Reviewers read a moving tree otherwise, and their findings are anchored to a state that no longer exists.
- Run them ONE AT A TIME when acting on findings. Parallel is right for a first sweep of a frozen commit. It is wrong once you are editing between reports: read one report, decide what you accept, apply it, commit, then start the next. The agents are advisors — the decision to change code is yours, and it is not delegable to ten of them at once.
Acting on a finding — the part that goes wrong
A report is a list of HYPOTHESES, not a list of defects. Converting one straight into an edit is how a review round ends with more bugs than it started.
Measured on one PR, one day: reviewers found six real pre-existing defects, and acting on them introduced five new ones. None shipped — four were caught by the next round, one by its own test — but four of the five came from the same omission, and it is not "this was hard":
| what I changed | what I did not check first |
| set a state flag to false on a failure path | who READS that flag — close() was gated on it, so the handle leaked |
put cleanup in a catch | whether the cleanup call can itself throw — it did, swallowing the original error |
vtool -output "$lib.norm" then mv | what the tool does to the OUTPUT — it baked .norm into the code signature |
| wrote a regression test | whether the test can distinguish the two worlds — it could not |
The loop, per finding, in this order:
- Reproduce it. Print the wrong value. A finding you cannot reproduce is not yet a defect — and twice this day a confident report was wrong on measurement.
- Read the neighbours. If you change state, grep every reader of that state. If you change a file, find what consumes it. If you call a tool, check what it does to its output.
- Fix.
- Mutate the test. Break the production line the test names, and watch it go red. If it stays green the test is decoration — delete it or fix it, but do not keep it.
- Only then take the next finding.
Step 4 is not optional and not a formality. Tests written after a fix "obviously" pass; that is the problem, not the reassurance.
Two more that cost real time:
- A green narrow check is not a green wide one.
flutter testin a package passed whileflutter analyze packages/had 17 errors, because the ambiguity was only visible from the wider scope. Run the wide one before saying "clean". - A fix that is not observable to the consumer is not a fix. A corrected binary was still not reaching builds, because the staging guard compared file SIZE and the correction happened not to change it. Verify at the point the user consumes it, not at the point you edited it.
Step 3: Launch ALL agents in parallel
Launch all 10 agents simultaneously using the Agent tool. Each agent gets:
- The full diff (or list of changed files)
- The affected platform(s)
- Its specific review checklist (below)
CRITICAL: All agents MUST run in parallel via a single message with multiple Agent tool calls.
Agent Specifications
Every path named in an agent prompt below was verified to exist. If one stops resolving, that is the finding — fix the skill before running the review, because an agent pointed at a missing directory returns a clean report.
Agent 1: Android native
subagent_type: android-architect
You are reviewing the Android native layer of flutter_edge_ai, a Dart pub workspace
monorepo. Inference itself is NOT in Kotlin — `.litertlm` runs through Dart FFI.
Kotlin exists in exactly three packages; confirm with
`find packages -path '*/android/src/main/kotlin' -name '*.kt'` before you start.
- packages/flutter_edge_ai/android/.../FlutterEdgeAiPlugin.kt — SLIM. Hosts only the
`flutter_gemma_bundled` channel: file ops plus the litertlm NPU
`getNativeLibraryDir`. If a change adds inference logic here, that is the
finding.
- packages/flutter_edge_ai_mediapipe/android/ — the only real engine layer:
own pigeon (PigeonInterface.g.kt), PlatformServiceImpl, InferenceModel, and
engines/{InferenceEngine,EngineFactory,InferenceSession,EngineConfig}.kt plus
engines/mediapipe/. EngineFactory handles `.task`/`.bin`/`.tflite` ONLY — it
throws on `.litertlm` with a message pointing at the Dart FFI client. That
throw is correct behaviour, not a bug.
(`flutter_edge_ai_builtin_ai` has no android/ since 0.3.0. The `minSdk 26` floor
still reaches an app that depends on it, but through `flutter_local_ai`.)
CHECKLIST
1. NO KGP IN THE PLUGINS: since #440 none of the THREE android/build.gradle
files applies `kotlin-android`, declares `ext.kotlin_version`, or carries the
KGP classpath. Flutter's own Gradle plugin applies KGP to any plugin
subproject that does not (FlutterPluginUtils `detectApplyingKotlinGradlePlugin`),
which is why `flutter: '>=3.44.0'` is load-bearing. Re-adding a guard like the
old `agpMajor < 9 || !builtInKotlinOn` is a REGRESSION, not a fix. What still
matters is the #360 lesson: the `kotlin { compilerOptions { jvmTarget } }` block
and its comment must be byte-identical in all three — a fix in one is a half-fix
that ships under its own version number.
2. MANIFEST: the `<uses-native-library>` entries (libOpenCL.so, -car, -pixel,
libvndksupport.so, libcdsprpc.so) live in the CORE plugin manifest and merge
into consumer apps. libvndksupport is load-bearing for the OpenCL ICD on
Android 12+ (#324) — without it OpenCL fails to load, and OpenCL is the only
Android GPU path (no WebGPU library ships for Android since native-v0.18.0).
3. minSdk: `.litertlm` needs 30 (API-30-only Bionic symbols, #265); builtin_ai
needs 26; core declares 24. A change to any floor must be consistent with what
the code actually dlopens.
4. PIGEON: *.g.kt files are generated — never hand-edited. Regenerated from the
package's own pigeon.dart.
5. NATIVE LIBS: arm64-v8a only for .litertlm/embeddings/vision. A change that
implies other ABIs ship broken APKs.
6. Coroutine scope, cancellation and prompt accumulation in the MediaPipe session.
Report CRITICAL / IMPORTANT / MINOR with file:line. Skip style nits.Agent 2: Apple native (iOS + macOS)
subagent_type: swift-reviewer
You are reviewing the Apple native layer of flutter_edge_ai. Note the layouts
differ per package — verify with `find packages -name '*.swift' | grep -v example`
rather than assuming a single convention:
- packages/flutter_edge_ai/{ios,macos}/flutter_edge_ai/Sources/flutter_edge_ai/ —
SwiftPM layout (NOT ios/Classes/). Slim plugin: bundled channel only.
- packages/flutter_edge_ai_mediapipe/ios/Classes/ — classic layout, real engine:
FlutterEdgeAiMediaPipePlugin, PlatformServiceImpl, InferenceModel, pigeon .g.swift
(`flutter_edge_ai_builtin_ai` has no darwin/ since 0.3.0. Apple Foundation Models
reach it through `flutter_local_ai`, whose floor is iOS 13.0 / macOS 12.0.)
CHECKLIST
1. Swift 6 concurrency: Sendable conformance, actor isolation, and no
captured-mutable-state across the pigeon boundary.
2. Podspec versions: three first-party podspecs exist and drift independently —
core ios, core macos, mediapipe ios. Each must match its OWN package version.
3. iOS floor since #441: core declares 15.0; only flutter_edge_ai_mediapipe
declares 16.0. A litertlm-only app is NOT held to 16 — that was the bug. Both
the podspec and the Package.swift must carry the same number for a package
that has both (mediapipe has no Package.swift). An app using
flutter_edge_ai_builtin_ai is additionally held to flutter_local_ai's
iOS 13.0 / macOS 12.0.
4. Entitlements: iOS needs extended-virtual-addressing and increased-memory-limit
for large models. macOS must carry NO `com.apple.developer.kernel.*` key — they
are iOS-only: without a signing team the build fails ("has entitlements that
require signing with a development certificate"), with a team Xcode drops
them. macOS needs `network.client` in BOTH DebugProfile and Release
entitlements, and an app with Swift Package Manager off also
`cs.disable-library-validation` (it takes effect under Hardened Runtime,
because the Podfile stager signs the companions ad hoc). With it on, the
companions come from litertlm's `macos/flutter_edge_ai_litertlm/Package.swift`
and Xcode signs them with the app's team (#689); Package.swift and the
litertlm podspec declare macOS 14.0, which every app depending on litertlm or
speech must match.
5. No `Podfile post_install` symlink step should be reintroduced: those lib*.dylib
symlinks caused App Store rejection ITMS-90432 (#245). Any bundled dylib needs
`vtool` minos 13.0 or the upload is rejected (ITMS-90208).
6. Generated pigeon .g.swift is never hand-edited.
Report CRITICAL / IMPORTANT / MINOR with file:line.Agent 3: Web
subagent_type: general-purpose
You are reviewing the web layer of flutter_edge_ai. Two independent engines have
web arms, plus embeddings and RAG:
- packages/flutter_edge_ai_mediapipe/lib/src/web/ — `.task` via @mediapipe/tasks-genai
- packages/flutter_edge_ai_litertlm/lib/src/web/ — `.litertlm` via @litert-lm/core.
EARLY PREVIEW: text only. Function calling is wired; vision, audio, verified
thinking and LoRA are not supported.
- packages/flutter_edge_ai_onnx/lib/src/web/ — `.onnx` text generation and
embeddings through Transformers.js / ONNX Runtime Web (WebGPU with WASM CPU
fallback).
- packages/flutter_edge_ai_litertlm/ web embedding arm — LiteRT.js bundle in its own web/
- packages/flutter_edge_ai_sqlite/ — package:sqlite3/wasm.dart + a custom
sqlite3.wasm with vec0 linked in, which the APP copies into its own web/ dir
- packages/flutter_edge_ai/lib/src/web/ — the shared web shells and model source
CHECKLIST
1. CONDITIONAL IMPORT / STUB DRIFT — the highest-value check here. FFI clients
have `*_stub.dart` counterparts that `flutter analyze` and `flutter test` do
NOT type-check on the host. Signature drift only surfaces at
`flutter build web`. If a real signature changed, its stub must change too.
This is how a web break shipped in 0.15.0 with green analyze and green tests.
2. dart:io / dart:ffi must not reach the web graph. Check the conditional export.
3. The six required web/ assets are not auto-injected — the app copies them:
cache_api.js and opfs_helper.js from `flutter_edge_ai`, and the four-file
LiteRT.js bundle from `flutter_edge_ai_litertlm` (litert_embeddings.js plus
its three vendor chunks). A change that needs a new global must
document the script tag.
4. Storage modes: cacheApi (default, <2GB), streaming (OPFS, large models),
none. MediaPipe and LiteRT-LM are GPU-first web paths; ONNX Runtime Web also
has a WASM CPU fallback. Do not describe the whole Web platform as GPU-only.
5. CDN pins: @mediapipe/tasks-genai, @litert-lm/core and @litertjs/core must
agree between the code and any documented script tag. @litertjs/core has
THREE places to keep in step: `LiteRtWebRuntime.pinnedVersion`,
`tool/web_build/package.json` and the committed `web/litert.js`.
Report CRITICAL / IMPORTANT / MINOR with file:line.Agent 4: Desktop / FFI and native assets
subagent_type: general-purpose
You are reviewing desktop inference and the native-asset pipeline of
flutter_edge_ai. Desktop is Dart FFI directly into the LiteRT-LM C API — there is
NO JVM, NO gRPC, NO separate server process and no proto layer. If the diff or a
task description mentions any of those, it predates 0.14.0.
- packages/flutter_edge_ai_litertlm/lib/src/ffi/ — the FFI client, generated
bindings, and the inference model
- packages/flutter_edge_ai_litertlm/hook/build.dart — the SOLE hook that owns the
shared libLiteRtLm bundle. embeddings and speech consume it transitively and
have no hook of their own.
- packages/flutter_edge_ai_litertlm/native/litert_lm/ — build_*.sh, patch_c_api.sh,
stream_proxy.c
- packages/flutter_edge_ai/{linux,windows}/ — thin plugin registration C++
- packages/flutter_edge_ai/lib/src/desktop/ — the registry-dispatch shell
CHECKLIST
1. HOOK CHECKSUMS: a bundle `version:` bump requires all seven per-platform
SHA256 entries updated, and the same value must appear in the released
tarball, in checksums_litertlm.txt, and in the hook. A stale txt sent a user
down the wrong path in #316.
2. NEVER re-upload an existing native-v* tag. tar is not reproducible, so the
published SHA256 can never be recovered — it breaks every user already on a
plugin version referencing that tag.
3. windowsExtraLibs / androidExtraLibs and the CI allow-list are ONE SET IN TWO
PLACES. A name staged by CI but absent from the hook extracts to the cache and
is never bundled — that is how 78.8 MB of the Intel NPU stack went missing at
v0.16.0 while every CI assertion passed.
4. Bazel `--define` names rot silently: Bazel accepts an unknown define and
builds the default. Grep the tree being built before trusting one.
5. v0.15.0 changed the stream callback shape with no version symbol. The shipped
stream_proxy.c probes it at runtime via dlsym/GetProcAddress; the source on
main also has stream_proxy_create2, where Dart passes the accessors it resolved
on the library it drives. Do not replace either with a compile-time branch.
6. `stage()` in the hook is Apple-only on purpose (an Xcode directoryTreeSignature
cycle); staging on Windows splits companion DLLs and hangs cancel/close.
7. Any claim that a native check "passed" must name the artifact it inspected —
nm/otool on a missing path prints nothing and reads as success.
Report CRITICAL / IMPORTANT / MINOR with file:line.Agent 5: Flutter Architect
subagent_type: flutter-architect
Prompt: Review the PR diff for flutter_edge_ai — a multi-platform Flutter plugin for on-device AI inference. Focus on: plugin architecture (platform channels via Pigeon), SOLID principles, ModelSource sealed class design, handler chain pattern (NetworkSourceHandler, AssetSourceHandler), dependency injection (ServiceRegistry), platform abstraction layer. Check separation of concerns between install-time identity (modelType, fileType) and runtime configuration (maxTokens, preferredBackend). Read AGENTS.md for project conventions.
Agent 6: Flutter Coder
subagent_type: flutter-coder
Prompt: Review the changed Dart files in flutter_edge_ai for code quality. Check: null safety, proper async/await patterns, Stream handling (no leaks, proper cancellation), Message class usage (isUser: true for user messages), PreferencesKeys constants (no inline string keys), proper close()/dispose() in finally blocks, type safety with ModelSource sealed classes. Read AGENTS.md for coding standards — especially "No Inline String Keys" rule.
Agent 7: Codex Review (Second Opinion)
subagent_type: codex:codex-rescue
Not the copilot CLI. That binary is GitHub Copilot, billed against a
different quota entirely, and it answers 402 You have exceeded your monthly
quota on every model regardless of the ChatGPT plan — an earlier revision of
this skill called it and lost a whole review round to that.
Prompt:
Second-opinion review of PR #{number} for flutter_edge_ai. Read the diff with
`gh pr diff {number}` (or `git diff main...HEAD` if no PR), and read AGENTS.md
for the project's conventions.
READ-ONLY. Do not write, create, edit, delete or move any file in the
repository, and do not run `flutter test` / `flutter analyze` / `dart format` /
`flutter pub get` — they write into .dart_tool and build outputs. Do not run
git add / restore / checkout / stash / clean / commit. Reading is unlimited.
If you want something verified by execution, DESCRIBE the experiment precisely
and stop; the caller will run it and hand you the output.
Key project context:
- A Dart pub workspace monorepo: core flutter_edge_ai plus opt-in packages under
packages/. Core registers no engine; engines and backends are passed to
FlutterEdgeAi.initialize().
- .litertlm inference is Dart FFI into the LiteRT-LM C API on every native
platform, desktop included. There is NO JVM, NO gRPC, no separate server
process and no proto layer — removed at 0.14.0. Kotlin exists only in the
MediaPipe and builtin_ai packages plus a slim core plugin; MediaPipe never
handles .litertlm.
- Engine selection is by the DECLARED ModelFileType via canHandle(spec), NOT by
sniffing the file name. installModel defaults fileType to .task, so a
.litertlm model must declare it explicitly or it is routed to MediaPipe.
- ModelSource sealed class: NetworkSource, AssetSource, BundledSource, FileSource.
- Installation stores identity (modelType, fileType); runtime accepts config
(maxTokens, preferredBackend).
- maxTokens is the CONTEXT WINDOW, not the reply length. Below 1024 the
.litertlm KV cache allocation fails; the engine clamps up with a warning. To
cap a reply use maxOutputTokens on the session.
- Error handling: NO silent fallbacks. Throw or return an error; never swallow
in a catch. edgeAiLog is debug-only, so anything reported only through it is
unreported in release builds.
- No inline string keys — use PreferencesKeys constants.
- Generated files are never hand-edited: pigeon *.g.dart / *.g.kt / *.g.swift,
and the ffigen bindings.
Cross-check specifically: engine routing by declared fileType; conditional-import
stub drift against the real signatures (analyze does not catch it, only
`flutter build web` does); and platform-specific limitations.
Focus on bugs, logic errors, security, dead code, silent error swallowing, race
conditions in async/streaming code, and memory leaks (unclosed sessions/models).
Be concise — only real issues, each with file:line and a concrete failure
scenario. Skip style nits. Categorize CRITICAL / IMPORTANT / MINOR.If no PR number, detect via: gh pr list --head $(git branch --show-current) --json number -q '.[0].number'
Agent 8: Code Reviewer
subagent_type: pr-review-toolkit:code-reviewer
Prompt: Review the PR for adherence to project guidelines in AGENTS.md. Focus on recently changed files. Key rules: no inline string keys, proper PreferencesKeys usage, no AI attribution in commits, sessions/models always closed, Message(isUser: true) for user messages.
Agent 9: Type Design Analyzer
subagent_type: pr-review-toolkit:type-design-analyzer
Prompt: Analyze any new or modified types/interfaces in the PR for encapsulation, invariant expression, and design quality. Focus on: ModelSource sealed class hierarchy, EngineConfig/SessionConfig, InferenceEngine/InferenceSession interfaces, EngineCapabilities, TestModelConfig.
Agent 10: Silent Failure Hunter
subagent_type: pr-review-toolkit:silent-failure-hunter
Prompt: Check all changed files for silent failures, inadequate error handling, catch blocks that swallow errors, and inappropriate fallback behavior. Key concern areas: image conversion fallbacks (should throw, not return original bytes), tryEmit() that drops errors silently, cancelGeneration() that swallows exceptions, download/checksum verification gaps.
Step 4: Collect and Deduplicate
After all agents complete:
- Collect all findings from all agents
- Deduplicate — if two agents report the same issue (same file, same line, same concern), keep the one with better description
- Categorize by severity: CRITICAL > IMPORTANT > MINOR
- Group by file path within each severity
Step 5: Generate Report
Save to test_reports/pr-reviews/pr-{number}-review.md (or pr-branch-{branch}-review.md):
# PR Review: #{number} — {title}
**Branch:** {branch}
**Date:** {date}
**Reviewers:** 10 agents (4 platform-specific + 6 general)
**Platforms affected:** {platforms}
## Critical Issues
{blocking issues that must be fixed before merge}
## Important Issues
{should be fixed, but not blocking}
## Minor Issues
{nice-to-have improvements}
## Passed Checks
{list of checks that passed cleanly}
## Summary
- Critical: X
- Important: Y
- Minor: Z
- Recommendation: APPROVE / REQUEST CHANGES / NEEDS DISCUSSIONStep 6: Output Summary
Print a concise summary to the user:
- Total findings by severity
- Top 3 most important issues
- Recommendation (approve/changes requested)
- Path to full report file
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

