timsquad 3.5.0 → 3.7.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 (454) hide show
  1. package/README.ko.md +103 -107
  2. package/README.md +100 -104
  3. package/dist/commands/daemon.d.ts.map +1 -1
  4. package/dist/commands/daemon.js +48 -2
  5. package/dist/commands/daemon.js.map +1 -1
  6. package/dist/commands/init.js +46 -14
  7. package/dist/commands/init.js.map +1 -1
  8. package/dist/commands/{upgrade.d.ts → update.d.ts} +3 -3
  9. package/dist/commands/update.d.ts.map +1 -0
  10. package/dist/commands/{upgrade.js → update.js} +12 -17
  11. package/dist/commands/update.js.map +1 -0
  12. package/dist/daemon/context-writer.d.ts +14 -0
  13. package/dist/daemon/context-writer.d.ts.map +1 -1
  14. package/dist/daemon/context-writer.js +29 -0
  15. package/dist/daemon/context-writer.js.map +1 -1
  16. package/dist/daemon/event-queue.d.ts +7 -11
  17. package/dist/daemon/event-queue.d.ts.map +1 -1
  18. package/dist/daemon/event-queue.js +78 -118
  19. package/dist/daemon/event-queue.js.map +1 -1
  20. package/dist/daemon/file-watcher.d.ts +14 -8
  21. package/dist/daemon/file-watcher.d.ts.map +1 -1
  22. package/dist/daemon/file-watcher.js +78 -41
  23. package/dist/daemon/file-watcher.js.map +1 -1
  24. package/dist/daemon/index.d.ts +1 -1
  25. package/dist/daemon/index.d.ts.map +1 -1
  26. package/dist/daemon/index.js +54 -47
  27. package/dist/daemon/index.js.map +1 -1
  28. package/dist/index.js +3 -41
  29. package/dist/index.js.map +1 -1
  30. package/dist/lib/agent-generator.d.ts.map +1 -1
  31. package/dist/lib/agent-generator.js +21 -10
  32. package/dist/lib/agent-generator.js.map +1 -1
  33. package/dist/lib/compile-rules.d.ts +2 -0
  34. package/dist/lib/compile-rules.d.ts.map +1 -1
  35. package/dist/lib/compile-rules.js +39 -4
  36. package/dist/lib/compile-rules.js.map +1 -1
  37. package/dist/lib/compiler.d.ts +22 -1
  38. package/dist/lib/compiler.d.ts.map +1 -1
  39. package/dist/lib/compiler.js +178 -12
  40. package/dist/lib/compiler.js.map +1 -1
  41. package/dist/lib/config.d.ts +3 -0
  42. package/dist/lib/config.d.ts.map +1 -1
  43. package/dist/lib/config.js +17 -2
  44. package/dist/lib/config.js.map +1 -1
  45. package/dist/{commands/log.d.ts → lib/log-utils.d.ts} +7 -15
  46. package/dist/lib/log-utils.d.ts.map +1 -0
  47. package/dist/lib/log-utils.js +347 -0
  48. package/dist/lib/log-utils.js.map +1 -0
  49. package/dist/lib/skill-generator.d.ts +1 -1
  50. package/dist/lib/skill-generator.d.ts.map +1 -1
  51. package/dist/lib/skill-generator.js +19 -44
  52. package/dist/lib/skill-generator.js.map +1 -1
  53. package/dist/lib/ssot-map.d.ts +31 -0
  54. package/dist/lib/ssot-map.d.ts.map +1 -0
  55. package/dist/lib/ssot-map.js +79 -0
  56. package/dist/lib/ssot-map.js.map +1 -0
  57. package/dist/lib/template.d.ts +10 -3
  58. package/dist/lib/template.d.ts.map +1 -1
  59. package/dist/lib/template.js +137 -22
  60. package/dist/lib/template.js.map +1 -1
  61. package/dist/lib/upgrade-backup.js +1 -1
  62. package/dist/lib/upgrade-backup.js.map +1 -1
  63. package/dist/lib/workflow-state.d.ts +1 -1
  64. package/dist/lib/workflow-state.d.ts.map +1 -1
  65. package/dist/lib/workflow-state.js +1 -1
  66. package/dist/lib/workflow-state.js.map +1 -1
  67. package/dist/types/config.d.ts +10 -1
  68. package/dist/types/config.d.ts.map +1 -1
  69. package/dist/types/config.js +46 -41
  70. package/dist/types/config.js.map +1 -1
  71. package/dist/types/feedback.d.ts +1 -54
  72. package/dist/types/feedback.d.ts.map +1 -1
  73. package/dist/types/feedback.js +1 -22
  74. package/dist/types/feedback.js.map +1 -1
  75. package/dist/types/index.d.ts +1 -0
  76. package/dist/types/index.d.ts.map +1 -1
  77. package/dist/types/index.js +1 -0
  78. package/dist/types/index.js.map +1 -1
  79. package/dist/types/meta-index.d.ts +8 -0
  80. package/dist/types/meta-index.d.ts.map +1 -1
  81. package/dist/types/project.d.ts +6 -1
  82. package/dist/types/project.d.ts.map +1 -1
  83. package/dist/types/project.js +15 -0
  84. package/dist/types/project.js.map +1 -1
  85. package/dist/types/ssot-map.d.ts +30 -0
  86. package/dist/types/ssot-map.d.ts.map +1 -0
  87. package/dist/types/ssot-map.js +6 -0
  88. package/dist/types/ssot-map.js.map +1 -0
  89. package/package.json +1 -1
  90. package/templates/base/agents/base/tsq-architect.md +1 -1
  91. package/templates/base/agents/base/tsq-dba.md +3 -1
  92. package/templates/base/agents/base/tsq-designer.md +3 -1
  93. package/templates/base/agents/base/tsq-developer.md +3 -1
  94. package/templates/base/agents/base/tsq-librarian.md +45 -0
  95. package/templates/base/agents/base/tsq-qa.md +3 -1
  96. package/templates/base/agents/base/tsq-security.md +3 -1
  97. package/templates/base/agents/overlays/platform/claude-code.md +2 -2
  98. package/templates/base/config.template.yaml +17 -28
  99. package/templates/base/knowledge/templates/task-result.md +5 -10
  100. package/templates/base/skills/_shared/naming-conventions.md +49 -0
  101. package/templates/base/skills/_template/SKILL.md +31 -17
  102. package/templates/base/skills/{architecture → tsq-architecture}/SKILL.md +2 -2
  103. package/templates/base/skills/tsq-audit/SKILL.md +74 -0
  104. package/templates/base/skills/{methodology/bdd → tsq-bdd}/SKILL.md +14 -9
  105. package/templates/base/skills/tsq-coding/SKILL.md +65 -0
  106. package/templates/base/skills/tsq-coding/rules/async-patterns.md +81 -0
  107. package/templates/base/skills/tsq-coding/rules/code-organization.md +80 -0
  108. package/templates/base/skills/tsq-coding/rules/error-handling.md +76 -0
  109. package/templates/base/skills/tsq-coding/rules/type-safety.md +85 -0
  110. package/templates/base/skills/tsq-controller/SKILL.md +81 -0
  111. package/templates/base/skills/tsq-controller/memory/.gitkeep +0 -0
  112. package/templates/base/skills/{mobile/dart → tsq-dart}/SKILL.md +5 -3
  113. package/templates/base/skills/{database → tsq-database}/SKILL.md +13 -27
  114. package/templates/base/skills/tsq-database/rules/query-optimization.md +32 -0
  115. package/templates/base/skills/tsq-database/rules/supabase-patterns.md +94 -0
  116. package/templates/base/skills/{methodology/ddd → tsq-ddd}/SKILL.md +15 -10
  117. package/templates/base/skills/{methodology/debugging → tsq-debugging}/SKILL.md +2 -2
  118. package/templates/base/skills/tsq-decompose/SKILL.md +117 -0
  119. package/templates/base/skills/tsq-delete/SKILL.md +72 -0
  120. package/templates/base/skills/{mobile/flutter → tsq-flutter}/SKILL.md +6 -3
  121. package/templates/base/skills/tsq-grill/SKILL.md +86 -0
  122. package/templates/base/skills/{backend/node → tsq-hono}/SKILL.md +6 -4
  123. package/templates/base/skills/tsq-librarian/SKILL.md +78 -0
  124. package/templates/base/skills/tsq-log/SKILL.md +30 -0
  125. package/templates/base/skills/{frontend/nextjs → tsq-nextjs}/SKILL.md +14 -9
  126. package/templates/base/skills/{planning → tsq-planning}/SKILL.md +2 -2
  127. package/templates/base/skills/{database/prisma → tsq-prisma}/SKILL.md +15 -9
  128. package/templates/base/skills/tsq-product-audit/SKILL.md +113 -0
  129. package/templates/base/skills/tsq-product-audit/checklists/01-security.md +86 -0
  130. package/templates/base/skills/tsq-product-audit/checklists/02-performance.md +67 -0
  131. package/templates/base/skills/tsq-product-audit/checklists/03-seo.md +46 -0
  132. package/templates/base/skills/tsq-product-audit/checklists/04-accessibility.md +66 -0
  133. package/templates/base/skills/tsq-product-audit/checklists/05-ui-ux.md +50 -0
  134. package/templates/base/skills/tsq-product-audit/checklists/06-architecture.md +53 -0
  135. package/templates/base/skills/tsq-product-audit/checklists/07-functional-requirements.md +55 -0
  136. package/templates/base/skills/tsq-product-audit/rules/audit-protocol.md +136 -0
  137. package/templates/base/skills/tsq-product-audit/rules/false-positive-guard.md +81 -0
  138. package/templates/base/skills/tsq-product-audit/rules/scoring-criteria.md +113 -0
  139. package/templates/base/skills/tsq-product-audit/templates/improvement-plan-template.md +60 -0
  140. package/templates/base/skills/tsq-product-audit/templates/report-template.md +88 -0
  141. package/templates/base/skills/tsq-prompt/SKILL.md +86 -0
  142. package/templates/base/skills/tsq-protocol/SKILL.md +101 -33
  143. package/templates/base/skills/{frontend/react → tsq-react}/SKILL.md +6 -3
  144. package/templates/base/skills/tsq-retro/SKILL.md +86 -0
  145. package/templates/base/skills/tsq-retro/references/feedback-guide.md +58 -0
  146. package/templates/base/skills/tsq-retro/references/improve-protocol.md +87 -0
  147. package/templates/base/skills/tsq-retro/references/improvement-template.md +26 -0
  148. package/templates/base/skills/tsq-security/SKILL.md +66 -0
  149. package/templates/base/skills/tsq-security/rules/auth-patterns.md +62 -0
  150. package/templates/base/skills/tsq-security/rules/dependency-security.md +69 -0
  151. package/templates/base/skills/tsq-security/rules/input-validation.md +68 -0
  152. package/templates/base/skills/tsq-security/rules/secrets-management.md +65 -0
  153. package/templates/base/skills/tsq-spec/SKILL.md +58 -0
  154. package/templates/base/skills/{stability-verification → tsq-stability}/SKILL.md +3 -3
  155. package/templates/base/skills/tsq-start/SKILL.md +90 -0
  156. package/templates/base/skills/tsq-start/references/onboarding-questions.md +177 -0
  157. package/templates/base/skills/tsq-status/SKILL.md +32 -0
  158. package/templates/base/skills/{methodology/tdd → tsq-tdd}/SKILL.md +12 -3
  159. package/templates/base/skills/tsq-testing/SKILL.md +69 -0
  160. package/templates/base/skills/tsq-testing/references/e2e-stability.md +33 -0
  161. package/templates/base/skills/{typescript → tsq-typescript}/SKILL.md +5 -11
  162. package/templates/base/skills/{ui-design → tsq-ui}/SKILL.md +2 -2
  163. package/templates/base/skills/tsq-update/SKILL.md +48 -0
  164. package/templates/base/timsquad/constraints/competency-framework.xml +2 -2
  165. package/templates/base/timsquad/constraints/ssot-schema.xml +2 -2
  166. package/templates/base/timsquad/process/phase-checklist.yaml +1 -1
  167. package/templates/base/timsquad/process/state-machine.xml +2 -2
  168. package/templates/base/timsquad/process/validation-rules.xml +8 -8
  169. package/templates/base/timsquad/process/workflow-base.xml +8 -8
  170. package/templates/base/timsquad/retrospective/cycle-report.template.md +2 -2
  171. package/templates/base/timsquad/retrospective/patterns/failure-patterns.md +1 -1
  172. package/templates/base/timsquad/retrospective/patterns/success-patterns.md +2 -2
  173. package/templates/base/timsquad/retrospective/retrospective-state.xml +2 -2
  174. package/templates/base/timsquad/ssot/audit-trail-spec.template.md +155 -0
  175. package/templates/base/timsquad/ssot/compliance-matrix.template.md +105 -0
  176. package/templates/base/timsquad/ssot/component-map.template.md +181 -0
  177. package/templates/base/timsquad/ssot/data-design.template.md +4 -4
  178. package/templates/base/timsquad/ssot/deployment-spec.template.md +29 -22
  179. package/templates/base/timsquad/ssot/env-config.template.md +4 -2
  180. package/templates/base/timsquad/ssot/error-codes.template.md +3 -3
  181. package/templates/base/timsquad/ssot/functional-spec.template.md +40 -3
  182. package/templates/base/timsquad/ssot/glossary.template.md +2 -2
  183. package/templates/base/timsquad/ssot/infra-topology.template.md +191 -0
  184. package/templates/base/timsquad/ssot/integration-spec.template.md +2 -2
  185. package/templates/base/timsquad/ssot/monitoring-spec.template.md +185 -0
  186. package/templates/base/timsquad/ssot/navigation-map.template.md +154 -0
  187. package/templates/base/timsquad/ssot/performance-budget.template.md +132 -0
  188. package/templates/base/timsquad/ssot/planning.template.md +3 -3
  189. package/templates/base/timsquad/ssot/prd/_template.md +73 -0
  190. package/templates/base/timsquad/ssot/prd.template.md +10 -21
  191. package/templates/base/timsquad/ssot/requirements.template.md +3 -3
  192. package/templates/base/timsquad/ssot/sdk-spec.template.md +223 -0
  193. package/templates/base/timsquad/ssot/service-spec.template.md +3 -3
  194. package/templates/base/timsquad/ssot/state-machine.template.md +127 -0
  195. package/templates/base/timsquad/ssot/test-spec.template.md +11 -1
  196. package/templates/base/timsquad/ssot/ui-ux-spec.template.md +43 -3
  197. package/templates/base/timsquad/ssot-map.template.yaml +69 -0
  198. package/templates/base/timsquad/state/workspace.xml +11 -11
  199. package/templates/platforms/claude-code/rules/adr-rules.md +1 -1
  200. package/templates/platforms/claude-code/rules/api-conventions.md +12 -0
  201. package/templates/platforms/claude-code/rules/build-gate.md +1 -1
  202. package/templates/platforms/claude-code/rules/completion-verification.md +0 -2
  203. package/templates/platforms/claude-code/rules/context-monitor.md +1 -1
  204. package/templates/platforms/claude-code/rules/feedback-routing.md +2 -2
  205. package/templates/platforms/claude-code/rules/librarian-constraints.md +11 -0
  206. package/templates/platforms/claude-code/rules/phase-management.md +2 -2
  207. package/templates/platforms/claude-code/rules/plan-review.md +2 -2
  208. package/templates/platforms/claude-code/rules/quality-guards.md +0 -2
  209. package/templates/platforms/claude-code/rules/sequence-management.md +15 -15
  210. package/templates/platforms/claude-code/rules/session-notes.md +1 -1
  211. package/templates/platforms/claude-code/rules/test-conventions.md +13 -0
  212. package/templates/platforms/claude-code/rules/workspace-sync.md +1 -1
  213. package/templates/platforms/claude-code/scripts/build-gate.sh +6 -1
  214. package/templates/platforms/claude-code/scripts/change-scope-guard.sh +110 -0
  215. package/templates/platforms/claude-code/scripts/check-capability.sh +68 -0
  216. package/templates/platforms/claude-code/scripts/completion-guard.sh +134 -14
  217. package/templates/platforms/claude-code/scripts/context-restore.sh +95 -0
  218. package/templates/platforms/claude-code/scripts/e2e-commit-gate.sh +70 -0
  219. package/templates/platforms/claude-code/scripts/e2e-marker.sh +51 -0
  220. package/templates/platforms/claude-code/scripts/phase-guard.sh +3 -6
  221. package/templates/platforms/claude-code/scripts/pre-compact.sh +70 -0
  222. package/templates/platforms/claude-code/scripts/safe-guard.sh +2 -5
  223. package/templates/platforms/claude-code/scripts/subagent-start.sh +11 -0
  224. package/templates/platforms/claude-code/scripts/subagent-stop.sh +11 -0
  225. package/templates/platforms/claude-code/settings.json +28 -56
  226. package/templates/project-types/api-backend/config.yaml +9 -5
  227. package/templates/project-types/api-backend/process/workflow.xml +2 -2
  228. package/templates/project-types/fintech/config.yaml +13 -19
  229. package/templates/project-types/fintech/ssot/audit-trail-spec.template.md +207 -0
  230. package/templates/project-types/fintech/ssot/compliance-matrix.template.md +187 -0
  231. package/templates/project-types/infra/config.yaml +7 -4
  232. package/templates/project-types/infra/process/workflow.xml +3 -3
  233. package/templates/project-types/mobile-app/config.yaml +8 -14
  234. package/templates/project-types/mobile-app/process/workflow.xml +4 -4
  235. package/templates/project-types/platform/config.yaml +8 -5
  236. package/templates/project-types/platform/process/workflow.xml +3 -3
  237. package/templates/project-types/web-app/config.yaml +9 -15
  238. package/templates/project-types/web-app/process/workflow.xml +6 -6
  239. package/templates/project-types/web-service/config.yaml +10 -19
  240. package/templates/project-types/web-service/process/workflow.xml +6 -6
  241. package/dist/commands/compile.d.ts +0 -3
  242. package/dist/commands/compile.d.ts.map +0 -1
  243. package/dist/commands/compile.js +0 -170
  244. package/dist/commands/compile.js.map +0 -1
  245. package/dist/commands/feedback.d.ts +0 -12
  246. package/dist/commands/feedback.d.ts.map +0 -1
  247. package/dist/commands/feedback.js +0 -382
  248. package/dist/commands/feedback.js.map +0 -1
  249. package/dist/commands/full.d.ts +0 -3
  250. package/dist/commands/full.d.ts.map +0 -1
  251. package/dist/commands/full.js +0 -88
  252. package/dist/commands/full.js.map +0 -1
  253. package/dist/commands/git/commit.d.ts +0 -3
  254. package/dist/commands/git/commit.d.ts.map +0 -1
  255. package/dist/commands/git/commit.js +0 -85
  256. package/dist/commands/git/commit.js.map +0 -1
  257. package/dist/commands/git/index.d.ts +0 -5
  258. package/dist/commands/git/index.d.ts.map +0 -1
  259. package/dist/commands/git/index.js +0 -5
  260. package/dist/commands/git/index.js.map +0 -1
  261. package/dist/commands/git/pr.d.ts +0 -3
  262. package/dist/commands/git/pr.d.ts.map +0 -1
  263. package/dist/commands/git/pr.js +0 -139
  264. package/dist/commands/git/pr.js.map +0 -1
  265. package/dist/commands/git/release.d.ts +0 -3
  266. package/dist/commands/git/release.d.ts.map +0 -1
  267. package/dist/commands/git/release.js +0 -153
  268. package/dist/commands/git/release.js.map +0 -1
  269. package/dist/commands/git/sync.d.ts +0 -3
  270. package/dist/commands/git/sync.d.ts.map +0 -1
  271. package/dist/commands/git/sync.js +0 -132
  272. package/dist/commands/git/sync.js.map +0 -1
  273. package/dist/commands/improve.d.ts +0 -3
  274. package/dist/commands/improve.d.ts.map +0 -1
  275. package/dist/commands/improve.js +0 -286
  276. package/dist/commands/improve.js.map +0 -1
  277. package/dist/commands/knowledge.d.ts +0 -3
  278. package/dist/commands/knowledge.d.ts.map +0 -1
  279. package/dist/commands/knowledge.js +0 -316
  280. package/dist/commands/knowledge.js.map +0 -1
  281. package/dist/commands/log.d.ts.map +0 -1
  282. package/dist/commands/log.js +0 -1436
  283. package/dist/commands/log.js.map +0 -1
  284. package/dist/commands/meta-index.d.ts +0 -3
  285. package/dist/commands/meta-index.d.ts.map +0 -1
  286. package/dist/commands/meta-index.js +0 -401
  287. package/dist/commands/meta-index.js.map +0 -1
  288. package/dist/commands/metrics.d.ts +0 -3
  289. package/dist/commands/metrics.d.ts.map +0 -1
  290. package/dist/commands/metrics.js +0 -843
  291. package/dist/commands/metrics.js.map +0 -1
  292. package/dist/commands/quick.d.ts +0 -3
  293. package/dist/commands/quick.d.ts.map +0 -1
  294. package/dist/commands/quick.js +0 -136
  295. package/dist/commands/quick.js.map +0 -1
  296. package/dist/commands/retro.d.ts +0 -3
  297. package/dist/commands/retro.d.ts.map +0 -1
  298. package/dist/commands/retro.js +0 -828
  299. package/dist/commands/retro.js.map +0 -1
  300. package/dist/commands/session.d.ts +0 -3
  301. package/dist/commands/session.d.ts.map +0 -1
  302. package/dist/commands/session.js +0 -346
  303. package/dist/commands/session.js.map +0 -1
  304. package/dist/commands/skills.d.ts +0 -12
  305. package/dist/commands/skills.d.ts.map +0 -1
  306. package/dist/commands/skills.js +0 -228
  307. package/dist/commands/skills.js.map +0 -1
  308. package/dist/commands/status.d.ts +0 -3
  309. package/dist/commands/status.d.ts.map +0 -1
  310. package/dist/commands/status.js +0 -127
  311. package/dist/commands/status.js.map +0 -1
  312. package/dist/commands/upgrade.d.ts.map +0 -1
  313. package/dist/commands/upgrade.js.map +0 -1
  314. package/dist/commands/watch.d.ts +0 -3
  315. package/dist/commands/watch.d.ts.map +0 -1
  316. package/dist/commands/watch.js +0 -213
  317. package/dist/commands/watch.js.map +0 -1
  318. package/dist/commands/workflow.d.ts +0 -3
  319. package/dist/commands/workflow.d.ts.map +0 -1
  320. package/dist/commands/workflow.js +0 -607
  321. package/dist/commands/workflow.js.map +0 -1
  322. package/templates/base/skills/coding/SKILL.md +0 -47
  323. package/templates/base/skills/controller/SKILL.md +0 -111
  324. package/templates/base/skills/prompt-engineering/SKILL.md +0 -103
  325. package/templates/base/skills/retrospective/SKILL.md +0 -102
  326. package/templates/base/skills/security/SKILL.md +0 -55
  327. package/templates/base/skills/testing/SKILL.md +0 -63
  328. package/templates/base/timsquad/feedback/feedback-router.sh +0 -341
  329. package/templates/base/timsquad/feedback/routing-rules.yaml +0 -352
  330. package/templates/platforms/claude-code/CLAUDE.md.template +0 -89
  331. package/templates/platforms/claude-code/rules/skill-suggest.md +0 -27
  332. package/templates/platforms/claude-code/scripts/skill-rules.json +0 -85
  333. package/templates/platforms/claude-code/scripts/skill-suggest.sh +0 -105
  334. /package/templates/base/skills/{architecture → tsq-architecture}/references/adr-template.md +0 -0
  335. /package/templates/base/skills/{architecture → tsq-architecture}/references/api-design.md +0 -0
  336. /package/templates/base/skills/{methodology/bdd → tsq-bdd}/rules/gherkin-patterns.md +0 -0
  337. /package/templates/base/skills/{coding → tsq-coding}/rules/patterns.md +0 -0
  338. /package/templates/base/skills/{controller → tsq-controller}/references/README.md +0 -0
  339. /package/templates/base/skills/{controller → tsq-controller}/rules/README.md +0 -0
  340. /package/templates/base/skills/{mobile/dart → tsq-dart}/rules/async-patterns.md +0 -0
  341. /package/templates/base/skills/{mobile/dart → tsq-dart}/rules/code-style.md +0 -0
  342. /package/templates/base/skills/{mobile/dart → tsq-dart}/rules/null-safety.md +0 -0
  343. /package/templates/base/skills/{mobile/dart → tsq-dart}/rules/type-system.md +0 -0
  344. /package/templates/base/skills/{methodology/ddd → tsq-ddd}/rules/strategic-patterns.md +0 -0
  345. /package/templates/base/skills/{methodology/debugging → tsq-debugging}/references/root-cause-tracing.md +0 -0
  346. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/SKILL.md +0 -0
  347. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/references/ci-cd-pipeline.md +0 -0
  348. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/code-signing.md +0 -0
  349. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/codemagic-setup.md +0 -0
  350. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/fastlane-setup.md +0 -0
  351. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/github-actions.md +0 -0
  352. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/store-deployment.md +0 -0
  353. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/versioning.md +0 -0
  354. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/SKILL.md +0 -0
  355. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/references/i18n-architecture.md +0 -0
  356. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/arb-files.md +0 -0
  357. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/locale-switching.md +0 -0
  358. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/localization-setup.md +0 -0
  359. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/plural-gender.md +0 -0
  360. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/text-direction.md +0 -0
  361. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/SKILL.md +0 -0
  362. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/references/monitoring-architecture.md +0 -0
  363. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/analytics.md +0 -0
  364. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/crashlytics-setup.md +0 -0
  365. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/logging.md +0 -0
  366. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/performance-monitoring.md +0 -0
  367. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/sentry-integration.md +0 -0
  368. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/SKILL.md +0 -0
  369. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/references/api-client-architecture.md +0 -0
  370. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/caching.md +0 -0
  371. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/connectivity.md +0 -0
  372. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/dio-setup.md +0 -0
  373. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/error-handling.md +0 -0
  374. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/interceptors.md +0 -0
  375. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/retrofit-patterns.md +0 -0
  376. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/SKILL.md +0 -0
  377. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/references/notification-architecture.md +0 -0
  378. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/references/platform-setup.md +0 -0
  379. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/background-processing.md +0 -0
  380. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/deep-linking.md +0 -0
  381. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/fcm-setup.md +0 -0
  382. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/local-notifications.md +0 -0
  383. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/notification-handling.md +0 -0
  384. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/notification-permissions.md +0 -0
  385. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/rich-notifications.md +0 -0
  386. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/references/freezed-patterns.md +0 -0
  387. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/references/project-structure.md +0 -0
  388. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/animations.md +0 -0
  389. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/architecture.md +0 -0
  390. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/navigation-routing.md +0 -0
  391. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/performance.md +0 -0
  392. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/platform-adaptive.md +0 -0
  393. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/state-management.md +0 -0
  394. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/testing.md +0 -0
  395. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/widget-conventions.md +0 -0
  396. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/SKILL.md +0 -0
  397. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/references/mobile-security-checklist.md +0 -0
  398. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/api-key-protection.md +0 -0
  399. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/authentication.md +0 -0
  400. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/data-protection.md +0 -0
  401. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/obfuscation.md +0 -0
  402. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/secure-storage.md +0 -0
  403. /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/ssl-pinning.md +0 -0
  404. /package/templates/base/skills/{backend/node → tsq-hono}/rules/async-patterns.md +0 -0
  405. /package/templates/base/skills/{backend/node → tsq-hono}/rules/deployment.md +0 -0
  406. /package/templates/base/skills/{backend/node → tsq-hono}/rules/env-config.md +0 -0
  407. /package/templates/base/skills/{backend/node → tsq-hono}/rules/error-handling.md +0 -0
  408. /package/templates/base/skills/{backend/node → tsq-hono}/rules/hono-app-setup.md +0 -0
  409. /package/templates/base/skills/{backend/node → tsq-hono}/rules/jwt-auth.md +0 -0
  410. /package/templates/base/skills/{backend/node → tsq-hono}/rules/middleware.md +0 -0
  411. /package/templates/base/skills/{backend/node → tsq-hono}/rules/testing.md +0 -0
  412. /package/templates/base/skills/{frontend/nextjs → tsq-nextjs}/rules/app-router.md +0 -0
  413. /package/templates/base/skills/{planning → tsq-planning}/references/prd-guide.md +0 -0
  414. /package/templates/base/skills/{planning → tsq-planning}/references/requirements-guide.md +0 -0
  415. /package/templates/base/skills/{database/prisma → tsq-prisma}/rules/queries.md +0 -0
  416. /package/templates/base/skills/{database/prisma → tsq-prisma}/rules/schema-design.md +0 -0
  417. /package/templates/base/skills/{frontend/react → tsq-react}/rules/_sections.md +0 -0
  418. /package/templates/base/skills/{frontend/react → tsq-react}/rules/anti-patterns.md +0 -0
  419. /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-api-routes.md +0 -0
  420. /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-defer-await.md +0 -0
  421. /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-dependencies.md +0 -0
  422. /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-parallel.md +0 -0
  423. /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-suspense-boundaries.md +0 -0
  424. /package/templates/base/skills/{frontend/react → tsq-react}/rules/bundle-barrel-imports.md +0 -0
  425. /package/templates/base/skills/{frontend/react → tsq-react}/rules/bundle-defer-third-party.md +0 -0
  426. /package/templates/base/skills/{frontend/react → tsq-react}/rules/bundle-dynamic-imports.md +0 -0
  427. /package/templates/base/skills/{frontend/react → tsq-react}/rules/component-conventions.md +0 -0
  428. /package/templates/base/skills/{frontend/react → tsq-react}/rules/js-combine-iterations.md +0 -0
  429. /package/templates/base/skills/{frontend/react → tsq-react}/rules/js-early-exit.md +0 -0
  430. /package/templates/base/skills/{frontend/react → tsq-react}/rules/js-index-maps.md +0 -0
  431. /package/templates/base/skills/{frontend/react → tsq-react}/rules/js-set-map-lookups.md +0 -0
  432. /package/templates/base/skills/{frontend/react → tsq-react}/rules/rendering-conditional-render.md +0 -0
  433. /package/templates/base/skills/{frontend/react → tsq-react}/rules/rendering-content-visibility.md +0 -0
  434. /package/templates/base/skills/{frontend/react → tsq-react}/rules/rendering-hoist-jsx.md +0 -0
  435. /package/templates/base/skills/{frontend/react → tsq-react}/rules/rerender-defer-reads.md +0 -0
  436. /package/templates/base/skills/{frontend/react → tsq-react}/rules/rerender-derived-state.md +0 -0
  437. /package/templates/base/skills/{frontend/react → tsq-react}/rules/rerender-memo.md +0 -0
  438. /package/templates/base/skills/{frontend/react → tsq-react}/rules/rerender-transitions.md +0 -0
  439. /package/templates/base/skills/{frontend/react → tsq-react}/rules/server-after-nonblocking.md +0 -0
  440. /package/templates/base/skills/{frontend/react → tsq-react}/rules/server-cache-react.md +0 -0
  441. /package/templates/base/skills/{frontend/react → tsq-react}/rules/server-parallel-fetching.md +0 -0
  442. /package/templates/base/skills/{frontend/react → tsq-react}/rules/state-location.md +0 -0
  443. /package/templates/base/skills/{security → tsq-security}/rules/owasp-examples.md +0 -0
  444. /package/templates/base/skills/{security → tsq-security}/scripts/check-secrets.sh +0 -0
  445. /package/templates/base/skills/{stability-verification → tsq-stability}/references/release-checklist.md +0 -0
  446. /package/templates/base/skills/{stability-verification → tsq-stability}/references/security-fix-patterns.md +0 -0
  447. /package/templates/base/skills/{stability-verification → tsq-stability}/rules/verification-layers.md +0 -0
  448. /package/templates/base/skills/{stability-verification → tsq-stability}/rules/verification-workflow.md +0 -0
  449. /package/templates/base/skills/{stability-verification → tsq-stability}/scripts/verify.sh +0 -0
  450. /package/templates/base/skills/{methodology/tdd → tsq-tdd}/rules/real-world-example.md +0 -0
  451. /package/templates/base/skills/{methodology/tdd → tsq-tdd}/rules/techniques.md +0 -0
  452. /package/templates/base/skills/{testing → tsq-testing}/references/testing-patterns.md +0 -0
  453. /package/templates/base/skills/{typescript → tsq-typescript}/rules/type-patterns.md +0 -0
  454. /package/templates/base/skills/{typescript → tsq-typescript}/rules/utility-types.md +0 -0
