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,72 +1,72 @@
1
- # ForjaJS 2.0 — Visão
2
-
3
- ## Problema
4
-
5
- Agentes de desenvolvimento conseguem editar código, mas não mantêm memória verificável,
6
- limites de autonomia, contexto econômico ou uma trilha uniforme de decisão. O ForjaJS 1.x
7
- resolve parte disso como CLI; a 2.0 transforma essas capacidades em contratos e serviços
8
- programáveis, preservando a operação CLI-first.
9
-
10
- ## Usuário principal e casos de uso
11
-
12
- O usuário principal é o desenvolvedor solo ou time pequeno que opera um ou mais repositórios
13
- com agentes. Casos prioritários:
14
-
15
- - descobrir e executar uma capability com entrada e saída validadas;
16
- - executar uma tarefa supervisionada, pausá-la e retomá-la com checkpoint;
17
- - entregar contexto mínimo baseado em memória, grafo, evidência e orçamento;
18
- - bloquear escrita, rede ou ações destrutivas por política;
19
- - revisar um resultado com evidências independentes antes de marcar a tarefa concluída;
20
- - consumir o mesmo núcleo pela CLI, SDK, MCP, worker e backend.
21
-
22
- ## Proposta de valor verificável
23
-
24
- ForjaJS 2.0 é uma plataforma local-first para memória, contexto, execução, governança e
25
- autonomia de agentes de desenvolvimento. A promessa é limitada às seguintes provas:
26
-
27
- | Promessa | Prova esperada |
28
- | --- | --- |
29
- | Ações descobríveis | registry versionado e introspectável |
30
- | Autonomia limitada | decisão de política, aprovação, orçamento e sandbox por execução |
31
- | Memória confiável | evidência, validade temporal e status de conhecimento |
32
- | Contexto econômico | refs, checksums, cache e métricas de tokens |
33
- | Falsa conclusão bloqueada | validator independente com resultado estruturado |
34
-
35
- ## Diferenciação técnica
36
-
37
- CLIs de agentes normalmente são superfícies de comando; frameworks de agentes normalmente
38
- orquestram loops; ferramentas de memória normalmente não governam execução. O Forja combina
39
- essas três preocupações em um núcleo de domínio independente de framework, com adapters para
40
- CLI, MCP, REST, SQLite e NestJS. GraphLoop é o grafo verificável de trabalho e contexto; não
41
- é apenas um índice de símbolos.
42
-
43
- ## Princípios
44
-
45
- 1. local-first e offline por padrão;
46
- 2. domínio independente de NestJS, Next.js, transporte e persistência;
47
- 3. contratos versionados, validação na entrada e resultados auditáveis;
48
- 4. determinismo antes de LLM;
49
- 5. autonomia supervisionada por padrão;
50
- 6. contexto mínimo suficiente e orçamento explícito;
51
- 7. migração 1.x aditiva e não destrutiva;
52
- 8. evidência separada de afirmação e hipótese.
53
-
54
- ## Fora do escopo da 2.0 inicial
55
-
56
- Hospedagem multi-tenant, execução remota obrigatória, dependência de um provedor de LLM,
57
- treinamento de modelos, substituição de Git, IDE própria, sincronização em nuvem obrigatória
58
- e dashboard como requisito para operar o produto.
59
-
60
- ## Sucesso e métricas
61
-
62
- O release candidate deve demonstrar: uma IA descobre uma capability sem documentação humana,
63
- executa uma tarefa supervisionada, pausa/retoma, é bloqueada por política e não conclui sem
64
- validação. Métricas mínimas: taxa de execuções auditadas, taxa de bloqueios corretos, taxa de
65
- retomada, tokens por tarefa, cache hit rate, retrabalho, afirmações sem evidência e falhas de
66
- validator.
67
-
68
- ## Estratégia de entrega
69
-
70
- A 2.0 será incremental: primeiro contratos e registry; depois runtime controlado, policy,
71
- sprint/task/handoff, MCP/Nest, GraphLoop/contexto, autonomia, multiagente, dashboard e plugins.
72
- O ForjaJS 1.x continua sendo a superfície CLI compatível durante a migração.
1
+ # ForjaJS 2.0 — Visão
2
+
3
+ ## Problema
4
+
5
+ Agentes de desenvolvimento conseguem editar código, mas não mantêm memória verificável,
6
+ limites de autonomia, contexto econômico ou uma trilha uniforme de decisão. O ForjaJS 1.x
7
+ resolve parte disso como CLI; a 2.0 transforma essas capacidades em contratos e serviços
8
+ programáveis, preservando a operação CLI-first.
9
+
10
+ ## Usuário principal e casos de uso
11
+
12
+ O usuário principal é o desenvolvedor solo ou time pequeno que opera um ou mais repositórios
13
+ com agentes. Casos prioritários:
14
+
15
+ - descobrir e executar uma capability com entrada e saída validadas;
16
+ - executar uma tarefa supervisionada, pausá-la e retomá-la com checkpoint;
17
+ - entregar contexto mínimo baseado em memória, grafo, evidência e orçamento;
18
+ - bloquear escrita, rede ou ações destrutivas por política;
19
+ - revisar um resultado com evidências independentes antes de marcar a tarefa concluída;
20
+ - consumir o mesmo núcleo pela CLI, SDK, MCP, worker e backend.
21
+
22
+ ## Proposta de valor verificável
23
+
24
+ ForjaJS 2.0 é uma plataforma local-first para memória, contexto, execução, governança e
25
+ autonomia de agentes de desenvolvimento. A promessa é limitada às seguintes provas:
26
+
27
+ | Promessa | Prova esperada |
28
+ | --- | --- |
29
+ | Ações descobríveis | registry versionado e introspectável |
30
+ | Autonomia limitada | decisão de política, aprovação, orçamento e sandbox por execução |
31
+ | Memória confiável | evidência, validade temporal e status de conhecimento |
32
+ | Contexto econômico | refs, checksums, cache e métricas de tokens |
33
+ | Falsa conclusão bloqueada | validator independente com resultado estruturado |
34
+
35
+ ## Diferenciação técnica
36
+
37
+ CLIs de agentes normalmente são superfícies de comando; frameworks de agentes normalmente
38
+ orquestram loops; ferramentas de memória normalmente não governam execução. O Forja combina
39
+ essas três preocupações em um núcleo de domínio independente de framework, com adapters para
40
+ CLI, MCP, REST, SQLite e NestJS. GraphLoop é o grafo verificável de trabalho e contexto; não
41
+ é apenas um índice de símbolos.
42
+
43
+ ## Princípios
44
+
45
+ 1. local-first e offline por padrão;
46
+ 2. domínio independente de NestJS, Next.js, transporte e persistência;
47
+ 3. contratos versionados, validação na entrada e resultados auditáveis;
48
+ 4. determinismo antes de LLM;
49
+ 5. autonomia supervisionada por padrão;
50
+ 6. contexto mínimo suficiente e orçamento explícito;
51
+ 7. migração 1.x aditiva e não destrutiva;
52
+ 8. evidência separada de afirmação e hipótese.
53
+
54
+ ## Fora do escopo da 2.0 inicial
55
+
56
+ Hospedagem multi-tenant, execução remota obrigatória, dependência de um provedor de LLM,
57
+ treinamento de modelos, substituição de Git, IDE própria, sincronização em nuvem obrigatória
58
+ e dashboard como requisito para operar o produto.
59
+
60
+ ## Sucesso e métricas
61
+
62
+ O release candidate deve demonstrar: uma IA descobre uma capability sem documentação humana,
63
+ executa uma tarefa supervisionada, pausa/retoma, é bloqueada por política e não conclui sem
64
+ validação. Métricas mínimas: taxa de execuções auditadas, taxa de bloqueios corretos, taxa de
65
+ retomada, tokens por tarefa, cache hit rate, retrabalho, afirmações sem evidência e falhas de
66
+ validator.
67
+
68
+ ## Estratégia de entrega
69
+
70
+ A 2.0 será incremental: primeiro contratos e registry; depois runtime controlado, policy,
71
+ sprint/task/handoff, MCP/Nest, GraphLoop/contexto, autonomia, multiagente, dashboard e plugins.
72
+ O ForjaJS 1.x continua sendo a superfície CLI compatível durante a migração.
@@ -1,15 +1,15 @@
1
- # Missão Universal: Projeto Agentes
2
-
3
- ## Propósito
4
- Criar um ecossistema de agentes orquestrados, independentes de LLM, com memória persistente e universal para acelerar o desenvolvimento de produtos escaláveis.
5
-
6
- ## Objetivos
7
- 1. **Independência de LLM**: Funcionar com Gemini, Claude, OpenAI, etc.
8
- 2. **Memória Universal**: Banco de dados SQLite central que indexa documentação de todos os projetos.
9
- 3. **Escalabilidade**: Camadas de metodologia para crescimento do produto (Growth, Scaling).
10
- 4. **Isolamento**: Projetos gerados são isolados e não poluem o repositório principal.
11
-
12
- ## Pilares
13
- - **Memória Hierárquica**: Global -> Projeto -> Domínio -> Tarefa.
14
- - **Orquestração**: Divisão clara de papéis e responsabilidades.
15
- - **Continuidade**: Handoffs que preservam o contexto entre sessões e agentes.
1
+ # Missão Universal: Projeto Agentes
2
+
3
+ ## Propósito
4
+ Criar um ecossistema de agentes orquestrados, independentes de LLM, com memória persistente e universal para acelerar o desenvolvimento de produtos escaláveis.
5
+
6
+ ## Objetivos
7
+ 1. **Independência de LLM**: Funcionar com Gemini, Claude, OpenAI, etc.
8
+ 2. **Memória Universal**: Banco de dados SQLite central que indexa documentação de todos os projetos.
9
+ 3. **Escalabilidade**: Camadas de metodologia para crescimento do produto (Growth, Scaling).
10
+ 4. **Isolamento**: Projetos gerados são isolados e não poluem o repositório principal.
11
+
12
+ ## Pilares
13
+ - **Memória Hierárquica**: Global -> Projeto -> Domínio -> Tarefa.
14
+ - **Orquestração**: Divisão clara de papéis e responsabilidades.
15
+ - **Continuidade**: Handoffs que preservam o contexto entre sessões e agentes.
@@ -1,8 +1,8 @@
1
- # Base de Conhecimento Compartilhada (Patterns)
2
-
3
- > Preenchida via Cross-Project Analysis (`npm run memory:extract`): padrões que se
4
- > repetem em 2+ projetos do workspace são promovidos para cá, **sem dados de
5
- > produto** — apenas o padrão generalizado.
6
-
7
- Nenhum padrão promovido ainda nesta instalação. Conhecimento específico de cada
8
- produto vive na ficha do projeto em `<workspace>/memory/30-projects/`.
1
+ # Base de Conhecimento Compartilhada (Patterns)
2
+
3
+ > Preenchida via Cross-Project Analysis (`npm run memory:extract`): padrões que se
4
+ > repetem em 2+ projetos do workspace são promovidos para cá, **sem dados de
5
+ > produto** — apenas o padrão generalizado.
6
+
7
+ Nenhum padrão promovido ainda nesta instalação. Conhecimento específico de cada
8
+ produto vive na ficha do projeto em `<workspace>/memory/30-projects/`.
@@ -1,47 +1,47 @@
1
- # Padrões Globais de Engenharia e Crescimento
2
-
3
- ## Camada de Metodologia Ágil (Agile)
4
- - **Sprints**: Ciclos de 1 a 2 semanas focados em entregas de valor.
5
- - **Backlog**: Única fonte de verdade para futuras implementações.
6
- - **Current Sprint**: Itens em execução imediata. Cada item deve ter um `owner_agent`.
7
- - **Handoffs**: Obrigatórios após cada subtarefa para manter a continuidade.
8
-
9
- ## Camada de Crescimento (Growth - AARRR)
10
- Todo projeto deve mapear e otimizar o funil:
11
- 1. **Aquisição**: Como o usuário chega (SEO, Ads, APIs).
12
- 2. **Ativação**: Primeira experiência de valor (Onboarding).
13
- 3. **Retenção**: Uso contínuo (Engajamento, Notificações).
14
- 4. **Receita**: Monetização (Abacate Pay, Assinaturas).
15
- 5. **Recomendação**: Viralidade e indicações.
16
-
17
- ## Camada de Escalonamento (Scaling - 12-Factor)
18
- Padrões para aplicações modernas e resilientes:
19
- - **Codebase**: Um repositório, múltiplos deploys.
20
- - **Dependencies**: Declaradas e isoladas explicitamente.
21
- - **Config**: Armazenada no ambiente (Environment variables).
22
- - **Backing Services**: Tratados como recursos anexados.
23
- - **Stateless**: Processos devem ser sem estado e compartilhar nada.
24
-
25
- ## Camada de Produto (Product Discovery)
26
- Protocolo mandatório para o **Agente de Produto**:
27
- - **Definição de Problema**: Antes de qualquer feature, o problema deve ser explicitado.
28
- - **Métricas de Sucesso**: Como mediremos se a feature foi bem-sucedida?
29
- - **Documentação**: Atualização obrigatória de `memory/10-product/business-rules.md`.
30
-
31
- ## Camada de Marketing e Growth (AARRR Metrics)
32
- Protocolo para o **Agente de Marketing**:
33
- - **SEO & Copy**: Todo projeto deve ter uma estratégia de conteúdo técnico.
34
- - **Loops de Viralidade**: Identificar mecanismos de indicação e compartilhamento (Recomendação).
35
- - **Ativação**: O "Aha! Moment" do usuário deve ser o foco do primeiro deploy.
36
-
37
- ## Camada de Governança e Compliance
38
- Protocolo para o **Agente de Governança**:
39
- - **Auditoria de Decisão**: Nenhuma mudança arquitetural sem `ADR`.
40
- - **Privacidade by Design**: Verificação de vazamento de PII em logs e tabelas.
41
- - **Qualidade de Handoff**: O score de maturidade (`project:check`) deve ser mantido acima de 80%.
42
-
43
- ## Qualidade de Código (Clean Code)
44
- ...
45
- - **SOLID**: Princípios fundamentais em toda implementação.
46
- - **Surgical Changes**: Evitar refatorações globais em tarefas de feature.
47
- - **Test-First**: Priorizar a criação de testes antes da implementação final.
1
+ # Padrões Globais de Engenharia e Crescimento
2
+
3
+ ## Camada de Metodologia Ágil (Agile)
4
+ - **Sprints**: Ciclos de 1 a 2 semanas focados em entregas de valor.
5
+ - **Backlog**: Única fonte de verdade para futuras implementações.
6
+ - **Current Sprint**: Itens em execução imediata. Cada item deve ter um `owner_agent`.
7
+ - **Handoffs**: Obrigatórios após cada subtarefa para manter a continuidade.
8
+
9
+ ## Camada de Crescimento (Growth - AARRR)
10
+ Todo projeto deve mapear e otimizar o funil:
11
+ 1. **Aquisição**: Como o usuário chega (SEO, Ads, APIs).
12
+ 2. **Ativação**: Primeira experiência de valor (Onboarding).
13
+ 3. **Retenção**: Uso contínuo (Engajamento, Notificações).
14
+ 4. **Receita**: Monetização (Abacate Pay, Assinaturas).
15
+ 5. **Recomendação**: Viralidade e indicações.
16
+
17
+ ## Camada de Escalonamento (Scaling - 12-Factor)
18
+ Padrões para aplicações modernas e resilientes:
19
+ - **Codebase**: Um repositório, múltiplos deploys.
20
+ - **Dependencies**: Declaradas e isoladas explicitamente.
21
+ - **Config**: Armazenada no ambiente (Environment variables).
22
+ - **Backing Services**: Tratados como recursos anexados.
23
+ - **Stateless**: Processos devem ser sem estado e compartilhar nada.
24
+
25
+ ## Camada de Produto (Product Discovery)
26
+ Protocolo mandatório para o **Agente de Produto**:
27
+ - **Definição de Problema**: Antes de qualquer feature, o problema deve ser explicitado.
28
+ - **Métricas de Sucesso**: Como mediremos se a feature foi bem-sucedida?
29
+ - **Documentação**: Atualização obrigatória de `memory/10-product/business-rules.md`.
30
+
31
+ ## Camada de Marketing e Growth (AARRR Metrics)
32
+ Protocolo para o **Agente de Marketing**:
33
+ - **SEO & Copy**: Todo projeto deve ter uma estratégia de conteúdo técnico.
34
+ - **Loops de Viralidade**: Identificar mecanismos de indicação e compartilhamento (Recomendação).
35
+ - **Ativação**: O "Aha! Moment" do usuário deve ser o foco do primeiro deploy.
36
+
37
+ ## Camada de Governança e Compliance
38
+ Protocolo para o **Agente de Governança**:
39
+ - **Auditoria de Decisão**: Nenhuma mudança arquitetural sem `ADR`.
40
+ - **Privacidade by Design**: Verificação de vazamento de PII em logs e tabelas.
41
+ - **Qualidade de Handoff**: O score de maturidade (`project:check`) deve ser mantido acima de 80%.
42
+
43
+ ## Qualidade de Código (Clean Code)
44
+ ...
45
+ - **SOLID**: Princípios fundamentais em toda implementação.
46
+ - **Surgical Changes**: Evitar refatorações globais em tarefas de feature.
47
+ - **Test-First**: Priorizar a criação de testes antes da implementação final.
@@ -1,21 +1,21 @@
1
- # Personas — Forja
2
-
3
- ## 1. Dev solo multi-produto (persona primária)
4
-
5
- - **Contexto**: opera 2–10 produtos simultaneamente usando IA como principal força de trabalho; não tem PM, arquiteto nem QA dedicados.
6
- - **Dores**: cada sessão de IA recomeça do zero; decisões evaporam; contexto de um produto vaza no outro; disciplina de processo depende só da própria memória.
7
- - **Ganhos esperados**: retomar qualquer produto em minutos (memória + smart-context), decisões rastreadas (ADRs), pipeline que impede código sem spec, trilha de auditoria do que rodou (core, ADR-0020).
8
-
9
- ## 2. Time pequeno com IA intensiva (persona secundária)
10
-
11
- - **Contexto**: 2–5 pessoas compartilhando agentes e convenções; múltiplas IAs no mesmo repo (Claude, Copilot, Gemini, Codex).
12
- - **Dores**: cada pessoa opera a IA de um jeito; handoffs informais; retrabalho por falta de fonte única de decisão.
13
- - **Ganhos esperados**: papéis e handoffs padronizados (7 campos), memória universal compartilhada, gates de governança iguais para todos.
14
-
15
- ## 3. Operador de agentes ("agent wrangler")
16
-
17
- - **Contexto**: desenha e roda times de agentes por projeto (harness); trata a IA como equipe, não como autocomplete.
18
- - **Dores**: sem topologia clara, agentes pisam um no outro; sem gates, entregam código não verificável.
19
- - **Ganhos esperados**: topologia de 6 papéis pronta, codegraph como gate de impacto, runbooks GSD verificáveis por comando.
20
-
21
- > Personas de produtos gerados vivem na ficha de cada projeto no workspace, não aqui.
1
+ # Personas — Forja
2
+
3
+ ## 1. Dev solo multi-produto (persona primária)
4
+
5
+ - **Contexto**: opera 2–10 produtos simultaneamente usando IA como principal força de trabalho; não tem PM, arquiteto nem QA dedicados.
6
+ - **Dores**: cada sessão de IA recomeça do zero; decisões evaporam; contexto de um produto vaza no outro; disciplina de processo depende só da própria memória.
7
+ - **Ganhos esperados**: retomar qualquer produto em minutos (memória + smart-context), decisões rastreadas (ADRs), pipeline que impede código sem spec, trilha de auditoria do que rodou (core, ADR-0020).
8
+
9
+ ## 2. Time pequeno com IA intensiva (persona secundária)
10
+
11
+ - **Contexto**: 2–5 pessoas compartilhando agentes e convenções; múltiplas IAs no mesmo repo (Claude, Copilot, Gemini, Codex).
12
+ - **Dores**: cada pessoa opera a IA de um jeito; handoffs informais; retrabalho por falta de fonte única de decisão.
13
+ - **Ganhos esperados**: papéis e handoffs padronizados (7 campos), memória universal compartilhada, gates de governança iguais para todos.
14
+
15
+ ## 3. Operador de agentes ("agent wrangler")
16
+
17
+ - **Contexto**: desenha e roda times de agentes por projeto (harness); trata a IA como equipe, não como autocomplete.
18
+ - **Dores**: sem topologia clara, agentes pisam um no outro; sem gates, entregam código não verificável.
19
+ - **Ganhos esperados**: topologia de 6 papéis pronta, codegraph como gate de impacto, runbooks GSD verificáveis por comando.
20
+
21
+ > Personas de produtos gerados vivem na ficha de cada projeto no workspace, não aqui.
@@ -1,27 +1,27 @@
1
- # Visão de Produto — Forja
2
-
3
- > A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.
4
-
5
- ## O problema (o inimigo)
6
-
7
- Agentes de IA são amnésicos e indisciplinados. Cada sessão recomeça do zero, decisões de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao mesmo tempo paga esse imposto multiplicado por N. Um assistente brilhante sem processo produz velocidade sem direção.
8
-
9
- ## A aposta
10
-
11
- O diferencial durável não é o modelo (commodity que melhora sozinho), é o que fica em volta dele:
12
-
13
- 1. **Memória que sobrevive** — contexto hierárquico, buscável (SQLite FTS5), compartilhado entre sessões e entre IAs (ADR-0001/0002/0003).
14
- 2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs auditáveis de 7 campos (ADR-0005); comandos passam por um core único com gates e trilha de auditoria (ADR-0020).
15
- 3. **Fábrica, não projeto único** — workspace multi-produto com canto fixo (ADR-0019), times de agentes desenhados por projeto (harness), code intelligence como gate (ADR-0017).
16
-
17
- ## Posicionamento
18
-
19
- - **Claude Code sozinho** é um engenheiro brilhante e amnésico; a Forja é o estúdio em volta dele.
20
- - **Frameworks de agentes** (LangGraph etc.) são infraestrutura para *construir* agentes; a Forja é a camada de cima — o sistema operacional do estúdio de software de uma pessoa só.
21
- - **Multi-IA por design** (Claude, Copilot, Gemini, Codex): nenhum vendor entrega isso, e a memória/processo não fica refém de um fornecedor.
22
-
23
- A stack gerada (NestJS hoje) é **um boilerplate entre vários** — a identidade da Forja é o processo + a memória, não o framework de backend.
24
-
25
- ## Métrica-norte
26
-
27
- Tempo entre "ideia" e "primeira feature governada em produção" num workspace com N projetos ativos, sem perda de contexto entre sessões e sem decisão estrutural fora de ADR.
1
+ # Visão de Produto — Forja
2
+
3
+ > A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.
4
+
5
+ ## O problema (o inimigo)
6
+
7
+ Agentes de IA são amnésicos e indisciplinados. Cada sessão recomeça do zero, decisões de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao mesmo tempo paga esse imposto multiplicado por N. Um assistente brilhante sem processo produz velocidade sem direção.
8
+
9
+ ## A aposta
10
+
11
+ O diferencial durável não é o modelo (commodity que melhora sozinho), é o que fica em volta dele:
12
+
13
+ 1. **Memória que sobrevive** — contexto hierárquico, buscável (SQLite FTS5), compartilhado entre sessões e entre IAs (ADR-0001/0002/0003).
14
+ 2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs auditáveis de 7 campos (ADR-0005); comandos passam por um core único com gates e trilha de auditoria (ADR-0020).
15
+ 3. **Fábrica, não projeto único** — workspace multi-produto com canto fixo (ADR-0019), times de agentes desenhados por projeto (harness), code intelligence como gate (ADR-0017).
16
+
17
+ ## Posicionamento
18
+
19
+ - **Claude Code sozinho** é um engenheiro brilhante e amnésico; a Forja é o estúdio em volta dele.
20
+ - **Frameworks de agentes** (LangGraph etc.) são infraestrutura para *construir* agentes; a Forja é a camada de cima — o sistema operacional do estúdio de software de uma pessoa só.
21
+ - **Multi-IA por design** (Claude, Copilot, Gemini, Codex): nenhum vendor entrega isso, e a memória/processo não fica refém de um fornecedor.
22
+
23
+ A stack gerada (NestJS hoje) é **um boilerplate entre vários** — a identidade da Forja é o processo + a memória, não o framework de backend.
24
+
25
+ ## Métrica-norte
26
+
27
+ Tempo entre "ideia" e "primeira feature governada em produção" num workspace com N projetos ativos, sem perda de contexto entre sessões e sem decisão estrutural fora de ADR.
@@ -1,15 +1,15 @@
1
- # memory/30-projects — fichas de projetos (privadas)
2
-
3
- Este diretório registra os projetos rastreados pela Memória Universal. Cada projeto
4
- gera uma ficha `<nome>.md` (criada por `init-project.js` ou pela sincronização de
5
- memória).
6
-
7
- ## Privacidade
8
-
9
- As fichas de projeto carregam dados de produto/cliente e por isso **não são
10
- versionadas** — `.gitignore` ignora `memory/30-projects/*` exceto este README.
11
- A mesma convenção vale para `specs/<produto>/` e `.context/` (ver `.gitignore`).
12
-
13
- As fichas continuam existindo em disco e funcionando localmente; apenas não entram
14
- no repositório público do framework. Para regenerar a ficha de um projeto, rode o
15
- fluxo de init/sync de memória correspondente.
1
+ # memory/30-projects — fichas de projetos (privadas)
2
+
3
+ Este diretório registra os projetos rastreados pela Memória Universal. Cada projeto
4
+ gera uma ficha `<nome>.md` (criada por `init-project.js` ou pela sincronização de
5
+ memória).
6
+
7
+ ## Privacidade
8
+
9
+ As fichas de projeto carregam dados de produto/cliente e por isso **não são
10
+ versionadas** — `.gitignore` ignora `memory/30-projects/*` exceto este README.
11
+ A mesma convenção vale para `specs/<produto>/` e `.context/` (ver `.gitignore`).
12
+
13
+ As fichas continuam existindo em disco e funcionando localmente; apenas não entram
14
+ no repositório público do framework. Para regenerar a ficha de um projeto, rode o
15
+ fluxo de init/sync de memória correspondente.
@@ -1,15 +1,15 @@
1
- # Backlog
2
-
3
- Priorizacao via RICE (Reach x Impact x Confidence / Effort).
4
-
5
- Assumptions: 1 usuario, ~5 empresas, ~60 ativos, 2 NAS.
6
-
7
- | Prioridade | Item | Reach | Impact | Confidence | Effort | RICE | Dependencias | Notas |
8
- |---|---:|---:|---:|---:|---:|---:|---|---|
9
- | P0 | Inventario multiempresa + CRUD de ativos | 60 | 3.0 | 0.8 | 6 | 24.0 | - | Base do sistema |
10
- | P0 | Monitoramento de disponibilidade + status | 60 | 3.0 | 0.7 | 8 | 15.8 | Inventario | Checks ICMP/TCP |
11
- | P1 | Alertas (regras + notificacao) | 60 | 2.0 | 0.7 | 6 | 14.0 | Monitoramento | SLA alerta <= 2 min |
12
- | P1 | Storage/NAS (capacidade/uso) | 10 | 2.0 | 0.6 | 4 | 3.0 | Inventario | Medir volumes |
13
- | P2 | Relatorios mensais + export CSV | 5 | 1.5 | 0.6 | 4 | 1.1 | Monitoramento | Foco em uptime |
14
- | P2 | Deploy Dokploy + Debian 13 | 1 | 2.5 | 0.8 | 3 | 0.7 | - | Bloqueador de validacao final |
15
- | P3 | Observabilidade (Prometheus/Grafana) | 1 | 2.0 | 0.6 | 3 | 0.4 | Monitoramento | /metrics + dashboard |
1
+ # Backlog
2
+
3
+ Priorizacao via RICE (Reach x Impact x Confidence / Effort).
4
+
5
+ Assumptions: 1 usuario, ~5 empresas, ~60 ativos, 2 NAS.
6
+
7
+ | Prioridade | Item | Reach | Impact | Confidence | Effort | RICE | Dependencias | Notas |
8
+ |---|---:|---:|---:|---:|---:|---:|---|---|
9
+ | P0 | Inventario multiempresa + CRUD de ativos | 60 | 3.0 | 0.8 | 6 | 24.0 | - | Base do sistema |
10
+ | P0 | Monitoramento de disponibilidade + status | 60 | 3.0 | 0.7 | 8 | 15.8 | Inventario | Checks ICMP/TCP |
11
+ | P1 | Alertas (regras + notificacao) | 60 | 2.0 | 0.7 | 6 | 14.0 | Monitoramento | SLA alerta <= 2 min |
12
+ | P1 | Storage/NAS (capacidade/uso) | 10 | 2.0 | 0.6 | 4 | 3.0 | Inventario | Medir volumes |
13
+ | P2 | Relatorios mensais + export CSV | 5 | 1.5 | 0.6 | 4 | 1.1 | Monitoramento | Foco em uptime |
14
+ | P2 | Deploy Dokploy + Debian 13 | 1 | 2.5 | 0.8 | 3 | 0.7 | - | Bloqueador de validacao final |
15
+ | P3 | Observabilidade (Prometheus/Grafana) | 1 | 2.0 | 0.6 | 3 | 0.4 | Monitoramento | /metrics + dashboard |
@@ -1,27 +1,24 @@
1
- # Sprint Atual
2
-
3
- ## Projeto
4
- framework-root (o repo do Forja — produtos vivem no workspace, ADR-0019)
5
-
6
- ## Objetivos
7
- - Fechar a classe de falha "erra sem avisar" (ADR-0021) com gates executáveis, não correções pontuais.
8
-
9
- ## Itens da Sprint
10
- - [x] SPEC-009 — Doctor do núcleo (`specs/doctor-do-nucleo/`, ADR-0023)
11
- `tools:doctor` deixa de auditar só ferramentas opcionais e passa a ser gate do núcleo:
12
- ABI nativa, memória, workspace, deps de runtime, `.mcp.json`. Exit 1 no que trava o fluxo.
1
+ # Sprint Atual
2
+
3
+ ## Projeto
4
+ framework-root (o repo do Forja — produtos vivem no workspace, ADR-0019)
5
+
6
+ ## Objetivos
7
+ - Fechar a classe de falha "erra sem avisar" (ADR-0021) com gates executáveis, não correções pontuais.
8
+
9
+ ## Itens da Sprint
10
+ - [x] SPEC-009 — Doctor do núcleo (`specs/doctor-do-nucleo/`, ADR-0023)
11
+ `tools:doctor` deixa de auditar só ferramentas opcionais e passa a ser gate do núcleo:
12
+ ABI nativa, memória, workspace, deps de runtime, `.mcp.json`. Exit 1 no que trava o fluxo.
13
13
  - [x] `spec:new` mantém a allow-list do `.gitignore` — spec nova do framework nascia invisível ao git.
