universal-dev-standards 4.0.0 → 4.2.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 (55) hide show
  1. package/bin/uds.js +75 -0
  2. package/bundled/core/ai-friendly-architecture.md +542 -0
  3. package/bundled/core/refactoring-standards.md +342 -120
  4. package/bundled/locales/zh-CN/README.md +210 -509
  5. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +306 -0
  6. package/bundled/locales/zh-CN/core/refactoring-standards.md +10 -9
  7. package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md +82 -22
  8. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +35 -3
  9. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +89 -3
  10. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +8 -4
  11. package/bundled/locales/zh-CN/skills/claude-code/commands/refactor.md +178 -0
  12. package/bundled/locales/zh-CN/skills/claude-code/refactoring-assistant/SKILL.md +243 -97
  13. package/bundled/locales/zh-TW/README.md +211 -490
  14. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -0
  15. package/bundled/locales/zh-TW/core/refactoring-standards.md +347 -125
  16. package/bundled/locales/zh-TW/docs/AI-AGENT-ROADMAP.md +82 -22
  17. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +35 -3
  18. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +89 -3
  19. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +8 -4
  20. package/bundled/locales/zh-TW/skills/claude-code/commands/refactor.md +178 -0
  21. package/bundled/locales/zh-TW/skills/claude-code/refactoring-assistant/SKILL.md +198 -52
  22. package/bundled/skills/claude-code/README.md +8 -0
  23. package/bundled/skills/claude-code/agents/README.md +305 -0
  24. package/bundled/skills/claude-code/agents/code-architect.md +259 -0
  25. package/bundled/skills/claude-code/agents/doc-writer.md +406 -0
  26. package/bundled/skills/claude-code/agents/reviewer.md +353 -0
  27. package/bundled/skills/claude-code/agents/spec-analyst.md +374 -0
  28. package/bundled/skills/claude-code/agents/test-specialist.md +364 -0
  29. package/bundled/skills/claude-code/commands/refactor.md +173 -0
  30. package/bundled/skills/claude-code/refactoring-assistant/SKILL.md +161 -63
  31. package/bundled/skills/claude-code/workflows/README.md +303 -0
  32. package/bundled/skills/claude-code/workflows/code-review.workflow.yaml +186 -0
  33. package/bundled/skills/claude-code/workflows/feature-dev.workflow.yaml +174 -0
  34. package/bundled/skills/claude-code/workflows/integrated-flow.workflow.yaml +238 -0
  35. package/bundled/skills/claude-code/workflows/large-codebase-analysis.workflow.yaml +226 -0
  36. package/package.json +11 -1
  37. package/src/commands/agent.js +417 -0
  38. package/src/commands/ai-context.js +552 -0
  39. package/src/commands/check.js +3 -3
  40. package/src/commands/init.js +6 -3
  41. package/src/commands/workflow.js +425 -0
  42. package/src/config/ai-agent-paths.js +217 -13
  43. package/src/core/constants.js +514 -0
  44. package/src/core/errors.js +398 -0
  45. package/src/core/manifest.js +473 -0
  46. package/src/core/paths.js +398 -0
  47. package/src/prompts/init.js +7 -5
  48. package/src/utils/agent-adapter.js +320 -0
  49. package/src/utils/agents-installer.js +393 -0
  50. package/src/utils/context-chunker.js +467 -0
  51. package/src/utils/copier.js +59 -99
  52. package/src/utils/hasher.js +2 -16
  53. package/src/utils/integration-generator.js +28 -52
  54. package/src/utils/workflows-installer.js +545 -0
  55. package/standards-registry.json +174 -24
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "version": "4.0.0",
4
- "lastUpdated": "2026-01-20",
3
+ "version": "4.2.0",
4
+ "lastUpdated": "2026-01-24",
5
5
  "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
6
6
  "formats": {
7
7
  "ai": {
@@ -48,14 +48,14 @@
48
48
  "standards": {
49
49
  "name": "universal-dev-standards",
50
50
  "url": "https://github.com/AsiaOstrich/universal-dev-standards",
51
- "version": "4.0.0"
51
+ "version": "4.2.0"
52
52
  },
53
53
  "skills": {
54
54
  "name": "universal-dev-standards",
55
55
  "url": "https://github.com/AsiaOstrich/universal-dev-standards",
56
56
  "localPath": "skills/claude-code",
57
57
  "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/claude-code",
58
- "version": "4.0.0",
58
+ "version": "4.2.0",
59
59
  "note": "Skills are now included in the main repository under skills/"
60
60
  }
61
61
  },
@@ -64,11 +64,15 @@
64
64
  "name": "Claude Code",
65
65
  "skillsPath": "skills/claude-code",
66
66
  "nativePaths": {
67
- "skills": { "project": ".claude/skills/", "user": "~/.claude/skills/" }
67
+ "skills": { "project": ".claude/skills/", "user": "~/.claude/skills/" },
68
+ "agents": { "project": ".claude/agents/", "user": "~/.claude/agents/" },
69
+ "workflows": { "project": ".claude/workflows/", "user": "~/.claude/workflows/" }
68
70
  },
69
71
  "supportsMarketplace": true,
70
72
  "supportsSkills": true,
71
73
  "supportsCommands": false,
74
+ "supportsTask": true,
75
+ "supportsAgents": true,
72
76
  "status": "complete"
73
77
  },
