with one click
behavioral-guardrails
// Behavioral guidelines for Flutter base tasks: clarify ambiguity, keep changes simple and surgical, and define verifiable success criteria before coding.
// Behavioral guidelines for Flutter base tasks: clarify ambiguity, keep changes simple and surgical, and define verifiable success criteria before coding.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | behavioral-guardrails |
| description | Behavioral guidelines for Flutter base tasks: clarify ambiguity, keep changes simple and surgical, and define verifiable success criteria before coding. |
Use this skill when writing, reviewing, refactoring, or planning code in the Flutter base template. It adapts the reusable ideas from the Karpathy-inspired claude-skills project to this repo's conventions.
Tradeoff: these guardrails bias toward caution over speed. For trivial one-line fixes, use judgment.
Do not silently choose an interpretation when the request is ambiguous.
Before implementing:
Flutter base examples:
module-scaffold, bloc-pattern, and route-config rather than ad-hoc Flutter structure.Write the minimum code that solves the current request.
fl_ui, core, or module widget fits.bloc-pattern.make lang.The test: if the same behavior can be expressed with an existing helper or pattern, reuse it.
Every changed line should trace back to the user request or to a required generator output.
When editing:
If a command causes broad churn, pause and ask whether to keep or revert it.
Turn each task into a verifiable outcome.
For multi-step work, track:
1. Change source of truth → verify generated/config output
2. Update call sites → verify stale references are gone
3. Run targeted checks → verify analyzer/tests pass
Prefer concrete checks:
rg for stale identifiers, locale codes, or old keys.make lang after localization CSV edits.make gen_core, make gen_main, or make gen_all only after relevant generated inputs change.fvm flutter analyze --no-pub from affected packages.Use these before editing derived files:
| Area | Source of truth | Regenerate/check |
|---|---|---|
| App IDs/display names | apps/main/app_identifier.yaml | sh gen_app_identifier.sh apps/main |
| App/core/media strings | */lib/l10n/localizations.csv | make lang |
BLoC _StateData / JSON / DI | annotated Dart files | make gen_core, make gen_main, or make gen_all |
| Theme tokens | plugins/fl_theme/ and existing extensions | fvm flutter analyze --no-pub |
| Navigation | IRoute, CustomRouter, coordinators | route-config checklist |