feat: enhance agent orchestration with clarification

Author: gracefullight

.agent/rules/build-guide.md

@@ -8,6 +8,7 @@ description: when working for building, running, or deploying the project
 ## Quick Start
 
 ### Prerequisites
+
 Ensure you have `mise` installed for runtime management.
 
 ```bash
@@ -23,6 +24,7 @@ mise current
 This project uses mise monorepo mode with `//path:task` syntax.
 
 ### Root (All Apps)
+
 ```bash
 # List all available tasks
 mise tasks --all
@@ -50,6 +52,7 @@ mise gen:api
 ```
 
 ### API (apps/api)
+
 ```bash
 # Start development server
 mise //apps/api:dev
@@ -86,6 +89,7 @@ docker build -t api apps/api
 ```
 
 ### Web (apps/web)
+
 ```bash
 # Start development server
 mise //apps/web:dev
@@ -113,6 +117,7 @@ docker build -t web apps/web
 ```
 
 ### Worker (apps/worker)
+
 ```bash
 # Start worker
 mise //apps/worker:dev
@@ -131,6 +136,7 @@ docker build -t worker apps/worker
 ```
 
 ### Mobile (apps/mobile)
+
 ```bash
 # Run on device/simulator
 mise //apps/mobile:dev
@@ -155,6 +161,7 @@ mise //apps/mobile:gen:api
 ```
 
 ### Fastlane (Mobile CI/CD)
+
 ```bash
 cd apps/mobile
 
@@ -171,6 +178,7 @@ bundle exec fastlane ios testflight_deploy  # Deploy to TestFlight
 ```
 
 ### Infrastructure (apps/infra)
+
 ```bash
 # Initialize Terraform
 mise //apps/infra:init
@@ -189,6 +197,7 @@ mise //apps/infra:apply:prod
 ```
 
 ### i18n (packages/i18n)
+
 ```bash
 # Build i18n files for web and mobile
 mise //packages/i18n:build
@@ -203,38 +212,45 @@ mise //packages/i18n:build:mobile
 ## Docker Compose (Local Development)
 
 ### Start Infrastructure
+
 ```bash
 mise //apps/api:infra:up
 ```
 
 This starts:
+
 - PostgreSQL (port 5432)
 - Redis (port 6379)
 - MinIO (ports 9000, 9001)
 
 ### Stop Infrastructure
+
 ```bash
 mise //apps/api:infra:down
 ```
 
 ### Reset Infrastructure (with data)
+
 ```bash
 docker compose -f apps/api/docker-compose.infra.yml down -v
 ```
 
 ## Database Migrations
 
 ### Create Migration
+
 ```bash
 mise //apps/api:migrate:create "description of changes"
 ```
 
 ### Apply Migrations
+
 ```bash
 mise //apps/api:migrate
 ```
 
 ### Rollback Migration
+
 ```bash
 cd apps/api
 uv run alembic downgrade -1
@@ -243,20 +259,23 @@ uv run alembic downgrade -1
 ## Common Build Issues
 
 ### Python Import Errors
+
 ```bash
 # Ensure virtual environment is activated
 cd apps/api
 uv sync --frozen
 ```
 
 ### Node Module Issues
+
 ```bash
 # Clear node_modules and reinstall
-rm -rf node_modules pnpm-lock.yaml
-pnpm install
+rm -rf node_modules bun-lock.yaml
+bun install
 ```
 
 ### Flutter Build Issues
+
 ```bash
 # Clean and rebuild
 flutter clean
@@ -265,6 +284,7 @@ dart run build_runner build --delete-conflicting-outputs
 ```
 
 ### Terraform State Issues
+
 ```bash
 cd apps/infra
 

.agent/rules/lint-format-guide.md

@@ -8,6 +8,7 @@ description: when working for linting and formatting.
 ## Overview
 
 This project uses:
+
 - **Biome** for JavaScript/TypeScript (lint + format)
 - **Ruff** for Python (lint + format)
 - **dart analyze** for Dart/Flutter
@@ -16,10 +17,11 @@ This project uses:
 ## Quick Commands
 
 ### Check All
+
 ```bash
 # From root
