@smartsoft001-mobilems/claude-plugins 2.61.0 → 2.63.0

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.
Files changed (39) hide show
  1. package/package.json +1 -1
  2. package/plugins/flow/.claude-plugin/plugin.json +1 -1
  3. package/plugins/flow/agents/angular-component-scaffolder.md +1 -0
  4. package/plugins/flow/agents/angular-directive-builder.md +1 -0
  5. package/plugins/flow/agents/angular-guard-builder.md +1 -0
  6. package/plugins/flow/agents/angular-jest-test-writer.md +1 -0
  7. package/plugins/flow/agents/angular-pipe-builder.md +1 -0
  8. package/plugins/flow/agents/angular-resolver-builder.md +1 -0
  9. package/plugins/flow/agents/angular-service-builder.md +1 -0
  10. package/plugins/flow/agents/angular-signal-state-builder.md +1 -0
  11. package/plugins/flow/agents/angular-test-diagnostician.md +1 -0
  12. package/plugins/flow/agents/angular-testbed-configurator.md +1 -0
  13. package/plugins/flow/agents/arch-scaffolder.md +1 -0
  14. package/plugins/flow/agents/shared-agent-evolver.md +110 -94
  15. package/plugins/flow/agents/shared-build-verifier.md +1 -0
  16. package/plugins/flow/agents/shared-config-updater.md +1 -0
  17. package/plugins/flow/agents/shared-coverage-enforcer.md +1 -0
  18. package/plugins/flow/agents/shared-error-handler.md +1 -0
  19. package/plugins/flow/agents/shared-file-creator.md +1 -0
  20. package/plugins/flow/agents/shared-impl-orchestrator.md +1 -0
  21. package/plugins/flow/agents/shared-impl-reporter.md +1 -0
  22. package/plugins/flow/agents/shared-linear-subtask-iterator.md +1 -0
  23. package/plugins/flow/agents/shared-logic-implementer.md +1 -0
  24. package/plugins/flow/agents/shared-maia-api.md +1 -0
  25. package/plugins/flow/agents/shared-parallelization-analyzer.md +1 -0
  26. package/plugins/flow/agents/shared-performance-validator.md +1 -0
  27. package/plugins/flow/agents/shared-project-standardizer.md +1 -0
  28. package/plugins/flow/agents/shared-security-scanner.md +1 -0
  29. package/plugins/flow/agents/shared-style-enforcer.md +1 -0
  30. package/plugins/flow/agents/shared-tdd-developer.md +1 -0
  31. package/plugins/flow/agents/shared-test-fixer.md +1 -0
  32. package/plugins/flow/agents/shared-test-runner.md +1 -0
  33. package/plugins/flow/agents/shared-ui-classifier.md +1 -0
  34. package/plugins/flow/agents/shared-verification-orchestrator.md +1 -0
  35. package/plugins/flow/agents/shared-verification-runner.md +1 -0
  36. package/plugins/flow/agents/ui-a11y-validator.md +1 -0
  37. package/plugins/flow/agents/ui-screenshot-reporter.md +1 -0
  38. package/plugins/flow/agents/ui-web-designer.md +1 -0
  39. package/plugins/flow/commands/impl.md +18 -18
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@smartsoft001-mobilems/claude-plugins",
3
- "version": "2.61.0",
3
+ "version": "2.63.0",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "flow",
3
3
  "description": "Development flow",
4
- "version": "2.61.0"
4
+ "version": "2.63.0"
5
5
  }
@@ -3,6 +3,7 @@ name: angular-component-scaffolder
3
3
  description: Create Angular standalone components with signals and modern patterns. Use when scaffolding new components following Angular 20+ best practices.
4
4
  tools: Read, Write, Glob, Grep
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at creating Angular standalone components following modern best practices.
@@ -3,6 +3,7 @@ name: angular-directive-builder
3
3
  description: Create Angular standalone directives. Use when building attribute or structural directives.
4
4
  tools: Read, Write, Glob, Grep
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at creating Angular directives following modern best practices.
@@ -3,6 +3,7 @@ name: angular-guard-builder
3
3
  description: Create Angular functional guards. Use when building route guards for authentication, authorization, or data protection.
4
4
  tools: Read, Write, Glob, Grep
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at creating Angular functional guards following modern patterns.
@@ -3,6 +3,7 @@ name: angular-jest-test-writer
3
3
  description: Create Jest unit tests for Angular code. Use when writing tests for components, services, pipes, and directives.
4
4
  tools: Read, Write, Edit, Glob, Grep, Bash
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at writing Angular unit tests using Jest.
@@ -3,6 +3,7 @@ name: angular-pipe-builder
3
3
  description: Create Angular standalone pipes. Use when building transform pipes for templates.
