timsquad 2.1.0 → 3.3.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 (345) hide show
  1. package/README.md +124 -724
  2. package/dist/commands/daemon.d.ts +7 -0
  3. package/dist/commands/daemon.d.ts.map +1 -0
  4. package/dist/commands/daemon.js +140 -0
  5. package/dist/commands/daemon.js.map +1 -0
  6. package/dist/commands/feedback.d.ts +9 -0
  7. package/dist/commands/feedback.d.ts.map +1 -1
  8. package/dist/commands/feedback.js +235 -14
  9. package/dist/commands/feedback.js.map +1 -1
  10. package/dist/commands/full.js +2 -2
  11. package/dist/commands/full.js.map +1 -1
  12. package/dist/commands/init.d.ts.map +1 -1
  13. package/dist/commands/init.js +107 -20
  14. package/dist/commands/init.js.map +1 -1
  15. package/dist/commands/knowledge.d.ts +3 -0
  16. package/dist/commands/knowledge.d.ts.map +1 -0
  17. package/dist/commands/knowledge.js +316 -0
  18. package/dist/commands/knowledge.js.map +1 -0
  19. package/dist/commands/log.d.ts +27 -0
  20. package/dist/commands/log.d.ts.map +1 -1
  21. package/dist/commands/log.js +965 -0
  22. package/dist/commands/log.js.map +1 -1
  23. package/dist/commands/meta-index.d.ts +3 -0
  24. package/dist/commands/meta-index.d.ts.map +1 -0
  25. package/dist/commands/meta-index.js +401 -0
  26. package/dist/commands/meta-index.js.map +1 -0
  27. package/dist/commands/metrics.d.ts.map +1 -1
  28. package/dist/commands/metrics.js +239 -4
  29. package/dist/commands/metrics.js.map +1 -1
  30. package/dist/commands/retro.js +154 -6
  31. package/dist/commands/retro.js.map +1 -1
  32. package/dist/commands/upgrade.d.ts +8 -0
  33. package/dist/commands/upgrade.d.ts.map +1 -0
  34. package/dist/commands/upgrade.js +287 -0
  35. package/dist/commands/upgrade.js.map +1 -0
  36. package/dist/commands/workflow.d.ts +3 -0
  37. package/dist/commands/workflow.d.ts.map +1 -0
  38. package/dist/commands/workflow.js +607 -0
  39. package/dist/commands/workflow.js.map +1 -0
  40. package/dist/daemon/context-writer.d.ts +16 -0
  41. package/dist/daemon/context-writer.d.ts.map +1 -0
  42. package/dist/daemon/context-writer.js +35 -0
  43. package/dist/daemon/context-writer.js.map +1 -0
  44. package/dist/daemon/entry.d.ts +7 -0
  45. package/dist/daemon/entry.d.ts.map +1 -0
  46. package/dist/daemon/entry.js +17 -0
  47. package/dist/daemon/entry.js.map +1 -0
  48. package/dist/daemon/event-queue.d.ts +52 -0
  49. package/dist/daemon/event-queue.d.ts.map +1 -0
  50. package/dist/daemon/event-queue.js +255 -0
  51. package/dist/daemon/event-queue.js.map +1 -0
  52. package/dist/daemon/file-watcher.d.ts +19 -0
  53. package/dist/daemon/file-watcher.d.ts.map +1 -0
  54. package/dist/daemon/file-watcher.js +87 -0
  55. package/dist/daemon/file-watcher.js.map +1 -0
  56. package/dist/daemon/index.d.ts +28 -0
  57. package/dist/daemon/index.d.ts.map +1 -0
  58. package/dist/daemon/index.js +204 -0
  59. package/dist/daemon/index.js.map +1 -0
  60. package/dist/daemon/jsonl-watcher.d.ts +49 -0
  61. package/dist/daemon/jsonl-watcher.d.ts.map +1 -0
  62. package/dist/daemon/jsonl-watcher.js +258 -0
  63. package/dist/daemon/jsonl-watcher.js.map +1 -0
  64. package/dist/daemon/meta-cache.d.ts +62 -0
  65. package/dist/daemon/meta-cache.d.ts.map +1 -0
  66. package/dist/daemon/meta-cache.js +240 -0
  67. package/dist/daemon/meta-cache.js.map +1 -0
  68. package/dist/daemon/shutdown.d.ts +21 -0
  69. package/dist/daemon/shutdown.d.ts.map +1 -0
  70. package/dist/daemon/shutdown.js +158 -0
  71. package/dist/daemon/shutdown.js.map +1 -0
  72. package/dist/index.js +20 -3
  73. package/dist/index.js.map +1 -1
  74. package/dist/lib/agent-composer.d.ts +38 -0
  75. package/dist/lib/agent-composer.d.ts.map +1 -0
  76. package/dist/lib/agent-composer.js +128 -0
  77. package/dist/lib/agent-composer.js.map +1 -0
  78. package/dist/lib/agent-generator.d.ts +22 -0
  79. package/dist/lib/agent-generator.d.ts.map +1 -0
  80. package/dist/lib/agent-generator.js +150 -0
  81. package/dist/lib/agent-generator.js.map +1 -0
  82. package/dist/lib/ast-parser.d.ts +11 -0
  83. package/dist/lib/ast-parser.d.ts.map +1 -0
  84. package/dist/lib/ast-parser.js +282 -0
  85. package/dist/lib/ast-parser.js.map +1 -0
  86. package/dist/lib/config.d.ts +6 -2
  87. package/dist/lib/config.d.ts.map +1 -1
  88. package/dist/lib/config.js +27 -3
  89. package/dist/lib/config.js.map +1 -1
  90. package/dist/lib/meta-index.d.ts +19 -0
  91. package/dist/lib/meta-index.d.ts.map +1 -0
  92. package/dist/lib/meta-index.js +573 -0
  93. package/dist/lib/meta-index.js.map +1 -0
  94. package/dist/lib/project.js +1 -1
  95. package/dist/lib/project.js.map +1 -1
  96. package/dist/lib/skill-generator.d.ts +32 -0
  97. package/dist/lib/skill-generator.d.ts.map +1 -0
  98. package/dist/lib/skill-generator.js +187 -0
  99. package/dist/lib/skill-generator.js.map +1 -0
  100. package/dist/lib/template.d.ts +16 -2
  101. package/dist/lib/template.d.ts.map +1 -1
  102. package/dist/lib/template.js +109 -20
  103. package/dist/lib/template.js.map +1 -1
  104. package/dist/lib/ui-index.d.ts +12 -0
  105. package/dist/lib/ui-index.d.ts.map +1 -0
  106. package/dist/lib/ui-index.js +239 -0
  107. package/dist/lib/ui-index.js.map +1 -0
  108. package/dist/lib/ui-parser.d.ts +12 -0
  109. package/dist/lib/ui-parser.d.ts.map +1 -0
  110. package/dist/lib/ui-parser.js +472 -0
  111. package/dist/lib/ui-parser.js.map +1 -0
  112. package/dist/lib/update-check.d.ts +6 -0
  113. package/dist/lib/update-check.d.ts.map +1 -0
  114. package/dist/lib/update-check.js +121 -0
  115. package/dist/lib/update-check.js.map +1 -0
  116. package/dist/lib/upgrade-backup.d.ts +33 -0
  117. package/dist/lib/upgrade-backup.d.ts.map +1 -0
  118. package/dist/lib/upgrade-backup.js +101 -0
  119. package/dist/lib/upgrade-backup.js.map +1 -0
  120. package/dist/lib/version.d.ts +19 -0
  121. package/dist/lib/version.d.ts.map +1 -0
  122. package/dist/lib/version.js +35 -0
  123. package/dist/lib/version.js.map +1 -0
  124. package/dist/lib/workflow-state.d.ts +48 -0
  125. package/dist/lib/workflow-state.d.ts.map +1 -0
  126. package/dist/lib/workflow-state.js +67 -0
  127. package/dist/lib/workflow-state.js.map +1 -0
  128. package/dist/types/config.d.ts +102 -2
  129. package/dist/types/config.d.ts.map +1 -1
  130. package/dist/types/config.js +173 -9
  131. package/dist/types/config.js.map +1 -1
  132. package/dist/types/feedback.d.ts +7 -0
  133. package/dist/types/feedback.d.ts.map +1 -1
  134. package/dist/types/feedback.js +1 -1
  135. package/dist/types/feedback.js.map +1 -1
  136. package/dist/types/index.d.ts +3 -0
  137. package/dist/types/index.d.ts.map +1 -1
  138. package/dist/types/index.js +3 -0
  139. package/dist/types/index.js.map +1 -1
  140. package/dist/types/meta-index.d.ts +146 -0
  141. package/dist/types/meta-index.d.ts.map +1 -0
  142. package/dist/types/meta-index.js +7 -0
  143. package/dist/types/meta-index.js.map +1 -0
  144. package/dist/types/project.d.ts +18 -2
  145. package/dist/types/project.d.ts.map +1 -1
  146. package/dist/types/project.js +21 -0
  147. package/dist/types/project.js.map +1 -1
  148. package/dist/types/task-log.d.ts +208 -0
  149. package/dist/types/task-log.d.ts.map +1 -0
  150. package/dist/types/task-log.js +6 -0
  151. package/dist/types/task-log.js.map +1 -0
  152. package/dist/types/ui-meta.d.ts +118 -0
  153. package/dist/types/ui-meta.d.ts.map +1 -0
  154. package/dist/types/ui-meta.js +7 -0
  155. package/dist/types/ui-meta.js.map +1 -0
  156. package/package.json +12 -4
  157. package/templates/base/agents/base/tsq-architect.md +68 -0
  158. package/templates/base/agents/base/tsq-dba.md +56 -0
  159. package/templates/base/agents/base/tsq-designer.md +72 -0
  160. package/templates/base/agents/base/tsq-developer.md +67 -0
  161. package/templates/base/agents/base/tsq-qa.md +55 -0
  162. package/templates/base/agents/base/tsq-security.md +65 -0
  163. package/templates/base/agents/overlays/domain/general-web/_common.md +11 -0
  164. package/templates/base/agents/overlays/platform/claude-code.md +12 -0
  165. package/templates/base/config.template.yaml +213 -0
  166. package/templates/base/knowledge/checklists/accessibility.md +37 -0
  167. package/templates/base/knowledge/checklists/architecture-review.md +28 -0
  168. package/templates/base/knowledge/checklists/database-standards.md +84 -0
  169. package/templates/base/knowledge/checklists/design-reference.md +97 -0
  170. package/templates/base/knowledge/checklists/security.md +50 -0
  171. package/templates/base/knowledge/checklists/ssot-validation.md +19 -0
  172. package/templates/base/knowledge/domains/_template.md +16 -0
  173. package/templates/base/knowledge/platforms/_template.md +16 -0
  174. package/templates/base/knowledge/templates/sequence-report.md +44 -0
  175. package/templates/base/knowledge/templates/task-result.md +105 -0
  176. package/templates/base/skills/_template/SKILL.md +59 -0
  177. package/templates/base/skills/_template/references/_template.md +35 -0
  178. package/templates/base/skills/_template/rules/_sections.md +34 -0
  179. package/templates/base/skills/_template/rules/_template.md +32 -0
  180. package/templates/base/skills/_template/scripts/_template.sh +31 -0
  181. package/templates/base/skills/architecture/SKILL.md +54 -0
  182. package/templates/base/skills/architecture/references/adr-template.md +50 -0
  183. package/templates/base/skills/architecture/references/api-design.md +64 -0
  184. package/templates/base/skills/backend/node/SKILL.md +81 -0
  185. package/templates/base/skills/backend/node/rules/async-patterns.md +81 -0
  186. package/templates/base/skills/backend/node/rules/deployment.md +33 -0
  187. package/templates/base/skills/backend/node/rules/env-config.md +41 -0
  188. package/templates/base/skills/backend/node/rules/error-handling.md +83 -0
  189. package/templates/base/skills/backend/node/rules/hono-app-setup.md +98 -0
  190. package/templates/base/skills/backend/node/rules/jwt-auth.md +76 -0
  191. package/templates/base/skills/backend/node/rules/middleware.md +56 -0
  192. package/templates/base/skills/backend/node/rules/testing.md +82 -0
  193. package/templates/base/skills/coding/SKILL.md +47 -0
  194. package/templates/base/skills/coding/rules/patterns.md +81 -0
  195. package/templates/base/skills/database/SKILL.md +98 -0
  196. package/templates/base/skills/database/prisma/SKILL.md +57 -0
  197. package/templates/base/skills/database/prisma/rules/queries.md +133 -0
  198. package/templates/base/skills/database/prisma/rules/schema-design.md +80 -0
  199. package/templates/base/skills/frontend/nextjs/SKILL.md +59 -0
  200. package/templates/base/skills/frontend/nextjs/rules/app-router.md +138 -0
  201. package/templates/base/skills/frontend/react/SKILL.md +86 -0
  202. package/templates/base/skills/frontend/react/rules/_sections.md +88 -0
  203. package/templates/base/skills/frontend/react/rules/anti-patterns.md +67 -0
  204. package/templates/base/skills/frontend/react/rules/async-api-routes.md +38 -0
  205. package/templates/base/skills/frontend/react/rules/async-defer-await.md +80 -0
  206. package/templates/base/skills/frontend/react/rules/async-dependencies.md +36 -0
  207. package/templates/base/skills/frontend/react/rules/async-parallel.md +28 -0
  208. package/templates/base/skills/frontend/react/rules/async-suspense-boundaries.md +99 -0
  209. package/templates/base/skills/frontend/react/rules/bundle-barrel-imports.md +59 -0
  210. package/templates/base/skills/frontend/react/rules/bundle-defer-third-party.md +49 -0
  211. package/templates/base/skills/frontend/react/rules/bundle-dynamic-imports.md +35 -0
  212. package/templates/base/skills/frontend/react/rules/component-conventions.md +74 -0
  213. package/templates/base/skills/frontend/react/rules/js-combine-iterations.md +32 -0
  214. package/templates/base/skills/frontend/react/rules/js-early-exit.md +50 -0
  215. package/templates/base/skills/frontend/react/rules/js-index-maps.md +37 -0
  216. package/templates/base/skills/frontend/react/rules/js-set-map-lookups.md +24 -0
  217. package/templates/base/skills/frontend/react/rules/rendering-conditional-render.md +40 -0
  218. package/templates/base/skills/frontend/react/rules/rendering-content-visibility.md +38 -0
  219. package/templates/base/skills/frontend/react/rules/rendering-hoist-jsx.md +46 -0
  220. package/templates/base/skills/frontend/react/rules/rerender-defer-reads.md +39 -0
  221. package/templates/base/skills/frontend/react/rules/rerender-derived-state.md +29 -0
  222. package/templates/base/skills/frontend/react/rules/rerender-memo.md +44 -0
  223. package/templates/base/skills/frontend/react/rules/rerender-transitions.md +40 -0
  224. package/templates/base/skills/frontend/react/rules/server-after-nonblocking.md +73 -0
  225. package/templates/base/skills/frontend/react/rules/server-cache-react.md +26 -0
  226. package/templates/base/skills/frontend/react/rules/server-parallel-fetching.md +79 -0
  227. package/templates/base/skills/frontend/react/rules/state-location.md +55 -0
  228. package/templates/base/skills/methodology/bdd/SKILL.md +69 -0
  229. package/templates/base/skills/methodology/bdd/rules/gherkin-patterns.md +113 -0
  230. package/templates/base/skills/methodology/ddd/SKILL.md +74 -0
  231. package/templates/base/skills/methodology/ddd/rules/strategic-patterns.md +98 -0
  232. package/templates/base/skills/methodology/debugging/SKILL.md +60 -0
  233. package/templates/base/skills/methodology/debugging/references/root-cause-tracing.md +84 -0
  234. package/templates/base/skills/methodology/tdd/SKILL.md +66 -0
  235. package/templates/base/skills/methodology/tdd/rules/real-world-example.md +88 -0
  236. package/templates/base/skills/methodology/tdd/rules/techniques.md +185 -0
  237. package/templates/base/skills/planning/SKILL.md +58 -0
  238. package/templates/base/skills/planning/references/prd-guide.md +47 -0
  239. package/templates/base/skills/planning/references/requirements-guide.md +46 -0
  240. package/templates/base/skills/prompt-engineering/SKILL.md +103 -0
  241. package/templates/base/skills/retrospective/SKILL.md +102 -0
  242. package/templates/base/skills/security/SKILL.md +55 -0
  243. package/templates/base/skills/security/rules/owasp-examples.md +119 -0
  244. package/templates/base/skills/security/scripts/check-secrets.sh +55 -0
  245. package/templates/base/skills/testing/SKILL.md +63 -0
  246. package/templates/base/skills/testing/references/testing-patterns.md +103 -0
  247. package/templates/base/skills/tsq-protocol/SKILL.md +51 -0
  248. package/templates/base/skills/typescript/SKILL.md +67 -0
  249. package/templates/base/skills/typescript/rules/type-patterns.md +135 -0
  250. package/templates/base/skills/typescript/rules/utility-types.md +76 -0
  251. package/templates/base/skills/ui-design/SKILL.md +70 -0
  252. package/templates/{common → base}/timsquad/feedback/routing-rules.yaml +1 -1
  253. package/templates/{common → base}/timsquad/retrospective/metrics/metrics-schema.json +46 -1
  254. package/templates/platforms/claude-code/CLAUDE.md.template +64 -0
  255. package/templates/platforms/claude-code/rules/adr-rules.md +32 -0
  256. package/templates/platforms/claude-code/rules/feedback-routing.md +18 -0
  257. package/templates/platforms/claude-code/rules/phase-management.md +23 -0
  258. package/templates/platforms/claude-code/rules/reporting-format.md +26 -0
  259. package/templates/platforms/claude-code/rules/sequence-management.md +72 -0
  260. package/templates/platforms/claude-code/rules/workspace-sync.md +33 -0
  261. package/templates/platforms/claude-code/settings.json +26 -0
  262. package/templates/project-types/api-backend/config.yaml +227 -0
  263. package/templates/project-types/api-backend/process/workflow.xml +214 -0
  264. package/templates/project-types/fintech/config.yaml +151 -0
  265. package/templates/project-types/fintech/process/workflow.xml +316 -0
  266. package/templates/project-types/infra/config.yaml +327 -0
  267. package/templates/project-types/infra/process/workflow.xml +296 -0
  268. package/templates/project-types/platform/config.yaml +254 -0
  269. package/templates/project-types/platform/process/workflow.xml +254 -0
  270. package/templates/project-types/web-app/config.yaml +198 -0
  271. package/templates/project-types/web-app/process/workflow.xml +210 -0
  272. package/templates/project-types/web-service/config.yaml +136 -0
  273. package/templates/project-types/web-service/process/workflow.xml +184 -0
  274. package/templates/common/CLAUDE.md.template +0 -254
  275. package/templates/common/claude/agents/tsq-dba.md +0 -311
  276. package/templates/common/claude/agents/tsq-designer.md +0 -323
  277. package/templates/common/claude/agents/tsq-developer.md +0 -177
  278. package/templates/common/claude/agents/tsq-planner.md +0 -190
  279. package/templates/common/claude/agents/tsq-prompter.md +0 -356
  280. package/templates/common/claude/agents/tsq-qa.md +0 -168
  281. package/templates/common/claude/agents/tsq-retro.md +0 -193
  282. package/templates/common/claude/agents/tsq-security.md +0 -221
  283. package/templates/common/claude/hooks/auto-metrics.sh +0 -165
  284. package/templates/common/claude/hooks/auto-worklog.sh +0 -245
  285. package/templates/common/claude/hooks/event-logger.sh +0 -208
  286. package/templates/common/claude/settings.json +0 -86
  287. package/templates/common/claude/skills/architecture/SKILL.md +0 -123
  288. package/templates/common/claude/skills/backend/node/SKILL.md +0 -1015
  289. package/templates/common/claude/skills/coding/SKILL.md +0 -171
  290. package/templates/common/claude/skills/database/prisma/SKILL.md +0 -357
  291. package/templates/common/claude/skills/frontend/nextjs/SKILL.md +0 -279
  292. package/templates/common/claude/skills/frontend/react/SKILL.md +0 -1729
  293. package/templates/common/claude/skills/methodology/bdd/SKILL.md +0 -234
  294. package/templates/common/claude/skills/methodology/ddd/SKILL.md +0 -311
  295. package/templates/common/claude/skills/methodology/tdd/SKILL.md +0 -512
  296. package/templates/common/claude/skills/planning/SKILL.md +0 -90
  297. package/templates/common/claude/skills/security/SKILL.md +0 -234
  298. package/templates/common/claude/skills/testing/SKILL.md +0 -146
  299. package/templates/common/claude/skills/typescript/SKILL.md +0 -435
  300. package/templates/common/config.template.yaml +0 -132
  301. /package/templates/{common → base}/timsquad/architectures/clean/ARCHITECTURE.md +0 -0
  302. /package/templates/{common → base}/timsquad/architectures/clean/backend.xml +0 -0
  303. /package/templates/{common → base}/timsquad/architectures/clean/frontend.xml +0 -0
  304. /package/templates/{common → base}/timsquad/architectures/fsd/ARCHITECTURE.md +0 -0
  305. /package/templates/{common → base}/timsquad/architectures/fsd/frontend.xml +0 -0
  306. /package/templates/{common → base}/timsquad/architectures/hexagonal/ARCHITECTURE.md +0 -0
  307. /package/templates/{common → base}/timsquad/architectures/hexagonal/backend.xml +0 -0
  308. /package/templates/{common → base}/timsquad/constraints/competency-framework.xml +0 -0
  309. /package/templates/{common → base}/timsquad/constraints/ssot-schema.xml +0 -0
  310. /package/templates/{common → base}/timsquad/feedback/feedback-router.sh +0 -0
  311. /package/templates/{common → base}/timsquad/generators/data-design.xml +0 -0
  312. /package/templates/{common → base}/timsquad/generators/prd.xml +0 -0
  313. /package/templates/{common → base}/timsquad/generators/requirements.xml +0 -0
  314. /package/templates/{common → base}/timsquad/generators/service-spec.xml +0 -0
  315. /package/templates/{common → base}/timsquad/logs/_example.md +0 -0
  316. /package/templates/{common → base}/timsquad/logs/_template.md +0 -0
  317. /package/templates/{common → base}/timsquad/patterns/cqrs.xml +0 -0
  318. /package/templates/{common → base}/timsquad/patterns/event-sourcing.xml +0 -0
  319. /package/templates/{common → base}/timsquad/patterns/repository.xml +0 -0
  320. /package/templates/{common → base}/timsquad/process/phase-checklist.yaml +0 -0
  321. /package/templates/{common → base}/timsquad/process/state-machine.xml +0 -0
  322. /package/templates/{common → base}/timsquad/process/validation-rules.xml +0 -0
  323. /package/templates/{common → base}/timsquad/process/workflow-base.xml +0 -0
  324. /package/templates/{common → base}/timsquad/retrospective/cycle-report.template.md +0 -0
  325. /package/templates/{common → base}/timsquad/retrospective/patterns/failure-patterns.md +0 -0
  326. /package/templates/{common → base}/timsquad/retrospective/patterns/success-patterns.md +0 -0
  327. /package/templates/{common → base}/timsquad/retrospective/retrospective-config.xml +0 -0
  328. /package/templates/{common → base}/timsquad/retrospective/retrospective-state.xml +0 -0
  329. /package/templates/{common → base}/timsquad/ssot/adr/ADR-000-template.md +0 -0
  330. /package/templates/{common → base}/timsquad/ssot/adr/ADR-001-example.md +0 -0
  331. /package/templates/{common → base}/timsquad/ssot/data-design.template.md +0 -0
  332. /package/templates/{common → base}/timsquad/ssot/deployment-spec.template.md +0 -0
  333. /package/templates/{common → base}/timsquad/ssot/env-config.template.md +0 -0
  334. /package/templates/{common → base}/timsquad/ssot/error-codes.template.md +0 -0
  335. /package/templates/{common → base}/timsquad/ssot/functional-spec.template.md +0 -0
  336. /package/templates/{common → base}/timsquad/ssot/glossary.template.md +0 -0
  337. /package/templates/{common → base}/timsquad/ssot/integration-spec.template.md +0 -0
  338. /package/templates/{common → base}/timsquad/ssot/planning.template.md +0 -0
  339. /package/templates/{common → base}/timsquad/ssot/prd.template.md +0 -0
  340. /package/templates/{common → base}/timsquad/ssot/requirements.template.md +0 -0
  341. /package/templates/{common → base}/timsquad/ssot/security-spec.template.md +0 -0
  342. /package/templates/{common → base}/timsquad/ssot/service-spec.template.md +0 -0
  343. /package/templates/{common → base}/timsquad/ssot/test-spec.template.md +0 -0
  344. /package/templates/{common → base}/timsquad/ssot/ui-ux-spec.template.md +0 -0
  345. /package/templates/{common → base}/timsquad/state/workspace.xml +0 -0
@@ -1,208 +0,0 @@
1
- #!/bin/bash
2
- # TimSquad Event Logger - Claude Code Hook
3
- # PostToolUse, Stop, SessionStart, SessionEnd 이벤트를 자동 기록
4
- #
5
- # 저장 위치: .timsquad/logs/sessions/{date}-{session_id_short}.jsonl
6
- # 형식: JSON Lines (한 줄 = 하나의 이벤트)
7
-
8
- set -euo pipefail
9
-
10
- # 프로젝트 루트 결정
11
- PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
12
- SESSIONS_DIR="$PROJECT_DIR/.timsquad/logs/sessions"
13
- mkdir -p "$SESSIONS_DIR"
14
-
15
- # stdin에서 JSON 읽기
16
- INPUT=$(cat)
17
-
18
- # 기본 필드 추출
19
- EVENT=$(echo "$INPUT" | jq -r '.hook_event_name // "unknown"')
20
- SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
21
- SESSION_SHORT="${SESSION_ID:0:8}"
22
- TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
23
- TODAY=$(date +"%Y-%m-%d")
24
-
25
- # 로그 파일 경로
26
- LOG_FILE="$SESSIONS_DIR/${TODAY}-${SESSION_SHORT}.jsonl"
27
-
28
- # 이벤트별 데이터 추출
29
- case "$EVENT" in
30
- PostToolUse|PostToolUseFailure)
31
- TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // "unknown"')
32
-
33
- # tool_input에서 핵심 정보만 추출 (전체 content 제외 - 용량 절약)
34
- case "$TOOL_NAME" in
35
- Write|Edit)
36
- TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
37
- file_path: .tool_input.file_path,
38
- action: "'"$TOOL_NAME"'"
39
- }')
40
- ;;
41
- Read)
42
- TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
43
- file_path: .tool_input.file_path,
44
- action: "Read"
45
- }')
46
- ;;
47
- Bash)
48
- # 커맨드만 추출 (출력 제외)
49
- TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
50
- command: (.tool_input.command // "" | .[0:200]),
51
- action: "Bash"
52
- }')
53
- ;;
54
- Glob|Grep)
55
- TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
56
- pattern: (.tool_input.pattern // ""),
57
- path: (.tool_input.path // ""),
58
- action: "'"$TOOL_NAME"'"
59
- }')
60
- ;;
61
- Task)
62
- TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
63
- description: (.tool_input.description // ""),
64
- subagent_type: (.tool_input.subagent_type // ""),
65
- action: "Task"
66
- }')
67
- ;;
68
- *)
69
- TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{action: "'"$TOOL_NAME"'"}')
70
- ;;
71
- esac
72
-
73
- # 성공 여부
74
- if [ "$EVENT" = "PostToolUseFailure" ]; then
75
- STATUS="failure"
76
- else
77
- STATUS="success"
78
- fi
79
-
80
- LOG_ENTRY=$(jq -n -c \
81
- --arg ts "$TIMESTAMP" \
82
- --arg ev "$EVENT" \
83
- --arg sid "$SESSION_SHORT" \
84
- --arg tool "$TOOL_NAME" \
85
- --arg status "$STATUS" \
86
- --argjson summary "$TOOL_SUMMARY" \
87
- '{timestamp: $ts, event: $ev, session: $sid, tool: $tool, status: $status, detail: $summary}')
88
- ;;
89
-
90
- Stop)
91
- # transcript에서 마지막 assistant 턴의 토큰 사용량 추출
92
- TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // ""')
93
- USAGE='{}'
94
-
95
- if [ -n "$TRANSCRIPT_PATH" ] && [ -f "$TRANSCRIPT_PATH" ]; then
96
- # 마지막 assistant 메시지의 usage 추출
97
- LAST_USAGE=$(tac "$TRANSCRIPT_PATH" | jq -c 'select(.type == "assistant" and .message.usage) | .message.usage' 2>/dev/null | head -1)
98
-
99
- if [ -n "$LAST_USAGE" ] && [ "$LAST_USAGE" != "null" ]; then
100
- USAGE=$(echo "$LAST_USAGE" | jq -c '{
101
- input: (.input_tokens // 0),
102
- output: (.output_tokens // 0),
103
- cache_create: (.cache_creation_input_tokens // 0),
104
- cache_read: (.cache_read_input_tokens // 0)
105
- }')
106
- fi
107
-
108
- # 누적 토큰 합산
109
- CUMULATIVE=$(jq -s -c '{
110
- total_input: ([.[].message.usage.input_tokens // 0] | add),
111
- total_output: ([.[].message.usage.output_tokens // 0] | add),
112
- total_cache_create: ([.[].message.usage.cache_creation_input_tokens // 0] | add),
113
- total_cache_read: ([.[].message.usage.cache_read_input_tokens // 0] | add),
114
- turns: length
115
- }' <(jq -c 'select(.type == "assistant" and .message.usage)' "$TRANSCRIPT_PATH" 2>/dev/null) 2>/dev/null || echo '{}')
116
- fi
117
-
118
- LOG_ENTRY=$(jq -n -c \
119
- --arg ts "$TIMESTAMP" \
120
- --arg ev "Stop" \
121
- --arg sid "$SESSION_SHORT" \
122
- --argjson usage "${USAGE:-'{}'}" \
123
- --argjson cumulative "${CUMULATIVE:-'{}'}" \
124
- '{timestamp: $ts, event: $ev, session: $sid, usage: $usage, cumulative: $cumulative}')
125
- ;;
126
-
127
- SessionStart)
128
- SOURCE=$(echo "$INPUT" | jq -r '.source // "unknown"')
129
- LOG_ENTRY=$(jq -n -c \
130
- --arg ts "$TIMESTAMP" \
131
- --arg ev "SessionStart" \
132
- --arg sid "$SESSION_SHORT" \
133
- --arg src "$SOURCE" \
134
- --arg cwd "$(echo "$INPUT" | jq -r '.cwd // ""')" \
135
- '{timestamp: $ts, event: $ev, session: $sid, source: $src, cwd: $cwd}')
136
- ;;
137
-
138
- SessionEnd)
139
- # transcript에서 최종 토큰 합산
140
- TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // ""')
141
- TOTAL_USAGE='{}'
142
-
143
- if [ -n "$TRANSCRIPT_PATH" ] && [ -f "$TRANSCRIPT_PATH" ]; then
144
- TOTAL_USAGE=$(jq -s -c '{
145
- total_input: ([.[].message.usage.input_tokens // 0] | add),
146
- total_output: ([.[].message.usage.output_tokens // 0] | add),
147
- total_cache_create: ([.[].message.usage.cache_creation_input_tokens // 0] | add),
148
- total_cache_read: ([.[].message.usage.cache_read_input_tokens // 0] | add),
149
- turns: length
150
- }' <(jq -c 'select(.type == "assistant" and .message.usage)' "$TRANSCRIPT_PATH" 2>/dev/null) 2>/dev/null || echo '{}')
151
- fi
152
-
153
- LOG_ENTRY=$(jq -n -c \
154
- --arg ts "$TIMESTAMP" \
155
- --arg ev "SessionEnd" \
156
- --arg sid "$SESSION_SHORT" \
157
- --argjson total_usage "${TOTAL_USAGE:-'{}'}" \
158
- '{timestamp: $ts, event: $ev, session: $sid, total_usage: $total_usage}')
159
-
160
- # SessionEnd 시 자동화 스크립트 체인 실행
161
- # 1. 작업 로그 자동 생성
162
- AUTO_WORKLOG="$PROJECT_DIR/.claude/hooks/auto-worklog.sh"
163
- if [ -f "$AUTO_WORKLOG" ]; then
164
- bash "$AUTO_WORKLOG" "$LOG_FILE" "$SESSION_SHORT" &
165
- fi
166
-
167
- # 2. 메트릭 자동 수집 (누적 갱신, 토큰 비용 0)
168
- AUTO_METRICS="$PROJECT_DIR/.claude/hooks/auto-metrics.sh"
169
- if [ -f "$AUTO_METRICS" ]; then
170
- bash "$AUTO_METRICS" "$LOG_FILE" "$SESSION_SHORT" &
171
- fi
172
- ;;
173
-
174
- SubagentStart)
175
- AGENT_TYPE=$(echo "$INPUT" | jq -r '.subagent_type // "unknown"')
176
- AGENT_DESC=$(echo "$INPUT" | jq -r '.description // ""' | head -c 200)
177
- LOG_ENTRY=$(jq -n -c \
178
- --arg ts "$TIMESTAMP" \
179
- --arg ev "SubagentStart" \
180
- --arg sid "$SESSION_SHORT" \
181
- --arg atype "$AGENT_TYPE" \
182
- --arg desc "$AGENT_DESC" \
183
- '{timestamp: $ts, event: $ev, session: $sid, detail: {subagent_type: $atype, description: $desc}}')
184
- ;;
185
-
186
- SubagentStop)
187
- AGENT_TYPE=$(echo "$INPUT" | jq -r '.subagent_type // "unknown"')
188
- LOG_ENTRY=$(jq -n -c \
189
- --arg ts "$TIMESTAMP" \
190
- --arg ev "SubagentStop" \
191
- --arg sid "$SESSION_SHORT" \
192
- --arg atype "$AGENT_TYPE" \
193
- '{timestamp: $ts, event: $ev, session: $sid, detail: {subagent_type: $atype}}')
194
- ;;
195
-
196
- *)
197
- LOG_ENTRY=$(jq -n -c \
198
- --arg ts "$TIMESTAMP" \
199
- --arg ev "$EVENT" \
200
- --arg sid "$SESSION_SHORT" \
201
- '{timestamp: $ts, event: $ev, session: $sid}')
202
- ;;
203
- esac
204
-
205
- # JSONL 파일에 append
206
- echo "$LOG_ENTRY" >> "$LOG_FILE"
207
-
208
- exit 0
@@ -1,86 +0,0 @@
1
- {
2
- "hooks": {
3
- "SessionStart": [
4
- {
5
- "hooks": [
6
- {
7
- "type": "command",
8
- "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/event-logger.sh\"",
9
- "timeout": 5
10
- }
11
- ]
12
- }
13
- ],
14
- "PostToolUse": [
15
- {
16
- "hooks": [
17
- {
18
- "type": "command",
19
- "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/event-logger.sh\"",
20
- "timeout": 5,
21
- "async": true
22
- }
23
- ]
24
- }
25
- ],
26
- "PostToolUseFailure": [
27
- {
28
- "hooks": [
29
- {
30
- "type": "command",
31
- "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/event-logger.sh\"",
32
- "timeout": 5,
33
- "async": true
34
- }
35
- ]
36
- }
37
- ],
38
- "Stop": [
39
- {
40
- "hooks": [
41
- {
42
- "type": "command",
43
- "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/event-logger.sh\"",
44
- "timeout": 5,
45
- "async": true
46
- }
47
- ]
48
- }
49
- ],
50
- "SubagentStart": [
51
- {
52
- "hooks": [
53
- {
54
- "type": "command",
55
- "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/event-logger.sh\"",
56
- "timeout": 5,
57
- "async": true
58
- }
59
- ]
60
- }
61
- ],
62
- "SubagentStop": [
63
- {
64
- "hooks": [
65
- {
66
- "type": "command",
67
- "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/event-logger.sh\"",
68
- "timeout": 5,
69
- "async": true
70
- }
71
- ]
72
- }
73
- ],
74
- "SessionEnd": [
75
- {
76
- "hooks": [
77
- {
78
- "type": "command",
79
- "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/event-logger.sh\"",
80
- "timeout": 10
81
- }
82
- ]
83
- }
84
- ]
85
- }
86
- }
@@ -1,123 +0,0 @@
1
- ---
2
- name: architecture
3
- description: 아키텍처 설계 및 API 명세 가이드라인
4
- user-invocable: false
5
- ---
6
-
7
- <skill name="architecture">
8
- <purpose>시스템 아키텍처 설계 및 API 명세를 위한 가이드라인</purpose>
9
-
10
- <clean-architecture>
11
- <layers>
12
- <layer name="Entities" level="core">핵심 비즈니스 로직</layer>
13
- <layer name="Use Cases" level="application">애플리케이션 로직</layer>
14
- <layer name="Interface Adapters" level="adapter">컨트롤러, 프레젠터</layer>
15
- <layer name="Frameworks & Drivers" level="external">DB, Web, 외부 시스템</layer>
16
- </layers>
17
- <principles>
18
- <principle>의존성 규칙: 안쪽 레이어는 바깥쪽을 모름</principle>
19
- <principle>추상화: 인터페이스를 통한 의존성 역전</principle>
20
- <principle>단일 책임: 각 컴포넌트는 하나의 역할</principle>
21
- </principles>
22
- </clean-architecture>
23
-
24
- <api-design>
25
- <restful-principles>
26
- <principle>리소스 중심 URL 설계</principle>
27
- <principle>HTTP 메서드 적절히 사용</principle>
28
- <principle>일관된 응답 형식</principle>
29
- </restful-principles>
30
- <url-patterns>
31
- <pattern method="GET" path="/api/v1/{resource}">목록 조회</pattern>
32
- <pattern method="GET" path="/api/v1/{resource}/:id">단일 조회</pattern>
33
- <pattern method="POST" path="/api/v1/{resource}">생성</pattern>
34
- <pattern method="PUT" path="/api/v1/{resource}/:id">전체 수정</pattern>
35
- <pattern method="PATCH" path="/api/v1/{resource}/:id">부분 수정</pattern>
36
- <pattern method="DELETE" path="/api/v1/{resource}/:id">삭제</pattern>
37
- </url-patterns>
38
- <response-format type="success">
39
- <![CDATA[
40
- {
41
- "success": true,
42
- "data": { ... },
43
- "error": null,
44
- "meta": {
45
- "page": 1,
46
- "limit": 20,
47
- "total": 100
48
- }
49
- }
50
- ]]>
51
- </response-format>
52
- <response-format type="error">
53
- <![CDATA[
54
- {
55
- "success": false,
56
- "data": null,
57
- "error": {
58
- "code": "AUTH_001",
59
- "message": "Invalid credentials",
60
- "details": { ... }
61
- }
62
- }
63
- ]]>
64
- </response-format>
65
- </api-design>
66
-
67
- <adr-guide>
68
- <when-to-write>
69
- <trigger>기술 스택 선정</trigger>
70
- <trigger>아키텍처 패턴 결정</trigger>
71
- <trigger>트레이드오프가 있는 결정</trigger>
72
- </when-to-write>
73
- <template>
74
- <![CDATA[
75
- # ADR-XXX: {제목}
76
-
77
- ## Status
78
- Proposed / Accepted / Deprecated / Superseded
79
-
80
- ## Context
81
- 결정이 필요한 배경과 상황
82
-
83
- ## Decision
84
- 내린 결정과 선택한 옵션
85
-
86
- ## Consequences
87
- ### Positive
88
- - 장점 1
89
- - 장점 2
90
-
91
- ### Negative
92
- - 단점 1 (완화 방안)
93
-
94
- ## Alternatives Considered
95
- | 옵션 | 장점 | 단점 |
96
- |-----|-----|-----|
97
- | A | ... | ... |
98
- | B | ... | ... |
99
- ]]>
100
- </template>
101
- </adr-guide>
102
-
103
- <data-design>
104
- <normalization>
105
- <form level="1NF">원자값</form>
106
- <form level="2NF">부분 함수 종속 제거</form>
107
- <form level="3NF">이행 함수 종속 제거</form>
108
- </normalization>
109
- <index-design>
110
- <guideline>자주 조회되는 컬럼</guideline>
111
- <guideline>WHERE, JOIN, ORDER BY에 사용되는 컬럼</guideline>
112
- <guideline>카디널리티 고려</guideline>
113
- </index-design>
114
- </data-design>
115
-
116
- <checklist>
117
- <item>레이어 간 의존성이 올바른가</item>
118
- <item>API 응답 형식이 일관적인가</item>
119
- <item>에러 코드가 문서화되었는가</item>
120
- <item>주요 결정에 ADR이 있는가</item>
121
- <item>데이터 모델이 정규화되었는가</item>
122
- </checklist>
123
- </skill>