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,268 +1,268 @@
1
- # 🎯 Sumário Executivo - Refinamento de Agentes Orquestrados
2
-
3
- **Data**: 2026-04-26 | **Status**: Operação & Visibilidade Ativados | **Versão**: 1.2
4
-
5
- ---
6
-
7
- ## 📌 O Que Foi Feito
8
-
9
- Evolução do kit para o nível **Elite Ops (v0.4.0)**, focando em autonomia de agentes, orquestramento dinâmico e redução de desperdício de contexto.
10
-
11
- ### Documentos Criados / Atualizados
12
-
13
- | Documento | Tamanho | Propósito |
14
- |-----------|---------|----------|
15
- | **REFINAMENTO-v1.0.md** | 16 KB | Especificação completa de 8 áreas (38 items) |
16
- | **IMPLEMENTACAO-FASE1.md** | 10 KB | Guia prático passo-a-passo para Semanas 1-2 |
17
- | **DASHBOARD-PROGRESSO.md** | 5 KB | Rastreamento visual do progresso |
18
- | **plan.md** (session) | 2 KB | Resumo do plano de melhoras |
19
- | **BD de Tracking** | - | 8 tabelas com 38 items + 5 decisões |
20
-
21
- ---
22
-
23
- ## 🎯 8 Áreas de Melhoria (Prioridade)
24
-
25
- ### Tier 1 (CRÍTICO - Fazer Primeiro)
26
-
27
- 1. **Qualidade & Segurança** (SEC)
28
- - Validação obrigatória, rate-limiting, sanitização, testes 80%
29
- - **Impact**: Reduz vulnerabilidades, aumenta confiança
30
-
31
- 2. **Design de Agentes** (AGENT)
32
- - Especificação estruturada, prompts com few-shot, handoff 7-campos, roteamento, JSON Schema
33
- - **Impact**: Agentes mais precisos, menos alucinação
34
-
35
- 3. **Otimização para IAs** (AI-OPT)
36
- - Context packing model-aware, Instruction Bundle, config YAML, inline links, strict mode
37
- - **Impact**: +30-50% qualidade de resposta das IAs
38
-
39
- 4. **ADR & Decisões** (ADR)
40
- - Estrutura robusta, versionamento, rastreamento em BD, integração com handoff
41
- - **Impact**: Rastreabilidade completa, fácil revisar decisões
42
-
43
- 5. **Gestão de Memória** (MEM)
44
- - 3 níveis de compactação, preservation de estrutura, handoff mínimo, recovery inteligente, análise de creep
45
- - **Impact**: Menos perda de contexto, melhor continuidade
46
-
47
- ### Tier 1.5 (ELITE - Autonomia)
48
-
49
- 6. **Auto-Diagnóstico (Self-Healing)**
50
- - Skill para resolver erros de build/teste sem humano.
51
- - **Impact**: Reduz fricção em loops de dev 24/7.
52
-
53
- 7. **Orquestramento Dinâmico**
54
- - Manifesto de skills (JSON) para descoberta de ferramentas.
55
- - **Impact**: Extensibilidade total sem mudar prompts.
56
-
57
- 8. **Memory Vacuum (TTL)**
58
- - Limpeza automática de logs antigos.
59
- - **Impact**: Tokens focados no presente, redução de custos.
60
-
61
- 9. **Fidelidade Visual (design-md)**
62
- - Auditoria estética baseada em referências mundiais.
63
- - **Impact**: Frontend gerado com qualidade visual premium.
64
-
65
- 10. **Agent State Machine**
66
- - Rastreamento de status (Idle, Busy, Failing) no SQLite.
67
- - **Impact**: Coordenação perfeita sem conflitos.
68
-
69
- ### Tier 1.6 (OPS - Visibilidade)
70
-
71
- 11. **Dashboard Operacional (/ops)**
72
- - Interface web para monitorar agentes e tarefas em tempo real.
73
- - **Impact**: Transparência total sobre o que as IAs estão fazendo.
74
-
75
- 12. **Raciocínio Estruturado (CoT)**
76
- - Protocolo obrigatório de análise antes de qualquer código.
77
- - **Impact**: Redução drástica em erros de lógica e atenção.
78
-
79
- 13. **Auto-Sync (Memory Watcher)**
80
- - Sincronização automática do SQLite ao salvar arquivos .md.
81
- - **Impact**: Base de conhecimento sempre atualizada sem esforço manual.
82
-
83
- ### Tier 2 (IMPORTANTE - Depois)
84
-
85
- 6. **Documentação de Produto** (DOC)
86
- - Estrutura Stripe/Vercel, padrão escrita, diagramas, changelog, contributing guide
87
- - **Impact**: Onboarding profissional, adoção mais fácil
88
-
89
- 7. **Metodologia Ágil** (AGILE)
90
- - Sprint template, Definition of Done, ceremônias, matriz rastreamento, release notes
91
- - **Impact**: Entregas previsíveis, menos surpresas
92
-
93
- 8. **Observabilidade** (OBS)
94
- - Logs estruturados, decorator, métricas, tracing handoff, dashboard
95
- - **Impact**: Visibilidade operacional, debugging mais rápido
96
-
97
- ---
98
-
99
- ## 📊 Números-Chave
100
-
101
- | Métrica | Baseline | Target (Elite) |
102
- |---------|----------|----------------|
103
- | Items de Melhoria | 38 | 45 |
104
- | Áreas Cobertas | 8 | 9 |
105
- | Nível de Documentação | Básico | Profissional (Stripe-like) |
106
- | Autonomia (healing) | 0% | ~40% de erros comuns |
107
- | Fidelidade de UI | Manual | Auditada vs design-md |
108
- | Desperdício contexto | Alto | Otimizado via Vacuum |
109
- | Validação de Input | Parcial | 100% com DTOs |
110
- | Coverage de Testes | <50% | >80% |
111
- | Segurança (OWASP) | Baixa | Rate-limit, sanitização, logs |
112
- | Rastreamento ADR | Nenhum | 100% em BD |
113
- | Context Packing | Genérico | Model-aware (Claude/GPT-4/Gemini) |
114
- | Qualidade de Prompts | Genéricos | Few-shot + Instruction Bundle |
115
- | Observabilidade | Nenhuma | Logs JSON + métricas + tracing |
116
-
117
- ---
118
-
119
- ## ⏱️ Timeline Estimada
120
-
121
- | Fase | Semanas | Items | Status |
122
- |------|---------|-------|--------|
123
- | **Fase 1** | 1-2 | 38 (Tier 1) | 🟡 Pronto (start now) |
124
- | **Fase 2** | 3-4 | Tier 2 | 🟢 Planned |
125
- | **Fase 3** | 5-6 | Integração | 🟢 Planned |
126
- | **Release** | Semana 6 | v0.3.0 | 🟢 Planned |
127
-
128
- **Esforço Total**: ~80-100 horas (dev experiente), ~120-150 horas (iniciante)
129
-
130
- ---
131
-
132
- ## 💡 Decisões Principais Tomadas
133
-
134
- 1. ✅ **class-validator** para validação (vs. joi) - padrão NestJS
135
- 2. ✅ **JSON Schema** para contratos de agentes - interoperável
136
- 3. ✅ **3 níveis** de compactação - flexibilidade
137
- 4. ✅ **Model-aware** context packing - otimização por IA
138
- 5. ✅ **7 campos obrigatórios** em handoff - qualidade mínima
139
- 6. ✅ **ADR com versionamento** - rastreabilidade completa
140
- 7. ✅ **Logs estruturados em JSON** - parseável e pronto para observabilidade
141
- 8. ✅ **Estrutura Stripe/Vercel** para docs - profissionalismo
142
- 9. ✅ **Skill Manifesto (JSON)**: Descoberta dinâmica vs Hardcoding.
143
- 10. ✅ **Vacuum de 30 dias**: Equilíbrio entre histórico e performance.
144
- 11. ✅ **SQLite State Tracking**: Banco operacional para coordenação.
145
- 12. ✅ **UI-Fidelity Skill**: Integração nativa com a biblioteca `design-md`.
146
- 13. ✅ **Reasoning Protocol (CoT)**: Lógica obrigatória antes de qualquer código.
147
- 14. ✅ **Memory Watcher (fs.watch)**: Sync automático em background.
148
- 15. ✅ **Dashboard Web (/ops)**: Observabilidade em tempo real via NestJS.
149
-
150
- > Todas as decisões estão documentadas em tabela `decisions` no BD para referência futura.
151
-
152
- ---
153
-
154
- ## 🚀 Como Começar (Próximos Passos)
155
-
156
- ### Dia 1-2: Setup
157
- 1. Revisar `REFINAMENTO-v1.0.md` (especificação completa)
158
- 2. Revisar `IMPLEMENTACAO-FASE1.md` (como implementar)
159
- 3. Revisar `DASHBOARD-PROGRESSO.md` (tracking visual)
160
- 4. Preparar ambiente
161
-
162
- ### Dia 3+: Implementação Semana 1
163
- **Começar em paralelo:**
164
- - SEC-001: Validação em rotas
165
- - SEC-002: Rate-limiting
166
- - AGENT-001: Especificação de agentes
167
- - AGENT-002: Prompts melhorados
168
- - AI-OPT-001: Context packing
169
- - ADR-001: Estrutura de ADR
170
- - MEM-001: 3 níveis de compactação
171
- - DOC-001: Reestruturar documentação
172
- - AGILE-001: Sprint template
173
- - OBS-001: Logs estruturados
174
-
175
- ### Validação
176
- ```bash
177
- # Após cada implementação
178
- node bin/create-memory-nest-kit.js /tmp/test-project
179
- cd /tmp/test-project/backend
180
- npm install && npm run build && npm test
181
- ```
182
-
183
- ### Rastreamento
184
- ```sql
185
- -- Ver progresso
186
- SELECT area_id, COUNT(*) total,
187
- SUM(CASE WHEN status='done' THEN 1 ELSE 0 END) as completo
188
- FROM improvement_items
189
- GROUP BY area_id;
190
-
191
- -- Atualizar após completar
192
- UPDATE improvement_items SET status='done' WHERE id='SEC-001';
193
- ```
194
-
195
- ---
196
-
197
- ## 📚 Recursos Disponíveis
198
-
199
- - **Documentação Estruturada**: REFINAMENTO-v1.0.md (8 seções, 16KB)
200
- - **Guia Implementação**: IMPLEMENTACAO-FASE1.md (código pronto, exemplos)
201
- - **BD de Tracking**: 38 items + 5 decisões + queries prontas
202
- - **Copilot Instructions**: `.github/copilot-instructions.md` (já criado)
203
-
204
- ---
205
-
206
- ## ⚡ Quick Wins (Começar HOJE)
207
-
208
- Se tem 2h:
209
- 1. Implementar SEC-001 (validação DTOs) - **30 min**
210
- 2. Implementar SEC-002 (rate-limit) - **30 min**
211
- 3. Implementar OBS-001 (logs JSON) - **30 min**
212
- 4. Gerar projeto novo e testar - **30 min**
213
-
214
- Resultado: 3 items feitos, 38% de progresso = **Momentum!!**
215
-
216
- ---
217
-
218
- ## ✨ Benefício Final
219
-
220
- Após Fase 1 completa (2 semanas):
221
-
222
- ```
223
- Kit v0.3.0 com:
224
-
225
- ✅ Qualidade Enterprise-grade (segurança, validação, testes)
226
- ✅ Design de Agentes Profissional (prompts, especificação, roteamento)
227
- ✅ Otimização Máxima para IAs (Claude: 100k tokens, Gemini: 32k, GPT-4: 8k)
228
- ✅ Rastreabilidade Completa (ADRs, decisões, handoffs no BD)
229
- ✅ Documentação Stripe-like (7 seções, diagrama, tutorial)
230
- ✅ Metodologia Ágil (sprints, DoD, ceremônias)
231
- ✅ Observabilidade Full-Stack (logs, métricas, tracing, dashboard)
232
-
233
- → Diferencial no mercado
234
- → Atrai equipes de alto nível
235
- → Pronto para produção
236
- → Escalável e mantível
237
- ```
238
-
239
- ---
240
-
241
- ## 🎓 Próximas Reuniões
242
-
243
- - **Kickoff Session**: Revisão REFINAMENTO-v1.0.md
244
- - **Semana 1 Checkpoint**: 30% completo?
245
- - **Semana 2 Review**: Tier 1 finalizado?
246
- - **Semana 3 Planning**: Tier 2 + v0.3.0
247
-
248
- ---
249
-
250
- ## 📞 Suporte
251
-
252
- - **Dúvidas sobre spec**: Ver REFINAMENTO-v1.0.md
253
- - **Dúvidas sobre implementação**: Ver IMPLEMENTACAO-FASE1.md
254
- - **Rastreamento**: Ver DASHBOARD-PROGRESSO.md ou query BD
255
- - **Decisões**: Ver tabela `decisions`
256
-
257
- ---
258
-
259
- ## 🎉 Conclusão
260
-
261
- Plano robusto de refinamento pronto para elevar o kit para nível profissional. Documentação estruturada, código pronto, rastreamento automático. **Tempo de começar!**
262
-
263
- ---
264
-
265
- **Aprovado por**: Copilot Analysis System
266
- **Próximo Review**: Fim da Semana 1
267
- **Status**: 🟢 GO (Implementação Autorizada)
268
-
1
+ # 🎯 Sumário Executivo - Refinamento de Agentes Orquestrados
2
+
3
+ **Data**: 2026-04-26 | **Status**: Operação & Visibilidade Ativados | **Versão**: 1.2
4
+
5
+ ---
6
+
7
+ ## 📌 O Que Foi Feito
8
+
9
+ Evolução do kit para o nível **Elite Ops (v0.4.0)**, focando em autonomia de agentes, orquestramento dinâmico e redução de desperdício de contexto.
10
+
11
+ ### Documentos Criados / Atualizados
12
+
13
+ | Documento | Tamanho | Propósito |
14
+ |-----------|---------|----------|
15
+ | **REFINAMENTO-v1.0.md** | 16 KB | Especificação completa de 8 áreas (38 items) |
16
+ | **IMPLEMENTACAO-FASE1.md** | 10 KB | Guia prático passo-a-passo para Semanas 1-2 |
17
+ | **DASHBOARD-PROGRESSO.md** | 5 KB | Rastreamento visual do progresso |
18
+ | **plan.md** (session) | 2 KB | Resumo do plano de melhoras |
19
+ | **BD de Tracking** | - | 8 tabelas com 38 items + 5 decisões |
20
+
21
+ ---
22
+
23
+ ## 🎯 8 Áreas de Melhoria (Prioridade)
24
+
25
+ ### Tier 1 (CRÍTICO - Fazer Primeiro)
26
+
27
+ 1. **Qualidade & Segurança** (SEC)
28
+ - Validação obrigatória, rate-limiting, sanitização, testes 80%
29
+ - **Impact**: Reduz vulnerabilidades, aumenta confiança
30
+
31
+ 2. **Design de Agentes** (AGENT)
32
+ - Especificação estruturada, prompts com few-shot, handoff 7-campos, roteamento, JSON Schema
33
+ - **Impact**: Agentes mais precisos, menos alucinação
34
+
35
+ 3. **Otimização para IAs** (AI-OPT)
36
+ - Context packing model-aware, Instruction Bundle, config YAML, inline links, strict mode
37
+ - **Impact**: +30-50% qualidade de resposta das IAs
38
+
39
+ 4. **ADR & Decisões** (ADR)
40
+ - Estrutura robusta, versionamento, rastreamento em BD, integração com handoff
41
+ - **Impact**: Rastreabilidade completa, fácil revisar decisões
42
+
43
+ 5. **Gestão de Memória** (MEM)
44
+ - 3 níveis de compactação, preservation de estrutura, handoff mínimo, recovery inteligente, análise de creep
45
+ - **Impact**: Menos perda de contexto, melhor continuidade
46
+
47
+ ### Tier 1.5 (ELITE - Autonomia)
48
+
49
+ 6. **Auto-Diagnóstico (Self-Healing)**
50
+ - Skill para resolver erros de build/teste sem humano.
51
+ - **Impact**: Reduz fricção em loops de dev 24/7.
52
+
53
+ 7. **Orquestramento Dinâmico**
54
+ - Manifesto de skills (JSON) para descoberta de ferramentas.
55
+ - **Impact**: Extensibilidade total sem mudar prompts.
56
+
57
+ 8. **Memory Vacuum (TTL)**
58
+ - Limpeza automática de logs antigos.
59
+ - **Impact**: Tokens focados no presente, redução de custos.
60
+
61
+ 9. **Fidelidade Visual (design-md)**
62
+ - Auditoria estética baseada em referências mundiais.
63
+ - **Impact**: Frontend gerado com qualidade visual premium.
64
+
65
+ 10. **Agent State Machine**
66
+ - Rastreamento de status (Idle, Busy, Failing) no SQLite.
67
+ - **Impact**: Coordenação perfeita sem conflitos.
68
+
69
+ ### Tier 1.6 (OPS - Visibilidade)
70
+
71
+ 11. **Dashboard Operacional (/ops)**
72
+ - Interface web para monitorar agentes e tarefas em tempo real.
73
+ - **Impact**: Transparência total sobre o que as IAs estão fazendo.
74
+
75
+ 12. **Raciocínio Estruturado (CoT)**
76
+ - Protocolo obrigatório de análise antes de qualquer código.
77
+ - **Impact**: Redução drástica em erros de lógica e atenção.
78
+
79
+ 13. **Auto-Sync (Memory Watcher)**
80
+ - Sincronização automática do SQLite ao salvar arquivos .md.
81
+ - **Impact**: Base de conhecimento sempre atualizada sem esforço manual.
82
+
83
+ ### Tier 2 (IMPORTANTE - Depois)
84
+
85
+ 6. **Documentação de Produto** (DOC)
86
+ - Estrutura Stripe/Vercel, padrão escrita, diagramas, changelog, contributing guide
87
+ - **Impact**: Onboarding profissional, adoção mais fácil
88
+
89
+ 7. **Metodologia Ágil** (AGILE)
90
+ - Sprint template, Definition of Done, ceremônias, matriz rastreamento, release notes
91
+ - **Impact**: Entregas previsíveis, menos surpresas
92
+
93
+ 8. **Observabilidade** (OBS)
94
+ - Logs estruturados, decorator, métricas, tracing handoff, dashboard
95
+ - **Impact**: Visibilidade operacional, debugging mais rápido
96
+
97
+ ---
98
+
99
+ ## 📊 Números-Chave
100
+
101
+ | Métrica | Baseline | Target (Elite) |
102
+ |---------|----------|----------------|
103
+ | Items de Melhoria | 38 | 45 |
104
+ | Áreas Cobertas | 8 | 9 |
105
+ | Nível de Documentação | Básico | Profissional (Stripe-like) |
106
+ | Autonomia (healing) | 0% | ~40% de erros comuns |
107
+ | Fidelidade de UI | Manual | Auditada vs design-md |
108
+ | Desperdício contexto | Alto | Otimizado via Vacuum |
109
+ | Validação de Input | Parcial | 100% com DTOs |
110
+ | Coverage de Testes | <50% | >80% |
111
+ | Segurança (OWASP) | Baixa | Rate-limit, sanitização, logs |
112
+ | Rastreamento ADR | Nenhum | 100% em BD |
113
+ | Context Packing | Genérico | Model-aware (Claude/GPT-4/Gemini) |
114
+ | Qualidade de Prompts | Genéricos | Few-shot + Instruction Bundle |
115
+ | Observabilidade | Nenhuma | Logs JSON + métricas + tracing |
116
+
117
+ ---
118
+
119
+ ## ⏱️ Timeline Estimada
120
+
121
+ | Fase | Semanas | Items | Status |
122
+ |------|---------|-------|--------|
123
+ | **Fase 1** | 1-2 | 38 (Tier 1) | 🟡 Pronto (start now) |
124
+ | **Fase 2** | 3-4 | Tier 2 | 🟢 Planned |
125
+ | **Fase 3** | 5-6 | Integração | 🟢 Planned |
126
+ | **Release** | Semana 6 | v0.3.0 | 🟢 Planned |
127
+
128
+ **Esforço Total**: ~80-100 horas (dev experiente), ~120-150 horas (iniciante)
129
+
130
+ ---
131
+
132
+ ## 💡 Decisões Principais Tomadas
133
+
134
+ 1. ✅ **class-validator** para validação (vs. joi) - padrão NestJS
135
+ 2. ✅ **JSON Schema** para contratos de agentes - interoperável
136
+ 3. ✅ **3 níveis** de compactação - flexibilidade
137
+ 4. ✅ **Model-aware** context packing - otimização por IA
138
+ 5. ✅ **7 campos obrigatórios** em handoff - qualidade mínima
139
+ 6. ✅ **ADR com versionamento** - rastreabilidade completa
140
+ 7. ✅ **Logs estruturados em JSON** - parseável e pronto para observabilidade
141
+ 8. ✅ **Estrutura Stripe/Vercel** para docs - profissionalismo
142
+ 9. ✅ **Skill Manifesto (JSON)**: Descoberta dinâmica vs Hardcoding.
143
+ 10. ✅ **Vacuum de 30 dias**: Equilíbrio entre histórico e performance.
144
+ 11. ✅ **SQLite State Tracking**: Banco operacional para coordenação.
145
+ 12. ✅ **UI-Fidelity Skill**: Integração nativa com a biblioteca `design-md`.
146
+ 13. ✅ **Reasoning Protocol (CoT)**: Lógica obrigatória antes de qualquer código.
147
+ 14. ✅ **Memory Watcher (fs.watch)**: Sync automático em background.
148
+ 15. ✅ **Dashboard Web (/ops)**: Observabilidade em tempo real via NestJS.
149
+
150
+ > Todas as decisões estão documentadas em tabela `decisions` no BD para referência futura.
151
+
152
+ ---
153
+
154
+ ## 🚀 Como Começar (Próximos Passos)
155
+
156
+ ### Dia 1-2: Setup
157
+ 1. Revisar `REFINAMENTO-v1.0.md` (especificação completa)
158
+ 2. Revisar `IMPLEMENTACAO-FASE1.md` (como implementar)
159
+ 3. Revisar `DASHBOARD-PROGRESSO.md` (tracking visual)
160
+ 4. Preparar ambiente
161
+
162
+ ### Dia 3+: Implementação Semana 1
163
+ **Começar em paralelo:**
164
+ - SEC-001: Validação em rotas
165
+ - SEC-002: Rate-limiting
166
+ - AGENT-001: Especificação de agentes
167
+ - AGENT-002: Prompts melhorados
168
+ - AI-OPT-001: Context packing
169
+ - ADR-001: Estrutura de ADR
170
+ - MEM-001: 3 níveis de compactação
171
+ - DOC-001: Reestruturar documentação
172
+ - AGILE-001: Sprint template
173
+ - OBS-001: Logs estruturados
174
+
175
+ ### Validação
176
+ ```bash
177
+ # Após cada implementação
178
+ node bin/create-memory-nest-kit.js /tmp/test-project
179
+ cd /tmp/test-project/backend
180
+ npm install && npm run build && npm test
181
+ ```
182
+
183
+ ### Rastreamento
184
+ ```sql
185
+ -- Ver progresso
186
+ SELECT area_id, COUNT(*) total,
187
+ SUM(CASE WHEN status='done' THEN 1 ELSE 0 END) as completo
188
+ FROM improvement_items
189
+ GROUP BY area_id;
190
+
191
+ -- Atualizar após completar
192
+ UPDATE improvement_items SET status='done' WHERE id='SEC-001';
193
+ ```
194
+
195
+ ---
196
+
197
+ ## 📚 Recursos Disponíveis
198
+
199
+ - **Documentação Estruturada**: REFINAMENTO-v1.0.md (8 seções, 16KB)
200
+ - **Guia Implementação**: IMPLEMENTACAO-FASE1.md (código pronto, exemplos)
201
+ - **BD de Tracking**: 38 items + 5 decisões + queries prontas
202
+ - **Copilot Instructions**: `.github/copilot-instructions.md` (já criado)
203
+
204
+ ---
205
+
206
+ ## ⚡ Quick Wins (Começar HOJE)
207
+
208
+ Se tem 2h:
209
+ 1. Implementar SEC-001 (validação DTOs) - **30 min**
210
+ 2. Implementar SEC-002 (rate-limit) - **30 min**
211
+ 3. Implementar OBS-001 (logs JSON) - **30 min**
212
+ 4. Gerar projeto novo e testar - **30 min**
213
+
214
+ Resultado: 3 items feitos, 38% de progresso = **Momentum!!**
215
+
216
+ ---
217
+
218
+ ## ✨ Benefício Final
219
+
220
+ Após Fase 1 completa (2 semanas):
221
+
222
+ ```
223
+ Kit v0.3.0 com:
224
+
225
+ ✅ Qualidade Enterprise-grade (segurança, validação, testes)
226
+ ✅ Design de Agentes Profissional (prompts, especificação, roteamento)
227
+ ✅ Otimização Máxima para IAs (Claude: 100k tokens, Gemini: 32k, GPT-4: 8k)
228
+ ✅ Rastreabilidade Completa (ADRs, decisões, handoffs no BD)
229
+ ✅ Documentação Stripe-like (7 seções, diagrama, tutorial)
230
+ ✅ Metodologia Ágil (sprints, DoD, ceremônias)
231
+ ✅ Observabilidade Full-Stack (logs, métricas, tracing, dashboard)
232
+
233
+ → Diferencial no mercado
234
+ → Atrai equipes de alto nível
235
+ → Pronto para produção
236
+ → Escalável e mantível
237
+ ```
238
+
239
+ ---
240
+
241
+ ## 🎓 Próximas Reuniões
242
+
243
+ - **Kickoff Session**: Revisão REFINAMENTO-v1.0.md
244
+ - **Semana 1 Checkpoint**: 30% completo?
245
+ - **Semana 2 Review**: Tier 1 finalizado?
246
+ - **Semana 3 Planning**: Tier 2 + v0.3.0
247
+
248
+ ---
249
+
250
+ ## 📞 Suporte
251
+
252
+ - **Dúvidas sobre spec**: Ver REFINAMENTO-v1.0.md
253
+ - **Dúvidas sobre implementação**: Ver IMPLEMENTACAO-FASE1.md
254
+ - **Rastreamento**: Ver DASHBOARD-PROGRESSO.md ou query BD
255
+ - **Decisões**: Ver tabela `decisions`
256
+
257
+ ---
258
+
259
+ ## 🎉 Conclusão
260
+
261
+ Plano robusto de refinamento pronto para elevar o kit para nível profissional. Documentação estruturada, código pronto, rastreamento automático. **Tempo de começar!**
262
+
263
+ ---
264
+
265
+ **Aprovado por**: Copilot Analysis System
266
+ **Próximo Review**: Fim da Semana 1
267
+ **Status**: 🟢 GO (Implementação Autorizada)
268
+
@@ -1,10 +1,10 @@
1
- # AGENTS
2
-
3
- ## Linguagem
4
- - Sempre responder e documentar em **pt-BR**.
5
-
6
- ## Stack
7
- - API padrão do projeto: **NestJS**.
8
-
9
- ## Uso da memória
10
- - Seguir a hierarquia em /memory e decisões em /memory/90-decisions.
1
+ # AGENTS
2
+
3
+ ## Linguagem
4
+ - Sempre responder e documentar em **pt-BR**.
5
+
6
+ ## Stack
7
+ - API padrão do projeto: **NestJS**.
8
+
9
+ ## Uso da memória
10
+ - Seguir a hierarquia em /memory e decisões em /memory/90-decisions.
@@ -1,36 +1,36 @@
1
- # create-memory-nest-kit
2
-
3
- Scaffold para projetos grandes com:
4
- - memória modular para agentes (Codex, Claude Code, Gemini CLI, OpenCode)
5
- - padrão de documentação viva
6
- - backend API em NestJS por padrão
7
- - tudo em pt-BR
8
-
9
- ## Uso local
10
-
11
- `node ./bin/create-memory-nest-kit.js meu-projeto`
12
-
13
- ## Uso via npx (GitHub)
14
-
15
- Após publicar no GitHub:
16
-
17
- `npx github:SEU_USUARIO/create-memory-nest-kit meu-projeto`
18
-
19
- ## Uso via npx (npm)
20
-
21
- Após publicar no npm:
22
-
23
- `npx create-memory-nest-kit meu-projeto`
24
-
25
- ## Flags
26
-
27
- - `--force`: sobrescreve arquivos existentes
28
- - `--only-memory`: gera apenas a estrutura de memória
29
- - `--no-gitkeep`: não cria .gitkeep em diretórios vazios
30
-
31
- ## Estrutura gerada
32
-
33
- - `memory/` (governança, arquitetura, domínios, delivery, ADR)
34
- - `prompts/project-prompt-base.md`
35
- - `AGENTS.md`
36
- - `backend/` com base NestJS
1
+ # create-memory-nest-kit
2
+
3
+ Scaffold para projetos grandes com:
4
+ - memória modular para agentes (Codex, Claude Code, Gemini CLI, OpenCode)
5
+ - padrão de documentação viva
6
+ - backend API em NestJS por padrão
7
+ - tudo em pt-BR
8
+
9
+ ## Uso local
10
+
11
+ `node ./bin/create-memory-nest-kit.js meu-projeto`
12
+
13
+ ## Uso via npx (GitHub)
14
+
15
+ Após publicar no GitHub:
16
+
17
+ `npx github:SEU_USUARIO/create-memory-nest-kit meu-projeto`
18
+
19
+ ## Uso via npx (npm)
20
+
21
+ Após publicar no npm:
22
+
23
+ `npx create-memory-nest-kit meu-projeto`
24
+
25
+ ## Flags
26
+
27
+ - `--force`: sobrescreve arquivos existentes
28
+ - `--only-memory`: gera apenas a estrutura de memória
29
+ - `--no-gitkeep`: não cria .gitkeep em diretórios vazios
30
+
31
+ ## Estrutura gerada
32
+
33
+ - `memory/` (governança, arquitetura, domínios, delivery, ADR)
34
+ - `prompts/project-prompt-base.md`
35
+ - `AGENTS.md`
36
+ - `backend/` com base NestJS
@@ -1,9 +1,9 @@
1
- {
2
- "moduleFileExtensions": ["js", "json", "ts"],
3
- "rootDir": ".",
4
- "testEnvironment": "node",
5
- "testRegex": ".e2e-spec.ts$",
6
- "transform": {
7
- "^.+\.(t|j)s$": "ts-jest"
8
- }
9
- }
1
+ {
2
+ "moduleFileExtensions": ["js", "json", "ts"],
3
+ "rootDir": ".",
4
+ "testEnvironment": "node",
5
+ "testRegex": ".e2e-spec.ts$",
6
+ "transform": {
7
+ "^.+\.(t|j)s$": "ts-jest"
8
+ }
9
+ }
@@ -1,4 +1,4 @@
1
- {
2
- "collection": "@nestjs/schematics",
3
- "sourceRoot": "src"
4
- }
1
+ {
2
+ "collection": "@nestjs/schematics",
3
+ "sourceRoot": "src"
4
+ }