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,476 +1,476 @@
1
- # 🚀 Guia de Implementação Prático - Fase 1
2
-
3
- Documento com instruções passo a passo para implementar as melhoras Tier 1 nos agentes.
4
-
5
- ---
6
-
7
- ## Início Rápido: Diagnosticar o Estado Atual
8
-
9
- ```bash
10
- cd /home/apk/Documentos/GitHub/2-Projeto-Agents
11
-
12
- # Verificar estado dos agentes
13
- ls -lh exemplo-v3/agents/
14
- ls -lh exemplo-v3/skills/
15
- ls -lh exemplo-v3/prompts/
16
-
17
- # Consultar plano de melhoras no BD
18
- # (requer SQL access)
19
- SELECT * FROM improvement_items
20
- WHERE status = 'pending'
21
- ORDER BY complexity, area_id;
22
-
23
- # Gerar projeto de teste
24
- node bin/create-memory-nest-kit.js /tmp/test-project
25
- cd /tmp/test-project
26
-
27
- # Verificar estrutura gerada
28
- ls -la
29
- tree memory/ | head -30
30
- ```
31
-
32
- ---
33
-
34
- ## 🎯 Semana 1: Implementar SEC-001 & SEC-002
35
-
36
- ### SEC-001: Validação Obrigatória em Rotas
37
-
38
- **O que fazer:**
39
- 1. Criar DTO com validadores no template backend
40
- 2. Gerar exemplo em `backend/src/users/create-user.dto.ts`
41
- 3. Usar em controller
42
-
43
- **Alteração em `bin/create-memory-nest-kit.js` (writeNestApi)**
44
-
45
- ```javascript
46
- // Adicionar novo arquivo ao objeto 'files':
47
- 'backend/src/common/dto/create-user.dto.ts': `import { IsString, IsEmail, IsNotEmpty, MinLength } from 'class-validator';
48
-
49
- export class CreateUserDto {
50
- @IsNotEmpty()
51
- @IsString()
52
- name: string;
53
-
54
- @IsEmail()
55
- email: string;
56
-
57
- @IsNotEmpty()
58
- @MinLength(8)
59
- password: string;
60
- }
61
- `,
62
-
63
- // Atualizar app.controller.ts com validação
64
- 'backend/src/app.controller.ts': `import { Controller, Get, Post, Body } from '@nestjs/common';
65
- import { CreateUserDto } from './common/dto/create-user.dto';
66
- import { AppService } from './app.service';
67
-
68
- @Controller()
69
- export class AppController {
70
- constructor(private readonly appService: AppService) {}
71
-
72
- @Get('health')
73
- health(): { status: string } {
74
- return this.appService.health();
75
- }
76
-
77
- @Post('users')
78
- createUser(@Body() dto: CreateUserDto) {
79
- return { id: 'user-1', ...dto };
80
- }
81
- }
82
- `,
83
-
84
- // Adicionar pipes globais
85
- 'backend/src/main.ts': `import { NestFactory } from '@nestjs/core';
86
- import { ValidationPipe } from '@nestjs/common';
87
- import { AppModule } from './app.module';
88
-
89
- async function bootstrap(): Promise<void> {
90
- const app = await NestFactory.create(AppModule);
91
- app.setGlobalPrefix('api');
92
-
93
- // Adicionar validação global
94
- app.useGlobalPipes(new ValidationPipe({
95
- whitelist: true,
96
- forbidNonWhitelisted: true,
97
- transform: true,
98
- }));
99
-
100
- await app.listen(process.env.PORT ? Number(process.env.PORT) : 3000);
101
- }
102
-
103
- void bootstrap();
104
- `,
105
- ```
106
-
107
- **Teste:**
108
- ```bash
109
- cd /tmp/test-project/backend
110
- npm install
111
- npm run build
112
-
113
- # Teste com cURL
114
- curl -X POST http://localhost:3000/api/users \
115
- -H "Content-Type: application/json" \
116
- -d '{"name": "João", "email": "invalid", "password": "123"}'
117
- # Resultado: erro 400 com lista de validações
118
- ```
119
-
120
- ---
121
-
122
- ### SEC-002: Rate-Limiting Middleware
123
-
124
- **O que fazer:**
125
- 1. Gerar middleware simples em memória
126
- 2. Aplicar globalmente no NestJS
127
-
128
- **Alteração em `bin/create-memory-nest-kit.js` (writeNestApi)**
129
-
130
- ```javascript
131
- 'backend/src/middleware/rate-limit.middleware.ts': `import { Injectable, NestMiddleware, HttpException, HttpStatus } from '@nestjs/common';
132
- import { Request, Response } from 'express';
133
-
134
- const requestStore = new Map<string, { count: number; resetAt: number }>();
135
-
136
- @Injectable()
137
- export class RateLimitMiddleware implements NestMiddleware {
138
- use(req: Request, res: Response, next: () => void) {
139
- const ip = req.ip || req.connection.remoteAddress || 'unknown';
140
- const now = Date.now();
141
-
142
- if (!requestStore.has(ip)) {
143
- requestStore.set(ip, { count: 1, resetAt: now + 60000 });
144
- next();
145
- return;
146
- }
147
-
148
- const record = requestStore.get(ip)!;
149
- if (now > record.resetAt) {
150
- requestStore.set(ip, { count: 1, resetAt: now + 60000 });
151
- next();
152
- return;
153
- }
154
-
155
- if (record.count >= 100) {
156
- throw new HttpException('Rate limit exceeded', HttpStatus.TOO_MANY_REQUESTS);
157
- }
158
-
159
- record.count++;
160
- next();
161
- }
162
- }
163
- `,
164
-
165
- // Usar no app.module.ts
166
- 'backend/src/app.module.ts': `import { Module, MiddlewareConsumer, NestModule } from '@nestjs/common';
167
- import { AppController } from './app.controller';
168
- import { AppService } from './app.service';
169
- import { RateLimitMiddleware } from './middleware/rate-limit.middleware';
170
-
171
- @Module({
172
- imports: [],
173
- controllers: [AppController],
174
- providers: [AppService]
175
- })
176
- export class AppModule implements NestModule {
177
- configure(consumer: MiddlewareConsumer) {
178
- consumer.apply(RateLimitMiddleware).forRoutes('*');
179
- }
180
- }
181
- `,
182
- ```
183
-
184
- **Teste:**
185
- ```bash
186
- # Simular 101 requests rápidos
187
- for i in {1..101}; do
188
- curl -s http://localhost:3000/api/health | jq .
189
- done
190
- # Último deve retornar 429 Too Many Requests
191
- ```
192
-
193
- ---
194
-
195
- ## 🧠 Semana 1: Implementar AGENT-001 & AGENT-002
196
-
197
- ### AGENT-001: Especificação Estruturada de Agentes
198
-
199
- **O que fazer:**
200
- 1. Criar template de especificação em `agents/AGENT-SPEC.md`
201
- 2. Usar em exemplo: `agents/backend-nest-v1.md`
202
-
203
- **Criar arquivo:**
204
-
205
- ```markdown
206
- # Agent Specification Template
207
-
208
- ## ID
209
- agent-[name]-v[version]
210
-
211
- ## Missão
212
- [1-2 frases, claro]
213
-
214
- ## Entrada Esperada
215
- ```
216
- {
217
- "task_id": "uuid",
218
- "type": "enum",
219
- "scope": "description",
220
- "context": "required fields"
221
- }
222
- ```
223
- Constraints: [tamanho máximo, formato, validações]
224
-
225
- ## Saída Esperada
226
- ```
227
- {
228
- "task_id": "uuid",
229
- "status": "success|partial|failed",
230
- "result": {...},
231
- "errors": []
232
- }
233
- ```
234
- Validação: [checklist de qualidade]
235
-
236
- ## Contexto Prioritário
237
- - memory/00-global/mission.md
238
- - memory/20-architecture/[domain].md
239
- - [domain]/current-sprint.md
240
-
241
- ## Proibições Explícitas
242
- - ❌ NUNCA modificar código sem ownership
243
- - ❌ NUNCA criar nova rota sem ADR
244
- - ❌ NUNCA ignorar validação de entrada
245
-
246
- ## Escala
247
- - Complexidade: 1-10 (expertise required)
248
- - Especialização: alta (muito específico) vs. baixa (genérico)
249
- ```
250
-
251
- ---
252
-
253
- ### AGENT-002: Melhorar Prompts com Few-Shot
254
-
255
- **O que fazer:**
256
- 1. Expandir `prompts/worker-task-template.md` com exemplos
257
- 2. Criar `prompts/instruction-bundle-format.md`
258
-
259
- **Criar arquivo: `prompts/instruction-bundle-format.md`**
260
-
261
- ```markdown
262
- # Instruction Bundle Format
263
-
264
- Use este formato para máxima clareza com LLMs.
265
-
266
- ## Estrutura Recomendada
267
-
268
- \`\`\`
269
- # [Task ID] Task Title
270
-
271
- ## 👤 Contexto (Quem você é)
272
- - Você é especialista em: [domain]
273
- - Objetivo: [clear, measurable]
274
- - Nível de detalhe: [high/medium/low]
275
-
276
- ## 📥 Entrada
277
- - Formato esperado:
278
- \`\`\`json
279
- {
280
- "type": "string",
281
- "data": {...}
282
- }
283
- \`\`\`
284
- - Restrições:
285
- - Tamanho máximo: [limit]
286
- - Validações: [rules]
287
-
288
- ## 📤 Saída Esperada
289
- - Formato obrigatório:
290
- \`\`\`json
291
- {
292
- "success": boolean,
293
- "result": {...},
294
- "errors": []
295
- }
296
- \`\`\`
297
- - Validação final:
298
- - [ ] Campo X presente
299
- - [ ] Campo Y validado
300
- - [ ] Erros claros
301
-
302
- ## 🚫 Proibições (MUITO IMPORTANTE)
303
- - NUNCA fazer: [x, y, z]
304
- - NÃO tente: [a, b, c]
305
- - Recuse se: [condition]
306
-
307
- ## ✅ Checklist Final (Você deve passar)
308
- - [ ] Entendeu o objetivo
309
- - [ ] Validou entrada conforme regras
310
- - [ ] Gerou saída no formato exato
311
- - [ ] Verificou proibições
312
- - [ ] Incluiu erros se relevante
313
-
314
- ## 📚 Exemplos
315
-
316
- ### Exemplo 1: Sucesso
317
- **Entrada:**
318
- \`\`\`json
319
- {...exemplo...}
320
- \`\`\`
321
- **Saída:**
322
- \`\`\`json
323
- {...esperada...}
324
- \`\`\`
325
-
326
- ### Exemplo 2: Erro (o que NÃO fazer)
327
- ...
328
- \`\`\`
329
- ```
330
-
331
- **Atualizar: `prompts/worker-task-template.md`**
332
-
333
- ```markdown
334
- # Worker Task Template
335
-
336
- Você é um **[especialista em domain]**.
337
-
338
- ## Sua Tarefa
339
- [Descrição clara da tarefa, 1-2 frases]
340
-
341
- ## Entrada
342
- - Task ID: {{task_id}}
343
- - Escopo: {{scope}}
344
- - Contexto: [arquivo principal para ler]
345
-
346
- ## Saída Esperada
347
- - Formato: JSON com fields [x, y, z]
348
- - Validação: [checklist]
349
-
350
- ## Proibições
351
- - ❌ Não criar nova estrutura sem coordenação
352
- - ❌ Não alterar código fora do escopo
353
- - ❌ Não ignorar testes
354
-
355
- ## Checklist Final
356
- 1. ✅ Tarefa completada conforme escopo?
357
- 2. ✅ Código passa em testes?
358
- 3. ✅ Documentação atualizada?
359
- 4. ✅ Risco mapeado?
360
- 5. ✅ Handoff pronto?
361
- ```
362
-
363
- ---
364
-
365
- ## 📚 Semana 1: Implementar DOC-001 (Estrutura)
366
-
367
- **O que fazer:**
368
- 1. Reorganizar docs em estrutura profissional
369
- 2. Criar arquivo de índice
370
-
371
- **Criar: `docs/INDEX.md`**
372
-
373
- ```markdown
374
- # Documentação - Índice
375
-
376
- ## 🚀 Início (5 minutos)
377
- - [O que é](/docs/01-getting-started/what-is-it.md)
378
- - [Instalação](/docs/01-getting-started/installation.md)
379
- - [Hello World](/docs/01-getting-started/hello-world.md)
380
-
381
- ## 🏗️ Conceitos Fundamentais
382
- - [Memória Hierárquica](/docs/02-concepts/memory-hierarchy.md)
383
- - [Agentes e Orquestração](/docs/02-concepts/agents.md)
384
- - [Handoff e Continuidade](/docs/02-concepts/handoff.md)
385
-
386
- ## 🔧 Guia de Uso
387
- - [Criar Novo Projeto](/docs/03-guide/create-project.md)
388
- - [Adicionar Domínio](/docs/03-guide/add-domain.md)
389
-
390
- ## 🎓 Tutoriais
391
- - [Caso 1: API Simples](/docs/04-tutorials/case-1.md)
392
- - [Caso 2: Múltiplos Domínios](/docs/04-tutorials/case-2.md)
393
-
394
- ## 🔍 Referência
395
- - [CLI Flags](/docs/05-reference/cli.md)
396
- - [Schema de Memória](/docs/05-reference/schema.md)
397
-
398
- ## ⚙️ Avançado
399
- - [Custom Agents](/docs/06-advanced/custom-agents.md)
400
- - [Model-Specific Tuning](/docs/06-advanced/model-tuning.md)
401
-
402
- ## ❓ FAQ
403
- - [Perguntas Frequentes](/docs/07-faq/index.md)
404
- ```
405
-
406
- ---
407
-
408
- ## 🔄 Próximas Semanas
409
-
410
- Seguir a sequência:
411
-
412
- **Semana 2:**
413
- - [ ] SEC-003: Sanitização
414
- - [ ] SEC-004: Testes
415
- - [ ] AGENT-003: Protocolo de handoff
416
- - [ ] ADR-001: Estrutura robusta
417
-
418
- **Semana 3:**
419
- - [ ] AI-OPT-001: Context packing
420
- - [ ] MEM-001: 3 níveis de compactação
421
- - [ ] AGILE-001: Sprint template
422
-
423
- **Semana 4 (Continuação):**
424
- - [ ] Completar Tier 1
425
- - [ ] Iniciar Tier 2
426
-
427
- ---
428
-
429
- ## 🧪 Validar Implementação
430
-
431
- Após cada implementação, executar:
432
-
433
- ```bash
434
- # Gerar projeto novo
435
- node bin/create-memory-nest-kit.js /tmp/validate-${date}
436
-
437
- # Verificar estrutura
438
- ls -la /tmp/validate-${date}/
439
- find /tmp/validate-${date}/backend/src -name "*.ts" | wc -l
440
-
441
- # Testes
442
- cd /tmp/validate-${date}/backend
443
- npm install
444
- npm run build
445
- npm run lint
446
- npm test
447
-
448
- # Sucesso?
449
- echo "✅ Implementação validada"
450
- ```
451
-
452
- ---
453
-
454
- ## 📝 Atualizar Rastreamento
455
-
456
- Após cada item completado:
457
-
458
- ```sql
459
- UPDATE improvement_items
460
- SET status = 'done'
461
- WHERE id = 'SEC-001';
462
-
463
- -- Verificar progresso
464
- SELECT area_id,
465
- COUNT(*) total,
466
- SUM(CASE WHEN status = 'done' THEN 1 ELSE 0 END) completed,
467
- ROUND(100.0 * SUM(CASE WHEN status = 'done' THEN 1 ELSE 0 END) / COUNT(*), 1) as pct
468
- FROM improvement_items
469
- GROUP BY area_id
470
- ORDER BY area_id;
471
- ```
472
-
473
- ---
474
-
475
- **Status**: Pronto para Implementação | **Data**: 2026-04-21 | **Próximo Review**: Semana 2
476
-
1
+ # 🚀 Guia de Implementação Prático - Fase 1
2
+
3
+ Documento com instruções passo a passo para implementar as melhoras Tier 1 nos agentes.
4
+
5
+ ---
6
+
7
+ ## Início Rápido: Diagnosticar o Estado Atual
8
+
9
+ ```bash
10
+ cd /home/apk/Documentos/GitHub/2-Projeto-Agents
11
+
12
+ # Verificar estado dos agentes
13
+ ls -lh exemplo-v3/agents/
14
+ ls -lh exemplo-v3/skills/
15
+ ls -lh exemplo-v3/prompts/
16
+
17
+ # Consultar plano de melhoras no BD
18
+ # (requer SQL access)
19
+ SELECT * FROM improvement_items
20
+ WHERE status = 'pending'
21
+ ORDER BY complexity, area_id;
22
+
23
+ # Gerar projeto de teste
24
+ node bin/create-memory-nest-kit.js /tmp/test-project
25
+ cd /tmp/test-project
26
+
27
+ # Verificar estrutura gerada
28
+ ls -la
29
+ tree memory/ | head -30
30
+ ```
31
+
32
+ ---
33
+
34
+ ## 🎯 Semana 1: Implementar SEC-001 & SEC-002
35
+
36
+ ### SEC-001: Validação Obrigatória em Rotas
37
+
38
+ **O que fazer:**
39
+ 1. Criar DTO com validadores no template backend
40
+ 2. Gerar exemplo em `backend/src/users/create-user.dto.ts`
41
+ 3. Usar em controller
42
+
43
+ **Alteração em `bin/create-memory-nest-kit.js` (writeNestApi)**
44
+
45
+ ```javascript
46
+ // Adicionar novo arquivo ao objeto 'files':
47
+ 'backend/src/common/dto/create-user.dto.ts': `import { IsString, IsEmail, IsNotEmpty, MinLength } from 'class-validator';
48
+
49
+ export class CreateUserDto {
50
+ @IsNotEmpty()
51
+ @IsString()
52
+ name: string;
53
+
54
+ @IsEmail()
55
+ email: string;
56
+
57
+ @IsNotEmpty()
58
+ @MinLength(8)
59
+ password: string;
60
+ }
61
+ `,
62
+
63
+ // Atualizar app.controller.ts com validação
64
+ 'backend/src/app.controller.ts': `import { Controller, Get, Post, Body } from '@nestjs/common';
65
+ import { CreateUserDto } from './common/dto/create-user.dto';
66
+ import { AppService } from './app.service';
67
+
68
+ @Controller()
69
+ export class AppController {
70
+ constructor(private readonly appService: AppService) {}
71
+
72
+ @Get('health')
73
+ health(): { status: string } {
74
+ return this.appService.health();
75
+ }
76
+
77
+ @Post('users')
78
+ createUser(@Body() dto: CreateUserDto) {
79
+ return { id: 'user-1', ...dto };
80
+ }
81
+ }
82
+ `,
83
+
84
+ // Adicionar pipes globais
85
+ 'backend/src/main.ts': `import { NestFactory } from '@nestjs/core';
86
+ import { ValidationPipe } from '@nestjs/common';
87
+ import { AppModule } from './app.module';
88
+
89
+ async function bootstrap(): Promise<void> {
90
+ const app = await NestFactory.create(AppModule);
91
+ app.setGlobalPrefix('api');
92
+
93
+ // Adicionar validação global
94
+ app.useGlobalPipes(new ValidationPipe({
95
+ whitelist: true,
96
+ forbidNonWhitelisted: true,
97
+ transform: true,
98
+ }));
99
+
100
+ await app.listen(process.env.PORT ? Number(process.env.PORT) : 3000);
101
+ }
102
+
103
+ void bootstrap();
104
+ `,
105
+ ```
106
+
107
+ **Teste:**
108
+ ```bash
109
+ cd /tmp/test-project/backend
110
+ npm install
111
+ npm run build
112
+
113
+ # Teste com cURL
114
+ curl -X POST http://localhost:3000/api/users \
115
+ -H "Content-Type: application/json" \
116
+ -d '{"name": "João", "email": "invalid", "password": "123"}'
117
+ # Resultado: erro 400 com lista de validações
118
+ ```
119
+
120
+ ---
121
+
122
+ ### SEC-002: Rate-Limiting Middleware
123
+
124
+ **O que fazer:**
125
+ 1. Gerar middleware simples em memória
126
+ 2. Aplicar globalmente no NestJS
127
+
128
+ **Alteração em `bin/create-memory-nest-kit.js` (writeNestApi)**
129
+
130
+ ```javascript
131
+ 'backend/src/middleware/rate-limit.middleware.ts': `import { Injectable, NestMiddleware, HttpException, HttpStatus } from '@nestjs/common';
132
+ import { Request, Response } from 'express';
133
+
134
+ const requestStore = new Map<string, { count: number; resetAt: number }>();
135
+
136
+ @Injectable()
137
+ export class RateLimitMiddleware implements NestMiddleware {
138
+ use(req: Request, res: Response, next: () => void) {
139
+ const ip = req.ip || req.connection.remoteAddress || 'unknown';
140
+ const now = Date.now();
141
+
142
+ if (!requestStore.has(ip)) {
143
+ requestStore.set(ip, { count: 1, resetAt: now + 60000 });
144
+ next();
145
+ return;
146
+ }
147
+
148
+ const record = requestStore.get(ip)!;
149
+ if (now > record.resetAt) {
150
+ requestStore.set(ip, { count: 1, resetAt: now + 60000 });
151
+ next();
152
+ return;
153
+ }
154
+
155
+ if (record.count >= 100) {
156
+ throw new HttpException('Rate limit exceeded', HttpStatus.TOO_MANY_REQUESTS);
157
+ }
158
+
159
+ record.count++;
160
+ next();
161
+ }
162
+ }
163
+ `,
164
+
165
+ // Usar no app.module.ts
166
+ 'backend/src/app.module.ts': `import { Module, MiddlewareConsumer, NestModule } from '@nestjs/common';
167
+ import { AppController } from './app.controller';
168
+ import { AppService } from './app.service';
169
+ import { RateLimitMiddleware } from './middleware/rate-limit.middleware';
170
+
171
+ @Module({
172
+ imports: [],
173
+ controllers: [AppController],
174
+ providers: [AppService]
175
+ })
176
+ export class AppModule implements NestModule {
177
+ configure(consumer: MiddlewareConsumer) {
178
+ consumer.apply(RateLimitMiddleware).forRoutes('*');
179
+ }
180
+ }
181
+ `,
182
+ ```
183
+
184
+ **Teste:**
185
+ ```bash
186
+ # Simular 101 requests rápidos
187
+ for i in {1..101}; do
188
+ curl -s http://localhost:3000/api/health | jq .
189
+ done
190
+ # Último deve retornar 429 Too Many Requests
191
+ ```
192
+
193
+ ---
194
+
195
+ ## 🧠 Semana 1: Implementar AGENT-001 & AGENT-002
196
+
197
+ ### AGENT-001: Especificação Estruturada de Agentes
198
+
199
+ **O que fazer:**
200
+ 1. Criar template de especificação em `agents/AGENT-SPEC.md`
201
+ 2. Usar em exemplo: `agents/backend-nest-v1.md`
202
+
203
+ **Criar arquivo:**
204
+
205
+ ```markdown
206
+ # Agent Specification Template
207
+
208
+ ## ID
209
+ agent-[name]-v[version]
210
+
211
+ ## Missão
212
+ [1-2 frases, claro]
213
+
214
+ ## Entrada Esperada
215
+ ```
216
+ {
217
+ "task_id": "uuid",
218
+ "type": "enum",
219
+ "scope": "description",
220
+ "context": "required fields"
221
+ }
222
+ ```
223
+ Constraints: [tamanho máximo, formato, validações]
224
+
225
+ ## Saída Esperada
226
+ ```
227
+ {
228
+ "task_id": "uuid",
229
+ "status": "success|partial|failed",
230
+ "result": {...},
231
+ "errors": []
232
+ }
233
+ ```
234
+ Validação: [checklist de qualidade]
235
+
236
+ ## Contexto Prioritário
237
+ - memory/00-global/mission.md
238
+ - memory/20-architecture/[domain].md
239
+ - [domain]/current-sprint.md
240
+
241
+ ## Proibições Explícitas
242
+ - ❌ NUNCA modificar código sem ownership
243
+ - ❌ NUNCA criar nova rota sem ADR
244
+ - ❌ NUNCA ignorar validação de entrada
245
+
246
+ ## Escala
247
+ - Complexidade: 1-10 (expertise required)
248
+ - Especialização: alta (muito específico) vs. baixa (genérico)
249
+ ```
250
+
251
+ ---
252
+
253
+ ### AGENT-002: Melhorar Prompts com Few-Shot
254
+
255
+ **O que fazer:**
256
+ 1. Expandir `prompts/worker-task-template.md` com exemplos
257
+ 2. Criar `prompts/instruction-bundle-format.md`
258
+
259
+ **Criar arquivo: `prompts/instruction-bundle-format.md`**
260
+
261
+ ```markdown
262
+ # Instruction Bundle Format
263
+
264
+ Use este formato para máxima clareza com LLMs.
265
+
266
+ ## Estrutura Recomendada
267
+
268
+ \`\`\`
269
+ # [Task ID] Task Title
270
+
271
+ ## 👤 Contexto (Quem você é)
272
+ - Você é especialista em: [domain]
273
+ - Objetivo: [clear, measurable]
274
+ - Nível de detalhe: [high/medium/low]
275
+
276
+ ## 📥 Entrada
277
+ - Formato esperado:
278
+ \`\`\`json
279
+ {
280
+ "type": "string",
281
+ "data": {...}
282
+ }
283
+ \`\`\`
284
+ - Restrições:
285
+ - Tamanho máximo: [limit]
286
+ - Validações: [rules]
287
+
288
+ ## 📤 Saída Esperada
289
+ - Formato obrigatório:
290
+ \`\`\`json
291
+ {
292
+ "success": boolean,
293
+ "result": {...},
294
+ "errors": []
295
+ }
296
+ \`\`\`
297
+ - Validação final:
298
+ - [ ] Campo X presente
299
+ - [ ] Campo Y validado
300
+ - [ ] Erros claros
301
+
302
+ ## 🚫 Proibições (MUITO IMPORTANTE)
303
+ - NUNCA fazer: [x, y, z]
304
+ - NÃO tente: [a, b, c]
305
+ - Recuse se: [condition]
306
+
307
+ ## ✅ Checklist Final (Você deve passar)
308
+ - [ ] Entendeu o objetivo
309
+ - [ ] Validou entrada conforme regras
310
+ - [ ] Gerou saída no formato exato
311
+ - [ ] Verificou proibições
312
+ - [ ] Incluiu erros se relevante
313
+
314
+ ## 📚 Exemplos
315
+
316
+ ### Exemplo 1: Sucesso
317
+ **Entrada:**
318
+ \`\`\`json
319
+ {...exemplo...}
320
+ \`\`\`
321
+ **Saída:**
322
+ \`\`\`json
323
+ {...esperada...}
324
+ \`\`\`
325
+
326
+ ### Exemplo 2: Erro (o que NÃO fazer)
327
+ ...
328
+ \`\`\`
329
+ ```
330
+
331
+ **Atualizar: `prompts/worker-task-template.md`**
332
+
333
+ ```markdown
334
+ # Worker Task Template
335
+
336
+ Você é um **[especialista em domain]**.
337
+
338
+ ## Sua Tarefa
339
+ [Descrição clara da tarefa, 1-2 frases]
340
+
341
+ ## Entrada
342
+ - Task ID: {{task_id}}
343
+ - Escopo: {{scope}}
344
+ - Contexto: [arquivo principal para ler]
345
+
346
+ ## Saída Esperada
347
+ - Formato: JSON com fields [x, y, z]
348
+ - Validação: [checklist]
349
+
350
+ ## Proibições
351
+ - ❌ Não criar nova estrutura sem coordenação
352
+ - ❌ Não alterar código fora do escopo
353
+ - ❌ Não ignorar testes
354
+
355
+ ## Checklist Final
356
+ 1. ✅ Tarefa completada conforme escopo?
357
+ 2. ✅ Código passa em testes?
358
+ 3. ✅ Documentação atualizada?
359
+ 4. ✅ Risco mapeado?
360
+ 5. ✅ Handoff pronto?
361
+ ```
362
+
363
+ ---
364
+
365
+ ## 📚 Semana 1: Implementar DOC-001 (Estrutura)
366
+
367
+ **O que fazer:**
368
+ 1. Reorganizar docs em estrutura profissional
369
+ 2. Criar arquivo de índice
370
+
371
+ **Criar: `docs/INDEX.md`**
372
+
373
+ ```markdown
374
+ # Documentação - Índice
375
+
376
+ ## 🚀 Início (5 minutos)
377
+ - [O que é](/docs/01-getting-started/what-is-it.md)
378
+ - [Instalação](/docs/01-getting-started/installation.md)
379
+ - [Hello World](/docs/01-getting-started/hello-world.md)
380
+
381
+ ## 🏗️ Conceitos Fundamentais
382
+ - [Memória Hierárquica](/docs/02-concepts/memory-hierarchy.md)
383
+ - [Agentes e Orquestração](/docs/02-concepts/agents.md)
384
+ - [Handoff e Continuidade](/docs/02-concepts/handoff.md)
385
+
386
+ ## 🔧 Guia de Uso
387
+ - [Criar Novo Projeto](/docs/03-guide/create-project.md)
388
+ - [Adicionar Domínio](/docs/03-guide/add-domain.md)
389
+
390
+ ## 🎓 Tutoriais
391
+ - [Caso 1: API Simples](/docs/04-tutorials/case-1.md)
392
+ - [Caso 2: Múltiplos Domínios](/docs/04-tutorials/case-2.md)
393
+
394
+ ## 🔍 Referência
395
+ - [CLI Flags](/docs/05-reference/cli.md)
396
+ - [Schema de Memória](/docs/05-reference/schema.md)
397
+
398
+ ## ⚙️ Avançado
399
+ - [Custom Agents](/docs/06-advanced/custom-agents.md)
400
+ - [Model-Specific Tuning](/docs/06-advanced/model-tuning.md)
401
+
402
+ ## ❓ FAQ
403
+ - [Perguntas Frequentes](/docs/07-faq/index.md)
404
+ ```
405
+
406
+ ---
407
+
408
+ ## 🔄 Próximas Semanas
409
+
410
+ Seguir a sequência:
411
+
412
+ **Semana 2:**
413
+ - [ ] SEC-003: Sanitização
414
+ - [ ] SEC-004: Testes
415
+ - [ ] AGENT-003: Protocolo de handoff
416
+ - [ ] ADR-001: Estrutura robusta
417
+
418
+ **Semana 3:**
419
+ - [ ] AI-OPT-001: Context packing
420
+ - [ ] MEM-001: 3 níveis de compactação
421
+ - [ ] AGILE-001: Sprint template
422
+
423
+ **Semana 4 (Continuação):**
424
+ - [ ] Completar Tier 1
425
+ - [ ] Iniciar Tier 2
426
+
427
+ ---
428
+
429
+ ## 🧪 Validar Implementação
430
+
431
+ Após cada implementação, executar:
432
+
433
+ ```bash
434
+ # Gerar projeto novo
435
+ node bin/create-memory-nest-kit.js /tmp/validate-${date}
436
+
437
+ # Verificar estrutura
438
+ ls -la /tmp/validate-${date}/
439
+ find /tmp/validate-${date}/backend/src -name "*.ts" | wc -l
440
+
441
+ # Testes
442
+ cd /tmp/validate-${date}/backend
443
+ npm install
444
+ npm run build
445
+ npm run lint
446
+ npm test
447
+
448
+ # Sucesso?
449
+ echo "✅ Implementação validada"
450
+ ```
451
+
452
+ ---
453
+
454
+ ## 📝 Atualizar Rastreamento
455
+
456
+ Após cada item completado:
457
+
458
+ ```sql
459
+ UPDATE improvement_items
460
+ SET status = 'done'
461
+ WHERE id = 'SEC-001';
462
+
463
+ -- Verificar progresso
464
+ SELECT area_id,
465
+ COUNT(*) total,
466
+ SUM(CASE WHEN status = 'done' THEN 1 ELSE 0 END) completed,
467
+ ROUND(100.0 * SUM(CASE WHEN status = 'done' THEN 1 ELSE 0 END) / COUNT(*), 1) as pct
468
+ FROM improvement_items
469
+ GROUP BY area_id
470
+ ORDER BY area_id;
471
+ ```
472
+
473
+ ---
474
+
475
+ **Status**: Pronto para Implementação | **Data**: 2026-04-21 | **Próximo Review**: Semana 2
476
+