@haposoft/cafekit 0.15.3 → 0.16.0-rc.1

package/src/claude/skills/inspect/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: hapo:inspect
-description: "Fast codebase discovery using parallel agents. Use for file discovery, task context gathering, quick searches across directories. Supports internal (Explore) and external (Gemini) agents."
+description: "Fast codebase discovery using parallel agents. Use for file discovery, task context gathering, quick searches across directories. Supports internal Explore agents."
 user-invocable: true
 when_to_use: "Invoke for fast parallel codebase discovery and file location."
 category: discovery
 keywords: [discovery, search, explore, context]
-argument-hint: "[search-target] [ext]"
+argument-hint: "[search-target]"
 metadata:
   author: haposoft
-  version: "2.0.0"
+  version: "2.1.0"
 ---
 # Inspect
 
@@ -16,7 +16,6 @@ Fast, token-efficient codebase discovery using parallel agents to find files nee
 
 ## Arguments
 - Default: Inspect using built-in Explore subagents in parallel (`./references/internal-inspection.md`)
-- `ext`: Inspect using external Gemini CLI tool in parallel (`./references/external-gemini-inspection.md`)
 
 ## When to Use
 
@@ -24,9 +23,9 @@ Fast, token-efficient codebase discovery using parallel agents to find files nee
 - Debugging that needs file relationships; project structure questions
 - Before multi-area changes, review, debug, or impact analysis
 
-## Preflight Scope Gate (MANDATORY - All Modes)
+## Preflight Scope Gate (MANDATORY)
 
-Before scanning with ANY mode (internal or external):
+Before scanning:
 1. Detect repo-root or root-wide scans such as `.`, `/`, `./`, `**/*`, `**/*.ts`, or similar broad patterns without a scoped directory.
 2. Apply the built-in no-scan lists below.
 3. Prefer file-type or glob hints whenever possible.
@@ -38,14 +37,14 @@ Before scanning with ANY mode (internal or external):
 Spawn **one scout** to map top-level layout before dividing work:
 1. List immediate children of the scope root (dirs + key config; monorepo markers)
 2. Rough file count per discovered directory
-3. Return a division plan of 1–6 logical sub-scopes (path/glob, est. files, focus)
+3. Return a division plan of 1–10 logical sub-scopes (path/glob, est. files, focus)
 
 Wait for Scout before Phase 2.
 
 ### Phase 2 — Parallel Explore Agents (Based on Scout Results)
 
 1. Follow Scout's plan; merge scopes < 10 files; split scopes > 100 files
-2. Spawn parallel Explore agents (SCALE 3–6 recommended), one per sub-scope
+2. Spawn parallel Explore agents, one per sub-scope
 3. Aggregate into the Inspect Report; offer deeper follow-up on specific areas
 
 **Fallback to AskUserQuestion:** if Scout is ambiguous (flat layout, < 3 areas), offer 2–4 concrete scopes from findings, then re-invoke with the chosen scope.
@@ -60,19 +59,6 @@ Wait for Scout before Phase 2.
 - private keys, token dumps, credential exports, `.env` secrets
 - generated bundles, binary blobs
 
-## Configuration
-
-Read from `.claude/runtime.json`:
-```json
-{
-  "gemini": {
-    "model": "gemma-4-31b-it"
-  }
-}
-```
-
-Default model: `gemma-4-31b-it` (installed with `npx @haposoft/cafekit`).
-
 ## Workflow
 
 ### 1. Analyze Task
@@ -86,7 +72,7 @@ SCALE = ceil(estimated_files_to_scan / 50)
 
 - Min SCALE = 1; Max SCALE = 10
 - SCALE 1-2: focused (< 100 files)
-- SCALE 3-5: medium (suitable for external Gemini CLI)
+- SCALE 3-5: medium
 - SCALE 6-10: large (internal Explore agents)
 
 ### 2. Divide and Conquer
@@ -101,16 +87,13 @@ SCALE = ceil(estimated_files_to_scan / 50)
 
 | Condition | Mode |
 |---|---|
-| No `ext` argument | Internal Explore agents |
-| `ext` + SCALE ≤ 5 | Gemini CLI (if available + scope gate passed) |
-| `ext` + SCALE ≥ 6 | Internal Explore agents |
-| Gemini unavailable/fails | Fallback to internal Explore |
+| Always | Internal Explore agents |
 
