SKILL.md
Android Workflow Orchestrator
Routes Android development tasks to appropriate workflows and manages quality gates.
Self-Check Protocol (MUST DO)
Before starting implementation tasks, verify:
| # | Question | Action if No |
|---|---|---|
| 1 | Is this an implementation task? | Handle directly |
| 2 | Has the workflow been classified? | Call task-router first |
| 3 | Following the correct sequence? | Re-check workflow |
| 4 | Trying to skip an agent? | Never allowed, follow sequence |
Quick Classification
Classification Criteria
| Condition | Workflow |
|---|---|
| Files ≤2, single layer, no UI/API/DB | quick-fix |
| New feature, new screen | feature |
| Structure change, behavior preserved | refactor |
| Unknown bug cause, error analysis | investigate |
| Production emergency | hotfix |
Auto-Upgrade Rules
| Trigger | From | To |
|---|---|---|
| UI changes detected | quick-fix | feature |
| Files 3+ | quick-fix | feature |
| API/DB changes | quick-fix | feature |
| Build fails 2x | any | investigate |
Workflow Sequences
Agent execution order for each workflow:
| Workflow | Sequence |
|---|---|
| quick-fix | code-writer → code-critic |
| feature | planner → [ux-engineer] → [ui-builder] → code-writer → test-engineer → code-critic |
| refactor | planner → code-writer → test-engineer → code-critic |
| investigate | investigator → (route based on findings) |
| hotfix | code-writer → test-engineer(smoke) → code-critic |
Detailed Guides:
- quick-fix: [workflows/quick-fix.md](workflows/quick-fix.md)
- feature: [workflows/feature.md](workflows/feature.md)
- refactor: [workflows/refactor.md](workflows/refactor.md)
- investigate: [workflows/investigate.md](workflows/investigate.md)
- hotfix: [workflows/hotfix.md](workflows/hotfix.md)
Quality Gates
| Gate | Checkpoint | Criteria |
|---|---|---|
| Gate 0 | task-router | Classification complete |
| Gate 1 | planner | Requirements clear, tasks defined |
| Gate 2 | code-writer | Build succeeds |
| Gate 3 | code-critic | 0 critical, ≤2 major issues |
Detailed Criteria: [gates/quality-gates.md](gates/quality-gates.md)
MCP Tool Requirements
| Workflow | sequential-thinking | context7 | codex-cli |
|---|---|---|---|
| quick-fix | Skip | Optional | 1 round |
| feature | 3+ steps | Required | 2+ rounds |
| refactor | 3+ steps | Optional | 2+ rounds |
| investigate | 5+ steps | Optional | Optional |
| hotfix | Skip | Optional | 1 round |
Build Commands
# Full build
./gradlew build
# Module build
./gradlew :feature:home:build
# Run tests
./gradlew test
./gradlew :feature:home:testDebugUnitTest
# Clean build
./gradlew clean buildFailure Recovery
On build or gate failure:
- Record: Log error messages and environment info
- Retry: Auto-retry once
- Escalate: If still failing, present options
- A: Manual fix then retry - B: Call investigator - C: Abort task