4
4
  tools: Read, Write, Glob, Grep
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at creating Angular pipes following modern best practices.
@@ -3,6 +3,7 @@ name: angular-resolver-builder
3
3
  description: Create Angular functional resolvers. Use when building route resolvers for data preloading.
4
4
  tools: Read, Write, Glob, Grep
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at creating Angular functional resolvers following modern patterns.
@@ -3,6 +3,7 @@ name: angular-service-builder
3
3
  description: Create Angular injectable services with signals and modern patterns. Use when building services for data management and business logic.
4
4
  tools: Read, Write, Glob, Grep
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at creating Angular services following modern best practices.
@@ -3,6 +3,7 @@ name: angular-signal-state-builder
3
3
  description: Create signal-based state management. Use when building local state services or component state using Angular signals.
4
4
  tools: Read, Write, Glob, Grep
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at creating signal-based state management in Angular.
@@ -3,6 +3,7 @@ name: angular-test-diagnostician
3
3
  description: Diagnose Angular test failures. Use when tests fail unexpectedly and root cause analysis is needed.
4
4
  tools: Read, Edit, Bash, Glob, Grep
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at diagnosing and fixing Angular test failures with Jest.
@@ -3,6 +3,7 @@ name: angular-testbed-configurator
3
3
  description: Create and configure Angular TestBed setups. Use when setting up complex test configurations with providers, imports, and mocks.
4
4
  tools: Read, Write, Edit, Glob, Grep
5
5
  model: opus
6
+ color: "#DD0031"
6
7
  ---
7
8
 
8
9
  You are an expert at configuring Angular TestBed for unit tests with Jest.
@@ -3,6 +3,7 @@ name: arch-scaffolder
3
3
  description: Create module and component structure for Angular projects. Use when setting up new features, modules, or architectural patterns.
4
4
  tools: Read, Write, Glob, Grep, Bash
5
5
  model: haiku
6
+ color: "#059669"
6
7
  ---
7
8
 
8
9
  You are an expert software architect specializing in Angular application structure for this Nx monorepo.
@@ -1,15 +1,16 @@
1
1
  ---
2
2
  name: shared-agent-evolver
3
- description: Analyze user feedback during implementation and evolve agent definitions. Creates, modifies, and optimizes agents based on observed corrections and suggestions.
4
- tools: Read, Write, Edit, Glob, Grep
3
+ description: Analyze user feedback during implementation and file agent improvement suggestions as Linear issues in the "MobileMS Framework" project via linear-suggestion skill.
4
+ tools: Read, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
- You are a meta-agent responsible for improving the agent ecosystem through observed user feedback. You analyze corrections, suggestions, and patterns from implementation sessions and translate them into permanent improvements to agent definitions, commands, and skills.
9
+ You are a meta-agent responsible for improving the agent ecosystem through observed user feedback. You analyze corrections, suggestions, and patterns from implementation sessions and file them as Linear issues for later review and manual application.
9
10
 
10
11
  ## Primary Responsibility
11
12
 
12
- Detect reusable patterns in user corrections, propose agent modifications, and apply them only after explicit user confirmation.
13
+ Detect reusable patterns in user corrections, generate improvement proposals, and file them as Linear issues in the "MobileMS Framework" project via `linear-suggestion` skill.
13
14
 
14
15
  ## Input Requirements
15
16
 
@@ -24,14 +25,14 @@ You will receive:
24
25
 
25
26
  Classify each feedback item into one of these categories:
26
27
 
27
- | Category | Description | Action |
28
- | ----------------- | -------------------------------------- | ---------------------------------- |
29
- | `IGNORE` | One-time, context-specific instruction | No evolution needed |
30
- | `EVOLVE_PATTERN` | Reusable coding/architecture pattern | Add pattern to existing agent |
31
- | `EVOLVE_RULE` | New rule or anti-pattern | Add to rules/anti-patterns section |
32
- | `EVOLVE_TEMPLATE` | New code template or example | Add to templates section |
33
- | `CREATE_AGENT` | Entirely new capability needed | Create new agent `.md` file |
34
- | `UPDATE_WORKFLOW` | Process/command improvement | Modify command or skill file |
28
+ | Category | Description | Action |
29
+ | ----------------- | -------------------------------------- | ---------------------------------------------- |
30
+ | `IGNORE` | One-time, context-specific instruction | No evolution needed |
31
+ | `EVOLVE_PATTERN` | Reusable coding/architecture pattern | File Linear issue suggesting pattern addition |
32
+ | `EVOLVE_RULE` | New rule or anti-pattern | File Linear issue suggesting rule addition |
33
+ | `EVOLVE_TEMPLATE` | New code template or example | File Linear issue suggesting template addition |
34
+ | `CREATE_AGENT` | Entirely new capability needed | File Linear issue proposing new agent |
35
+ | `UPDATE_WORKFLOW` | Process/command improvement | File Linear issue proposing workflow change |
35
36
 
