create-vasvibe 2.4.0 → 2.5.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 (286) hide show
  1. package/README.md +170 -167
  2. package/bin/cli.mjs +9 -9
  3. package/package.json +45 -45
  4. package/src/git.mjs +47 -47
  5. package/src/index.mjs +228 -228
  6. package/src/prompts.mjs +113 -113
  7. package/src/scaffold.mjs +74 -74
  8. package/src/upgrade.mjs +121 -121
  9. package/src/utils.mjs +91 -91
  10. package/template/.agents/agents/analyst/agent.json +43 -43
  11. package/template/.agents/agents/backend/agent.json +44 -44
  12. package/template/.agents/agents/data-architect/agent.json +43 -43
  13. package/template/.agents/agents/devops/agent.json +44 -44
  14. package/template/.agents/agents/discovery/agent.json +43 -43
  15. package/template/.agents/agents/document/agent.json +43 -43
  16. package/template/.agents/agents/fixer/agent.json +44 -44
  17. package/template/.agents/agents/frontend/agent.json +44 -44
  18. package/template/.agents/agents/fullstack/agent.json +44 -44
  19. package/template/.agents/agents/initiator/agent.json +41 -41
  20. package/template/.agents/agents/{explorer → manual-tester}/agent.json +4 -3
  21. package/template/.agents/agents/orchestrator/agent.json +44 -44
  22. package/template/.agents/agents/pm/agent.json +42 -42
  23. package/template/.agents/agents/qa/agent.json +44 -44
  24. package/template/.agents/agents/reliability/agent.json +44 -44
  25. package/template/.agents/agents/security/agent.json +44 -44
  26. package/template/.agents/agents/sysarch/agent.json +44 -44
  27. package/template/.agents/agents/tester/agent.json +44 -44
  28. package/template/.agents/agents/toolsmith/agent.json +44 -44
  29. package/template/.agents/agents/ux-designer/agent.json +43 -43
  30. package/template/.agents/skills/find-skills/SKILL.md +142 -142
  31. package/template/.agents/skills/fullstack/SKILL.md +89 -89
  32. package/template/.agents/skills/penetration-testing/SKILL.md +94 -94
  33. package/template/.agents/skills/penetration-testing/references/automated-penetration-testing-framework.md +328 -328
  34. package/template/.agents/skills/penetration-testing/references/burp-suite-automation-script.md +135 -135
  35. package/template/.agents/skills/penetration-testing/scripts/security-checklist.sh +30 -30
  36. package/template/.agents/skills/pm/SKILL.md +170 -170
  37. package/template/.agents/skills/ui-ux-pro-max/SKILL.md +658 -658
  38. package/template/.agents/skills/ui-ux-pro-max/data/_sync_all.py +414 -414
  39. package/template/.agents/skills/ui-ux-pro-max/data/app-interface.csv +30 -30
  40. package/template/.agents/skills/ui-ux-pro-max/data/design.csv +1775 -1775
  41. package/template/.agents/skills/ui-ux-pro-max/data/draft.csv +1778 -1778
  42. package/template/.agents/skills/ui-ux-pro-max/data/icons.csv +105 -105
  43. package/template/.agents/skills/ui-ux-pro-max/data/products.csv +162 -162
  44. package/template/.agents/skills/ui-ux-pro-max/data/react-performance.csv +45 -45
  45. package/template/.agents/skills/ui-ux-pro-max/data/stacks/angular.csv +51 -51
  46. package/template/.agents/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -54
  47. package/template/.agents/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -53
  48. package/template/.agents/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -56
  49. package/template/.agents/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
  50. package/template/.agents/skills/ui-ux-pro-max/data/stacks/laravel.csv +51 -51
  51. package/template/.agents/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -53
  52. package/template/.agents/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
  53. package/template/.agents/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
  54. package/template/.agents/skills/ui-ux-pro-max/data/stacks/react.csv +54 -54
  55. package/template/.agents/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
  56. package/template/.agents/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -54
  57. package/template/.agents/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -51
  58. package/template/.agents/skills/ui-ux-pro-max/data/stacks/threejs.csv +54 -54
  59. package/template/.agents/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -50
  60. package/template/.agents/skills/ui-ux-pro-max/data/typography.csv +74 -74
  61. package/template/.agents/skills/ui-ux-pro-max/scripts/core.py +262 -262
  62. package/template/.agents/skills/ui-ux-pro-max/scripts/design_system.py +1148 -1148
  63. package/template/.agents/workflows/build-feature.md +21 -21
  64. package/template/.agents/workflows/daily-standup.md +16 -16
  65. package/template/.agents/workflows/deliver-feature.md +16 -16
  66. package/template/.agents/workflows/harden-release.md +21 -21
  67. package/template/.agents/workflows/plan-project.md +25 -25
  68. package/template/.agents/workflows/release.md +18 -18
  69. package/template/.agents/workflows/security-audit.md +19 -19
  70. package/template/.agents/workflows/setup-workspace.md +21 -21
  71. package/template/.agents/workflows/start-fix.md +17 -18
  72. package/template/.agents/workflows/test-feature.md +17 -17
  73. package/template/.claude/agents/analyst.md +75 -104
  74. package/template/.claude/agents/backend.md +61 -61
  75. package/template/.claude/agents/data-architect.md +43 -43
  76. package/template/.claude/agents/devops.md +44 -43
  77. package/template/.claude/agents/discovery.md +51 -51
  78. package/template/.claude/agents/document.md +51 -51
  79. package/template/.claude/agents/fixer.md +83 -81
  80. package/template/.claude/agents/frontend.md +58 -60
  81. package/template/.claude/agents/fullstack.md +84 -85
  82. package/template/.claude/agents/initiator.md +74 -74
  83. package/template/.claude/agents/manual-tester.md +108 -0
  84. package/template/.claude/agents/orchestrator.md +115 -133
  85. package/template/.claude/agents/pm.md +199 -199
  86. package/template/.claude/agents/qa.md +66 -65
  87. package/template/.claude/agents/reliability.md +48 -47
  88. package/template/.claude/agents/security.md +107 -106
  89. package/template/.claude/agents/sysarch.md +301 -301
  90. package/template/.claude/agents/tester.md +100 -100
  91. package/template/.claude/agents/toolsmith.md +77 -76
  92. package/template/.claude/agents/ux-designer.md +45 -45
  93. package/template/.claude/commands/build-feature.md +22 -22
  94. package/template/.claude/commands/daily-standup.md +16 -16
  95. package/template/.claude/commands/deliver-feature.md +17 -17
  96. package/template/.claude/commands/harden-release.md +22 -22
  97. package/template/.claude/commands/manual-test.md +19 -0
  98. package/template/.claude/commands/plan-project.md +26 -26
  99. package/template/.claude/commands/release.md +19 -19
  100. package/template/.claude/commands/security-audit.md +20 -20
  101. package/template/.claude/commands/setup-workspace.md +22 -22
  102. package/template/.claude/commands/start-fix.md +18 -19
  103. package/template/.claude/commands/test-feature.md +18 -18
  104. package/template/.claude/skills/find-skills +1 -0
  105. package/template/.claude/skills/penetration-testing/SKILL.md +94 -94
  106. package/template/.claude/skills/penetration-testing/references/automated-penetration-testing-framework.md +328 -328
  107. package/template/.claude/skills/penetration-testing/references/burp-suite-automation-script.md +135 -135
  108. package/template/.claude/skills/penetration-testing/scripts/security-checklist.sh +30 -30
  109. package/template/.claude/skills/ui-ux-pro-max/SKILL.md +658 -658
  110. package/template/.claude/skills/ui-ux-pro-max/data/_sync_all.py +414 -414
  111. package/template/.claude/skills/ui-ux-pro-max/data/app-interface.csv +30 -30
  112. package/template/.claude/skills/ui-ux-pro-max/data/design.csv +1775 -1775
  113. package/template/.claude/skills/ui-ux-pro-max/data/draft.csv +1778 -1778
  114. package/template/.claude/skills/ui-ux-pro-max/data/icons.csv +105 -105
  115. package/template/.claude/skills/ui-ux-pro-max/data/products.csv +162 -162
  116. package/template/.claude/skills/ui-ux-pro-max/data/react-performance.csv +45 -45
  117. package/template/.claude/skills/ui-ux-pro-max/data/stacks/angular.csv +51 -51
  118. package/template/.claude/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -54
  119. package/template/.claude/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -53
  120. package/template/.claude/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -56
  121. package/template/.claude/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
  122. package/template/.claude/skills/ui-ux-pro-max/data/stacks/laravel.csv +51 -51
  123. package/template/.claude/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -53
  124. package/template/.claude/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
  125. package/template/.claude/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
  126. package/template/.claude/skills/ui-ux-pro-max/data/stacks/react.csv +54 -54
  127. package/template/.claude/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
  128. package/template/.claude/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -54
  129. package/template/.claude/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -51
  130. package/template/.claude/skills/ui-ux-pro-max/data/stacks/threejs.csv +54 -54
  131. package/template/.claude/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -50
  132. package/template/.claude/skills/ui-ux-pro-max/data/typography.csv +74 -74
  133. package/template/.claude/skills/ui-ux-pro-max/scripts/core.py +262 -262
  134. package/template/.claude/skills/ui-ux-pro-max/scripts/design_system.py +1148 -1148
  135. package/template/.github/prompts/analyst.prompt.md +58 -104
  136. package/template/.github/prompts/backend.prompt.md +44 -44
  137. package/template/.github/prompts/data-architect.prompt.md +38 -38
  138. package/template/.github/prompts/devops.prompt.md +32 -32
  139. package/template/.github/prompts/discovery.prompt.md +39 -39
  140. package/template/.github/prompts/document.prompt.md +14 -14
  141. package/template/.github/prompts/fixer.prompt.md +91 -81
  142. package/template/.github/prompts/frontend.prompt.md +43 -60
  143. package/template/.github/prompts/fullstack.prompt.md +92 -86
  144. package/template/.github/prompts/initiator.prompt.md +55 -55
  145. package/template/.github/prompts/manual-tester.prompt.md +103 -0
  146. package/template/.github/prompts/orchestrator.prompt.md +75 -133
  147. package/template/.github/prompts/pm.prompt.md +186 -186
  148. package/template/.github/prompts/qa.prompt.md +57 -57
  149. package/template/.github/prompts/reliability.prompt.md +44 -44
  150. package/template/.github/prompts/security.prompt.md +41 -41
  151. package/template/.github/prompts/sysarch.prompt.md +351 -351
  152. package/template/.github/prompts/tester.prompt.md +107 -107
  153. package/template/.github/prompts/toolsmith.prompt.md +46 -46
  154. package/template/.github/prompts/ux-designer.prompt.md +41 -41
  155. package/template/.opencode/agents/analyst.md +75 -104
  156. package/template/.opencode/agents/backend.md +61 -61
  157. package/template/.opencode/agents/data-architect.md +43 -43
  158. package/template/.opencode/agents/devops.md +44 -44
  159. package/template/.opencode/agents/discovery.md +51 -51
  160. package/template/.opencode/agents/document.md +51 -51
  161. package/template/.opencode/agents/fixer.md +83 -81
  162. package/template/.opencode/agents/frontend.md +59 -61
  163. package/template/.opencode/agents/fullstack.md +84 -85
  164. package/template/.opencode/agents/initiator.md +74 -74
  165. package/template/.opencode/agents/manual-tester.md +107 -0
  166. package/template/.opencode/agents/orchestrator.md +116 -131
  167. package/template/.opencode/agents/pm.md +199 -199
  168. package/template/.opencode/agents/qa.md +66 -65
  169. package/template/.opencode/agents/reliability.md +48 -48
  170. package/template/.opencode/agents/security.md +107 -107
  171. package/template/.opencode/agents/sysarch.md +301 -301
  172. package/template/.opencode/agents/tester.md +100 -100
  173. package/template/.opencode/agents/toolsmith.md +77 -77
  174. package/template/.opencode/agents/ux-designer.md +45 -45
  175. package/template/.opencode/commands/build-feature.md +21 -21
  176. package/template/.opencode/commands/daily-standup.md +16 -16
  177. package/template/.opencode/commands/deliver-feature.md +16 -16
  178. package/template/.opencode/commands/harden-release.md +21 -21
  179. package/template/.opencode/commands/manual-test.md +18 -0
  180. package/template/.opencode/commands/plan-project.md +25 -25
  181. package/template/.opencode/commands/release.md +18 -18
  182. package/template/.opencode/commands/security-audit.md +19 -19
  183. package/template/.opencode/commands/setup-workspace.md +21 -21
  184. package/template/.opencode/commands/start-fix.md +17 -18
  185. package/template/.opencode/commands/test-feature.md +17 -17
  186. package/template/.opencode/skills/penetration-testing/SKILL.md +94 -94
  187. package/template/.opencode/skills/penetration-testing/references/automated-penetration-testing-framework.md +328 -328
  188. package/template/.opencode/skills/penetration-testing/references/burp-suite-automation-script.md +135 -135
  189. package/template/.opencode/skills/penetration-testing/scripts/security-checklist.sh +30 -30
  190. package/template/.opencode/skills/ui-ux-pro-max/SKILL.md +658 -658
  191. package/template/.opencode/skills/ui-ux-pro-max/data/_sync_all.py +414 -414
  192. package/template/.opencode/skills/ui-ux-pro-max/data/app-interface.csv +30 -30
  193. package/template/.opencode/skills/ui-ux-pro-max/data/design.csv +1775 -1775
  194. package/template/.opencode/skills/ui-ux-pro-max/data/draft.csv +1778 -1778
  195. package/template/.opencode/skills/ui-ux-pro-max/data/icons.csv +105 -105
  196. package/template/.opencode/skills/ui-ux-pro-max/data/products.csv +162 -162
  197. package/template/.opencode/skills/ui-ux-pro-max/data/react-performance.csv +45 -45
  198. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/angular.csv +51 -51
  199. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -54
  200. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -53
  201. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -56
  202. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
  203. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/laravel.csv +51 -51
  204. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -53
  205. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
  206. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
  207. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/react.csv +54 -54
  208. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
  209. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -54
  210. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -51
  211. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/threejs.csv +54 -54
  212. package/template/.opencode/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -50
  213. package/template/.opencode/skills/ui-ux-pro-max/data/typography.csv +74 -74
  214. package/template/.opencode/skills/ui-ux-pro-max/scripts/core.py +262 -262
  215. package/template/.opencode/skills/ui-ux-pro-max/scripts/design_system.py +1148 -1148
  216. package/template/AGENT_PERSONAS.md +595 -551
  217. package/template/GIT_STRUCTURE_GUIDE.md +270 -270
  218. package/template/PROJECT_README.example.md +81 -81
  219. package/template/QUICK-START.md +134 -131
  220. package/template/README.md +1942 -1919
  221. package/template/_gitignore +141 -138
  222. package/template/agent/workflows/_shared/change-management.md +70 -70
  223. package/template/agent/workflows/_shared/git-branch-management.md +25 -25
  224. package/template/agent/workflows/_shared/phases.md +88 -88
  225. package/template/agent/workflows/_shared/state-management.md +87 -87
  226. package/template/agent/workflows/_shared/work-depth.md +46 -46
  227. package/template/agent/workflows/analyst.md +75 -104
  228. package/template/agent/workflows/backend.md +61 -61
  229. package/template/agent/workflows/data-architect.md +43 -43
  230. package/template/agent/workflows/devops.md +44 -44
  231. package/template/agent/workflows/discovery.md +51 -51
  232. package/template/agent/workflows/document.md +51 -51
  233. package/template/agent/workflows/fixer.md +83 -81
  234. package/template/agent/workflows/frontend.md +58 -60
  235. package/template/agent/workflows/fullstack.md +84 -86
  236. package/template/agent/workflows/initiator.md +74 -74
  237. package/template/agent/workflows/manual-tester.md +103 -0
  238. package/template/agent/workflows/orchestrator.md +114 -133
  239. package/template/agent/workflows/pm.md +199 -199
  240. package/template/agent/workflows/qa.md +66 -66
  241. package/template/agent/workflows/reliability.md +48 -48
  242. package/template/agent/workflows/security.md +107 -107
  243. package/template/agent/workflows/sysarch.md +301 -301
  244. package/template/agent/workflows/tester.md +100 -100
  245. package/template/agent/workflows/toolsmith.md +77 -77
  246. package/template/agent/workflows/ux-designer.md +45 -45
  247. package/template/codes/.gitkeep +1 -1
  248. package/template/project_overview_example.md +54 -54
  249. package/template/schemas/adr.template.md +36 -36
  250. package/template/schemas/changelog.template.md +34 -34
  251. package/template/schemas/data-model.template.md +57 -57
  252. package/template/schemas/design-system.template.md +63 -63
  253. package/template/schemas/dev_log.template.md +20 -20
  254. package/template/schemas/product-ci.template.yml +50 -50
  255. package/template/schemas/requirements.template.md +64 -64
  256. package/template/schemas/security-standards.template.md +58 -58
  257. package/template/schemas/security_report.template.md +89 -89
  258. package/template/schemas/specification.template.md +57 -71
  259. package/template/schemas/style_guide.template.md +29 -29
  260. package/template/schemas/task_list.template.md +28 -28
  261. package/template/schemas/workspace-manifest.template.json +24 -24
  262. package/template/schemas/workspace-registry.json +94 -95
  263. package/template/skills-lock.json +11 -11
  264. package/template/specifications/.gitkeep +1 -3
  265. package/template/state/knowledge_base/.gitkeep +1 -1
  266. package/template/state/knowledge_base/requirements/.gitkeep +1 -1
  267. package/template/tests/.gitkeep +1 -1
  268. package/template/.agents/agents/logger/agent.json +0 -43
  269. package/template/.agents/workflows/build-prototype.md +0 -32
  270. package/template/.agents/workflows/explorer.md +0 -78
  271. package/template/.agents/workflows/logger.md +0 -117
  272. package/template/.agents/workflows/plan-feature.md +0 -30
  273. package/template/.claude/agents/explorer.md +0 -138
  274. package/template/.claude/agents/logger.md +0 -143
  275. package/template/.claude/commands/build-prototype.md +0 -33
  276. package/template/.claude/commands/plan-feature.md +0 -31
  277. package/template/.claude/settings.local.json +0 -44
  278. package/template/.claude/skills/find-skills/SKILL.md +0 -142
  279. package/template/.github/prompts/explorer.prompt.md +0 -133
  280. package/template/.github/prompts/logger.prompt.md +0 -138
  281. package/template/.opencode/agents/explorer.md +0 -137
  282. package/template/.opencode/agents/logger.md +0 -142
  283. package/template/.opencode/commands/build-prototype.md +0 -32
  284. package/template/.opencode/commands/plan-feature.md +0 -30
  285. package/template/agent/workflows/explorer.md +0 -133
  286. package/template/agent/workflows/logger.md +0 -138