@@ -0,0 +1,181 @@
1
+ ---
2
+ title: "컴포넌트 맵 (Component Map)"
3
+ version: 1.0.0
4
+ last_updated: {{DATE}}
5
+ author: tsq-designer
6
+ status: draft
7
+ project: {{PROJECT_NAME}}
8
+ ---
9
+
10
+ # 컴포넌트 맵 (Component Map)
11
+
12
+ > UI 컴포넌트의 계층 구조, 재사용 정책, Props 인터페이스를 정의합니다.
13
+ > 디자인 시스템과 개발 구현 사이의 일관성을 보장합니다.
14
+
15
+ ---
16
+
17
+ ## 1. 컴포넌트 계층
18
+
19
+ ### 1.1 분류 체계
20
+
21
+ | 계층 | 설명 | 예시 | 의존성 |
22
+ |-----|------|------|--------|
23
+ | Primitives | 최소 단위, 스타일만 | Button, Input, Text | 없음 |
24
+ | Components | 단일 기능 조합 | SearchBar, Card, Modal | Primitives |
25
+ | Composites | 비즈니스 로직 포함 | UserCard, OrderList | Components + 상태 |
26
+ | Layouts | 페이지 레이아웃 | AppShell, SidebarLayout | Composites |
27
+ | Pages | 라우트 대응 화면 | HomePage, DetailPage | Layouts + 데이터 |
28
+
29
+ ### 1.2 디렉토리 구조
30
+
31
+ ```
32
+ src/components/
33
+ ├── primitives/
34
+ │ ├── Button/
35
+ │ │ ├── Button.tsx
36
+ │ │ ├── Button.test.tsx
37
+ │ │ └── index.ts
38
+ │ ├── Input/
39
+ │ ├── Text/
40
+ │ └── Icon/
41
+ ├── components/
42
+ │ ├── SearchBar/
43
+ │ ├── Card/
44
+ │ ├── Modal/
45
+ │ └── Toast/
46
+ ├── composites/
47
+ │ ├── UserCard/
48
+ │ ├── OrderList/
49
+ │ └── NotificationBell/
50
+ └── layouts/
51
+ ├── AppShell/
52
+ ├── AuthLayout/
53
+ └── DashboardLayout/
54
+ ```
55
+
56
+ ---
57
+
58
+ ## 2. Primitives
59
+
60
+ ### 2.1 Button
61
+
62
+ | Prop | 타입 | 기본값 | 설명 |
63
+ |------|------|--------|------|
64
+ | variant | `'primary' \| 'secondary' \| 'ghost' \| 'danger'` | `'primary'` | 스타일 변형 |
65
+ | size | `'sm' \| 'md' \| 'lg'` | `'md'` | 크기 |
66
+ | disabled | `boolean` | `false` | 비활성화 |
67
+ | loading | `boolean` | `false` | 로딩 상태 |
68
+ | fullWidth | `boolean` | `false` | 전체 너비 |
69
+ | children | `ReactNode` | - | 버튼 내용 |
70
+ | onPress | `() => void` | - | 클릭 핸들러 |
71
+
72
+ ### 2.2 Input
73
+
74
+ | Prop | 타입 | 기본값 | 설명 |
75
+ |------|------|--------|------|
76
+ | type | `'text' \| 'email' \| 'password' \| 'number'` | `'text'` | 입력 타입 |
77
+ | label | `string` | - | 라벨 |
78
+ | placeholder | `string` | - | 플레이스홀더 |
79
+ | error | `string` | - | 에러 메시지 |
80
+ | disabled | `boolean` | `false` | 비활성화 |
81
+
82
+ ### 2.3 Text
83
+
84
+ | Prop | 타입 | 기본값 | 설명 |
85
+ |------|------|--------|------|
86
+ | variant | `'h1' \| 'h2' \| 'h3' \| 'body' \| 'caption'` | `'body'` | 타이포그래피 |
87
+ | color | `string` | `'text.primary'` | 색상 토큰 |
88
+ | align | `'left' \| 'center' \| 'right'` | `'left'` | 정렬 |
89
+
90
+ ---
91
+
92
+ ## 3. Components
93
+
94
+ ### 3.1 Card
95
+
96
+ | Prop | 타입 | 기본값 | 설명 |
97
+ |------|------|--------|------|
98
+ | variant | `'elevated' \| 'outlined' \| 'filled'` | `'elevated'` | 스타일 |
99
+ | padding | `'none' \| 'sm' \| 'md' \| 'lg'` | `'md'` | 내부 여백 |
100
+ | onPress | `() => void` | - | 클릭 가능 여부 |
101
+ | children | `ReactNode` | - | 카드 내용 |
102
+
103
+ ### 3.2 Modal
104
+
105
+ | Prop | 타입 | 기본값 | 설명 |
106
+ |------|------|--------|------|
107
+ | open | `boolean` | `false` | 표시 여부 |
108
+ | onClose | `() => void` | - | 닫기 핸들러 |
109
+ | title | `string` | - | 제목 |
110
+ | size | `'sm' \| 'md' \| 'lg' \| 'full'` | `'md'` | 크기 |
111
+ | closeOnOverlay | `boolean` | `true` | 오버레이 클릭 닫기 |
112
+
113
+ ### 3.3 Toast
114
+
115
+ | Prop | 타입 | 기본값 | 설명 |
116
+ |------|------|--------|------|
117
+ | type | `'success' \| 'error' \| 'warning' \| 'info'` | `'info'` | 토스트 타입 |
118
+ | message | `string` | - | 메시지 |
119
+ | duration | `number` | `3000` | 표시 시간 (ms) |
120
+ | action | `{ label: string; onPress: () => void }` | - | 액션 버튼 |
121
+
122
+ ---
123
+
124
+ ## 4. 재사용 정책
125
+
126
+ ### 4.1 규칙
127
+
128
+ | 규칙 | 설명 |
129
+ |-----|------|
130
+ | 단방향 의존 | 상위 계층만 하위 계층을 import |
131
+ | Props 전용 통신 | 컴포넌트 간 데이터는 Props로만 전달 |
132
+ | 비즈니스 로직 분리 | Primitives/Components에 비즈니스 로직 금지 |
133
+ | 스타일 토큰 사용 | 하드코딩 색상/크기 금지, 디자인 토큰만 사용 |
134
+
135
+ ### 4.2 신규 컴포넌트 기준
136
+
137
+ | 기준 | 임계값 |
138
+ |-----|--------|
139
+ | 재사용 횟수 | 3회 이상 사용 시 컴포넌트화 |
140
+ | Props 수 | 10개 초과 시 분리 검토 |
141
+ | 중첩 깊이 | 3단계 초과 시 Composite로 승격 |
142
+
143
+ ---
144
+
145
+ ## 5. 디자인 토큰
146
+
147
+ ### 5.1 색상
148
+
149
+ | 토큰 | Light | Dark | 용도 |
150
+ |-----|-------|------|------|
151
+ | `colors.primary` | #3B82F6 | #60A5FA | 주요 액션 |
152
+ | `colors.secondary` | #6B7280 | #9CA3AF | 보조 액션 |
153
+ | `colors.danger` | #EF4444 | #F87171 | 위험/삭제 |
154
+ | `colors.text.primary` | #111827 | #F9FAFB | 본문 텍스트 |
155
+ | `colors.bg.primary` | #FFFFFF | #111827 | 배경 |
156
+
157
+ ### 5.2 간격
158
+
159
+ | 토큰 | 값 | 용도 |
160
+ |-----|-----|------|
161
+ | `spacing.xs` | 4px | 아이콘 간격 |
162
+ | `spacing.sm` | 8px | 요소 내부 |
163
+ | `spacing.md` | 16px | 섹션 내부 |
164
+ | `spacing.lg` | 24px | 섹션 간 |
165
+ | `spacing.xl` | 32px | 페이지 여백 |
166
+
167
+ ---
168
+
169
+ ## 6. 관련 문서
170
+
171
+ - [UI/UX 명세](./ui-ux-spec.md) — 화면 디자인 상세
172
+ - [네비게이션 맵](./navigation-map.md) — 화면 구조
173
+ - [성능 예산](./performance-budget.md) — 번들 크기 제약
174
+
175
+ ---
176
+
177
+ ## 변경 이력
178
+
179
+ | 버전 | 날짜 | 작성자 | 변경 내용 |
180
+ |------|------|--------|----------|
181
+ | 1.0.0 | {{DATE}} | tsq-designer | 초기 작성 |
@@ -1,7 +1,7 @@
1
- # {PROJECT_NAME} 데이터 설계서
1
+ # {{PROJECT_NAME}} 데이터 설계서
2
2
 
