Triggers#

• At the point of feature development completion
• Self-review before PR creation
• Before requesting code review

Usage#

/checklist/feature-complete [feature_name]

Verification Items#

1. Structure Verification#

Domain Layer

• Entity definition complete (@immutable + Equatable + copyWith)
• Repository Interface defined (I prefix)
• UseCase implementation complete
• Failure class defined
• Unit tests written

Data Layer

• Repository implementation complete
• Serverpod Mixin implemented (if needed)
• Local Database implemented (if needed)
• DTO ↔ Entity mapper implemented
• Caching strategy applied (SWR/Cache-First)

Presentation Layer

• Page widget implemented
• Reusable Widgets extracted
• BLoC/Cubit implemented
• Event/State defined (sealed class extends Equatable + copyWith)
• Widget tests written

DI & Routing

• Dependencies registered manually via GetIt (ServiceLocator.instance.registerLazySingleton/registerFactory)
• BLoC wired in bootstrap.dart (not auto-registered)
• Route defined with go_router (@TypedGoRoute + extends GoRouteData)
• Route redirect/guard applied (if needed)

2. Code Generation#

melos run build

• *.g.dart generated for go_router routes (@TypedGoRoute) and JSON
• No build errors

No *.freezed.dart (State/Event are hand-written). No @injectable codegen (DI is manual GetIt).

3. Testing#

Unit Tests

• UseCase tests (Happy path, Error, Edge cases)
• Repository tests (mocked data source)

BLoC Tests

• Initial state test
• Event → state transition tests
• Error handling tests

Widget Tests

• Rendering tests
• Interaction tests
• State-specific UI tests

flutter test feature/{type}/{feature_name}/test/
melos run test:with-html-coverage

• All tests passing
• Coverage 80% or above

4. Documentation#

• dartdoc comments on public APIs
• Explanatory comments on complex logic
• TODO comments resolved or issues filed

5. Internationalization#

• All UI text uses translation keys
• Translation files updated (melos run generate:locale)
• Pluralization/parameter handling verified

6. Performance Optimization#

• const widgets utilized
• BlocBuilder buildWhen applied
• ListView.builder used (for long lists)
• Image cacheWidth/cacheHeight applied
• Resources released in dispose

7. Security Review#

• No hardcoded sensitive information
• Input validation applied
• Appropriate error messages

8. Accessibility#

• Semantics labels applied
• Touch target size verified (48x48 minimum)
• Color contrast verified

9. Static Analysis#

melos run analyze       # dart analyze + dcm analyze
melos run format        # kobic uses dcm format (not dart format)
melos run lint:check    # combined format-check → analyze gate

• No lint warnings
• Code formatting complete
• DCM analysis passed
• Pre-push hook passed (auto-verified on push)

10. Integration Verification#

flutter build ios --flavor development
flutter build apk --flavor development

• iOS build successful
• Android build successful
• Working correctly in development environment

11. PR Preparation#

• Meaningful commit messages (Conventional + Gitmoji)
• Related issues linked
• Reviewers assigned

Completion Summary#

References#

• Detailed checklist: .claude/checklists/feature-complete.md
• PR review checklist: .claude/commands/checklist/pr-review.md
• Code review skill: .claude/commands/code-review.md