-Load: **Internal** `./references/internal-inspection.md` or **External** `./references/external-gemini-inspection.md`.
+Load: **Internal** `./references/internal-inspection.md`.
 
 ### 5. Spawn Parallel Agents
 
-**Internal mode:** dispatch native Explore agents with breadth medium/very-thorough + the Scope Gate above. Details: `./references/internal-inspection.md`.
+Dispatch native Explore agents with breadth medium/very-thorough + the Scope Gate above. Details: `./references/internal-inspection.md`.
 
 - `TaskUpdate` each task to `in_progress` before spawn
 - Prompt each subagent with exact directories/files; each has < 200K context
@@ -147,5 +130,4 @@ Load: **Internal** `./references/internal-inspection.md` or **External** `./refe
 
 ## References
 
-- `./references/internal-inspection.md` - Using Explore subagents
-- `./references/external-gemini-inspection.md` - Using Gemini CLI
+- `./references/internal-inspection.md` - Using Explore subagents

package/src/claude/skills/mobile-development/SKILL.md

@@ -31,8 +31,8 @@ Production-ready mobile development with modern frameworks, best practices, and
 ## Technology Selection Guide
 
 **Cross-Platform Frameworks:**
-- **React Native**: JavaScript expertise, web code sharing, mature ecosystem (121K stars, 67% familiarity)
-- **Flutter**: Performance-critical apps, complex animations, fastest-growing (170K stars, 46% adoption)
+- **React Native**: JavaScript expertise, web code sharing, mature ecosystem
+- **Flutter**: Performance-critical apps, complex animations, fastest-growing
 
 **Native Development:**
 - **iOS (Swift/SwiftUI)**: Maximum iOS performance, latest features, Apple ecosystem integration
@@ -44,7 +44,7 @@ See: `references/mobile-frameworks.md` for detailed framework comparisons
 
 **The 10 Commandments of Mobile Development:**
 
-1. **Performance is Foundation, Not Feature** - 70% abandon apps >3s load time
+1. **Performance is Foundation, Not Feature** - Slow load times can drive users away
 2. **Every Kilobyte, Every Millisecond Matters** - Mobile constraints are real
 3. **Offline-First by Default** - Network is unreliable, design for it
 4. **User Context > Developer Environment** - Think real-world usage scenarios
@@ -72,7 +72,7 @@ See: `references/mobile-mindset.md` for thinking patterns and decision framework
 ## Key Best Practices (2024-2025)
 
 **Performance Targets:**
-- App launch: <2 seconds (70% abandon if >3s)
+- App launch: <2 seconds; slow launches risk abandonment
 - Memory usage: <100MB for typical screens
 - Network requests: Batch and cache aggressively
 - Battery impact: Respect Doze Mode and background restrictions
@@ -92,7 +92,7 @@ See: `references/mobile-mindset.md` for thinking patterns and decision framework
 - Implement proper session management
 
 **Testing Strategy:**
-- Unit tests: 70%+ coverage for business logic
+- Unit tests: meaningful coverage for business logic
 - Integration tests: Critical user flows
 - E2E tests: Detox (React Native), Appium (cross-platform), XCUITest (iOS), Espresso (Android)
 - Real device testing mandatory before release
@@ -101,7 +101,7 @@ See: `references/mobile-mindset.md` for thinking patterns and decision framework
 - Fastlane for automation across platforms
 - Staged rollouts: Internal → Closed → Open → Production
 - Mandatory: iOS 17 SDK (2024), Android 15 API 35 (Aug 2025)
-- CI/CD saves 20% development time
+- CI/CD saves development time
 
 ## Quick Decision Matrix
 
@@ -121,9 +121,9 @@ See: `references/mobile-mindset.md` for thinking patterns and decision framework
 
 | Criterion | React Native | Flutter | Swift/SwiftUI | Kotlin/Compose |
 |-----------|--------------|---------|---------------|----------------|
-| **Stars** | 121K | 170K | N/A | N/A |
-| **Adoption** | 35% | 46% | iOS only | Android only |
-| **Performance** | 80-90% native | 85-95% native | 100% native | 100% native |
+| **Community footprint** | Large | Large | Apple ecosystem | Android ecosystem |
+| **Adoption** | Established | Established | iOS only | Android only |
+| **Performance** | Near-native when profiled | Near-native when profiled | Native baseline | Native baseline |
 | **Dev Speed** | Fast (hot reload) | Very fast (hot reload) | Fast (Xcode Previews) | Fast (Live Edit) |
 | **Learning Curve** | Easy (JavaScript) | Medium (Dart) | Medium (Swift) | Medium (Kotlin) |
 | **UI Paradigm** | Component-based | Widget-based | Declarative | Declarative |
@@ -148,7 +148,7 @@ See: `references/mobile-mindset.md` for thinking patterns and decision framework
 - Image optimization → Lazy loading → Memory profiling → Network optimization → Battery testing → Launch time optimization
 
 **Quality:**
-- Unit tests (70%+) → Integration tests → E2E tests → Accessibility testing → Performance testing → Security audit
+- Unit tests → Integration tests → E2E tests → Accessibility testing → Performance testing → Security audit
 
 **Security:**
 - Secure storage → Authentication flow → Network security → Input validation → Session management → Encryption
@@ -179,7 +179,7 @@ See: `references/mobile-mindset.md` for thinking patterns and decision framework
 3. **No offline handling** - Network failures will happen
 4. **Poor memory management** - Leads to crashes and poor UX
 5. **Hardcoded credentials** - Security vulnerability
-6. **No accessibility** - Excludes 15%+ of users
+6. **No accessibility** - Can exclude users
 7. **Premature optimization** - Optimize based on metrics, not assumptions
 8. **Over-engineering** - Start simple, scale as needed
 9. **Skipping real device testing** - Simulators don't show battery/network issues
@@ -193,7 +193,7 @@ See: `references/mobile-mindset.md` for thinking patterns and decision framework
 - **Screen load**: <1 second for cached data
 - **Network request**: <3 seconds for API calls
 - **Memory**: <100MB for typical screens, <200MB peak
-- **Battery**: <5% drain per hour of active use
+- **Battery**: Minimize drain during active use
 - **Frame rate**: 60 FPS (16.67ms per frame)
 
 ## Resources

package/src/claude/skills/mobile-development/references/mobile-android.md

@@ -74,8 +74,8 @@ when (uiState) {
 
 ### Why Compose?
 - **Declarative**: Describe UI state, not imperative commands
-- **60% adoption**: In top 1,000 apps (2024)
-- **Less code**: 40% reduction vs Views
+- **Adoption**: Used in many top 1,000 apps
+- **Less code**: Reduction vs Views
 - **Modern**: Built for Kotlin and coroutines
 - **Material 3**: First-class support
 
@@ -310,7 +310,7 @@ class UserViewModel(
 
 **Hilt vs Koin:**
 - **Hilt**: Compile-time, type-safe, Google-backed, complex setup
-- **Koin**: Runtime, simple DSL, 50% faster setup, reflection-based
+- **Koin**: Runtime, simple DSL, faster setup, reflection-based
 
 ## Performance Optimization
 
@@ -335,14 +335,14 @@ android {
 ```
 
 **Impact:**
-- 10-20% app size reduction
-- 20% faster startup
+- Smaller app size
+- Faster startup
 - Harder to reverse engineer
 
 ### Baseline Profiles
 
 **Performance boost:**
-- 10-20% faster startup
+- Faster startup
 - Reduced jank in critical paths
 - AOT compilation of hot code
 
@@ -572,7 +572,7 @@ android {
 ```
 
 **Benefits:**
-- 15-30% smaller downloads
+- Smaller downloads
 - Dynamic feature modules
 - Instant apps support
 

package/src/claude/skills/mobile-development/references/mobile-best-practices.md

@@ -86,8 +86,8 @@ User opens screen
 - Background App Refresh (iOS)
 
 **Targets:**
-- Active use: <5% per hour
-- Background: <1% per hour
+- Active use: minimize foreground energy use
+- Background: minimize background energy use
 
 ## Offline-First Architecture
 
@@ -315,8 +315,8 @@ messaging().onNotificationOpenedApp(remoteMessage => {
 ```
 
 **Impact:**
-- 25% revenue increase with proper personalization
-- 88% opt-in rate with pre-permission modal (vs 40% without)
+- Personalization can increase revenue
+- Pre-permission modal can improve opt-in rate
 
 ## Authentication & Authorization
 
@@ -443,10 +443,10 @@ const token = credentials.password;
 - Expedited: 1-2 hours (emergencies only)
 
 **Rejection Reasons:**
-- Crashes (50%)
-- Privacy violations (25%)
-- Incomplete information (15%)
-- Guideline violations (10%)
+- Crashes
+- Privacy violations
+- Incomplete information
+- Guideline violations
 
 ### Google Play (Android)
 
@@ -460,7 +460,7 @@ const token = credentials.password;
 1. Build signed AAB (Android App Bundle)
 2. Upload to Play Console
 3. Submit to production track
-4. Staged rollout (10% → 50% → 100%)
+4. Staged rollout (pilot → partial → full)
 
 **Review Time:**
 - Average: 1-3 days
@@ -468,22 +468,21 @@ const token = credentials.password;
 
 ### Staged Rollout Strategy
 
-**Week 1:**
-- 10% of users
+**Pilot:**
+- Release to a small audience
 - Monitor crash-free rate
 - Watch for critical bugs
 
-**Week 2:**
-- 50% of users
+**Partial rollout:**
+- Expand audience after pilot
 - Validate performance metrics
 - Check user feedback
 
-**Week 3:**
-- 100% of users
-- Full release if metrics healthy
+**Full rollout:**
+- Release to all users when metrics are healthy
 
 **Rollback Triggers:**
-- Crash-free rate drops >5%
+- Crash-free rate shows a material drop
 - Critical bug discovered
 - Major user complaints
 
@@ -493,12 +492,12 @@ const token = credentials.password;
 
 | Metric | React Native | Flutter |
 |--------|--------------|---------|
-| **Adoption** | 35% | 46% |
-| **Performance** | 80-90% | 85-95% |
-| **App Size** | 40-50MB | 15-20MB |
-| **Dev Speed** | Fast | Very Fast |
-| **Commercial** | 12.57% | 5.24% |
-| **Developers** | 20:1 ratio | 1 ratio |
+| **Adoption** | Established | Established |
+| **Performance** | Near-native when profiled | Near-native when profiled |
+| **App Size** | Moderate | Moderate |
+| **Dev Speed** | Fast | Very fast |
+| **Commercial footprint** | Established | Established |
+| **Developers** | Broad ecosystem | Broad ecosystem |
 | **Best For** | JS teams | Performance |
 
 ### Architecture Comparison

package/src/claude/skills/mobile-development/references/mobile-frameworks.md

@@ -7,8 +7,8 @@ Comprehensive guide to mobile development frameworks: React Native, Flutter, and
 ### React Native
 - **Language**: JavaScript/TypeScript
 - **Stars**: 121,000+ on GitHub
-- **Adoption**: 35% of mobile developers, 67% familiarity
-- **Performance**: 80-90% native performance
+- **Adoption**: Broad adoption and familiarity among mobile developers
+- **Performance**: Near-native performance
 - **Architecture**: Bridge-based (legacy) → New Architecture (JSI, Fabric, Codegen)
 - **Rendering**: Native components
 - **Hot Reload**: Yes
@@ -17,8 +17,8 @@ Comprehensive guide to mobile development frameworks: React Native, Flutter, and
 ### Flutter
 - **Language**: Dart
 - **Stars**: 170,000+ on GitHub (fastest-growing)
-- **Adoption**: 46% of mobile developers
-- **Performance**: 85-95% native performance
+- **Adoption**: Broad adoption among mobile developers
+- **Performance**: Near-native performance
 - **Architecture**: "Everything is a widget"
 - **Rendering**: Custom Impeller rendering engine (eliminates jank)
 - **Hot Reload**: Yes (fastest in industry)
@@ -26,7 +26,7 @@ Comprehensive guide to mobile development frameworks: React Native, Flutter, and
 
 ### Native iOS (Swift/SwiftUI)
 - **Language**: Swift
-- **Performance**: 100% native
+- **Performance**: Native performance
 - **UI Framework**: SwiftUI (declarative) or UIKit (imperative)
 - **Latest**: Swift 6 with compile-time data race detection
 - **Tooling**: Xcode 16, Swift Package Manager
@@ -34,7 +34,7 @@ Comprehensive guide to mobile development frameworks: React Native, Flutter, and
 
 ### Native Android (Kotlin/Jetpack Compose)
 - **Language**: Kotlin
-- **Performance**: 100% native
+- **Performance**: Native performance
 - **UI Framework**: Jetpack Compose (declarative) or Views (imperative)
 - **Latest**: Kotlin 2.1, Compose 1.7
 - **Tooling**: Android Studio Hedgehog+
@@ -51,7 +51,7 @@ Comprehensive guide to mobile development frameworks: React Native, Flutter, and
 - **Turbo Modules**: Lazy-loaded native modules
 
 **Performance Optimizations**
-- **Hermes Engine**: 30-40% faster startup, reduced memory
+- **Hermes Engine**: Faster startup, reduced memory
 - **Native Driver Animations**: Offloaded to UI thread (60 FPS)
 - **FlatList Virtualization**: Renders only visible items
 - **Image Optimization**: FastImage library, progressive loading
@@ -81,14 +81,14 @@ src/
 4. **Context API**: Simple apps, avoid prop drilling
 
 **Navigation**
-- **React Navigation**: Industry standard, 80%+ adoption
+- **React Navigation**: Industry standard
 - Type-safe navigation with TypeScript
 - Deep linking configuration
 - Tab, stack, drawer navigators
 
 **TypeScript Adoption**
-- 85%+ of new React Native projects use TypeScript
-- Type safety prevents 15% of runtime errors
+- TypeScript is common in new React Native projects
+- Type safety helps prevent runtime errors
 - Better IDE support and autocomplete
 
 ### Testing Strategy
@@ -130,7 +130,7 @@ test('login button should be enabled when form is valid', async () => {
 - Rapid prototyping and MVPs
 - Strong community support needed
 - npm ecosystem integration
-- Commercial apps (12.57% market share)
+- Commercial apps
 
 **❌ Not Ideal For:**
 - Heavy graphics/gaming (use native or Unity)
@@ -254,7 +254,7 @@ testWidgets('Counter increments', (WidgetTester test-runner) async {
 - Move semantics for performance
 
 **SwiftUI vs UIKit**
-- **SwiftUI**: Declarative, 40% less code, iOS 13+, modern approach
+- **SwiftUI**: Declarative, less code, iOS 13+, modern approach
 - **UIKit**: Imperative, fine-grained control, legacy support, complex customizations
 - Both work together in same project
 
@@ -318,7 +318,7 @@ struct LoginView: View {
 
 **Jetpack Compose**
 - Declarative UI (like SwiftUI/React)
-- 60% adoption in top 1,000 apps
+- Widely adopted in top 1,000 apps
 - Material Design 3 integration
 - Compose compiler with Kotlin 2.0+
 

package/src/claude/skills/mobile-development/references/mobile-ios.md

@@ -53,7 +53,7 @@ actor UserCache {
 ✅ Declarative UI preferred
 ✅ Fast iteration needed
 ✅ Cross-platform (macOS, watchOS, tvOS)
-✅ 40% less code vs UIKit
+✅ Less code vs UIKit
 
 ### When to Use UIKit
 ✅ Legacy app maintenance

package/src/claude/skills/mobile-development/references/mobile-mindset.md

@@ -5,7 +5,7 @@ Essential thinking patterns and decision-making frameworks for successful mobile
 ## The 10 Commandments of Mobile Development
 
 ### 1. Performance is Foundation, Not Feature
-- **Reality**: 70% users abandon apps >3s load time
+- **Reality**: Users may abandon apps when load time exceeds 3s
 - **Mindset**: Optimize from day one, not "later"
 - **Action**: Set performance budgets before writing code
 
@@ -50,7 +50,7 @@ Essential thinking patterns and decision-making frameworks for successful mobile
 - **Action**: MVVM for small apps, Clean Architecture when complexity demands
 
 ### 10. Continuous Learning is Survival
-- **Reality**: 85% developers use AI tools (2024), frameworks evolve constantly
+- **Reality**: AI tools are widely used by developers (2024), frameworks evolve constantly
 - **Mindset**: Embrace change, allocate learning time
 - **Action**: 1+ hour weekly for new tech/patterns
 
@@ -131,7 +131,7 @@ Essential thinking patterns and decision-making frameworks for successful mobile
 - "It just works" expectation = zero tolerance for crashes
 
 **Fragmentation**: LOW
-- 90%+ on iOS 16+ (2024)
+- Most users on iOS 16+ (2024)
 - Only ~50 device models to test
 - Predictable hardware specs
 
@@ -165,7 +165,7 @@ Essential thinking patterns and decision-making frameworks for successful mobile
 - Handle back button properly
 
 **When to Go Native Android:**
-- Global market focus (72% market share)
+- Global market focus (Android dominates)
 - Emerging markets (Android dominates)
 - Enterprise/B2B (customization needs)
 
@@ -177,7 +177,7 @@ Essential thinking patterns and decision-making frameworks for successful mobile
 |--------|-----------|-----------------|
 | **Launch time** | <2s | Acceptable |
 | **Launch time** | 2-3s | Noticeable delay |
-| **Launch time** | >3s | 70% abandon |
+| **Launch time** | >3s | Users may abandon |
 | **Screen load** | <1s | Instant (cached) |
 | **Screen load** | 1-3s | Acceptable (network) |
 | **Screen load** | >3s | Frustrating |
@@ -259,46 +259,44 @@ Week 2: Polish + Ship
 8. Merge to develop
 
 **CI/CD Impact:**
-- 20% reduction in development time
-- 50% fewer production bugs
-- 3x faster deployment
+- Faster development and deployment with fewer production bugs
 
 ### Common Pitfalls & Avoidance
 
 #### 1. Testing Only on Simulators
 **Problem**: Simulators don't show real performance (battery, memory, network)
 **Solution**: Real device testing mandatory before every release
-**Impact**: 40% of bugs only appear on real devices
+**Impact**: Some bugs only appear on real devices
 
 #### 2. Ignoring Platform Conventions
 **Problem**: Custom navigation confuses users
 **Solution**: Follow iOS HIG and Material Design
-**Impact**: 30% lower engagement with non-standard UIs
+**Impact**: Non-standard UIs can lower engagement
 
 #### 3. No Offline Handling
 **Problem**: Network failures = blank screens, errors
 **Solution**: Offline-first architecture, cached data
-**Impact**: 50% of users experience network issues daily
+**Impact**: Users can experience network issues daily
 
 #### 4. Poor Memory Management
 **Problem**: Memory leaks → crashes, poor performance
 **Solution**: ARC/GC understanding, profile regularly
-**Impact**: Memory issues = #1 crash cause (35%)
+**Impact**: Memory issues are a leading crash cause
 
 #### 5. Hardcoded Credentials
 **Problem**: Security vulnerability, API key exposure
 **Solution**: Environment variables, secure storage
-**Impact**: 23% of apps leak sensitive data (OWASP)
+**Impact**: Apps can leak sensitive data; follow OWASP guidance.
 
 #### 6. No Accessibility
-**Problem**: Excludes 15%+ of users (disability, situational)
+**Problem**: Excludes users with disabilities or situational needs
 **Solution**: VoiceOver/TalkBack testing, semantic labels
 **Impact**: Accessibility = 1.3B global market
 
 #### 7. Premature Optimization
 **Problem**: Wasted time optimizing non-bottlenecks
 **Solution**: Measure first, optimize biggest impact
-**Impact**: 80% of performance issues = 20% of code
+**Impact**: Many performance issues come from a small part of the code
 
 #### 8. Over-Engineering
 **Problem**: Complex architecture for simple apps
@@ -308,7 +306,7 @@ Week 2: Polish + Ship
 #### 9. Skipping Real Device Testing
 **Problem**: Missed battery drain, thermal issues
 **Solution**: Device farm in CI/CD, manual testing
-**Impact**: 25% of performance issues device-specific
+**Impact**: Some performance issues are device-specific
 
 #### 10. Not Respecting Battery
 **Problem**: Background processing drains battery
@@ -460,12 +458,12 @@ if (isLowEndDevice) {
 
 **Example Architecture:**
 ```
-React Native / Flutter (90%)
+React Native / Flutter
 ├─ UI and business logic
 ├─ Standard features
 └─ API integration
 
-Native Modules (10%)
+Native Modules
 ├─ Performance-critical (video processing)
 ├─ Platform-specific (HealthKit, Android Auto)
 └─ Third-party SDKs (payment, analytics)
@@ -535,7 +533,7 @@ v4.0: Extract microservices if justified
 - Discord (React Native, Flutter official)
 - Twitter: Follow framework creators and contributors
 
-**AI Tools (85% adoption in 2024):**
+**AI Tools (widely adopted in 2024):**
 - GitHub Copilot: Code completion, boilerplate
 - ChatGPT/Claude: Architecture questions, debugging
 - Tabnine: Context-aware suggestions

package/src/claude/skills/question/SKILL.md

@@ -30,14 +30,14 @@ The output is an answer, evidence, confidence, and a follow-up only when needed.
 ## When To Use
 
 Use `hapo:question` when the user asks:
-- "Trong hệ thống này X làm gì?"
-- "Luồng này đang xử lý ở đâu?"
-- "Config/version/package hiện tại là gì?"
-- "Có dùng thư viện/công nghệ/cách làm nào không?"
-- "Requirement/spec này có khớp code không?"
-- "Tool/library/framework này nên dùng thế nào?"
-- "Theo best practice/current docs thì sao?"
-- "Tôi nên hiểu phần này như thế nào?"
+- "What does X do in this system?"
+- "Where is this flow handled?"
+- "What is the current config/version/package?"
+- "Does it use a particular library/technology/approach?"
+- "Does this requirement/spec match the code?"
+- "How should I use this tool/library/framework?"
+- "What does best practice or the current docs say?"
+- "How should I understand this part?"
 
 Do not use it when:
 - The user asks to implement, fix, debug, test, commit, or publish.
@@ -131,14 +131,14 @@ Use `templates/question.md` when the user asks to save or document the answer.
 - Separate "confirmed by source" from "inferred".
 - Keep the answer proportional: concise for simple questions, structured for complex ones.
 - If external sources were used, include source links or names.
-- If no evidence exists, say "không thấy bằng chứng trong source hiện tại" and explain what was checked.
+- If no evidence exists, say "no evidence found in the current source" and explain what was checked.
 
 ## Examples
 
 ### Source Question
 
 ```text
-/hapo:question "Trong hệ thống này cafekit dùng file nào để bật/tắt skill routing?"
+/hapo:question "In this system, which file does cafekit use to toggle skill routing?"
 ```
 
 Expected behavior:
@@ -149,7 +149,7 @@ Expected behavior:
 ### Mixed Source + Web Question
 
 ```text
-/hapo:question "Dự án này đang dùng React version nào, và version đó có còn phù hợp theo best practice hiện tại không?" --both
+/hapo:question "Which React version does this project use, and does that version still match current best practice?" --both
 ```
 
 Expected behavior:
@@ -160,8 +160,8 @@ Expected behavior:
 ### Ask Back
 
 ```text
-/hapo:question "Hệ thống này có ổn không?"
+/hapo:question "Is this system stable?"
 ```
 
 Expected behavior:
-- ask one narrowing question because "ổn" could mean architecture, security, performance, UX, tests, or deploy readiness.
+- ask one narrowing question because "stable" could mean architecture, security, performance, UX, tests, or deploy readiness.

package/src/claude/skills/research/SKILL.md

@@ -12,7 +12,7 @@ metadata:
 ---
 # Research (Delegation Facade)
 
-**Mantra:** YAGNI, KISS, DRY. Be brutal, straight to the point, and strictly authoritative.
+**Mantra:** Return ranked recommendations with sources; never an unsorted list of options.
 
 This skill acts as a **Command Facade**. When invoked, the main Orchestrator MUST NOT attempt to run WebSearch itself. Instead, it must instantly delegate the operation to the Specialized Subagent.
 
@@ -40,7 +40,7 @@ Output Format: Must strictly follow the 'Standard Research Report' layout.
 The subagent MUST return the findings formatted EXACTLY according to the built-in specification template.
 
 Instruct the Researcher Subagent with this strict requirement:
-> "Sử dụng nguyên bản template tại `packages/spec/src/claude/skills/specs/templates/research.md`. Tuyệt đối không tự ý đẻ thêm các đề mục ngoài phạm vi file template này."
+> "Use the template at .claude/skills/specs/templates/research.md verbatim. Do not add sections beyond it."
 
 ## Post-Execution
 Once the `researcher` completes the Task and returns the Markdown output, save it based on context: