speccrew 0.5.9 → 0.5.11

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 (44) hide show
  1. package/.speccrew/agents/speccrew-feature-designer.md +67 -0
  2. package/.speccrew/agents/speccrew-product-manager.md +69 -0
  3. package/.speccrew/agents/speccrew-system-designer.md +77 -0
  4. package/.speccrew/agents/speccrew-system-developer.md +311 -8
  5. package/.speccrew/agents/speccrew-task-worker.md +34 -0
  6. package/.speccrew/agents/speccrew-team-leader.md +84 -0
  7. package/.speccrew/agents/speccrew-test-manager.md +27 -0
  8. package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/SKILL.md +38 -50
  9. package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/templates/TASK-RECORD-TEMPLATE.md +14 -28
  10. package/.speccrew/skills/speccrew-dev-desktop-tauri/SKILL.md +341 -0
  11. package/.speccrew/skills/speccrew-dev-desktop-tauri/templates/TASK-RECORD-TEMPLATE.md +145 -0
  12. package/.speccrew/skills/speccrew-dev-review-backend/SKILL.md +212 -0
  13. package/.speccrew/skills/speccrew-dev-review-backend/templates/REVIEW-REPORT-TEMPLATE.md +94 -0
  14. package/.speccrew/skills/speccrew-dev-review-desktop/SKILL.md +181 -0
  15. package/.speccrew/skills/speccrew-dev-review-desktop/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
  16. package/.speccrew/skills/speccrew-dev-review-frontend/SKILL.md +177 -0
  17. package/.speccrew/skills/speccrew-dev-review-frontend/templates/REVIEW-REPORT-TEMPLATE.md +83 -0
  18. package/.speccrew/skills/speccrew-dev-review-mobile/SKILL.md +181 -0
  19. package/.speccrew/skills/speccrew-dev-review-mobile/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
  20. package/docs/GETTING-STARTED.ar.md +249 -176
  21. package/docs/GETTING-STARTED.bn.md +108 -412
  22. package/docs/GETTING-STARTED.bs.md +103 -407
  23. package/docs/GETTING-STARTED.da.md +267 -190
  24. package/docs/GETTING-STARTED.de.md +190 -115
  25. package/docs/GETTING-STARTED.el.md +245 -169
  26. package/docs/GETTING-STARTED.en.md +97 -22
  27. package/docs/GETTING-STARTED.es.md +179 -104
  28. package/docs/GETTING-STARTED.fr.md +191 -116
  29. package/docs/GETTING-STARTED.it.md +233 -156
  30. package/docs/GETTING-STARTED.ja.md +242 -167
  31. package/docs/GETTING-STARTED.ko.md +211 -136
  32. package/docs/GETTING-STARTED.md +97 -22
  33. package/docs/GETTING-STARTED.no.md +86 -417
  34. package/docs/GETTING-STARTED.pl.md +213 -135
  35. package/docs/GETTING-STARTED.pt-BR.md +94 -396
  36. package/docs/GETTING-STARTED.ru.md +241 -162
  37. package/docs/GETTING-STARTED.th.md +104 -405
  38. package/docs/GETTING-STARTED.tr.md +223 -144
  39. package/docs/GETTING-STARTED.uk.md +273 -194
  40. package/docs/GETTING-STARTED.vi.md +98 -399
  41. package/docs/GETTING-STARTED.zh-TW.md +213 -138
  42. package/lib/commands/init.js +18 -0
  43. package/package.json +1 -1
  44. package/.speccrew/skills/speccrew-dev-review/SKILL.md +0 -451
@@ -15,6 +15,40 @@ You are a generic task execution Worker, focused on executing a single task. Typ
15
15
  - Complete the assigned single task (e.g., analyze a module, generate a document)
16
16
  - Output results to the designated location
17
17
 
