timsquad 2.1.0 → 3.4.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 (438) hide show
  1. package/README.ko.md +288 -0
  2. package/README.md +170 -763
  3. package/dist/commands/compile.d.ts +3 -0
  4. package/dist/commands/compile.d.ts.map +1 -0
  5. package/dist/commands/compile.js +170 -0
  6. package/dist/commands/compile.js.map +1 -0
  7. package/dist/commands/daemon.d.ts +7 -0
  8. package/dist/commands/daemon.d.ts.map +1 -0
  9. package/dist/commands/daemon.js +229 -0
  10. package/dist/commands/daemon.js.map +1 -0
  11. package/dist/commands/feedback.d.ts +9 -0
  12. package/dist/commands/feedback.d.ts.map +1 -1
  13. package/dist/commands/feedback.js +235 -14
  14. package/dist/commands/feedback.js.map +1 -1
  15. package/dist/commands/full.js +2 -2
  16. package/dist/commands/full.js.map +1 -1
  17. package/dist/commands/init.d.ts.map +1 -1
  18. package/dist/commands/init.js +118 -22
  19. package/dist/commands/init.js.map +1 -1
  20. package/dist/commands/knowledge.d.ts +3 -0
  21. package/dist/commands/knowledge.d.ts.map +1 -0
  22. package/dist/commands/knowledge.js +316 -0
  23. package/dist/commands/knowledge.js.map +1 -0
  24. package/dist/commands/log.d.ts +27 -0
  25. package/dist/commands/log.d.ts.map +1 -1
  26. package/dist/commands/log.js +965 -0
  27. package/dist/commands/log.js.map +1 -1
  28. package/dist/commands/meta-index.d.ts +3 -0
  29. package/dist/commands/meta-index.d.ts.map +1 -0
  30. package/dist/commands/meta-index.js +401 -0
  31. package/dist/commands/meta-index.js.map +1 -0
  32. package/dist/commands/metrics.d.ts.map +1 -1
  33. package/dist/commands/metrics.js +239 -4
  34. package/dist/commands/metrics.js.map +1 -1
  35. package/dist/commands/retro.js +154 -6
  36. package/dist/commands/retro.js.map +1 -1
  37. package/dist/commands/skills.d.ts +12 -0
  38. package/dist/commands/skills.d.ts.map +1 -0
  39. package/dist/commands/skills.js +231 -0
  40. package/dist/commands/skills.js.map +1 -0
  41. package/dist/commands/upgrade.d.ts +8 -0
  42. package/dist/commands/upgrade.d.ts.map +1 -0
  43. package/dist/commands/upgrade.js +292 -0
  44. package/dist/commands/upgrade.js.map +1 -0
  45. package/dist/commands/workflow.d.ts +3 -0
  46. package/dist/commands/workflow.d.ts.map +1 -0
  47. package/dist/commands/workflow.js +607 -0
  48. package/dist/commands/workflow.js.map +1 -0
  49. package/dist/daemon/context-writer.d.ts +16 -0
  50. package/dist/daemon/context-writer.d.ts.map +1 -0
  51. package/dist/daemon/context-writer.js +35 -0
  52. package/dist/daemon/context-writer.js.map +1 -0
  53. package/dist/daemon/entry.d.ts +7 -0
  54. package/dist/daemon/entry.d.ts.map +1 -0
  55. package/dist/daemon/entry.js +17 -0
  56. package/dist/daemon/entry.js.map +1 -0
  57. package/dist/daemon/event-queue.d.ts +52 -0
  58. package/dist/daemon/event-queue.d.ts.map +1 -0
  59. package/dist/daemon/event-queue.js +255 -0
  60. package/dist/daemon/event-queue.js.map +1 -0
  61. package/dist/daemon/file-watcher.d.ts +19 -0
  62. package/dist/daemon/file-watcher.d.ts.map +1 -0
  63. package/dist/daemon/file-watcher.js +87 -0
  64. package/dist/daemon/file-watcher.js.map +1 -0
  65. package/dist/daemon/index.d.ts +29 -0
  66. package/dist/daemon/index.d.ts.map +1 -0
  67. package/dist/daemon/index.js +296 -0
  68. package/dist/daemon/index.js.map +1 -0
  69. package/dist/daemon/jsonl-watcher.d.ts +49 -0
  70. package/dist/daemon/jsonl-watcher.d.ts.map +1 -0
  71. package/dist/daemon/jsonl-watcher.js +258 -0
  72. package/dist/daemon/jsonl-watcher.js.map +1 -0
  73. package/dist/daemon/meta-cache.d.ts +63 -0
  74. package/dist/daemon/meta-cache.d.ts.map +1 -0
  75. package/dist/daemon/meta-cache.js +249 -0
  76. package/dist/daemon/meta-cache.js.map +1 -0
  77. package/dist/daemon/session-state.d.ts +19 -0
  78. package/dist/daemon/session-state.d.ts.map +1 -0
  79. package/dist/daemon/session-state.js +132 -0
  80. package/dist/daemon/session-state.js.map +1 -0
  81. package/dist/daemon/shutdown.d.ts +21 -0
  82. package/dist/daemon/shutdown.d.ts.map +1 -0
  83. package/dist/daemon/shutdown.js +164 -0
  84. package/dist/daemon/shutdown.js.map +1 -0
  85. package/dist/index.js +24 -3
  86. package/dist/index.js.map +1 -1
  87. package/dist/lib/agent-composer.d.ts +38 -0
  88. package/dist/lib/agent-composer.d.ts.map +1 -0
  89. package/dist/lib/agent-composer.js +128 -0
  90. package/dist/lib/agent-composer.js.map +1 -0
  91. package/dist/lib/agent-generator.d.ts +22 -0
  92. package/dist/lib/agent-generator.d.ts.map +1 -0
  93. package/dist/lib/agent-generator.js +150 -0
  94. package/dist/lib/agent-generator.js.map +1 -0
  95. package/dist/lib/ast-parser.d.ts +11 -0
  96. package/dist/lib/ast-parser.d.ts.map +1 -0
  97. package/dist/lib/ast-parser.js +282 -0
  98. package/dist/lib/ast-parser.js.map +1 -0
  99. package/dist/lib/compile-rules.d.ts +66 -0
  100. package/dist/lib/compile-rules.d.ts.map +1 -0
  101. package/dist/lib/compile-rules.js +114 -0
  102. package/dist/lib/compile-rules.js.map +1 -0
  103. package/dist/lib/compiler.d.ts +105 -0
  104. package/dist/lib/compiler.d.ts.map +1 -0
  105. package/dist/lib/compiler.js +368 -0
  106. package/dist/lib/compiler.js.map +1 -0
  107. package/dist/lib/config.d.ts +7 -2
  108. package/dist/lib/config.d.ts.map +1 -1
  109. package/dist/lib/config.js +34 -3
  110. package/dist/lib/config.js.map +1 -1
  111. package/dist/lib/meta-index.d.ts +19 -0
  112. package/dist/lib/meta-index.d.ts.map +1 -0
  113. package/dist/lib/meta-index.js +573 -0
  114. package/dist/lib/meta-index.js.map +1 -0
  115. package/dist/lib/project.js +1 -1
  116. package/dist/lib/project.js.map +1 -1
  117. package/dist/lib/skill-generator.d.ts +32 -0
  118. package/dist/lib/skill-generator.d.ts.map +1 -0
  119. package/dist/lib/skill-generator.js +187 -0
  120. package/dist/lib/skill-generator.js.map +1 -0
  121. package/dist/lib/template.d.ts +16 -2
  122. package/dist/lib/template.d.ts.map +1 -1
  123. package/dist/lib/template.js +115 -20
  124. package/dist/lib/template.js.map +1 -1
  125. package/dist/lib/ui-index.d.ts +12 -0
  126. package/dist/lib/ui-index.d.ts.map +1 -0
  127. package/dist/lib/ui-index.js +239 -0
  128. package/dist/lib/ui-index.js.map +1 -0
  129. package/dist/lib/ui-parser.d.ts +12 -0
  130. package/dist/lib/ui-parser.d.ts.map +1 -0
  131. package/dist/lib/ui-parser.js +472 -0
  132. package/dist/lib/ui-parser.js.map +1 -0
  133. package/dist/lib/update-check.d.ts +6 -0
  134. package/dist/lib/update-check.d.ts.map +1 -0
  135. package/dist/lib/update-check.js +121 -0
  136. package/dist/lib/update-check.js.map +1 -0
  137. package/dist/lib/upgrade-backup.d.ts +33 -0
  138. package/dist/lib/upgrade-backup.d.ts.map +1 -0
  139. package/dist/lib/upgrade-backup.js +101 -0
  140. package/dist/lib/upgrade-backup.js.map +1 -0
  141. package/dist/lib/version.d.ts +19 -0
  142. package/dist/lib/version.d.ts.map +1 -0
  143. package/dist/lib/version.js +35 -0
  144. package/dist/lib/version.js.map +1 -0
  145. package/dist/lib/workflow-state.d.ts +48 -0
  146. package/dist/lib/workflow-state.d.ts.map +1 -0
  147. package/dist/lib/workflow-state.js +67 -0
  148. package/dist/lib/workflow-state.js.map +1 -0
  149. package/dist/types/config.d.ts +103 -2
  150. package/dist/types/config.d.ts.map +1 -1
  151. package/dist/types/config.js +184 -9
  152. package/dist/types/config.js.map +1 -1
  153. package/dist/types/feedback.d.ts +7 -0
  154. package/dist/types/feedback.d.ts.map +1 -1
  155. package/dist/types/feedback.js +1 -1
  156. package/dist/types/feedback.js.map +1 -1
  157. package/dist/types/index.d.ts +3 -0
  158. package/dist/types/index.d.ts.map +1 -1
  159. package/dist/types/index.js +3 -0
  160. package/dist/types/index.js.map +1 -1
  161. package/dist/types/meta-index.d.ts +146 -0
  162. package/dist/types/meta-index.d.ts.map +1 -0
  163. package/dist/types/meta-index.js +7 -0
  164. package/dist/types/meta-index.js.map +1 -0
  165. package/dist/types/project.d.ts +19 -3
  166. package/dist/types/project.d.ts.map +1 -1
  167. package/dist/types/project.js +23 -0
  168. package/dist/types/project.js.map +1 -1
  169. package/dist/types/task-log.d.ts +208 -0
  170. package/dist/types/task-log.d.ts.map +1 -0
  171. package/dist/types/task-log.js +6 -0
  172. package/dist/types/task-log.js.map +1 -0
  173. package/dist/types/ui-meta.d.ts +118 -0
  174. package/dist/types/ui-meta.d.ts.map +1 -0
  175. package/dist/types/ui-meta.js +7 -0
  176. package/dist/types/ui-meta.js.map +1 -0
  177. package/package.json +12 -4
  178. package/templates/base/agents/base/tsq-architect.md +68 -0
  179. package/templates/base/agents/base/tsq-dba.md +56 -0
  180. package/templates/base/agents/base/tsq-designer.md +72 -0
  181. package/templates/base/agents/base/tsq-developer.md +67 -0
  182. package/templates/base/agents/base/tsq-qa.md +55 -0
  183. package/templates/base/agents/base/tsq-security.md +65 -0
  184. package/templates/base/agents/overlays/domain/general-web/_common.md +11 -0
  185. package/templates/base/agents/overlays/domain/mobile/_common.md +13 -0
  186. package/templates/base/agents/overlays/platform/claude-code.md +12 -0
  187. package/templates/base/config.template.yaml +213 -0
  188. package/templates/base/knowledge/checklists/accessibility.md +37 -0
  189. package/templates/base/knowledge/checklists/architecture-review.md +28 -0
  190. package/templates/base/knowledge/checklists/database-standards.md +84 -0
  191. package/templates/base/knowledge/checklists/design-reference.md +97 -0
  192. package/templates/base/knowledge/checklists/security.md +50 -0
  193. package/templates/base/knowledge/checklists/ssot-validation.md +19 -0
  194. package/templates/base/knowledge/domains/_template.md +16 -0
  195. package/templates/base/knowledge/platforms/_template.md +16 -0
  196. package/templates/base/knowledge/templates/sequence-report.md +44 -0
  197. package/templates/base/knowledge/templates/task-result.md +105 -0
  198. package/templates/base/skills/_template/SKILL.md +59 -0
  199. package/templates/base/skills/_template/references/_template.md +35 -0
  200. package/templates/base/skills/_template/rules/_sections.md +34 -0
  201. package/templates/base/skills/_template/rules/_template.md +32 -0
  202. package/templates/base/skills/_template/scripts/_template.sh +31 -0
  203. package/templates/base/skills/architecture/SKILL.md +54 -0
  204. package/templates/base/skills/architecture/references/adr-template.md +50 -0
  205. package/templates/base/skills/architecture/references/api-design.md +64 -0
  206. package/templates/base/skills/backend/node/SKILL.md +81 -0
  207. package/templates/base/skills/backend/node/rules/async-patterns.md +81 -0
  208. package/templates/base/skills/backend/node/rules/deployment.md +33 -0
  209. package/templates/base/skills/backend/node/rules/env-config.md +41 -0
  210. package/templates/base/skills/backend/node/rules/error-handling.md +83 -0
  211. package/templates/base/skills/backend/node/rules/hono-app-setup.md +98 -0
  212. package/templates/base/skills/backend/node/rules/jwt-auth.md +76 -0
  213. package/templates/base/skills/backend/node/rules/middleware.md +56 -0
  214. package/templates/base/skills/backend/node/rules/testing.md +82 -0
  215. package/templates/base/skills/coding/SKILL.md +47 -0
  216. package/templates/base/skills/coding/rules/patterns.md +81 -0
  217. package/templates/base/skills/controller/SKILL.md +111 -0
  218. package/templates/base/skills/controller/references/README.md +35 -0
  219. package/templates/base/skills/controller/rules/README.md +18 -0
  220. package/templates/base/skills/database/SKILL.md +98 -0
  221. package/templates/base/skills/database/prisma/SKILL.md +57 -0
  222. package/templates/base/skills/database/prisma/rules/queries.md +133 -0
  223. package/templates/base/skills/database/prisma/rules/schema-design.md +80 -0
  224. package/templates/base/skills/frontend/nextjs/SKILL.md +59 -0
  225. package/templates/base/skills/frontend/nextjs/rules/app-router.md +138 -0
  226. package/templates/base/skills/frontend/react/SKILL.md +86 -0
  227. package/templates/base/skills/frontend/react/rules/_sections.md +88 -0
  228. package/templates/base/skills/frontend/react/rules/anti-patterns.md +67 -0
  229. package/templates/base/skills/frontend/react/rules/async-api-routes.md +38 -0
  230. package/templates/base/skills/frontend/react/rules/async-defer-await.md +80 -0
  231. package/templates/base/skills/frontend/react/rules/async-dependencies.md +36 -0
  232. package/templates/base/skills/frontend/react/rules/async-parallel.md +28 -0
  233. package/templates/base/skills/frontend/react/rules/async-suspense-boundaries.md +99 -0
  234. package/templates/base/skills/frontend/react/rules/bundle-barrel-imports.md +59 -0
  235. package/templates/base/skills/frontend/react/rules/bundle-defer-third-party.md +49 -0
  236. package/templates/base/skills/frontend/react/rules/bundle-dynamic-imports.md +35 -0
  237. package/templates/base/skills/frontend/react/rules/component-conventions.md +74 -0
  238. package/templates/base/skills/frontend/react/rules/js-combine-iterations.md +32 -0
  239. package/templates/base/skills/frontend/react/rules/js-early-exit.md +50 -0
  240. package/templates/base/skills/frontend/react/rules/js-index-maps.md +37 -0
  241. package/templates/base/skills/frontend/react/rules/js-set-map-lookups.md +24 -0
  242. package/templates/base/skills/frontend/react/rules/rendering-conditional-render.md +40 -0
  243. package/templates/base/skills/frontend/react/rules/rendering-content-visibility.md +38 -0
  244. package/templates/base/skills/frontend/react/rules/rendering-hoist-jsx.md +46 -0
  245. package/templates/base/skills/frontend/react/rules/rerender-defer-reads.md +39 -0
  246. package/templates/base/skills/frontend/react/rules/rerender-derived-state.md +29 -0
  247. package/templates/base/skills/frontend/react/rules/rerender-memo.md +44 -0
  248. package/templates/base/skills/frontend/react/rules/rerender-transitions.md +40 -0
  249. package/templates/base/skills/frontend/react/rules/server-after-nonblocking.md +73 -0
  250. package/templates/base/skills/frontend/react/rules/server-cache-react.md +26 -0
  251. package/templates/base/skills/frontend/react/rules/server-parallel-fetching.md +79 -0
  252. package/templates/base/skills/frontend/react/rules/state-location.md +55 -0
  253. package/templates/base/skills/methodology/bdd/SKILL.md +69 -0
  254. package/templates/base/skills/methodology/bdd/rules/gherkin-patterns.md +113 -0
  255. package/templates/base/skills/methodology/ddd/SKILL.md +74 -0
  256. package/templates/base/skills/methodology/ddd/rules/strategic-patterns.md +98 -0
  257. package/templates/base/skills/methodology/debugging/SKILL.md +60 -0
  258. package/templates/base/skills/methodology/debugging/references/root-cause-tracing.md +84 -0
  259. package/templates/base/skills/methodology/tdd/SKILL.md +66 -0
  260. package/templates/base/skills/methodology/tdd/rules/real-world-example.md +88 -0
  261. package/templates/base/skills/methodology/tdd/rules/techniques.md +185 -0
  262. package/templates/base/skills/mobile/dart/SKILL.md +69 -0
  263. package/templates/base/skills/mobile/dart/rules/async-patterns.md +112 -0
  264. package/templates/base/skills/mobile/dart/rules/code-style.md +96 -0
  265. package/templates/base/skills/mobile/dart/rules/null-safety.md +84 -0
  266. package/templates/base/skills/mobile/dart/rules/type-system.md +111 -0
  267. package/templates/base/skills/mobile/flutter/SKILL.md +89 -0
  268. package/templates/base/skills/mobile/flutter/ci-cd/SKILL.md +82 -0
  269. package/templates/base/skills/mobile/flutter/ci-cd/references/ci-cd-pipeline.md +314 -0
  270. package/templates/base/skills/mobile/flutter/ci-cd/rules/code-signing.md +106 -0
  271. package/templates/base/skills/mobile/flutter/ci-cd/rules/codemagic-setup.md +116 -0
  272. package/templates/base/skills/mobile/flutter/ci-cd/rules/fastlane-setup.md +105 -0
  273. package/templates/base/skills/mobile/flutter/ci-cd/rules/github-actions.md +112 -0
  274. package/templates/base/skills/mobile/flutter/ci-cd/rules/store-deployment.md +106 -0
  275. package/templates/base/skills/mobile/flutter/ci-cd/rules/versioning.md +107 -0
  276. package/templates/base/skills/mobile/flutter/i18n/SKILL.md +78 -0
  277. package/templates/base/skills/mobile/flutter/i18n/references/i18n-architecture.md +225 -0
  278. package/templates/base/skills/mobile/flutter/i18n/rules/arb-files.md +182 -0
  279. package/templates/base/skills/mobile/flutter/i18n/rules/locale-switching.md +226 -0
  280. package/templates/base/skills/mobile/flutter/i18n/rules/localization-setup.md +137 -0
  281. package/templates/base/skills/mobile/flutter/i18n/rules/plural-gender.md +159 -0
  282. package/templates/base/skills/mobile/flutter/i18n/rules/text-direction.md +199 -0
  283. package/templates/base/skills/mobile/flutter/monitoring/SKILL.md +81 -0
  284. package/templates/base/skills/mobile/flutter/monitoring/references/monitoring-architecture.md +269 -0
  285. package/templates/base/skills/mobile/flutter/monitoring/rules/analytics.md +227 -0
  286. package/templates/base/skills/mobile/flutter/monitoring/rules/crashlytics-setup.md +195 -0
  287. package/templates/base/skills/mobile/flutter/monitoring/rules/logging.md +258 -0
  288. package/templates/base/skills/mobile/flutter/monitoring/rules/performance-monitoring.md +248 -0
  289. package/templates/base/skills/mobile/flutter/monitoring/rules/sentry-integration.md +249 -0
  290. package/templates/base/skills/mobile/flutter/networking/SKILL.md +88 -0
  291. package/templates/base/skills/mobile/flutter/networking/references/api-client-architecture.md +305 -0
  292. package/templates/base/skills/mobile/flutter/networking/rules/caching.md +212 -0
  293. package/templates/base/skills/mobile/flutter/networking/rules/connectivity.md +213 -0
  294. package/templates/base/skills/mobile/flutter/networking/rules/dio-setup.md +159 -0
  295. package/templates/base/skills/mobile/flutter/networking/rules/error-handling.md +209 -0
  296. package/templates/base/skills/mobile/flutter/networking/rules/interceptors.md +205 -0
  297. package/templates/base/skills/mobile/flutter/networking/rules/retrofit-patterns.md +194 -0
  298. package/templates/base/skills/mobile/flutter/push-notifications/SKILL.md +87 -0
  299. package/templates/base/skills/mobile/flutter/push-notifications/references/notification-architecture.md +340 -0
  300. package/templates/base/skills/mobile/flutter/push-notifications/references/platform-setup.md +286 -0
  301. package/templates/base/skills/mobile/flutter/push-notifications/rules/background-processing.md +308 -0
  302. package/templates/base/skills/mobile/flutter/push-notifications/rules/deep-linking.md +217 -0
  303. package/templates/base/skills/mobile/flutter/push-notifications/rules/fcm-setup.md +164 -0
  304. package/templates/base/skills/mobile/flutter/push-notifications/rules/local-notifications.md +262 -0
  305. package/templates/base/skills/mobile/flutter/push-notifications/rules/notification-handling.md +210 -0
  306. package/templates/base/skills/mobile/flutter/push-notifications/rules/notification-permissions.md +246 -0
  307. package/templates/base/skills/mobile/flutter/push-notifications/rules/rich-notifications.md +320 -0
  308. package/templates/base/skills/mobile/flutter/references/freezed-patterns.md +162 -0
  309. package/templates/base/skills/mobile/flutter/references/project-structure.md +170 -0
  310. package/templates/base/skills/mobile/flutter/rules/animations.md +112 -0
  311. package/templates/base/skills/mobile/flutter/rules/architecture.md +121 -0
  312. package/templates/base/skills/mobile/flutter/rules/navigation-routing.md +117 -0
  313. package/templates/base/skills/mobile/flutter/rules/performance.md +112 -0
  314. package/templates/base/skills/mobile/flutter/rules/platform-adaptive.md +126 -0
  315. package/templates/base/skills/mobile/flutter/rules/state-management.md +110 -0
  316. package/templates/base/skills/mobile/flutter/rules/testing.md +131 -0
  317. package/templates/base/skills/mobile/flutter/rules/widget-conventions.md +122 -0
  318. package/templates/base/skills/mobile/flutter/security/SKILL.md +86 -0
  319. package/templates/base/skills/mobile/flutter/security/references/mobile-security-checklist.md +168 -0
  320. package/templates/base/skills/mobile/flutter/security/rules/api-key-protection.md +206 -0
  321. package/templates/base/skills/mobile/flutter/security/rules/authentication.md +248 -0
  322. package/templates/base/skills/mobile/flutter/security/rules/data-protection.md +271 -0
  323. package/templates/base/skills/mobile/flutter/security/rules/obfuscation.md +213 -0
  324. package/templates/base/skills/mobile/flutter/security/rules/secure-storage.md +171 -0
  325. package/templates/base/skills/mobile/flutter/security/rules/ssl-pinning.md +197 -0
  326. package/templates/base/skills/planning/SKILL.md +58 -0
  327. package/templates/base/skills/planning/references/prd-guide.md +47 -0
  328. package/templates/base/skills/planning/references/requirements-guide.md +46 -0
  329. package/templates/base/skills/prompt-engineering/SKILL.md +103 -0
  330. package/templates/base/skills/retrospective/SKILL.md +102 -0
  331. package/templates/base/skills/security/SKILL.md +55 -0
  332. package/templates/base/skills/security/rules/owasp-examples.md +119 -0
  333. package/templates/base/skills/security/scripts/check-secrets.sh +55 -0
  334. package/templates/base/skills/testing/SKILL.md +63 -0
  335. package/templates/base/skills/testing/references/testing-patterns.md +103 -0
  336. package/templates/base/skills/tsq-protocol/SKILL.md +51 -0
  337. package/templates/base/skills/typescript/SKILL.md +67 -0
  338. package/templates/base/skills/typescript/rules/type-patterns.md +135 -0
  339. package/templates/base/skills/typescript/rules/utility-types.md +76 -0
  340. package/templates/base/skills/ui-design/SKILL.md +70 -0
  341. package/templates/{common → base}/timsquad/feedback/routing-rules.yaml +1 -1
  342. package/templates/{common → base}/timsquad/retrospective/metrics/metrics-schema.json +46 -1
  343. package/templates/platforms/claude-code/CLAUDE.md.template +89 -0
  344. package/templates/platforms/claude-code/rules/adr-rules.md +32 -0
  345. package/templates/platforms/claude-code/rules/feedback-routing.md +18 -0
  346. package/templates/platforms/claude-code/rules/phase-management.md +23 -0
  347. package/templates/platforms/claude-code/rules/reporting-format.md +26 -0
  348. package/templates/platforms/claude-code/rules/sequence-management.md +72 -0
  349. package/templates/platforms/claude-code/rules/workspace-sync.md +33 -0
  350. package/templates/platforms/claude-code/scripts/completion-guard.sh +57 -0
  351. package/templates/platforms/claude-code/scripts/phase-guard.sh +79 -0
  352. package/templates/platforms/claude-code/settings.json +98 -0
  353. package/templates/project-types/api-backend/config.yaml +227 -0
  354. package/templates/project-types/api-backend/process/workflow.xml +214 -0
  355. package/templates/project-types/fintech/config.yaml +151 -0
  356. package/templates/project-types/fintech/process/workflow.xml +316 -0
  357. package/templates/project-types/infra/config.yaml +327 -0
  358. package/templates/project-types/infra/process/workflow.xml +296 -0
  359. package/templates/project-types/mobile-app/config.yaml +123 -0
  360. package/templates/project-types/mobile-app/process/workflow.xml +191 -0
  361. package/templates/project-types/platform/config.yaml +254 -0
  362. package/templates/project-types/platform/process/workflow.xml +254 -0
  363. package/templates/project-types/web-app/config.yaml +198 -0
  364. package/templates/project-types/web-app/process/workflow.xml +210 -0
  365. package/templates/project-types/web-service/config.yaml +136 -0
  366. package/templates/project-types/web-service/process/workflow.xml +184 -0
  367. package/templates/common/CLAUDE.md.template +0 -254
  368. package/templates/common/claude/agents/tsq-dba.md +0 -311
  369. package/templates/common/claude/agents/tsq-designer.md +0 -323
  370. package/templates/common/claude/agents/tsq-developer.md +0 -177
  371. package/templates/common/claude/agents/tsq-planner.md +0 -190
  372. package/templates/common/claude/agents/tsq-prompter.md +0 -356
  373. package/templates/common/claude/agents/tsq-qa.md +0 -168
  374. package/templates/common/claude/agents/tsq-retro.md +0 -193
  375. package/templates/common/claude/agents/tsq-security.md +0 -221
  376. package/templates/common/claude/hooks/auto-metrics.sh +0 -165
  377. package/templates/common/claude/hooks/auto-worklog.sh +0 -245
  378. package/templates/common/claude/hooks/event-logger.sh +0 -208
  379. package/templates/common/claude/settings.json +0 -86
  380. package/templates/common/claude/skills/architecture/SKILL.md +0 -123
  381. package/templates/common/claude/skills/backend/node/SKILL.md +0 -1015
  382. package/templates/common/claude/skills/coding/SKILL.md +0 -171
  383. package/templates/common/claude/skills/database/prisma/SKILL.md +0 -357
  384. package/templates/common/claude/skills/frontend/nextjs/SKILL.md +0 -279
  385. package/templates/common/claude/skills/frontend/react/SKILL.md +0 -1729
  386. package/templates/common/claude/skills/methodology/bdd/SKILL.md +0 -234
  387. package/templates/common/claude/skills/methodology/ddd/SKILL.md +0 -311
  388. package/templates/common/claude/skills/methodology/tdd/SKILL.md +0 -512
  389. package/templates/common/claude/skills/planning/SKILL.md +0 -90
  390. package/templates/common/claude/skills/security/SKILL.md +0 -234
  391. package/templates/common/claude/skills/testing/SKILL.md +0 -146
  392. package/templates/common/claude/skills/typescript/SKILL.md +0 -435
  393. package/templates/common/config.template.yaml +0 -132
  394. /package/templates/{common → base}/timsquad/architectures/clean/ARCHITECTURE.md +0 -0
  395. /package/templates/{common → base}/timsquad/architectures/clean/backend.xml +0 -0
  396. /package/templates/{common → base}/timsquad/architectures/clean/frontend.xml +0 -0
  397. /package/templates/{common → base}/timsquad/architectures/fsd/ARCHITECTURE.md +0 -0
  398. /package/templates/{common → base}/timsquad/architectures/fsd/frontend.xml +0 -0
  399. /package/templates/{common → base}/timsquad/architectures/hexagonal/ARCHITECTURE.md +0 -0
  400. /package/templates/{common → base}/timsquad/architectures/hexagonal/backend.xml +0 -0
  401. /package/templates/{common → base}/timsquad/constraints/competency-framework.xml +0 -0
  402. /package/templates/{common → base}/timsquad/constraints/ssot-schema.xml +0 -0
  403. /package/templates/{common → base}/timsquad/feedback/feedback-router.sh +0 -0
  404. /package/templates/{common → base}/timsquad/generators/data-design.xml +0 -0
  405. /package/templates/{common → base}/timsquad/generators/prd.xml +0 -0
  406. /package/templates/{common → base}/timsquad/generators/requirements.xml +0 -0
  407. /package/templates/{common → base}/timsquad/generators/service-spec.xml +0 -0
  408. /package/templates/{common → base}/timsquad/logs/_example.md +0 -0
  409. /package/templates/{common → base}/timsquad/logs/_template.md +0 -0
  410. /package/templates/{common → base}/timsquad/patterns/cqrs.xml +0 -0
  411. /package/templates/{common → base}/timsquad/patterns/event-sourcing.xml +0 -0
  412. /package/templates/{common → base}/timsquad/patterns/repository.xml +0 -0
  413. /package/templates/{common → base}/timsquad/process/phase-checklist.yaml +0 -0
  414. /package/templates/{common → base}/timsquad/process/state-machine.xml +0 -0
  415. /package/templates/{common → base}/timsquad/process/validation-rules.xml +0 -0
  416. /package/templates/{common → base}/timsquad/process/workflow-base.xml +0 -0
  417. /package/templates/{common → base}/timsquad/retrospective/cycle-report.template.md +0 -0
  418. /package/templates/{common → base}/timsquad/retrospective/patterns/failure-patterns.md +0 -0
  419. /package/templates/{common → base}/timsquad/retrospective/patterns/success-patterns.md +0 -0
  420. /package/templates/{common → base}/timsquad/retrospective/retrospective-config.xml +0 -0
  421. /package/templates/{common → base}/timsquad/retrospective/retrospective-state.xml +0 -0
  422. /package/templates/{common → base}/timsquad/ssot/adr/ADR-000-template.md +0 -0
  423. /package/templates/{common → base}/timsquad/ssot/adr/ADR-001-example.md +0 -0
  424. /package/templates/{common → base}/timsquad/ssot/data-design.template.md +0 -0
  425. /package/templates/{common → base}/timsquad/ssot/deployment-spec.template.md +0 -0
  426. /package/templates/{common → base}/timsquad/ssot/env-config.template.md +0 -0
  427. /package/templates/{common → base}/timsquad/ssot/error-codes.template.md +0 -0
  428. /package/templates/{common → base}/timsquad/ssot/functional-spec.template.md +0 -0
  429. /package/templates/{common → base}/timsquad/ssot/glossary.template.md +0 -0
  430. /package/templates/{common → base}/timsquad/ssot/integration-spec.template.md +0 -0
  431. /package/templates/{common → base}/timsquad/ssot/planning.template.md +0 -0
  432. /package/templates/{common → base}/timsquad/ssot/prd.template.md +0 -0
  433. /package/templates/{common → base}/timsquad/ssot/requirements.template.md +0 -0
  434. /package/templates/{common → base}/timsquad/ssot/security-spec.template.md +0 -0
  435. /package/templates/{common → base}/timsquad/ssot/service-spec.template.md +0 -0
  436. /package/templates/{common → base}/timsquad/ssot/test-spec.template.md +0 -0
  437. /package/templates/{common → base}/timsquad/ssot/ui-ux-spec.template.md +0 -0
  438. /package/templates/{common → base}/timsquad/state/workspace.xml +0 -0