@@ -1,95 +1,94 @@
1
- {
2
- "version": 1,
3
- "description": "Curated registry for the Toolsmith agent. Maps project needs (tech stack / phase) to recommended skills + MCP servers, and encodes how to write MCP config for each AI tool platform. Toolsmith reads this as the DEFAULT catalog, then may augment via requirements + find-skills.",
4
-
5
- "stackMappings": {
6
- "_comment": "tech-stack / capability keyword -> recommended skills + mcp ids. Match loosely (case-insensitive substring) against project_overview tech stack & key features.",
7
- "ui|frontend|react|next|nextjs|vue|svelte|tailwind|shadcn": { "skills": ["ui-ux-pro-max"], "mcp": ["shadcn"] },
8
- "prototype|mockup|wireframe|demo": { "skills": ["ui-ux-pro-max", "theme-factory"], "mcp": ["shadcn"] },
9
- "postgres|postgresql|prisma|sql|database": { "skills": [], "mcp": ["postgres"] },
10
- "e2e|test|testing|playwright|qa": { "skills": [], "mcp": ["playwright"] },
11
- "security|auth|oauth|pentest|owasp": { "skills": ["penetration-testing"], "mcp": [] },
12
- "*": { "skills": ["find-skills"], "mcp": ["filesystem", "git", "fetch"] }
13
- },
14
-
15
- "mcpCatalog": {
16
- "_comment": "Common, safe MCP servers. command/args are indicative starting points — Toolsmith MUST verify the current invocation against the live MCP registry (or each server's README) before applying, since package names drift. `runtime` notes whether it ships via npx (Node) or uvx (Python).",
17
- "filesystem": {
18
- "description": "Read/write files within allowed roots — grounds the agent in the workspace.",
19
- "runtime": "npx",
20
- "command": "npx",
21
- "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
22
- "env": {}
23
- },
24
- "git": {
25
- "description": "Inspect git history, diffs, and status — context for code-aware agents.",
26
- "runtime": "uvx",
27
- "command": "uvx",
28
- "args": ["mcp-server-git"],
29
- "env": {}
30
- },
31
- "fetch": {
32
- "description": "Fetch and convert web content (docs, references) into agent-readable text.",
33
- "runtime": "uvx",
34
- "command": "uvx",
35
- "args": ["mcp-server-fetch"],
36
- "env": {}
37
- },
38
- "postgres": {
39
- "description": "Query a Postgres database (schema introspection, read queries). Set POSTGRES_URL.",
40
- "runtime": "npx",
41
- "command": "npx",
42
- "args": ["-y", "@modelcontextprotocol/server-postgres", "${POSTGRES_URL}"],
43
- "env": { "POSTGRES_URL": "${POSTGRES_URL}" }
44
- },
45
- "playwright": {
46
- "description": "Drive a real browser for E2E testing & verification (Tester agent).",
47
- "runtime": "npx",
48
- "command": "npx",
49
- "args": ["-y", "@playwright/mcp@latest"],
50
- "env": {}
51
- },
52
- "shadcn": {
53
- "description": "Search & pull shadcn/ui component examples — pairs with ui-ux-pro-max skill. Verify current invocation (e.g. `npx shadcn@latest mcp`) before applying.",
54
- "runtime": "npx",
55
- "command": "npx",
56
- "args": ["-y", "shadcn@latest", "mcp"],
57
- "env": {}
58
- }
59
- },
60
-
61
- "platformTargets": {
62
- "_comment": "How to write MCP config declaratively for each tool. `file` is project-relative. `topLevelKey` is the JSON key holding servers. `entryShape` documents the per-server object shape; substitute command/args/env from mcpCatalog.",
63
- "claude-code": {
64
- "detect": [".claude/", ".mcp.json"],
65
- "file": ".mcp.json",
66
- "topLevelKey": "mcpServers",
67
- "entryShape": { "command": "<command>", "args": ["<args>"], "env": {} },
68
- "skillsDir": ".claude/skills/"
69
- },
70
- "opencode": {
71
- "detect": [".opencode/", "opencode.json"],
72
- "file": "opencode.json",
73
- "topLevelKey": "mcp",
74
- "entryShape": { "type": "local", "command": ["<command>", "<args>"], "enabled": true, "environment": {} },
75
- "skillsDir": ".opencode/skills/",
76
- "note": "OpenCode merges command+args into a single `command` array and uses `environment` (not `env`). Include \"$schema\": \"https://opencode.ai/config.json\" at the root."
77
- },
78
- "antigravity": {
79
- "detect": [".agents/"],
80
- "file": ".agents/mcp.json",
81
- "topLevelKey": "mcpServers",
82
- "entryShape": { "command": "<command>", "args": ["<args>"], "env": {} },
83
- "skillsDir": ".agents/skills/",
84
- "note": "Antigravity uses an mcpServers-shaped config. Confirm the exact path your Antigravity build reads (workspace vs global) with the human; .agents/mcp.json is the project-local default."
85
- },
86
- "github-copilot": {
87
- "detect": [".github/prompts/", ".vscode/"],
88
- "file": ".vscode/mcp.json",
89
- "topLevelKey": "servers",
90
- "entryShape": { "command": "<command>", "args": ["<args>"], "env": {} },
91
- "skillsDir": null,
92
- "note": "Copilot/VS Code uses the `servers` key (not `mcpServers`). Copilot has no skills dir — skills are Claude/OpenCode/Antigravity only."
93
- }
94
- }
95
- }
1
+ {
2
+ "version": 1,
3
+ "description": "Curated registry for the Toolsmith agent. Maps project needs (tech stack / phase) to recommended skills + MCP servers, and encodes how to write MCP config for each AI tool platform. Toolsmith reads this as the DEFAULT catalog, then may augment via requirements + find-skills.",
4
+
5
+ "stackMappings": {
6
+ "_comment": "tech-stack / capability keyword -> recommended skills + mcp ids. Match loosely (case-insensitive substring) against project_overview tech stack & key features.",
7
+ "ui|frontend|react|next|nextjs|vue|svelte|tailwind|shadcn": { "skills": ["ui-ux-pro-max"], "mcp": ["shadcn"] },
8
+ "postgres|postgresql|prisma|sql|database": { "skills": [], "mcp": ["postgres"] },
9
+ "e2e|test|testing|playwright|qa": { "skills": [], "mcp": ["playwright"] },
10
+ "security|auth|oauth|pentest|owasp": { "skills": ["penetration-testing"], "mcp": [] },
11
+ "*": { "skills": ["find-skills"], "mcp": ["filesystem", "git", "fetch"] }
12
+ },
13
+
14
+ "mcpCatalog": {
15
+ "_comment": "Common, safe MCP servers. command/args are indicative starting points — Toolsmith MUST verify the current invocation against the live MCP registry (or each server's README) before applying, since package names drift. `runtime` notes whether it ships via npx (Node) or uvx (Python).",
16
+ "filesystem": {
17
+ "description": "Read/write files within allowed roots — grounds the agent in the workspace.",
18
+ "runtime": "npx",
19
+ "command": "npx",
20
+ "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
21
+ "env": {}
22
+ },
23
+ "git": {
24
+ "description": "Inspect git history, diffs, and status — context for code-aware agents.",
25
+ "runtime": "uvx",
26
+ "command": "uvx",
27
+ "args": ["mcp-server-git"],
28
+ "env": {}
29
+ },
30
+ "fetch": {
31
+ "description": "Fetch and convert web content (docs, references) into agent-readable text.",
32
+ "runtime": "uvx",
33
+ "command": "uvx",
34
+ "args": ["mcp-server-fetch"],
35
+ "env": {}
36
+ },
37
+ "postgres": {
38
+ "description": "Query a Postgres database (schema introspection, read queries). Set POSTGRES_URL.",
39
+ "runtime": "npx",
40
+ "command": "npx",
41
+ "args": ["-y", "@modelcontextprotocol/server-postgres", "${POSTGRES_URL}"],
42
+ "env": { "POSTGRES_URL": "${POSTGRES_URL}" }
43
+ },
44
+ "playwright": {
45
+ "description": "Drive a real browser for E2E testing & verification (Tester agent).",
46
+ "runtime": "npx",
47
+ "command": "npx",
48
+ "args": ["-y", "@playwright/mcp@latest"],
49
+ "env": {}
50
+ },
51
+ "shadcn": {
52
+ "description": "Search & pull shadcn/ui component examples — pairs with ui-ux-pro-max skill. Verify current invocation (e.g. `npx shadcn@latest mcp`) before applying.",
53
+ "runtime": "npx",
54
+ "command": "npx",
55
+ "args": ["-y", "shadcn@latest", "mcp"],
56
+ "env": {}
57
+ }
58
+ },
59
+
60
+ "platformTargets": {
61
+ "_comment": "How to write MCP config declaratively for each tool. `file` is project-relative. `topLevelKey` is the JSON key holding servers. `entryShape` documents the per-server object shape; substitute command/args/env from mcpCatalog.",
62
+ "claude-code": {
63
+ "detect": [".claude/", ".mcp.json"],
64
+ "file": ".mcp.json",
65
+ "topLevelKey": "mcpServers",
66
+ "entryShape": { "command": "<command>", "args": ["<args>"], "env": {} },
67
+ "skillsDir": ".claude/skills/"
68
+ },
69
+ "opencode": {
70
+ "detect": [".opencode/", "opencode.json"],
71
+ "file": "opencode.json",
72
+ "topLevelKey": "mcp",
73
+ "entryShape": { "type": "local", "command": ["<command>", "<args>"], "enabled": true, "environment": {} },
74
+ "skillsDir": ".opencode/skills/",
75
+ "note": "OpenCode merges command+args into a single `command` array and uses `environment` (not `env`). Include \"$schema\": \"https://opencode.ai/config.json\" at the root."
76
+ },
77
+ "antigravity": {
78
+ "detect": [".agents/"],
79
+ "file": ".agents/mcp.json",
80
+ "topLevelKey": "mcpServers",
81
+ "entryShape": { "command": "<command>", "args": ["<args>"], "env": {} },
82
+ "skillsDir": ".agents/skills/",
83
+ "note": "Antigravity uses an mcpServers-shaped config. Confirm the exact path your Antigravity build reads (workspace vs global) with the human; .agents/mcp.json is the project-local default."
84
+ },
85
+ "github-copilot": {
86
+ "detect": [".github/prompts/", ".vscode/"],
87
+ "file": ".vscode/mcp.json",
88
+ "topLevelKey": "servers",
89
+ "entryShape": { "command": "<command>", "args": ["<args>"], "env": {} },
90
+ "skillsDir": null,
91
+ "note": "Copilot/VS Code uses the `servers` key (not `mcpServers`). Copilot has no skills dir — skills are Claude/OpenCode/Antigravity only."
92
+ }
93
+ }
94
+ }
@@ -1,11 +1,11 @@
1
- {
2
- "version": 1,
3
- "skills": {
4
- "find-skills": {
5
- "source": "vercel-labs/skills",
6
- "sourceType": "github",
7
- "skillPath": "skills/find-skills/SKILL.md",
8
- "computedHash": "9e1c8b3103f92fa8092568a44fe64858de7c5c9dc65ce4bea8f168080e889cfd"
9
- }
10
- }
11
- }
1
+ {
2
+ "version": 1,
3
+ "skills": {
4
+ "find-skills": {
5
+ "source": "vercel-labs/skills",
6
+ "sourceType": "github",
7
+ "skillPath": "skills/find-skills/SKILL.md",
8
+ "computedHash": "9e1c8b3103f92fa8092568a44fe64858de7c5c9dc65ce4bea8f168080e889cfd"
9
+ }
10
+ }
11
+ }
@@ -1,3 +1 @@
1
- # Keeps the specifications/ folder in the repository.
2
- # Specification files generated by the Analyst agent (e.g. 000_spec_environment_setup.md)
3
- # ARE tracked and should be committed — they are the source of truth for development.
1
+ # Place specification documents here. The contents of this folder are gitignored by default.
@@ -1 +1 @@
1
- # Keep this directory for storing agent bug-fixes patterns and learnings.
1
+ # Keep this directory for storing agent bug-fixes patterns and learnings.
@@ -1 +1 @@
1
- # Keep this folder tracked by git
1
+ # Keep this folder tracked by git
@@ -1 +1 @@
1
- # Place test files here. The contents of this folder are gitignored by default.
1
+ # Place test files here. The contents of this folder are gitignored by default.
@@ -1,43 +0,0 @@
1
- {
2
- "name": "logger",
3
- "description": "Change Logger. Records session changes into the appropriate task log.",
4
- "hidden": true,
5
- "config": {
6
- "customAgent": {
7
- "systemPromptSections": [
8
- {
9
- "title": "Agent System Instructions",
10
- "content": "You are the logger Agent. Read and follow ALL instructions in agent/workflows/logger.md as your complete system prompt. That file is your source of truth."
11
- }
12
- ],
13
- "toolNames": [
14
- "send_message",
15
- "find_by_name",
16
- "grep_search",
17
- "view_file",
18
- "list_dir",
19
- "read_url_content",
20
- "search_web",
21
- "schedule",
22
- "multi_replace_file_content",
23
- "replace_file_content",
24
- "write_to_file",
25
- "manage_task",
26
- "define_subagent",
27
- "invoke_subagent",
28
- "manage_subagents"
29
- ],
30
- "systemPromptConfig": {
31
- "includeSections": [
32
- "user_information",
33
- "mcp_servers",
34
- "skills",
35
- "subagent_reminder",
36
- "messaging",
37
- "artifacts",
38
- "user_rules"
39
- ]
40
- }
41
- }
42
- }
43
- }
@@ -1,32 +0,0 @@
1
- ---
2
- description: Bangun prototipe UI/UX cepat (frontend-only, data mock) untuk presentasi/menyepakati desain dengan klien — tanpa backend.
3
- ---
4
-
5
- Jalankan **Build Prototype** — prototipe UI/UX cepat untuk: **$ARGUMENTS**
6
-
7
- > **Tujuan:** menampilkan tampilan aplikasi secepatnya untuk presentasi ke klien / menyepakati UI-UX — BUKAN produk jadi. **Frontend saja: tanpa backend, tanpa API nyata, tanpa database.** Data di-mock/fixture. Ini artefak demo (throwaway) yang bisa diganti; jangan diperlakukan sebagai implementasi final.
8
-
9
- **DI LUAR RUANG LINGKUP (jangan dikerjakan):** business logic, persistensi data, integrasi API nyata, autentikasi nyata, dan test fungsional. Untuk implementasi sungguhan gunakan `/build-feature`.
10
-
11
- Langkah:
12
- 0. **Provisioning (Toolsmith)** → pastikan skill + MCP untuk prototyping terpasang di tool aktif: skill `ui-ux-pro-max` + `theme-factory`, MCP `shadcn`. Sumber acuan `state/workspace-manifest.json` + `schemas/workspace-registry.json` (mapping `prototype`). Skip cepat jika sudah ter-apply.
13
- 1. **Brief Prototipe (INTERAKTIF — JANGAN delegasikan ke subagent)** → klarifikasi cepat dengan human di thread utama: layar/alur apa yang mau ditunjukkan, urutan navigasi antar-layar, dan referensi visual (brand/warna/mood) jika ada. Ringkas — bukan wawancara kebutuhan penuh.
14
- - *(Opsional, pra-kode)* Untuk menyepakati layout/hierarki lebih dulu tanpa menulis kode, boleh pakai mockup inline (skill/tool `visualize`) atau aset visual (Canva) **bila tool aktif menyediakannya** — ini opsional, bukan dependensi.
15
- 2. **Arah Visual (pilih satu):**
16
- - `state/knowledge_base/design-system/` **sudah ada** → pakai sebagai acuan, lewati langkah ini.
17
- - Belum ada & butuh **kilat** → gunakan skill **`theme-factory`** untuk menetapkan tema global (palette + font) instan.
18
- - Belum ada & mau **lebih rapi** → delegasikan ke **UX Designer** (mode `fast`) untuk palette + tipografi + token dasar via `ui-ux-pro-max`.
19
- 3. **Frontend Engineer (mode PROTOTYPE)** → bangun UI di `codes/`:
20
- - Frontend-only, **tanpa panggilan backend** — gunakan data **mock/fixture statis**.
21
- - **Tooling (komplementer):** `theme-factory` untuk tema global (bila belum ada design-system) · `ui-ux-pro-max` untuk pola, layout & kualitas komponen · MCP `shadcn` untuk menarik komponen jadi bila tersedia. Ikuti `design-system/` bila ada.
22
- - Bangun semua layar yang disepakati + **navigasi antar-layar yang clickable** agar bisa didemokan.
23
- - Tampilkan variasi state (empty/loading/success) sebagai tampilan statis bila relevan — tanpa logika nyata.
24
- - **Lewati unit test dan integrasi API.**
25
- 4. **CHECKPOINT — Demo ke klien:** **Jalankan dev server** prototipe dan tampilkan ke human/klien; kumpulkan feedback UI/UX. **Iterasi langkah 3** sampai desain disepakati.
26
- 5. **Output:** prototipe frontend yang bisa dijalankan untuk presentasi + catatan kesepakatan UI/UX (masukan untuk `design-system/` atau spec berikutnya).
27
-
28
- **Aturan orkestrasi (WAJIB):**
29
- - Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent (Task tool Claude Code / agent invocation OpenCode).
30
- - **BERHENTI di CHECKPOINT** untuk feedback klien sebelum iterasi atau menyelesaikan.
31
- - Ini alur **di luar 4 fase** (throwaway/demo) — JANGAN buat spec, API Contract, atau backend. Jika klien setuju dan ingin lanjut ke produk, arahkan ke `/plan-feature` (fitur) atau `/plan-project` (proyek baru).
32
- - Definisi kanonik pipeline: `agent/workflows/orchestrator.md`. Model fase: `agent/workflows/_shared/phases.md`.
@@ -1,78 +0,0 @@
1
- # Explorer Agent — Workflow Detail
2
-
3
- **Role:** Senior Software Architect & Code Analyst
4
- **Trigger:** `/explore-codebase` atau dipanggil Orchestrator sebelum `/build-feature` pada project existing.
5
- **Input:** Codebase yang sudah ada di folder `codes/`
6
- **Output:** `project_overview.md`, `state/knowledge_base/codebase/inventory.md`, `state/context.json`
7
-
8
- ---
9
-
10
- ## Kapan Menggunakan Explorer?
11
-
12
- Gunakan Explorer (bukan Discovery + Initiator) ketika:
13
- - Kamu **bergabung ke project yang sudah berjalan** dan perlu memahami kondisinya sebelum mengerjakan fitur baru.
14
- - Ada **handover codebase** dari tim lain dan tidak ada dokumentasi overview.
15
- - Kamu ingin **memverifikasi** apakah `project_overview.md` yang ada masih akurat dengan kode terkini.
16
- - Sebelum menjalankan `/build-feature` atau `/start-fix` pada project existing yang belum punya state.
17
-
18
- ---
19
-
20
- ## Alur Kerja
21
-
22
- ```
23
- codes/ exists?
24
-
25
- ├─ YES → Explorer baca kode → tulis project_overview.md + inventory + context.json
26
- │ │
27
- │ └─ Human review → lanjut ke /build-feature atau /start-fix
28
-
29
- └─ NO → Arahkan ke /plan-project (project baru, mulai dari Discovery)
30
- ```
31
-
32
- ---
33
-
34
- ## Dokumen yang Dihasilkan
35
-
36
- | Dokumen | Path | Deskripsi |
37
- |---------|------|-----------|
38
- | Project Overview | `project_overview.md` | Tech stack, fitur, design system — disintesis dari kode |
39
- | Codebase Inventory | `state/knowledge_base/codebase/inventory.md` | Daftar API endpoints, data models, file penting |
40
- | Context State | `state/context.json` | Status project saat ini untuk kontinuitas antar-session |
41
-
42
- ---
43
-
44
- ## Panduan Membaca Kode per Stack
45
-
46
- ### Node.js / TypeScript (Next.js, Express, NestJS)
47
- - Root: `package.json`, `tsconfig.json`, `.env.example`
48
- - Routes: `src/routes/`, `src/app/api/`, `pages/api/`, `src/controllers/`
49
- - Models: `prisma/schema.prisma`, `src/models/`, `src/entities/`
50
- - Config: `src/config/`, `next.config.js`, `nest-cli.json`
51
-
52
- ### Python (FastAPI, Django, Flask)
53
- - Root: `pyproject.toml`, `requirements.txt`, `setup.py`
54
- - Routes: `app/routers/`, `app/views.py`, `urls.py`
55
- - Models: `app/models.py`, `alembic/versions/`
56
- - Config: `app/config.py`, `settings.py`
57
-
58
- ### Go
59
- - Root: `go.mod`, `go.sum`
60
- - Routes: `internal/handler/`, `internal/api/`, `cmd/`
61
- - Models: `internal/domain/`, `internal/model/`
62
- - DB: `internal/repository/`, migration files
63
-
64
- ### Mobile (Flutter, React Native)
65
- - Root: `pubspec.yaml` atau `package.json`
66
- - Screens: `lib/screens/`, `src/screens/`
67
- - State: `lib/providers/`, `lib/bloc/`, `src/store/`
68
- - API: `lib/services/`, `src/api/`
69
-
70
- ---
71
-
72
- ## Output Quality Rules
73
-
74
- 1. **Jangan berasumsi** — setiap klaim HARUS dari file yang dibaca. Tandai dengan `[confirmed]`, `[inferred]`, atau `[unknown]`.
75
- 2. **Inventarisasi endpoints lengkap** — jangan skip; ini akan dipakai Analyst untuk API Contract.
76
- 3. **Tandai incomplete features** — gunakan `[~]` untuk partial, `[ ]` untuk planned/TODO.
77
- 4. **Catat technical debt** — tulis di `notes` field `context.json` agar agent berikutnya tahu.
78
- 5. **Jangan timpa state yang masih valid** — jika `state/context.json` sudah ada dan masih relevan, merge informasi baru ke dalamnya.
@@ -1,117 +0,0 @@
1
- # Logger Agent — Workflow Detail
2
-
3
- **Role:** Technical Change Recorder & Analyst
4
- **Trigger:** Dipanggil kapan saja oleh human — *"catat perubahan ini"*, *"log apa yang baru saja terjadi"*, atau cukup *"logger"*.
5
- **Input:** Deskripsi perubahan dari human, dan/atau analisa sesi / kode secara mandiri
6
- **Output:** Entry baru di `task/[TASK-ID]/dev_log.md` + baris baru di Status Log task detail file
7
-
8
- ---
9
-
10
- ## Kapan Memanggil Logger?
11
-
12
- | Situasi | Cara panggil |
13
- |---------|--------------|
14
- | Baru selesai fix bug secara manual | *"Logger, catat: fix bug validasi di form login"* |
15
- | Selesai coding satu sesi, ingin rekap tercatat | *"Logger, analisa apa yang baru saja dikerjakan dan catat"* |
16
- | Mau pastikan enhancement tercatat sebelum tutup sesi | *"Logger"* (tanpa argumen — logger akan tanya / analisa sendiri) |
17
- | Ingin log lintas beberapa task | *"Logger, tadi ada 3 perubahan: ..."* |
18
-
19
- ---
20
-
21
- ## Tipe Perubahan & Klasifikasinya
22
-
23
- ```
24
- Sesuatu yang salah/rusak diperbaiki?
25
- └─ YES → fix
26
-
27
- Kemampuan baru ditambahkan?
28
- └─ YES → enhancement
29
-
30
- Kode diubah tanpa ubah perilaku?
31
- └─ YES → refactor
32
-
33
- Config, dependency, atau dokumentasi?
34
- └─ YES → chore
35
- ```
36
-
37
- **Aturan tie-breaker:** Jika satu perubahan bisa fix DAN enhancement (mis. memperbaiki cara feature bekerja sambil menambah field baru), buat **dua entry terpisah** — satu fix, satu enhancement.
38
-
39
- ---
40
-
41
- ## Struktur Dokumen yang Diisi
42
-
43
- ### 1. Task Detail File — Status Log
44
- **Path:** `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`
45
-
46
- Logger menambahkan baris baru di tabel Status Log yang sudah ada:
47
- ```markdown
48
- | [timestamp] | logger | [tipe] | [deskripsi 1 baris] |
49
- ```
50
-
51
- ### 2. Dev Log File
52
- **Path:** `task/[TASK-ID]_[nama-task]/dev_log.md`
53
-
54
- Logger membuat file ini jika belum ada, atau menambah entry di Revision History:
55
- ```markdown
56
- ## [timestamp] — [tipe]: [judul]
57
-
58
- **Type:** fix / enhancement / refactor / chore
59
- **Changed by:** [human / agent]
60
-
61
- ### What Changed
62
- [Narasi singkat]
63
-
64
- ### Files Affected
65
- - `path/file` — apa yang berubah
66
-
67
- ### Notes
68
- [Catatan teknis jika ada]
69
- ```
70
-
71
- ### 3. Fallback — Untracked Changes
72
- Jika tidak ada task yang cocok, tulis ke:
73
- **Path:** `task/untracked/[YYYY-MM-DD]_untracked_changes.md`
74
-
75
- ```markdown
76
- # Untracked Changes — [YYYY-MM-DD]
77
-
78
- ## [HH:MM] — [tipe]: [judul]
79
- [Deskripsi perubahan]
80
- **Suggested Task:** [nama task yang mungkin relevan, atau "belum ada task terdaftar"]
81
- ```
82
-
83
- ---
84
-
85
- ## Alur Keputusan Logger
86
-
87
- ```
88
- Human panggil logger
89
-
90
- ├─ Ada deskripsi eksplisit? ──→ Gunakan sebagai basis
91
-
92
- ├─ Tidak ada info? ──────────→ Tanya 1-2 pertanyaan ringkas
93
-
94
- └─ Minta analisa mandiri? ───→ Periksa file yang berubah / konteks sesi
95
-
96
-
97
- Klasifikasi tipe perubahan
98
-
99
-
100
- Cari task yang cocok di task_list.md
101
-
102
- ├─ Ketemu → tulis log di task tersebut
103
- ├─ Lintas task → tulis di semua task relevan
104
- └─ Tidak ketemu → tulis di task/untracked/
105
-
106
-
107
- Konfirmasi ringkasan ke human
108
- ```
109
-
110
- ---
111
-
112
- ## Aturan Kualitas Log
113
-
114
- 1. **Deskripsi konkret** — bukan *"fix bug"* tapi *"fix: email tidak divalidasi saat domain kosong"*
115
- 2. **Satu entry per perubahan logis** — 3 perubahan berbeda = 3 entry
116
- 3. **Tidak mengarang** — jika tidak yakin apa yang berubah, tanya dulu
117
- 4. **Timestamp real** — selalu gunakan waktu saat ini, bukan placeholder
@@ -1,30 +0,0 @@
1
- ---
2
- description: Perencanaan terfokus untuk SATU fitur — hasilkan spesifikasi lengkap (low-entropy) tanpa merencanakan ulang seluruh proyek.
3
- ---
4
-
5
- Jalankan **Perencanaan Fitur** (sub-set Fase 1, ruang lingkup satu fitur) untuk: **$ARGUMENTS**
6
-
7
- > Berbeda dengan `/plan-project` yang menghasilkan SELURUH blueprint proyek, `/plan-feature` mengasumsikan blueprint proyek sudah ada dan hanya menghasilkan **spesifikasi satu fitur** yang siap dikerjakan. Output akhirnya identik dengan yang diproduksi Analyst: file spec lengkap di `specifications/` sesuai `schemas/specification.template.md`.
8
-
9
- **PRECONDITION CHECK (langkah 0):**
10
- - Pastikan `project_overview.md` ada dan "Tech Stack" + "UI Guidelines" terisi.
11
- - Pastikan `specifications/000_spec_environment_setup.md` sudah ada.
12
- - **Jika salah satu belum ada:** proyek belum direncanakan. **BERHENTI** dan arahkan human menjalankan `/plan-project` dulu. Jangan menambal blueprint proyek di sini.
13
-
14
- Langkah:
15
- 1. **Feature Discovery (INTERAKTIF — JANGAN delegasikan ke subagent)** → kamu sendiri di thread utama mewawancarai human, khusus untuk fitur ini: tujuan & nilai, aktor/role, ruang lingkup, **apa yang di luar ruang lingkup (Non-Goals)**, aturan bisnis, dan kriteria sukses. Ringkas, fokus fitur — bukan wawancara proyek penuh. Ikuti gaya tanya-jawab `agent/workflows/discovery.md` namun terbatas pada fitur.
16
- 2. **GATE:** Human sign-off ruang lingkup & Non-Goals fitur.
17
- 3. **Delta acuan (KONDISIONAL — hanya jika fitur menuntutnya):**
18
- - Jika fitur butuh entitas/kolom data BARU → delegasikan ke **Data Architect** untuk menambah delta di `state/knowledge_base/data-model/` (bukan redesign).
19
- - Jika fitur butuh komponen/pola UI BARU → delegasikan ke **UX Designer** untuk menambah delta di `state/knowledge_base/design-system/`.
20
- - Jika `depth=deep` dan fitur menyentuh data sensitif → koordinasi **Security (Mode S)** untuk aturan yang relevan.
21
- - Jika tidak ada kebutuhan baru, lewati langkah ini.
22
- 4. **Analyst** → tulis spesifikasi fitur lengkap di `specifications/NNN_...md` (nomor urut berikutnya), mengikuti `schemas/specification.template.md` dan **Low-Entropy Gate** di `agent/workflows/analyst.md`. Terapkan atomicity (1 file = 1 user story; pecah bila perlu). **API Contract wajib final & deterministik.**
23
- 5. **GATE — Spec disetujui:** Human set `Human Approval Status: approved`. API Contract final sebelum fitur boleh masuk `/build-feature`.
24
-
25
- **Aturan orkestrasi (WAJIB):**
26
- - Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
27
- - **BERHENTI di setiap GATE** dan minta persetujuan human secara eksplisit sebelum lanjut.
28
- - Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
29
- - Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
30
- - Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).