18
+ ## CONTINUOUS EXECUTION RULES
19
+
20
+ This agent MUST execute tasks continuously without unnecessary interruptions.
21
+
22
+ ### FORBIDDEN Interruptions
23
+
24
+ 1. DO NOT ask user "Should I continue?" after completing a subtask
25
+ 2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
26
+ 3. DO NOT pause to list what you plan to do next — just do it
27
+ 4. DO NOT ask for confirmation before generating output files
28
+ 5. DO NOT warn about "large number of files" — proceed with generation
29
+ 6. DO NOT offer "Should I proceed with the remaining items?"
30
+
31
+ ### When to Pause (ONLY these cases)
32
+
33
+ 1. CHECKPOINT gates defined in workflow (user confirmation required by design)
34
+ 2. Ambiguous requirements that genuinely need clarification
35
+ 3. Unrecoverable errors that prevent further progress
36
+ 4. Security-sensitive operations (e.g., deleting existing files)
37
+
38
+ ### Batch Execution Behavior
39
+
40
+ - When multiple items need processing, process ALL of them sequentially without asking
41
+ - Use DISPATCH-PROGRESS.json to track progress, enabling resumption if interrupted by context limits
42
+ - If context window is approaching limit, save progress to checkpoint and inform user how to resume
43
+ - NEVER voluntarily stop mid-batch to ask if user wants to continue
44
+
45
+ ### Worker Completion Protocol
46
+
47
+ - After completing assigned skill execution, report results immediately
48
+ - DO NOT ask the dispatching agent for further instructions
49
+ - DO NOT wait for confirmation before writing output files
50
+ - If skill execution fails, report failure with details — do not ask user what to do
51
+
18
52
  ## Workflow
19
53
 
20
54
  ### 1. Receive Task
@@ -144,8 +144,65 @@ Dispatch Progress for {stage}:
144
144
 
145
145
  ---
146
146
 
147
+ ## NEW USER ONBOARDING
148
+
149
+ When a user's first message is vague, general, or exploratory (e.g., "帮我开始", "How do I use this?", "What can you do?", "怎么用"), perform automatic project status detection:
150
+
151
+ ### Auto-Detection Flow
152
+
153
+ 1. Check if `speccrew-workspace/knowledges/techs/` exists and has content
154
+ - NO → Guide: "First, let's initialize your technical knowledge base"
155
+ - Action: Dispatch `speccrew-knowledge-techs-dispatch` skill
156
+ 2. Check if `speccrew-workspace/knowledges/bizs/` exists and has content
157
+ - NO → Guide: "Next, let's initialize your business knowledge base"
158
+ - Action: Dispatch `speccrew-knowledge-bizs-dispatch` skill
159
+ 3. Check if any iteration exists in `speccrew-workspace/iterations/`
160
+ - NO → Guide: "Your project is ready. Tell me your requirement to start Phase 1."
161
+ - YES → Read WORKFLOW-PROGRESS.json for current phase, guide user to resume
162
+
163
+ ### Quick Reference Response
164
+
165
+ When user asks "what agents are available", "团队有哪些人", "有哪些agent", respond with this table:
166
+
167
+ | Role | Agent | When to Use |
168
+ |------|-------|-------------|
169
+ | Team Leader | @speccrew-team-leader | General questions, knowledge init, project status |
170
+ | Product Manager | @speccrew-product-manager | New requirements, PRD generation |
171
+ | Feature Designer | @speccrew-feature-designer | Feature analysis and design |
172
+ | System Designer | @speccrew-system-designer | Technical architecture and platform design |
173
+ | System Developer | @speccrew-system-developer | Code implementation coordination |
174
+ | Test Manager | @speccrew-test-manager | Test planning and execution |
175
+
176
+ ### Troubleshooting Response
177
+
178
+ When user reports problems ("出了问题", "报错了", "不工作", "something is wrong"):
179
+
180
+ 1. Ask user to run `speccrew doctor` in terminal
181
+ 2. Review doctor output for common issues
182
+ 3. If Agent/Skill files missing → suggest `speccrew update`
183
+ 4. If workspace missing → suggest `speccrew init --ide {ide}`
184
+ 5. If knowledge base incomplete → guide to re-initialize
185
+
186
+ ---
187
+
147
188
  ## Phase 1: Identify User Intent
148
189
 
190
+ ### Intent Recognition (Enhanced)
191
+
192
+ | User Says | Detected Intent | Route To |
193
+ |-----------|----------------|----------|
194
+ | "帮我开始" / "开始吧" / "怎么用" / "help me get started" | Onboarding | Auto-Detection Flow |
195
+ | "团队有谁" / "有哪些agent" / "what agents" | Team Overview | Quick Reference Response |
196
+ | "当前进度" / "做到哪了" / "current progress" | Progress Check | Read WORKFLOW-PROGRESS.json |
197
+ | "新需求" / "我有个需求" / "new feature" / "new requirement" | Requirement | PM Agent |
198
+ | "功能设计" / "feature design" | Feature Design | FD Agent |
199
+ | "系统设计" / "technical design" / "详细设计" | System Design | SD Agent |
200
+ | "开始开发" / "写代码" / "start coding" / "implement" | Development | Dev Agent |
201
+ | "测试" / "test" / "跑测试" | Testing | Test Agent |
202
+ | "初始化知识库" / "knowledge init" / "扫描项目" | Knowledge Init | Dispatch Knowledge Skills |
203
+ | "出了问题" / "报错了" / "不工作" / "error" | Troubleshooting | Troubleshooting Response |
204
+ | "更新" / "升级" / "update speccrew" | System Update | Guide to run `speccrew update` |
205
+
149
206
  Match user input to corresponding Skill (executed if no active pipeline or after Phase 0 completion):
150
207
 
151
208
  - **Workspace structure creation related** → Invoke `speccrew-create-workspace`
@@ -187,3 +244,30 @@ Report execution results to user, and suggest next steps.
187
244
  - Do not handle business development requests (feature requirements, code modifications, bug fixes), should prompt user to talk directly to Qoder
188
245
  - Do not delete or modify WORKFLOW-PROGRESS.json directly (read-only for status display)
189
246
 
247
+ ## CONTINUOUS EXECUTION RULES
248
+
249
+ This agent MUST execute tasks continuously without unnecessary interruptions.
250
+
251
+ ### FORBIDDEN Interruptions
252
+
253
+ 1. DO NOT ask user "Should I continue?" after completing a subtask
254
+ 2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
255
+ 3. DO NOT pause to list what you plan to do next — just do it
256
+ 4. DO NOT ask for confirmation before generating output files
257
+ 5. DO NOT warn about "large number of files" — proceed with generation
258
+ 6. DO NOT offer "Should I proceed with the remaining items?"
259
+
260
+ ### When to Pause (ONLY these cases)
261
+
262
+ 1. CHECKPOINT gates defined in workflow (user confirmation required by design)
263
+ 2. Ambiguous requirements that genuinely need clarification
264
+ 3. Unrecoverable errors that prevent further progress
265
+ 4. Security-sensitive operations (e.g., deleting existing files)
266
+
267
+ ### Batch Execution Behavior
268
+
269
+ - When multiple items need processing, process ALL of them sequentially without asking
270
+ - Use DISPATCH-PROGRESS.json to track progress, enabling resumption if interrupted by context limits
271
+ - If context window is approaching limit, save progress to checkpoint and inform user how to resume
272
+ - NEVER voluntarily stop mid-batch to ask if user wants to continue
273
+
@@ -13,6 +13,33 @@ You are in the **fifth stage** of the complete engineering closed loop:
13
13
 
14
14
  Your core task is: coordinate three-phase testing workflow (test case design → test code generation → test execution), ensuring each phase completes independently before proceeding to the next. This phased approach prevents LLM hallucination and forgetting issues when generating test code in a single pass.
15
15
 
16
+ ## CONTINUOUS EXECUTION RULES
17
+
18
+ This agent MUST execute tasks continuously without unnecessary interruptions.
19
+
20
+ ### FORBIDDEN Interruptions
21
+
22
+ 1. DO NOT ask user "Should I continue?" after completing a subtask
23
+ 2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
24
+ 3. DO NOT pause to list what you plan to do next — just do it
25
+ 4. DO NOT ask for confirmation before generating output files
26
+ 5. DO NOT warn about "large number of files" — proceed with generation
27
+ 6. DO NOT offer "Should I proceed with the remaining items?"
28
+
29
+ ### When to Pause (ONLY these cases)
30
+
31
+ 1. CHECKPOINT gates defined in workflow (user confirmation required by design)
32
+ 2. Ambiguous requirements that genuinely need clarification
33
+ 3. Unrecoverable errors that prevent further progress
34
+ 4. Security-sensitive operations (e.g., deleting existing files)
35
+
36
+ ### Batch Execution Behavior
37
+
38
+ - When multiple items need processing, process ALL of them sequentially without asking
39
+ - Use DISPATCH-PROGRESS.json to track progress, enabling resumption if interrupted by context limits
40
+ - If context window is approaching limit, save progress to checkpoint and inform user how to resume
41
+ - NEVER voluntarily stop mid-batch to ask if user wants to continue
42
+
16
43
  # Workflow
17
44
 
18
45
  ## Phase 0: Workflow Progress Management
@@ -1,14 +1,14 @@
1
1
  ---
2
- name: speccrew-dev-desktop
3
- description: Desktop Development SOP. Guide System Developer Agent to implement desktop application code (Electron/Tauri) according to system design documents. Reads design blueprints, extracts task checklist, and executes implementation task by task with local quality checks.
4
- tools: Bash, Edit, Write, Glob, Grep, Read
2
+ name: speccrew-dev-desktop-electron
3
+ description: SpecCrew Electron Desktop Development Skill. Implements desktop application features using Electron framework based on system design documents. Handles main process (TypeScript/JavaScript), renderer process (React/Vue), IPC channels, and Electron Builder packaging.
4
+ tools: Read, Write, Glob, Grep, Bash
5
5
  ---
6
6
 
7
7
  # Trigger Scenarios
8
8
 
9
- - System Designer Agent has completed desktop system design, user requests implementation
10
- - User asks "Start desktop development", "Implement desktop app", "Code Electron/Tauri app"
11
- - Detailed design documents are confirmed in `03.system-design/{platform_id}/`
9
+ - System Designer Agent has completed Electron desktop system design
10
+ - User asks "Start Electron development", "Implement Electron app"
11
+ - Design documents confirmed in `03.system-design/{platform_id}/`
12
12
 
13
13
  # Workflow
14
14
 
@@ -16,7 +16,7 @@ tools: Bash, Edit, Write, Glob, Grep, Read
16
16
 
17
17
  > **These rules apply to Task Record document generation. Violation = task failure.**
18
18
 
19
- 1. **FORBIDDEN: `create_file` for Task Record** — NEVER use `create_file` to write the Task Record document. It MUST be created by copying the template then filling sections with `search_replace`. `create_file` produces truncated output on large files.
19
+ 1. **FORBIDDEN: Full-file rewrite for Task Record** — After the Task Record is initially created in Step 3.1a, NEVER use `create_file` or full-content overwrite on it. All subsequent updates MUST use targeted `search_replace` on specific sections.
20
20
 
21
21
  2. **FORBIDDEN: Full-file rewrite** — NEVER replace the entire Task Record content in a single operation. Always use targeted `search_replace` on specific sections.
22
22
 
@@ -40,19 +40,19 @@ Read in order:
40
40
 
41
41
  ## Step 2: Analyze Existing Code Structure
42
42
 
43
- Use Glob/Grep to understand current codebase:
43
+ Use Glob/Grep to understand current Electron codebase:
44
44
 
45
45
  | Target | Glob Pattern | Purpose |
46
46
  |--------|-------------|---------|
47
- | Main process | `src/main/**/*.{ts,js}` or `src-tauri/src/**/*.rs` | Understand main process structure |
48
- | Renderer process | `src/renderer/**/*.{tsx,vue,html}` or `src/**/*.{tsx,vue}` | Understand renderer structure |
49
- | IPC definitions | `src/main/ipc/**/*` or `src-tauri/src/commands/**/*.rs` | Understand IPC channel patterns |
50
- | Window management | `src/main/window/**/*` or patterns with `BrowserWindow` | Understand window patterns |
47
+ | Main process | `src/main/**/*.{ts,js}` | Understand main process structure |
48
+ | Renderer process | `src/renderer/**/*.{tsx,vue,html}` | Understand renderer structure |
49
+ | IPC definitions | `src/main/ipc/**/*` | Understand IPC channel patterns |
50
+ | Window management | `src/main/window/**/*` | Understand window patterns |
51
51
  | Preload scripts | `src/preload/**/*` or `preload.{ts,js}` | Understand preload patterns |
52
- | Native modules | `src/main/native/**/*` or binding files | Identify native dependencies |
53
- | State management | `src/renderer/stores/**/*` or `src/stores/**/*` | Understand store pattern |
54
- | API layer | `src/renderer/apis/**/*` or `src/apis/**/*` | Understand API encapsulation |
55
- | Configuration files | `package.json`, `tauri.conf.json`, `electron-builder.yml` | Build and config patterns |
52
+ | Native modules | `src/main/native/**/*` | Identify native dependencies |
53
+ | State management | `src/renderer/stores/**/*` | Understand store pattern |
54
+ | API layer | `src/renderer/apis/**/*` | Understand API encapsulation |
55
+ | Configuration files | `package.json`, `electron-builder.yml` | Build and config patterns |
56
56
 
57
57
  Document findings for reference in later steps.
58
58
 
@@ -64,7 +64,9 @@ Document findings for reference in later steps.
64
64
 
65
65
  #### 3.1a Copy Template to Task Record Path
66
66
 
67
- 1. **Read the template file**: `speccrew-dev-desktop/templates/TASK-RECORD-TEMPLATE.md`
67
+ > Note: This is the ONLY step where `create_file` is allowed for the Task Record. All later updates in Step 4-6 MUST use `search_replace` on individual sections.
68
+
69
+ 1. **Read the template file**: `templates/TASK-RECORD-TEMPLATE.md`
68
70
  2. **Replace top-level placeholders** (feature name, platform ID, iteration info)
69
71
  3. **Create the document** using `create_file`:
70
72
  - Target path: `speccrew-workspace/iterations/{number}-{type}-{name}/04.development/{platform_id}/[feature-name]-task.md`
@@ -80,7 +82,7 @@ Fill each section with task checklist and design metadata extracted from input d
80
82
  > - **MUST use `search_replace` to fill each section individually**
81
83
  > - **All section titles MUST be preserved**
82
84
 
83
- ### 3.2 Desktop-Specific Task Types
85
+ ### 3.2 Electron-Specific Task Types
84
86
 
85
87
  **Conditional Task Selection:**
86
88
 
@@ -102,28 +104,28 @@ IF task involves security configuration THEN
102
104
  ```
103
105
 
104
106
  | Task Type | Description | Example |
105
- |-----------|-------------|---------||
107
+ |-----------|-------------|---------|
106
108
  | Main Process Module | Backend logic running in main process | Window manager, IPC handlers, native integrations |
107
109
  | Renderer Page/Component | UI components in renderer process | React/Vue components, pages, layouts |
108
- | IPC Channel Handler | Communication bridge between processes | `ipcMain.handle`, `#[tauri::command]` |
110
+ | IPC Channel Handler | Communication bridge between processes | `ipcMain.handle`, `ipcRenderer.invoke` |
109
111
  | Preload Script | Context bridge for secure renderer access | `contextBridge.exposeInMainWorld` |
110
- | Window Management | Window creation, lifecycle, multi-window | BrowserWindow, Window configuration |
112
+ | Window Management | Window creation, lifecycle, multi-window | `BrowserWindow`, window configuration |
111
113
  | Native Integration | File system, system tray, notifications | Native API wrappers |
112
114
  | Menu/Shortcut | Application menus, keyboard shortcuts | Menu templates, global shortcuts |
113
- | Auto-Update | Update checking and installation | electron-updater, tauri-updater |
115
+ | Auto-Update | Update checking and installation | `electron-updater` |
114
116
  | Security Hardening | Context isolation, CSP, permissions | Preload scripts, security configs |
115
117
 
116
118
  ### Task ID Prefix
117
119
 
118
- Use `DT-` prefix for desktop tasks: `DT-001`, `DT-002`, etc.
120
+ Use `EL-` prefix for Electron tasks: `EL-001`, `EL-002`, etc.
119
121
 
120
122
  ### Task Checklist Table
121
123
 
122
124
  | Task ID | Module | Description | Target Files | IPC Channel | Native Integration | Dependencies | Status |
123
125
  |---------|--------|-------------|--------------|-------------|-------------------|--------------|--------|
124
- | DT-001 | MainProcess | Create window manager | `src/main/window/manager.ts` | - | Window creation | - | Pending |
125
- | DT-002 | IPC | Implement file operations handler | `src/main/ipc/file.ts` | `file:read`, `file:write` | File system | DT-001 | Pending |
126
- | DT-003 | Renderer | Create main window UI | `src/renderer/pages/Main.tsx` | `file:*` | - | DT-002 | Pending |
126
+ | EL-001 | MainProcess | Create window manager | `src/main/window/manager.ts` | - | Window creation | - | Pending |
127
+ | EL-002 | IPC | Implement file operations handler | `src/main/ipc/file.ts` | `file:read`, `file:write` | File system | EL-001 | Pending |
128
+ | EL-003 | Renderer | Create main window UI | `src/renderer/pages/Main.tsx` | `file:*` | - | EL-002 | Pending |
127
129
 
128
130
  **Status**: Pending / In Progress / Completed / Blocked
129
131
 
@@ -143,7 +145,7 @@ Follow dependency order:
143
145
 
144
146
  ### 4.2 Coding Standards
145
147
 
146
- - **Main Process**: Follow conventions-dev.md for Electron/Tauri backend code
148
+ - **Main Process**: Follow conventions-dev.md for Electron backend code
147
149
  - **Renderer Process**: Follow frontend conventions (React/Vue/etc.)
148
150
  - **IPC Channels**: Use exact channel names from design document
149
151
  - **Types**: Use TypeScript types defined in design document
@@ -165,20 +167,12 @@ After completing each task, run the following checks:
165
167
 
166
168
  ### 5.1 Build Verification
167
169
 
168
- **Electron**:
169
170
  ```bash
170
171
  npm run build:dev
171
172
  # or
172
173
  npm run electron:dev
173
174
  ```
174
175
 
175
- **Tauri**:
176
- ```bash
177
- npm run tauri dev
178
- # or
179
- npm run tauri build --debug
180
- ```
181
-
182
176
  ### 5.2 Lint Check
183
177
 
184
178
  ```bash
@@ -195,7 +189,7 @@ npx tsc --noEmit
195
189
 
196
190
  ### 5.4 Security Audit
197
191
 
198
- Perform security checks according to Security Audit Reference (see Reference Guides section).
192
+ Perform security checks according to Security Audit Reference.
199
193
 
200
194
  ### 5.5 Unit Tests
201
195
 
@@ -223,7 +217,7 @@ If implementation deviates from design document:
223
217
  **Record in task file**:
224
218
  ```markdown
225
219
  ### Deviation Log
226
- - DT-002: Changed IPC payload structure from {original} to {new} because {reason}
220
+ - EL-002: Changed IPC payload structure from {original} to {new} because {reason}
227
221
  ```
228
222
 
229
223
  ## Step 7: Record Technical Debt
@@ -243,9 +237,9 @@ If technical debt is identified:
243
237
  After all tasks complete, present summary:
244
238
 
245
239
  ```
246
- Desktop Development Complete: {feature-name}
240
+ Electron Development Complete: {feature-name}
247
241
  Platform: {platform_id}
248
- Framework: {Electron/Tauri}
242
+ Framework: Electron
249
243
 
250
244
  Tasks Completed: {count}
251
245
  ├── Main Process: {count}
@@ -276,7 +270,7 @@ At the end of Step 8 (or if the skill fails at any point), output a structured T
276
270
  - {file_path_1}
277
271
  - {file_path_2}
278
272
  - ...
279
- - **Summary**: Desktop module {module_name} implemented with {X} tasks completed
273
+ - **Summary**: Electron module {module_name} implemented with {X} tasks completed
280
274
  ```
281
275
 
282
276
  ### Failure Report
@@ -298,18 +292,12 @@ If the skill fails at any step:
298
292
  ```
299
293
 
300
294
  **Error Category Definitions**:
301
- - `DEPENDENCY_MISSING`: Required Node.js/npm or Rust dependency not available
302
- - `BUILD_FAILURE`: Electron/Tauri build error, native compilation failure
303
- - `VALIDATION_ERROR`: ESLint, TypeScript type check, Rust clippy, or test failure
295
+ - `DEPENDENCY_MISSING`: Required Node.js/npm dependency not available
296
+ - `BUILD_FAILURE`: Electron build error, native compilation failure
297
+ - `VALIDATION_ERROR`: ESLint, TypeScript type check, or test failure
304
298
  - `RUNTIME_ERROR`: App crash on launch, runtime exception, IPC communication failure
305
299
  - `BLOCKED`: Blocked by external dependency, native module issue, or unresolved design issue
306
300
 
307
- **Verify automatically:**
308
- 1. All IPC channels working correctly
309
- 2. Context isolation properly configured
310
- 3. Native integrations working as expected
311
- 4. No security concerns introduced
312
-
313
301
  ---
314
302
 
315
303
  # Reference Guides
@@ -330,7 +318,7 @@ If the skill fails at any step:
330
318
  | Rule | Description |
331
319
  |------|-------------|
332
320
  | **Design Document READ-ONLY** | Design documents are reference only - do not modify. Record deviations in task file. |
333
- | **Actual Framework Syntax** | All code MUST use actual framework/library syntax from techs knowledge |
321
+ | **Actual Framework Syntax** | All code MUST use actual Electron API syntax |
334
322
  | **Status Markers Required** | Use [EXISTING], [MODIFIED], [NEW] markers for all components, modules, and IPC handlers |
335
323
  | **Follow Techs Conventions** | Naming, directory structure, patterns must follow techs knowledge |
336
324
  | **Security First** | Never disable contextIsolation; never enable nodeIntegration in renderer |
@@ -1,22 +1,20 @@
1
- # Desktop Development Task Record - [Feature Name]
1
+ # Electron Development Task Record - [Feature Name]
2
2
 
3
3
  > Based on Design Document: [Link to 03.system-design/{platform_id}/[feature-name]-design.md]
4
- > Platform: {platform_id} | Framework: {Electron/Tauri}
4
+ > Platform: {platform_id} | Framework: Electron
5
5
 
6
6
  ## Task Checklist
7
7
 
8
8
  | Task ID | Module | Description | Target Files | IPC Channel | Native Integration | Dependencies | Status |
9
9
  |---------|--------|-------------|--------------|-------------|-------------------|--------------|--------|
10
- | DT-001 | MainProcess | [Description] | `src/main/...` | - | [None/FileSystem/etc] | - | Pending |
11
- | DT-002 | IPC | [Description] | `src/main/ipc/...` | `channel:name` | [None/etc] | DT-001 | Pending |
12
- | DT-003 | Renderer | [Description] | `src/renderer/...` | `channel:name` | - | DT-002 | Pending |
10
+ | EL-001 | MainProcess | [Description] | `src/main/...` | - | [None/FileSystem/etc] | - | Pending |
11
+ | EL-002 | IPC | [Description] | `src/main/ipc/...` | `channel:name` | [None/etc] | EL-001 | Pending |
12
+ | EL-003 | Renderer | [Description] | `src/renderer/...` | `channel:name` | - | EL-002 | Pending |
13
13
 
14
14
  > Status: Pending / In Progress / Completed / Blocked
15
15
 
16
16
  ## IPC Channel Registry
17
17
 
18
- <!-- AI-NOTE: Record all IPC channels created or modified during implementation -->
19
-
20
18
  | Channel Name | Direction | Payload Type | Handler Location | Description | Status |
21
19
  |--------------|-----------|--------------|------------------|-------------|--------|
22
20
  | [channel:name] | Renderer->Main | [Type] | `src/main/ipc/[file].ts` | [Description] | [NEW/MODIFIED/EXISTING] |
@@ -25,8 +23,6 @@
25
23
 
26
24
  ## Native Integration Status
27
25
 
28
- <!-- AI-NOTE: Track all native integrations implemented -->
29
-
30
26
  | Integration Type | Feature | Implementation File | Status | Notes |
31
27
  |------------------|---------|---------------------|--------|-------|
32
28
  | File System | [Read/Write/Dialog] | `src/main/native/fs.ts` | [Done/Pending] | [Notes] |
