@walwal-harness/cli 6.1.6 → 7.1.1

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 (318) hide show
  1. package/HR-Resource/academic-academic-anthropologist/SKILL.md +142 -0
  2. package/HR-Resource/academic-academic-geographer/SKILL.md +144 -0
  3. package/HR-Resource/academic-academic-historian/SKILL.md +140 -0
  4. package/HR-Resource/academic-academic-narratologist/SKILL.md +135 -0
  5. package/HR-Resource/academic-academic-psychologist/SKILL.md +135 -0
  6. package/HR-Resource/brick-office/SKILL.md +20 -0
  7. package/HR-Resource/cdo/SKILL.md +33 -0
  8. package/HR-Resource/ceo/SKILL.md +47 -0
  9. package/HR-Resource/coo/SKILL.md +36 -0
  10. package/HR-Resource/cqo/SKILL.md +33 -0
  11. package/HR-Resource/cto/SKILL.md +36 -0
  12. package/HR-Resource/design-design-brand-guardian/SKILL.md +339 -0
  13. package/HR-Resource/design-design-image-prompt-engineer/SKILL.md +253 -0
  14. package/HR-Resource/design-design-inclusive-visuals-specialist/SKILL.md +88 -0
  15. package/HR-Resource/design-design-ui-designer/SKILL.md +400 -0
  16. package/HR-Resource/design-design-ux-architect/SKILL.md +486 -0
  17. package/HR-Resource/design-design-ux-researcher/SKILL.md +346 -0
  18. package/HR-Resource/design-design-visual-storyteller/SKILL.md +166 -0
  19. package/HR-Resource/design-design-whimsy-injector/SKILL.md +455 -0
  20. package/HR-Resource/engineering-engineering-ai-data-remediation-engineer/SKILL.md +227 -0
  21. package/HR-Resource/engineering-engineering-ai-engineer/SKILL.md +163 -0
  22. package/HR-Resource/engineering-engineering-autonomous-optimization-architect/SKILL.md +124 -0
  23. package/HR-Resource/engineering-engineering-backend-architect/SKILL.md +252 -0
  24. package/HR-Resource/engineering-engineering-cms-developer/SKILL.md +553 -0
  25. package/HR-Resource/engineering-engineering-code-reviewer/SKILL.md +93 -0
  26. package/HR-Resource/engineering-engineering-codebase-onboarding-engineer/SKILL.md +190 -0
  27. package/HR-Resource/engineering-engineering-data-engineer/SKILL.md +323 -0
  28. package/HR-Resource/engineering-engineering-database-optimizer/SKILL.md +193 -0
  29. package/HR-Resource/engineering-engineering-devops-automator/SKILL.md +393 -0
  30. package/HR-Resource/engineering-engineering-email-intelligence-engineer/SKILL.md +370 -0
  31. package/HR-Resource/engineering-engineering-embedded-firmware-engineer/SKILL.md +190 -0
  32. package/HR-Resource/engineering-engineering-feishu-integration-developer/SKILL.md +615 -0
  33. package/HR-Resource/engineering-engineering-filament-optimization-specialist/SKILL.md +300 -0
  34. package/HR-Resource/engineering-engineering-frontend-developer/SKILL.md +242 -0
  35. package/HR-Resource/engineering-engineering-git-workflow-master/SKILL.md +101 -0
  36. package/HR-Resource/engineering-engineering-incident-response-commander/SKILL.md +461 -0
  37. package/HR-Resource/engineering-engineering-minimal-change-engineer/SKILL.md +224 -0
  38. package/HR-Resource/engineering-engineering-mobile-app-builder/SKILL.md +510 -0
  39. package/HR-Resource/engineering-engineering-rapid-prototyper/SKILL.md +479 -0
  40. package/HR-Resource/engineering-engineering-security-engineer/SKILL.md +321 -0
  41. package/HR-Resource/engineering-engineering-senior-developer/SKILL.md +193 -0
  42. package/HR-Resource/engineering-engineering-software-architect/SKILL.md +98 -0
  43. package/HR-Resource/engineering-engineering-solidity-smart-contract-engineer/SKILL.md +539 -0
  44. package/HR-Resource/engineering-engineering-sre/SKILL.md +107 -0
  45. package/HR-Resource/engineering-engineering-technical-writer/SKILL.md +410 -0
  46. package/HR-Resource/engineering-engineering-threat-detection-engineer/SKILL.md +551 -0
  47. package/HR-Resource/engineering-engineering-voice-ai-integration-engineer/SKILL.md +578 -0
  48. package/HR-Resource/engineering-engineering-wechat-mini-program-developer/SKILL.md +367 -0
  49. package/HR-Resource/finance-finance-bookkeeper-controller/SKILL.md +277 -0
  50. package/HR-Resource/finance-finance-financial-analyst/SKILL.md +251 -0
  51. package/HR-Resource/finance-finance-fpa-analyst/SKILL.md +280 -0
  52. package/HR-Resource/finance-finance-investment-researcher/SKILL.md +289 -0
  53. package/HR-Resource/finance-finance-tax-strategist/SKILL.md +256 -0
  54. package/HR-Resource/game-development-blender-blender-addon-engineer/SKILL.md +251 -0
  55. package/HR-Resource/game-development-game-audio-engineer/SKILL.md +281 -0
  56. package/HR-Resource/game-development-game-designer/SKILL.md +184 -0
  57. package/HR-Resource/game-development-godot-godot-gameplay-scripter/SKILL.md +351 -0
  58. package/HR-Resource/game-development-godot-godot-multiplayer-engineer/SKILL.md +314 -0
  59. package/HR-Resource/game-development-godot-godot-shader-developer/SKILL.md +283 -0
  60. package/HR-Resource/game-development-level-designer/SKILL.md +225 -0
  61. package/HR-Resource/game-development-narrative-designer/SKILL.md +260 -0
  62. package/HR-Resource/game-development-roblox-studio-roblox-avatar-creator/SKILL.md +314 -0
  63. package/HR-Resource/game-development-roblox-studio-roblox-experience-designer/SKILL.md +322 -0
  64. package/HR-Resource/game-development-roblox-studio-roblox-systems-scripter/SKILL.md +342 -0
  65. package/HR-Resource/game-development-technical-artist/SKILL.md +246 -0
  66. package/HR-Resource/game-development-unity-unity-architect/SKILL.md +288 -0
  67. package/HR-Resource/game-development-unity-unity-editor-tool-developer/SKILL.md +327 -0
  68. package/HR-Resource/game-development-unity-unity-multiplayer-engineer/SKILL.md +338 -0
  69. package/HR-Resource/game-development-unity-unity-shader-graph-artist/SKILL.md +286 -0
  70. package/HR-Resource/game-development-unreal-engine-unreal-multiplayer-architect/SKILL.md +330 -0
  71. package/HR-Resource/game-development-unreal-engine-unreal-systems-engineer/SKILL.md +327 -0
  72. package/HR-Resource/game-development-unreal-engine-unreal-technical-artist/SKILL.md +273 -0
  73. package/HR-Resource/game-development-unreal-engine-unreal-world-builder/SKILL.md +290 -0
  74. package/HR-Resource/hiring/SKILL.md +28 -0
  75. package/HR-Resource/index.json +747 -0
  76. package/HR-Resource/integrations-mcp-memory-backend-architect-with-memory/SKILL.md +264 -0
  77. package/HR-Resource/marketing-marketing-agentic-search-optimizer/SKILL.md +328 -0
  78. package/HR-Resource/marketing-marketing-ai-citation-strategist/SKILL.md +187 -0
  79. package/HR-Resource/marketing-marketing-app-store-optimizer/SKILL.md +338 -0
  80. package/HR-Resource/marketing-marketing-baidu-seo-specialist/SKILL.md +243 -0
  81. package/HR-Resource/marketing-marketing-bilibili-content-strategist/SKILL.md +216 -0
  82. package/HR-Resource/marketing-marketing-book-co-author/SKILL.md +127 -0
  83. package/HR-Resource/marketing-marketing-carousel-growth-engine/SKILL.md +216 -0
  84. package/HR-Resource/marketing-marketing-china-ecommerce-operator/SKILL.md +300 -0
  85. package/HR-Resource/marketing-marketing-china-market-localization-strategist/SKILL.md +300 -0
  86. package/HR-Resource/marketing-marketing-content-creator/SKILL.md +71 -0
  87. package/HR-Resource/marketing-marketing-cross-border-ecommerce/SKILL.md +276 -0
  88. package/HR-Resource/marketing-marketing-douyin-strategist/SKILL.md +166 -0
  89. package/HR-Resource/marketing-marketing-growth-hacker/SKILL.md +71 -0
  90. package/HR-Resource/marketing-marketing-instagram-curator/SKILL.md +130 -0
  91. package/HR-Resource/marketing-marketing-kuaishou-strategist/SKILL.md +240 -0
  92. package/HR-Resource/marketing-marketing-linkedin-content-creator/SKILL.md +230 -0
  93. package/HR-Resource/marketing-marketing-livestream-commerce-coach/SKILL.md +322 -0
  94. package/HR-Resource/marketing-marketing-podcast-strategist/SKILL.md +294 -0
  95. package/HR-Resource/marketing-marketing-private-domain-operator/SKILL.md +325 -0
  96. package/HR-Resource/marketing-marketing-reddit-community-builder/SKILL.md +140 -0
  97. package/HR-Resource/marketing-marketing-seo-specialist/SKILL.md +338 -0
  98. package/HR-Resource/marketing-marketing-short-video-editing-coach/SKILL.md +429 -0
  99. package/HR-Resource/marketing-marketing-social-media-strategist/SKILL.md +142 -0
  100. package/HR-Resource/marketing-marketing-tiktok-strategist/SKILL.md +142 -0
  101. package/HR-Resource/marketing-marketing-twitter-engager/SKILL.md +143 -0
  102. package/HR-Resource/marketing-marketing-video-optimization-specialist/SKILL.md +136 -0
  103. package/HR-Resource/marketing-marketing-wechat-official-account/SKILL.md +162 -0
  104. package/HR-Resource/marketing-marketing-weibo-strategist/SKILL.md +257 -0
  105. package/HR-Resource/marketing-marketing-xiaohongshu-specialist/SKILL.md +155 -0
  106. package/HR-Resource/marketing-marketing-zhihu-strategist/SKILL.md +179 -0
  107. package/HR-Resource/ops/SKILL.md +46 -0
  108. package/HR-Resource/paid-media-paid-media-auditor/SKILL.md +88 -0
  109. package/HR-Resource/paid-media-paid-media-creative-strategist/SKILL.md +88 -0
  110. package/HR-Resource/paid-media-paid-media-paid-social-strategist/SKILL.md +88 -0
  111. package/HR-Resource/paid-media-paid-media-ppc-strategist/SKILL.md +88 -0
  112. package/HR-Resource/paid-media-paid-media-programmatic-buyer/SKILL.md +88 -0
  113. package/HR-Resource/paid-media-paid-media-search-query-analyst/SKILL.md +88 -0
  114. package/HR-Resource/paid-media-paid-media-tracking-specialist/SKILL.md +88 -0
  115. package/HR-Resource/product-product-behavioral-nudge-engine/SKILL.md +97 -0
  116. package/HR-Resource/product-product-feedback-synthesizer/SKILL.md +136 -0
  117. package/HR-Resource/product-product-manager/SKILL.md +486 -0
  118. package/HR-Resource/product-product-sprint-prioritizer/SKILL.md +171 -0
  119. package/HR-Resource/product-product-trend-researcher/SKILL.md +176 -0
  120. package/HR-Resource/project-management-project-management-experiment-tracker/SKILL.md +215 -0
  121. package/HR-Resource/project-management-project-management-jira-workflow-steward/SKILL.md +247 -0
  122. package/HR-Resource/project-management-project-management-project-shepherd/SKILL.md +211 -0
  123. package/HR-Resource/project-management-project-management-studio-operations/SKILL.md +217 -0
  124. package/HR-Resource/project-management-project-management-studio-producer/SKILL.md +220 -0
  125. package/HR-Resource/project-management-project-manager-senior/SKILL.md +152 -0
  126. package/HR-Resource/resource-manager/SKILL.md +23 -0
  127. package/HR-Resource/sales-sales-account-strategist/SKILL.md +244 -0
  128. package/HR-Resource/sales-sales-coach/SKILL.md +288 -0
  129. package/HR-Resource/sales-sales-deal-strategist/SKILL.md +197 -0
  130. package/HR-Resource/sales-sales-discovery-coach/SKILL.md +242 -0
  131. package/HR-Resource/sales-sales-engineer/SKILL.md +199 -0
  132. package/HR-Resource/sales-sales-outbound-strategist/SKILL.md +218 -0
  133. package/HR-Resource/sales-sales-pipeline-analyst/SKILL.md +284 -0
  134. package/HR-Resource/sales-sales-proposal-strategist/SKILL.md +234 -0
  135. package/HR-Resource/spatial-computing-macos-spatial-metal-engineer/SKILL.md +354 -0
  136. package/HR-Resource/spatial-computing-terminal-integration-specialist/SKILL.md +87 -0
  137. package/HR-Resource/spatial-computing-visionos-spatial-engineer/SKILL.md +71 -0
  138. package/HR-Resource/spatial-computing-xr-cockpit-interaction-specialist/SKILL.md +49 -0
  139. package/HR-Resource/spatial-computing-xr-immersive-developer/SKILL.md +49 -0
  140. package/HR-Resource/spatial-computing-xr-interface-architect/SKILL.md +49 -0
  141. package/HR-Resource/specialized-accounts-payable-agent/SKILL.md +202 -0
  142. package/HR-Resource/specialized-agentic-identity-trust/SKILL.md +404 -0
  143. package/HR-Resource/specialized-agents-orchestrator/SKILL.md +384 -0
  144. package/HR-Resource/specialized-automation-governance-architect/SKILL.md +233 -0
  145. package/HR-Resource/specialized-blockchain-security-auditor/SKILL.md +480 -0
  146. package/HR-Resource/specialized-compliance-auditor/SKILL.md +175 -0
  147. package/HR-Resource/specialized-corporate-training-designer/SKILL.md +209 -0
  148. package/HR-Resource/specialized-customer-service/SKILL.md +415 -0
  149. package/HR-Resource/specialized-data-consolidation-agent/SKILL.md +77 -0
  150. package/HR-Resource/specialized-government-digital-presales-consultant/SKILL.md +380 -0
  151. package/HR-Resource/specialized-healthcare-customer-service/SKILL.md +406 -0
  152. package/HR-Resource/specialized-healthcare-marketing-compliance/SKILL.md +412 -0
  153. package/HR-Resource/specialized-hospitality-guest-services/SKILL.md +620 -0
  154. package/HR-Resource/specialized-hr-onboarding/SKILL.md +468 -0
  155. package/HR-Resource/specialized-identity-graph-operator/SKILL.md +277 -0
  156. package/HR-Resource/specialized-language-translator/SKILL.md +281 -0
  157. package/HR-Resource/specialized-legal-billing-time-tracking/SKILL.md +586 -0
  158. package/HR-Resource/specialized-legal-client-intake/SKILL.md +509 -0
  159. package/HR-Resource/specialized-legal-document-review/SKILL.md +471 -0
  160. package/HR-Resource/specialized-loan-officer-assistant/SKILL.md +572 -0
  161. package/HR-Resource/specialized-lsp-index-engineer/SKILL.md +331 -0
  162. package/HR-Resource/specialized-real-estate-buyer-seller/SKILL.md +613 -0
  163. package/HR-Resource/specialized-recruitment-specialist/SKILL.md +526 -0
  164. package/HR-Resource/specialized-report-distribution-agent/SKILL.md +82 -0
  165. package/HR-Resource/specialized-retail-customer-returns/SKILL.md +583 -0
  166. package/HR-Resource/specialized-sales-data-extraction-agent/SKILL.md +84 -0
  167. package/HR-Resource/specialized-sales-outreach/SKILL.md +442 -0
  168. package/HR-Resource/specialized-specialized-chief-of-staff/SKILL.md +296 -0
  169. package/HR-Resource/specialized-specialized-civil-engineer/SKILL.md +373 -0
  170. package/HR-Resource/specialized-specialized-cultural-intelligence-strategist/SKILL.md +105 -0
  171. package/HR-Resource/specialized-specialized-developer-advocate/SKILL.md +334 -0
  172. package/HR-Resource/specialized-specialized-document-generator/SKILL.md +72 -0
  173. package/HR-Resource/specialized-specialized-french-consulting-market/SKILL.md +209 -0
  174. package/HR-Resource/specialized-specialized-korean-business-navigator/SKILL.md +233 -0
  175. package/HR-Resource/specialized-specialized-mcp-builder/SKILL.md +265 -0
  176. package/HR-Resource/specialized-specialized-model-qa/SKILL.md +505 -0
  177. package/HR-Resource/specialized-specialized-salesforce-architect/SKILL.md +197 -0
  178. package/HR-Resource/specialized-specialized-workflow-architect/SKILL.md +614 -0
  179. package/HR-Resource/specialized-study-abroad-advisor/SKILL.md +299 -0
  180. package/HR-Resource/specialized-supply-chain-strategist/SKILL.md +599 -0
  181. package/HR-Resource/specialized-zk-steward/SKILL.md +228 -0
  182. package/HR-Resource/support-support-analytics-reporter/SKILL.md +382 -0
  183. package/HR-Resource/support-support-executive-summary-generator/SKILL.md +229 -0
  184. package/HR-Resource/support-support-finance-tracker/SKILL.md +459 -0
  185. package/HR-Resource/support-support-infrastructure-maintainer/SKILL.md +635 -0
  186. package/HR-Resource/support-support-legal-compliance-checker/SKILL.md +605 -0
  187. package/HR-Resource/support-support-support-responder/SKILL.md +602 -0
  188. package/HR-Resource/testing-testing-accessibility-auditor/SKILL.md +333 -0
  189. package/HR-Resource/testing-testing-api-tester/SKILL.md +323 -0
  190. package/HR-Resource/testing-testing-evidence-collector/SKILL.md +227 -0
  191. package/HR-Resource/testing-testing-performance-benchmarker/SKILL.md +285 -0
  192. package/HR-Resource/testing-testing-reality-checker/SKILL.md +253 -0
  193. package/HR-Resource/testing-testing-test-results-analyzer/SKILL.md +322 -0
  194. package/HR-Resource/testing-testing-tool-evaluator/SKILL.md +411 -0
  195. package/HR-Resource/testing-testing-workflow-optimizer/SKILL.md +467 -0
  196. package/assets/templates/config.json +36 -2
  197. package/bin/init.js +292 -110
  198. package/commands/goal.md +25 -0
  199. package/commands/hot-fix.md +25 -0
  200. package/commands/play-harness.md +22 -0
  201. package/commands/release-harness.md +22 -0
  202. package/commands/stop-harness.md +21 -0
  203. package/conventions/README.md +14 -88
  204. package/conventions/brick-office.md +5 -0
  205. package/conventions/cdo.md +6 -0
  206. package/conventions/ceo.md +9 -0
  207. package/conventions/coo.md +6 -0
  208. package/conventions/cqo.md +6 -23
  209. package/conventions/cto.md +5 -23
  210. package/conventions/hiring.md +7 -0
  211. package/conventions/ops.md +9 -0
  212. package/conventions/resource-manager.md +6 -0
  213. package/conventions/shared.md +29 -58
  214. package/gotchas/README.md +14 -82
  215. package/gotchas/brick-office.md +9 -0
  216. package/gotchas/cdo.md +9 -0
  217. package/gotchas/ceo.md +9 -0
  218. package/gotchas/coo.md +9 -0
  219. package/gotchas/cqo.md +6 -19
  220. package/gotchas/cto.md +6 -19
  221. package/gotchas/hiring.md +9 -0
  222. package/gotchas/ops.md +17 -0
  223. package/gotchas/resource-manager.md +9 -0
  224. package/gotchas/shared.md +13 -0
  225. package/init.sh +208 -0
  226. package/package.json +12 -17
  227. package/scripts/harness-runtime-stop.sh +58 -0
  228. package/scripts/harness-service-ops-monitor.sh +160 -16
  229. package/scripts/harness-stop.sh +18 -0
  230. package/scripts/harness-worker-evidence-validate.sh +59 -0
  231. package/scripts/import-agency-agents.js +102 -0
  232. package/scripts/play.sh +104 -0
  233. package/scripts/release.sh +89 -0
  234. package/conventions/conductor.md +0 -24
  235. package/conventions/coo-developer.md +0 -24
  236. package/conventions/dispatcher.md +0 -24
  237. package/conventions/documentationer.md +0 -24
  238. package/conventions/evaluator-architecture.md +0 -24
  239. package/conventions/evaluator-code-quality.md +0 -24
  240. package/conventions/evaluator-functional.md +0 -24
  241. package/conventions/evaluator-security.md +0 -24
  242. package/conventions/evaluator-visual.md +0 -24
  243. package/conventions/generator-backend.md +0 -24
  244. package/conventions/generator-designer.md +0 -24
  245. package/conventions/generator-devops.md +0 -24
  246. package/conventions/generator-frontend.md +0 -24
  247. package/conventions/meeting-manager.md +0 -24
  248. package/conventions/planner.md +0 -24
  249. package/conventions/service-ops.md +0 -24
  250. package/gotchas/conductor.md +0 -38
  251. package/gotchas/coo-developer.md +0 -22
  252. package/gotchas/dispatcher.md +0 -38
  253. package/gotchas/documentationer.md +0 -22
  254. package/gotchas/evaluator-architecture.md +0 -22
  255. package/gotchas/evaluator-code-quality.md +0 -22
  256. package/gotchas/evaluator-functional.md +0 -22
  257. package/gotchas/evaluator-security.md +0 -22
  258. package/gotchas/evaluator-visual.md +0 -22
  259. package/gotchas/generator-backend-laravel.md +0 -19
  260. package/gotchas/generator-backend.md +0 -22
  261. package/gotchas/generator-designer.md +0 -22
  262. package/gotchas/generator-devops.md +0 -22
  263. package/gotchas/generator-frontend.md +0 -22
  264. package/gotchas/meeting-manager.md +0 -30
  265. package/gotchas/planner.md +0 -22
  266. package/gotchas/service-ops.md +0 -30
  267. package/skills/_shared/dynamic-registration.md +0 -120
  268. package/skills/brainstorming/SKILL.md +0 -220
  269. package/skills/brainstorming/references/attribution.md +0 -109
  270. package/skills/brainstorming/references/spec-document-reviewer-prompt.md +0 -49
  271. package/skills/brainstorming/references/visual-companion.md +0 -287
  272. package/skills/brainstorming/scripts/frame-template.html +0 -214
  273. package/skills/brainstorming/scripts/helper.js +0 -88
  274. package/skills/brainstorming/scripts/server.cjs +0 -354
  275. package/skills/brainstorming/scripts/start-server.sh +0 -148
  276. package/skills/brainstorming/scripts/stop-server.sh +0 -56
  277. package/skills/conductor/SKILL.md +0 -336
  278. package/skills/coo-developer/SKILL.md +0 -72
  279. package/skills/cqo/SKILL.md +0 -146
  280. package/skills/cto/SKILL.md +0 -141
  281. package/skills/dispatcher/SKILL.md +0 -298
  282. package/skills/dispatcher/persona-ceo.md +0 -169
  283. package/skills/dispatcher/references/convention-flow.md +0 -111
  284. package/skills/dispatcher/references/gotcha-flow.md +0 -79
  285. package/skills/dispatcher/references/initialization.md +0 -53
  286. package/skills/dispatcher/references/pipeline-definitions.md +0 -151
  287. package/skills/documentationer/SKILL.md +0 -92
  288. package/skills/evaluator-architecture/SKILL.md +0 -173
  289. package/skills/evaluator-code-quality/SKILL.md +0 -218
  290. package/skills/evaluator-code-quality/references/scoring-rubric.md +0 -104
  291. package/skills/evaluator-functional/SKILL.md +0 -271
  292. package/skills/evaluator-functional/references/ia-compliance.md +0 -37
  293. package/skills/evaluator-functional/references/playwright-tools.md +0 -43
  294. package/skills/evaluator-functional/references/scoring-rubric.md +0 -52
  295. package/skills/evaluator-security/SKILL.md +0 -172
  296. package/skills/evaluator-visual/SKILL.md +0 -165
  297. package/skills/evaluator-visual/references/responsive-checklist.md +0 -44
  298. package/skills/evaluator-visual/references/scoring-rubric.md +0 -59
  299. package/skills/generator-backend/SKILL.md +0 -153
  300. package/skills/generator-backend/references/nestjs-msa-patterns.md +0 -69
  301. package/skills/generator-backend/references/sprint-contract-be.md +0 -32
  302. package/skills/generator-designer/SKILL.md +0 -219
  303. package/skills/generator-devops/SKILL.md +0 -201
  304. package/skills/generator-frontend/SKILL.md +0 -155
  305. package/skills/generator-frontend/references/_web-react-legacy/ai-forbidden-patterns.md +0 -89
  306. package/skills/generator-frontend/references/_web-react-legacy/component-patterns.md +0 -52
  307. package/skills/generator-frontend/references/_web-react-legacy/design-system-rules.md +0 -139
  308. package/skills/generator-frontend/references/_web-react-legacy/vercel-best-practices.md +0 -54
  309. package/skills/meeting-manager/SKILL.md +0 -419
  310. package/skills/planner/SKILL.md +0 -243
  311. package/skills/planner/hr-onboard.md +0 -134
  312. package/skills/planner/hr-recruit.md +0 -99
  313. package/skills/planner/persona-coo-hr.md +0 -182
  314. package/skills/planner/references/api-contract-schema.md +0 -34
  315. package/skills/planner/references/fe-stack-detection.md +0 -164
  316. package/skills/planner/references/ia-map-guide.md +0 -31
  317. package/skills/planner/references/plan-template.md +0 -51
  318. package/skills/service-ops/SKILL.md +0 -295