14
-
15
- ## Próximos candidatos (sem spec ainda)
16
- - `release-auditor` consumindo `lib/core/health.mjs` em vez de heurística própria — é a terceira
17
- superfície prevista no ADR-0023 e a única que ainda não migrou.
18
- - Checks de núcleo no CI (`tools:doctor` como step), fechando o ciclo: hoje o CI roda os testes,
19
- mas não o gate.
20
-
21
- ## Ritual CLI
22
- - Planejar: npm run gsd:plan -- <slug> "<objetivo>"
23
- - Handoff spec: npm run gsd:handoff -- spec <slug>
24
- - Handoff plan: npm run gsd:handoff -- plan <slug>
25
- - Handoff implement: npm run gsd:handoff -- implement <slug>
26
- - Validar: npm run gsd:check -- <slug>
27
- - Governança: npm run project:check && npm run tools:doctor
14
+ - [x] SPEC-022 — Release Auditor consome a saúde canônica (`specs/release-auditor-health/`)
15
+ `tools:doctor` passa a anteceder o gate estrito `release:check --publish`, sem probes duplicados
16
+ e sem substituir o modo de publicação por `check:all --full`.
17
+
18
+ ## Ritual CLI
19
+ - Planejar: npm run gsd:plan -- <slug> "<objetivo>"
20
+ - Handoff spec: npm run gsd:handoff -- spec <slug>
21
+ - Handoff plan: npm run gsd:handoff -- plan <slug>
22
+ - Handoff implement: npm run gsd:handoff -- implement <slug>
23
+ - Validar: npm run gsd:check -- <slug>
24
+ - Governança: npm run project:check && npm run tools:doctor
@@ -1,55 +1,55 @@
1
- # GSD + Hermes Harness
2
-
3
- GSD e a camada operacional que liga SDD, sprints e handoffs Hermes por linha de comando. `design-md` entra somente quando ha impacto visual.
4
-
5
- ## Contratos
6
-
7
- - `gsd:plan` cria `.context/gsd-<slug>.md` com gates verificaveis.
8
- - `gsd:handoff` registra passagens padronizadas no SQLite via Hermes.
9
- - `gsd:check` valida runbook, spec e indice codegraph. Brief visual e opcional em fluxo CLI-only.
10
- - `code:check` valida indice codegraph (worktree + freshness) — gate de code intelligence (ADR-0017).
11
- - `code:impact <simbolo>` mostra chamadores e blast radius antes de editar.
12
- - `tools:doctor` faz o raio-x das ferramentas de processo (ADR-0018).
13
- - `design:select` escolhe referencias locais de `design-md/`.
14
- - `design:check` bloqueia brief incompleto antes de implementacao visual.
15
-
16
- ## Sequencia padrao
17
-
18
- Todo projeto deve andar em steps, sem pular briefing, estrutura, sprints e validacao:
19
-
20
- 1. Briefing, com slug gerado
21
- 2. Estrutura do projeto
22
- 3. Sprints definidas
23
- 4. Contexto inteligente montado
24
- 5. Mapa de impacto via codegraph (`code:check` + `code:impact`) — ADR-0017
25
- 6. Spec de produto aprovada
26
- 7. Brief visual validado somente se houver UI
27
- 8. Plano tecnico e ADRs definidos
28
- 9. Desenvolvimento por Worker
29
- 10. Validacao dos passos
30
- 11. Gate final de Governance (inclui `code:check` e `tools:doctor`)
31
-
32
- ```bash
33
- npm run dev -- gsd:plan <slug> "<objetivo>"
34
- npm run dev -- gsd:handoff spec <slug>
35
- npm run dev -- gsd:handoff plan <slug>
36
- npm run dev -- gsd:handoff implement <slug>
37
- npm run dev -- gsd:handoff review <slug>
38
- npm run dev -- gsd:check <slug>
39
- ```
40
-
41
- Se a entrega tiver UI:
42
-
43
- ```bash
44
- npm run dev -- design:select <surface> <tom>
45
- npm run dev -- design:check <brief.md>
46
- npm run dev -- gsd:check <slug> <brief.md>
47
- ```
48
-
49
- ## Uso por papel
50
-
51
- - Orchestrator: inicia `gsd:plan` e registra `gsd:handoff spec`.
52
- - Product: garante que `spec.md` tenha dor, escopo, AC e metrica 30d.
53
- - SDD Architect: roda `code:impact` para fundamentar modulos afetados, transforma spec aprovada em plan/tasks e registra implementacao.
54
- - Worker: roda `code:impact <simbolo>` antes de editar, implementa dentro do ownership e devolve review.
55
- - Governance: roda `gsd:check`, `code:check`, `tools:doctor`, `spec:check`, testes e `project:check`.
1
+ # GSD + Hermes Harness
2
+
3
+ GSD e a camada operacional que liga SDD, sprints e handoffs Hermes por linha de comando. `design-md` entra somente quando ha impacto visual.
4
+
5
+ ## Contratos
6
+
7
+ - `gsd:plan` cria `.context/gsd-<slug>.md` com gates verificaveis.
8
+ - `gsd:handoff` registra passagens padronizadas no SQLite via Hermes.
9
+ - `gsd:check` valida runbook, spec e indice codegraph. Brief visual e opcional em fluxo CLI-only.
10
+ - `code:check` valida indice codegraph (worktree + freshness) — gate de code intelligence (ADR-0017).
11
+ - `code:impact <simbolo>` mostra chamadores e blast radius antes de editar.
12
+ - `tools:doctor` faz o raio-x das ferramentas de processo (ADR-0018).
13
+ - `design:select` escolhe referencias locais de `design-md/`.
14
+ - `design:check` bloqueia brief incompleto antes de implementacao visual.
15
+
16
+ ## Sequencia padrao
17
+
18
+ Todo projeto deve andar em steps, sem pular briefing, estrutura, sprints e validacao:
19
+
20
+ 1. Briefing, com slug gerado
21
+ 2. Estrutura do projeto
22
+ 3. Sprints definidas
23
+ 4. Contexto inteligente montado
24
+ 5. Mapa de impacto via codegraph (`code:check` + `code:impact`) — ADR-0017
25
+ 6. Spec de produto aprovada
26
+ 7. Brief visual validado somente se houver UI
27
+ 8. Plano tecnico e ADRs definidos
28
+ 9. Desenvolvimento por Worker
29
+ 10. Validacao dos passos
30
+ 11. Gate final de Governance (inclui `code:check` e `tools:doctor`)
31
+
32
+ ```bash
33
+ npm run dev -- gsd:plan <slug> "<objetivo>"
34
+ npm run dev -- gsd:handoff spec <slug>
35
+ npm run dev -- gsd:handoff plan <slug>
36
+ npm run dev -- gsd:handoff implement <slug>
37
+ npm run dev -- gsd:handoff review <slug>
38
+ npm run dev -- gsd:check <slug>
39
+ ```
40
+
41
+ Se a entrega tiver UI:
42
+
43
+ ```bash
44
+ npm run dev -- design:select <surface> <tom>
45
+ npm run dev -- design:check <brief.md>
46
+ npm run dev -- gsd:check <slug> <brief.md>
47
+ ```
48
+
49
+ ## Uso por papel
50
+
51
+ - Orchestrator: inicia `gsd:plan` e registra `gsd:handoff spec`.
52
+ - Product: garante que `spec.md` tenha dor, escopo, AC e metrica 30d.
53
+ - SDD Architect: roda `code:impact` para fundamentar modulos afetados, transforma spec aprovada em plan/tasks e registra implementacao.
54
+ - Worker: roda `code:impact <simbolo>` antes de editar, implementa dentro do ownership e devolve review.
55
+ - Governance: roda `gsd:check`, `code:check`, `tools:doctor`, `spec:check`, testes e `project:check`.