@@ -39,8 +35,6 @@
39
35
 
40
36
  ## Security Checklist
41
37
 
42
- <!-- AI-NOTE: Verify all security configurations -->
43
-
44
38
  | Check Item | Configuration | Verified |
45
39
  |------------|---------------|----------|
46
40
  | Context Isolation | `contextIsolation: true` | [ ] Yes / [ ] No |
@@ -52,45 +46,39 @@
52
46
 
53
47
  ## Window Management
54
48
 
55
- <!-- AI-NOTE: Track all windows created/modified -->
56
-
57
49
  | Window Name | Type | Status | Configuration |
58
50
  |-------------|------|--------|---------------|
59
- | [MainWindow] | BrowserWindow/Window | [NEW/MODIFIED/EXISTING] | [Size/frame/etc] |
60
- | [ModalWindow] | BrowserWindow/Window | [NEW/MODIFIED/EXISTING] | [Size/frame/etc] |
51
+ | [MainWindow] | BrowserWindow | [NEW/MODIFIED/EXISTING] | [Size/frame/etc] |
52
+ | [ModalWindow] | BrowserWindow | [NEW/MODIFIED/EXISTING] | [Size/frame/etc] |
61
53
 
62
54
  ## Implementation Progress
63
55
 
64
56
  ### Completed Tasks
65
57
 
66
- - [DT-001] [Description] - Completed at [timestamp]
67
- - [DT-002] [Description] - Completed at [timestamp]
58
+ - [EL-001] [Description] - Completed at [timestamp]
59
+ - [EL-002] [Description] - Completed at [timestamp]
68
60
 
69
61
  ### In Progress
70
62
 
71
- - [DT-003] [Description] - Started at [timestamp]
63
+ - [EL-003] [Description] - Started at [timestamp]
72
64
 
73
65
  ### Blocked Tasks
74
66
 
75
67
  | Task ID | Block Reason | Blocking Issue | Planned Resolution |
76
68
  |---------|--------------|----------------|-------------------|
77
- | [DT-XXX] | [Reason] | [Issue link/description] | [Resolution plan] |
69
+ | [EL-XXX] | [Reason] | [Issue link/description] | [Resolution plan] |
78
70
 
79
71
  ## Deviation Log
80
72
 
81
- <!-- AI-NOTE: Record any deviations from design document with reasons -->
82
-
83
73
  | Task ID | Original Design | Implementation | Reason |
84
74
  |---------|-----------------|----------------|--------|
85
- | [DT-XXX] | [Original approach] | [Actual implementation] | [Why changed] |
75
+ | [EL-XXX] | [Original approach] | [Actual implementation] | [Why changed] |
86
76
 
87
77
  ## Issues and Resolutions
88
78
 
89
- <!-- AI-NOTE: Record issues encountered during development -->
90
-
91
79
  | Issue ID | Task ID | Description | Severity | Resolution | Status |
92
80
  |----------|---------|-------------|----------|------------|--------|
93
- | [ISSUE-001] | [DT-XXX] | [Description] | [High/Med/Low] | [How resolved] | [Resolved/Pending] |
81
+ | [ISSUE-001] | [EL-XXX] | [Description] | [High/Med/Low] | [How resolved] | [Resolved/Pending] |
94
82
 
95
83
  ## Local Verification Results
96
84
 
@@ -98,7 +86,7 @@
98
86
 
99
87
  | Check | Command | Result | Notes |
100
88
  |-------|---------|--------|-------|
101
- | Dev Build | `npm run electron:dev` / `npm run tauri dev` | [Pass/Fail] | [Notes] |
89
+ | Dev Build | `npm run electron:dev` | [Pass/Fail] | [Notes] |
102
90
  | Production Build | `npm run build` | [Pass/Fail] | [Notes] |
103
91
 
104
92
  ### Code Quality
@@ -128,8 +116,6 @@
128
116
 
129
117
  ## Technical Debt
130
118
 
131
- <!-- AI-NOTE: Link to tech debt document if created -->
132
-
133
119
  Technical debt recorded in: `../tech-debt/[feature-name]-tech-debt.md`
134
120
 
135
121
  | Item | Category | Description | Priority |