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,141 +1,141 @@
1
- # Política de Contexto & Gestão de Memória
2
-
3
- ## 1. Estrutura de Níveis
4
-
5
- A memória está organizada em 10 níveis que crescem em especificidade:
6
-
7
- | Nível | Escopo | Uso |
8
- |-------|--------|-----|
9
- | 00 | Global | Mission, patterns, policies |
10
- | 10 | Product | Visão, personas, regras |
11
- | 20 | Architecture | Decisões técnicas |
12
- | 30 | Domains | Context por domínio de negócio |
13
- | 40 | Delivery | Roadmap, sprints |
14
- | 50 | Orchestration | Topologia de agents |
15
- | 60 | Runs | Logs de execução |
16
- | 70 | Summaries | Sínteses executivas |
17
- | 80 | Data | Schemas, migrations |
18
- | 90 | Decisions | ADRs (Architecture Decision Records) |
19
-
20
- ## 2. Fluxo de Leitura de Context
21
-
22
- **Ordem de prioridade** para agente decidir ação:
23
- 1. Domínio específico (30-domains/X/)
24
- 2. Architecture decisão (20-architecture/)
25
- 3. Padrões globais (00-global/patterns.md)
26
- 4. Regras de produto (10-product/business-rules.md)
27
-
28
- **Exemplo**: Para implementar "upgrade de subscription":
29
- 1. Ler `30-domains/subscriptions/context.md` (o que é upgrade aqui)
30
- 2. Ler `30-domains/billing/context.md` (impacto no billing)
31
- 3. Ler `20-architecture/backend.md` (padrão de implementação)
32
- 4. Aplicar padrão de service/controller de `patterns.md`
33
-
34
- ## 3. Gestão de Estado em Runs
35
-
36
- Cada execução de agente registra:
37
-
38
- ```
39
- 60-runs/
40
- ├── 2024-01-15-auth-setup.md
41
- ├── 2024-01-15-subscription-endpoint.md
42
- └── index.md (lista de todas as runs)
43
- ```
44
-
45
- **Formato de run:**
46
- ```markdown
47
- # Auth Setup - 2024-01-15 10:30:00
48
-
49
- ## Agente
50
- Setup Agent
51
-
52
- ## Tarefa
53
- Inicializar módulo de autenticação
54
-
55
- ## Output
56
- - ✅ JWT config criado
57
- - ✅ Local strategy implementada
58
- - ✅ Login endpoint funcional
59
-
60
- ## Issues
61
- - Nenhum
62
-
63
- ## Próximos passos
64
- - Implementar refresh token
65
- ```
66
-
67
- ## 4. Atualização de Summaries
68
-
69
- **Global summary** (`70-summaries/global.md`):
70
- - Atualizado diariamente
71
- - Lista funcionalidades implementadas
72
- - Identifica bloqueadores
73
-
74
- **Domain summaries** (`70-summaries/{domain}.md`):
75
- - Atualizado quando módulo completa feature
76
- - Estado de cada endpoint
77
- - Issues conhecidas
78
-
79
- ## 5. Versionamento de Memória
80
-
81
- Quando política muda:
82
- 1. Criar ADR em `90-decisions/adr-YYYYMMDD-{titulo}.md`
83
- 2. Atualizar arquivo afetado com timestamp
84
- 3. Registrar em `90-decisions/index.md`
85
-
86
- **Exemplo de ADR:**
87
- ```
88
- # ADR-20240115-001: JWT expiry strategy
89
-
90
- ## Context
91
- Tokens devem expirar, mas user experience deve ser suave
92
-
93
- ## Decision
94
- - Access token: 15 minutos
95
- - Refresh token: 7 dias
96
- - Silent refresh em background
97
-
98
- ## Consequences
99
- - Melhor segurança, mais chamadas à API
100
- - Melhor UX com refresh automático
101
- ```
102
-
103
- ## 6. Quem Atualiza Cada Seção
104
-
105
- | Seção | Quem |
106
- |-------|-----|
107
- | 00-global | Tech lead, architect |
108
- | 10-product | Product manager, PO |
109
- | 20-architecture | Tech lead |
110
- | 30-domains | Agentes de domínio |
111
- | 40-delivery | Scrum master, tech lead |
112
- | 50-orchestration | Tech lead, setup agent |
113
- | 60-runs | Cada agente após execução |
114
- | 70-summaries | Summary agent (rotina diária) |
115
- | 80-data | Data agent, migrations |
116
- | 90-decisions | Tech lead, architect |
117
-
118
- ## 7. Context Freshness
119
-
120
- **Staleness rules:**
121
- - Padrões (00-global): OK até 3 meses sem atualização
122
- - Domain context (30-domains): AVISO se > 1 sprint
123
- - Runs (60-runs): OBRIGATÓRIO após cada execução
124
- - Summaries: AVISO se > 1 dia
125
- - Decisions: Nunca ficam obsoletos (imutáveis)
126
-
127
- ## 8. Limpeza de Contexto
128
-
129
- Trimestral:
130
- 1. Arquivar runs antigas (60-runs → 60-runs/archive/)
131
- 2. Consolidar learnings em 70-summaries
132
- 3. Atualizar ADRs obsoletos
133
- 4. Verificar alinhamento de 10-product com 30-domains
134
-
135
- ## 9. Conflitos de Contexto
136
-
137
- Se dois documentos dizem coisas diferentes:
138
- 1. Ordem de precedência: Decisão > Domain > Architecture > Pattern
139
- 2. ADR mais recente vence
140
- 3. Registrar conflito em `90-decisions/conflicts.md`
141
- 4. Resolver em pair programming ou architecture review
1
+ # Política de Contexto & Gestão de Memória
2
+
3
+ ## 1. Estrutura de Níveis
4
+
5
+ A memória está organizada em 10 níveis que crescem em especificidade:
6
+
7
+ | Nível | Escopo | Uso |
8
+ |-------|--------|-----|
9
+ | 00 | Global | Mission, patterns, policies |
10
+ | 10 | Product | Visão, personas, regras |
11
+ | 20 | Architecture | Decisões técnicas |
12
+ | 30 | Domains | Context por domínio de negócio |
13
+ | 40 | Delivery | Roadmap, sprints |
14
+ | 50 | Orchestration | Topologia de agents |
15
+ | 60 | Runs | Logs de execução |
16
+ | 70 | Summaries | Sínteses executivas |
17
+ | 80 | Data | Schemas, migrations |
18
+ | 90 | Decisions | ADRs (Architecture Decision Records) |
19
+
20
+ ## 2. Fluxo de Leitura de Context
21
+
22
+ **Ordem de prioridade** para agente decidir ação:
23
+ 1. Domínio específico (30-domains/X/)
24
+ 2. Architecture decisão (20-architecture/)
25
+ 3. Padrões globais (00-global/patterns.md)
26
+ 4. Regras de produto (10-product/business-rules.md)
27
+
28
+ **Exemplo**: Para implementar "upgrade de subscription":
29
+ 1. Ler `30-domains/subscriptions/context.md` (o que é upgrade aqui)
30
+ 2. Ler `30-domains/billing/context.md` (impacto no billing)
31
+ 3. Ler `20-architecture/backend.md` (padrão de implementação)
32
+ 4. Aplicar padrão de service/controller de `patterns.md`
33
+
34
+ ## 3. Gestão de Estado em Runs
35
+
36
+ Cada execução de agente registra:
37
+
38
+ ```
39
+ 60-runs/
40
+ ├── 2024-01-15-auth-setup.md
41
+ ├── 2024-01-15-subscription-endpoint.md
42
+ └── index.md (lista de todas as runs)
43
+ ```
44
+
45
+ **Formato de run:**
46
+ ```markdown
47
+ # Auth Setup - 2024-01-15 10:30:00
48
+
49
+ ## Agente
50
+ Setup Agent
51
+
52
+ ## Tarefa
53
+ Inicializar módulo de autenticação
54
+
55
+ ## Output
56
+ - ✅ JWT config criado
57
+ - ✅ Local strategy implementada
58
+ - ✅ Login endpoint funcional
59
+
60
+ ## Issues
61
+ - Nenhum
62
+
63
+ ## Próximos passos
64
+ - Implementar refresh token
65
+ ```
66
+
67
+ ## 4. Atualização de Summaries
68
+
69
+ **Global summary** (`70-summaries/global.md`):
70
+ - Atualizado diariamente
71
+ - Lista funcionalidades implementadas
72
+ - Identifica bloqueadores
73
+
74
+ **Domain summaries** (`70-summaries/{domain}.md`):
75
+ - Atualizado quando módulo completa feature
76
+ - Estado de cada endpoint
77
+ - Issues conhecidas
78
+
79
+ ## 5. Versionamento de Memória
80
+
81
+ Quando política muda:
82
+ 1. Criar ADR em `90-decisions/adr-YYYYMMDD-{titulo}.md`
83
+ 2. Atualizar arquivo afetado com timestamp
84
+ 3. Registrar em `90-decisions/index.md`
85
+
86
+ **Exemplo de ADR:**
87
+ ```
88
+ # ADR-20240115-001: JWT expiry strategy
89
+
90
+ ## Context
91
+ Tokens devem expirar, mas user experience deve ser suave
92
+
93
+ ## Decision
94
+ - Access token: 15 minutos
95
+ - Refresh token: 7 dias
96
+ - Silent refresh em background
97
+
98
+ ## Consequences
99
+ - Melhor segurança, mais chamadas à API
100
+ - Melhor UX com refresh automático
101
+ ```
102
+
103
+ ## 6. Quem Atualiza Cada Seção
104
+
105
+ | Seção | Quem |
106
+ |-------|-----|
107
+ | 00-global | Tech lead, architect |
108
+ | 10-product | Product manager, PO |
109
+ | 20-architecture | Tech lead |
110
+ | 30-domains | Agentes de domínio |
111
+ | 40-delivery | Scrum master, tech lead |
112
+ | 50-orchestration | Tech lead, setup agent |
113
+ | 60-runs | Cada agente após execução |
114
+ | 70-summaries | Summary agent (rotina diária) |
115
+ | 80-data | Data agent, migrations |
116
+ | 90-decisions | Tech lead, architect |
117
+
118
+ ## 7. Context Freshness
119
+
120
+ **Staleness rules:**
121
+ - Padrões (00-global): OK até 3 meses sem atualização
122
+ - Domain context (30-domains): AVISO se > 1 sprint
123
+ - Runs (60-runs): OBRIGATÓRIO após cada execução
124
+ - Summaries: AVISO se > 1 dia
125
+ - Decisions: Nunca ficam obsoletos (imutáveis)
126
+
127
+ ## 8. Limpeza de Contexto
128
+
129
+ Trimestral:
130
+ 1. Arquivar runs antigas (60-runs → 60-runs/archive/)
131
+ 2. Consolidar learnings em 70-summaries
132
+ 3. Atualizar ADRs obsoletos
133
+ 4. Verificar alinhamento de 10-product com 30-domains
134
+
135
+ ## 9. Conflitos de Contexto
136
+
137
+ Se dois documentos dizem coisas diferentes:
138
+ 1. Ordem de precedência: Decisão > Domain > Architecture > Pattern
139
+ 2. ADR mais recente vence
140
+ 3. Registrar conflito em `90-decisions/conflicts.md`
141
+ 4. Resolver em pair programming ou architecture review
@@ -1,133 +1,133 @@
1
- # Índice de Memória - SaaS Starter
2
-
3
- ## Navegação Rápida
4
-
5
- ### 00-Global (Políticas & Princípios)
6
- - **[mission.md](./mission.md)** — Visão, objetivos, papéis de agentes
7
- - **[patterns.md](./patterns.md)** — Code patterns, conventions, testing
8
- - **[context-policy.md](./context-policy.md)** — Gestão de níveis, freshness, limpeza
9
- - **[agent-contract.md](./agent-contract.md)** — Ciclo de vida, responsabilidades, handoffs
10
- - **[index.md](./index.md)** — Este arquivo
11
-
12
- ### 10-Product (Visão & Regras)
13
- - **vision.md** — Proposta de valor, diferencial
14
- - **personas.md** — Buyer persona, user scenarios
15
- - **business-rules.md** — Rules engine, compliance
16
- - **nfrs.md** — Performance, scalability, security requirements
17
-
18
- ### 20-Architecture (Decisões Técnicas)
19
- - **overview.md** — Diagrama de arquitetura, stack
20
- - **frontend.md** — Stack frontend, componentes, state
21
- - **backend.md** — NestJS, modules, database strategy
22
- - **data.md** — PostgreSQL schema, indexing strategy
23
- - **security.md** — JWT, RBAC, encryption, PII
24
- - **observability.md** — Logging, metrics, tracing
25
-
26
- ### 30-Domains (Domínios de Negócio)
27
- - **auth/context.md** — O que é auth aqui, fluxo
28
- - **auth/api.md** — Endpoints, contratos, errors
29
- - **subscriptions/context.md** — Planos, transições, regras
30
- - **subscriptions/api.md** — Endpoints de subscriptions
31
- - **billing/context.md** — Pagamentos, invoices, refunds
32
- - **billing/api.md** — Endpoints de billing
33
-
34
- ### 40-Delivery (Roadmap & Sprints)
35
- - **roadmap.md** — 6+ months vision
36
- - **sprint-atual.md** — Sprint atual, tasks, burndown
37
- - **backlog.md** — Product backlog, priorização
38
-
39
- ### 50-Orchestration (Topologia de Agents)
40
- - **topology.md** — Quais agents, quando, em que ordem
41
- - **routing.md** — Como agentes se descobrem
42
- - **handoff-protocol.md** — Formato, timing, escalation
43
- - **playbook-paralelo.md** — Como executar 2+ agents em paralelo
44
- - **handoffs/ directory** — Histórico de handoffs
45
-
46
- ### 60-Runs (Logs de Execução)
47
- - **index.md** — Lista de todas as runs
48
- - **YYYY-MM-DD-agent-task.md** — Run log individual
49
- - **YYYY-MM-DD-ERROR.md** — Logs de erro
50
-
51
- ### 70-Summaries (Sínteses Executivas)
52
- - **global.md** — Status geral, funcionalidades implementadas, bloqueadores
53
- - **auth.md** — Status módulo auth, endpoints ready
54
- - **subscriptions.md** — Status subscriptions, issues
55
- - **billing.md** — Status billing, payment gateway
56
-
57
- ### 80-Data (Schemas & Migrations)
58
- - **schema.md** — Entidades PostgreSQL, relationships
59
- - **migrations/ directory** — Histórico de migrations
60
- - **seeds/ directory** — Seed data
61
-
62
- ### 90-Decisions (ADRs - Architecture Decision Records)
63
- - **adr-template.md** — Template para novas decisões
64
- - **adr-YYYYMMDD-*.md** — Decisões arquiteturais
65
- - **index.md** — Índice de ADRs
66
- - **conflicts.md** — Conflitos e resoluções
67
-
68
- ## Fluxo de Leitura por Cenário
69
-
70
- ### Cenário 1: Novo agente começa tarefa
71
- 1. Ler level 30 (domain específico)
72
- 2. Ler level 20 (architecture)
73
- 3. Ler level 00 (patterns)
74
- 4. Verificar 40-delivery para status
75
- 5. Executar tarefa
76
- 6. Documentar em 60-runs
77
-
78
- ### Cenário 2: Debug de issue
79
- 1. Procurar em 60-runs (problema similar?)
80
- 2. Verificar ADR em 90-decisions (decisão relevante?)
81
- 3. Consultar domain context em 30-domains
82
- 4. Criar ADR se nova decisão necessária
83
-
84
- ### Cenário 3: Atualizar visão de produto
85
- 1. Editar 10-product/
86
- 2. Criar ADR em 90-decisions
87
- 3. Registrar em 70-summaries/global.md
88
-
89
- ### Cenário 4: Escalação de bloqueador
90
- 1. Documentar issue em 60-runs/ERROR.md
91
- 2. Registrar dependência em 40-delivery/backlog.md
92
- 3. Criar ADR se decisão necessária
93
- 4. Notificar responsável
94
-
95
- ## Queries Rápidas
96
-
97
- **"Qual é o status do auth module?"**
98
- → Ler `70-summaries/auth.md`
99
-
100
- **"Como implementar novo endpoint?"**
101
- → Ler `00-global/patterns.md` + `20-architecture/backend.md`
102
-
103
- **"Qual é o próximo agente?"**
104
- → Ler `40-delivery/sprint-atual.md` + `50-orchestration/topology.md`
105
-
106
- **"Por que escolhemos PostgreSQL?"**
107
- → Buscar ADR em `90-decisions/`
108
-
109
- **"O que significa tenant isolation?"**
110
- → Ler `20-architecture/security.md` + `30-domains/auth/context.md`
111
-
112
- **"Como fazer handoff?"**
113
- → Ler `50-orchestration/handoff-protocol.md` (template em `agent-contract.md`)
114
-
115
- ## Atualização Frequência
116
-
117
- | Nível | Frequência | Responsável |
118
- |-------|-----------|-------------|
119
- | 00 | Trimestral | Tech lead |
120
- | 10 | Mensal | Product |
121
- | 20 | Conforme necessário | Tech lead |
122
- | 30 | Cada agente concluindo | Agentes |
123
- | 40 | Semanal | Scrum master |
124
- | 50 | Cada handoff | Agente completando |
125
- | 60 | Cada execução | Agente executando |
126
- | 70 | Diário | Summary agent |
127
- | 80 | Com migrations | Data agent |
128
- | 90 | Decisões imutáveis | Tech lead |
129
-
130
- ## Last Updated
131
- - **Date**: 2024-01-15
132
- - **By**: SaaS Starter Scaffold
133
- - **Next Review**: 2024-02-15
1
+ # Índice de Memória - SaaS Starter
2
+
3
+ ## Navegação Rápida
4
+
5
+ ### 00-Global (Políticas & Princípios)
6
+ - **[mission.md](./mission.md)** — Visão, objetivos, papéis de agentes
7
+ - **[patterns.md](./patterns.md)** — Code patterns, conventions, testing
8
+ - **[context-policy.md](./context-policy.md)** — Gestão de níveis, freshness, limpeza
9
+ - **[agent-contract.md](./agent-contract.md)** — Ciclo de vida, responsabilidades, handoffs
10
+ - **[index.md](./index.md)** — Este arquivo
11
+
12
+ ### 10-Product (Visão & Regras)
13
+ - **vision.md** — Proposta de valor, diferencial
14
+ - **personas.md** — Buyer persona, user scenarios
15
+ - **business-rules.md** — Rules engine, compliance
16
+ - **nfrs.md** — Performance, scalability, security requirements
17
+
18
+ ### 20-Architecture (Decisões Técnicas)
19
+ - **overview.md** — Diagrama de arquitetura, stack
20
+ - **frontend.md** — Stack frontend, componentes, state
21
+ - **backend.md** — NestJS, modules, database strategy
22
+ - **data.md** — PostgreSQL schema, indexing strategy
23
+ - **security.md** — JWT, RBAC, encryption, PII
24
+ - **observability.md** — Logging, metrics, tracing
25
+
26
+ ### 30-Domains (Domínios de Negócio)
27
+ - **auth/context.md** — O que é auth aqui, fluxo
28
+ - **auth/api.md** — Endpoints, contratos, errors
29
+ - **subscriptions/context.md** — Planos, transições, regras
30
+ - **subscriptions/api.md** — Endpoints de subscriptions
31
+ - **billing/context.md** — Pagamentos, invoices, refunds
32
+ - **billing/api.md** — Endpoints de billing
33
+
34
+ ### 40-Delivery (Roadmap & Sprints)
35
+ - **roadmap.md** — 6+ months vision
36
+ - **sprint-atual.md** — Sprint atual, tasks, burndown
37
+ - **backlog.md** — Product backlog, priorização
38
+
39
+ ### 50-Orchestration (Topologia de Agents)
40
+ - **topology.md** — Quais agents, quando, em que ordem
41
+ - **routing.md** — Como agentes se descobrem
42
+ - **handoff-protocol.md** — Formato, timing, escalation
43
+ - **playbook-paralelo.md** — Como executar 2+ agents em paralelo
44
+ - **handoffs/ directory** — Histórico de handoffs
45
+
46
+ ### 60-Runs (Logs de Execução)
47
+ - **index.md** — Lista de todas as runs
48
+ - **YYYY-MM-DD-agent-task.md** — Run log individual
49
+ - **YYYY-MM-DD-ERROR.md** — Logs de erro
50
+
51
+ ### 70-Summaries (Sínteses Executivas)
52
+ - **global.md** — Status geral, funcionalidades implementadas, bloqueadores
53
+ - **auth.md** — Status módulo auth, endpoints ready
54
+ - **subscriptions.md** — Status subscriptions, issues
55
+ - **billing.md** — Status billing, payment gateway
56
+
57
+ ### 80-Data (Schemas & Migrations)
58
+ - **schema.md** — Entidades PostgreSQL, relationships
59
+ - **migrations/ directory** — Histórico de migrations
60
+ - **seeds/ directory** — Seed data
61
+
62
+ ### 90-Decisions (ADRs - Architecture Decision Records)
63
+ - **adr-template.md** — Template para novas decisões
64
+ - **adr-YYYYMMDD-*.md** — Decisões arquiteturais
65
+ - **index.md** — Índice de ADRs
66
+ - **conflicts.md** — Conflitos e resoluções
67
+
68
+ ## Fluxo de Leitura por Cenário
69
+
70
+ ### Cenário 1: Novo agente começa tarefa
71
+ 1. Ler level 30 (domain específico)
72
+ 2. Ler level 20 (architecture)
73
+ 3. Ler level 00 (patterns)
74
+ 4. Verificar 40-delivery para status
75
+ 5. Executar tarefa
76
+ 6. Documentar em 60-runs
77
+
78
+ ### Cenário 2: Debug de issue
79
+ 1. Procurar em 60-runs (problema similar?)
80
+ 2. Verificar ADR em 90-decisions (decisão relevante?)
81
+ 3. Consultar domain context em 30-domains
82
+ 4. Criar ADR se nova decisão necessária
83
+
84
+ ### Cenário 3: Atualizar visão de produto
85
+ 1. Editar 10-product/
86
+ 2. Criar ADR em 90-decisions
87
+ 3. Registrar em 70-summaries/global.md
88
+
89
+ ### Cenário 4: Escalação de bloqueador
90
+ 1. Documentar issue em 60-runs/ERROR.md
91
+ 2. Registrar dependência em 40-delivery/backlog.md
92
+ 3. Criar ADR se decisão necessária
93
+ 4. Notificar responsável
94
+
95
+ ## Queries Rápidas
96
+
97
+ **"Qual é o status do auth module?"**
98
+ → Ler `70-summaries/auth.md`
99
+
100
+ **"Como implementar novo endpoint?"**
101
+ → Ler `00-global/patterns.md` + `20-architecture/backend.md`
102
+
103
+ **"Qual é o próximo agente?"**
104
+ → Ler `40-delivery/sprint-atual.md` + `50-orchestration/topology.md`
105
+
106
+ **"Por que escolhemos PostgreSQL?"**
107
+ → Buscar ADR em `90-decisions/`
108
+
109
+ **"O que significa tenant isolation?"**
110
+ → Ler `20-architecture/security.md` + `30-domains/auth/context.md`
111
+
112
+ **"Como fazer handoff?"**
113
+ → Ler `50-orchestration/handoff-protocol.md` (template em `agent-contract.md`)
114
+
115
+ ## Atualização Frequência
116
+
117
+ | Nível | Frequência | Responsável |
118
+ |-------|-----------|-------------|
119
+ | 00 | Trimestral | Tech lead |
120
+ | 10 | Mensal | Product |
121
+ | 20 | Conforme necessário | Tech lead |
122
+ | 30 | Cada agente concluindo | Agentes |
123
+ | 40 | Semanal | Scrum master |
124
+ | 50 | Cada handoff | Agente completando |
125
+ | 60 | Cada execução | Agente executando |
126
+ | 70 | Diário | Summary agent |
127
+ | 80 | Com migrations | Data agent |
128
+ | 90 | Decisões imutáveis | Tech lead |
129
+
130
+ ## Last Updated
131
+ - **Date**: 2024-01-15
132
+ - **By**: SaaS Starter Scaffold
133
+ - **Next Review**: 2024-02-15
@@ -1,45 +1,45 @@
1
- # Missão do Projeto SaaS Starter
2
-
3
- ## Visão Geral
4
-
5
- Fornecer uma plataforma SaaS multi-tenant, escalável e pronta para produção que:
6
-
7
- 1. **Autenticação & Autorização**: JWT-based com RBAC (roles: owner, admin, member)
8
- 2. **Subscription Management**: Planos (free, pro, enterprise) com gerenciamento automático
9
- 3. **Billing & Payments**: Integração mock com sistemas de pagamento (Stripe-like)
10
- 4. **Multi-Tenancy**: Isolamento seguro de dados por organização
11
- 5. **Observabilidade**: Logs estruturados e métricas para decisões operacionais
12
-
13
- ## Princípios Fundamentais
14
-
15
- | Princípio | Descrição |
16
- |-----------|-----------|
17
- | **Multi-Tenant First** | Cada organização é isolada em camada de data e contexto |
18
- | **Security by Default** | JWT + Rate limiting + Input validation em todas as rotas |
19
- | **Scalability Ready** | Arquitetura preparada para PostgreSQL + Redis |
20
- | **Developer Experience** | NestJS + TypeScript com tipagem forte e injeção de dependências |
21
- | **Testabilidade** | Testes E2E para fluxos críticos (auth, subscriptions, billing) |
22
-
23
- ## Objetivos Imediatos
24
-
25
- 1. Gerar scaffold completo com módulos SaaS funcionais
26
- 2. Fornecer exemplos de endpoints para Auth, Subscriptions e Billing
27
- 3. Documentar fluxos de signup, subscription upgrade, e pagamento
28
- 4. Incluir testes E2E para os fluxos críticos
29
- 5. Docker-compose com PostgreSQL + Redis preconfigurado
30
-
31
- ## Papéis de Agentes
32
-
33
- | Agente | Responsabilidade |
34
- |--------|-----------------|
35
- | **Setup Agent** | Inicializar projeto, criar schemas, seedar dados |
36
- | **Auth Agent** | Validar JWT, gerenciar permissões RBAC |
37
- | **Subscription Agent** | Gerenciar planos e upgrades |
38
- | **Billing Agent** | Processar pagamentos (mock) e gerar invoices |
39
- | **Analytics Agent** | Rastrear eventos de negócio e métricas |
40
-
41
- ## Status
42
-
43
- - ✅ Estrutura de memória criada
44
- - ✅ Backend NestJS inicializado
45
- - 🚀 Pronto para integração de agents
1
+ # Missão do Projeto SaaS Starter
2
+
3
+ ## Visão Geral
4
+
5
+ Fornecer uma plataforma SaaS multi-tenant, escalável e pronta para produção que:
6
+
7
+ 1. **Autenticação & Autorização**: JWT-based com RBAC (roles: owner, admin, member)
8
+ 2. **Subscription Management**: Planos (free, pro, enterprise) com gerenciamento automático
9
+ 3. **Billing & Payments**: Integração mock com sistemas de pagamento (Stripe-like)
10
+ 4. **Multi-Tenancy**: Isolamento seguro de dados por organização
11
+ 5. **Observabilidade**: Logs estruturados e métricas para decisões operacionais
12
+
13
+ ## Princípios Fundamentais
14
+
15
+ | Princípio | Descrição |
16
+ |-----------|-----------|
17
+ | **Multi-Tenant First** | Cada organização é isolada em camada de data e contexto |
18
+ | **Security by Default** | JWT + Rate limiting + Input validation em todas as rotas |
19
+ | **Scalability Ready** | Arquitetura preparada para PostgreSQL + Redis |
20
+ | **Developer Experience** | NestJS + TypeScript com tipagem forte e injeção de dependências |
21
+ | **Testabilidade** | Testes E2E para fluxos críticos (auth, subscriptions, billing) |
22
+
23
+ ## Objetivos Imediatos
24
+
25
+ 1. Gerar scaffold completo com módulos SaaS funcionais
26
+ 2. Fornecer exemplos de endpoints para Auth, Subscriptions e Billing
27
+ 3. Documentar fluxos de signup, subscription upgrade, e pagamento
28
+ 4. Incluir testes E2E para os fluxos críticos
29
+ 5. Docker-compose com PostgreSQL + Redis preconfigurado
30
+
31
+ ## Papéis de Agentes
32
+
33
+ | Agente | Responsabilidade |
34
+ |--------|-----------------|
35
+ | **Setup Agent** | Inicializar projeto, criar schemas, seedar dados |
36
+ | **Auth Agent** | Validar JWT, gerenciar permissões RBAC |
37
+ | **Subscription Agent** | Gerenciar planos e upgrades |
38
+ | **Billing Agent** | Processar pagamentos (mock) e gerar invoices |
39
+ | **Analytics Agent** | Rastrear eventos de negócio e métricas |
40
+
41
+ ## Status
42
+
43
+ - ✅ Estrutura de memória criada
44
+ - ✅ Backend NestJS inicializado
45
+ - 🚀 Pronto para integração de agents