@@ -1,356 +0,0 @@
1
- ---
2
- name: tsq-prompter
3
- description: |
4
- TimSquad Prompter 에이전트.
5
- 프롬프트 최적화, 템플릿 관리, 회고 기반 개선 담당.
6
- Agentsway 논문의 Prompting Agent 개념 구현.
7
- @tsq-prompter로 호출.
8
- model: opus
9
- theoretical_basis: "Agentsway (arXiv:2510.23664) - Prompting Agent"
10
- tools: [Read, Write, Edit, Bash, Grep, Glob]
11
- ---
12
-
13
- # TimSquad Prompter Agent
14
-
15
- ## TSQ CLI 사용 규칙 (필수)
16
-
17
- > **로그 기록, 피드백, 메트릭 등 TSQ CLI가 제공하는 기능은 반드시 CLI 커맨드를 사용하세요.**
18
- > 직접 파일을 조작하지 마세요. CLI를 사용해야 구조화된 데이터가 자동 저장됩니다.
19
-
20
- | 시점 | 커맨드 |
21
- |-----|--------|
22
- | 작업 시작 | `tsq log add prompter work "TASK-XXX 시작: {설명}"` |
23
- | 결정 기록 | `tsq log add prompter decision "{결정 내용}"` |
24
- | 이슈 발견 | `tsq feedback "{프롬프트 이슈 설명}"` |
25
- | 메트릭 확인 | `tsq metrics summary` |
26
- | 작업 완료 | `tsq log add prompter work "TASK-XXX 완료: {결과}"` |
27
-
28
- **금지사항:**
29
- - 직접 `.timsquad/logs/` 파일 생성/수정 금지 (`tsq log` 사용)
30
- - 직접 `.timsquad/feedback/` 파일 생성 금지 (`tsq feedback` 사용)
31
-
32
- ---
33
-
34
- > **이론적 기반**: Agentsway 논문의 Prompting Agent
35
- > "The framework introduces Prompting Agents that transform planner intentions
36
- > into optimized prompts for specialized agents."
37
-
38
- ## 페르소나
39
-
40
- 10년 경력의 프롬프트 엔지니어 겸 LLM 전문가.
41
- - Anthropic Claude 프롬프트 최적화 전문
42
- - 다양한 도메인 프롬프트 설계 경험
43
- - LLM의 행동 패턴과 한계에 대한 깊은 이해
44
- - 측정 가능한 개선에 집중
45
-
46
- ## 역할
47
-
48
- 1. **프롬프트 최적화**: Planner 의도를 최적화된 프롬프트로 변환
49
- 2. **템플릿 관리**: 프롬프트 템플릿 버전 관리
50
- 3. **품질 검증**: 프롬프트 품질 검증 및 A/B 테스트
51
- 4. **회고 기반 개선**: 회고 결과를 반영한 프롬프트 진화
52
-
53
- ## 작업 전 필수 확인
54
-
55
- ```xml
56
- <mandatory-references>
57
- <reference path=".timsquad/retrospective/patterns/">패턴 데이터</reference>
58
- <reference path=".timsquad/retrospective/improvements/">개선 이력</reference>
59
- <reference path=".claude/agents/">현재 에이전트 정의</reference>
60
- <reference path=".claude/skills/">현재 스킬 정의</reference>
61
- </mandatory-references>
62
- ```
63
-
64
- ---
65
-
66
- ## 프롬프트 최적화 원칙
67
-
68
- ### 1. 구조화 (Structure)
69
-
70
- ```markdown
71
- # [역할/에이전트명]
72
-
73
- ## 페르소나
74
- [구체적인 전문가 정의]
75
-
76
- ## 작업 전 필수
77
- [참조해야 할 문서/파일]
78
-
79
- ## 핵심 원칙
80
- [준수해야 할 규칙]
81
-
82
- ## 작업 프로세스
83
- [단계별 절차]
84
-
85
- ## 출력 형식
86
- [기대하는 결과물 형식]
87
-
88
- ## 금지 사항
89
- [하지 말아야 할 것]
90
-
91
- ## 예시
92
- [Good/Bad 예시]
93
- ```
94
-
95
- ### 2. 명확성 (Clarity)
96
-
97
- | 원칙 | 설명 | Bad | Good |
98
- |-----|------|-----|------|
99
- | 구체적 지시 | 모호함 제거 | "잘 작성해" | "3문장 이내로 요약해" |
100
- | 측정 가능 | 기준 명시 | "좋은 코드" | "테스트 커버리지 80%" |
101
- | 우선순위 | 중요도 표시 | 나열만 | "필수/권장/선택" 분류 |
102
-
103
- ### 3. 컨텍스트 (Context)
104
-
105
- ```markdown
106
- ## 작업 컨텍스트
107
-
108
- ### 프로젝트 정보
109
- - 프로젝트: {{PROJECT_NAME}}
110
- - 타입: {{PROJECT_TYPE}}
111
- - 현재 Phase: {{CURRENT_PHASE}}
112
-
113
- ### 참조 문서
114
- - SSOT: [관련 문서 경로]
115
- - 이전 작업: [workspace.xml 참조]
116
-
117
- ### 제약 사항
118
- - [적용되는 제약]
119
- ```
120
-
121
- ### 4. 예시 포함 (Examples)
122
-
123
- ```markdown
124
- ## 예시
125
-
126
- ### Good Example
127
- ```code
128
- // 좋은 예시 코드/결과물
129
- ```
130
- **왜 좋은가**: [설명]
131
-
132
- ### Bad Example
133
- ```code
134
- // 나쁜 예시 코드/결과물
135
- ```
136
- **왜 나쁜가**: [설명]
137
- ```
138
-
139
- ---
140
-
141
- ## 프롬프트 템플릿
142
-
143
- ### 템플릿 디렉토리 구조
144
-
145
- ```
146
- .timsquad/prompts/
147
- ├── agents/
148
- │ ├── developer/
149
- │ │ ├── implement-feature.md
150
- │ │ ├── fix-bug.md
151
- │ │ └── refactor.md
152
- │ ├── qa/
153
- │ │ ├── review-code.md
154
- │ │ └── write-tests.md
155
- │ └── security/
156
- │ └── security-audit.md
157
- ├── tasks/
158
- │ ├── planning.md
159
- │ ├── coding.md
160
- │ └── review.md
161
- └── changelog.md
162
- ```
163
-
164
- ### 템플릿 형식
165
-
166
- ```markdown
167
- ---
168
- name: implement-feature
169
- version: 1.0.0
170
- agent: tsq-developer
171
- task_type: implementation
172
- last_updated: {{DATE}}
173
- effectiveness_score: 85
174
- ---
175
-
176
- # Feature Implementation Prompt
177
-
178
- ## 컨텍스트 주입
179
- {{CONTEXT}}
180
-
181
- ## 작업 정의
182
- {{TASK_DESCRIPTION}}
183
-
184
- ## SSOT 참조
185
- {{SSOT_REFERENCES}}
186
-
187
- ## 출력 요구사항
188
- {{OUTPUT_REQUIREMENTS}}
189
-
190
- ## 검증 기준
191
- {{VALIDATION_CRITERIA}}
192
- ```
193
-
194
- ---
195
-
196
- ## 프롬프트 진화 프로세스
197
-
198
- ### Iterative Refinement (Self-Refine 기반)
199
-
200
- ```
201
- ┌─────────┐ ┌──────────┐ ┌─────────┐ ┌─────────┐
202
- │ 프롬프트 │ → │ 실행 │ → │ 결과 │ → │ 피드백 │
203
- │ v1.0 │ │ (에이전트)│ │ 분석 │ │ 수집 │
204
- └─────────┘ └──────────┘ └─────────┘ └────┬────┘
205
-
206
- ┌─────────┐ ┌──────────┐ ┌─────────┐ │
207
- │ 프롬프트 │ ← │ 개선안 │ ← │ 패턴 │ ←────┘
208
- │ v1.1 │ │ 생성 │ │ 분석 │
209
- └─────────┘ └──────────┘ └─────────┘
210
- ```
211
-
212
- ### 버전 관리 규칙
213
-
214
- | 변경 유형 | 버전 증가 | 예시 |
215
- |---------|----------|------|
216
- | 구조 변경 | Major (x.0.0) | 섹션 추가/삭제 |
217
- | 내용 수정 | Minor (0.x.0) | 규칙 추가, 예시 수정 |
218
- | 오타 수정 | Patch (0.0.x) | 단순 수정 |
219
-
220
- ### 롤백 조건
221
-
222
- | 조건 | 액션 |
223
- |-----|------|
224
- | 성공률 10% 하락 | 이전 버전 롤백 |
225
- | Critical 피드백 발생 | 즉시 롤백 + 분석 |
226
- | A/B 테스트 실패 | 기존 버전 유지 |
227
-
228
- ---
229
-
230
- ## 회고 기반 개선
231
-
232
- ### 패턴 → 프롬프트 개선 매핑
233
-
234
- ```xml
235
- <improvement-mapping>
236
- <pattern id="FP-001" type="failure">
237
- <description>SSOT 미참조 구현</description>
238
- <prompt-change>
239
- <target>tsq-developer.md</target>
240
- <section>작업 전 필수</section>
241
- <action>SSOT 체크리스트 강화</action>
242
- </prompt-change>
243
- </pattern>
244
-
245
- <pattern id="SP-001" type="success">
246
- <description>SSOT 먼저, 코드 나중</description>
247
- <prompt-change>
248
- <target>전체 에이전트</target>
249
- <action>SSOT 참조 우선 규칙 표준화</action>
250
- </prompt-change>
251
- </pattern>
252
- </improvement-mapping>
253
- ```
254
-
255
- ### 개선 제안 형식
256
-
257
- ```markdown
258
- ## PROMPT-IMP-XXX: [개선 제목]
259
-
260
- ### 관련 정보
261
- | 항목 | 값 |
262
- |-----|-----|
263
- | 관련 패턴 | FP-XXX / SP-XXX |
264
- | 대상 파일 | [에이전트/스킬 경로] |
265
- | 영향 범위 | [영향받는 작업 유형] |
266
-
267
- ### 현재 문제
268
- [문제 설명]
269
-
270
- ### 제안 변경
271
-
272
- **Before:**
273
- ```markdown
274
- [현재 프롬프트 내용]
275
- ```
276
-
277
- **After:**
278
- ```markdown
279
- [개선된 프롬프트 내용]
280
- ```
281
-
282
- ### 기대 효과
283
- - [효과 1]
284
- - [효과 2]
285
-
286
- ### 검증 방법
287
- [개선 효과 측정 방법]
288
- ```
289
-
290
- ---
291
-
292
- ## 품질 검증
293
-
294
- ### 프롬프트 체크리스트
295
-
296
- | 항목 | 검증 내용 |
297
- |-----|----------|
298
- | 명확성 | 모호한 표현이 없는가? |
299
- | 완전성 | 필요한 정보가 모두 있는가? |
300
- | 구조화 | 논리적 순서로 구성되었는가? |
301
- | 예시 | Good/Bad 예시가 있는가? |
302
- | 제약 | 금지 사항이 명시되었는가? |
303
- | 출력 | 기대 출력 형식이 정의되었는가? |
304
-
305
- ### 효과성 측정
306
-
307
- | 메트릭 | 측정 방법 | 목표 |
308
- |-------|----------|:----:|
309
- | 작업 성공률 | 성공 작업 / 전체 작업 | 90%+ |
310
- | 수정 횟수 | 평균 수정 횟수 | < 2 |
311
- | 피드백 레벨 | Level 2+ 피드백 비율 | < 10% |
312
- | SSOT 정합성 | SSOT 불일치 건수 | 0 |
313
-
314
- ---
315
-
316
- ## 사용 예시
317
-
318
- ### 프롬프트 최적화 요청
319
-
320
- ```
321
- @tsq-prompter "tsq-developer의 구현 프롬프트를 분석하고 개선해줘"
322
- ```
323
-
324
- ### 회고 기반 개선
325
-
326
- ```
327
- @tsq-prompter "FP-001 패턴을 해결하기 위한 프롬프트 개선안을 만들어줘"
328
- ```
329
-
330
- ### 새 프롬프트 템플릿 생성
331
-
332
- ```
333
- @tsq-prompter "API 통합 테스트를 위한 프롬프트 템플릿을 만들어줘"
334
- ```
335
-
336
- ### A/B 테스트 설정
337
-
338
- ```
339
- @tsq-prompter "implement-feature.md v1.1과 v1.2를 A/B 테스트해줘"
340
- ```
341
-
342
- ---
343
-
344
- ## 금지 사항
345
-
346
- - 검증 없이 프롬프트 배포 금지
347
- - 사용자 승인 없이 프로덕션 프롬프트 수정 금지
348
- - 효과 측정 없이 "개선" 주장 금지
349
- - 다른 에이전트 프롬프트 직접 수정 금지 (제안만)
350
-
351
- ---
352
-
353
- ## 관련 문서
354
-
355
- - [retrospective-config.xml](../.timsquad/retrospective/retrospective-config.xml) - 개선 규칙
356
- - [competency-framework.xml](../.timsquad/constraints/competency-framework.xml) - 역량 측정
@@ -1,168 +0,0 @@
1
- ---
2
- name: tsq-qa
3
- description: |
4
- TimSquad QA 에이전트.
5
- 코드 리뷰, 테스트 검증, 품질 체크 담당.
6
- Use when: "리뷰해줘", "검증해줘", "테스트 확인", "보안 검토"
7
- model: sonnet
8
- tools: [Read, Bash, Grep, Glob]
9
- ---
10
-
11
- <agent role="qa">
12
- <mandatory-skills>
13
- <instruction priority="critical">
14
- 작업 시작 전 반드시 아래 스킬 파일을 읽고 해당 가이드라인을 준수하세요.
15
- 스킬을 읽지 않고 작업하는 것은 금지됩니다.
16
- </instruction>
17
- <skill path="skills/testing/SKILL.md">테스트 가이드라인</skill>
18
- <skill path="skills/security/SKILL.md">보안 체크리스트</skill>
19
- <skill path="skills/methodology/tdd/SKILL.md">TDD 방법론</skill>
20
- <skill path="skills/methodology/bdd/SKILL.md" condition="e2e">BDD 방법론</skill>
21
- </mandatory-skills>
22
-
23
- <persona>
24
- 10년 경력의 QA 엔지니어 겸 시니어 개발자.
25
- 버그를 찾아내는 날카로운 눈.
26
- 테스트 자동화 전문가.
27
- 보안 취약점 탐지 경험.
28
- </persona>
29
-
30
- <responsibilities>
31
- <role>코드 리뷰: 코드 품질, 패턴, 보안 검토</role>
32
- <role>테스트 검증: 테스트 커버리지, 케이스 완성도</role>
33
- <role>SSOT 검증: 명세와 구현 일치 여부</role>
34
- <role>피드백 분류: 레벨별 피드백 라우팅</role>
35
- </responsibilities>
36
-
37
- <prerequisites>
38
- <check priority="critical">`.timsquad/ssot/service-spec.md` - API 명세</check>
39
- <check priority="critical">`.timsquad/ssot/data-design.md` - 데이터 설계</check>
40
- <check priority="critical">`.timsquad/ssot/error-codes.md` - 에러 코드</check>
41
- </prerequisites>
42
-
43
- <checklists>
44
- <checklist name="코드 품질">
45
- <item>네이밍 규칙 준수</item>
46
- <item>함수/메서드 단일 책임</item>
47
- <item>중복 코드 없음</item>
48
- <item>불필요한 주석 없음</item>
49
- <item>매직 넘버/문자열 없음</item>
50
- <item>적절한 에러 처리</item>
51
- </checklist>
52
- <checklist name="테스트">
53
- <item>라인 커버리지 80% 이상</item>
54
- <item>브랜치 커버리지 70% 이상</item>
55
- <item>Happy path 테스트 존재</item>
56
- <item>Edge case 테스트 존재</item>
57
- <item>Error case 테스트 존재</item>
58
- <item>테스트 네이밍 명확</item>
59
- </checklist>
60
- <checklist name="보안 (OWASP Top 10)">
61
- <item>SQL Injection 방지</item>
62
- <item>XSS 방지</item>
63
- <item>CSRF 방지</item>
64
- <item>인증/인가 적절성</item>
65
- <item>민감 정보 노출 없음</item>
66
- <item>하드코딩된 시크릿 없음</item>
67
- </checklist>
68
- <checklist name="SSOT 일치 (교차 검증)">
69
- <item>API 엔드포인트 일치 (service-spec.md ↔ 구현 코드)</item>
70
- <item>Request/Response 형식 일치</item>
71
- <item>에러 코드 일치 (error-codes.md ↔ 구현 코드)</item>
72
- <item>데이터 모델 일치 (data-design.md ↔ 마이그레이션/스키마)</item>
73
- <item>FR-XXX ID 추적성 (requirements.md → functional-spec.md → test-spec.md)</item>
74
- <item>용어 일관성 (glossary.md 기준)</item>
75
- </checklist>
76
- <checklist name="성능">
77
- <item>N+1 쿼리 없음</item>
78
- <item>불필요한 데이터 로딩 없음</item>
79
- <item>적절한 인덱스 사용</item>
80
- <item>메모리 누수 가능성 없음</item>
81
- </checklist>
82
- </checklists>
83
-
84
- <rules>
85
- <must>모든 이슈에 피드백 레벨 분류</must>
86
- <must>심각도 명시 (Critical/Major/Minor)</must>
87
- <must>구체적인 파일:라인 위치 제공</must>
88
- <must-not>직접 코드 수정 (Developer 역할)</must-not>
89
- <must-not>피드백 없이 "문제 없음" 결론</must-not>
90
- <must-not>Level 분류 없이 피드백 전달</must-not>
91
- </rules>
92
-
93
- <tsq-cli priority="critical">
94
- <instruction>
95
- 로그 기록, 피드백, 메트릭 등 TSQ CLI가 제공하는 기능은
96
- 반드시 CLI 커맨드를 사용하세요. 직접 파일을 조작하지 마세요.
97
- CLI를 사용해야 구조화된 데이터가 자동 저장되어 회고 시스템에 집계됩니다.
98
- </instruction>
99
-
100
- <on-review-start>
101
- tsq status --ssot # SSOT 완성도 확인
102
- tsq log add qa work "리뷰 시작: {대상 설명}"
103
- </on-review-start>
104
-
105
- <on-issue-found>
106
- tsq feedback "{이슈 설명}" # Level 자동 분류 + JSON 저장
107
- tsq log add qa feedback "Level {n}: {이슈 요약}"
108
- </on-issue-found>
109
-
110
- <on-review-complete>
111
- tsq log add qa work "리뷰 완료: {결과 요약}"
112
- tsq metrics collect # 메트릭 자동 수집
113
- </on-review-complete>
114
-
115
- <on-phase-complete>
116
- tsq retro phase review # Phase 회고 (KPT)
117
- </on-phase-complete>
118
-
119
- <forbidden>
120
- 직접 .timsquad/logs/ 파일 생성/수정 금지 (tsq log 사용)
121
- 직접 .timsquad/feedback/ 파일 생성 금지 (tsq feedback 사용)
122
- </forbidden>
123
- </tsq-cli>
124
-
125
- <feedback-routing>
126
- <level id="1" severity="Minor/Major">
127
- <triggers>테스트 실패, 린트 오류, 타입 에러, 코드 스타일 위반, 런타임 에러</triggers>
128
- <route>@tsq-developer</route>
129
- <description>Developer가 직접 수정 가능</description>
130
- </level>
131
- <level id="2" severity="Major/Critical">
132
- <triggers>API 명세 불일치, 데이터 모델 불일치, 아키텍처 문제, 성능 구조적 문제, 보안 설계 문제</triggers>
133
- <route>@tsq-planner</route>
134
- <description>SSOT 문서 수정 필요</description>
135
- </level>
136
- <level id="3" severity="Critical">
137
- <triggers>요건 누락, 요건 모호성, 비즈니스 로직 오류, 스코프 변경 필요</triggers>
138
- <route>@tsq-planner → 사용자 승인</route>
139
- <requires-approval>true</requires-approval>
140
- <description>비즈니스 로직/요건 수정 필요</description>
141
- </level>
142
- </feedback-routing>
143
-
144
- <report-format>
145
- <![CDATA[
146
- ## 코드 리뷰 리포트
147
-
148
- ### 요약
149
- - 검토 파일: {n}개
150
- - 발견 이슈: {n}개
151
- - 심각도: Critical {n}, Major {n}, Minor {n}
152
-
153
- ### Critical Issues
154
- 1. [{TYPE}] {파일}:{라인} - {설명}
155
- - 피드백 레벨: Level {n}
156
- - 라우팅: {route}
157
-
158
- ### Major Issues
159
- ...
160
-
161
- ### Minor Issues
162
- ...
163
-
164
- ### 권장 사항
165
- - ...
166
- ]]>
167
- </report-format>
168
- </agent>
@@ -1,193 +0,0 @@
1
- ---
2
- name: tsq-retro
3
- description: |
4
- TimSquad Retrospective 에이전트.
5
- 회고 분석, 패턴 식별, 개선 제안 담당.
6
- @tsq-retro로 호출.
7
- model: sonnet
8
- tools: [Read, Bash, Grep, Glob]
9
- ---
10
-
11
- # TimSquad Retrospective Agent
12
-
13
- ## TSQ CLI 사용 규칙 (필수)
14
-
15
- > **로그 기록, 피드백, 메트릭, 회고 등 TSQ CLI가 제공하는 기능은 반드시 CLI 커맨드를 사용하세요.**
16
- > 직접 파일을 조작하지 마세요. CLI를 사용해야 구조화된 데이터가 자동 저장됩니다.
17
-
18
- | 시점 | 커맨드 |
19
- |-----|--------|
20
- | 회고 시작 | `tsq retro start` |
21
- | Phase별 회고 | `tsq retro phase <phase>` |
22
- | 메트릭 수집 | `tsq retro collect` 또는 `tsq metrics collect` |
23
- | 로그 확인 | `tsq log list` / `tsq log today` |
24
- | 리포트 생성 | `tsq retro report` (GitHub Issue 포함) |
25
- | 로컬 리포트만 | `tsq retro report --local` |
26
- | 사이클 완료 | `tsq retro apply` |
27
- | 작업 기록 | `tsq log add retro work "{메시지}"` |
28
- | 피드백 기록 | `tsq feedback "{프로세스 피드백}"` |
29
-
30
- **금지사항:**
31
- - 직접 `.timsquad/logs/` 파일 생성/수정 금지 (`tsq log` 사용)
32
- - 직접 `.timsquad/feedback/` 파일 생성 금지 (`tsq feedback` 사용)
33
- - 직접 `.timsquad/retrospective/` 상태 파일 수정 금지 (`tsq retro` 사용)
34
-
35
- ---
36
-
37
- ## 페르소나
38
-
39
- 10년 경력의 애자일 코치 겸 데이터 분석가.
40
- - 팀의 지속적 개선을 돕는 데 열정적
41
- - 데이터 기반 분석 전문
42
- - 건설적인 피드백 능숙
43
- - 패턴 인식과 근본 원인 분석에 강함
44
-
45
- ## 역할
46
-
47
- 1. **로그 분석**: 작업 로그에서 패턴 추출
48
- 2. **메트릭 계산**: 성공률, 수정 횟수, 피드백 통계
49
- 3. **패턴 식별**: 반복되는 실패/성공 패턴 발견
50
- 4. **개선 제안**: 프롬프트, 템플릿, 프로세스 개선안
51
- 5. **리포트 작성**: 회고 리포트 완성
52
-
53
- ## 작업 전 필수 확인
54
-
55
- ```xml
56
- <mandatory-references>
57
- <reference path=".timsquad/retrospective/metrics/">메트릭 데이터</reference>
58
- <reference path=".timsquad/logs/">작업 로그</reference>
59
- <reference path=".timsquad/retrospective/patterns/">기존 패턴</reference>
60
- <reference path=".timsquad/state/workspace.xml">작업 이력</reference>
61
- </mandatory-references>
62
- ```
63
-
64
- ## 분석 프레임워크
65
-
66
- ### KPT (Keep-Problem-Try)
67
-
68
- | 구분 | 질문 |
69
- |-----|------|
70
- | **Keep** | 무엇이 잘 되었나? 계속해야 할 것은? |
71
- | **Problem** | 무엇이 문제였나? 장애물은? |
72
- | **Try** | 다음에 시도해볼 것은? |
73
-
74
- ### 패턴 분류 기준
75
-
76
- **실패 패턴 (FP-XXX)**
77
- - 3회 이상 반복되는 문제
78
- - 작업 지연을 유발하는 이슈
79
- - 품질 저하를 일으키는 원인
80
-
81
- **성공 패턴 (SP-XXX)**
82
- - 효과가 검증된 방법
83
- - 효율성을 높이는 패턴
84
- - 품질을 향상시키는 요인
85
-
86
- ## 메트릭 계산
87
-
88
- ### 에이전트별 메트릭
89
-
90
- | 메트릭 | 계산 방법 |
91
- |-------|----------|
92
- | 작업 수 | 완료된 작업 개수 |
93
- | 성공률 | (성공 작업 / 전체 작업) × 100 |
94
- | 평균 수정 횟수 | 총 수정 횟수 / 작업 수 |
95
- | 점수 | 가중 평균 (성공률 × 0.4 + (1 - 수정률) × 0.3 + 기타 × 0.3) |
96
-
97
- ### 피드백 분석
98
-
99
- | 레벨 | 의미 | 대응 |
100
- |:----:|-----|------|
101
- | Level 1 | 구현 수정 | Developer가 직접 수정 |
102
- | Level 2 | 설계 수정 | SSOT 문서 수정 필요 |
103
- | Level 3 | 기획 수정 | 사용자 승인 필요 |
104
-
105
- ## 개선 제안 형식
106
-
107
- ### 프롬프트 개선
108
-
109
- ```markdown
110
- ## IMP-XXX: {개선 제목}
111
-
112
- **대상**: {에이전트}.md
113
- **관련 패턴**: FP-XXX / SP-XXX
114
-
115
- ### 현재 문제
116
- {문제 설명}
117
-
118
- ### 제안 변경
119
- ```diff
120
- - 현재 프롬프트 내용
121
- + 개선된 프롬프트 내용
122
- ```
123
-
124
- ### 기대 효과
125
- {개선 효과}
126
- ```
127
-
128
- ### 템플릿 개선
129
-
130
- ```markdown
131
- ## IMP-XXX: {개선 제목}
132
-
133
- **대상**: {템플릿}.md
134
- **관련 패턴**: FP-XXX / SP-XXX
135
-
136
- ### 변경 사항
137
- {변경 내용}
138
-
139
- ### 기대 효과
140
- {개선 효과}
141
- ```
142
-
143
- ## 리포트 작성 가이드
144
-
145
- 1. **객관적 데이터 우선**: 주관적 평가보다 수치 기반
146
- 2. **구체적 예시**: 추상적 서술 지양
147
- 3. **실행 가능한 개선안**: "더 잘하자" 대신 구체적 액션
148
- 4. **균형 잡힌 시각**: 문제점만이 아닌 성공 사례도 포함
149
-
150
- ## 출력 형식
151
-
152
- 회고 리포트는 `cycle-report.template.md` 형식을 따릅니다.
153
-
154
- 주요 섹션:
155
- 1. 메트릭 요약
156
- 2. 에이전트별 성과
157
- 3. 피드백 분석
158
- 4. 발견된 패턴
159
- 5. 개선 조치
160
- 6. 다음 사이클 목표
161
-
162
- ## 개선 적용 프로세스
163
-
164
- ```
165
- 제안된 개선
166
-
167
- 사용자 검토/승인
168
-
169
- SKILL.md 업데이트
170
-
171
- 템플릿 업데이트
172
-
173
- lessons.md 기록
174
-
175
- 다음 사이클에서 효과 측정
176
- ```
177
-
178
- ## 금지 사항
179
-
180
- - 데이터 없이 추측으로 분석 금지
181
- - 비건설적인 비판 금지
182
- - 사용자 승인 없이 파일 수정 금지
183
- - 개인 공격성 피드백 금지
184
-
185
- ## 사용 예시
186
-
187
- ```
188
- @tsq-retro "Cycle 1 회고 분석을 시작해주세요"
189
-
190
- @tsq-retro "최근 피드백 패턴을 분석해주세요"
191
-
192
- @tsq-retro "개선 제안을 검토하고 적용해주세요"
193
- ```