-pnpm lint          # Biome check
-pnpm format:check  # Biome format check
+bun lint          # Biome check
+bun format:check  # Biome format check
 
 # Python (in apps/api or apps/worker)
 poe lint           # Ruff check
@@ -33,10 +35,11 @@ terraform fmt -check -recursive
 ```
 
 ### Fix All
+
 ```bash
 # From root
-pnpm lint:fix      # Biome fix
-pnpm format        # Biome format
+bun lint:fix      # Biome fix
+bun format        # Biome format
 
 # Python
 poe lint:fix       # Ruff fix
@@ -49,30 +52,35 @@ terraform fmt -recursive
 ## Biome (JavaScript/TypeScript)
 
 ### Configuration
+
 See `biome.json` at project root.
 
 ### Key Rules
+
 - Indent: 2 spaces
 - Quotes: double
 - Semicolons: required
 - Trailing commas: ES5
 - Line width: 100
 
 ### Lint Categories
+
 - **Correctness**: Errors that will cause bugs
 - **Suspicious**: Likely bugs or confusing code
 - **Style**: Code style issues
 - **Complexity**: Overly complex code
 - **Security**: Potential security issues
 
 ### Ignored Patterns
+
 - `node_modules/`
 - `.next/`
 - `dist/`
 - `coverage/`
 - Generated files (`*.gen.ts`)
 
 ### Editor Integration
+
 ```json
 // .vscode/settings.json
 {
@@ -90,15 +98,18 @@ See `biome.json` at project root.
 ## Ruff (Python)
 
 ### Configuration
+
 See `ruff.toml` in `apps/api/` and `apps/worker/`.
 
 ### Key Rules
+
 - Line length: 88
 - Target: Python 3.12
 - Indent: 4 spaces
 - Quotes: double
 
 ### Rule Sets
+
 - **E/W**: pycodestyle (errors/warnings)
 - **F**: Pyflakes
 - **I**: isort (import sorting)
@@ -110,6 +121,7 @@ See `ruff.toml` in `apps/api/` and `apps/worker/`.
 - **RUF**: Ruff-specific
 
 ### Editor Integration
+
 ```json
 // .vscode/settings.json
 {
@@ -126,19 +138,23 @@ See `ruff.toml` in `apps/api/` and `apps/worker/`.
 ## Dart/Flutter
 
 ### Configuration
+
 See `analysis_options.yaml` in `apps/mobile/`.
 
 ### Key Rules
+
 - Strict mode enabled
 - All recommended lints
 - Flutter-specific lints
 
 ### Editor Integration
+
 Dart extension automatically uses `analysis_options.yaml`.
 
 ## Terraform
 
 ### Formatting
+
 ```bash
 # Check format
 terraform fmt -check -recursive
@@ -148,6 +164,7 @@ terraform fmt -recursive
 ```
 
 ### Validation
+
 ```bash
 terraform validate
 ```
@@ -172,6 +189,7 @@ chmod +x .git/hooks/commit-msg
 ```
 
 The pre-commit task runs lint for changed apps:
+
 - `apps/api/` changes → `mise //apps/api:lint`
 - `apps/web/` changes → `mise //apps/web:lint`
 - `apps/worker/` changes → `mise //apps/worker:lint`
@@ -185,7 +203,7 @@ GitHub Actions runs linting on every PR:
 
 ```yaml
 - name: Lint JS/TS
-  run: pnpm lint
+  run: bun lint
 
 - name: Lint Python
   run: |
@@ -206,10 +224,13 @@ GitHub Actions runs linting on every PR:
 ## Troubleshooting
 
 ### Biome Conflicts with Other Formatters
+
 Disable other formatters in VS Code settings and set Biome as default.
 
 ### Ruff Import Sorting Issues
+
 Ensure `I` rule set is enabled and run `ruff check --fix --select I`.
 
 ### Dart Analysis Takes Too Long
+
 Run `flutter clean` then `flutter pub get` to regenerate analysis.