forjajs 2.0.2 → 2.0.4

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 (712) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -317
  21. package/README.pt-BR.md +345 -323
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/apps/server/src/main.d.ts +3 -2
  329. package/dist/apps/server/src/main.js +8 -6
  330. package/dist/bin/create-memory-nest-kit.js +17 -17
  331. package/dist/bin/forja.js +22 -5
  332. package/dist/bin/init-project.js +38 -38
  333. package/dist/lib/audit.js +7 -7
  334. package/dist/lib/context-builder.js +32 -32
  335. package/dist/lib/core/doc-graph.js +6 -4
  336. package/dist/lib/core/registry.d.ts +64 -0
  337. package/dist/lib/core/registry.js +65 -0
  338. package/dist/lib/core/release.d.ts +63 -0
  339. package/dist/lib/core/release.js +5 -1
  340. package/dist/lib/generators/memory-generator.js +700 -698
  341. package/dist/lib/generators/nest-generator.js +398 -398
  342. package/dist/lib/generators/readme-generator.js +180 -180
  343. package/dist/lib/governance-report.js +39 -39
  344. package/dist/lib/project-upgrade.js +1 -1
  345. package/dist/lib/workspace.d.ts +7 -0
  346. package/dist/lib/workspace.js +63 -34
  347. package/dist/packages/adapter-git/src/index.d.ts +2 -0
  348. package/dist/packages/adapter-git/src/index.js +22 -1
  349. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  350. package/dist/packages/contracts/src/index.d.ts +1 -1
  351. package/dist/packages/llm/src/index.d.ts +43 -0
  352. package/dist/packages/llm/src/index.js +108 -0
  353. package/dist/packages/plugin-docker/src/index.d.ts +3 -0
  354. package/dist/packages/plugin-docker/src/index.js +13 -0
  355. package/dist/packages/plugin-github/src/index.d.ts +3 -0
  356. package/dist/packages/plugin-github/src/index.js +13 -0
  357. package/dist/packages/sandbox/src/index.d.ts +2 -0
  358. package/dist/packages/sandbox/src/index.js +10 -0
  359. package/dist/scripts/agent-harness.js +66 -64
  360. package/dist/scripts/agent-router.js +20 -20
  361. package/dist/scripts/build-smart-context.js +22 -22
  362. package/dist/scripts/compress-memory.js +8 -8
  363. package/dist/scripts/context-benchmark.d.ts +2 -0
  364. package/dist/scripts/context-benchmark.js +39 -0
  365. package/dist/scripts/context-ops.js +29 -29
  366. package/dist/scripts/demo-autonomy.d.ts +15 -0
  367. package/dist/scripts/demo-autonomy.js +200 -0
  368. package/dist/scripts/demo-workspace.d.ts +6 -0
  369. package/dist/scripts/demo-workspace.js +101 -0
  370. package/dist/scripts/dev.js +13 -13
  371. package/dist/scripts/extract-global-knowledge.js +5 -5
  372. package/dist/scripts/generate-dashboard.js +11 -11
  373. package/dist/scripts/llm-fit.d.ts +1 -0
  374. package/dist/scripts/llm-fit.js +131 -0
  375. package/dist/scripts/memory-schema.js +48 -48
  376. package/dist/scripts/query-universal-memory.js +13 -13
  377. package/dist/scripts/sprint-manager.js +39 -39
  378. package/dist/scripts/sync-universal-memory.js +63 -50
  379. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  380. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
  381. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  382. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  383. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  384. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
  385. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
  386. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
  387. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
  388. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
  389. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  390. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  391. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  392. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  393. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  394. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  395. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  396. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  397. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  398. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  399. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  400. package/docs/agent-harnesses.md +149 -149
  401. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  402. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  403. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  404. package/docs/archive/FASE2-SUMMARY.md +263 -263
  405. package/docs/archive/FASE3-PROGRESS.md +355 -355
  406. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  407. package/docs/archive/INDICE-MASTER.md +282 -282
  408. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  409. package/docs/archive/README-REFINAMENTO.md +293 -293
  410. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  411. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  412. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  413. package/docs/archive/START-HERE.md +319 -319
  414. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  415. package/docs/archive/examples/v1/AGENTS.md +10 -10
  416. package/docs/archive/examples/v1/README.md +36 -36
  417. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  418. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  419. package/docs/archive/examples/v1/backend/package.json +42 -42
  420. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  421. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  422. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  423. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  424. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  425. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  426. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  427. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  428. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  429. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  430. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  431. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  433. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  434. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  435. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  436. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  437. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  438. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  439. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  440. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  441. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  442. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  443. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  444. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  445. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  446. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  447. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  448. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  449. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  450. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  451. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  452. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  453. package/docs/archive/examples/v2/AGENTS.md +16 -16
  454. package/docs/archive/examples/v2/README.md +35 -35
  455. package/docs/archive/examples/v2/agents/README.md +3 -3
  456. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  457. package/docs/archive/examples/v2/agents/dba.md +4 -4
  458. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  459. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  460. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  461. package/docs/archive/examples/v2/agents/security.md +4 -4
  462. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  463. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  464. package/docs/archive/examples/v2/backend/package.json +42 -42
  465. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  466. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  467. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  468. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  469. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  470. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  471. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  472. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  473. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  474. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  475. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  476. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  477. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  479. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  480. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  481. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  482. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  483. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  484. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  485. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  486. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  487. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  488. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  489. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  490. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  491. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  492. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  493. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  494. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  495. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  496. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  497. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  498. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  499. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  500. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  501. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  502. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  503. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  504. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  505. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  506. package/docs/archive/examples/v2/memory/README.md +8 -8
  507. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  508. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  509. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  510. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  511. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  512. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  513. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  514. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  515. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  516. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  517. package/docs/capacidades-externas.md +86 -86
  518. package/docs/cli-first-operacao.md +74 -74
  519. package/docs/dev-workflow.md +421 -421
  520. package/docs/examples.md +546 -546
  521. package/docs/fluxo.md +103 -103
  522. package/docs/glossary.md +453 -453
  523. package/docs/init-project.md +457 -457
  524. package/docs/llm-fit-loop.md +41 -0
  525. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  526. package/docs/modos-de-operacao.md +52 -0
  527. package/docs/personas/architect/README.md +333 -333
  528. package/docs/personas/developer/README.md +371 -371
  529. package/docs/personas/executive/README.md +172 -172
  530. package/docs/personas/qa/README.md +350 -350
  531. package/docs/processo-projeto.md +138 -138
  532. package/docs/produto/factsheet-marketing.md +151 -0
  533. package/docs/produto/roteiro-demo.md +47 -0
  534. package/docs/publishing.md +377 -377
  535. package/docs/quick-reference.md +409 -409
  536. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  537. package/docs/structure.md +360 -360
  538. package/docs/token-optimization.md +502 -502
  539. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  540. package/memory/00-global/mission.md +15 -15
  541. package/memory/00-global/shared-knowledge.md +8 -8
  542. package/memory/00-global/standards.md +47 -47
  543. package/memory/10-product/personas.md +21 -21
  544. package/memory/10-product/vision.md +27 -27
  545. package/memory/30-projects/README.md +15 -15
  546. package/memory/40-delivery/backlog.md +15 -15
  547. package/memory/40-delivery/current-sprint.md +23 -26
  548. package/memory/50-orchestration/gsd-harness.md +55 -55
  549. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  550. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  551. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  552. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  553. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  554. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  555. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  556. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  557. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  558. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  559. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  560. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  561. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  562. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  563. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  564. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  565. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  566. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  567. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  568. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  569. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  570. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  571. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  572. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  573. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  574. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  575. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  576. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
  577. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  578. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  579. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  580. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  581. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  582. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  583. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  584. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  585. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
  586. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
  587. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
  588. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
  589. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  590. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  591. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  592. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  593. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  594. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  595. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  596. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  597. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  598. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  599. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  600. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  601. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  602. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  603. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  604. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  605. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  606. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  607. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  608. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  609. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  610. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  611. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  612. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  613. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  614. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  615. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  616. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  617. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  618. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  619. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  620. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  621. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  622. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  623. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  624. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  625. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  626. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  627. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  628. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  629. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  630. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  631. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  632. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  633. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  634. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  635. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  636. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  637. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  638. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  639. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  640. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  641. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  642. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  643. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  644. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  645. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  646. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  647. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  648. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  649. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  650. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  651. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  652. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  653. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
  654. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
  655. package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
  656. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
  657. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
  658. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  659. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  660. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  661. package/memory/90-decisions/_template.md +28 -28
  662. package/package.json +157 -140
  663. package/prompts/context-engineer-agent.md +19 -19
  664. package/prompts/governance-agent.md +16 -16
  665. package/prompts/marketing-agent.md +13 -13
  666. package/prompts/orchestrator-agent.md +18 -18
  667. package/prompts/product-agent.md +13 -13
  668. package/prompts/sdd-architect-agent.md +20 -20
  669. package/specs/README.md +70 -70
  670. package/specs/_templates/plan.md +43 -43
  671. package/specs/_templates/spec.md +43 -43
  672. package/specs/_templates/tasks.md +32 -32
  673. package/specs/clean-arch-boilerplate/plan.md +137 -137
  674. package/specs/clean-arch-boilerplate/spec.md +121 -121
  675. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  676. package/specs/cli-first-operacao/plan.md +53 -53
  677. package/specs/cli-first-operacao/spec.md +53 -53
  678. package/specs/cli-first-operacao/tasks.md +53 -53
  679. package/specs/code-context/spec.md +56 -56
  680. package/specs/coerencia-do-sistema/plan.md +155 -155
  681. package/specs/coerencia-do-sistema/spec.md +123 -123
  682. package/specs/coerencia-do-sistema/tasks.md +115 -115
  683. package/specs/dev-token-assets-db/plan.md +71 -71
  684. package/specs/dev-token-assets-db/spec.md +58 -58
  685. package/specs/dev-token-assets-db/tasks.md +58 -58
  686. package/specs/doctor-do-nucleo/plan.md +165 -165
  687. package/specs/doctor-do-nucleo/spec.md +139 -139
  688. package/specs/doctor-do-nucleo/tasks.md +172 -172
  689. package/specs/forja-core/spec.md +71 -71
  690. package/specs/gates/spec.md +63 -63
  691. package/specs/governanca-visivel/plan.md +122 -122
  692. package/specs/governanca-visivel/spec.md +112 -112
  693. package/specs/governanca-visivel/tasks.md +60 -60
  694. package/specs/harness-codegraph/spec.md +71 -71
  695. package/specs/memory-audit/spec.md +54 -54
  696. package/specs/orchestrate/spec.md +108 -108
  697. package/specs/orchestration-coherent/spec.md +95 -95
  698. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  699. package/specs/project-smoke/spec.md +96 -96
  700. package/specs/project-upgrade/spec.md +58 -58
  701. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  702. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  703. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  704. package/specs/release-auditor-health/plan.md +88 -0
  705. package/specs/release-auditor-health/spec.md +82 -0
  706. package/specs/release-auditor-health/tasks.md +72 -0
  707. package/specs/release-gate/plan.md +174 -174
  708. package/specs/release-gate/spec.md +122 -122
  709. package/specs/release-gate/tasks.md +183 -183
  710. package/specs/ts-migration/plan.md +200 -200
  711. package/specs/ts-migration/spec.md +119 -119
  712. package/specs/ts-migration/tasks.md +110 -110
