| name | flutter-kiwi-nlp |
| description | Maintain and extend the flutter_kiwi_nlp plugin. Use when working in this repository to implement features or fixes across native FFI and web WASM backends, adjust model loading behavior, update platform build scripts, and validate analyzer API parity before release. |
Flutter Kiwi NLP
Overview
Use a parity-first workflow.
Keep KiwiAnalyzer behavior aligned across native and web.
Preserve public API compatibility unless a breaking change is requested.
Workflow
- Collect context.
- Read
README.en.md, lib/flutter_kiwi_nlp.dart, and the affected files
under lib/src/.
- If API contracts change, inspect
lib/src/kiwi_options.dart and
lib/src/kiwi_types.dart.
- Implement change.
- Apply equivalent behavior in native and web backends when feasible.
- Keep unsupported targets explicit in
lib/src/kiwi_analyzer_stub.dart
(KiwiException).
- Preserve clear runtime errors for integration debugging.
- Validate.
- Run
skills/flutter-kiwi-nlp/scripts/verify_plugin.sh.
- If platform scripts changed, validate the related script under
tool/ and
the platform hook (android/build.gradle, ios/*.podspec,
macos/*.podspec, linux/CMakeLists.txt, windows/CMakeLists.txt).
- Document.
- Update
README.en.md and README.ko.md for behavior/config changes.
- Add a
CHANGELOG.md entry for user-visible changes.
- Keep
llms.txt links aligned with newly added or moved docs.
Decision rules
- Treat API parity as required for:
create, nativeVersion, analyze, addUserWord, and close.
- For model loading bugs, verify precedence and fallback logic before changing
defaults.
- For platform build issues, prefer fixing auto-prepare scripts before adding
manual steps.
Resources
- API and parity contract:
references/api-surface.md
- Runtime/build references:
references/runtime-and-build.md
- Reusable checks runner:
scripts/verify_plugin.sh