@@ -1,134 +0,0 @@
1
- ---
2
- docmeta:
3
- id: planner-hr-onboard
4
- title: Planner HR Module — Onboarding
5
- type: output
6
- createdAt: 2026-05-07T00:00:00Z
7
- updatedAt: 2026-05-07T00:00:00Z
8
- source:
9
- producer: agent
10
- skillId: harness-planner
11
- inputs:
12
- - documentId: agency-agents-specialized
13
- uri: https://github.com/msitarzewski/agency-agents
14
- relation: output-from
15
- sections:
16
- - sourceRange: { startLine: 1, endLine: 1 } # specialized/hr-onboarding.md
17
- targetRange: { startLine: 1, endLine: 200 }
18
- tags: [planner, hr, onboarding, phase-b]
19
- ---
20
-
21
- <!-- Source: https://github.com/msitarzewski/agency-agents (MIT) — specialized/hr-onboarding.md -->
22
-
23
- # Planner HR Module — Onboarding (서브 모듈)
24
-
25
- > Recruiting 모듈에서 import한 신규 부서가 첫날 일을 시작할 수 있도록 자료·라우팅·관계를 갖춰주는 절차.
26
-
27
- ## 1. 입력
28
-
29
- - Recruiting 산출물: 새 `skills/<role>/SKILL.md`
30
- - `.harness/actions/scan-result.json` (현재 스택)
31
- - `.harness/agency-mapping.md` (분류 정보)
32
-
33
- ## 2. 온보딩 절차
34
-
35
- ```
36
- 1. gotchas 인벤토리 생성
37
- - gotchas/<role>.md (공통 가드)
38
- - gotchas/<role>-<stack>.md (스택별, 해당 시)
39
- - 첫 입사일에는 verified 0건, unverified 후보만 명시
40
- - "스택별 gotcha 후보"는 직전 스프린트의 fail 패턴 참고
41
-
42
- 2. ref-doc 작성 (필요 시)
43
- - .harness/ref/<role>-<stack>.md
44
- - best practice + Eval 검증 기준 1차 정의
45
- - 예: backend-laravel.md (Phase B-10 산출)
46
-
47
- 3. 권한 매트릭스 갱신
48
- - AGENTS.md 의 "읽기/쓰기 권한" 표에 신규 부서 행 추가
49
- - IA-MAP에 해당 부서가 책임지는 폴더 표기
50
-
51
- 4. dispatcher 라우팅 카탈로그 갱신
52
- - skills/dispatcher/persona-ceo.md "부서 카탈로그 룩업" 표에 추가
53
- - Runbook 매칭 매트릭스에서 어디 편성될지 명시
54
-
55
- 5. progress.json 보강
56
- - org.<role> = "active"
57
- - 해당 부서 전용 필드 (예: eval_security, generator_designer 등)
58
-
59
- 6. 대시보드 (Brick Office) 데이터 갱신
60
- - apps/harness-dashboard/data/org.json 에 책상 추가
61
- - 부서별 색상·아이콘 결정
62
-
63
- 7. Conductor 라우팅 룰 등록
64
- - skills/conductor/SKILL.md 의 spawn 결정 트리에 신규 부서 진입 조건 추가
65
-
66
- 8. 첫 미션 등록 (선택)
67
- - feature-list.json 에 ramp-up feature 1건 자동 등록
68
- - 이는 부서가 자기 산출물 양식을 한 번 출력해 보는 dry-run
69
-
70
- 9. 회의 참석자 매트릭스 갱신
71
- - skills/meeting-manager/SKILL.md 의 회의 종류별 참석자 표 업데이트
72
- ```
73
-
74
- ## 3. 산출물 체크리스트
75
-
76
- 새 부서 active 선언 전 모두 통과해야 함:
77
-
78
- ```
79
- [ ] skills/<role>/SKILL.md 존재 + frontmatter + 출처 주석
80
- [ ] gotchas/<role>.md 인벤토리 (unverified 후보 ≥ 3건 또는 N/A 명시)
81
- [ ] (스택 의존 시) .harness/ref/<role>-<stack>.md 작성
82
- [ ] AGENTS.md 권한 매트릭스 행 추가
83
- [ ] dispatcher 카탈로그 + Runbook 편성 명시
84
- [ ] progress.json 필드 정의
85
- [ ] (대시보드 활성 시) apps/harness-dashboard/data/org.json 갱신
86
- [ ] Conductor 진입 조건 등록
87
- [ ] meeting-manager 참석자 매트릭스 갱신
88
- [ ] hr-roster.md 의 recruiting → active 이동
89
- ```
90
-
91
- 체크리스트 미통과 항목 1건이라도 있으면 부서 status는 `recruiting` 으로 유지, Sprint에 합류 X.
92
-
93
- ## 4. 인계 (Handoff Package)
94
-
95
- 신규 부서가 받는 첫 패키지:
96
-
97
- ```
98
- .harness/actions/onboarding/<role>/
99
- ├── welcome.md (역할 정의·기대치·금지사항)
100
- ├── stack-context.md (현재 스택·conventions·관련 ref-doc 링크)
101
- ├── interfaces.md (어느 부서에 무엇을 보내고 받는지)
102
- ├── first-mission.md (선택: ramp-up feature 명세)
103
- └── escalation.md (문제 시 누구에게 어떻게 알리는지)
104
- ```
105
-
106
- ## 5. 동료 관계 (Cross-Department Edges)
107
-
108
- 부서 신설 시 즉시 정의해야 할 관계:
109
-
110
- | 질문 | 예시 (Eval-Architecture 신설 시) |
111
- |---|---|
112
- | 누가 산출물을 받아주나? | CQO (audit 통합) |
113
- | 누구의 산출물을 받아 일하나? | Generator-* (코드·diff) |
114
- | 어느 회의 참석? | Sprint Review, Spec Review |
115
- | 어느 Eval과 cross-validate? | Functional, Security, CodeQuality |
116
- | Conductor가 언제 spawn? | Generator 완료 후 / Sprint 종료 회귀 시 |
117
-
118
- 이 관계가 모호하면 부서가 Idle 상태로 떠도게 됨.
119
-
120
- ## 6. 안전 가드
121
-
122
- - 체크리스트 미통과 active 선언 거부
123
- - 스택과 무관한 ref-doc 강제 작성 금지 (필요 시에만)
124
- - 한 Sprint에 동시 ≥ 3 부서 신설 금지 (혼란 방지) — Owner override 가능
125
-
126
- ## 7. Off-boarding과의 대칭
127
-
128
- 부서 폐지 시 대칭적 절차:
129
- - AGENTS.md 권한 행 제거(주석으로 비활성 표시)
130
- - dispatcher 카탈로그에서 제외
131
- - Conductor 진입 조건 비활성
132
- - progress.json.org.<role> = "inactive"
133
- - 파일·gotcha·ref-doc 보존 (재활성 가능)
134
- - hr-roster.md inactive 섹션 이동 + 사유 명시
@@ -1,99 +0,0 @@
1
- ---
2
- docmeta:
3
- id: planner-hr-recruit
4
- title: Planner HR Module — Recruiting
5
- type: output
6
- createdAt: 2026-05-07T00:00:00Z
7
- updatedAt: 2026-05-07T00:00:00Z
8
- source:
9
- producer: agent
10
- skillId: harness-planner
11
- inputs:
12
- - documentId: agency-agents-specialized
13
- uri: https://github.com/msitarzewski/agency-agents
14
- relation: output-from
15
- sections:
16
- - sourceRange: { startLine: 1, endLine: 1 } # specialized/recruitment-specialist.md
17
- targetRange: { startLine: 1, endLine: 200 }
18
- tags: [planner, hr, recruiting, phase-b]
19
- ---
20
-
21
- <!-- Source: https://github.com/msitarzewski/agency-agents (MIT) — specialized/recruitment-specialist.md -->
22
-
23
- # Planner HR Module — Recruiting (서브 모듈)
24
-
25
- > 본 문서는 `skills/planner/SKILL.md` 의 보조 모듈. Dispatcher 부서식별 결과나 CTO/Conductor 채용 제안을 받아 신규 부서 import 절차 수행.
26
-
27
- ## 1. 입력
28
-
29
- - **트리거 1**: Dispatcher org-chart에 새 must/should 부서가 비활성 상태로 표기됨
30
- - **트리거 2**: CTO 또는 Conductor가 Owner에 채용 제안 (Dispatcher 경유 → Owner 승인) → Planner에 위임
31
- - **자료**: `.harness/agency-mapping.md`, `progress.json.org`, `hr-roster.md`
32
-
33
- ## 2. 채용 절차
34
-
35
- ```
36
- 1. 후보 매칭
37
- a. agency-mapping.md 의 "✅ 확정 채택" 카탈로그에서 직접 매핑
38
- b. 없으면 같은 카테고리 다른 항목 (보류 상태)
39
- c. 그래도 없으면 → 직접 작성 모드 (별도 절차)
40
-
41
- 2. 자격 검증
42
- - CN-only 필터 (WeChat/Weibo/Douyin/Baidu/Bilibili/Kuaishou/
43
- Xiaohongshu/Zhihu/Feishu/cross-border 보류) 자동 제외
44
- - License 확인 (MIT 외 라이선스는 Owner 명시 승인 필요)
45
-
46
- 3. Owner 승인
47
- Dispatcher 통해:
48
- [채용 제안]
49
- 부서: <role>
50
- 사유: <one-line>
51
- 출처: agency-agents/<path> (MIT)
52
- 온보딩 비용: 1 sprint ramp
53
- 승인하시겠습니까? (y/n)
54
-
55
- 4. Import
56
- - raw fetch: https://raw.githubusercontent.com/msitarzewski/agency-agents/main/<path>
57
- - 변환: agency 양식 → walwal SKILL.md 양식
58
- · YAML frontmatter (name, description, disable-model-invocation)
59
- · Source 주석 첨부 (MIT)
60
- · docmeta 추가
61
- · 우리 조직도 용어로 정렬 (CEO/COO/CTO/CQO/Service-Ops/Conductor 등)
62
- - 저장 위치: skills/<role>/SKILL.md
63
-
64
- 5. Onboarding 모듈로 핸드오프 (`hr-onboard.md`)
65
- ```
66
-
67
- ## 3. 변환 룰 (agency → walwal)
68
-
69
- | agency 양식 | walwal 양식 |
70
- |---|---|
71
- | `name: Foo Bar` | `name: harness-foo-bar` (kebab + 접두) |
72
- | `description: ...` | description 마지막에 트리거 키워드 추가 |
73
- | `color`, `emoji`, `vibe` | 제거 또는 주석으로 보존 |
74
- | 호출 양식 ("Please spawn...") | progress.json next_agent 패턴으로 재작성 |
75
- | Phase 라이프사이클 언급 | 우리 NEXUS-adapted Phase 0~6에 매핑 |
76
- | 다른 agency 에이전트 호출 | 우리 부서 이름으로 치환 (혹은 Pending 표시) |
77
-
78
- ## 4. 직접 작성 모드 (카탈로그 부재 시)
79
-
80
- agency-agents에 없는 부서가 필요할 때:
81
-
82
- 1. CTO·Owner와 책임 정의 합의 (Spec Review Meeting)
83
- 2. 기존 walwal 스킬을 베이스로 새 SKILL.md 초안
84
- 3. gotchas/<role>.md 빈 인벤토리 생성 (verified 0건)
85
- 4. ref-doc 필요 여부 판단 (스택 의존이면 작성)
86
-
87
- ## 5. 산출물
88
-
89
- - 새 `skills/<role>/SKILL.md` (변환 또는 직접)
90
- - `gotchas/<role>.md` 초안 (Onboarding 책임)
91
- - `.harness/actions/hr-roster.md` 갱신 (`recruiting → active`)
92
- - progress.json.org.<role> = "active"
93
-
94
- ## 6. 안전 가드
95
-
96
- - Owner 승인 없이 import 금지
97
- - 동일 role 중복 채용 시도 거부 (이미 active이면 무시)
98
- - License MIT 외 항목은 import 전 사용자에게 명시 (Apache 2.0/BSD는 자동 OK, GPL은 거부)
99
- - Import된 파일은 `Source: <url> (LICENSE)` 주석 필수, 누락 시 자체 reject
@@ -1,182 +0,0 @@
1
- ---
2
- docmeta:
3
- id: persona-coo-hr
4
- title: Planner COO + HR Persona (v6 supplement)
5
- type: output
6
- createdAt: 2026-05-07T00:00:00Z
7
- updatedAt: 2026-05-07T00:00:00Z
8
- source:
9
- producer: agent
10
- skillId: harness-planner
11
- inputs:
12
- - documentId: agency-agents-product-pm-specialized
13
- uri: https://github.com/msitarzewski/agency-agents
14
- relation: output-from
15
- note: PM·sprint-prioritizer·studio-producer·recruitment·hr-onboarding 흡수
16
- sections:
17
- - sourceRange: { startLine: 1, endLine: 1 } # product/product-manager.md
18
- targetRange: { startLine: 24, endLine: 48 }
19
- - sourceRange: { startLine: 1, endLine: 1 } # product/product-sprint-prioritizer.md
20
- targetRange: { startLine: 50, endLine: 70 }
21
- - sourceRange: { startLine: 1, endLine: 1 } # specialized/recruitment-specialist.md
22
- targetRange: { startLine: 72, endLine: 110 }
23
- - sourceRange: { startLine: 1, endLine: 1 } # specialized/hr-onboarding.md
24
- targetRange: { startLine: 112, endLine: 150 }
25
- - sourceRange: { startLine: 1, endLine: 1 } # strategy/playbooks/phase-{0..6}
26
- targetRange: { startLine: 152, endLine: 180 }
27
- tags: [persona, planner, coo, hr, phase-b]
28
- ---
29
-
30
- <!--
31
- Source: https://github.com/msitarzewski/agency-agents (MIT)
32
- 재해석 출처:
33
- - product/product-manager.md
34
- - product/product-sprint-prioritizer.md
35
- - project-management/project-manager-senior.md
36
- - project-management/project-management-studio-producer.md
37
- - specialized/recruitment-specialist.md
38
- - specialized/hr-onboarding.md
39
- - strategy/playbooks/phase-{0..6}.md (Planner phase 모드)
40
- -->
41
-
42
- # Planner — COO + HR 페르소나 (v6 supplement)
43
-
44
- > 본 문서는 기존 `SKILL.md` 의 **확장**이며, Sprint·feature-list·AC·IA-MAP 책임은 그대로 유지됩니다.
45
-
46
- ## A. COO 책임 (확장)
47
-
48
- 기존 Sprint/AC 분해 외 다음 추가:
49
-
50
- ### A-1. Phase 모드 (NEXUS 7-Phase 흡수)
51
-
52
- | Phase | Planner 모드 | 입력 | 산출물 |
53
- |---|---|---|---|
54
- | 0 Discovery | `planner.discovery` | Owner 발화 + scan-result | GOAL 초안 + 도메인 분류 |
55
- | 1 Strategy | `planner.strategy` | goals.md + cto-review | feature-list draft + IA-MAP |
56
- | 2 Foundation | `planner.foundation` | org-chart | 스캐폴드 명세 + api-contract draft |
57
- | 3 Build | `planner.build` | feature-list | sprint-contract.md per Sprint |
58
- | 4 Hardening | `planner.hardening` | cqo-audit | 회귀·보안 회피 항목 별도 Sprint |
59
- | 5 Launch | `planner.launch` | DevOps + Service-Ops | 배포 체크리스트·Rollback 리허설 |
60
- | 6 Operate | `planner.operate` | ops-report·Auto-Retro | 정기 운영 Sprint 사이클 |
61
-
62
- `progress.json.phase` 값에 따라 Planner가 모드 자동 선택.
63
-
64
- ### A-2. Sprint 우선순위 알고리즘
65
-
66
- `product-sprint-prioritizer` 흡수. feature 우선순위는 다음 가중합:
67
-
68
- ```
69
- score = 0.4 * goal_alignment + 0.25 * risk_reduction + 0.2 * dependency_unblocking + 0.15 * effort_inverse
70
- ```
71
-
72
- 매 Sprint 종료 시 backlog 재정렬. 재정렬 결과 변경되면 다음 Sprint 시작 전 1줄 보고.
73
-
74
- ## B. HR 책임 (신규 흡수)
75
-
76
- 별도 부서 만들지 않고 Planner에 통합. 내부적으로 두 모듈로 분리.
77
-
78
- ### B-1. Recruiting (`recruit.md`)
79
-
80
- **입력**: Dispatcher의 org-chart 또는 CTO/Conductor의 채용 제안
81
-
82
- **프로세스**:
83
- ```
84
- 1. agency-agents 카탈로그(.harness/agency-mapping.md) 룩업
85
- 2. 후보 매칭:
86
- - 1순위: 우리 매핑에 ✅ 표시된 항목
87
- - 2순위: 같은 카테고리 다른 항목
88
- - 3순위: 직접 작성 (없는 경우)
89
- 3. Owner 승인 요청 (Dispatcher 경유)
90
- 4. 승인 시 import:
91
- - 원본 fetch (raw.githubusercontent.com)
92
- - skills/<role>/SKILL.md 로 변환
93
- - 상단에 출처 주석 + docmeta 추가
94
- 5. Onboarding 모듈로 핸드오프
95
- ```
96
-
97
- **제외 룰**: CN-only(WeChat/Weibo/Douyin/Baidu/Bilibili/Kuaishou/Xiaohongshu/Zhihu/Feishu) 자동 필터.
98
-
99
- ### B-2. Onboarding (`onboard.md`)
100
-
101
- **입력**: Recruiting 결과 + 현재 스택(scan-result)
102
-
103
- **프로세스**:
104
- ```
105
- 1. gotchas/<agent>.md 초안 생성 (공통 가드 + 스택별 적응)
106
- 2. .harness/ref/<role>-<stack>.md 작성 (best practice)
107
- 3. progress.json.org.<role> = "active"
108
- 4. dispatcher 라우팅 테이블 자동 갱신 (department selection 카탈로그에 추가)
109
- 5. Brick Office 대시보드에 책상 추가 (apps/harness-dashboard 데이터 갱신)
110
- 6. 첫 Sprint에 ramp-up feature 1건 자동 등록 (선택사항)
111
- ```
112
-
113
- ### B-3. Off-boarding
114
-
115
- Sprint 3회 연속 미사용 부서 → Off-boarding 후보:
116
- 1. 비활성 표시 (`progress.json.org.<role> = "inactive"`)
117
- 2. 파일은 보존 (재활성 가능)
118
- 3. dispatcher 라우팅에서만 제외
119
-
120
- ### B-4. HR 산출물
121
-
122
- `.harness/actions/hr-roster.md` (단일 문서, 갱신형):
123
-
124
- ```yaml
125
- ---
126
- docmeta: { ... }
127
- hr_roster:
128
- active:
129
- - role: generator-backend
130
- since: <iso>
131
- onboarded_from: <agency path or "native">
132
- inactive:
133
- - role: marketing
134
- since: <iso>
135
- reason: <text>
136
- recruiting:
137
- - role: evaluator-architecture
138
- requested_by: cto
139
- status: pending_owner_approval
140
- ---
141
- ```
142
-
143
- ### B-5. COO Direct Hypothesis Cell
144
-
145
- Planner는 정규 Sprint 라인과 별도로 다음 2개 직속 역할을 운영할 수 있다:
146
-
147
- - `coo-developer`: 빠른 spike, 백데이터 스크립트, throwaway prototype
148
- - `documentationer`: 웹 리서치, 실험 로그 정리, 보고서, 가설 유효/무효 판정
149
-
150
- 활성화 조건:
151
- 1. CEO가 기획안 탐색 또는 미검증 아이디어 검토를 지시
152
- 2. Service-Ops가 새 기획 방향 또는 drift 신호를 보고
153
- 3. CTO/CQO 정규 라인에 넣기 전에 빠른 사실 확인이 필요
154
-
155
- 운영 원칙:
156
- - 산출물은 정규 구현물이 아니라 `hypothesis brief`, `experiment note`, `validation report`
157
- - 코드 품질/테스트 완성도보다 의사결정 속도를 우선
158
- - 결과가 유효하면 Planner가 이를 정규 Sprint artifact로 재작성해 CTO 라인에 넘긴다
159
-
160
- ## C. 권한 (보강)
161
-
162
- 기존 권한에 추가:
163
- - `agency-mapping.md` 읽기 ✅
164
- - `hr-roster.md` 쓰기 ✅
165
- - 신규 부서 SKILL.md 생성·gotcha 초안 작성 ✅
166
- - 부서별 onboarding ref-doc 작성 ✅
167
-
168
- ## D. Conductor와의 인터페이스
169
-
170
- - Conductor 틱에서 `next_agent == "planner"` 시 Planner spawn
171
- - Conductor가 부서 채용 필요를 감지하면 Planner에 HR 모드 요청 (`mode: "hr-recruit"`)
172
- - Planner 산출물(sprint-contract·hr-roster)은 Conductor가 다음 틱에 자연스럽게 라우팅
173
-
174
- ## E. Meeting 참석 책임
175
-
176
- | 회의 | Planner 역할 |
177
- |---|---|
178
- | Standup | 미참석 (CTO·CQO·Service-Ops만) |
179
- | Sprint Review | 사회 보조 + 다음 Sprint 우선순위 정리 |
180
- | Spec Review | 발신 Eval의 Change Request를 feature-list·api-contract 변경안으로 변환 |
181
- | Incident War Room | 미참석 (긴급 운영 대응 중심) |
182
- | All-Hands (Phase Gate) | Phase 진입 prep 작성 (전 부서 인선 안 포함) |
@@ -1,34 +0,0 @@
1
- # API Contract Schema
2
-
3
- ```json
4
- {
5
- "version": "1.0.0",
6
- "gateway_base_url": "/api/v1",
7
- "services": {
8
- "gateway": { "port": 3000, "description": "API Gateway" },
9
- "service-a": { "port": 3001, "transport": "TCP", "description": "..." }
10
- },
11
- "endpoints": [
12
- {
13
- "id": "EP-001",
14
- "method": "POST",
15
- "path": "/api/v1/items",
16
- "gateway_route": true,
17
- "target_service": "service-a",
18
- "message_pattern": "create_item",
19
- "description": "...",
20
- "request_body": { "name": "string (required)" },
21
- "response_200": { "id": "number", "name": "string", "created_at": "string (ISO 8601)" },
22
- "response_errors": [
23
- { "status": 400, "when": "유효성 검증 실패" }
24
- ],
25
- "related_features": ["F-001"]
26
- }
27
- ]
28
- }
29
- ```
30
-
31
- ## 규칙
32
- - Gateway가 외부 진입점, 내부 서비스는 message pattern으로 통신
33
- - request/response 스키마는 Pydantic/class-validator로 직접 변환 가능한 수준
34
- - 이 계약서가 Frontend ↔ Gateway ↔ Services 간 유일한 진실의 원천
@@ -1,164 +0,0 @@
1
- ---
2
- docmeta:
3
- id: fe-stack-detection
4
- title: FE Stack Detection — Planner Responsibility
5
- type: output
6
- createdAt: 2026-04-09T00:00:00Z
7
- updatedAt: 2026-04-09T00:00:00Z
8
- source:
9
- producer: agent
10
- skillId: harness-planner
11
- inputs:
12
- - documentId: clue-fe-flutter-skill
13
- uri: ../../../../../moon_web/clue-fe-flutter.skill
14
- relation: output-from
15
- sections:
16
- - sourceRange:
17
- startLine: 1
18
- endLine: 103
19
- targetRange:
20
- startLine: 79
21
- endLine: 94
22
- - documentId: harness-planner-skill
23
- uri: ../SKILL.md
24
- relation: output-from
25
- sections:
26
- - sourceRange:
27
- startLine: 26
28
- endLine: 56
29
- targetRange:
30
- startLine: 27
31
- endLine: 78
32
- tags:
33
- - planner
34
- - fe-stack
35
- - flutter
36
- - pipeline
37
- ---
38
-
39
- # FE Stack Detection — Planner Responsibility
40
-
41
- Planner는 Sprint 1 착수 전 반드시 `fe_stack`을 확정하고 `pipeline.json`에 기록해야 한다.
42
-
43
- ## 1. 감지 순서 (자동)
44
-
45
- ```
46
- 1. .harness/actions/scan-result.json 의 tech_stack.fe_stack 읽기
47
- 2. 값이 "flutter" 또는 "react" 면 → 그대로 사용
48
- 3. 값이 없거나 "unknown" 이면 → 아래 추가 감지
49
- ```
50
-
51
- ### 추가 감지 (fallback)
52
-
53
- | 시그널 | 판정 |
54
- |--------|------|
55
- | 루트 `pubspec.yaml` + `flutter:` 키 존재 | `flutter` |
56
- | 하위 경로(예: `mobile/`, `apps/mobile/`, `clue_mobile_app/`)에 pubspec.yaml | `flutter` |
57
- | `package.json` 에 `react`, `next`, `vite` 등 | `react` |
58
- | `lib/` + `.dart` 파일 다수 | `flutter` |
59
- | 둘 다 존재 (Flutter + Web 혼재) | **사용자 질문 필수** |
60
-
61
- ## 2. 사용자 질문 (불명확 시 단 한 번)
62
-
63
- ```
64
- 프론트엔드 스택을 확인합니다:
65
-
66
- (A) React / Next.js / Vite 기반 Web
67
- (B) Flutter (Dart, 모바일/데스크톱)
68
-
69
- 현재 감지된 시그널:
70
- - pubspec.yaml: [있음/없음]
71
- - package.json: [있음/없음]
72
- - Next.js config: [있음/없음]
73
-
74
- 어떤 스택으로 진행하시겠습니까? (A/B)
75
- ```
76
-
77
- 혼재 프로젝트(Web + Flutter mobile)라면 사용자에게 **현 스프린트의 타깃**을 묻는다 — 파이프라인은 한 번에 하나의 `fe_stack`만 취급한다.
78
-
79
- ## 2.5 fe_target 확정 (Flutter 전용)
80
-
81
- `fe_stack == "flutter"` 인 경우, **반드시** `fe_target` 도 함께 확정해야 한다 (`web` | `mobile` | `desktop`).
82
- 이는 Flutter Web vs Mobile/Desktop 에서 사용 가능한 API, 빌드 명령, evaluator 가 달라지기 때문이다.
83
-
84
- ### 자동 감지 (scan-result.json 의 `tech_stack.fe_target`)
85
-
86
- | 시그널 | fe_target |
87
- |--------|-----------|
88
- | `<flutter_root>/web/index.html` 존재 | `web` |
89
- | `<flutter_root>/android/` 또는 `ios/` 존재, web/ 없음 | `mobile` |
90
- | `<flutter_root>/macos/`, `windows/`, `linux/` 존재 (mobile/web 없음) | `desktop` |
91
- | 없음 | `unknown` |
92
-
93
- ### 사용자 질문 (불명확하거나 multi-target)
94
-
95
- ```
96
- Flutter 프로젝트의 타깃을 확인합니다:
97
-
98
- (A) Web — 브라우저 (Chrome/Safari/Firefox), 컴파일 결과는 HTML+JS+CSS
99
- (B) Mobile — Android / iOS 네이티브 빌드
100
- (C) Desktop — macOS / Windows / Linux 네이티브 빌드
101
-
102
- 감지된 시그널:
103
- - web/index.html: [있음/없음]
104
- - android|ios/: [있음/없음]
105
- - macos|windows|linux/: [있음/없음]
106
-
107
- 이번 스프린트의 타깃은? (A/B/C)
108
- ```
109
-
110
- ### fe_target 과 Eval 흐름 (v5.6.5+)
111
-
112
- 에이전트 이름 치환은 하지 않는다. 모든 스택이 공통 `generator-frontend` / `evaluator-functional` / `evaluator-visual` 을 사용하고, 스택 특성은 `.harness/ref/fe-<stack>.md` (adaptive ref-docs) 의 `validation` 블록으로 조절된다.
113
-
114
- | fe_target | 전략 | 방법 |
115
- |-----------|------|------|
116
- | `web` (Flutter Web, Next.js 등) | 일반 Playwright 평가 | ref.validation.visual.enabled = true |
117
- | `mobile` (iOS/Android 네이티브) | Visual 은 MANUAL_REQUIRED | ref.validation.visual.enabled = false + functional_tests 에 스택 네이티브 명령 |
118
- | `desktop` (macOS/Windows/Linux 네이티브) | Visual MANUAL_REQUIRED | 동일 |
119
-
120
- Generator 는 `ref.runner.dev_command` / `ref.paths.*` 를 로드해 스택별 빌드·테스트·구조를 따른다.
121
-
122
- ## 3. pipeline.json 갱신
123
-
124
- `fe_stack` + `fe_target` 확정 후 `pipeline.json` 에 기록:
125
-
126
- ```json
127
- {
128
- "pipeline": "FULLSTACK",
129
- "planner_mode": "full",
130
- "fe_stack": "flutter",
131
- "fe_target": "mobile",
132
- "agents_active": [
133
- "planner",
134
- "generator-backend",
135
- "generator-frontend",
136
- "evaluator-code-quality",
137
- "evaluator-functional"
138
- ],
139
- "agents_skipped": [],
140
- "evaluator_mode": "native",
141
- "notes": "Flutter mobile — ref.validation.visual.enabled=false, evaluator-visual 은 MANUAL_REQUIRED 로 우회."
142
- }
143
- ```
144
-
145
- ### fe_stack + fe_target → 파이프라인 매핑
146
-
147
- | pipeline | 에이전트 체인 (스택 무관) | ref-docs 로 조절되는 부분 |
148
- |----------|--------------------------|---------------------------|
149
- | FULLSTACK | planner → gen-be → gen-fe → eval-code-quality → eval-func → eval-visual | Gen/Eval 모두 ref.* 로드 |
150
- | FE-ONLY | planner(light) → gen-fe → eval-code-quality → eval-func → eval-visual | 동일 |
151
- | BE-ONLY | planner → gen-be → eval-code-quality → eval-func | visual 체인 없음 |
152
-
153
- ## 4. Flutter 등 네이티브 스택 선택 시 추가 작업
154
-
155
- 1. **AGENTS.md IA-MAP** 의 `[FE]` 섹션에 해당 스택 구조 반영 (예: Flutter 면 `lib/ui/pages/`, `integrated_data_layer/` 등).
156
- 2. **api-contract.json** 은 언어 중립 스키마 JSON — Generator 가 스택 타입으로 변환.
157
- 3. **feature-list.json** 의 `layer: "frontend"` feature 에 `fe_stack` 태그 유지 (필터링 용도).
158
- 4. **`.harness/ref/fe-<stack>.md`** 의 `validation` 블록을 스택에 맞게 채워 두기 — 이게 실제 동작을 바꾸는 유일한 지점.
159
-
160
- ## 5. 금지
161
-
162
- - 파이프라인 실행 도중 `fe_stack` 변경 금지 — 스프린트 경계에서만 가능
163
- - 서로 다른 스택 코드 혼재 생성 금지 — Generator 는 하나의 stack만 담당
164
- - 사용자가 명시적으로 한 스택을 지시했는데 감지 결과로 다른 스택을 강제하지 말 것
@@ -1,31 +0,0 @@
1
- # IA-MAP Guide
2
-
3
- ## 형식
4
-
5
- ```
6
- ├── path/to/dir/ # [TAG] 한줄 설명 → 소유 에이전트
7
- ```
8
-
9
- ## 태그
10
-
11
- | 태그 | 의미 | 소유 |
12
- |------|------|------|
13
- | `[BE]` | Backend | Generator-Backend |
14
- | `[FE]` | Frontend | Generator-Frontend |
15
- | `[HARNESS]` | 하네스 시스템 | Planner / Evaluator |
16
- | `[META]` | 프로젝트 메타 | Planner |
17
- | `[INFRA]` | 인프라/배포 | Planner |
18
- | `[TEST]` | 테스트 코드 | Evaluator / Generator |
19
- | `[?]` | 미분류 | TBD (Planner가 확정) |
20
-
21
- ## 갱신 시점
22
-
23
- - Sprint 0 (최초): 전체 구조 설계
24
- - Sprint 간 전환: 새 폴더/파일 반영, Change Request 처리
25
- - Generator/Evaluator가 남긴 Change Request 검토 후 반영
26
-
27
- ## 규칙
28
-
29
- - Planner만 AGENTS.md 수정 가능
30
- - Generator는 sprint-contract.md에 `## Change Request`로 요청
31
- - Evaluator는 evaluation에 `## AGENTS.md Drift`로 보고