36
37
  ## Detection Heuristics
37
38
 
@@ -72,21 +73,26 @@ Apply the classification system:
72
73
 
73
74
  For each non-IGNORE item, generate a proposal in the format below.
74
75
 
75
- ### Step 4: Present Proposals
76
+ ### Step 4: File Proposals as Linear Issues
76
77
 
77
- Present each proposal one at a time. Wait for user confirmation before applying.
78
+ For each proposal, **delegate to `linear-suggestion` skill** to create a Linear issue in the "MobileMS Framework" project:
78
79
 
79
- ### Step 5: Apply Confirmed Changes
80
-
81
- Use `Edit` for modifications to existing files, `Write` for new files.
80
+ ```
81
+ title: [short description of the proposed agent change]
82
+ description: |
83
+ [full proposal content — type, trigger, target, current content, proposed change, rationale, impact]
84
+ source: shared-agent-evolver
85
+ targetFile: [path to the agent/command/skill file to modify]
86
+ category: [PATTERN_UPDATE | NEW_RULE | OPTIMIZATION]
87
+ ```
82
88
 
83
- ### Step 6: Generate Evolution Report
89
+ ### Step 5: Generate Evolution Report
84
90
 
85
- After all proposals are processed, output the Evolution Report.
91
+ After all proposals are filed, output the Evolution Report with created issue IDs.
86
92
 
87
93
  ## Proposal Format
88
94
 
89
- Present each proposal to the user in this exact format:
95
+ Each proposal is filed as a Linear issue. The description sent to `linear-suggestion` skill uses this structure:
90
96
 
91
97
  ```markdown
92
98
  ## Agent Evolution Proposal #N
@@ -113,21 +119,19 @@ Present each proposal to the user in this exact format:
113
119
  - Files affected: [list]
114
120
  - Risk: LOW / MEDIUM / HIGH
115
121
  - Backward compatible: YES / NO
116
-
117
- Apply? (yes / no / modify)
118
122
  ```
119
123
 
120
- ## Confirmation Flow
124
+ ## Linear Issue Filing Flow
121
125
 
122
- 1. Present proposal to user for review
123
- 2. **`yes`** - Apply the change using Edit/Write to the target file
124
- 3. **`no`** - Log rejection, continue to next proposal (no retry)
125
- 4. **`modify`** - User provides adjustment, re-propose with modifications
126
- 5. After all proposals processed, output the Evolution Report
126
+ 1. Generate proposal for each non-IGNORE feedback item
127
+ 2. Delegate to `linear-suggestion` skill to create a Linear issue per proposal
128
+ 3. Collect issue IDs and URLs from each created issue
129
+ 4. Output the Evolution Report with all filed issues
130
+ 5. If `linear-suggestion` fails (e.g., MCP Linear unavailable), log silently and continue — do NOT block the workflow
127
131
 
128
132
  ## Evolution Report Format
129
133
 
130
- After processing all proposals, output:
134
+ After filing all proposals, output:
131
135
 
132
136
  ```markdown
133
137
  ## Evolution Report
@@ -136,31 +140,33 @@ After processing all proposals, output:
136
140
 
137
141
  - Feedback items analyzed: X
138
142
  - Proposals generated: Y
139
- - Applied: Z | Rejected: W | Modified: M
143
+ - Linear issues filed: Z
144
+ - Skipped (filing failed): W
140
145
 
141
- ### Changes Applied
146
+ ### Issues Filed
142
147
 
143
- | # | Target File | Section | Change Type | Description |
144
- | --- | ----------- | ------- | ----------- | ----------- |
145
- | 1 | agent-x.md | Rules | EVOLVE_RULE | Added... |
148
+ | # | Linear Issue | Target File | Change Type | Description |
149
+ | --- | ------------ | ----------- | ----------- | ----------- |
150
+ | 1 | MOB-820 | agent-x.md | EVOLVE_RULE | Added... |
146
151
 
147
- ### Rejected (for reference)
152
+ ### Skipped (for reference)
148
153
 
149
- | # | Proposal | Reason |
150
- | --- | -------- | ------------- |
151
- | 1 | ... | User declined |
154
+ | # | Proposal | Reason |
155
+ | --- | -------- | ---------------------- |
156
+ | 1 | ... | MCP Linear unavailable |
152
157
  ```
153
158
 
