kortext 3.0.0 → 3.1.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 (373) hide show
  1. package/README.md +159 -139
  2. package/agents/architect.md +85 -0
  3. package/agents/compliance-expert.md +36 -75
  4. package/agents/copywriter.md +36 -92
  5. package/agents/db-admin.md +43 -91
  6. package/agents/designer.md +40 -77
  7. package/agents/devops-engineer.md +37 -113
  8. package/agents/growth-expert.md +45 -88
  9. package/agents/product-manager.md +38 -83
  10. package/agents/qa-engineer.md +51 -99
  11. package/agents/security-engineer.md +47 -92
  12. package/bin/kortext.js +1 -22
  13. package/dist/app.js +829 -0
  14. package/dist/cli-spawn.js +137 -0
  15. package/dist/daemon.js +40 -0
  16. package/dist/db.js +78 -0
  17. package/dist/design-preview.js +533 -0
  18. package/dist/docs.js +701 -0
  19. package/dist/engines.js +225 -0
  20. package/dist/index.js +109 -0
  21. package/dist/pick-directory.js +38 -0
  22. package/dist/projects.js +189 -0
  23. package/dist/readiness.js +288 -0
  24. package/dist/runner.js +771 -0
  25. package/dist/update.js +55 -0
  26. package/docs/CHANGELOG.md +11 -0
  27. package/package.json +25 -57
  28. package/templates/AGENTS.md +62 -0
  29. package/templates/docs/API.md +67 -0
  30. package/templates/docs/ARCHITECTURE.md +31 -0
  31. package/templates/docs/BRIEF.md +27 -0
  32. package/templates/docs/CONTENT.md +66 -0
  33. package/templates/docs/DATABASE.md +63 -0
  34. package/templates/docs/DESIGN.md +124 -0
  35. package/templates/docs/ENGINEERING.md +66 -0
  36. package/templates/docs/ENVIRONMENT.md +102 -0
  37. package/templates/docs/GROWTH.md +44 -0
  38. package/templates/docs/LEGAL.md +48 -0
  39. package/templates/docs/PRODUCT.md +43 -0
  40. package/templates/docs/SECURITY.md +65 -0
  41. package/templates/docs/STACK.md +57 -0
  42. package/templates/docs/STRUCTURE.md +73 -0
  43. package/templates/docs/TEST.md +62 -0
  44. package/ui/dist/assets/abnfDiagram-VCTEODGH-Bm7Q2BML.js +1 -0
  45. package/ui/dist/assets/arc-BV9hs0Hu.js +1 -0
  46. package/ui/dist/assets/architecture-7GRP2DOG-RckR3gBI.js +1 -0
  47. package/ui/dist/assets/architectureDiagram-5GKGNRK7-CHiJ6JFT.js +36 -0
  48. package/ui/dist/assets/array-BifhSqXX.js +1 -0
  49. package/ui/dist/assets/blockDiagram-I7D4REHJ-qCbaKVhd.js +129 -0
  50. package/ui/dist/assets/c4Diagram-7LVT6UL2-DidCDJrv.js +38 -0
  51. package/ui/dist/assets/channel-CNUQ11ne.js +1 -0
  52. package/ui/dist/assets/chunk-2Q5K7J3B-C1jixKkw.js +1 -0
  53. package/ui/dist/assets/chunk-4HAMMTFA-CDGFjfVp.js +62 -0
  54. package/ui/dist/assets/chunk-5VM5RSS4-ZNzvKenW.js +15 -0
  55. package/ui/dist/assets/chunk-75Z2AOVW-CbNT4sDh.js +2 -0
  56. package/ui/dist/assets/chunk-DU6HZSFF-Cq2BVv26.js +127 -0
  57. package/ui/dist/assets/chunk-F27PBJKO-CE365m0v.js +1 -0
  58. package/ui/dist/assets/chunk-FOHPRMQF-DHwB1DNv.js +161 -0
  59. package/ui/dist/assets/chunk-GMAD6QVW-DxWL1VC-.js +72 -0
  60. package/ui/dist/assets/chunk-GVQU2GXP-aARV8YbK.js +1 -0
  61. package/ui/dist/assets/chunk-IMKFNOWR-CC790Kt2.js +231 -0
  62. package/ui/dist/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
  63. package/ui/dist/assets/chunk-L3NEJ4N5-BfE4VE8J.js +1 -0
  64. package/ui/dist/assets/chunk-OSK3NFVY-BImQbSWH.js +10 -0
  65. package/ui/dist/assets/chunk-P2QGCYS3-CN3XD313.js +1 -0
  66. package/ui/dist/assets/chunk-POPQ4Y6H-Dqb6jOrX.js +1 -0
  67. package/ui/dist/assets/chunk-PWAF6VOD-DfXX6rBk.js +1 -0
  68. package/ui/dist/assets/chunk-SHT3W25Y-DATyyqPK.js +168 -0
  69. package/ui/dist/assets/chunk-SVP7TREG-r1chwRmg.js +88 -0
  70. package/ui/dist/assets/chunk-TICWLB2K-DL4atHUC.js +206 -0
  71. package/ui/dist/assets/chunk-XXDRQBXY-DXrM6jh7.js +1 -0
  72. package/ui/dist/assets/chunk-Y2CYZVJY-DsF7k-Jl.js +1 -0
  73. package/ui/dist/assets/classDiagram-ZZMXUADV-BpQxfIQ7.js +1 -0
  74. package/ui/dist/assets/classDiagram-v2-VYDZK3BY-BpQxfIQ7.js +1 -0
  75. package/ui/dist/assets/cose-bilkent-JH36ORCC-Bhe-ZBlS.js +1 -0
  76. package/ui/dist/assets/cynefin-OW5HDTMX-D1koLd-G.js +1 -0
  77. package/ui/dist/assets/cynefinDiagram-5FMLGOSQ-BMcw40hV.js +62 -0
  78. package/ui/dist/assets/cytoscape.esm-CGd-uY3x.js +321 -0
  79. package/ui/dist/assets/dagre-GXQ25YYZ-DBun-Rs2.js +4 -0
  80. package/ui/dist/assets/dagre-PrKaheQc.js +1 -0
  81. package/ui/dist/assets/defaultLocale-BFoDCU3G.js +1 -0
  82. package/ui/dist/assets/diagram-S7CK7UJ4-C1fUIGvo.js +30 -0
  83. package/ui/dist/assets/diagram-UQ7AKVKN-B5FDfkvB.js +41 -0
  84. package/ui/dist/assets/diagram-VSXAHHWV-CCIpOCNC.js +3 -0
  85. package/ui/dist/assets/diagram-VX7I27RA-DV0q2xo_.js +24 -0
  86. package/ui/dist/assets/diagram-Z3DM3KII-B3LCdNgI.js +24 -0
  87. package/ui/dist/assets/dist-EcW76Zvr.js +1 -0
  88. package/ui/dist/assets/ebnfDiagram-PWID7BFC-De_oRbYe.js +1 -0
  89. package/ui/dist/assets/erDiagram-RLTQ6QDP-B9NikMr1.js +99 -0
  90. package/ui/dist/assets/eventmodeling-NTZA5JFV-DZ4t581k.js +1 -0
  91. package/ui/dist/assets/flowDiagram-HODETNUW-DuTOJp1C.js +1 -0
  92. package/ui/dist/assets/ganttDiagram-EL5Y4UJY-BVTqqlPw.js +292 -0
  93. package/ui/dist/assets/gitGraph-4MIJSDKK-xRFaEJdZ.js +1 -0
  94. package/ui/dist/assets/gitGraphDiagram-WWUBYQGX-CK5_GCmX.js +106 -0
  95. package/ui/dist/assets/graphlib-DS17s2tU.js +1 -0
  96. package/ui/dist/assets/index-CjkpNftW.js +46 -0
  97. package/ui/dist/assets/index-DVIDTWin.css +1 -0
  98. package/ui/dist/assets/info-A6RAGUB7-Dg7z-CTI.js +1 -0
  99. package/ui/dist/assets/infoDiagram-27XIBGKW-YaqsOXh0.js +2 -0
  100. package/ui/dist/assets/init-C-OQMol4.js +1 -0
  101. package/ui/dist/assets/ishikawaDiagram-5VMMS53U-C-wtxZPa.js +70 -0
  102. package/ui/dist/assets/journeyDiagram-3NMN7TZE-DsXSXf16.js +139 -0
  103. package/ui/dist/assets/kanban-definition-UXKFOSKX-Ct59fuWk.js +89 -0
  104. package/ui/dist/assets/katex-CXMH3UgJ.js +257 -0
  105. package/ui/dist/assets/line-BUVw9Mhs.js +1 -0
  106. package/ui/dist/assets/linear-D8ncLO0X.js +1 -0
  107. package/ui/dist/assets/mermaid-parser.core-BDC4bG-O.js +7 -0
  108. package/ui/dist/assets/mermaid.core-DZY3WwzX.js +44 -0
  109. package/ui/dist/assets/mindmap-definition-YA3MSWOX-DtiuF6Ce.js +96 -0
  110. package/ui/dist/assets/ordinal-BDEzSJ7C.js +1 -0
  111. package/ui/dist/assets/packet-AYTQ26CC-BX2-w9rD.js +1 -0
  112. package/ui/dist/assets/path-fybaL0A-.js +1 -0
  113. package/ui/dist/assets/pegDiagram-XKGWAZYB-CotwuIHB.js +1 -0
  114. package/ui/dist/assets/pie-WAS4IAKB-Hth8ZVpm.js +1 -0
  115. package/ui/dist/assets/pieDiagram-E7YTZNPT-D9-INs8B.js +39 -0
  116. package/ui/dist/assets/quadrantDiagram-AXDQQJYC-CMtBXZGV.js +7 -0
  117. package/ui/dist/assets/radar-RG4KPBEZ-6UuwQPsw.js +1 -0
  118. package/ui/dist/assets/railroad-74A4TZTK-BF5TZgj0.js +1 -0
  119. package/ui/dist/assets/railroad-abnf-HS5TGJTU-3KYovtYT.js +1 -0
  120. package/ui/dist/assets/railroad-ebnf-LZEXJU2U-DeP4WedE.js +1 -0
  121. package/ui/dist/assets/railroad-peg-WCYAUIDC-i42N1-yk.js +1 -0
  122. package/ui/dist/assets/railroadDiagram-O6MQD6OU-BS6zkU3Z.js +1 -0
  123. package/ui/dist/assets/requirementDiagram-BXWQKSXE-J4IOB-kP.js +84 -0
  124. package/ui/dist/assets/rough.esm-Dy-Kn_BL.js +1 -0
  125. package/ui/dist/assets/sankeyDiagram-P5KCCOFB-jYTCuYzQ.js +40 -0
  126. package/ui/dist/assets/sequenceDiagram-WJ2MYXX4-Cd2r6PW-.js +162 -0
  127. package/ui/dist/assets/sizeCapture-INFHLROL-B0uUizjq.js +1 -0
  128. package/ui/dist/assets/src-7TsfZXRO.js +1 -0
  129. package/ui/dist/assets/stateDiagram-D77RDMKH-DXOdtOKe.js +1 -0
  130. package/ui/dist/assets/stateDiagram-v2-MP3YSRHH-9h7sIf3R.js +1 -0
  131. package/ui/dist/assets/swimlanes-42K2YHIH-BvJGmGs1.js +1 -0
  132. package/ui/dist/assets/swimlanesDiagram-VR7AAH4N-QA4gPi6a.js +8 -0
  133. package/ui/dist/assets/timeline-definition-24CTP7MA-CAaD6-yd.js +120 -0
  134. package/ui/dist/assets/treeView-Q6P3EWNA-4gDEXIyJ.js +1 -0
  135. package/ui/dist/assets/treemap-WGGIJYW6-CGel5TwW.js +1 -0
  136. package/ui/dist/assets/vennDiagram-4TSXK5OY-DpxsKboL.js +34 -0
  137. package/ui/dist/assets/wardley-WFR3VGLG-Ck38v5ns.js +1 -0
  138. package/ui/dist/assets/wardleyDiagram-VM6X3IG4-Ba0grrqs.js +78 -0
  139. package/ui/dist/assets/xychartDiagram-S5SC5T6Z-DH_gC96K.js +7 -0
  140. package/ui/dist/index.html +13 -0
  141. package/ui/dist/kortext-logo-dark.svg +41 -0
  142. package/ui/dist/kortext-logo.svg +41 -0
  143. package/workflows/existing-project-analysis.md +87 -0
  144. package/workflows/new-project-analysis.md +98 -0
  145. package/workflows/planning-pipeline.md +61 -0
  146. package/AGENTS.md +0 -24
  147. package/CHANGELOG.md +0 -81
  148. package/USER-GUIDE.md +0 -505
  149. package/agents/backend-developer.md +0 -132
  150. package/agents/delivery-manager.md +0 -121
  151. package/agents/engineering-manager.md +0 -208
  152. package/agents/frontend-developer.md +0 -174
  153. package/agents/operation-manager.md +0 -122
  154. package/bin/kortext.ts +0 -377
  155. package/dist/bin/kortext.js +0 -346
  156. package/dist/bin/kortext.js.map +0 -1
  157. package/dist/mcp/index.js +0 -4
  158. package/dist/mcp/index.js.map +0 -1
  159. package/dist/mcp/server.js +0 -553
  160. package/dist/mcp/server.js.map +0 -1
  161. package/dist/mcp/sse.js +0 -38
  162. package/dist/mcp/sse.js.map +0 -1
  163. package/dist/mcp/stdio.js +0 -44
  164. package/dist/mcp/stdio.js.map +0 -1
  165. package/dist/server/cli/cleanup.js +0 -73
  166. package/dist/server/cli/cleanup.js.map +0 -1
  167. package/dist/server/cli/commands.js +0 -73
  168. package/dist/server/cli/commands.js.map +0 -1
  169. package/dist/server/cli/doctor.js +0 -118
  170. package/dist/server/cli/doctor.js.map +0 -1
  171. package/dist/server/cli/executor-factory.js +0 -39
  172. package/dist/server/cli/executor-factory.js.map +0 -1
  173. package/dist/server/cli/init.js +0 -121
  174. package/dist/server/cli/init.js.map +0 -1
  175. package/dist/server/cli/logs.js +0 -28
  176. package/dist/server/cli/logs.js.map +0 -1
  177. package/dist/server/cli/serve.js +0 -72
  178. package/dist/server/cli/serve.js.map +0 -1
  179. package/dist/server/config/env.js +0 -12
  180. package/dist/server/config/env.js.map +0 -1
  181. package/dist/server/db/client.js +0 -32
  182. package/dist/server/db/client.js.map +0 -1
  183. package/dist/server/db/json.js +0 -21
  184. package/dist/server/db/json.js.map +0 -1
  185. package/dist/server/db/migrate.js +0 -70
  186. package/dist/server/db/migrate.js.map +0 -1
  187. package/dist/server/db/migrations/001_init.sql +0 -243
  188. package/dist/server/db/repositories/audit-log.js +0 -58
  189. package/dist/server/db/repositories/audit-log.js.map +0 -1
  190. package/dist/server/db/repositories/backlog.js +0 -96
  191. package/dist/server/db/repositories/backlog.js.map +0 -1
  192. package/dist/server/db/repositories/contexts.js +0 -54
  193. package/dist/server/db/repositories/contexts.js.map +0 -1
  194. package/dist/server/db/repositories/decisions.js +0 -71
  195. package/dist/server/db/repositories/decisions.js.map +0 -1
  196. package/dist/server/db/repositories/handovers.js +0 -53
  197. package/dist/server/db/repositories/handovers.js.map +0 -1
  198. package/dist/server/db/repositories/index.js +0 -30
  199. package/dist/server/db/repositories/index.js.map +0 -1
  200. package/dist/server/db/repositories/locks.js +0 -59
  201. package/dist/server/db/repositories/locks.js.map +0 -1
  202. package/dist/server/db/repositories/notifications.js +0 -63
  203. package/dist/server/db/repositories/notifications.js.map +0 -1
  204. package/dist/server/db/repositories/pending-questions.js +0 -63
  205. package/dist/server/db/repositories/pending-questions.js.map +0 -1
  206. package/dist/server/db/repositories/runs.js +0 -138
  207. package/dist/server/db/repositories/runs.js.map +0 -1
  208. package/dist/server/db/repositories/runtime-artifacts.js +0 -39
  209. package/dist/server/db/repositories/runtime-artifacts.js.map +0 -1
  210. package/dist/server/db/repositories/secrets.js +0 -65
  211. package/dist/server/db/repositories/secrets.js.map +0 -1
  212. package/dist/server/db/repositories/sessions.js +0 -48
  213. package/dist/server/db/repositories/sessions.js.map +0 -1
  214. package/dist/server/db/schemas.js +0 -308
  215. package/dist/server/db/schemas.js.map +0 -1
  216. package/dist/server/engine/consistency.js +0 -25
  217. package/dist/server/engine/consistency.js.map +0 -1
  218. package/dist/server/engine/dag.js +0 -86
  219. package/dist/server/engine/dag.js.map +0 -1
  220. package/dist/server/engine/executor.js +0 -2
  221. package/dist/server/engine/executor.js.map +0 -1
  222. package/dist/server/engine/executors/claude-cli-executor.js +0 -83
  223. package/dist/server/engine/executors/claude-cli-executor.js.map +0 -1
  224. package/dist/server/engine/executors/cli-spawn.js +0 -127
  225. package/dist/server/engine/executors/cli-spawn.js.map +0 -1
  226. package/dist/server/engine/executors/codex-cli-executor.js +0 -69
  227. package/dist/server/engine/executors/codex-cli-executor.js.map +0 -1
  228. package/dist/server/engine/executors/gemini-cli-executor.js +0 -69
  229. package/dist/server/engine/executors/gemini-cli-executor.js.map +0 -1
  230. package/dist/server/engine/executors/mock-executor.js +0 -52
  231. package/dist/server/engine/executors/mock-executor.js.map +0 -1
  232. package/dist/server/engine/executors/persona-routed-executor.js +0 -17
  233. package/dist/server/engine/executors/persona-routed-executor.js.map +0 -1
  234. package/dist/server/engine/gate-enforcer.js +0 -75
  235. package/dist/server/engine/gate-enforcer.js.map +0 -1
  236. package/dist/server/engine/git-commit.js +0 -42
  237. package/dist/server/engine/git-commit.js.map +0 -1
  238. package/dist/server/engine/handover.js +0 -120
  239. package/dist/server/engine/handover.js.map +0 -1
  240. package/dist/server/engine/item-lifecycle.js +0 -74
  241. package/dist/server/engine/item-lifecycle.js.map +0 -1
  242. package/dist/server/engine/persona-registry.js +0 -108
  243. package/dist/server/engine/persona-registry.js.map +0 -1
  244. package/dist/server/engine/worker-pool.js +0 -324
  245. package/dist/server/engine/worker-pool.js.map +0 -1
  246. package/dist/server/engine/workflow-loader.js +0 -55
  247. package/dist/server/engine/workflow-loader.js.map +0 -1
  248. package/dist/server/engine/workflow-parser.js +0 -158
  249. package/dist/server/engine/workflow-parser.js.map +0 -1
  250. package/dist/server/engine/worktree.js +0 -176
  251. package/dist/server/engine/worktree.js.map +0 -1
  252. package/dist/server/index.js +0 -99
  253. package/dist/server/index.js.map +0 -1
  254. package/dist/server/notifications/dispatcher.js +0 -60
  255. package/dist/server/notifications/dispatcher.js.map +0 -1
  256. package/dist/server/notifications/slack.js +0 -37
  257. package/dist/server/notifications/slack.js.map +0 -1
  258. package/dist/server/notifications/telegram.js +0 -33
  259. package/dist/server/notifications/telegram.js.map +0 -1
  260. package/dist/server/orchestrator/approval-queue.js +0 -83
  261. package/dist/server/orchestrator/approval-queue.js.map +0 -1
  262. package/dist/server/orchestrator/blueprint-watcher.js +0 -94
  263. package/dist/server/orchestrator/blueprint-watcher.js.map +0 -1
  264. package/dist/server/orchestrator/orchestrator.js +0 -283
  265. package/dist/server/orchestrator/orchestrator.js.map +0 -1
  266. package/dist/server/orchestrator/pipeline-chainer.js +0 -96
  267. package/dist/server/orchestrator/pipeline-chainer.js.map +0 -1
  268. package/dist/server/orchestrator/resume.js +0 -36
  269. package/dist/server/orchestrator/resume.js.map +0 -1
  270. package/dist/server/routes/approvals.js +0 -52
  271. package/dist/server/routes/approvals.js.map +0 -1
  272. package/dist/server/routes/backlog.js +0 -44
  273. package/dist/server/routes/backlog.js.map +0 -1
  274. package/dist/server/routes/db-info.js +0 -21
  275. package/dist/server/routes/db-info.js.map +0 -1
  276. package/dist/server/routes/docs.js +0 -70
  277. package/dist/server/routes/docs.js.map +0 -1
  278. package/dist/server/routes/doctor.js +0 -19
  279. package/dist/server/routes/doctor.js.map +0 -1
  280. package/dist/server/routes/handovers.js +0 -25
  281. package/dist/server/routes/handovers.js.map +0 -1
  282. package/dist/server/routes/health.js +0 -11
  283. package/dist/server/routes/health.js.map +0 -1
  284. package/dist/server/routes/personas.js +0 -96
  285. package/dist/server/routes/personas.js.map +0 -1
  286. package/dist/server/routes/runs.js +0 -41
  287. package/dist/server/routes/runs.js.map +0 -1
  288. package/dist/server/routes/workflows.js +0 -38
  289. package/dist/server/routes/workflows.js.map +0 -1
  290. package/dist/server/safety/harmful-output-filter.js +0 -40
  291. package/dist/server/safety/harmful-output-filter.js.map +0 -1
  292. package/dist/server/safety/secret-scanner.js +0 -169
  293. package/dist/server/safety/secret-scanner.js.map +0 -1
  294. package/dist/server/services/markdown-sync.js +0 -101
  295. package/dist/server/services/markdown-sync.js.map +0 -1
  296. package/dist/web/assets/index-B80d5ZPZ.js +0 -75
  297. package/dist/web/assets/index-B80d5ZPZ.js.map +0 -1
  298. package/dist/web/assets/index-Bge5Gzqv.css +0 -1
  299. package/dist/web/index.html +0 -13
  300. package/docs/architecture.md +0 -413
  301. package/rules/behavior.md +0 -252
  302. package/rules/branching.md +0 -82
  303. package/rules/commands.md +0 -112
  304. package/rules/emergency.md +0 -160
  305. package/rules/mcp.md +0 -47
  306. package/rules/models.md +0 -93
  307. package/scripts/copy-migrations.mjs +0 -29
  308. package/workflows/00-kortext-setup.md +0 -53
  309. package/workflows/01a-analysis-pipeline.md +0 -117
  310. package/workflows/01b-onboarding-pipeline.md +0 -110
  311. package/workflows/02-planning-pipeline.md +0 -146
  312. package/workflows/02b-spike-workflow.md +0 -120
  313. package/workflows/03-environment-setup.md +0 -99
  314. package/workflows/04-development-cycle.md +0 -203
  315. package/workflows/05-test-cycle.md +0 -123
  316. package/workflows/06-deployment-cycle.md +0 -224
  317. package/workflows/07-rollback-pipeline.md +0 -203
  318. package/workflows/08-hotfix-pipeline.md +0 -196
  319. package/workflows/09-maintenance-cycle.md +0 -133
  320. package/workspace/.locks/workspace_handover.md.lock +0 -3
  321. package/workspace/archive/.gitkeep +0 -0
  322. package/workspace/backups/.gitkeep +0 -0
  323. package/workspace/memory/backlog/.gitkeep +0 -0
  324. package/workspace/memory/backlog/BXX-[bug-name].md +0 -2
  325. package/workspace/memory/backlog/DXX-[debt-name].md +0 -2
  326. package/workspace/memory/backlog/README.md +0 -31
  327. package/workspace/memory/backlog/TXX-[task-name].md +0 -2
  328. package/workspace/memory/backlog/debt-dashboard.md +0 -3
  329. package/workspace/memory/backlog/epic-dashboard.md +0 -10
  330. package/workspace/memory/backlog/version-dashboard.md +0 -7
  331. package/workspace/memory/context/.gitkeep +0 -0
  332. package/workspace/memory/context/README.md +0 -35
  333. package/workspace/memory/context/[agent-name]-active.md +0 -2
  334. package/workspace/memory/decisions.md +0 -17
  335. package/workspace/memory/handover.md +0 -40
  336. package/workspace/memory/learned.md +0 -21
  337. package/workspace/references/access.md +0 -47
  338. package/workspace/references/api-reference.md +0 -59
  339. package/workspace/references/blueprint.md +0 -29
  340. package/workspace/references/content-strategy.md +0 -39
  341. package/workspace/references/db-schema.md +0 -51
  342. package/workspace/references/design-system.md +0 -107
  343. package/workspace/references/dictionary.md +0 -42
  344. package/workspace/references/file-system.md +0 -42
  345. package/workspace/references/growth-strategy.md +0 -46
  346. package/workspace/references/legal-strategy.md +0 -35
  347. package/workspace/references/required-skills.md +0 -11
  348. package/workspace/references/security-rules.md +0 -34
  349. package/workspace/references/tech-stack.md +0 -49
  350. package/workspace/references/test-strategy.md +0 -48
  351. package/workspace/reports/analysis-reports.md +0 -40
  352. package/workspace/reports/content-reports.md +0 -29
  353. package/workspace/reports/delivery-reports.md +0 -26
  354. package/workspace/reports/growth-reports.md +0 -9
  355. package/workspace/reports/legal-reports.md +0 -29
  356. package/workspace/reports/product-requirements.md +0 -28
  357. package/workspace/reports/release-notes.md +0 -20
  358. package/workspace/reports/security-reports.md +0 -27
  359. package/workspace/reports/status-reports.md +0 -48
  360. package/workspace/reports/tech-requirements.md +0 -30
  361. package/workspace/reports/test-reports.md +0 -61
  362. package/workspace/templates/BXX-[bug-name].md +0 -34
  363. package/workspace/templates/DXX-[debt-name].md +0 -35
  364. package/workspace/templates/EXX-[epic-name].md +0 -48
  365. package/workspace/templates/HXX-[hotfix-name].md +0 -73
  366. package/workspace/templates/SXX-[spike-name].md +0 -51
  367. package/workspace/templates/TXX-[task-name].md +0 -34
  368. package/workspace/templates/[agent-name]-active.md +0 -4
  369. package/workspace/templates/[original-name]_[YYYY-MM-DD_HHMMSS].md +0 -5
  370. package/workspace/templates/adr-XXX.md +0 -66
  371. package/workspace/templates/debt-dashboard.md +0 -10
  372. package/workspace/templates/epic-dashboard.md +0 -10
  373. package/workspace/templates/version-dashboard.md +0 -10
