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
package/docs/structure.md CHANGED
@@ -1,360 +1,360 @@
1
- # 📁 Estrutura Completa do Projeto Gerado
2
-
3
- Quando você roda `npm run project:new meu-projeto`, o projeto é criado dentro do workspace Forja (`~/forja-workspace/projects/meu-projeto/`). Veja ADR-0019.
4
-
5
- ## Workspace Forja
6
-
7
- ```
8
- ~/forja-workspace/
9
- ├── projects/ # produtos gerados
10
- │ └── meu-projeto/ # projeto individual
11
- ├── memory/
12
- │ ├── sqlite/
13
- │ │ └── universal.db # SQLite FTS5 com índice de todos os produtos
14
- │ └── 30-projects/ # fichas dos projetos
15
- ├── specs/ # specs de produto
16
- ├── .context/ # runbooks GSD de produto
17
- └── README.md
18
- ```
19
-
20
- ## Projeto Gerado
21
-
22
- ```
23
- ~/forja-workspace/projects/meu-projeto/
24
- │
25
- ├── 📂 memory/ [Núcleo: Memória Hierárquica]
26
- │ ├── 📂 00-global/
27
- │ │ ├── missao.md → Propósito e visão
28
- │ │ ├── padroes.md → Convenções de código
29
- │ │ ├── politica-contexto.md → Limites de token/modelo
30
- │ │ ├── contrato-agentes.md → Protocolo de comunicação
31
- │ │ └── indice.md → Mapa de memória
32
- │ │
33
- │ ├── 📂 10-product/
34
- │ │ ├── visao.md → Visão do produto
35
- │ │ ├── personas.md → Usuários/agentes
36
- │ │ ├── regras-negocio.md → Restrições operacionais
37
- │ │ └── nfrs.md → Performance, segurança, etc
38
- │ │
39
- │ ├── 📂 20-architecture/
40
- │ │ ├── visao-geral.md → Diagrama macro
41
- │ │ ├── frontend.md → Stack frontend
42
- │ │ ├── backend.md → Stack backend (NestJS)
43
- │ │ ├── dados.md → BD, cache, indexação
44
- │ │ ├── seguranca.md → Autenticação, autorização
45
- │ │ └── observabilidade.md → Logs, métricas, tracing
46
- │ │
47
- │ ├── 📂 30-domains/
48
- │ │ ├── 📂 auth/
49
- │ │ │ ├── context.md → Bounded context de auth
50
- │ │ │ ├── rules.md → Regras de negócio
51
- │ │ │ └── api.md → Endpoints do domínio
52
- │ │ ├── 📂 billing/
53
- │ │ │ ├── context.md
54
- │ │ │ ├── rules.md
55
- │ │ │ └── api.md
56
- │ │ └── [domínios adicionais]
57
- │ │
58
- │ ├── 📂 40-delivery/
59
- │ │ ├── roadmap.md → Planejamento trimestral
60
- │ │ ├── sprint-atual.md → Sprint em progresso
61
- │ │ └── backlog.md → Itens futuros
62
- │ │
63
- │ ├── 📂 50-orchestration/
64
- │ │ ├── topologia.md → Mapa de agentes
65
- │ │ ├── roteamento.md → Como messages são roteadas
66
- │ │ ├── handoff-protocol.md → 7 campos obrigatórios
67
- │ │ ├── playbook-paralelo.md → Execução paralela segura
68
- │ │ └── 📂 handoffs/
69
- │ │ ├── handoff-20260421-001.md
70
- │ │ ├── handoff-20260421-002.md
71
- │ │ └── [histórico de handoffs]
72
- │ │
73
- │ ├── 📂 60-runs/
74
- │ │ ├── 📂 run-20260421-001/
75
- │ │ │ ├── task.md → Tarefa original
76
- │ │ │ ├── decomposicao.md → Plano de execução
77
- │ │ │ ├── logs.md → Output de cada worker
78
- │ │ │ └── resultado.md → Resumo final
79
- │ │ └── [runs anteriores]
80
- │ │
81
- │ ├── 📂 70-summaries/
82
- │ │ ├── global-summary.md → Estado geral do projeto
83
- │ │ ├── 📂 domain-summaries/
84
- │ │ │ ├── auth-summary.md
85
- │ │ │ ├── billing-summary.md
86
- │ │ │ └── [por domínio]
87
- │ │ └── [criados/atualizados por runs]
88
- │ │
89
- │ ├── 📂 80-data/
90
- │ │ ├── schema.md → Estrutura SQLite
91
- │ │ ├── migration-plan.md → Evoluções do schema
92
- │ │ └── queries-comuns.md → Consultas úteis
93
- │ │
94
- │ └── 📂 90-decisions/
95
- │ ├── ADR-0001-v1.md → Primeira decisão
96
- │ ├── ADR-0002-v1.md
97
- │ ├── ADR-0002-v2.md → Versão revisada
98
- │ └── [ADRs versionadas]
99
- │
100
- ├── 📂 design-md/ [Biblioteca de Design]
101
- │ ├── INDEX.md → Índice de todas as marcas
102
- │ ├── 📂 airbnb/
103
- │ ├── 📂 apple/
104
- │ ├── 📂 stripe/
105
- │ └── [+50 marcas]
106
- │
107
- ├── 📂 agents/ [Especialização por Papel]
108
- │ ├── orchestrator.md → Decompõe tarefas
109
- │ ├── backend-nest.md → Implementa NestJS
110
- │ ├── frontend.md → Implementa UI
111
- │ ├── dba.md → Gerencia BD
112
- │ ├── security.md → Valida segurança
113
- │ ├── reviewer.md → Valida qualidade
114
- │ └── README.md → Diretório de agentes
115
- │
116
- ├── 📂 skills/ [Operações Comuns]
117
- │ ├── triage.md → Classificar tarefas
118
- │ ├── compactacao.md → Reduzir contexto
119
- │ ├── handoff.md → Passar para próximo agente
120
- │ └── nest-api.md → Gerar endpoints
121
- │
122
- ├── 📂 prompts/ [Templates de Prompts]
123
- │ ├── orchestrator-prompt.md
124
- │ ├── worker-prompt-backend.md
125
- │ ├── worker-prompt-frontend.md
126
- │ ├── reviewer-prompt.md
127
- │ └── handoff-prompt.md
128
- │
129
- ├── 📂 scripts/ [Automação]
130
- │ ├── build-context-pack.mjs → Compactar contexto
131
- │ ├── append-handoff.mjs → Criar handoff
132
- │ ├── .context/
133
- │ │ └── context-pack.md → Output compactado
134
- │ └── package.json
135
- │
136
- ├── 📂 .ia-instructions/ [Config por IA]
137
- │ ├── copilot.md → Para Copilot/VSCode
138
- │ ├── claude.md → Para Claude/claude.ai
139
- │ ├── gemini.md → Para Gemini/gemini.ai
140
- │ └── README.md → Guia de instrução
141
- │
142
- ├── 📂 backend/ [NestJS (se não --skip-backend)]
143
- │ ├── 📂 src/
144
- │ │ ├── 📂 modules/
145
- │ │ │ ├── 📂 health/
146
- │ │ │ │ ├── health.controller.ts
147
- │ │ │ │ └── health.module.ts
148
- │ │ │ └── [módulos por domínio]
149
- │ │ ├── 📂 middleware/
150
- │ │ │ ├── rate-limit.middleware.ts
151
- │ │ │ └── sanitize.middleware.ts
152
- │ │ ├── 📂 config/
153
- │ │ │ └── database.config.ts
154
- │ │ ├── app.module.ts
155
- │ │ └── main.ts
156
- │ │
157
- │ ├── 📂 scripts/
158
- │ │ ├── memory-db-init.mjs → Criar BD
159
- │ │ ├── memory-db-sync.mjs → Sincronizar memória
160
- │ │ ├── memory-db-query.mjs → Consultar
161
- │ │ └── .sqlite/
162
- │ │ └── context.db → BD principal
163
- │ │
164
- │ ├── package.json
165
- │ ├── tsconfig.json
166
- │ └── nest-cli.json
167
- │
168
- ├── 📂 .git/ [Git Repository]
169
- │ └── [histórico de commits]
170
- │
171
- ├── 📄 .memoryrc.json [Configuração de Memória]
172
- │ ├── memoria_size_limits
173
- │ ├── modelo_tokens
174
- │ ├── compactacao_nivel
175
- │ └── politica_retention
176
- │
177
- ├── 📄 AGENTS.md [Diretório Global de Agentes]
178
- │ ├── Mapa de todos os agentes
179
- │ ├── Responsabilidades
180
- │ ├── Endpoints de comunicação
181
- │ └── Versionamento
182
- │
183
- ├── 📄 README.md [Documentação do Projeto]
184
- │ ├── Quick start
185
- │ ├── Estrutura
186
- │ ├── Comandos principais
187
- │ └── Links para memória
188
- │
189
- ├── 📄 .gitignore
190
- ├── 📄 .env
191
- └── 📄 package.json
192
- ```
193
-
194
- ---
195
-
196
- ## 🎯 Como Usar Cada Pasta
197
-
198
- ### `memory/00-global/` - Conhecimento Compartilhado
199
- **Use quando**: Onboarding de novo agente, refrescar contexto global
200
- ```bash
201
- cat memory/00-global/contrato-agentes.md
202
- # → Entender como IAs devem se comunicar
203
- ```
204
-
205
- ### `memory/30-domains/` - Contexto por Domínio
206
- **Use quando**: Trabalhar em autenticação, billing, etc
207
- ```bash
208
- cat memory/30-domains/auth/context.md
209
- # → Entender bounded context de auth
210
- ```
211
-
212
- ### `memory/50-orchestration/` - Coordenação
213
- **Use quando**: Descompor tarefa entre múltiplos agentes
214
- ```bash
215
- cat memory/50-orchestration/playbook-paralelo.md
216
- # → Padrão de execução paralela segura
217
- ```
218
-
219
- ### `design-md/` - Biblioteca de Design
220
- **Use quando**: Projetar interfaces, buscar inspiração de UX ou definir padrões visuais
221
- ```bash
222
- cat design-md/INDEX.md
223
- # → Ver todas as referências de design disponíveis
224
- ```
225
-
226
- ### `agents/` - Qual Agente Fazer Quê
227
- **Use quando**: Começar trabalho novo
228
- ```bash
229
- cat agents/orchestrator.md
230
- # → Orquestrador decide quem faz o quê
231
- ```
232
-
233
- ### `scripts/` - Automação
234
- **Use quando**: Precisar compactar contexto ou criar handoff
235
- ```bash
236
- node scripts/build-context-pack.mjs
237
- # → Gera context-pack.md otimizado para token limit
238
-
239
- node scripts/append-handoff.mjs
240
- # → Cria handoff pronto para próximo agente
241
- ```
242
-
243
- ### `backend/scripts/` - Gerenciar BD
244
- **Use quando**: Sincronizar memória ou consultar índice
245
- ```bash
246
- node backend/scripts/memory-db-init.mjs
247
- # → Criar/resetar BD
248
-
249
- node backend/scripts/memory-db-sync.mjs
250
- # → Indexar memory/ em SQLite
251
-
252
- node backend/scripts/memory-db-query.mjs \
253
- --query "SELECT * FROM improvement_items WHERE status='pending'"
254
- # → Consultar rastreamento
255
- ```
256
-
257
- ---
258
-
259
- ## 📊 Fluxo de Trabalho Completo
260
-
261
- ### 1️⃣ Iniciar Nova Tarefa
262
- ```bash
263
- # Orquestrador lê tarefa
264
- cat memory/40-delivery/sprint-atual.md
265
-
266
- # Decide quem faz o quê
267
- cat memory/50-orchestration/topologia.md
268
-
269
- # Cria prompt estruturado
270
- cat prompts/orchestrator-prompt.md
271
- ```
272
-
273
- ### 2️⃣ Workers Executam
274
- ```bash
275
- # Backend worker pega seu contexto
276
- node scripts/build-context-pack.mjs --role backend
277
-
278
- # Implementa em backend/
279
- cd backend && npm run start:dev
280
-
281
- # Frontend worker faz o mesmo
282
- node scripts/build-context-pack.mjs --role frontend
283
- ```
284
-
285
- ### 3️⃣ Criar Handoff
286
- ```bash
287
- # Após completar trabalho
288
- node scripts/append-handoff.mjs \
289
- --from backend \
290
- --to reviewer \
291
- --changes "Implementado auth endpoints" \
292
- --riscos "SQLite migration precisa teste"
293
-
294
- # Cria: memory/50-orchestration/handoffs/handoff-YYYYMMDD-NNN.md
295
- ```
296
-
297
- ### 4️⃣ Reviewer Valida
298
- ```bash
299
- # Reviewer lê handoff
300
- cat memory/50-orchestration/handoffs/handoff-*.md
301
-
302
- # Executa prompts de review
303
- cat prompts/reviewer-prompt.md
304
-
305
- # Atualiza summaries se OK
306
- node backend/scripts/memory-db-sync.mjs
307
- ```
308
-
309
- ### 5️⃣ Documentar Run
310
- ```bash
311
- # Criar pasta de run
312
- mkdir memory/60-runs/run-$(date +%Y%m%d-%H%M%S)
313
-
314
- # Log de tudo: task, decomposição, logs, resultado
315
- ```
316
-
317
- ---
318
-
319
- ## 🔐 Segurança por Pasta
320
-
321
- | Pasta | Acesso | Quem Edita |
322
- |-------|--------|-----------|
323
- | `00-global/` | Public | Arquiteto |
324
- | `30-domains/` | Public | Especialista de domínio |
325
- | `50-orchestration/` | Public | Orquestrador |
326
- | `60-runs/` | Private | Workers durante execução |
327
- | `90-decisions/` | Public | Líder técnico |
328
-
329
- ---
330
-
331
- ## 💾 Sincronização com SQLite
332
-
333
- Após mudanças importantes:
334
- ```bash
335
- # 1. Adicionar à memória (manual ou via handoff)
336
- cat memory/30-domains/auth/context.md
337
-
338
- # 2. Sincronizar com BD
339
- node backend/scripts/memory-db-sync.mjs
340
-
341
- # 3. Consultar progresso
342
- node backend/scripts/memory-db-query.mjs --table improvement_items
343
- ```
344
-
345
- ---
346
-
347
- ## 🎯 Próximos Passos
348
-
349
- 1. ✅ Entender a estrutura (você está aqui)
350
- 2. Ler `.ia-instructions/copilot.md` (ou claude.md/gemini.md)
351
- 3. Rodar `node scripts/build-context-pack.mjs`
352
- 4. Chamar primeiro agente com contexto
353
- 5. Criar handoff após cada tarefa
354
-
355
- ---
356
-
357
- **Para mais detalhes**, veja:
358
- - [README.md](../README.md)
359
- - [AGENTS.md](../AGENTS.md)
360
- - [DOC-MAP.md](../DOC-MAP.md)
1
+ # 📁 Estrutura Completa do Projeto Gerado
2
+
3
+ Quando você roda `npm run project:new meu-projeto`, o projeto é criado dentro do workspace Forja (`~/forja-workspace/projects/meu-projeto/`). Veja ADR-0019.
4
+
5
+ ## Workspace Forja
6
+
7
+ ```
8
+ ~/forja-workspace/
9
+ ├── projects/ # produtos gerados
10
+ │ └── meu-projeto/ # projeto individual
11
+ ├── memory/
12
+ │ ├── sqlite/
13
+ │ │ └── universal.db # SQLite FTS5 com índice de todos os produtos
14
+ │ └── 30-projects/ # fichas dos projetos
15
+ ├── specs/ # specs de produto
16
+ ├── .context/ # runbooks GSD de produto
17
+ └── README.md
18
+ ```
19
+
20
+ ## Projeto Gerado
21
+
22
+ ```
23
+ ~/forja-workspace/projects/meu-projeto/
24
+ │
25
+ ├── 📂 memory/ [Núcleo: Memória Hierárquica]
26
+ │ ├── 📂 00-global/
27
+ │ │ ├── missao.md → Propósito e visão
28
+ │ │ ├── padroes.md → Convenções de código
29
+ │ │ ├── politica-contexto.md → Limites de token/modelo
30
+ │ │ ├── contrato-agentes.md → Protocolo de comunicação
31
+ │ │ └── indice.md → Mapa de memória
32
+ │ │
33
+ │ ├── 📂 10-product/
34
+ │ │ ├── visao.md → Visão do produto
35
+ │ │ ├── personas.md → Usuários/agentes
36
+ │ │ ├── regras-negocio.md → Restrições operacionais
37
+ │ │ └── nfrs.md → Performance, segurança, etc
38
+ │ │
39
+ │ ├── 📂 20-architecture/
40
+ │ │ ├── visao-geral.md → Diagrama macro
41
+ │ │ ├── frontend.md → Stack frontend
42
+ │ │ ├── backend.md → Stack backend (NestJS)
43
+ │ │ ├── dados.md → BD, cache, indexação
44
+ │ │ ├── seguranca.md → Autenticação, autorização
45
+ │ │ └── observabilidade.md → Logs, métricas, tracing
46
+ │ │
47
+ │ ├── 📂 30-domains/
48
+ │ │ ├── 📂 auth/
49
+ │ │ │ ├── context.md → Bounded context de auth
50
+ │ │ │ ├── rules.md → Regras de negócio
51
+ │ │ │ └── api.md → Endpoints do domínio
52
+ │ │ ├── 📂 billing/
53
+ │ │ │ ├── context.md
54
+ │ │ │ ├── rules.md
55
+ │ │ │ └── api.md
56
+ │ │ └── [domínios adicionais]
57
+ │ │
58
+ │ ├── 📂 40-delivery/
59
+ │ │ ├── roadmap.md → Planejamento trimestral
60
+ │ │ ├── sprint-atual.md → Sprint em progresso
61
+ │ │ └── backlog.md → Itens futuros
62
+ │ │
63
+ │ ├── 📂 50-orchestration/
64
+ │ │ ├── topologia.md → Mapa de agentes
65
+ │ │ ├── roteamento.md → Como messages são roteadas
66
+ │ │ ├── handoff-protocol.md → 7 campos obrigatórios
67
+ │ │ ├── playbook-paralelo.md → Execução paralela segura
68
+ │ │ └── 📂 handoffs/
69
+ │ │ ├── handoff-20260421-001.md
70
+ │ │ ├── handoff-20260421-002.md
71
+ │ │ └── [histórico de handoffs]
72
+ │ │
73
+ │ ├── 📂 60-runs/
74
+ │ │ ├── 📂 run-20260421-001/
75
+ │ │ │ ├── task.md → Tarefa original
76
+ │ │ │ ├── decomposicao.md → Plano de execução
77
+ │ │ │ ├── logs.md → Output de cada worker
78
+ │ │ │ └── resultado.md → Resumo final
79
+ │ │ └── [runs anteriores]
80
+ │ │
81
+ │ ├── 📂 70-summaries/
82
+ │ │ ├── global-summary.md → Estado geral do projeto
83
+ │ │ ├── 📂 domain-summaries/
84
+ │ │ │ ├── auth-summary.md
85
+ │ │ │ ├── billing-summary.md
86
+ │ │ │ └── [por domínio]
87
+ │ │ └── [criados/atualizados por runs]
88
+ │ │
89
+ │ ├── 📂 80-data/
90
+ │ │ ├── schema.md → Estrutura SQLite
91
+ │ │ ├── migration-plan.md → Evoluções do schema
92
+ │ │ └── queries-comuns.md → Consultas úteis
93
+ │ │
94
+ │ └── 📂 90-decisions/
95
+ │ ├── ADR-0001-v1.md → Primeira decisão
96
+ │ ├── ADR-0002-v1.md
97
+ │ ├── ADR-0002-v2.md → Versão revisada
98
+ │ └── [ADRs versionadas]
99
+ │
100
+ ├── 📂 design-md/ [Biblioteca de Design]
101
+ │ ├── INDEX.md → Índice de todas as marcas
102
+ │ ├── 📂 airbnb/
103
+ │ ├── 📂 apple/
104
+ │ ├── 📂 stripe/
105
+ │ └── [+50 marcas]
106
+ │
107
+ ├── 📂 agents/ [Especialização por Papel]
108
+ │ ├── orchestrator.md → Decompõe tarefas
109
+ │ ├── backend-nest.md → Implementa NestJS
110
+ │ ├── frontend.md → Implementa UI
111
+ │ ├── dba.md → Gerencia BD
112
+ │ ├── security.md → Valida segurança
113
+ │ ├── reviewer.md → Valida qualidade
114
+ │ └── README.md → Diretório de agentes
115
+ │
116
+ ├── 📂 skills/ [Operações Comuns]
117
+ │ ├── triage.md → Classificar tarefas
118
+ │ ├── compactacao.md → Reduzir contexto
119
+ │ ├── handoff.md → Passar para próximo agente
120
+ │ └── nest-api.md → Gerar endpoints
121
+ │
122
+ ├── 📂 prompts/ [Templates de Prompts]
123
+ │ ├── orchestrator-prompt.md
124
+ │ ├── worker-prompt-backend.md
125
+ │ ├── worker-prompt-frontend.md
126
+ │ ├── reviewer-prompt.md
127
+ │ └── handoff-prompt.md
128
+ │
129
+ ├── 📂 scripts/ [Automação]
130
+ │ ├── build-context-pack.mjs → Compactar contexto
131
+ │ ├── append-handoff.mjs → Criar handoff
132
+ │ ├── .context/
133
+ │ │ └── context-pack.md → Output compactado
134
+ │ └── package.json
135
+ │
136
+ ├── 📂 .ia-instructions/ [Config por IA]
137
+ │ ├── copilot.md → Para Copilot/VSCode
138
+ │ ├── claude.md → Para Claude/claude.ai
139
+ │ ├── gemini.md → Para Gemini/gemini.ai
140
+ │ └── README.md → Guia de instrução
141
+ │
142
+ ├── 📂 backend/ [NestJS (se não --skip-backend)]
143
+ │ ├── 📂 src/
144
+ │ │ ├── 📂 modules/
145
+ │ │ │ ├── 📂 health/
146
+ │ │ │ │ ├── health.controller.ts
147
+ │ │ │ │ └── health.module.ts
148
+ │ │ │ └── [módulos por domínio]
149
+ │ │ ├── 📂 middleware/
150
+ │ │ │ ├── rate-limit.middleware.ts
151
+ │ │ │ └── sanitize.middleware.ts
152
+ │ │ ├── 📂 config/
153
+ │ │ │ └── database.config.ts
154
+ │ │ ├── app.module.ts
155
+ │ │ └── main.ts
156
+ │ │
157
+ │ ├── 📂 scripts/
158
+ │ │ ├── memory-db-init.mjs → Criar BD
159
+ │ │ ├── memory-db-sync.mjs → Sincronizar memória
160
+ │ │ ├── memory-db-query.mjs → Consultar
161
+ │ │ └── .sqlite/
162
+ │ │ └── context.db → BD principal
163
+ │ │
164
+ │ ├── package.json
165
+ │ ├── tsconfig.json
166
+ │ └── nest-cli.json
167
+ │
168
+ ├── 📂 .git/ [Git Repository]
169
+ │ └── [histórico de commits]
170
+ │
171
+ ├── 📄 .memoryrc.json [Configuração de Memória]
172
+ │ ├── memoria_size_limits
173
+ │ ├── modelo_tokens
174
+ │ ├── compactacao_nivel
175
+ │ └── politica_retention
176
+ │
177
+ ├── 📄 AGENTS.md [Diretório Global de Agentes]
178
+ │ ├── Mapa de todos os agentes
179
+ │ ├── Responsabilidades
180
+ │ ├── Endpoints de comunicação
181
+ │ └── Versionamento
182
+ │
183
+ ├── 📄 README.md [Documentação do Projeto]
184
+ │ ├── Quick start
185
+ │ ├── Estrutura
186
+ │ ├── Comandos principais
187
+ │ └── Links para memória
188
+ │
189
+ ├── 📄 .gitignore
190
+ ├── 📄 .env
191
+ └── 📄 package.json
192
+ ```
193
+
194
+ ---
195
+
196
+ ## 🎯 Como Usar Cada Pasta
197
+
198
+ ### `memory/00-global/` - Conhecimento Compartilhado
199
+ **Use quando**: Onboarding de novo agente, refrescar contexto global
200
+ ```bash
201
+ cat memory/00-global/contrato-agentes.md
202
+ # → Entender como IAs devem se comunicar
203
+ ```
204
+
205
+ ### `memory/30-domains/` - Contexto por Domínio
206
+ **Use quando**: Trabalhar em autenticação, billing, etc
207
+ ```bash
208
+ cat memory/30-domains/auth/context.md
209
+ # → Entender bounded context de auth
210
+ ```
211
+
212
+ ### `memory/50-orchestration/` - Coordenação
213
+ **Use quando**: Descompor tarefa entre múltiplos agentes
214
+ ```bash
215
+ cat memory/50-orchestration/playbook-paralelo.md
216
+ # → Padrão de execução paralela segura
217
+ ```
218
+
219
+ ### `design-md/` - Biblioteca de Design
220
+ **Use quando**: Projetar interfaces, buscar inspiração de UX ou definir padrões visuais
221
+ ```bash
222
+ cat design-md/INDEX.md
223
+ # → Ver todas as referências de design disponíveis
224
+ ```
225
+
226
+ ### `agents/` - Qual Agente Fazer Quê
227
+ **Use quando**: Começar trabalho novo
228
+ ```bash
229
+ cat agents/orchestrator.md
230
+ # → Orquestrador decide quem faz o quê
231
+ ```
232
+
233
+ ### `scripts/` - Automação
234
+ **Use quando**: Precisar compactar contexto ou criar handoff
235
+ ```bash
236
+ node scripts/build-context-pack.mjs
237
+ # → Gera context-pack.md otimizado para token limit
238
+
239
+ node scripts/append-handoff.mjs
240
+ # → Cria handoff pronto para próximo agente
241
+ ```
242
+
243
+ ### `backend/scripts/` - Gerenciar BD
244
+ **Use quando**: Sincronizar memória ou consultar índice
245
+ ```bash
246
+ node backend/scripts/memory-db-init.mjs
247
+ # → Criar/resetar BD
248
+
249
+ node backend/scripts/memory-db-sync.mjs
250
+ # → Indexar memory/ em SQLite
251
+
252
+ node backend/scripts/memory-db-query.mjs \
253
+ --query "SELECT * FROM improvement_items WHERE status='pending'"
254
+ # → Consultar rastreamento
255
+ ```
256
+
257
+ ---
258
+
259
+ ## 📊 Fluxo de Trabalho Completo
260
+
261
+ ### 1️⃣ Iniciar Nova Tarefa
262
+ ```bash
263
+ # Orquestrador lê tarefa
264
+ cat memory/40-delivery/sprint-atual.md
265
+
266
+ # Decide quem faz o quê
267
+ cat memory/50-orchestration/topologia.md
268
+
269
+ # Cria prompt estruturado
270
+ cat prompts/orchestrator-prompt.md
271
+ ```
272
+
273
+ ### 2️⃣ Workers Executam
274
+ ```bash
275
+ # Backend worker pega seu contexto
276
+ node scripts/build-context-pack.mjs --role backend
277
+
278
+ # Implementa em backend/
279
+ cd backend && npm run start:dev
280
+
281
+ # Frontend worker faz o mesmo
282
+ node scripts/build-context-pack.mjs --role frontend
283
+ ```
284
+
285
+ ### 3️⃣ Criar Handoff
286
+ ```bash
287
+ # Após completar trabalho
288
+ node scripts/append-handoff.mjs \
289
+ --from backend \
290
+ --to reviewer \
291
+ --changes "Implementado auth endpoints" \
292
+ --riscos "SQLite migration precisa teste"
293
+
294
+ # Cria: memory/50-orchestration/handoffs/handoff-YYYYMMDD-NNN.md
295
+ ```
296
+
297
+ ### 4️⃣ Reviewer Valida
298
+ ```bash
299
+ # Reviewer lê handoff
300
+ cat memory/50-orchestration/handoffs/handoff-*.md
301
+
302
+ # Executa prompts de review
303
+ cat prompts/reviewer-prompt.md
304
+
305
+ # Atualiza summaries se OK
306
+ node backend/scripts/memory-db-sync.mjs
307
+ ```
308
+
309
+ ### 5️⃣ Documentar Run
310
+ ```bash
311
+ # Criar pasta de run
312
+ mkdir memory/60-runs/run-$(date +%Y%m%d-%H%M%S)
313
+
314
+ # Log de tudo: task, decomposição, logs, resultado
315
+ ```
316
+
317
+ ---
318
+
319
+ ## 🔐 Segurança por Pasta
320
+
321
+ | Pasta | Acesso | Quem Edita |
322
+ |-------|--------|-----------|
323
+ | `00-global/` | Public | Arquiteto |
324
+ | `30-domains/` | Public | Especialista de domínio |
325
+ | `50-orchestration/` | Public | Orquestrador |
326
+ | `60-runs/` | Private | Workers durante execução |
327
+ | `90-decisions/` | Public | Líder técnico |
328
+
329
+ ---
330
+
331
+ ## 💾 Sincronização com SQLite
332
+
333
+ Após mudanças importantes:
334
+ ```bash
335
+ # 1. Adicionar à memória (manual ou via handoff)
336
+ cat memory/30-domains/auth/context.md
337
+
338
+ # 2. Sincronizar com BD
339
+ node backend/scripts/memory-db-sync.mjs
340
+
341
+ # 3. Consultar progresso
342
+ node backend/scripts/memory-db-query.mjs --table improvement_items
343
+ ```
344
+
345
+ ---
346
+
347
+ ## 🎯 Próximos Passos
348
+
349
+ 1. ✅ Entender a estrutura (você está aqui)
350
+ 2. Ler `.ia-instructions/copilot.md` (ou claude.md/gemini.md)
351
+ 3. Rodar `node scripts/build-context-pack.mjs`
352
+ 4. Chamar primeiro agente com contexto
353
+ 5. Criar handoff após cada tarefa
354
+
355
+ ---
356
+
357
+ **Para mais detalhes**, veja:
358
+ - [README.md](../README.md)
359
+ - [AGENTS.md](../AGENTS.md)
360
+ - [DOC-MAP.md](../DOC-MAP.md)