3
3
  **Version**: 1.0
4
- **Created**: {DATE}
4
+ **Created**: {{DATE}}
5
5
  **Database**: PostgreSQL / MySQL / MongoDB
6
6
 
7
7
  ---
@@ -104,7 +104,7 @@ VALUES ('admin@example.com', 'Admin', '$2b$...', 'active');
104
104
 
105
105
  | Version | Date | Description |
106
106
  |---------|------|-------------|
107
- | 001 | {DATE} | 초기 스키마 생성 |
107
+ | 001 | {{DATE}} | 초기 스키마 생성 |
108
108
 
109
109
  ---
110
110
 
@@ -129,4 +129,4 @@ VALUES ('admin@example.com', 'Admin', '$2b$...', 'active');
129
129
 
130
130
  | 버전 | 날짜 | 변경 내용 | 작성자 |
131
131
  |-----|-----|----------|-------|
132
- | 1.0 | {DATE} | 최초 작성 | |
132
+ | 1.0 | {{DATE}} | 최초 작성 | |
@@ -2,7 +2,7 @@
2
2
  title: "배포 명세서 (Deployment Specification)"
3
3
  version: 1.0.0
4
4
  last_updated: {{DATE}}
5
- author: tsq-planner
5
+ author: tsq-architect
6
6
  status: draft