74
78
  "opencode": {
@@ -76,91 +80,131 @@
76
80
  "skillsPath": "skills/claude-code",
77
81
  "nativePaths": {
78
82
  "skills": { "project": ".opencode/skill/", "user": "~/.config/opencode/skill/" },
79
- "commands": { "project": ".opencode/command/" }
83
+ "commands": { "project": ".opencode/command/" },
84
+ "agents": { "project": ".opencode/agents/", "user": "~/.config/opencode/agents/" },
85
+ "workflows": { "project": ".opencode/workflows/", "user": "~/.config/opencode/workflows/" }
80
86
  },
81
87
  "fallbackSkillsPath": ".claude/skills/",
82
88
  "supportsSkills": true,
83
89
  "supportsCommands": true,
90
+ "supportsTask": true,
91
+ "supportsAgents": true,
84
92
  "status": "complete"
85
93
  },
86
94
  "cursor": {
87
95
  "name": "Cursor",
88
96
  "skillsPath": "skills/cursor",
89
97
  "nativePaths": {
90
- "skills": { "project": ".cursor/skills/", "user": "~/.cursor/skills/" }
98
+ "skills": { "project": ".cursor/skills/", "user": "~/.cursor/skills/" },
99
+ "agents": { "project": ".cursor/agents/", "user": "~/.cursor/agents/" }
91
100
  },
92
101
  "fallbackSkillsPath": ".claude/skills/",
93
102
  "supportsSkills": false,
94
103
  "supportsCommands": false,
95
- "status": "planned"
104
+ "supportsTask": false,
105
+ "supportsAgents": true,
106
+ "status": "minimal"
96
107
  },
97
108
  "cline": {
98
109
  "name": "Cline",
99
110
  "skillsPath": "skills/cline",
100
111
  "nativePaths": {
101
- "skills": { "project": ".cline/skills/", "user": "~/.cline/skills/" }
112
+ "skills": { "project": ".cline/skills/", "user": "~/.cline/skills/" },
113
+ "agents": { "project": ".cline/agents/", "user": "~/.cline/agents/" },
114
+ "workflows": { "project": ".cline/workflows/", "user": "~/.cline/workflows/" }
102
115
  },
103
116
  "fallbackSkillsPath": ".claude/skills/",
104
117
  "supportsSkills": true,
105
118
  "supportsCommands": false,
106
- "status": "planned"
119
+ "supportsTask": false,
120
+ "supportsAgents": true,
121
+ "status": "partial"
107
122
  },
108
123
  "roo-code": {
109
124
  "name": "Roo Code",
110
125
  "skillsPath": "skills/claude-code",
111
126
  "nativePaths": {
112
127
  "skills": { "project": ".roo/skills/", "user": "~/.roo/skills/" },
113
- "commands": { "project": ".roo/commands/" }
128
+ "commands": { "project": ".roo/commands/" },
129
+ "agents": { "project": ".roo/agents/", "user": "~/.roo/agents/" },
130
+ "workflows": { "project": ".roo/workflows/", "user": "~/.roo/workflows/" }
114
131
  },
115
132
  "fallbackSkillsPath": ".claude/skills/",
116
133
  "supportsSkills": true,
117
134
  "supportsCommands": true,
135
+ "supportsTask": true,
136
+ "supportsAgents": true,
118
137
  "status": "planned"
119
138
  },
120
139
  "codex": {
121
140
  "name": "OpenAI Codex",
122
141
  "skillsPath": "skills/claude-code",
123
142
  "nativePaths": {
124
- "skills": { "project": ".codex/skills/", "user": "~/.codex/skills/" }
143
+ "skills": { "project": ".codex/skills/", "user": "~/.codex/skills/" },
144
+ "agents": { "project": ".codex/agents/", "user": "~/.codex/agents/" }
125
145
  },
126
146
  "fallbackSkillsPath": ".claude/skills/",
127
147
  "supportsSkills": true,
128
148
  "supportsCommands": false,
129
- "status": "planned"
149
+ "supportsTask": false,
150
+ "supportsAgents": true,
151
+ "status": "partial"
130
152
  },
