oh-my-ag 1.2.0

package/.agent/skills/mobile-agent/resources/screen-template.dart

@@ -0,0 +1,298 @@
+/**
+ * Screen Template for Mobile Agent (Flutter)
+ *
+ * This template demonstrates best practices for Flutter screens.
+ */
+
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+// Provider definition (in separate file: providers/example_providers.dart)
+/*
+final exampleProvider = FutureProvider<List<ExampleModel>>((ref) async {
+  final repository = ref.watch(exampleRepositoryProvider);
+  return repository.fetchData();
+});
+*/
+
+/// Example screen demonstrating common patterns
+class ExampleScreen extends ConsumerStatefulWidget {
+  /// Route name for navigation
+  static const routeName = '/example';
+
+  /// Constructor
+  const ExampleScreen({super.key});
+
+  @override
+  ConsumerState<ExampleScreen> createState() => _ExampleScreenState();
+}
+
+class _ExampleScreenState extends ConsumerState<ExampleScreen> {
+  // Local state (if needed)
+  final _scrollController = ScrollController();
+  bool _showScrollToTop = false;
+
+  @override
+  void initState() {
+    super.initState();
+    _setupScrollListener();
+  }
+
+  @override
+  void dispose() {
+    _scrollController.dispose();
+    super.dispose();
+  }
+
+  void _setupScrollListener() {
+    _scrollController.addListener(() {
+      final shouldShow = _scrollController.offset > 200;
+      if (shouldShow != _showScrollToTop) {
+        setState(() => _showScrollToTop = shouldShow);
+      }
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    // Watch providers
+    final dataAsync = ref.watch(exampleProvider);
+
+    return Scaffold(
+      // App bar
+      appBar: AppBar(
+        title: const Text('Example Screen'),
+        actions: [
+          IconButton(
+            icon: const Icon(Icons.refresh),
+            onPressed: () => ref.invalidate(exampleProvider),
+            tooltip: 'Refresh',
+          ),
+          IconButton(
+            icon: const Icon(Icons.settings),
+            onPressed: _navigateToSettings,
+            tooltip: 'Settings',
+          ),
+        ],
+      ),
+
+      // Body with async handling
+      body: dataAsync.when(
+        // Success state
+        data: (items) => _buildContent(items),
+
+        // Loading state
+        loading: () => const Center(
+          child: CircularProgressIndicator(),
+        ),
+
+        // Error state
+        error: (error, stackTrace) => _buildErrorState(error),
+      ),
+
+      // Floating action button
+      floatingActionButton: _showScrollToTop
+          ? FloatingActionButton(
+              onPressed: _scrollToTop,
+              child: const Icon(Icons.arrow_upward),
+            )
+          : null,
+    );
+  }
+
+  /// Builds main content
+  Widget _buildContent(List<dynamic> items) {
+    if (items.isEmpty) {
+      return _buildEmptyState();
+    }
+
+    return RefreshIndicator(
+      onRefresh: _handleRefresh,
+      child: CustomScrollView(
+        controller: _scrollController,
+        slivers: [
+          // Header
+          SliverToBoxAdapter(
+            child: Padding(
+              padding: const EdgeInsets.all(16),
+              child: Text(
+                '${items.length} Items',
+                style: Theme.of(context).textTheme.titleMedium,
+              ),
+            ),
+          ),
+
+          // List
+          SliverList(
+            delegate: SliverChildBuilderDelegate(
+              (context, index) {
+                final item = items[index];
+                return _buildListItem(item, index);
+              },
+              childCount: items.length,
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+
+  /// Builds individual list item
+  Widget _buildListItem(dynamic item, int index) {
+    return Card(
+      margin: const EdgeInsets.symmetric(
+        horizontal: 16,
+        vertical: 8,
+      ),
+      child: ListTile(
+        leading: CircleAvatar(
+          child: Text('${index + 1}'),
+        ),
+        title: Text(item.title ?? 'Untitled'),
+        subtitle: Text(item.description ?? ''),
+        trailing: IconButton(
+          icon: const Icon(Icons.chevron_right),
+          onPressed: () => _navigateToDetail(item),
+        ),
+        onTap: () => _navigateToDetail(item),
+      ),
+    );
+  }
+
+  /// Builds empty state
+  Widget _buildEmptyState() {
+    return Center(
+      child: Column(
+        mainAxisAlignment: MainAxisAlignment.center,
+        children: [
+          Icon(
+            Icons.inbox,
+            size: 64,
+            color: Theme.of(context).colorScheme.secondary,
+          ),
+          const SizedBox(height: 16),
+          Text(
+            'No items yet',
+            style: Theme.of(context).textTheme.titleLarge,
+          ),
+          const SizedBox(height: 8),
+          Text(
+            'Add your first item to get started',
+            style: Theme.of(context).textTheme.bodyMedium?.copyWith(
+                  color: Theme.of(context).colorScheme.onSurface.withOpacity(0.6),
+                ),
+          ),
+          const SizedBox(height: 24),
+          ElevatedButton.icon(
+            onPressed: _showAddDialog,
+            icon: const Icon(Icons.add),
+            label: const Text('Add Item'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  /// Builds error state
+  Widget _buildErrorState(Object error) {
+    return Center(
+      child: Padding(
+        padding: const EdgeInsets.all(24),
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: [
+            Icon(
+              Icons.error_outline,
+              size: 64,
+              color: Theme.of(context).colorScheme.error,
+            ),
+            const SizedBox(height: 16),
+            Text(
+              'Oops! Something went wrong',
+              style: Theme.of(context).textTheme.titleLarge,
+              textAlign: TextAlign.center,
+            ),
+            const SizedBox(height: 8),
+            Text(
+              error.toString(),
+              style: Theme.of(context).textTheme.bodyMedium?.copyWith(
+                    color: Theme.of(context).colorScheme.onSurface.withOpacity(0.6),
+                  ),
+              textAlign: TextAlign.center,
+            ),
+            const SizedBox(height: 24),
+            ElevatedButton.icon(
+              onPressed: () => ref.invalidate(exampleProvider),
+              icon: const Icon(Icons.refresh),
+              label: const Text('Try Again'),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  // Event handlers
+
+  Future<void> _handleRefresh() async {
+    await ref.refresh(exampleProvider.future);
+  }
+
+  void _scrollToTop() {
+    _scrollController.animateTo(
+      0,
+      duration: const Duration(milliseconds: 500),
+      curve: Curves.easeOut,
+    );
+  }
+
+  void _navigateToDetail(dynamic item) {
+    Navigator.of(context).pushNamed(
+      '/detail',
+      arguments: item,
+    );
+  }
+
+  void _navigateToSettings() {
+    Navigator.of(context).pushNamed('/settings');
+  }
+
+  void _showAddDialog() {
+    showDialog(
+      context: context,
+      builder: (context) => AlertDialog(
+        title: const Text('Add Item'),
+        content: TextField(
+          decoration: const InputDecoration(
+            labelText: 'Title',
+            hintText: 'Enter title',
+          ),
+          onSubmitted: (value) {
+            // Handle submission
+            Navigator.of(context).pop();
+          },
+        ),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.of(context).pop(),
+            child: const Text('Cancel'),
+          ),
+          ElevatedButton(
+            onPressed: () {
+              // Handle add
+              Navigator.of(context).pop();
+            },
+            child: const Text('Add'),
+          ),
+        ],
+      ),
+    );
+  }
+}
+
+// Placeholder provider (move to separate file)
+final exampleProvider = FutureProvider<List<dynamic>>((ref) async {
+  // Simulate API call
+  await Future.delayed(const Duration(seconds: 1));
+  return [];
+});

package/.agent/skills/mobile-agent/resources/snippets.md

@@ -0,0 +1,235 @@
+# Mobile Agent - Code Snippets
+
+Copy-paste ready patterns. Use these as starting points, adapt to the specific task.
+
+---
+
+## Riverpod AsyncNotifier
+
+```dart
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+part 'todo_provider.g.dart';
+
+@riverpod
+class TodoList extends _$TodoList {
+  @override
+  Future<List<Todo>> build() async {
+    final repository = ref.watch(todoRepositoryProvider);
+    return repository.fetchAll();
+  }
+
+  Future<void> add(String title) async {
+    final repository = ref.read(todoRepositoryProvider);
+    await repository.create(title);
+    ref.invalidateSelf();
+  }
+
+  Future<void> toggle(String id) async {
+    final repository = ref.read(todoRepositoryProvider);
+    await repository.toggle(id);
+    ref.invalidateSelf();
+  }
+
+  Future<void> delete(String id) async {
+    final repository = ref.read(todoRepositoryProvider);
+    await repository.delete(id);
+    ref.invalidateSelf();
+  }
+}
+```
+
+---
+
+## Screen with AsyncValue
+
+```dart
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+class TodoListScreen extends ConsumerWidget {
+  const TodoListScreen({super.key});
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final todosAsync = ref.watch(todoListProvider);
+
+    return Scaffold(
+      appBar: AppBar(title: const Text('Todos')),
+      body: todosAsync.when(
+        loading: () => const Center(child: CircularProgressIndicator()),
+        error: (error, stack) => Center(
+          child: Column(
+            mainAxisSize: MainAxisSize.min,
+            children: [
+              Text('Error: $error'),
+              const SizedBox(height: 8),
+              ElevatedButton(
+                onPressed: () => ref.invalidate(todoListProvider),
+                child: const Text('Retry'),
+              ),
+            ],
+          ),
+        ),
+        data: (todos) => todos.isEmpty
+            ? const Center(child: Text('No todos yet'))
+            : ListView.builder(
+                itemCount: todos.length,
+                itemBuilder: (context, index) => TodoItem(todo: todos[index]),
+              ),
+      ),
+      floatingActionButton: FloatingActionButton(
+        onPressed: () => _showAddDialog(context, ref),
+        child: const Icon(Icons.add),
+      ),
+    );
+  }
+}
+```
+
+---
+
+## Repository Pattern
+
+```dart
+abstract class TodoRepository {
+  Future<List<Todo>> fetchAll();
+  Future<Todo> create(String title);
+  Future<void> toggle(String id);
+  Future<void> delete(String id);
+}
+
+class TodoRepositoryImpl implements TodoRepository {
+  final Dio _dio;
+
+  TodoRepositoryImpl(this._dio);
+
+  @override
+  Future<List<Todo>> fetchAll() async {
+    final response = await _dio.get('/api/todos');
+    return (response.data as List).map((e) => Todo.fromJson(e)).toList();
+  }
+
+  @override
+  Future<Todo> create(String title) async {
+    final response = await _dio.post('/api/todos', data: {'title': title});
+    return Todo.fromJson(response.data);
+  }
+
+  @override
+  Future<void> toggle(String id) async {
+    await _dio.patch('/api/todos/$id/toggle');
+  }
+
+  @override
+  Future<void> delete(String id) async {
+    await _dio.delete('/api/todos/$id');
+  }
+}
+```
+
+---
+
+## Dio with Auth Interceptor
+
+```dart
+class AuthInterceptor extends Interceptor {
+  final Ref _ref;
+
+  AuthInterceptor(this._ref);
+
+  @override
+  void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
+    final token = _ref.read(authProvider).accessToken;
+    if (token != null) {
+      options.headers['Authorization'] = 'Bearer $token';
+    }
+    handler.next(options);
+  }
+
+  @override
+  void onError(DioException err, ErrorInterceptorHandler handler) {
+    if (err.response?.statusCode == 401) {
+      _ref.read(authProvider.notifier).logout();
+    }
+    handler.next(err);
+  }
+}
+```
+
+---
+
+## GoRouter Config
+
+```dart
+final routerProvider = Provider<GoRouter>((ref) {
+  final auth = ref.watch(authProvider);
+
+  return GoRouter(
+    redirect: (context, state) {
+      final isLoggedIn = auth.isAuthenticated;
+      final isAuthRoute = state.matchedLocation.startsWith('/auth');
+
+      if (!isLoggedIn && !isAuthRoute) return '/auth/login';
+      if (isLoggedIn && isAuthRoute) return '/';
+      return null;
+    },
+    routes: [
+      GoRoute(path: '/', builder: (_, __) => const HomeScreen()),
+      GoRoute(path: '/auth/login', builder: (_, __) => const LoginScreen()),
+      GoRoute(path: '/todos', builder: (_, __) => const TodoListScreen()),
+    ],
+  );
+});
+```
+
+---
+
+## Entity (freezed)
+
+```dart
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+part 'todo.freezed.dart';
+part 'todo.g.dart';
+
+@freezed
+class Todo with _$Todo {
+  const factory Todo({
+    required String id,
+    required String title,
+    @Default(false) bool completed,
+    required DateTime createdAt,
+  }) = _Todo;
+
+  factory Todo.fromJson(Map<String, dynamic> json) => _$TodoFromJson(json);
+}
+```
+
+---
+
+## Widget Test
+
+```dart
+import 'package:flutter_test/flutter_test.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+void main() {
+  testWidgets('TodoListScreen shows loading then data', (tester) async {
+    await tester.pumpWidget(
+      ProviderScope(
+        overrides: [
+          todoListProvider.overrideWith(() => MockTodoList()),
+        ],
+        child: const MaterialApp(home: TodoListScreen()),
+      ),
+    );
+
+    expect(find.byType(CircularProgressIndicator), findsOneWidget);
+
+    await tester.pumpAndSettle();
+
+    expect(find.text('Test Todo'), findsOneWidget);
+  });
+}
+```

package/.agent/skills/mobile-agent/resources/tech-stack.md

@@ -0,0 +1,45 @@
+# Mobile Agent - Tech Stack Reference
+
+## Flutter (Recommended)
+- **Framework**: Flutter 3.19+
+- **Language**: Dart 3.3+
+- **State**: Riverpod 2.4+, Bloc, Provider
+- **Navigation**: GoRouter 13+
+- **API Client**: Dio
+- **Local Storage**: Drift, Hive
+- **Testing**: flutter_test, mockito
+
+## React Native (Alternative)
+- **Framework**: React Native 0.73+
+- **Language**: TypeScript
+- **State**: Redux Toolkit, Zustand
+- **Navigation**: React Navigation 6+
+- **Testing**: Jest, React Native Testing Library
+
+## Project Structure (Flutter)
+
+```
+lib/
+  main.dart
+  core/              # Theme, router, utils
+  features/
+    [feature]/
+      data/          # Models, repositories
+      domain/        # Entities, use cases
+      presentation/  # Screens, widgets, providers
+  shared/            # Shared widgets
+```
+
+## Architecture Pattern
+
+Clean Architecture with Riverpod:
+1. Entity (Domain) - Pure business objects
+2. Repository Interface (Domain) - Abstract data access
+3. Repository Implementation (Data) - Dio, database
+4. Providers (Presentation) - State management
+5. Screens/Widgets (Presentation) - UI
+
+## Platform Guidelines
+- Material Design 3 for Android
+- iOS Human Interface Guidelines for iOS
+- Use `Platform.isIOS` for platform-specific code

package/.agent/skills/orchestrator/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: orchestrator
+description: Automated multi-agent orchestrator that spawns CLI subagents in parallel, coordinates via MCP Memory, and monitors progress
+---
+
+# Orchestrator - Automated Multi-Agent Coordinator
+
+## When to use
+- Complex feature requires multiple specialized agents working in parallel
+- User wants automated execution without manually spawning agents
+- Full-stack implementation spanning backend, frontend, mobile, and QA
+- User says "자동으로 실행해줘", "병렬로 돌려줘", or similar automation requests
+
+## When NOT to use
+- Simple single-domain task -> use the specific agent directly
+- User wants step-by-step manual control -> use workflow-guide
+- Quick bug fixes or minor changes
+
+## Important
+This skill orchestrates CLI subagents via `gemini -p "..." --approval-mode=yolo`. It uses MCP Memory tools as a shared state bus. Each subagent runs as an independent process.
+
+## Configuration
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| MAX_PARALLEL | 3 | Max concurrent subagents |
+| MAX_RETRIES | 2 | Retry attempts per failed task |
+| POLL_INTERVAL | 30s | Status check interval |
+| MAX_TURNS (impl) | 20 | Turn limit for backend/frontend/mobile |
+| MAX_TURNS (review) | 15 | Turn limit for qa/debug |
+| MAX_TURNS (plan) | 10 | Turn limit for pm |
+
+## Memory Configuration
+
+Memory provider and tool names are configurable via `mcp.json`:
+```json
+{
+  "memoryConfig": {
+    "provider": "serena",
+    "basePath": ".serena/memories",
+    "tools": {
+      "read": "read_memory",
+      "write": "write_memory",
+      "edit": "edit_memory"
+    }
+  }
+}
+```
+
+## Workflow Phases
+
+**PHASE 1 - Plan**: Analyze request -> decompose tasks -> generate session ID
+**PHASE 2 - Setup**: Use memory write tool to create `orchestrator-session.md` + `task-board.md`
+**PHASE 3 - Execute**: Spawn agents by priority tier (never exceed MAX_PARALLEL)
+**PHASE 4 - Monitor**: Poll every POLL_INTERVAL; handle completed/failed/crashed agents
+**PHASE 4.5 - Verify**: Run `../_shared/verify.sh {agent-type} {workspace}` per completed agent
+**PHASE 5 - Collect**: Read all `result-{agent}.md`, compile summary, cleanup progress files
+
+See `resources/subagent-prompt-template.md` for prompt construction.
+See `resources/memory-schema.md` for memory file formats.
+
+## Memory File Ownership
+
+| File | Owner | Others |
+|------|-------|--------|
+| `orchestrator-session.md` | orchestrator | read-only |
+| `task-board.md` | orchestrator | read-only |
+| `progress-{agent}.md` | that agent | orchestrator reads |
+| `result-{agent}.md` | that agent | orchestrator reads |
+
+## Verification Gate (PHASE 4.5)
+After each agent completes, run automated verification before accepting the result:
+```bash
+bash .agent/skills/_shared/verify.sh {agent-type} {workspace}
+```
+- **PASS (exit 0)**: Accept result, advance to next task
+- **FAIL (exit 1)**: Treat as failure → enter Retry Logic with verify output as error context
+- This is mandatory. Never skip verification even if the agent reports success.
+
+## Retry Logic
+- 1st retry: Wait 30s, re-spawn with error context (include verify.sh output)
+- 2nd retry: Wait 60s, add "Try a different approach"
+- Final failure: Report to user, ask whether to continue or abort
+
+## References
+- Prompt template: `resources/subagent-prompt-template.md`
+- Memory schema: `resources/memory-schema.md`
+- Config: `config/cli-config.yaml`
+- Scripts: `scripts/spawn-agent.sh`, `scripts/parallel-run.sh`
+- Task templates: `templates/`
+- Skill routing: `../_shared/skill-routing.md`
+- Verification: `../_shared/verify.sh`
+- API contracts: `../_shared/api-contracts/`
+- Context loading: `../_shared/context-loading.md`
+- Difficulty guide: `../_shared/difficulty-guide.md`
+- Reasoning templates: `../_shared/reasoning-templates.md`
+- Clarification protocol: `../_shared/clarification-protocol.md`
+- Context budget: `../_shared/context-budget.md`
+- Lessons learned: `../_shared/lessons-learned.md`