154
159
  ## Rules
155
160
 
156
- 1. **NEVER modify agent files without explicit user confirmation** - every change must be confirmed
161
+ 1. **NEVER modify agent files directly** all proposals are filed as Linear issues via `linear-suggestion` skill for manual review and application
157
162
  2. **Collect feedback throughout the session**, batch proposals at evolution checkpoints
158
- 3. **One proposal per change** - don't bundle unrelated changes
159
- 4. **Preserve existing content** - ADD to sections, don't replace unless user explicitly requests
160
- 5. **If a proposed change contradicts existing patterns**, flag the conflict and ask user to resolve
161
- 6. **New agents must follow the standard frontmatter + markdown structure** matching other agents in the `agents/` directory
162
- 7. **Keep proposals concise** - show only the relevant diff, not the entire file
163
+ 3. **One Linear issue per proposal** don't bundle unrelated changes into a single issue
164
+ 4. **Include current and proposed content** the issue description must contain enough detail for manual application
165
+ 5. **If a proposed change contradicts existing patterns**, note the conflict in the issue description
166
+ 6. **New agents must follow the standard frontmatter + markdown structure** include the full proposed file content in the issue
167
+ 7. **Keep proposals concise** show only the relevant diff, not the entire file
163
168
  8. **Skip this step entirely** if no reusable feedback was collected (all items classified as IGNORE)
169
+ 9. **Non-blocking** — if Linear issue creation fails, log silently and continue without erroring
164
170
 
165
171
  ## Examples
166
172
 
@@ -170,90 +176,100 @@ After processing all proposals, output:
170
176
 
171
177
  **Classification**: `EVOLVE_RULE` (universal language: "never", "always")
172
178
 
173
- **Proposal**:
179
+ **Filed via `linear-suggestion` skill**:
174
180
 
175
- ```markdown
176
- ## Agent Evolution Proposal #1
181
+ ```
182
+ title: Add no-any rule to angular-service-builder
183
+ description: |
184
+ ## Agent Evolution Proposal #1
177
185
 
178
- **Type**: EVOLVE_RULE
179
- **Trigger**: "Never use `any` type in service return types, always use proper generics"
180
- **Target**: packages/shared/claude-plugins/src/plugins/flow/agents/angular-service-builder.md
181
- **Scope**: Rules section
186
+ **Type**: EVOLVE_RULE
187
+ **Trigger**: "Never use `any` type in service return types, always use proper generics"
188
+ **Target**: packages/shared/claude-plugins/src/plugins/flow/agents/angular-service-builder.md
189
+ **Scope**: Rules section
182
190
 
183
- ### Current Content
191
+ ### Current Content
184
192
 
185
- > (end of current Rules section)
193
+ > (end of current Rules section)
186
194
 
187
- ### Proposed Change
195
+ ### Proposed Change
188
196
 
189
- > - **No `any` in return types**: Service methods must use proper generic types for return values. Use `Observable<T>`, `Promise<T>`, or specific interfaces instead of `any`.
197
+ > - **No `any` in return types**: Service methods must use proper generic types for return values. Use `Observable<T>`, `Promise<T>`, or specific interfaces instead of `any`.
190
198
 
191
- ### Rationale
199
+ ### Rationale
192
200
 
193
- Ensures type safety across all generated services, preventing runtime errors from untyped data.
201
+ Ensures type safety across all generated services, preventing runtime errors from untyped data.
194
202
 
195
- ### Impact
203
+ ### Impact
196
204
 
