mobile-ai-agents 1.0.32 → 1.0.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mobile-ai-agents",
3
- "version": "1.0.32",
3
+ "version": "1.0.33",
4
4
  "description": "AI agents, skills, and Loop Engineering workflows for building, testing, auditing, and releasing mobile apps.",
5
5
  "bin": {
6
6
  "mobile-ai-agents": "cli/index.js",
@@ -27,6 +27,10 @@ IMPLEMENTATION:
27
27
  <changed files, relevant source code, repo tree, or diff>
28
28
  EVIDENCE:
29
29
  <test output, build output, screenshots, Mobile MCP QA report, logs, accessibility report, security report>
30
+ RESKIN_PLAN:
31
+ <optional /mobile-app-design plan with REDESIGN, RESTYLE, and LEAVE screen inventory rows>
32
+ RESKIN_QA:
33
+ <optional /mobile-mcp-qa Reskin QA report, before/after screenshots, state coverage, and theme evidence>
30
34
  KNOWN_LIMITATIONS:
31
35
  <optional explicit constraints, skipped checks, unavailable device, unavailable backend>
32
36
  ```
@@ -45,11 +49,13 @@ Read these inputs in order:
45
49
  1. PRD.md or product requirements
46
50
  2. TASKS.md acceptance criteria
47
51
  3. DESIGN.md or design plan
48
- 4. DEPENDENCIES.md and ROADMAP.md when provided
49
- 5. MOBILE_MEMORY.md or project context when provided
50
- 6. Relevant source code, diff, and file tree
51
- 7. Test/build output
52
- 8. Screenshots, videos, accessibility reports, security reports, or Mobile MCP QA reports
52
+ 4. /mobile-app-design reskin plan and screen inventory when provided
53
+ 5. DEPENDENCIES.md and ROADMAP.md when provided
54
+ 6. MOBILE_MEMORY.md or project context when provided
55
+ 7. Relevant source code, diff, and file tree
56
+ 8. Test/build output
57
+ 9. Screenshots, videos, accessibility reports, security reports, or Mobile MCP QA reports
58
+ 10. /mobile-mcp-qa Reskin QA report when provided
53
59
 
54
60
  Verification rules:
55
61
 
@@ -61,6 +67,10 @@ Verification rules:
61
67
  - Separate confirmed gaps from assumptions.
62
68
  - Do not expand scope beyond the approved PRD unless it creates release risk.
63
69
  - Do not mark release-ready if critical requirements, security blockers, crash risks, or required tests are missing.
70
+ - For mobile reskins, compile/build/test success is not UI proof by itself.
71
+ - For mobile reskins, every required screen inventory row needs screenshot, video, or Mobile MCP evidence.
72
+ - Mark missing required reskin evidence as UNVERIFIED, or PARTIAL only when some states/themes are proven.
73
+ - Reject shallow rethemes: a REDESIGN screen fails when it only inherits token, color, font, spacing, or theme changes.
64
74
 
65
75
  Check these areas:
66
76
 
@@ -81,17 +91,28 @@ Check these areas:
81
91
  - Layout, hierarchy, content, states, responsiveness, and accessibility evidence.
82
92
  - Screenshot or Mobile MCP evidence when available.
83
93
 
84
- 4. TEST AND DEVICE EVIDENCE
94
+ 4. MOBILE RESKIN VERIFICATION
95
+ Use this section when RESKIN_PLAN is provided or the scope mentions /mobile-app-design, reskin, redesign, tab reorder, navigation rename, visual refresh, or restyle.
96
+ - Read every screen inventory row and preserve its decision: REDESIGN, RESTYLE, or LEAVE.
97
+ - REDESIGN must show structural change: layout, hierarchy, grouping, density, information architecture, state layout, tab order, or interaction model.
98
+ - RESTYLE must include justification and must not be counted as structurally redesigned.
99
+ - LEAVE must be intentionally out of scope and should not be reported as a missed redesign unless the PRD required it.
100
+ - Compare before/after screenshots or Mobile MCP evidence for each required screen, state, orientation, and light/dark theme listed in the plan.
101
+ - If navigation changed, verify routes, deep links, selected tab state, back behavior, accessibility labels, tests, snapshots, and docs.
102
+ - If tabs or screens were renamed, verify user-facing copy changed consistently in UI, tests, screenshots, and docs.
103
+ - Use per-screen status values: PASS, FAIL, PARTIAL, or UNVERIFIED.
104
+
105
+ 5. TEST AND DEVICE EVIDENCE
85
106
  - Unit, integration, UI, golden/snapshot, E2E, and manual QA evidence.
86
107
  - Build/install/launch proof.
87
108
  - Device, emulator, simulator, or Mobile MCP proof when available.
88
109
 
89
- 5. SECURITY AND RELEASE BLOCKERS
110
+ 6. SECURITY AND RELEASE BLOCKERS
90
111
  - Security audit findings that affect release.
91
112
  - Sensitive data, auth, storage, network, permissions, deep links, WebViews, logging, and payment/subscription behavior when relevant.
92
113
  - Performance blockers that affect launch readiness.
93
114
 
94
- 6. CONTEXT CONTINUITY
115
+ 7. CONTEXT CONTINUITY
95
116
  - MOBILE_MEMORY.md or project context reflects the current state.
96
117
  - Remaining gaps and next action are captured for future sessions.
97
118
 
@@ -127,6 +148,10 @@ UI Match:
127
148
  | Screen/State | Source | Status | Evidence |
128
149
  |---|---|---|---|
129
150
 
151
+ Mobile Reskin Verification:
152
+ | Screen/State | Decision | Evidence | Status | Reason |
153
+ |---|---|---|---|---|
154
+
130
155
  Test And Device Evidence:
131
156
  | Check | Status | Evidence |
132
157
  |---|---|---|
@@ -157,7 +182,7 @@ Test Gaps:
157
182
  - <gap or "None">
158
183
 
159
184
  Release Readiness:
160
- PASS only if all required PRD items and acceptance criteria are PASS, no critical UI/security/test gaps remain, and unknowns are documented or risk-accepted.
185
+ PASS only if all required PRD items and acceptance criteria are PASS, no critical UI/security/test gaps remain, required reskin evidence is PASS or risk-accepted, and unknowns are documented or risk-accepted.
161
186
 
162
187
  Next Action:
163
188
  1. <single highest priority action>
@@ -299,6 +324,54 @@ Next Action:
299
324
 
300
325
  ---
301
326
 
327
+ ## Mobile Reskin Example
328
+
329
+ Use this guidance when `/mobile-app-design` produced a reskin plan and `/mobile-mcp-qa` produced device evidence.
330
+
331
+ ```text
332
+ RESKIN_PLAN:
333
+ - Home: REDESIGN. Replace feed cards with grouped Today, Progress, and Next Action sections.
334
+ - Profile: RESTYLE. Keep structure, update typography and spacing only.
335
+ - Billing: LEAVE. Out of scope for this release.
336
+
337
+ RESKIN_QA:
338
+ - Mobile MCP Reskin QA has before/after screenshots for Home light and dark.
339
+ - Profile screenshot exists only for light theme.
340
+ - No Billing screenshot because it is marked LEAVE.
341
+ ```
342
+
343
+ Expected verification behavior:
344
+
345
+ ```text
346
+ Mobile Reskin Verification:
347
+ | Screen/State | Decision | Evidence | Status | Reason |
348
+ |---|---|---|---|---|
349
+ | Home light/dark | REDESIGN | MCP screenshots | PASS | Structure changed |
350
+ | Profile light | RESTYLE | Screenshot | PARTIAL | Dark missing |
351
+ | Billing | LEAVE | Plan row | PASS | Out of scope |
352
+
353
+ Verification Details:
354
+ ### UI-001 — Home redesign is proven
355
+ - Source: /mobile-app-design RESKIN_PLAN.
356
+ - Evidence: /mobile-mcp-qa before/after screenshots show new grouped sections.
357
+ - Status: PASS.
358
+ - Confirmed gap: None.
359
+ - Assumption: None.
360
+ - Required fix: None.
361
+
362
+ ### UI-002 — Profile restyle has incomplete evidence
363
+ - Source: /mobile-app-design RESKIN_PLAN.
364
+ - Evidence: Only light theme screenshot was provided.
365
+ - Status: PARTIAL.
366
+ - Confirmed gap: Dark theme evidence is missing.
367
+ - Assumption: Profile was intentionally restyled, not redesigned.
368
+ - Required fix: Capture Profile dark theme screenshot or risk-accept the gap.
369
+ ```
370
+
371
+ If Home only changed colors, fonts, or tokens, mark it FAIL because a REDESIGN requires structural proof.
372
+
373
+ ---
374
+
302
375
  ## Composition Example
303
376
 
304
377
  ```text