131
153
  "copilot": {
132
154
  "name": "GitHub Copilot",
133
155
  "skillsPath": "skills/copilot",
134
156
  "nativePaths": {
135
157
  "skills": { "project": ".github/skills/", "user": "~/.copilot/skills/" },
136
- "commands": { "project": ".github/prompts/" }
158
+ "commands": { "project": ".github/prompts/" },
159
+ "agents": { "project": ".github/agents/", "user": "~/.copilot/agents/" }
137
160
  },
138
161
  "fallbackSkillsPath": ".claude/skills/",
139
162
  "supportsSkills": true,
140
163
  "supportsCommands": true,
141
- "status": "planned"
164
+ "supportsTask": false,
165
+ "supportsAgents": true,
166
+ "status": "partial"
142
167
  },
143
168
  "windsurf": {
144
169
  "name": "Windsurf",
145
170
  "skillsPath": "skills/windsurf",
146
171
  "nativePaths": {
147
- "skills": { "project": ".windsurf/skills/", "user": "~/.codeium/windsurf/skills/" }
172
+ "skills": { "project": ".windsurf/skills/", "user": "~/.codeium/windsurf/skills/" },
173
+ "agents": { "project": ".windsurf/agents/", "user": "~/.codeium/windsurf/agents/" }
148
174
  },
149
- "supportsSkills": true,
175
+ "supportsSkills": false,
150
176
  "supportsCommands": false,
151
- "status": "planned"
177
+ "supportsTask": false,
178
+ "supportsAgents": true,
179
+ "status": "minimal"
152
180
  },
153
181
  "gemini-cli": {
154
182
  "name": "Gemini CLI",
155
183
  "skillsPath": "skills/claude-code",
156
184
  "nativePaths": {
157
185
  "skills": { "project": ".gemini/skills/", "user": "~/.gemini/skills/" },
158
- "commands": { "project": ".gemini/commands/" }
186
+ "commands": { "project": ".gemini/commands/" },
187
+ "agents": { "project": ".gemini/agents/", "user": "~/.gemini/agents/" },
188
+ "workflows": { "project": ".gemini/workflows/", "user": "~/.gemini/workflows/" }
159
189
  },
160
190
  "fallbackSkillsPath": ".claude/skills/",
161
191
  "supportsSkills": true,
162
192
  "supportsCommands": true,
163
- "status": "planned"
193
+ "supportsTask": false,
194
+ "supportsAgents": true,
195
+ "status": "preview"
196
+ },
197
+ "antigravity": {
198
+ "name": "Google Antigravity",
199
+ "skillsPath": null,
200
+ "nativePaths": {
201
+ "config": { "project": "INSTRUCTIONS.md" }
202
+ },
203
+ "supportsSkills": false,
204
+ "supportsCommands": false,
205
+ "supportsTask": false,
206
+ "supportsAgents": false,
207
+ "status": "minimal"
164
208
  }
165
209
  },
166
210
  "skillFiles": {
@@ -256,7 +300,11 @@
256
300
  "skills/claude-code/commands/update.md",
257
301
  "skills/claude-code/commands/reverse-spec.md",
258
302
  "skills/claude-code/commands/reverse-bdd.md",
259
- "skills/claude-code/commands/reverse-tdd.md"
303
+ "skills/claude-code/commands/reverse-tdd.md",
304
+ "skills/claude-code/commands/refactor.md"
305
+ ],
306
+ "refactoring-assistant": [
307
+ "skills/claude-code/refactoring-assistant/SKILL.md"
260
308
  ],
261
309
  "methodology-system": [
262
310
  "skills/claude-code/methodology-system/SKILL.md",
@@ -273,6 +321,95 @@
273
321
  "skills/claude-code/forward-derivation/SKILL.md"
274
322
  ]
275
323
  },