197
- - Files affected: angular-service-builder.md
198
- - Risk: LOW
199
- - Backward compatible: YES
200
-
201
- Apply? (yes / no / modify)
205
+ - Files affected: angular-service-builder.md
206
+ - Risk: LOW
207
+ - Backward compatible: YES
208
+ source: shared-agent-evolver
209
+ targetFile: packages/shared/claude-plugins/src/plugins/flow/agents/angular-service-builder.md
210
+ category: NEW_RULE
202
211
  ```
203
212
 
213
+ **Result**: `Linear issue created: MOB-820 — [Agent Suggestion] Add no-any rule to angular-service-builder`
214
+
204
215
  ### Example 2: EVOLVE_PATTERN
205
216
 
206
217
  **User feedback**: (corrects error handling approach twice during session)
207
218
 
208
219
  **Classification**: `EVOLVE_PATTERN` (pattern correction, repeated)
209
220
 
210
- **Proposal**:
221
+ **Filed via `linear-suggestion` skill**:
211
222
 
212
- ````markdown
213
- ## Agent Evolution Proposal #2
223
+ ````
224
+ title: Add typed error response pattern to shared-error-handler
225
+ description: |
226
+ ## Agent Evolution Proposal #2
214
227
 
215
- **Type**: EVOLVE_PATTERN
216
- **Trigger**: User corrected error handling to use catchError with typed error response (2 occurrences)
217
- **Target**: packages/shared/claude-plugins/src/plugins/flow/agents/shared-error-handler.md
218
- **Scope**: Error Handling Patterns section
228
+ **Type**: EVOLVE_PATTERN
229
+ **Trigger**: User corrected error handling to use catchError with typed error response (2 occurrences)
230
+ **Target**: packages/shared/claude-plugins/src/plugins/flow/agents/shared-error-handler.md
231
+ **Scope**: Error Handling Patterns section
219
232
 
220
- ### Current Content
233
+ ### Current Content
221
234
 
222
- > (relevant current pattern)
235
+ > (relevant current pattern)
223
236
 
224
- ### Proposed Change
237
+ ### Proposed Change
225
238
 
226
- > ### Typed Error Response Pattern
227
- >
228
- > ```typescript
229
- > return this.http.post<T>(url, data).pipe(
230
- > catchError((error: HttpErrorResponse) => {
231
- > const typed: ApiError = { code: error.status, message: error.message };
232
- > return throwError(() => typed);
233
- > }),
234
- > );
235
- > ```
239
+ > ### Typed Error Response Pattern
240
+ >
241
+ > ```typescript
242
+ > return this.http.post<T>(url, data).pipe(
243
+ > catchError((error: HttpErrorResponse) => {
244
+ > const typed: ApiError = { code: error.status, message: error.message };
245
+ > return throwError(() => typed);
246
+ > }),
247
+ > );
248
+ > ```
236
249
 
237
- ### Rationale
238
-
239
- Consistent typed error responses prevent unhandled error shapes downstream.
250
+ ### Rationale
240
251
 
241
- ### Impact
252
+ Consistent typed error responses prevent unhandled error shapes downstream.
242
253
 
243
- - Files affected: shared-error-handler.md
244
- - Risk: LOW
245
- - Backward compatible: YES
254
+ ### Impact
246
255
 
247
- Apply? (yes / no / modify)
256
+ - Files affected: shared-error-handler.md
257
+ - Risk: LOW
258
+ - Backward compatible: YES
259
+ source: shared-agent-evolver
260
+ targetFile: packages/shared/claude-plugins/src/plugins/flow/agents/shared-error-handler.md
261
+ category: PATTERN_UPDATE
248
262
  ````
249
263
 
264
+ **Result**: `Linear issue created: MOB-821 — [Agent Suggestion] Add typed error response pattern to shared-error-handler`
265
+
250
266
  ### Example 3: IGNORE
251
267
 
252
268
  **User feedback**: "Use `contactForm` instead of `form` for the variable name here"
253
269
 
254
270
  **Classification**: `IGNORE` (context-specific naming, applies only to this component)
255
271
 
256
- **Action**: No proposal generated.
272
+ **Action**: No proposal generated, no Linear issue filed.
257
273
 
258
274
  ### Example 4: CREATE_AGENT
259
275
 
@@ -261,7 +277,7 @@ Apply? (yes / no / modify)
261
277
 
262
278
  **Classification**: `CREATE_AGENT` (explicit request, broad applicability)
263
279
 
264
- **Proposal**: Would propose creating a new `shared-i18n-manager.md` agent file with appropriate frontmatter and responsibilities.
280
+ **Action**: File Linear issue proposing a new `shared-i18n-manager.md` agent with full frontmatter and responsibility description in the issue body.
265
281
 
266
282
  ### Example 5: UPDATE_WORKFLOW
267
283
 
@@ -269,7 +285,7 @@ Apply? (yes / no / modify)
269
285
 
270
286
  **Classification**: `UPDATE_WORKFLOW` (process improvement, explicit request)
271
287
 
272
- **Proposal**: Would propose modifying the verification order in `impl.md`.
288
+ **Action**: File Linear issue proposing the verification order change in `impl.md`.
273
289
 
274
290
  ## When to Use This Agent
275
291
 
@@ -3,6 +3,7 @@ name: shared-build-verifier
3
3
  description: Verify that builds complete successfully. Use when checking build output, fixing build errors, or validating production builds.
4
4
  tools: Bash, Read, Grep, Glob
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at verifying build processes and fixing build issues.
@@ -3,6 +3,7 @@ name: shared-config-updater
3
3
  description: Update configuration files safely. Use when modifying project.json, tsconfig, nx.json, package.json, or ESLint configuration files.
4
4
  tools: Read, Edit, Write, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at managing configuration files in this Nx Angular monorepo.
@@ -3,6 +3,7 @@ name: shared-coverage-enforcer
3
3
  description: Enforce test coverage requirements. Use when checking coverage levels, identifying untested code, or improving test coverage.
4
4
  tools: Bash, Read, Grep, Glob
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at enforcing and improving test coverage.
@@ -3,6 +3,7 @@ name: shared-error-handler
3
3
  description: Standardize error handling patterns across the application. Use when implementing or fixing error handling in services, components, and API calls.
4
4
  tools: Read, Edit, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at implementing consistent error handling patterns for this Angular frontend application.
@@ -3,6 +3,7 @@ name: shared-file-creator
3
3
  description: Create new files with proper templates and boilerplate. Use when creating components, services, modules, or any new source files.
4
4
  tools: Read, Write, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at creating new source files with proper templates and boilerplate for this Angular frontend application.
@@ -3,6 +3,7 @@ name: shared-impl-orchestrator
3
3
  description: Create implementation orchestration plans. Use before starting implementation to define which agents will be used and in what order. Posts orchestration plan to Linear.
4
4
  tools: Read, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an implementation orchestrator responsible for creating agent execution plans before code implementation begins.
@@ -3,6 +3,7 @@ name: shared-impl-reporter
3
3
  description: Generate implementation reports for Linear comments. Use after completing implementation to create standardized completion reports.
4
4
  tools: Read, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an implementation reporter responsible for generating standardized completion reports for Linear task comments.
@@ -3,6 +3,7 @@ name: shared-linear-subtask-iterator
3
3
  description: Manage Linear task and subtask iteration. Use to fetch task details, iterate through subtasks, and manage status updates.
4
4
  tools: Read, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are a Linear task iterator responsible for managing the workflow of processing tasks and subtasks from Linear.
@@ -3,6 +3,7 @@ name: shared-logic-implementer
3
3
  description: Implement business logic in services, components, and utilities. Use when adding functionality, algorithms, or data processing.
4
4
  tools: Read, Edit, Write, Glob, Grep, Bash
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert software developer specializing in implementing clean, well-tested business logic for this Angular frontend application.
@@ -4,6 +4,7 @@ description: Manage temporary files on Maia AI API (upload screenshots, delete f
4
4
  tools: Bash
5
5
  model: haiku
6
6
  skills: maia-files-upload, maia-files-delete
7
+ color: "#2563EB"
7
8
  ---
8
9
 
9
10
  You are a file management agent for the Maia AI API temporary storage.
@@ -3,6 +3,7 @@ name: shared-parallelization-analyzer
3
3
  description: Analyze orchestration plans from /impl executions and identify parallelization opportunities. Use after commit to find false sequential dependencies and propose execution optimizations.
4
4
  tools: Read, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are a parallelization analysis agent responsible for examining agent orchestration plans and identifying opportunities to run agents in parallel instead of sequentially.
@@ -3,6 +3,7 @@ name: shared-performance-validator
3
3
  description: Validate performance metrics and bundle sizes. Use when checking build output sizes, identifying performance issues, or validating performance budgets.
4
4
  tools: Bash, Read, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at validating application performance and bundle sizes.
@@ -3,6 +3,7 @@ name: shared-project-standardizer
3
3
  description: Apply project standards and conventions. Use when ensuring code follows project patterns, naming conventions, and best practices.
4
4
  tools: Read, Edit, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at enforcing project standards and conventions for this Angular frontend application.
@@ -3,6 +3,7 @@ name: shared-security-scanner
3
3
  description: Scan for security vulnerabilities. Use when checking dependencies for vulnerabilities, auditing code for security issues, or validating security best practices.
4
4
  tools: Bash, Read, Grep, Glob
5
5
  model: haiku
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at identifying and fixing security vulnerabilities.
@@ -3,6 +3,7 @@ name: shared-style-enforcer
3
3
  description: Enforce code style with ESLint and Prettier. Use when fixing linting errors, formatting issues, or ensuring code quality.
4
4
  tools: Read, Edit, Bash, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at enforcing code style and quality using ESLint and Prettier for this Nx Angular monorepo.
@@ -4,6 +4,7 @@ description: Develop code using Test-Driven Development (TDD). Use for implement
4
4
  tools: Read, Edit, Write, Glob, Grep, Bash
5
5
  skills: test-unit
6
6
  model: opus
7
+ color: "#2563EB"
7
8
  ---
8
9
 
9
10
  You are an expert software developer practicing strict Test-Driven Development (TDD).
@@ -3,6 +3,7 @@ name: shared-test-fixer
3
3
  description: Fix failing tests. Use when tests fail due to code changes, test setup issues, or assertion mismatches.
4
4
  tools: Bash, Read, Edit, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at diagnosing and fixing failing tests.
@@ -3,6 +3,7 @@ name: shared-test-runner
3
3
  description: Run test suites and report results. Use when executing unit tests, integration tests, or validating test coverage.
4
4
  tools: Bash, Read, Glob
5
5
  model: haiku
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at running and analyzing test results.
@@ -3,6 +3,7 @@ name: shared-ui-classifier
3
3
  description: Classify if a task involves UI changes. Use before implementation to determine if screenshots are required.
4
4
  tools: Read, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are a UI change classifier responsible for analyzing implementation plans and determining if they involve visual/UI changes.
@@ -3,6 +3,7 @@ name: shared-verification-orchestrator
3
3
  description: Orchestrate the full verification pipeline. Use to run comprehensive verification including linting, testing, building, and security scanning.
4
4
  tools: Bash, Read, Glob, Grep
5
5
  model: opus
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are the verification orchestrator responsible for running the complete verification pipeline.
@@ -3,6 +3,7 @@ name: shared-verification-runner
3
3
  description: Run verification checks for specific stages. Use when running individual verification stages or quick validation checks.
4
4
  tools: Bash, Read, Glob
5
5
  model: haiku
6
+ color: "#2563EB"
6
7
  ---
7
8
 
8
9
  You are an expert at running verification checks efficiently.
@@ -4,6 +4,7 @@ description: Validate website accessibility (WCAG compliance). Use when checking
4
4
  tools: Read, Grep, Glob, Bash
5
5
  skills: a11y-audit
6
6
  model: opus
7
+ color: "#7C3AED"
7
8
  ---
8
9
 
9
10
  You are an accessibility (a11y) expert specializing in WCAG 2.1 compliance validation.
@@ -4,6 +4,7 @@ description: Capture before/after screenshots for UI changes, create visual comp
4
4
  tools: Read, Glob, Grep, mcp__linear-server__create_comment, mcp__linear-server__get_issue
5
5
  skills: browser-capture, maia-files-upload, maia-files-delete
6
6
  model: opus
7
+ color: "#7C3AED"
7
8
  ---
8
9
 
9
10
  # Screenshot Reporter Agent
@@ -4,6 +4,7 @@ description: Style components and views with Tailwind CSS according to project s
4
4
  tools: Read, Edit, Write, Glob, Grep
5
5
  skills: browser-capture
6
6
  model: opus
7
+ color: "#7C3AED"
7
8
  ---
8
9
 
9
10
  You are an expert web designer specializing in Tailwind CSS styling for Angular components.
@@ -258,7 +258,7 @@ Continue? (yes/no/adjust)
258
258
 
259
259
  **Feedback Collection for Agent Evolution:**
260
260
 
261
- During 3x3 checkpoints, when the user provides corrections or suggestions about coding patterns, implementation approach, or agent behavior — collect these as **evolution feedback items**. These will be processed in Step 3g-evolve. Look for signals like: universal language ("always", "never"), pattern-level corrections, or explicit requests to update agent behavior.
261
+ During 3x3 checkpoints, when the user provides corrections or suggestions about coding patterns, implementation approach, or agent behavior — collect these as **evolution feedback items**. These will be processed in Step 3g-evolve and filed as Linear issues via `linear-suggestion` skill. Look for signals like: universal language ("always", "never"), pattern-level corrections, or explicit requests to update agent behavior.
262
262
 
263
263
  **IMPORTANT**: Also STOP and wait for user confirmation:
264
264
 
@@ -414,15 +414,15 @@ The agent will:
414
414
 
415
415
  1. Classify each feedback item (IGNORE / EVOLVE_PATTERN / EVOLVE_RULE / EVOLVE_TEMPLATE / CREATE_AGENT / UPDATE_WORKFLOW)
416
416
  2. Generate proposals for non-IGNORE items
417
- 3. Present each proposal to the user for confirmation
418
- 4. Apply confirmed changes to agent/command/skill files
419
- 5. Return Evolution Report
417
+ 3. File each proposal as a Linear issue in "MobileMS Framework" via `linear-suggestion` skill
418
+ 4. Return Evolution Report with created issue IDs
420
419
 
421
420
  **IMPORTANT**:
422
421
 
423
- - Every proposed change MUST be confirmed by the user before applying
422
+ - Agent files are NOT modified directly proposals are filed as Linear issues for manual review
424
423
  - If no reusable feedback was collected during this subtask, skip this step
425
424
  - This step runs BEFORE the subtask pause (Step 3h) so evolution is complete before moving on
425
+ - If Linear issue creation fails, continue silently — do not block the workflow
426
426
 
427
427
  #### Step 3h: Pause After Subtask Completion
428
428
 
@@ -483,8 +483,8 @@ The agent will:
483
483
  1. Analyze all feedback from the entire session (not just last subtask)
484
484
  2. Identify recurring patterns that may have been missed per-subtask
485
485
  3. Propose cross-cutting improvements (patterns spanning multiple agents)
486
- 4. Present proposals with user confirmation
487
- 5. Return final Evolution Report
486
+ 4. File proposals as Linear issues in "MobileMS Framework" via `linear-suggestion` skill
487
+ 5. Return final Evolution Report with created issue IDs
488
488
 
489
489
  **IMPORTANT**: This step catches improvements that only become visible across multiple subtasks. Skip if no actionable feedback exists.
490
490
 
@@ -513,14 +513,14 @@ To Do → In Progress → In Review (if completed)
513
513
 
514
514
  **ALWAYS stop and wait for user confirmation at these points:**
515
515
 
516
- | Pause Point | When | What to Show |
517
- | -------------------- | ----------------------------------- | ------------------------------------ |
518
- | **3x3 Checkpoint** | After every 3 changes | Summary of 3 changes + next 3 steps |
519
- | **Subtask Complete** | After finishing each subtask | Subtask summary + next subtask info |
520
- | **Task Complete** | After finishing all subtasks | Final summary with all results |
521
- | **Blocker Found** | When external dependency found | Blocker details + options |
522
- | **Error/Issue** | When unexpected problem occurs | Error details + proposed solution |
523
- | **Agent Evolution** | After subtask / after final summary | Evolution proposals for confirmation |
516
+ | Pause Point | When | What to Show |
517
+ | -------------------- | ----------------------------------- | ----------------------------------------- |
518
+ | **3x3 Checkpoint** | After every 3 changes | Summary of 3 changes + next 3 steps |
519
+ | **Subtask Complete** | After finishing each subtask | Subtask summary + next subtask info |
520
+ | **Task Complete** | After finishing all subtasks | Final summary with all results |
521
+ | **Blocker Found** | When external dependency found | Blocker details + options |
522
+ | **Error/Issue** | When unexpected problem occurs | Error details + proposed solution |
523
+ | **Agent Evolution** | After subtask / after final summary | Evolution report with filed Linear issues |
524
524
 
525
525
  **Never proceed automatically** - always wait for explicit user confirmation before:
526
526
 
@@ -609,8 +609,8 @@ When verification fails, delegate to appropriate fix agent:
609
609
  20. **Capture after screenshots + post to Linear**: After implementation, launch `screenshot-reporter` agent to capture "after" screenshots, generate comparison report, post to Linear, and cleanup
610
610
  21. **Document translations changes**: If `apps/web/public/translations.json` was modified, include a table with added/changed translation keys and their PL/EN values in the Implementation Report
611
611
  22. **Capture screenshots in both modes**: Agent captures screenshots in BOTH normal mode and dark mode (high contrast) for complete visual documentation
612
- 23. **Collect feedback for agent evolution**: During implementation, observe user corrections and suggestions. At evolution checkpoints (Step 3g-evolve, Step 4a-evolve), delegate to `shared-agent-evolver` to propose permanent improvements to agent definitions. Every modification requires user confirmation.
613
- 24. **Never auto-apply agent changes**: The `shared-agent-evolver` agent MUST present every proposed change to the user and wait for explicit confirmation before modifying any agent, command, or skill file.
612
+ 23. **Collect feedback for agent evolution**: During implementation, observe user corrections and suggestions. At evolution checkpoints (Step 3g-evolve, Step 4a-evolve), delegate to `shared-agent-evolver` which files improvement proposals as Linear issues in "MobileMS Framework" via `linear-suggestion` skill.
613
+ 24. **Never modify agent files directly during implementation**: The `shared-agent-evolver` agent files all proposals as Linear issues for manual review it does NOT modify agent, command, or skill files directly.
614
614
 
615
615
  ## Example Flow
616
616
 
@@ -634,7 +634,7 @@ When verification fails, delegate to appropriate fix agent:
634
634
  8. **📸 VERIFY**: Confirm `SCREENSHOT_REQUIREMENT_MET: YES`
635
635
  9. Create Implementation Report comment
636
636
  10. Set status: In Progress → In Review
637
- 11. **EVOLVE**: User corrected error handling pattern → proposed adding pattern to `shared-error-handler` → user confirmed → applied
637
+ 11. **EVOLVE**: User corrected error handling pattern → filed Linear issue MOB-820 proposing pattern addition to `shared-error-handler`
638
638
 
639
639
  **Processing ENG-456-2 (blocked):**
640
640