composewebview-code-review

name	composewebview-code-review
description	Performs code quality checks and reviews for ComposeWebView. Validates expect/actual implementations, KDoc coverage, Spotless formatting, and multiplatform patterns. Use when reviewing PRs, checking code quality, or validating new features.

ComposeWebView Code Review & Quality

This skill automates code quality checks and assists with pull request reviews for the ComposeWebView multiplatform library.

Quick Review

Run complete review workflow:

bash .agents/skills/code-review/scripts/review_checklist.sh

This executes all quality checks: formatting, expect/actual validation, KDoc coverage, and tests.

Review Categories

1. Code Formatting

Check formatting (non-destructive):

./gradlew spotlessCheck

Auto-fix formatting:

./gradlew spotlessApply

Spotless enforces ktlint rules. REQUIRED before all commits.

2. Multiplatform Completeness

Check expect/actual pairs:

bash .agents/skills/code-review/scripts/check_expect_actual.sh

Verifies:

• Every expect declaration has corresponding actual implementations
• All platforms (Android, iOS, Desktop, JS, WASM) are covered
• No orphaned actual declarations

3. Documentation Coverage

Verify KDoc:

bash .agents/skills/code-review/scripts/verify_kdoc.sh

Checks:

• All public APIs have KDoc comments
• KDoc includes @param and @return where applicable
• No placeholder documentation (e.g., "TODO")

4. Testing Coverage

Ensure tests exist for:

• Common functionality in commonTest
• Platform-specific features in platform test sources
• Critical paths (WebView loading, JS bridge, state management)

Run tests:

bash .agents/skills/development/scripts/test_all.sh

5. Architecture Compliance

Verify adherence to project patterns:

• State management via WebViewState (see .agents/knowledge/architecture.md)
• Controller separation via WebViewController
• Proper platform abstraction (expect/actual)

See reference/common_patterns.md for patterns.

Review Checklists

Feature Implementation

Copy and work through: checklists/feature_checklist.md

Quick checklist:

- [ ] Defined in commonMain with expect
- [ ] Implemented in all 5 platforms (Android, iOS, Desktop, JS, WASM)
- [ ] Public APIs have KDoc with @param/@return
- [ ] Tests added in commonTest and platform tests
- [ ] Spotless formatting applied
- [ ] Updated relevant documentation
- [ ] Follows existing patterns (State/Controller)
- [ ] Platform constraints considered (iOS, Desktop, WASM)
- [ ] Kotlinx Serialization used for JSON
- [ ] Null safety enforced (no !! operator)
- [ ] Immutability preferred (val over var)

Pull Request Review

Copy and work through: checklists/pr_checklist.md

Essential checks:

• Code quality (formatting, naming, structure)
• Multiplatform completeness
• Test coverage
• Documentation updates
• Breaking change assessment

Multiplatform Validation

For complex platform work: checklists/multiplatform_checklist.md

Platform-specific considerations:

• Android: WebView API usage, permissions
• iOS: WKWebView constraints, message handlers
• Desktop: CEF initialization, threading
• Web (JS): IFrame limitations, postMessage bridge
• Web (WASM): Same-origin policy, limited native features

Automated Checks

Complete Review Script

bash .agents/skills/code-review/scripts/review_checklist.sh

Checks performed:

1. ✅ Code formatting (Spotless)
2. ✅ Expect/actual completeness
3. ⚠️ KDoc coverage (warning only)
4. ✅ All tests passing

Exit codes:

• 0 - All checks passed
• 1 - Critical issues found (formatting, tests, expect/actual)

Individual Checks

Expect/Actual:

bash .agents/skills/code-review/scripts/check_expect_actual.sh

KDoc Coverage:

bash .agents/skills/code-review/scripts/verify_kdoc.sh

Formatting:

bash .agents/skills/development/scripts/format_check.sh

Common Issues & Solutions

See reference/review_guidelines.md for:

• Common multiplatform pitfalls
• Platform-specific gotchas (WKWebView, CEF)
• Performance considerations
• Breaking change checklist

Quick Fixes

Formatting issues:

./gradlew spotlessApply

Missing actual implementation:

1. Identify the expect declaration
2. Add actual to all platform source sets
3. Verify: bash .agents/skills/code-review/scripts/check_expect_actual.sh

Missing KDoc:

/**
 * Brief description of what this does.
 *
 * @param param Description of parameter
 * @return Description of return value
 */
fun publicFunction(param: String): Result

Review Workflow

Before Submitting PR

1. Format code:

   ./gradlew spotlessApply
   

2. Run full review:

   bash .agents/skills/code-review/scripts/review_checklist.sh
   

3. Fix any issues reported

4. Run tests:

   bash .agents/skills/development/scripts/test_all.sh
   

5. Commit and push

During Code Review

1. Check PR against checklist:

   • Use pr_checklist.md

2. Verify multiplatform completeness:

   bash .agents/skills/code-review/scripts/check_expect_actual.sh
   

3. Review architectural patterns:

   • Refer to common_patterns.md
   • Check .agents/knowledge/architecture.md

4. Test locally:

   git checkout pr-branch
   bash .agents/skills/development/scripts/test_all.sh
   

Best Practices

Code Quality

1. Consistent naming: Follow Kotlin conventions

   • Classes: PascalCase
   • Functions/properties: camelCase
   • Constants: UPPER_SNAKE_CASE

2. Visibility modifiers:

   • public - External API
   • internal - Internal implementations
   • private - Encapsulated logic

3. Immutability: Prefer val over var

4. Null safety: Avoid !!, use safe calls ?. or ?:

Multiplatform

1. Keep common code platform-agnostic
2. Use expect/actual for platform specifics
3. Document platform constraints
4. Test on all platforms

Documentation

1. All public APIs must have KDoc
2. Include examples in documentation
3. Document platform differences
4. Keep docs up-to-date with code

CI/CD Integration

These checks can be integrated into GitHub Actions:

- name: Code Review Checks
  run: bash .agents/skills/code-review/scripts/review_checklist.sh

Scripts Reference

review_checklist.sh

Comprehensive review running all checks. Returns non-zero exit code if critical issues found.

check_expect_actual.sh

Validates that all expect declarations have actual implementations on all platforms.

verify_kdoc.sh

Checks KDoc coverage for public APIs. Warning-level (doesn't fail build).

Related Resources

• Development: Development Skill
• Architecture: .agents/knowledge/architecture.md
• Code Style: .agents/knowledge/code_style.md
• Workflows: .agents/knowledge/commands.md

Troubleshooting

Review Script Fails

Check output for specific failure:

• Formatting → Run ./gradlew spotlessApply
• Tests → Fix failing tests
• Expect/actual → Implement missing actuals

False Positives

Expect/actual check counts declarations - may show warnings for:

• Internal implementations
• Platform-specific extensions

Review build errors for actual issues.

KDoc Warnings

Not all public APIs require extensive KDoc (e.g., simple getters). Use judgment, but prefer documentation.

---

Use this skill to maintain high code quality and consistent patterns across the ComposeWebView codebase.