324
+ "agents": {
325
+ "status": "stable",
326
+ "statusNote": "New in v4.1.0 - Subagent orchestration system",
327
+ "statusNoteZh": "v4.1.0 新增 - Subagent 編排系統",
328
+ "description": "Specialized AI subagents that can be orchestrated to handle complex development workflows",
329
+ "descriptionZh": "專門的 AI 子代理,可編排處理複雜的開發工作流程",
330
+ "basePath": "skills/claude-code/agents/",
331
+ "builtIn": [
332
+ {
333
+ "id": "code-architect",
334
+ "name": "Code Architect",
335
+ "nameZh": "程式碼架構師",
336
+ "source": "skills/claude-code/agents/code-architect.md",
337
+ "role": "specialist",
338
+ "expertise": ["system-design", "api-design", "database-modeling"],
339
+ "description": "Software architecture specialist for system design and technical planning"
340
+ },
341
+ {
342
+ "id": "test-specialist",
343
+ "name": "Test Specialist",
344
+ "nameZh": "測試專家",
345
+ "source": "skills/claude-code/agents/test-specialist.md",
346
+ "role": "specialist",
347
+ "expertise": ["test-strategy", "tdd", "bdd", "coverage-analysis"],
348
+ "description": "Testing strategy specialist for test design, coverage analysis, and quality assurance"
349
+ },
350
+ {
351
+ "id": "reviewer",
352
+ "name": "Code Reviewer",
353
+ "nameZh": "程式碼審查員",
354
+ "source": "skills/claude-code/agents/reviewer.md",
355
+ "role": "reviewer",
356
+ "expertise": ["code-review", "security-analysis", "best-practices"],
357
+ "description": "Code review specialist for quality assessment, security analysis, and best practices enforcement"
358
+ },
359
+ {
360
+ "id": "doc-writer",
361
+ "name": "Documentation Writer",
362
+ "nameZh": "文件撰寫員",
363
+ "source": "skills/claude-code/agents/doc-writer.md",
364
+ "role": "specialist",
365
+ "expertise": ["technical-writing", "api-documentation", "user-guides"],
366
+ "description": "Documentation specialist for technical writing, API docs, and user guides"
367
+ },
368
+ {
369
+ "id": "spec-analyst",
370
+ "name": "Specification Analyst",
371
+ "nameZh": "規格分析師",
372
+ "source": "skills/claude-code/agents/spec-analyst.md",
373
+ "role": "specialist",
374
+ "expertise": ["requirement-analysis", "specification-writing", "reverse-engineering"],
375
+ "description": "Specification analysis specialist for requirement extraction and spec generation"
376
+ }
377
+ ]
378
+ },
379
+ "workflows": {
380
+ "status": "experimental",
381
+ "statusNote": "New in v4.1.0 - Multi-agent workflow orchestration",
382
+ "statusNoteZh": "v4.1.0 新增 - 多代理工作流程編排",
383
+ "description": "Workflow definitions that orchestrate multiple agents for complex development tasks",
384
+ "descriptionZh": "編排多個代理處理複雜開發任務的工作流程定義",
385
+ "basePath": "skills/claude-code/workflows/",
386
+ "builtIn": [
387
+ {
388
+ "id": "integrated-flow",
389
+ "name": "Integrated Development Flow",
390
+ "nameZh": "整合開發流程",
391
+ "source": "skills/claude-code/workflows/integrated-flow.workflow.yaml",
392
+ "stages": 8,
393
+ "description": "Complete ATDD → SDD → BDD → TDD workflow"
394
+ },
395
+ {
396
+ "id": "feature-dev",
397
+ "name": "Feature Development",
398
+ "nameZh": "功能開發",
399
+ "source": "skills/claude-code/workflows/feature-dev.workflow.yaml",
400
+ "stages": 6,
401
+ "description": "Feature development workflow"
402
+ },
403
+ {
404
+ "id": "code-review",
405
+ "name": "Code Review Workflow",
406
+ "nameZh": "程式碼審查流程",
407
+ "source": "skills/claude-code/workflows/code-review.workflow.yaml",
408
+ "stages": 4,
409
+ "description": "Code review workflow"
410
+ }
411
+ ]
412
+ },
276
413
  "methodologies": {
277
414
  "status": "experimental",
278
415
  "statusNote": "Will be redesigned in v4.0",
@@ -389,6 +526,19 @@
389
526
  "level": 1,
390
527
  "description": "Guidelines for AI collaboration to prevent hallucination and ensure evidence-based responses"
391
528
  },
529
+ {
530
+ "id": "ai-friendly-architecture",
531
+ "name": "AI-Friendly Architecture",
532
+ "nameZh": "AI 友善架構",
533
+ "source": {
534
+ "human": "core/ai-friendly-architecture.md",
535
+ "ai": "ai/standards/ai-friendly-architecture.ai.yaml"
536
+ },
537
+ "category": "skill",
538
+ "skillName": "ai-collaboration-standards",
539
+ "level": 2,
540
+ "description": "Standards for designing project architecture that maximizes AI collaboration effectiveness"
541
+ },
392
542
  {
393
543
  "id": "commit-message",
394
544
  "name": "Commit Message Guide",
@@ -814,10 +964,10 @@
814
964
  "human": "core/refactoring-standards.md",
815
965
  "ai": "ai/standards/refactoring-standards.ai.yaml"
816
966
  },
817
- "category": "reference",
818
- "skillName": null,
967
+ "category": "skill",
968
+ "skillName": "refactoring-assistant",
819
969
  "level": 2,
820
- "description": "Comprehensive refactoring guidelines covering legacy code strategies, large-scale patterns, database refactoring, metrics, and team collaboration"
970
+ "description": "Comprehensive refactoring guidelines with tactical, strategic, and legacy code safety strategies including decision matrix"
821
971
  },
822
972
  {
823
973
  "id": "csharp-style",