@@ -1,121 +1,121 @@
1
- # Spec: clean-arch-boilerplate
2
-
3
- - **ID**: SPEC-013
4
- - **Status**: approved
5
- - **Owner**: apk
6
- - **Criado em**: 2026-07-18
7
- - **Sprint alvo**: S?
8
- - **ADRs relacionadas**: [ADR-0009](../../memory/90-decisions/0009-claude-hooks-token-economy.md) (economia de tokens), [ADR-0016](../../memory/90-decisions/0016-integracao-capacidades-externas.md) (harness), [ADR-0001](../../memory/90-decisions/0001-memoria-hierarquica.md) (memória hierárquica)
9
-
10
- ## 1. Problema
11
-
12
- Os boilerplates atuais são **NestJS-flat**: `modules/<x>/{controller, service, entities, dto}`, com o
13
- service falando direto com a entity do TypeORM. A infraestrutura (ORM) vaza para dentro da regra de
14
- negócio, não há inversão de dependência, e a regra de domínio — quando existe — fica presa dentro de
15
- um `service` acoplado ao framework. Isso cobra dois preços:
16
-
17
- 1. **De manutenção**: trocar ORM, testar regra sem subir o Nest, ou mover uma invariante para onde
18
- ela pertence exige cirurgia.
19
- 2. **De tokens** — o que mais importa aqui (ADR-0009). Um agente que opera um projeto flat precisa
20
- **ler a implementação inteira** para entender o que uma feature faz, porque a regra está diluída
21
- no service junto do acesso a dados e do HTTP. Não há contrato legível separado da execução.
22
-
23
- Ao mesmo tempo, a resposta ingênua — "aplicar Clean Architecture" — tem um preço oposto e igualmente
24
- real: **quatro camadas para um CRUD são mais arquivos para ler, não menos.** Um boilerplate que força
25
- use-case + porta + adapter + mapper por endpoint trivial é o anti-padrão de token que estamos tentando
26
- evitar, com nome bonito.
27
-
28
- ## 2. Proposta de valor
29
-
30
- Um boilerplate Clean Architecture que **sabe quando NÃO ser Clean Architecture.** Camadas ricas onde
31
- há regra de negócio de verdade; caminho enxuto explícito onde é CRUD. Estruturado para **navegação
32
- barata por agente**: o contrato de um use-case se lê pela assinatura de tipo, não pela implementação;
33
- cada bounded context tem um doc de memória na linguagem ubíqua que o agente lê **em vez** do código.
34
- Arquitetura como compressão de contexto, não como cerimônia.
35
-
36
- ## 3. User stories
37
-
38
- - **Como** dev iniciando um produto, **quero** um esqueleto com domínio isolado de framework e ORM,
39
- **para que** a regra de negócio seja testável e sobreviva a troca de infraestrutura.
40
- - **Como** agente operando o projeto gerado, **quero** ler o contrato tipado de um use-case e o doc
41
- de contexto do módulo, **para que** eu entenda a feature sem carregar a implementação inteira —
42
- menos tokens por tarefa.
43
- - **Como** dev com uma feature CRUD trivial, **quero** um caminho enxuto documentado, **para que** eu
44
- não pague 4 camadas por um `GET /x`.
45
- - **Como** arquiteto, **quero** uma fatia vertical rica de referência (com invariante de negócio de
46
- verdade), **para que** o padrão Clean Architecture seja demonstrado onde ele se paga, não abstrato.
47
-
48
- ## 4. Critérios de aceite (Definition of Done)
49
-
50
- - [ ] AC-1: Novo boilerplate `boilerplates/06-clean-arch/` com as 4 camadas e a **regra de
51
- dependência** para dentro: `domain` (puro: entities, value objects, ports/interfaces — zero
52
- NestJS, zero ORM) → `application` (use-cases orquestrando domínio + portas) → `infrastructure`
53
- (adapters: repos ORM, mappers, serviços externos) + `presentation` (controllers, DTOs HTTP).
54
- - [ ] AC-2: **Inversão de dependência real** via DI do NestJS: as portas são tokens de injeção
55
- (`interface` no domínio), os adapters as implementam e são bound no módulo. O use-case depende
56
- da porta, nunca da implementação.
57
- - [ ] AC-3: **Fatia vertical rica de referência** — um bounded context com invariante de negócio
58
- genuína (não CRUD) que vive **no domínio** (ex.: um `Order` que não pode ser enviado sem
59
- pagamento; ou `Subscription` como máquina de estados). Prova que a separação se paga.
60
- - [ ] AC-4: **Caminho enxuto explícito** (a calibração). Um módulo CRUD simples demonstrado com o
61
- mínimo de camadas, e um doc `WHEN-CLEAN-WHEN-LEAN.md` que ensina o critério de escolha. O
62
- boilerplate não força ceremônia.
63
- - [ ] AC-5: **Contratos legíveis** — todo use-case tem input/output tipados (TS) que se leem sem a
64
- implementação. O domínio é a linguagem ubíqua tipada.
65
- - [ ] AC-6: **Memória por bounded context** (ADR-0001): cada contexto tem um doc em
66
- `memory/30-domains/<ctx>/context.md` na linguagem ubíqua, que o agente lê **antes** do código.
67
- Medir: o pacote de contexto de uma tarefa cai vs. o boilerplate flat (ADR-0009).
68
- - [ ] AC-7: Manifesto (`boilerplate.manifest.json`) + integração com o gerador (o boilerplate aparece
69
- como opção, gera com a memória e os agentes multi-IA como os outros).
70
- - [ ] AC-8: **Testes de domínio sem framework**: a invariante da AC-3 tem teste unitário que roda
71
- **sem subir o Nest** — a prova concreta de que o domínio está isolado.
72
- - [ ] AC-9: O boilerplate passa pelos gates do próprio Forja: `release:check` (está no `files[]`,
73
- instala limpo) e a coerência de doc (SPEC-011) não acusa comando fantasma nos seus docs.
74
- - [ ] AC-10: ADR registrando a decisão (Clean Architecture calibrada como boilerplate; o *porquê* da
75
- calibração e do ângulo de token).
76
-
77
- ## 5. Escopo
78
-
79
- **Dentro**:
80
- - `boilerplates/06-clean-arch/` completo: as 4 camadas, a fatia rica, o módulo enxuto, o
81
- `WHEN-CLEAN-WHEN-LEAN.md`, a memória por contexto, o manifesto.
82
- - Integração com o gerador (`lib/generators/`) para o boilerplate ser selecionável.
83
- - ADR + a atualização de `boilerplates/README.md`.
84
-
85
- **Fora** (explícito):
86
- - **Refatorar os boilerplates existentes** (01-05). Eles ficam; este é aditivo. Migrar os antigos é
87
- outra decisão.
88
- - **Aplicar Clean Architecture ao framework Forja.** Decidido: over-engineering para um CLI; o
89
- framework ganha só modelos de domínio tipados, e isso ride na migração TS (SPEC-012), não aqui.
90
- - **Frontend.** Este boilerplate é backend (NestJS). Um par frontend é outra spec.
91
- - **Prescrever ORM único.** O ponto é o domínio não saber do ORM; qual ORM o adapter usa é detalhe do
92
- boilerplate, não da arquitetura.
93
-
94
- ## 6. NFRs / restrições
95
-
96
- - **Token-first (a régua)**: o ganho tem que ser *medível*. AC-6 exige comparar o pacote de contexto
97
- de uma tarefa-tipo neste boilerplate vs. no flat. Se não cair, a arquitetura virou custo, não
98
- economia — e aí recalibra.
99
- - **Calibração inegociável**: a existência do caminho enxuto (AC-4) é o que separa esta spec de um
100
- cargo-cult. Sem ele, reprovado.
101
- - **TypeScript**: alinhado com a migração em curso (SPEC-012) — o domínio é tipado de primeira classe.
102
- - **Compatibilidade**: aditivo; não muda os geradores dos boilerplates existentes.
103
-
104
- ## 7. Riscos e mitigação
105
-
106
- | Risco | Prob | Impacto | Mitigação |
107
- |---|---|---|---|
108
- | Vira cargo-cult: 4 camadas por CRUD, +tokens | **A** | A | AC-4 (caminho enxuto) + AC-6 (medir tokens) são gate; sem eles, reprova |
109
- | Complexidade assusta o dev/agente | M | M | A fatia rica é 1 só; o resto é enxuto. `WHEN-CLEAN-WHEN-LEAN.md` guia |
110
- | Inversão de dependência no Nest fica verbosa | M | M | Padrão de porta-como-token documentado uma vez; repetível |
111
- | O ganho de token não se materializa | M | A | Medir cedo (AC-6). Se não cair, a spec falhou seu propósito — honesto reconhecer |
112
-
113
- ## 8. Métricas de sucesso
114
-
115
- - **Tokens por tarefa** num projeto gerado com este boilerplate **caem** vs. o flat, para uma
116
- tarefa-tipo ("adicionar uma regra ao contexto X") — medido via `context:smart`/`token:benchmark`.
117
- É a métrica-norte; sem ela a arquitetura não se justifica.
118
- - Um dev pega a fatia rica e adiciona uma invariante de negócio **sem tocar em infraestrutura**.
119
- - A invariante de domínio é testável **sem subir o Nest** (AC-8).
120
- - 90 dias depois: os projetos novos do usuário escolhem este boilerplate quando há regra de negócio,
121
- e o flat quando é CRUD puro — a calibração usada na prática, não só documentada.
1
+ # Spec: clean-arch-boilerplate
2
+
3
+ - **ID**: SPEC-013
4
+ - **Status**: approved
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-07-18
7
+ - **Sprint alvo**: S?
8
+ - **ADRs relacionadas**: [ADR-0009](../../memory/90-decisions/0009-claude-hooks-token-economy.md) (economia de tokens), [ADR-0016](../../memory/90-decisions/0016-integracao-capacidades-externas.md) (harness), [ADR-0001](../../memory/90-decisions/0001-memoria-hierarquica.md) (memória hierárquica)
9
+
10
+ ## 1. Problema
11
+
12
+ Os boilerplates atuais são **NestJS-flat**: `modules/<x>/{controller, service, entities, dto}`, com o
13
+ service falando direto com a entity do TypeORM. A infraestrutura (ORM) vaza para dentro da regra de
14
+ negócio, não há inversão de dependência, e a regra de domínio — quando existe — fica presa dentro de
15
+ um `service` acoplado ao framework. Isso cobra dois preços:
16
+
17
+ 1. **De manutenção**: trocar ORM, testar regra sem subir o Nest, ou mover uma invariante para onde
18
+ ela pertence exige cirurgia.
19
+ 2. **De tokens** — o que mais importa aqui (ADR-0009). Um agente que opera um projeto flat precisa
20
+ **ler a implementação inteira** para entender o que uma feature faz, porque a regra está diluída
21
+ no service junto do acesso a dados e do HTTP. Não há contrato legível separado da execução.
22
+
23
+ Ao mesmo tempo, a resposta ingênua — "aplicar Clean Architecture" — tem um preço oposto e igualmente
24
+ real: **quatro camadas para um CRUD são mais arquivos para ler, não menos.** Um boilerplate que força
25
+ use-case + porta + adapter + mapper por endpoint trivial é o anti-padrão de token que estamos tentando
26
+ evitar, com nome bonito.
27
+
28
+ ## 2. Proposta de valor
29
+
30
+ Um boilerplate Clean Architecture que **sabe quando NÃO ser Clean Architecture.** Camadas ricas onde
31
+ há regra de negócio de verdade; caminho enxuto explícito onde é CRUD. Estruturado para **navegação
32
+ barata por agente**: o contrato de um use-case se lê pela assinatura de tipo, não pela implementação;
33
+ cada bounded context tem um doc de memória na linguagem ubíqua que o agente lê **em vez** do código.
34
+ Arquitetura como compressão de contexto, não como cerimônia.
35
+
36
+ ## 3. User stories
37
+
38
+ - **Como** dev iniciando um produto, **quero** um esqueleto com domínio isolado de framework e ORM,
39
+ **para que** a regra de negócio seja testável e sobreviva a troca de infraestrutura.
40
+ - **Como** agente operando o projeto gerado, **quero** ler o contrato tipado de um use-case e o doc
41
+ de contexto do módulo, **para que** eu entenda a feature sem carregar a implementação inteira —
42
+ menos tokens por tarefa.
43
+ - **Como** dev com uma feature CRUD trivial, **quero** um caminho enxuto documentado, **para que** eu
44
+ não pague 4 camadas por um `GET /x`.
45
+ - **Como** arquiteto, **quero** uma fatia vertical rica de referência (com invariante de negócio de
46
+ verdade), **para que** o padrão Clean Architecture seja demonstrado onde ele se paga, não abstrato.
47
+
48
+ ## 4. Critérios de aceite (Definition of Done)
49
+
50
+ - [ ] AC-1: Novo boilerplate `boilerplates/06-clean-arch/` com as 4 camadas e a **regra de
51
+ dependência** para dentro: `domain` (puro: entities, value objects, ports/interfaces — zero
52
+ NestJS, zero ORM) → `application` (use-cases orquestrando domínio + portas) → `infrastructure`
53
+ (adapters: repos ORM, mappers, serviços externos) + `presentation` (controllers, DTOs HTTP).
54
+ - [ ] AC-2: **Inversão de dependência real** via DI do NestJS: as portas são tokens de injeção
55
+ (`interface` no domínio), os adapters as implementam e são bound no módulo. O use-case depende
56
+ da porta, nunca da implementação.
57
+ - [ ] AC-3: **Fatia vertical rica de referência** — um bounded context com invariante de negócio
58
+ genuína (não CRUD) que vive **no domínio** (ex.: um `Order` que não pode ser enviado sem
59
+ pagamento; ou `Subscription` como máquina de estados). Prova que a separação se paga.
60
+ - [ ] AC-4: **Caminho enxuto explícito** (a calibração). Um módulo CRUD simples demonstrado com o
61
+ mínimo de camadas, e um doc `WHEN-CLEAN-WHEN-LEAN.md` que ensina o critério de escolha. O
62
+ boilerplate não força ceremônia.
63
+ - [ ] AC-5: **Contratos legíveis** — todo use-case tem input/output tipados (TS) que se leem sem a
64
+ implementação. O domínio é a linguagem ubíqua tipada.
65
+ - [ ] AC-6: **Memória por bounded context** (ADR-0001): cada contexto tem um doc em
66
+ `memory/30-domains/<ctx>/context.md` na linguagem ubíqua, que o agente lê **antes** do código.
67
+ Medir: o pacote de contexto de uma tarefa cai vs. o boilerplate flat (ADR-0009).
68
+ - [ ] AC-7: Manifesto (`boilerplate.manifest.json`) + integração com o gerador (o boilerplate aparece
69
+ como opção, gera com a memória e os agentes multi-IA como os outros).
70
+ - [ ] AC-8: **Testes de domínio sem framework**: a invariante da AC-3 tem teste unitário que roda
71
+ **sem subir o Nest** — a prova concreta de que o domínio está isolado.
72
+ - [ ] AC-9: O boilerplate passa pelos gates do próprio Forja: `release:check` (está no `files[]`,
73
+ instala limpo) e a coerência de doc (SPEC-011) não acusa comando fantasma nos seus docs.
74
+ - [ ] AC-10: ADR registrando a decisão (Clean Architecture calibrada como boilerplate; o *porquê* da
75
+ calibração e do ângulo de token).
76
+
77
+ ## 5. Escopo
78
+
79
+ **Dentro**:
80
+ - `boilerplates/06-clean-arch/` completo: as 4 camadas, a fatia rica, o módulo enxuto, o
81
+ `WHEN-CLEAN-WHEN-LEAN.md`, a memória por contexto, o manifesto.
82
+ - Integração com o gerador (`lib/generators/`) para o boilerplate ser selecionável.
83
+ - ADR + a atualização de `boilerplates/README.md`.
84
+
85
+ **Fora** (explícito):
86
+ - **Refatorar os boilerplates existentes** (01-05). Eles ficam; este é aditivo. Migrar os antigos é
87
+ outra decisão.
88
+ - **Aplicar Clean Architecture ao framework Forja.** Decidido: over-engineering para um CLI; o
89
+ framework ganha só modelos de domínio tipados, e isso ride na migração TS (SPEC-012), não aqui.
90
+ - **Frontend.** Este boilerplate é backend (NestJS). Um par frontend é outra spec.
91
+ - **Prescrever ORM único.** O ponto é o domínio não saber do ORM; qual ORM o adapter usa é detalhe do
92
+ boilerplate, não da arquitetura.
93
+
94
+ ## 6. NFRs / restrições
95
+
96
+ - **Token-first (a régua)**: o ganho tem que ser *medível*. AC-6 exige comparar o pacote de contexto
97
+ de uma tarefa-tipo neste boilerplate vs. no flat. Se não cair, a arquitetura virou custo, não
98
+ economia — e aí recalibra.
99
+ - **Calibração inegociável**: a existência do caminho enxuto (AC-4) é o que separa esta spec de um
100
+ cargo-cult. Sem ele, reprovado.
101
+ - **TypeScript**: alinhado com a migração em curso (SPEC-012) — o domínio é tipado de primeira classe.
102
+ - **Compatibilidade**: aditivo; não muda os geradores dos boilerplates existentes.
103
+
104
+ ## 7. Riscos e mitigação
105
+
106
+ | Risco | Prob | Impacto | Mitigação |
107
+ |---|---|---|---|
108
+ | Vira cargo-cult: 4 camadas por CRUD, +tokens | **A** | A | AC-4 (caminho enxuto) + AC-6 (medir tokens) são gate; sem eles, reprova |
109
+ | Complexidade assusta o dev/agente | M | M | A fatia rica é 1 só; o resto é enxuto. `WHEN-CLEAN-WHEN-LEAN.md` guia |
110
+ | Inversão de dependência no Nest fica verbosa | M | M | Padrão de porta-como-token documentado uma vez; repetível |
111
+ | O ganho de token não se materializa | M | A | Medir cedo (AC-6). Se não cair, a spec falhou seu propósito — honesto reconhecer |
112
+
113
+ ## 8. Métricas de sucesso
114
+
115
+ - **Tokens por tarefa** num projeto gerado com este boilerplate **caem** vs. o flat, para uma
116
+ tarefa-tipo ("adicionar uma regra ao contexto X") — medido via `context:smart`/`token:benchmark`.
117
+ É a métrica-norte; sem ela a arquitetura não se justifica.
118
+ - Um dev pega a fatia rica e adiciona uma invariante de negócio **sem tocar em infraestrutura**.
119
+ - A invariante de domínio é testável **sem subir o Nest** (AC-8).
120
+ - 90 dias depois: os projetos novos do usuário escolhem este boilerplate quando há regra de negócio,
121
+ e o flat quando é CRUD puro — a calibração usada na prática, não só documentada.
@@ -1,70 +1,70 @@
1
- # Tasks: clean-arch-boilerplate
2
-
3
- - **Spec**: ./spec.md
4
- - **Plan**: ./plan.md
5
- - **Status**: approved
6
- - **Criado em**: 2026-07-18
7
-
8
- > Decomposição executável. O boilerplate é **conteúdo de template** (código do projeto gerado), não
9
- > código do framework — não roda na CI do Forja. Escrever para ser referência idiomática correta.
10
-
11
- ---
12
-
13
- ## T1 — Esqueleto + `shared/`
14
- - **Owner**: Worker · **Estimativa**: P · **Depende de**: —
15
- - **Paths**: `boilerplates/06-clean-arch/backend/src/{shared,main.ts,app.module.ts}`
16
- - **Done**: `Result`/erros de domínio/base VO; `main.ts`/`app.module.ts`; `package.json` + `tsconfig`
17
- do projeto (com `test:e2e`, `start:dev` etc. — entram na allowlist derivada do SPEC-011).
18
-
19
- ## T2 — Fatia rica: Orders (as 4 camadas) — AC-1/2/3/5
20
- - **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
21
- - **Paths**: `.../modules/orders/{domain,application,infrastructure,presentation}/*`, `orders.module.ts`
22
- - **Done**:
23
- - [ ] `domain/`: `Order` (agregado, invariantes: não confirma sem estoque, não envia sem pagamento),
24
- `order-status.vo.ts`, `order.repository.ts` (porta = interface + token). **Zero `@nestjs`/ORM.**
25
- - [ ] `application/`: `place-order`/`ship-order` use-cases com input/output tipados (contrato legível).
26
- - [ ] `infrastructure/`: adapter TypeORM implementa a porta + mapper domínio↔orm-entity.
27
- - [ ] `presentation/`: controller + HTTP DTOs mapeando p/ use-case.
28
- - [ ] `orders.module.ts`: bind `{ provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository }`.
29
-
30
- ## T3 — Teste da invariante sem Nest — AC-8
31
- - **Owner**: Worker · **Estimativa**: P · **Depende de**: T2
32
- - **Paths**: `.../backend/test/orders/place-order.spec.ts`
33
- - **Done**: testa a invariante de domínio **instanciando só o agregado** (sem `Test.createTestingModule`,
34
- sem ORM). É a prova concreta do isolamento — se precisar do Nest, o domínio vazou.
35
-
36
- ## T4 — Caminho enxuto: Products (1 camada) — AC-4
37
- - **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
38
- - **Paths**: `.../modules/products/*`, `WHEN-CLEAN-WHEN-LEAN.md`
39
- - **Done**: CRUD controller→repo direto, **sem** use-case/porta; o doc ensina o critério de escolha.
40
- Kill criteria: se Products virar 4 camadas, a spec falhou.
41
-
42
- ## T5 — Memória por contexto (o vetor de token) — AC-6
43
- - **Owner**: Worker · **Estimativa**: P · **Depende de**: T2, T4
44
- - **Paths**: `.../memory/30-domains/{orders,products}/context.md`
45
- - **Done**: cada contexto descrito na linguagem ubíqua — o que o agente lê **antes** do código.
46
- Orders documenta as invariantes e os use-cases; Products, o CRUD raso.
47
-
48
- ## T6 — Manifesto + catálogo + README — AC-7
49
- - **Owner**: Worker · **Estimativa**: P · **Depende de**: T1-T5
50
- - **Paths**: `.../boilerplate.manifest.json`, `.../README.md`, `boilerplates/README.md`
51
- - **Done**: manifesto no schema 1.0 (stack/useCases/commands); entrada no catálogo; README explicando
52
- a estrutura e apontando o `WHEN-CLEAN-WHEN-LEAN.md`.
53
-
54
- ## T7 — Medir o token (métrica-norte) + ADR-0027 — AC-6/AC-10
55
- - **Owner**: SDD Architect + Governance · **Estimativa**: P · **Depende de**: T5, T6
56
- - **Paths**: `memory/90-decisions/0027-*.md`
57
- - **Done**:
58
- - [ ] Medir o pacote de contexto de "adicionar uma regra ao contexto orders" aqui vs. no
59
- `02-saas-starter` flat. **Registrar os números.**
60
- - [ ] ADR-0027: Clean Architecture calibrada; o porquê da calibração e o resultado da medição.
61
- Se o token não caiu, o ADR diz isso e recalibra — não maquia.
62
-
63
- ## T8 — Gates (Governance) — AC-9
64
- - **Owner**: Governance · **Estimativa**: P · **Depende de**: T6
65
- - **Done**: `release:check` (boilerplate no `files[]`, instala limpo), `tools:doctor` (docs-commands
66
- não acusa fantasma), `npm test` do Forja verde. spec → `done`.
67
-
68
- ---
69
- ## Handoffs
70
- Worker (T1-T6), SDD Architect + Governance (T7-T8). `forja agent:route` a cada fronteira (ADR-0005).
1
+ # Tasks: clean-arch-boilerplate
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: approved
6
+ - **Criado em**: 2026-07-18
7
+
8
+ > Decomposição executável. O boilerplate é **conteúdo de template** (código do projeto gerado), não
9
+ > código do framework — não roda na CI do Forja. Escrever para ser referência idiomática correta.
10
+
11
+ ---
12
+
13
+ ## T1 — Esqueleto + `shared/`
14
+ - **Owner**: Worker · **Estimativa**: P · **Depende de**: —
15
+ - **Paths**: `boilerplates/06-clean-arch/backend/src/{shared,main.ts,app.module.ts}`
16
+ - **Done**: `Result`/erros de domínio/base VO; `main.ts`/`app.module.ts`; `package.json` + `tsconfig`
17
+ do projeto (com `test:e2e`, `start:dev` etc. — entram na allowlist derivada do SPEC-011).
18
+
19
+ ## T2 — Fatia rica: Orders (as 4 camadas) — AC-1/2/3/5
20
+ - **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
21
+ - **Paths**: `.../modules/orders/{domain,application,infrastructure,presentation}/*`, `orders.module.ts`
22
+ - **Done**:
23
+ - [ ] `domain/`: `Order` (agregado, invariantes: não confirma sem estoque, não envia sem pagamento),
24
+ `order-status.vo.ts`, `order.repository.ts` (porta = interface + token). **Zero `@nestjs`/ORM.**
25
+ - [ ] `application/`: `place-order`/`ship-order` use-cases com input/output tipados (contrato legível).
26
+ - [ ] `infrastructure/`: adapter TypeORM implementa a porta + mapper domínio↔orm-entity.
27
+ - [ ] `presentation/`: controller + HTTP DTOs mapeando p/ use-case.
28
+ - [ ] `orders.module.ts`: bind `{ provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository }`.
29
+
30
+ ## T3 — Teste da invariante sem Nest — AC-8
31
+ - **Owner**: Worker · **Estimativa**: P · **Depende de**: T2
32
+ - **Paths**: `.../backend/test/orders/place-order.spec.ts`
33
+ - **Done**: testa a invariante de domínio **instanciando só o agregado** (sem `Test.createTestingModule`,
34
+ sem ORM). É a prova concreta do isolamento — se precisar do Nest, o domínio vazou.
35
+
36
+ ## T4 — Caminho enxuto: Products (1 camada) — AC-4
37
+ - **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
38
+ - **Paths**: `.../modules/products/*`, `WHEN-CLEAN-WHEN-LEAN.md`
39
+ - **Done**: CRUD controller→repo direto, **sem** use-case/porta; o doc ensina o critério de escolha.
40
+ Kill criteria: se Products virar 4 camadas, a spec falhou.
41
+
42
+ ## T5 — Memória por contexto (o vetor de token) — AC-6
43
+ - **Owner**: Worker · **Estimativa**: P · **Depende de**: T2, T4
44
+ - **Paths**: `.../memory/30-domains/{orders,products}/context.md`
45
+ - **Done**: cada contexto descrito na linguagem ubíqua — o que o agente lê **antes** do código.
46
+ Orders documenta as invariantes e os use-cases; Products, o CRUD raso.
47
+
48
+ ## T6 — Manifesto + catálogo + README — AC-7
49
+ - **Owner**: Worker · **Estimativa**: P · **Depende de**: T1-T5
50
+ - **Paths**: `.../boilerplate.manifest.json`, `.../README.md`, `boilerplates/README.md`
51
+ - **Done**: manifesto no schema 1.0 (stack/useCases/commands); entrada no catálogo; README explicando
52
+ a estrutura e apontando o `WHEN-CLEAN-WHEN-LEAN.md`.
53
+
54
+ ## T7 — Medir o token (métrica-norte) + ADR-0027 — AC-6/AC-10
55
+ - **Owner**: SDD Architect + Governance · **Estimativa**: P · **Depende de**: T5, T6
56
+ - **Paths**: `memory/90-decisions/0027-*.md`
57
+ - **Done**:
58
+ - [ ] Medir o pacote de contexto de "adicionar uma regra ao contexto orders" aqui vs. no
59
+ `02-saas-starter` flat. **Registrar os números.**
60
+ - [ ] ADR-0027: Clean Architecture calibrada; o porquê da calibração e o resultado da medição.
61
+ Se o token não caiu, o ADR diz isso e recalibra — não maquia.
62
+
63
+ ## T8 — Gates (Governance) — AC-9
64
+ - **Owner**: Governance · **Estimativa**: P · **Depende de**: T6
65
+ - **Done**: `release:check` (boilerplate no `files[]`, instala limpo), `tools:doctor` (docs-commands
66
+ não acusa fantasma), `npm test` do Forja verde. spec → `done`.
67
+
68
+ ---
69
+ ## Handoffs
70
+ Worker (T1-T6), SDD Architect + Governance (T7-T8). `forja agent:route` a cada fronteira (ADR-0005).
@@ -1,53 +1,53 @@
1
- # Plan: cli-first-operacao
2
-
3
- - **Spec**: ./spec.md
4
- - **Status**: approved
5
- - **Criado em**: 2026-06-02
6
-
7
- ## 1. Abordagem tecnica
8
- Manter o dashboard existente como opcional e mover a operacao principal para comandos. Corrigir o gerenciador de sprint para funcionar no repositorio raiz, aceitar backlog RICE e expor encerramento de sprint no `package.json`. Ajustar GSD para nao exigir design em fluxo sem UI.
9
-
10
- ## 2. Modulos afetados
11
- | Caminho | Mudanca | Risco |
12
- |---|---|---|
13
- | `scripts/sprint-manager.js` | default para raiz e suporte a tabela RICE | M |
14
- | `scripts/agent-harness.mjs` | `gsd:check` aceita CLI-only sem brief visual | B |
15
- | `scripts/dev.mjs` | saida textual mais limpa | B |
16
- | `scripts/check-standards.js` | `project:check` valida root sem argumento | B |
17
- | `package.json` | novos aliases de operacao | B |
18
- | `README.md`, `AGENTS.md`, `docs/*` | documentar CLI-first | B |
19
-
20
- ## 3. Fluxo
21
- ```
22
- sprint:start/status
23
- -> context:build
24
- -> gsd:plan
25
- -> gsd:handoff spec/plan/implement/review
26
- -> gsd:check
27
- -> project:check
28
- ```
29
-
30
- ## 4. Contratos
31
- - `npm run sprint:start [projeto]`
32
- - `npm run sprint:status [projeto]`
33
- - `npm run sprint:complete [projeto]`
34
- - `npm run gsd:check -- <slug> [brief.md]`
35
-
36
- Sem `brief.md`, o check considera design como nao aplicavel.
37
-
38
- ## 5. Decisoes
39
- **D1**: Nao remover o dashboard agora. Ele fica legado/opcional para evitar quebra de scripts e preservar historico.
40
-
41
- **D2**: Backlog RICE nao e modificado ao iniciar sprint. A sprint recebe uma selecao operacional dos P0/P1.
42
-
43
- ## 6. Dependencias
44
- - Sem novos pacotes.
45
- - Sem migracao de banco.
46
-
47
- ## 7. Rollout
48
- - Documentacao atualizada no README, AGENTS e guia CLI-first.
49
- - Testes de CLI executados localmente.
50
-
51
- ## 8. Sinais de fracasso
52
- - Operador ainda precisar abrir web para acompanhar sprint.
53
- - `gsd:check` bloquear tarefa CLI-only por ausencia de brief visual.
1
+ # Plan: cli-first-operacao
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Status**: approved
5
+ - **Criado em**: 2026-06-02
6
+
7
+ ## 1. Abordagem tecnica
8
+ Manter o dashboard existente como opcional e mover a operacao principal para comandos. Corrigir o gerenciador de sprint para funcionar no repositorio raiz, aceitar backlog RICE e expor encerramento de sprint no `package.json`. Ajustar GSD para nao exigir design em fluxo sem UI.
9
+
10
+ ## 2. Modulos afetados
11
+ | Caminho | Mudanca | Risco |
12
+ |---|---|---|
13
+ | `scripts/sprint-manager.js` | default para raiz e suporte a tabela RICE | M |
14
+ | `scripts/agent-harness.mjs` | `gsd:check` aceita CLI-only sem brief visual | B |
15
+ | `scripts/dev.mjs` | saida textual mais limpa | B |
16
+ | `scripts/check-standards.js` | `project:check` valida root sem argumento | B |
17
+ | `package.json` | novos aliases de operacao | B |
18
+ | `README.md`, `AGENTS.md`, `docs/*` | documentar CLI-first | B |
19
+
20
+ ## 3. Fluxo
21
+ ```
22
+ sprint:start/status
23
+ -> context:build
24
+ -> gsd:plan
25
+ -> gsd:handoff spec/plan/implement/review
26
+ -> gsd:check
27
+ -> project:check
28
+ ```
29
+
30
+ ## 4. Contratos
31
+ - `npm run sprint:start [projeto]`
32
+ - `npm run sprint:status [projeto]`
33
+ - `npm run sprint:complete [projeto]`
34
+ - `npm run gsd:check -- <slug> [brief.md]`
35
+
36
+ Sem `brief.md`, o check considera design como nao aplicavel.
37
+
38
+ ## 5. Decisoes
39
+ **D1**: Nao remover o dashboard agora. Ele fica legado/opcional para evitar quebra de scripts e preservar historico.
40
+
41
+ **D2**: Backlog RICE nao e modificado ao iniciar sprint. A sprint recebe uma selecao operacional dos P0/P1.
42
+
43
+ ## 6. Dependencias
44
+ - Sem novos pacotes.
45
+ - Sem migracao de banco.
46
+
47
+ ## 7. Rollout
48
+ - Documentacao atualizada no README, AGENTS e guia CLI-first.
49
+ - Testes de CLI executados localmente.
50
+
51
+ ## 8. Sinais de fracasso
52
+ - Operador ainda precisar abrir web para acompanhar sprint.
53
+ - `gsd:check` bloquear tarefa CLI-only por ausencia de brief visual.
@@ -1,53 +1,53 @@
1
- # Spec: cli-first-operacao
2
-
3
- - **ID**: SPEC-CLI-FIRST-001
4
- - **Status**: done
5
- - **Owner**: orchestrator
6
- - **Criado em**: 2026-06-02
7
- - **Sprint alvo**: refinamento-cli-2026-06
8
- - **ADRs relacionadas**: ADR-0005, ADR-0007, ADR-0008
9
-
10
- ## 1. Problema
11
- O projeto tinha forte presenca de dashboard/web e referencias visuais na entrada operacional. Isso poluia a operacao diaria e desviava o uso do objetivo principal: orquestracao, SDD, GSD, sprints e handoffs por comandos.
12
-
13
- ## 2. Proposta de valor
14
- Operar o framework pelo terminal com sprints, contexto, specs, handoffs, checks e governanca em uma trilha curta e repetivel.
15
-
16
- ## 3. User stories
17
- - **Como** operador do framework, **quero** acompanhar sprints pelo CLI, **para que** eu nao dependa da web para saber o proximo passo.
18
- - **Como** Orchestrator, **quero** registrar handoffs GSD pelo CLI, **para que** SDD e governanca tenham rastreabilidade.
19
- - **Como** Governance, **quero** validar entregas CLI-only sem brief visual, **para que** design nao bloqueie trabalho sem UI.
20
-
21
- ## 4. Criterios de aceite
22
- - [x] AC-1: `npm run sprint:start/status/complete` funciona no repositorio raiz sem argumento de projeto.
23
- - [x] AC-2: backlog em tabela RICE gera sprint com itens P0/P1.
24
- - [x] AC-3: `gsd:check` nao exige brief visual quando a entrega e CLI-only.
25
- - [x] AC-4: README, AGENTS e docs apontam CLI-first como caminho operacional principal.
26
- - [x] AC-5: dashboard/web permanece opcional/legado, nao gate operacional.
27
- - [x] AC-6: `npm run project:check` valida o framework raiz quando chamado sem projeto.
28
-
29
- ## 5. Escopo
30
- **Dentro**:
31
- - Scripts de sprint e GSD.
32
- - Check de governanca do projeto raiz.
33
- - Documentacao de operacao CLI-first.
34
- - Reducao de ruido visual no CLI principal.
35
-
36
- **Fora**:
37
- - Remover fisicamente o dashboard.
38
- - Reescrever frontend.
39
- - Alterar SQLite ou schema de handoffs.
40
-
41
- ## 6. NFRs / restricoes
42
- - Compatibilidade: manter comandos existentes.
43
- - Operabilidade: saida de terminal simples, sem depender de browser.
44
- - Governanca: preservar ADR-0005 e fluxo SDD.
45
-
46
- ## 7. Riscos e mitigacao
47
- | Risco | Probabilidade | Impacto | Mitigacao |
48
- |---|---|---|---|
49
- | Usuarios ainda abrirem dashboard por habito | M | B | README e AGENTS priorizam CLI-first |
50
- | Sprint duplicar itens de backlog RICE | B | B | Tabela RICE nao e removida; sprint vira selecao operacional |
51
-
52
- ## 8. Metricas de sucesso
53
- Em 30 dias, 90% das execucoes de sprint e handoff devem ser feitas por CLI, com `gsd:check` e `project:check` usados antes de entrega.
1
+ # Spec: cli-first-operacao
2
+
3
+ - **ID**: SPEC-CLI-FIRST-001
4
+ - **Status**: done
5
+ - **Owner**: orchestrator
6
+ - **Criado em**: 2026-06-02
7
+ - **Sprint alvo**: refinamento-cli-2026-06
8
+ - **ADRs relacionadas**: ADR-0005, ADR-0007, ADR-0008
9
+
10
+ ## 1. Problema
11
+ O projeto tinha forte presenca de dashboard/web e referencias visuais na entrada operacional. Isso poluia a operacao diaria e desviava o uso do objetivo principal: orquestracao, SDD, GSD, sprints e handoffs por comandos.
12
+
13
+ ## 2. Proposta de valor
14
+ Operar o framework pelo terminal com sprints, contexto, specs, handoffs, checks e governanca em uma trilha curta e repetivel.
15
+
16
+ ## 3. User stories
17
+ - **Como** operador do framework, **quero** acompanhar sprints pelo CLI, **para que** eu nao dependa da web para saber o proximo passo.
18
+ - **Como** Orchestrator, **quero** registrar handoffs GSD pelo CLI, **para que** SDD e governanca tenham rastreabilidade.
19
+ - **Como** Governance, **quero** validar entregas CLI-only sem brief visual, **para que** design nao bloqueie trabalho sem UI.
20
+
21
+ ## 4. Criterios de aceite
22
+ - [x] AC-1: `npm run sprint:start/status/complete` funciona no repositorio raiz sem argumento de projeto.
23
+ - [x] AC-2: backlog em tabela RICE gera sprint com itens P0/P1.
24
+ - [x] AC-3: `gsd:check` nao exige brief visual quando a entrega e CLI-only.
25
+ - [x] AC-4: README, AGENTS e docs apontam CLI-first como caminho operacional principal.
26
+ - [x] AC-5: dashboard/web permanece opcional/legado, nao gate operacional.
27
+ - [x] AC-6: `npm run project:check` valida o framework raiz quando chamado sem projeto.
28
+
29
+ ## 5. Escopo
30
+ **Dentro**:
31
+ - Scripts de sprint e GSD.
32
+ - Check de governanca do projeto raiz.
33
+ - Documentacao de operacao CLI-first.
34
+ - Reducao de ruido visual no CLI principal.
35
+
36
+ **Fora**:
37
+ - Remover fisicamente o dashboard.
38
+ - Reescrever frontend.
39
+ - Alterar SQLite ou schema de handoffs.
40
+
41
+ ## 6. NFRs / restricoes
42
+ - Compatibilidade: manter comandos existentes.
43
+ - Operabilidade: saida de terminal simples, sem depender de browser.
44
+ - Governanca: preservar ADR-0005 e fluxo SDD.
45
+
46
+ ## 7. Riscos e mitigacao
47
+ | Risco | Probabilidade | Impacto | Mitigacao |
48
+ |---|---|---|---|
49
+ | Usuarios ainda abrirem dashboard por habito | M | B | README e AGENTS priorizam CLI-first |
50
+ | Sprint duplicar itens de backlog RICE | B | B | Tabela RICE nao e removida; sprint vira selecao operacional |
51
+
52
+ ## 8. Metricas de sucesso
53
+ Em 30 dias, 90% das execucoes de sprint e handoff devem ser feitas por CLI, com `gsd:check` e `project:check` usados antes de entrega.