package/rules/models.md DELETED
@@ -1,93 +0,0 @@
1
- # Model Konfigürasyonu
2
-
3
- Bu dosya, personanın görev türüne göre hangi model profilini kullanacağını merkezi olarak tanımlar. Persona dosyalarında doğrudan model adı yazılmaz; persona dosyaları yalnızca görev kategorisini belirtir.
4
-
5
- ## Görev Kategorileri
6
-
7
- | Kategori | Kullanım Alanı | Varsayılan Profil | Fallback Profil |
8
- | :--- | :--- | :--- | :--- |
9
- | `deep-research` | Araştırma, analiz, mimari tasarım, strateji, karmaşık kod üretimi, güvenlik değerlendirmesi | `high-reasoning` | `standard-reasoning` |
10
- | `routine` | Format düzenleme, standart güncelleme, raporlama, basit denetim, düşük riskli rutin işler | `fast-reasoning` | `standard-reasoning` |
11
-
12
- ## Model Profilleri
13
-
14
- | Profil | Beklenen Özellik | Kullanım |
15
- | :--- | :--- | :--- |
16
- | `high-reasoning` | En güçlü muhakeme, uzun bağlam, karmaşık analiz | Kritik teknik kararlar ve çok adımlı üretim işleri |
17
- | `standard-reasoning` | Dengeli muhakeme ve hız | Fallback veya orta karmaşıklıktaki işler |
18
- | `fast-reasoning` | Hızlı cevap, düşük maliyet | Rutin raporlama ve basit kontrol işleri |
19
-
20
- ## Rol → Kategori Ataması
21
-
22
- | Persona | Varsayılan Kategori | Not |
23
- | :--- | :--- | :--- |
24
- | `+operation-manager` | `routine` | Orkestrasyon, durum takibi, raporlama |
25
- | `+product-manager` | `deep-research` | Ürün gereksinimi, kapsam ve önceliklendirme |
26
- | `+engineering-manager` | `deep-research` | Mimari, teknik karar, code review |
27
- | `+delivery-manager` | `routine` | Release koordinasyonu ve teslimat raporları |
28
- | `+backend-developer` | `deep-research` | Backend uygulama ve servis mantığı |
29
- | `+frontend-developer` | `deep-research` | UI uygulama ve frontend mimarisi |
30
- | `+db-admin` | `deep-research` | Veri modeli, migration, performans |
31
- | `+devops-engineer` | `routine` | CI/CD, ortam, deployment operasyonları |
32
- | `+qa-engineer` | `routine` | Test yürütme, doğrulama, raporlama |
33
- | `+security-engineer` | `deep-research` | Güvenlik analizi, risk ve zafiyet değerlendirmesi |
34
- | `+designer` | `deep-research` | Tasarım sistemi, UX/UI değerlendirmesi |
35
- | `+copywriter` | `deep-research` | İçerik stratejisi, marka dili, mikro metin |
36
- | `+growth-expert` | `deep-research` | SEO/GEO, analitik, büyüme stratejisi |
37
- | `+compliance-expert` | `deep-research` | KVKK/GDPR ve yasal değerlendirme |
38
-
39
- ## Sağlayıcı Seçimi
40
-
41
- Gerçek model ID'leri sağlayıcıya ve kurulu ortama göre değişebilir. Bu nedenle model ID'leri persona dosyalarına yazılmaz.
42
-
43
- ## Resmi Model Kaynakları
44
-
45
- Model seçimi veya model güncellemesi yapılmadan önce sağlayıcının resmi model dokümantasyonu kontrol edilir.
46
-
47
- | Sağlayıcı | Resmi Kaynak |
48
- | :--- | :--- |
49
- | Anthropic / Claude | https://docs.anthropic.com/en/docs/about-claude/models/overview |
50
- | Google / Gemini | https://ai.google.dev/gemini-api/docs/models |
51
- | OpenAI | https://developers.openai.com/api/docs/models |
52
-
53
- ## Güncellik Kuralı
54
-
55
- - +prime "en güncel", "latest" veya belirli bir sağlayıcıdaki yeni model ailesini isterse ajan resmi model dokümanını kontrol etmeden model önermemelidir.
56
- - Varsayılan tercih +prime aksi yönde belirtmedikçe en güncel uygun modeldir.
57
- - Production kullanımında model ID sabitlenmesi gerekiyorsa ilgili snapshot/stable ID `workspace/references/access.md` veya `workspace/references/tech-stack.md` içinde ayrıca belgelenir.
58
- - Bir sağlayıcının "latest" alias'ı ile sabit snapshot ID'si farklı amaçlara hizmet ediyorsa bu fark raporda açıkça belirtilir.
59
-
60
- Model seçimi yapılırken:
61
-
62
- 1. Önce görevin kategorisi belirlenir.
63
- 2. Resmi model kaynağı kontrol edilir.
64
- 3. Kategoriye karşılık gelen varsayılan profil seçilir.
65
- 4. Mevcut ortamda bu profile karşılık gelen en güncel uygun model kullanılır.
66
- 5. Model erişilemezse fallback profil kullanılır.
67
- 6. Fallback kullanımı `workspace/reports/status-reports.md` veya ilgili görev raporuna not edilir.
68
-
69
- ## Fallback Politikası
70
-
71
- - Fallback modeli aynı görevi tamamlamak için yeterliyse işlem devam eder.
72
- - Fallback kalite riski oluşturuyorsa görev `Blocked` yapılır ve +operation-manager'a eskale edilir.
73
- - `deep-research` görevlerinde fallback kullanıldıysa sonuç kalitesi özellikle belirtilir.
74
- - API/LLM kesintilerinde retry ve fallback sırası `rules/emergency.md` içindeki Self-Healing Protocol'e göre yürütülür.
75
-
76
- ## Persona Dosyalarında Kullanım
77
-
78
- Persona dosyalarının `instructions` bölümünde her görev adımında model adı yerine kategori referansı kullanılır:
79
-
80
- ```markdown
81
- ### 1. Araştırma Protokolü
82
- **Kategori:** `deep-research`
83
-
84
- ### 2. Rutin Güncelleme
85
- **Kategori:** `routine`
86
- ```
87
-
88
- ## Güncelleme Politikası
89
-
90
- - Model profili veya kategori değişikliklerinde yalnızca bu dosya güncellenir.
91
- - Gerçek sağlayıcı/model ID eşleşmeleri proje ortamına göre `workspace/references/tech-stack.md` veya `workspace/references/access.md` içinde belgelenir.
92
- - Model değişikliği önerisi +operation-manager tarafından yapılır.
93
- - Stratejik model değişikliği +prime onayı gerektirir.
@@ -1,29 +0,0 @@
1
- #!/usr/bin/env node
2
- // Post-build step: tsc doesn't copy non-TS assets. The migration runner
3
- // expects `server/db/migrations/*.sql` next to the compiled `migrate.js`,
4
- // so we mirror them into `dist/server/db/migrations/` after tsc emits.
5
-
6
- import { cpSync, mkdirSync, readdirSync, existsSync } from 'node:fs';
7
- import { dirname, join, resolve } from 'node:path';
8
- import { fileURLToPath } from 'node:url';
9
-
10
- const here = dirname(fileURLToPath(import.meta.url));
11
- const root = resolve(here, '..');
12
- const src = join(root, 'server', 'db', 'migrations');
13
- const dst = join(root, 'dist', 'server', 'db', 'migrations');
14
-
15
- if (!existsSync(src)) {
16
- console.error(`[copy-migrations] source missing: ${src}`);
17
- process.exit(1);
18
- }
19
- if (!existsSync(join(root, 'dist'))) {
20
- console.error('[copy-migrations] dist/ not found — did `tsc` run?');
21
- process.exit(1);
22
- }
23
-
24
- mkdirSync(dst, { recursive: true });
25
- const files = readdirSync(src).filter((f) => f.endsWith('.sql'));
26
- for (const f of files) {
27
- cpSync(join(src, f), join(dst, f));
28
- }
29
- console.error(`[copy-migrations] copied ${files.length} migration file(s) → ${dst}`);
@@ -1,53 +0,0 @@
1
- # Kortext Setup
2
-
3
- Bu akış Kortext'i hedef projede başlatır, sistem dosyalarını korur ve ilk çalışma kararını +prime'a bildirir.
4
-
5
- ## Girdi ve Çıkış
6
-
7
- - **Başlangıç koşulu:** Kortext dosya ağacı hedef projeye eklenmiş olmalıdır.
8
- - **Girdi:** `../workspace/references/blueprint.md`
9
- - **Çıkış:** Kilitlenmiş framework çekirdeği ve +prime için bir sonraki akış kararı.
10
- - **Sonraki akış:** Yeni proje için `01a-analysis-pipeline.md`, mevcut proje için `01b-onboarding-pipeline.md`.
11
-
12
- ## Koruma
13
-
14
- 1. Başka hiçbir işlem yapmadan önce `../scripts/lock_kortext.sh` dosyasını çalıştır.
15
- 2. Aşağıdaki Kortext sistem dosyalarını ve dizinlerini salt okunur yap:
16
- - `../AGENTS.md`
17
- - `../agents/`
18
- - `../rules/`
19
- - `../workflows/`
20
- - `../hooks/`
21
- - `../scripts/`
22
-
23
- ## Anayasanın Yüklenmesi
24
-
25
- 3. Kortext protokollerini ve davranış kurallarını içeren şu dosyaları oku:
26
- - `../rules/behavior.md`
27
- - `../rules/commands.md`
28
-
29
- ## Durum Tespiti
30
-
31
- 4. Kortext dizin yapısının doğru olup olmadığını ve güncel olup olmadığını kontrol et.
32
-
33
- > [!WARNING] BLUEPRINT KOŞULU
34
- > `../workspace/references/blueprint.md` boşsa sistem ilerlemez.
35
-
36
- 5. `../workspace/references/blueprint.md` dosyasını kontrol et.
37
- - Blueprint boşsa süreci durdur ve +prime'dan blueprint'i tamamlamasını iste.
38
- - Blueprint doluysa Kortext kurulumu tamamlanır; yeni proje analizi veya mevcut proje onboarding kararı +prime komutuyla verilir.
39
- - Yeni proje için `01a-analysis-pipeline.md` akışı kullanılır.
40
- - Mevcut projeyi Kortext'e adapte etmek için `01b-onboarding-pipeline.md` akışı kullanılır.
41
-
42
- ## Bildirim
43
-
44
- Duruma göre yalnızca ilgili bildirimi kullan.
45
-
46
- > [!NOTE] KORTEXT [DURDU/YÜKLENDİ]
47
- > +prime,
48
- > [`../workspace/references/blueprint.md` boş olduğu için kurulumu ilerletmiyorum.
49
- > Blueprint'i tamamladıktan sonra `!setup kortext` komutunu bekliyorum.]
50
- > [Kortext yüklendi ve [project-name] projesi için hazır.
51
- > Yeni projenin analizi için `!start analysis` komutunu bekliyorum.]
52
- > [Kortext yüklendi ve [project-name] projesi için hazır.
53
- > Mevcut projeyi Kortext'e adapte etmek için `!start onboard` komutunu bekliyorum.]
@@ -1,117 +0,0 @@
1
- # Analysis Pipeline (`!start analysis`)
2
-
3
- Bu akış, yeni bir projenin ürün, teknik ve kalite temelini oluşturur.
4
-
5
- ## Girdi ve Çıkış
6
-
7
- - **Başlangıç koşulu:** `../workspace/references/blueprint.md` dolu ve onaylı olmalıdır.
8
- - **Girdi:** Onaylı blueprint.
9
- - **Çıkış:** Ürün, teknik ve test referansları ile `../workspace/reports/analysis-reports.md`.
10
- - **Sonraki akış:** Onay sonrası `02-planning-pipeline.md`.
11
-
12
- > [!TIP]
13
- > - Birbirine bağımlı olmayan adımlarda (Örn: +security-engineer ve +designer) ajanlar eşzamanlı (paralel) olarak çalışır.
14
- > - Input dosyaların `status: approved` olması gerekir. Değilse, ilgili `approver`'dan dosyayı incelemesi istenir.
15
- > - Her ajan bir adıma başlamadan önce `../workspace/memory/context/[agent-name]-active.md` dosyasını oluşturur veya günceller; adım bitince sonucu `../workspace/memory/handover.md` dosyasına kaydeder ve kendi aktif görev dosyasını siler.
16
-
17
- ## Ön Hazırlıklar
18
-
19
- **+operation-manager**
20
- 1. `../workspace/memory/context/operation-manager-active.md` dosyasını oluşturur veya günceller.
21
- 2. Bu workflow'u okur ve paralel çalışabilecek ajanları belirler.
22
- 3. `../rules/models.md` dosyasını okur ve görevli her ajanın kullanacağı LLM/model eşleşmesini belirler.
23
- 4. Ajanlara görevlerini verir.
24
-
25
- ## Product Analysis
26
-
27
- 1. **+compliance-expert:** Projenin bulunduğu sektöre, hedef pazarlara ve veri işleme biçimine göre yasal gereksinimleri belirler. KVKK, GDPR, CCPA gibi regülasyonları; gizlilik, aydınlatma, rıza, saklama, silme ve üçüncü taraf veri paylaşımı açısından değerlendirir.
28
- - Inputs: `../workspace/references/blueprint.md`
29
- - Outputs: `../workspace/references/legal-strategy.md`
30
- - Approver: +prime
31
- 2. **+growth-expert:** Hedef kitleye, pazara ve ürün vaadine göre büyüme stratejisini belirler. SEO/GEO, kanal stratejisi, ölçümleme, analitik ve dönüşüm takibi için gerekli görevleri çıkarır.
32
- - Inputs: `../workspace/references/blueprint.md`
33
- - Outputs: `../workspace/references/growth-strategy.md`
34
- - Approver: +prime
35
- 3. **+product-manager:** Blueprint'i, legal ve growth çıktılarını birleştirerek ürün gereksinimlerini çıkarır. Kapsamı, kullanıcı tiplerini, ana akışları, öncelikleri, kabul kriterlerini ve kapsam dışı bırakılan işleri netleştirir.
36
- - Inputs: `../workspace/references/blueprint.md`, `../workspace/references/legal-strategy.md`, `../workspace/references/growth-strategy.md`
37
- - Outputs: `../workspace/reports/product-requirements.md`
38
- - Approver: +prime
39
-
40
- ### Ara Bildirim
41
-
42
- > [!NOTE] RAPOR HAZIR
43
- > +prime,
44
- > - `../workspace/references/legal-strategy.md`
45
- > - `../workspace/references/growth-strategy.md`
46
- > - `../workspace/reports/product-requirements.md`
47
- > raporları hazır. `!approve/reject [report-name]` komutunu bekliyorum.
48
-
49
- 4. **+copywriter:** Ürün gereksinimleri, yasal sınırlar ve büyüme stratejisine göre içerik stratejisini oluşturur. Marka dili, mesaj hiyerarşisi, sayfa içerikleri, mikro metinler ve kampanya/SEO içerik yönünü belirler.
50
- - Inputs: `../workspace/reports/product-requirements.md`, `../workspace/references/legal-strategy.md`, `../workspace/references/growth-strategy.md`
51
- - Outputs: `../workspace/references/content-strategy.md`
52
- - Approver: +prime
53
-
54
- ### Ara Bildirim
55
-
56
- > [!NOTE] RAPOR HAZIR
57
- > +prime,
58
- > `../workspace/references/content-strategy.md` raporu hazır. `!approve/reject content-strategy` komutunu bekliyorum.
59
-
60
- ## Technical Analysis
61
-
62
- 1. **+engineering-manager:** Teknoloji yığınını (stack), MCP sunucularını, geliştirme araçlarını ve +prime tarafından kurulması gereken ön gereksinimleri belirler. Bu ön gereksinimler test cihazları, emulator, API key gerektiren servis hesapları veya harici araçlar olabilir. Kodlama standartlarını ve proje klasör yapısı kurallarını yazar.
63
- - Inputs: `../workspace/references/blueprint.md`, `../workspace/reports/product-requirements.md`
64
- - Outputs: `../workspace/references/tech-stack.md`, `../workspace/references/dictionary.md`, `../workspace/references/file-system.md`
65
- - Approver: +prime
66
- 2. **+security-engineer:** Seçilen tech stack'in bilinen güvenlik risklerini ve proje verisinin hassasiyetini değerlendirir. Kimlik doğrulama, yetkilendirme, secret yönetimi, veri saklama, loglama, `.gitignore` ve güvenli geliştirme kurallarını belirler.
67
- - Inputs: `../workspace/references/tech-stack.md`
68
- - Outputs: `../workspace/references/security-rules.md`
69
- - Approver: +engineering-manager
70
- 3. **+designer:** Ürün gereksinimleri, içerik stratejisi ve teknik sınırları dikkate alarak tasarım sistemini oluşturur. Renk paleti, tipografi, bileşen ilkeleri, responsive davranış, erişilebilirlik ve temel UI kurallarını belirler.
71
- - Inputs: `../workspace/reports/product-requirements.md`, `../workspace/references/tech-stack.md`, `../workspace/references/content-strategy.md`
72
- - Outputs: `../workspace/references/design-system.md`
73
- - Reviewer: +frontend-developer
74
- - Approver: +prime
75
-
76
- ### Ara Bildirim
77
-
78
- > [!NOTE] RAPOR HAZIR
79
- > +prime,
80
- > `../workspace/references/design-system.md` raporu hazır. `!approve/reject design-system` komutunu bekliyorum.
81
-
82
- 4. **+db-admin:** Ürün gereksinimleri, güvenlik kuralları ve teknik standartlara göre veritabanı şemasını tasarlar. Tabloları, ilişkileri, indeksleri, erişim kurallarını, migration yaklaşımını ve veri bütünlüğü gereksinimlerini netleştirir.
83
- - Inputs: `../workspace/reports/product-requirements.md`, `../workspace/references/security-rules.md`, `../workspace/references/dictionary.md`, `../workspace/references/file-system.md`, `../workspace/references/tech-stack.md`
84
- - Outputs: `../workspace/references/db-schema.md`
85
- - Approver: +engineering-manager
86
- 5. **+engineering-manager:** API uçlarını ve servis sınırlarını tasarlar. Teknik standartları, endpoint listesini, istek/yanıt modellerini, hata formatlarını, yetkilendirme gereksinimlerini ve veri akışını belirler.
87
- - Inputs: `../workspace/reports/product-requirements.md`, `../workspace/references/security-rules.md`, `../workspace/references/dictionary.md`, `../workspace/references/file-system.md`, `../workspace/references/tech-stack.md`, `../workspace/references/db-schema.md`
88
- - Outputs: `../workspace/references/api-reference.md`
89
- - Reviewer: +backend-developer
90
- - Approver: +engineering-manager
91
- 6. **+engineering-manager:** Teknik analiz çıktılarını konsolide ederek teknik gereksinim raporunu oluşturur. Stack, dosya yapısı, güvenlik, veritabanı, API, tasarım sistemi ve uygulanması gereken mühendislik kararlarını tek kaynakta toplar.
92
- - Inputs: `../workspace/reports/product-requirements.md`, `../workspace/references/security-rules.md`, `../workspace/references/dictionary.md`, `../workspace/references/file-system.md`, `../workspace/references/tech-stack.md`, `../workspace/references/db-schema.md`, `../workspace/references/api-reference.md`, `../workspace/references/design-system.md`
93
- - Outputs: `../workspace/reports/tech-requirements.md`
94
- - Approver: +prime
95
- 7. **+qa-engineer:** Ürün ve teknik gereksinimlere göre test stratejisini belirler. Test türlerini, kritik kullanıcı akışlarını, otomasyon kapsamını, manuel QA ihtiyaçlarını, kabul kriterlerini ve release öncesi kalite kapılarını tanımlar.
96
- - Inputs: `../workspace/reports/product-requirements.md`, `../workspace/reports/tech-requirements.md`
97
- - Outputs: `../workspace/references/test-strategy.md`
98
- - Approver: +engineering-manager
99
-
100
- ## Konsolidasyon
101
-
102
- > [!NOTE]
103
- > - Tüm output dosyaları ilgili reviewer/approver tarafından onaylandıktan sonra konsolidasyon başlar.
104
- > - +prime'ın karar vermesi gereken açık konular `../workspace/reports/analysis-reports.md` içinde ayrı bir karar listesi olarak yazılır.
105
-
106
- 8. **+operation-manager:** Product, technical ve test çıktılarını konsolide ederek nihai analiz raporunu oluşturur. Rapor; proje kapsamını, ana kararları, onay bekleyen konuları, riskleri, bağımlılıkları ve planlama akışına aktarılacak görev başlıklarını netleştirir.
107
- - Inputs: `../workspace/reports/product-requirements.md`, `../workspace/reports/tech-requirements.md`, `../workspace/references/test-strategy.md`
108
- - Outputs: `../workspace/reports/analysis-reports.md`
109
- - Approver: +prime
110
-
111
- ## Bildirim
112
-
113
- > [!NOTE] ANALİZ TAMAMLANDI
114
- > +prime,
115
- > [project-name] analizi tamamlandı.
116
- > `../workspace/reports/analysis-reports.md` dosyası için `!approve/reject analysis-reports` komutunu bekliyorum.
117
- > Onaydan sonra planlama akışı için `!start planning` komutunu bekleyeceğim.
@@ -1,110 +0,0 @@
1
- # Onboarding Pipeline (`!start onboard`)
2
-
3
- Bu akış mevcut bir projeyi Kortext çalışma düzenine dahil eder.
4
-
5
- ## Girdi ve Çıkış
6
-
7
- - **Başlangıç koşulu:** Mevcut codebase erişilebilir olmalı ve +prime başlangıç özetini `../workspace/references/blueprint.md` içine yazmış olmalıdır.
8
- - **Girdi:** Mevcut codebase, başlangıç blueprint'i ve varsa mevcut proje dokümanları.
9
- - **Çıkış:** Mevcut sistemin referans dosyaları, teknik borç görünümü ve `../workspace/reports/analysis-reports.md`.
10
- - **Sonraki akış:** Onay sonrası `02-planning-pipeline.md`.
11
-
12
- > [!TIP]
13
- > - Birbirine bağımlı olmayan keşif adımlarında ajanlar eşzamanlı (paralel) çalışır.
14
- > - Her ajan bir adıma başlamadan önce `../workspace/memory/context/[agent-name]-active.md` dosyasını oluşturur veya günceller; adım bitince sonucu `../workspace/memory/handover.md` dosyasına kaydeder ve kendi aktif görev dosyasını siler.
15
-
16
- **Ön koşul:** +prime, `../workspace/references/blueprint.md` dosyasına yalnızca başlangıç özetini yazar:
17
- - Projenin ne olduğu ve mevcut durumu
18
- - Hangi versiyonda olduğu (örn: v2.3, beta, production)
19
- - Bilinen kritik teknik borçlar veya sorunlar
20
- - Kısa vadeli hedef (neden Kortext'e alınıyor?)
21
-
22
- Onboarding sırasında +prime'a sorulan tüm ek soruların yanıtları `../workspace/reports/analysis-reports.md` içinde toplanır. Bu yanıtlar planlama aşamasında backlog kararlarına girdi olur.
23
-
24
- ---
25
-
26
- ## 1. Teknik Keşif
27
-
28
- 1. **+engineering-manager:** Mevcut codebase'i okuyarak teknoloji yığınını, klasör yapısını, dosya organizasyonunu, bağımlılıkları, dil/framework versiyonlarını, isimlendirme kurallarını ve mimari kalıpları tespit eder. Amaç yeni standart dayatmak değil, projenin mevcut teknik gerçekliğini belgelemektir.
29
- - Inputs: Mevcut codebase, bağımlılık dosyaları, framework konfigürasyonları
30
- - Outputs: `../workspace/references/tech-stack.md`, `../workspace/references/file-system.md`, `../workspace/references/dictionary.md`
31
- - Approver: +prime
32
- 2. **+db-admin:** Mevcut migration dosyalarını, şema tanımlarını, ORM modellerini ve veritabanı bağlantı biçimini inceler. Tabloları, ilişkileri, index'leri, veri tiplerini ve veri bütünlüğü kurallarını belgeler.
33
- - Inputs: Mevcut migration/schema dosyaları, ORM modelleri, veritabanı konfigürasyonları
34
- - Outputs: `../workspace/references/db-schema.md`
35
- - Approver: +engineering-manager
36
- 3. **+security-engineer:** Mevcut güvenlik yapılandırmalarını inceler. Auth, yetkilendirme, middleware, env handling, CORS, rate limiting, secret yönetimi, loglama ve hassas veri kullanımı açısından açıkları veya eksik katmanları tespit eder.
37
- - Inputs: Mevcut codebase, `../workspace/references/tech-stack.md`
38
- - Outputs: `../workspace/references/security-rules.md`
39
- - Approver: +engineering-manager
40
- - Escalation: Kritik güvenlik bulguları +prime'a bildirilir.
41
- 4. **+devops-engineer:** Mevcut CI/CD pipeline'larını, deployment süreçlerini, ortam yapılandırmalarını, branch stratejisini, erişim sahipliğini ve secret yönetimini inceler. Kortext'in `../rules/branching.md` kurallarıyla uyumsuzlukları ve release risklerini raporlar.
42
- - Inputs: Mevcut CI/CD konfigürasyonları, deployment dosyaları, branch/release dokümantasyonu
43
- - Outputs: `../workspace/references/access.md`, `../workspace/reports/delivery-reports.md`
44
- - Approver: +delivery-manager
45
-
46
- ---
47
-
48
- ## 2. Ürün ve API Keşfi
49
-
50
- 1. **+engineering-manager:** Mevcut API endpoint'lerini, servis sınırlarını, request/response modellerini, auth mekanizmalarını ve entegrasyon noktalarını belgeler. +backend-developer teknik doğruluk açısından review yapar.
51
- - Inputs: Mevcut route/controller dosyaları, servis katmanı, varsa Swagger/Postman koleksiyonu
52
- - Outputs: `../workspace/references/api-reference.md`
53
- - Reviewer: +backend-developer
54
- - Approver: +engineering-manager
55
- 2. **+product-manager:** Mevcut özellikleri, kullanıcı akışlarını, roller/izinleri, bilinen eksiklikleri ve var olan roadmap/issue listesini inceler. Ürünün şu an ne yaptığı ile +prime'ın beklentisi arasındaki farkları görünür yapar.
56
- - Inputs: `../workspace/references/blueprint.md`, mevcut ürün dokümanları, issue tracker, roadmap, kullanıcı geri bildirimleri
57
- - Outputs: `../workspace/reports/product-requirements.md`
58
- - Approver: +prime
59
- 3. **+qa-engineer:** Mevcut test kapsamını, test tiplerini, CI test raporlarını ve eksik test alanlarını belgeler. Kritik kullanıcı akışları için mevcut kalite güvencesinin yeterli olup olmadığını değerlendirir.
60
- - Inputs: Mevcut test dosyaları, CI test raporları, `../workspace/reports/product-requirements.md`
61
- - Outputs: `../workspace/references/test-strategy.md`
62
- - Approver: +engineering-manager
63
-
64
- ---
65
-
66
- ## 3. Teknik Borç Tespiti
67
-
68
- 1. **+engineering-manager:** Keşif adımlarında tespit edilen teknik borçları, mimari sorunları, güvenlik risklerini, test açıklarını, devops/release risklerini ve iyileştirme alanlarını konsolide eder. Her borç kalemi için etki, risk, bağımlılık ve öncelik seviyesi belirler.
69
- - Inputs: Tüm keşif çıktıları
70
- - Outputs: `../workspace/reports/tech-requirements.md`
71
- - Reviewer: +security-engineer, +qa-engineer, +devops-engineer
72
- - Approver: +prime
73
-
74
- ---
75
-
76
- ## 4. Talep Toplama
77
-
78
- Konsolidasyon başlamadan önce +prime'ın beklentileri ve açık kararları sisteme alınır.
79
-
80
- 1. **+product-manager:** +prime'a planlama kararlarını etkileyecek ek soruları yöneltir. Amaç yeni rapor üretmek değil, backlog'a girecek öncelikleri ve yarım kalan işleri netleştirmektir.
81
- - Sorular:
82
- - Teknik borçlara ek olarak backlog'a alınmasını istediğin yeni özellikler var mı?
83
- - Devam eden veya yarım kalmış görevler var mı? Bunlar nasıl önceliklendirilmeli?
84
- - Kısa vadeli hedefin nedir? Örneğin belirli bir özelliği bitirmek, bir versiyonu yayınlamak veya sistemi stabilize etmek.
85
- - Outputs: +prime yanıtları `../workspace/reports/analysis-reports.md` içinde `+prime Kararları ve Planlama Girdileri` başlığı altında konsolide edilir.
86
- - Approver: +prime
87
-
88
- ### Ara Bildirim
89
-
90
- > [!NOTE] TALEPLER ALINDI
91
- > +prime,
92
- > Yanıtların `../workspace/reports/analysis-reports.md` içine `+prime Kararları ve Planlama Girdileri` başlığı altında işlendi.
93
- > Doğruysa `!approve`, düzeltmek istersen `!reject [not]` komutunu bekliyorum.
94
- ---
95
-
96
- ## 5. Konsolidasyon ve Onay
97
-
98
- 1. **+operation-manager:** Tüm keşif çıktılarını, teknik borç listesini ve +prime yanıtlarını konsolide ederek onboarding analiz raporunu oluşturur. Rapor mevcut durum özetini, referans dosyalarını, riskleri, açık kararları, teknik borçları ve planning akışına aktarılacak başlıkları netleştirir.
99
- - Inputs: Tüm keşif çıktıları, `../workspace/references/blueprint.md`, `../workspace/reports/tech-requirements.md`, +prime yanıtları
100
- - Outputs: `../workspace/reports/analysis-reports.md`
101
- - Approver: +prime
102
- ---
103
-
104
- ## Bildirim
105
-
106
- > [!NOTE] ONBOARDING TAMAMLANDI
107
- > +prime,
108
- > [project-name] projesi Kortext'e dahil edildi.
109
- > `../workspace/reports/analysis-reports.md` dosyası için `!approve/reject analysis-reports` komutunu bekliyorum.
110
- > Onaydan sonra planning akışı için `!start planning` komutunu bekleyeceğim.
@@ -1,146 +0,0 @@
1
- # Planning Pipeline (`!start planning`)
2
-
3
- Bu akış, onaylı analiz çıktılarından uygulanabilir düz backlog yapısını üretir.
4
-
5
- ## Girdi ve Çıkış
6
-
7
- - **Başlangıç koşulu:** `../workspace/reports/analysis-reports.md` onaylı olmalıdır.
8
- - **Girdi:** Analiz raporu ve bu raporda referans verilen onaylı kaynak dosyalar.
9
- - **Çıkış:** `../workspace/memory/backlog/` altında düz dashboard ve item dosyaları.
10
- - **Sonraki akış:** Ortam hazır değilse `03-environment-setup.md`, hazırsa `04-development-cycle.md`.
11
-
12
- ## Otomasyon Çağrıları
13
-
14
- > [!TIP] Bu tablo workflow adımlarının hangi script/hook'a bağlandığını gösterir. Tek-kaynak referans: `../settings/INTEGRATION-MAP.md`.
15
-
16
- | Adım | Tetikleyici Persona | Script / Hook | Beklenen Çıktı |
17
- |---|---|---|---|
18
- | Görev Belirleme (toplu) | +engineering-manager | `scripts/kortext-bulk-plan.py <plan.json>` | Toplu Task/Bug/Debt item dosyaları + dashboard satırları, otomatik git commit |
19
- | Görev Belirleme (iteratif) | +engineering-manager | `scripts/kortext-backlog-add.py --type task|bug|debt --id <id> --title "..." --epic <epic-id>` | Item dosyası + dashboard satırı, otomatik git commit |
20
- | Spike Item Açma | +engineering-manager | `scripts/kortext-backlog-add.py --type spike --id S01 --title "..."` (workflows/02b ile birlikte) | Spike item + ADR placeholder |
21
- | Kalite & Etiketleme | +qa-engineer, +security-engineer, +designer | (item dosyalarına `Review Gates` eklenir; manuel düzenleme) | Gate işaretleri |
22
- | Bağımlılık & Önceliklendirme | +engineering-manager | (item dosyalarına `Blocks` / `Blocked By` eklenir; manuel düzenleme) | İlişki haritası |
23
- | Versiyonlama | +engineering-manager | (`version-dashboard.md` güncellenir) | Version eşleme |
24
- | Görev Atama + Model Seçimi | +engineering-manager + +operation-manager | (item dosyalarına `Assignee` + `Model` eklenir) | Atama tamam |
25
- | Konsolidasyon | +operation-manager | `scripts/kortext-backlog-sync.py` | Dashboard drift = 0 |
26
- | Onay | +prime | `!approve backlog` / `!reject backlog` (manuel) | Backlog kabul kaydı |
27
-
28
- > [!TIP]
29
- > - Birbirine bağımlı olmayan adımlarda (Örn: +security-engineer ve +qa-engineer) ajanlar eşzamanlı (paralel) olarak çalışır.
30
- > - Input dosyaların `status: approved` olması gerekir. Değilse, ilgili `approver`'dan dosyayı incelemesi istenir.
31
- > - Her ajan bir adıma başlamadan önce `../workspace/memory/context/[agent-name]-active.md` dosyasını oluşturur veya günceller; adım bitince sonucu `../workspace/memory/handover.md` dosyasına kaydeder ve kendi aktif görev dosyasını siler.
32
- > - **Metodoloji:** Kanban (Sprint yok, Eforlama yok)
33
- > - **Görev Tipleri:** Epic, Task, Bug, Debt
34
- > - **Inputs:** `../workspace/reports/analysis-reports.md` ve bu raporda onaylı olarak referans verilen tüm `../workspace/references/` ve `../workspace/reports/` çıktıları.
35
- > - **Outputs:** `../workspace/memory/backlog/` altında tek seviyeli dashboard ve item dosyaları
36
-
37
- ## Görev Tipleri
38
-
39
- - **Epic:** Ortak bir iş hedefine hizmet eden görev grubu.
40
- - **Task:** Yeni geliştirme veya planlı iş.
41
- - **Bug:** Mevcut davranışın yanlış çalışması.
42
- - **Debt:** Bilinen teknik borç, refactor, mimari iyileştirme, test açığı veya operasyonel borç.
43
-
44
- ## Review Gates
45
-
46
- - **Quality control:** QA kontrolü gerektiren görevlerde kullanılır.
47
- - **Security check:** Güvenlik incelemesi gerektiren görevlerde kullanılır.
48
- - **Design review:** UI veya UX doğrulaması gerektiren görevlerde kullanılır.
49
-
50
- ## Backlog Dosya Yapısı
51
-
52
- Backlog tek seviyeli dosya yapısı kullanır. Version, Epic, Task, Bug ve Debt için ayrı klasör açılmaz.
53
-
54
- ```text
55
- ../workspace/memory/backlog/
56
- ├── version-dashboard.md
57
- ├── epic-dashboard.md
58
- ├── debt-dashboard.md
59
- ├── TXX-[task-name].md
60
- ├── BXX-[bug-name].md
61
- └── DXX-[debt-name].md
62
- ```
63
-
64
- - `version-dashboard.md`: Versiyon hedefleri, versiyon kapsamındaki Epic'ler ve genel ilerleme.
65
- - `epic-dashboard.md`: Epic listesi, Epic owner bilgisi, Epic altındaki Task/Bug ilişkileri ve Epic statüsü.
66
- - `debt-dashboard.md`: Debt listesi, assignee ve statü.
67
- - `TXX-[task-name].md`: Task detay dosyası.
68
- - `BXX-[bug-name].md`: Bug detay dosyası.
69
- - `DXX-[debt-name].md`: Debt detay dosyası.
70
-
71
- ## Görev Belirleme
72
-
73
- 1. **+engineering-manager:** Onaylı analiz çıktılarını tarayarak özellikleri, teknik gereksinimleri, açık riskleri ve +prime kararlarını backlog adaylarına dönüştürür.
74
- 2. Her işi atomik seviyeye böler. Atomik iş tek başına anlaşılabilir, bağımsız geliştirilebilir ve ayrı doğrulanabilir olmalıdır.
75
- 3. Her backlog adayı için görev tipini belirler:
76
- - **Task:** Yeni geliştirme veya planlı uygulama işi.
77
- - **Bug:** Mevcut davranışın yanlış çalışması.
78
- - **Debt:** Teknik borç, refactor, mimari iyileştirme, test açığı veya operasyonel borç.
79
- 4. Her görev için kısa açıklama, gereksinimler, beklenen çıktı ve kaynak referansını yazar.
80
- 5. İnsan müdahalesi gerektiren işler +prime'a atanır. Bu işler domain satın alma, hesap açma, API key oluşturma, fiziksel cihaz kurulumu, platform erişimi veya bütçe/onay gerektiren kararlar olabilir.
81
-
82
- ## Kalite ve Etiketleme
83
-
84
- 1. **+qa-engineer:** Tüm Task, Bug ve Debt adaylarını inceler. Her görev için davranış odaklı, test edilebilir ve madde madde yazılmış Acceptance Criteria ekler.
85
- 2. Test edilemeyecek kadar muğlak görevleri +engineering-manager'a revizyon için geri gönderir.
86
- 3. QA kontrolü gerektiren görevlere `Review Gates: Quality control` ekler.
87
- 4. **+security-engineer:** Güvenlik, auth, secret, veri işleme, erişim kontrolü veya compliance riski taşıyan görevlere `Review Gates: Security check` ekler.
88
- 5. **+designer:** UI, UX, responsive davranış, erişilebilirlik veya görsel tutarlılık gerektiren görevlere `Review Gates: Design review` ekler.
89
-
90
- ## Bağımlılık ve Önceliklendirme
91
-
92
- ### İlişkilendirme
93
-
94
- 1. **+engineering-manager:** Tüm görev adayları arasındaki teknik ve operasyonel bağımlılıkları belirler.
95
- 2. Bir görevin başlaması için başka bir görevin tamamlanması gerekiyorsa `Blocks` ve `Blocked By` alanlarını kullanır.
96
- > [!INFO] **Bağımlılık Yönetimi Kuralı:**
97
- > - **Task A:** `Blocks: [Task B]`
98
- > - **Task B:** `Blocked By: [Task A]`
99
- > - Assignee kim olursa olsun, `Blocked By` alanındaki görev tamamlanmadan bağlı görev başlamaz.
100
-
101
- ### Epic Kategorileri
102
-
103
- 1. **+engineering-manager:** Atomik görevleri ortak bir iş hedefine hizmet eden Epic başlıkları altında birleştirir.
104
- 2. Her Epic için amaç, kapsam, başarı kriteri, kapsadığı görev tipleri ve genel işleyiş yazılır.
105
- > [!WARNING] Her görev mutlaka bir **Epic** ile ilişkilendirilir.
106
-
107
- ### Versiyonlama
108
-
109
- 1. **+engineering-manager:** Epic'lerin ve görevlerin hangi versiyona ait olduğunu belirler.
110
- 2. Epic'leri projenin karmaşıklığına göre `v0.x` aşamalarından başlayarak `v1.0` aşamasına kadar mantıksal bir sıraya dizer.
111
- 3. Her versiyon için ana hedef, başarı kriteri ve kapsadığı Epic/Debt alanları yazılır.
112
- 4. Versiyon bilgisi `version-dashboard.md` içinde tutulur; versiyonlara göre alt klasör açılmaz.
113
- 5. Teknik borçlar `debt-dashboard.md` ve `DXX-[debt-name].md` item dosyalarında Debt olarak tutulur.
114
- > [!WARNING] Her epic mutlaka en az bir **Version** ile ilişkilendirilir.
115
-
116
- ## Görev Atama, Model ve Skill Seçimi
117
-
118
- 1. **+engineering-manager:** Her görevi yapması gereken ajana atar. Teknik görevlerde ajan seçimi görevin uzmanlık alanına, `../workspace/references/tech-stack.md` içeriğine ve gerekli Review Gates alanlarına göre yapılır.
119
- 2. Her göreve uygulanması gereken skill bilgisini ekler. Skill seçimi teknoloji yığınına, görev tipine ve ilgili ajan rolüne göre yapılır.
120
- 3. İnsan müdahalesi, erişim, bütçe veya dış platform onayı gerektiren görevler +prime'a atanır.
121
- 4. **+operation-manager:** `../rules/models.md` dosyasına göre her görevin ihtiyaç duyduğu model tercihini belirler ve task içine ekler.
122
- 5. Her Epic için owner ajanı belirler. Epic owner, Epic altındaki görevlerin ilerleme ve blokaj takibinden sorumludur.
123
-
124
- ## Konsolidasyon
125
-
126
- 1. **+operation-manager:** Tüm planning çıktılarını `../workspace/memory/backlog/` altında dashboard ve item dosyaları olarak oluşturur.
127
- - Reviewer: +engineering-manager
128
- - Approver: +prime
129
- > [!INFO] BACKLOG YAPISI
130
- >```
131
- > ../workspace/memory/backlog/
132
- > ├── version-dashboard.md
133
- > ├── epic-dashboard.md
134
- > ├── debt-dashboard.md
135
- > ├── TXX-[task-name].md
136
- > ├── BXX-[bug-name].md
137
- > └── DXX-[debt-name].md
138
- >```
139
-
140
- ## Bildirim
141
-
142
- > [!NOTE] PLANLAMA TAMAMLANDI
143
- > +prime,
144
- > [project-name] planlaması tamamlandı.
145
- > `../workspace/memory/backlog/` için `!approve/reject backlog` komutunu bekliyorum.
146
- > Onaydan sonra ortam kurulumu akışı için `!setup environment` komutunu bekleyeceğim.