7
7
  project: {{PROJECT_NAME}}
8
8
  required_level: 3
@@ -21,13 +21,11 @@ required_level: 3
21
21
 
22
22
  ```
23
23
  ┌─────────────┐
24
- CDN
25
- │ (CloudFront)│
24
+ CDN
26
25
  └──────┬──────┘
27
26
 
28
27
  ┌──────▼──────┐
29
28
  │ Load Balancer│
30
- │ (ALB) │
31
29
  └──────┬──────┘
32
30
 
33
31
  ┌─────────────────┼─────────────────┐
@@ -42,9 +40,10 @@ required_level: 3
42
40
  ┌────────────┼────────────┐
43
41
  │ │ │
44
42
  ┌────▼────┐ ┌───▼────┐ ┌───▼────┐
45
- DB │ │ Redis │ │ S3
46
- │ (RDS) │ │(Cache) │ │(Storage)│
43
+ DB │ │ Cache │ │Storage
47
44
  └─────────┘ └────────┘ └────────┘
45
+
46
+ > 클라우드 예시: AWS (CloudFront, ALB, ECS, RDS), GCP (Cloud CDN, Cloud Run, Cloud SQL), Azure (Front Door, App Service, Azure DB)
48
47
  ```
49
48
 
50
49
  ### 1.2 환경 구성
@@ -63,34 +62,38 @@ required_level: 3
63
62
 
64
63
  | 리소스 | 서비스 | 사양 | 환경별 수량 |
65
64
  |-------|-------|------|-----------|
66
- | 애플리케이션 | ECS Fargate | 0.5 vCPU, 1GB | Dev:1, Stg:2, Prod:3+ |
67
- | 배치 작업 | Lambda | 256MB | 필요 시 |
65
+ | 애플리케이션 | 컨테이너 서비스 | 0.5 vCPU, 1GB | Dev:1, Stg:2, Prod:3+ |
66
+ | 배치 작업 | 서버리스 함수 | 256MB | 필요 시 |
67
+
68
+ > 클라우드별: AWS(ECS Fargate, Lambda), GCP(Cloud Run, Cloud Functions), Azure(Container Apps, Azure Functions)
68
69
 
69
70
  ### 2.2 데이터베이스
70
71
 
71
72
  | 리소스 | 서비스 | 사양 | 백업 |
72
73
  |-------|-------|------|------|
73
- | Primary DB | RDS PostgreSQL | db.t3.medium | 7일 |
74
- | Read Replica | RDS (Prod만) | db.t3.medium | - |
75
- | Cache | ElastiCache Redis | cache.t3.micro | - |
74
+ | Primary DB | Managed PostgreSQL | Medium | 7일 |
75
+ | Read Replica | (Prod만) | Medium | - |
76
+ | Cache | Managed Redis | Small | - |
77
+
78
+ > 클라우드별: AWS(RDS, ElastiCache), GCP(Cloud SQL, Memorystore), Azure(Azure DB, Azure Cache)
76
79
 
77
80
  ### 2.3 스토리지
78
81
 
79
82
  | 리소스 | 서비스 | 용도 |
80
83
  |-------|-------|------|
81
- | 정적 파일 | S3 | 이미지, 파일 업로드 |
82
- | 로그 | S3 + CloudWatch | 애플리케이션 로그 |
83
- | 백업 | S3 Glacier | DB 백업 장기 보관 |
84
+ | 정적 파일 | 오브젝트 스토리지 | 이미지, 파일 업로드 |
85
+ | 로그 | 오브젝트 스토리지 + 로그 서비스 | 애플리케이션 로그 |
86
+ | 백업 | 아카이브 스토리지 | DB 백업 장기 보관 |
84
87
 
85
88
  ### 2.4 네트워크
86
89
 
87
- | 리소스 | 서비스 | 설정 |
88
- |-------|-------|------|
89
- | VPC | VPC | 10.0.0.0/16 |
90
- | Public Subnet | 2개 AZ | 10.0.1.0/24, 10.0.2.0/24 |
91
- | Private Subnet | 2개 AZ | 10.0.10.0/24, 10.0.20.0/24 |
92
- | NAT Gateway | 각 AZ | 아웃바운드 트래픽 |
93
- | Security Group | 서비스별 | 최소 권한 |
90
+ | 리소스 | 설정 |
91
+ |-------|------|
92
+ | VPC/VNet | 10.0.0.0/16 |
93
+ | Public Subnet | 2개 AZ, 10.0.1.0/24, 10.0.2.0/24 |
94
+ | Private Subnet | 2개 AZ, 10.0.10.0/24, 10.0.20.0/24 |
95
+ | NAT Gateway | 아웃바운드 트래픽 |
96
+ | Security Group | 서비스별 최소 권한 |
94
97
 
95
98
  ---
96
99
 
@@ -137,6 +140,7 @@ jobs:
137
140
  docker push $IMAGE_NAME
138
141
 
139
142
  test:
143
+ runs-on: ubuntu-latest
140
144
  needs: build
141
145
  steps:
142
146
  - name: Unit Tests
@@ -149,6 +153,7 @@ jobs:
149
153
  run: npm audit
150
154
 
151
155
  deploy-staging:
156
+ runs-on: ubuntu-latest
152
157
  needs: test
153
158
  if: github.ref == 'refs/heads/develop'
154
159
  steps:
@@ -156,6 +161,7 @@ jobs:
156
161
  run: ./deploy.sh staging
157
162
 
158
163
  deploy-production:
164
+ runs-on: ubuntu-latest
159
165
  needs: test
160
166
  if: github.ref == 'refs/heads/main'
161
167
  environment: production # 승인 필요
@@ -164,6 +170,7 @@ jobs:
164
170
  run: ./deploy.sh production
165
171
 
166
172
  verify:
173
+ runs-on: ubuntu-latest
167
174
  needs: [deploy-staging, deploy-production]
168
175
  steps:
169
176
  - name: Smoke Test
@@ -381,4 +388,4 @@ CMD ["node", "dist/main.js"]
381
388
 
382
389
  | 버전 | 날짜 | 작성자 | 변경 내용 |
383
390
  |------|------|--------|----------|
384
- | 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |
391
+ | 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
@@ -2,7 +2,7 @@
2
2
  title: "환경 설정 (Environment Configuration)"
3
3
  version: 1.0.0
4
4
  last_updated: {{DATE}}
5
- author: tsq-planner
5
+ author: tsq-architect
6
6
  status: draft
7
7
  project: {{PROJECT_NAME}}
8
8
  ---
@@ -118,6 +118,8 @@ DATABASE_URL=postgresql://postgres:postgres@localhost:5432/{{PROJECT_NAME}}_dev
118
118
  REDIS_URL=redis://localhost:6379
119
119
 
120
120
  # Auth
121
+ # ⚠️ 아래는 로컬 개발 전용. 절대 프로덕션에서 사용 금지.
122
+ # 프로덕션은 반드시 시크릿 매니저(Vault, AWS Secrets Manager 등)에서 주입.
121
123
  JWT_SECRET=local-dev-secret-change-in-production
122
124
  JWT_EXPIRES_IN=1d
123
125
  SESSION_SECRET=local-session-secret
@@ -343,4 +345,4 @@ if (await featureService.isEnabled('NEW_UI', userId)) {
343
345
 
344
346
  | 버전 | 날짜 | 작성자 | 변경 내용 |
345
347
  |------|------|--------|----------|
346
- | 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |
348
+ | 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
@@ -1,7 +1,7 @@
1
- # {PROJECT_NAME} 에러 코드
1
+ # {{PROJECT_NAME}} 에러 코드
2
2
 
3
3
  **Version**: 1.0
4
- **Created**: {DATE}
4
+ **Created**: {{DATE}}
5
5
 
6
6
  ---
7
7
 
@@ -111,4 +111,4 @@
111
111
 
112
112
  | 버전 | 날짜 | 변경 내용 | 작성자 |
113
113
  |-----|-----|----------|-------|
114
- | 1.0 | {DATE} | 최초 작성 | |
114
+ | 1.0 | {{DATE}} | 최초 작성 | |
@@ -2,7 +2,7 @@
2
2
  title: "기능 명세서 (Functional Specification)"
3
3
  version: 1.0.0
4
4
  last_updated: {{DATE}}
5
- author: tsq-planner
5
+ author: tsq-architect
6
6
  status: draft
7
7
  project: {{PROJECT_NAME}}
8
8
  ---
@@ -130,7 +130,44 @@ Feature: [기능명]
130
130
 
131
131
  ### FS-002: [기능명]
132
132
 
133
- (위와 동일한 형식으로 작성)
133
+ #### 3.2.1 개요
134
+
135
+ | 항목 | 내용 |
136
+ |-----|------|
137
+ | **ID** | FS-002 |
138
+ | **기능명** | |
139
+ | **우선순위** | P0 / P1 / P2 |
140
+ | **관련 PRD** | [prd/xxx](./prd/xxx.md) |
141
+ | **관련 요건** | FR-XXX-001 |
142
+ | **관련 화면** | [SCR-002](./ui-ux-spec.md#SCR-002) |
143
+ | **관련 API** | [service-spec](./service-spec.md) |
144
+
145
+ #### 3.2.2 사전 조건 (Preconditions)
146
+ -
147
+
148
+ #### 3.2.3 주요 흐름 (Main Flow)
149
+
150
+ | 단계 | Actor | Action | System Response |
151
+ |:----:|-------|--------|----------------|
152
+ | 1 | | | |
153
+ | 2 | | | |
154
+
155
+ #### 3.2.4 대안 흐름 / 예외 흐름
156
+ -
157
+
158
+ #### 3.2.5 사후 조건 (Postconditions)
159
+ - [ ]
160
+
161
+ #### 3.2.6 수용 조건 (Acceptance Criteria)
162
+
163
+ ```gherkin
164
+ Feature: [기능명]
165
+
166
+ Scenario: [시나리오명]
167
+ Given [사전 조건]
168
+ When [행동]
169
+ Then [기대 결과]
170
+ ```
134
171
 
135
172
  ---
136
173
 
@@ -182,4 +219,4 @@ graph LR
182
219
 
183
220
  | 버전 | 날짜 | 작성자 | 변경 내용 |
184
221
  |------|------|--------|----------|
185
- | 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |
222
+ | 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
@@ -2,7 +2,7 @@
2
2
  title: "용어 사전 (Glossary)"
3
3
  version: 1.0.0
4
4
  last_updated: {{DATE}}
5
- author: tsq-planner
5
+ author: tsq-architect
6
6
  status: draft
7
7
  project: {{PROJECT_NAME}}
8
8
  ---
@@ -145,4 +145,4 @@ project: {{PROJECT_NAME}}
145
145
 
146
146
  | 버전 | 날짜 | 작성자 | 변경 내용 |
147
147
  |------|------|--------|----------|
148
- | 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |
148
+ | 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
@@ -0,0 +1,191 @@
1
+ ---
2
+ title: "인프라 토폴로지 (Infrastructure Topology)"
3
+ version: 1.0.0
4
+ last_updated: {{DATE}}
5
+ author: tsq-architect
6
+ status: draft
7
+ project: {{PROJECT_NAME}}
8
+ ---
9
+
10
+ # 인프라 토폴로지 (Infrastructure Topology)
11
+
12
+ > 시스템의 물리/논리적 인프라 구조, 네트워크 토폴로지, 서비스 의존성을 정의합니다.
13
+ > 인프라 프로비저닝, 장애 분석, 용량 계획의 기준 문서입니다.
14
+
15
+ ---
16
+
17
+ ## 1. 시스템 아키텍처
18
+
19
+ ### 1.1 전체 토폴로지
20
+
21
+ ```
22
+ ┌─────────────┐
23
+ │ DNS │
24
+ └──────┬──────┘
25
+
26
+ ┌──────▼──────┐
27
+ │ CDN/WAF │
28
+ └──────┬──────┘
29
+
30
+ ┌───────────▼───────────┐
31
+ │ Load Balancer │
32
+ │ (ALB) │
33
+ └───────────┬───────────┘
34
+
35
+ ┌─────────────────┼─────────────────┐
36
+ │ │ │
37
+ ┌──────▼──────┐ ┌──────▼──────┐ ┌──────▼──────┐
38
+ │ Service A │ │ Service B │ │ Service C │
39
+ │ (Container) │ │ (Container) │ │ (Container) │
40
+ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘
41
+ │ │ │
42
+ └─────────────────┼─────────────────┘
43
+
44
+ ┌─────────────────┼─────────────────┐
45
+ │ │ │
46
+ ┌──────▼──────┐ ┌──────▼──────┐ ┌──────▼──────┐
47
+ │ Database │ │ Cache │ │ Storage │
48
+ │ │ │ (Redis) │ │ │
49
+ └─────────────┘ └─────────────┘ └─────────────┘
50
+ ```
51
+
52
+ ---
53
+
54
+ ## 2. 네트워크 구성
55
+
56
+ ### 2.1 VPC 설계
57
+
58
+ | 항목 | 설정 | 비고 |
59
+ |-----|------|------|
60
+ | VPC CIDR | 10.0.0.0/16 | 65,534 호스트 |
61
+ | 리전 | (프로젝트 대상 리전) | |
62
+ | AZ | 2개 (a, c) | 고가용성 |
63
+
64
+ ### 2.2 서브넷
65
+
66
+ | 서브넷 | CIDR | AZ | 접근 | 용도 |
67
+ |-------|------|:--:|------|------|
68
+ | public-a | 10.0.1.0/24 | a | 인터넷 | ALB, NAT |
69
+ | public-c | 10.0.2.0/24 | c | 인터넷 | ALB, NAT |
70
+ | private-app-a | 10.0.10.0/24 | a | NAT | 앱 서비스 |
71
+ | private-app-c | 10.0.20.0/24 | c | NAT | 앱 서비스 |
72
+ | private-data-a | 10.0.100.0/24 | a | 내부만 | DB, Cache |
73
+ | private-data-c | 10.0.200.0/24 | c | 내부만 | DB, Cache |
74
+
75
+ ### 2.3 Security Groups
76
+
77
+ | SG | 인바운드 | 소스 | 용도 |
78
+ |---|---------|------|------|
79
+ | sg-alb | 80, 443 | 0.0.0.0/0 | 로드밸런서 |
80
+ | sg-app | 3000 | sg-alb | 앱 서비스 |
81
+ | sg-db | 5432 | sg-app | PostgreSQL |
82
+ | sg-cache | 6379 | sg-app | Redis |
83
+
84
+ ---
85
+
86
+ ## 3. 서비스 구성
87
+
88
+ ### 3.1 서비스 목록
89
+
90
+ | 서비스 | 타입 | 포트 | 인스턴스 (Prod) | 의존성 |
91
+ |-------|------|:----:|:-----------:|--------|
92
+ | API Server | 컨테이너 | 3000 | 2-10 | DB, Cache, Storage |
93
+ | Worker | 컨테이너 | - | 1-3 | DB, Queue |
94
+ | Scheduler | 서버리스 함수 | - | 1 | DB |
95
+
96
+ ### 3.2 서비스 의존성
97
+
98
+ ```
99
+ API Server ──► Database
100
+ ──► Cache
101
+ ──► Storage
102
+ ──► Worker (Queue)
103
+ ──► External API
104
+
105
+ Worker ──► Database
106
+ ──► Queue
107
+ ──► Notification
108
+
109
+ Scheduler ──► Database
110
+ ──► Worker (Queue)
111
+ ```
112
+
113
+ ### 3.3 외부 의존성
114
+
115
+ | 서비스 | 용도 | SLA | 장애 시 대응 |
116
+ |-------|------|:---:|-----------|
117
+ | 결제 PG | 결제 처리 | 99.9% | 재시도 + 큐잉 |
118
+ | SMS | 본인인증 | 99.5% | 대체 수단 (Email) |
119
+ | CDN | 정적 파일 | 99.99% | 오리진 폴백 |
120
+
121
+ ---
122
+
123
+ ## 4. 데이터 흐름
124
+
125
+ ### 4.1 주요 데이터 흐름
126
+
127
+ | 흐름 | 경로 | 프로토콜 | 암호화 |
128
+ |-----|------|---------|:------:|
129
+ | 클라이언트 → API | CDN → ALB → App | HTTPS | ✅ |
130
+ | App → DB | Private subnet | TCP/5432 | ✅ (TLS) |
131
+ | App → Cache | Private subnet | TCP/6379 | ✅ (TLS) |
132
+ | App → S3 | VPC Endpoint | HTTPS | ✅ |
133
+ | App → External | NAT Gateway | HTTPS | ✅ |
134
+
135
+ ---
136
+
137
+ ## 5. 환경별 차이
138
+
139
+ | 항목 | Development | Staging | Production |
140
+ |-----|------------|---------|-----------|
141
+ | AZ | 1 | 2 | 2 |
142
+ | App 인스턴스 | 1 | 2 | 2-10 (Auto) |
143
+ | DB | db.t3.micro | db.t3.small | db.r6g.large |
144
+ | DB Multi-AZ | ❌ | ❌ | ✅ |
145
+ | Redis | ❌ | cache.t3.micro | cache.r6g.large |
146
+ | Redis 클러스터 | ❌ | ❌ | ✅ |
147
+ | WAF | ❌ | ❌ | ✅ |
148
+ | 백업 | ❌ | 일간 | 시간별 |
149
+
150
+ ---
151
+
152
+ ## 6. IaC (Infrastructure as Code)
153
+
154
+ ### 6.1 도구
155
+
156
+ | 도구 | 용도 | 경로 |
157
+ |-----|------|------|
158
+ | Terraform | 인프라 프로비저닝 | `infra/terraform/` |
159
+ | Docker Compose | 로컬 개발 | `docker-compose.yml` |
160
+
161
+ ### 6.2 모듈 구조
162
+
163
+ ```
164
+ infra/terraform/
165
+ ├── modules/
166
+ │ ├── networking/ # VPC, Subnet, SG
167
+ │ ├── compute/ # ECS, Lambda
168
+ │ ├── database/ # RDS, ElastiCache
169
+ │ └── storage/ # S3, CloudFront
170
+ ├── environments/
171
+ │ ├── dev/
172
+ │ ├── staging/
173
+ │ └── production/
174
+ └── global/ # IAM, Route53
175
+ ```
176
+
177
+ ---
178
+
179
+ ## 7. 관련 문서
180
+
181
+ - [배포 명세](./deployment-spec.md) — CI/CD, 컨테이너 설정
182
+ - [모니터링 명세](./monitoring-spec.md) — 인프라 메트릭
183
+ - [보안 명세](./security-spec.md) — 네트워크 보안
184
+
185
+ ---
186
+
187
+ ## 변경 이력
188
+
189
+ | 버전 | 날짜 | 작성자 | 변경 내용 |
190
+ |------|------|--------|----------|
191
+ | 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
@@ -2,7 +2,7 @@
2
2
  title: "외부 연동 명세서 (Integration Specification)"
3
3
  version: 1.0.0
4
4
  last_updated: {{DATE}}
5
- author: tsq-planner
5
+ author: tsq-architect
6
6
  status: draft
7
7
  project: {{PROJECT_NAME}}
8
8
  required_level: 3
@@ -388,4 +388,4 @@ const retryConfig = {
388
388
 
389
389
  | 버전 | 날짜 | 작성자 | 변경 내용 |
390
390
  |------|------|--------|----------|
391
- | 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |
391
+ | 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |