forjajs 2.0.3 → 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 (701) 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 -339
  21. package/README.pt-BR.md +345 -345
  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/bin/create-memory-nest-kit.js +17 -17
  329. package/dist/bin/forja.js +14 -2
  330. package/dist/bin/init-project.js +38 -38
  331. package/dist/lib/audit.js +7 -7
  332. package/dist/lib/context-builder.js +32 -32
  333. package/dist/lib/core/doc-graph.js +6 -4
  334. package/dist/lib/core/registry.d.ts +54 -0
  335. package/dist/lib/core/registry.js +55 -0
  336. package/dist/lib/core/release.d.ts +53 -0
  337. package/dist/lib/core/release.js +5 -1
  338. package/dist/lib/generators/memory-generator.js +700 -698
  339. package/dist/lib/generators/nest-generator.js +398 -398
  340. package/dist/lib/generators/readme-generator.js +180 -180
  341. package/dist/lib/governance-report.js +39 -39
  342. package/dist/lib/project-upgrade.js +1 -1
  343. package/dist/lib/workspace.d.ts +7 -0
  344. package/dist/lib/workspace.js +63 -34
  345. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  346. package/dist/packages/llm/src/index.d.ts +43 -0
  347. package/dist/packages/llm/src/index.js +108 -0
  348. package/dist/scripts/agent-harness.js +66 -64
  349. package/dist/scripts/agent-router.js +20 -20
  350. package/dist/scripts/build-smart-context.js +22 -22
  351. package/dist/scripts/compress-memory.js +8 -8
  352. package/dist/scripts/context-ops.js +29 -29
  353. package/dist/scripts/demo-autonomy.js +2 -2
  354. package/dist/scripts/demo-workspace.d.ts +6 -0
  355. package/dist/scripts/demo-workspace.js +101 -0
  356. package/dist/scripts/dev.js +13 -13
  357. package/dist/scripts/extract-global-knowledge.js +5 -5
  358. package/dist/scripts/generate-dashboard.js +11 -11
  359. package/dist/scripts/llm-fit.js +131 -0
  360. package/dist/scripts/memory-schema.js +48 -48
  361. package/dist/scripts/query-universal-memory.js +13 -13
  362. package/dist/scripts/sprint-manager.js +39 -39
  363. package/dist/scripts/sync-universal-memory.js +63 -50
  364. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  365. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  366. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  367. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  368. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  369. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  370. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  371. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  372. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  373. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  374. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  375. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  376. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  377. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  378. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  379. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  380. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  381. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  382. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  383. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  384. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  385. package/docs/agent-harnesses.md +149 -149
  386. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  387. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  388. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  389. package/docs/archive/FASE2-SUMMARY.md +263 -263
  390. package/docs/archive/FASE3-PROGRESS.md +355 -355
  391. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  392. package/docs/archive/INDICE-MASTER.md +282 -282
  393. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  394. package/docs/archive/README-REFINAMENTO.md +293 -293
  395. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  396. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  397. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  398. package/docs/archive/START-HERE.md +319 -319
  399. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  400. package/docs/archive/examples/v1/AGENTS.md +10 -10
  401. package/docs/archive/examples/v1/README.md +36 -36
  402. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  403. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  404. package/docs/archive/examples/v1/backend/package.json +42 -42
  405. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  406. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  407. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  408. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  409. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  410. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  411. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  412. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  413. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  414. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  415. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  416. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  417. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  418. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  419. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  420. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  421. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  422. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  423. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  424. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  425. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  426. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  427. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  428. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  429. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  430. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  431. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  433. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  434. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  435. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  436. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  437. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  438. package/docs/archive/examples/v2/AGENTS.md +16 -16
  439. package/docs/archive/examples/v2/README.md +35 -35
  440. package/docs/archive/examples/v2/agents/README.md +3 -3
  441. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  442. package/docs/archive/examples/v2/agents/dba.md +4 -4
  443. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  444. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  445. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  446. package/docs/archive/examples/v2/agents/security.md +4 -4
  447. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  448. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  449. package/docs/archive/examples/v2/backend/package.json +42 -42
  450. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  451. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  452. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  453. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  454. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  455. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  456. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  457. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  458. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  459. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  460. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  461. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  462. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  463. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  464. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  465. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  466. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  467. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  468. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  469. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  470. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  471. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  472. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  473. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  474. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  475. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  476. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  477. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  479. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  480. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  481. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  482. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  483. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  484. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  485. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  486. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  487. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  488. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  489. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  490. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  491. package/docs/archive/examples/v2/memory/README.md +8 -8
  492. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  493. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  494. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  495. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  496. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  497. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  498. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  499. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  500. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  501. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  502. package/docs/capacidades-externas.md +86 -86
  503. package/docs/cli-first-operacao.md +74 -74
  504. package/docs/dev-workflow.md +421 -421
  505. package/docs/examples.md +546 -546
  506. package/docs/fluxo.md +103 -103
  507. package/docs/glossary.md +453 -453
  508. package/docs/init-project.md +457 -457
  509. package/docs/llm-fit-loop.md +41 -0
  510. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  511. package/docs/modos-de-operacao.md +52 -0
  512. package/docs/personas/architect/README.md +333 -333
  513. package/docs/personas/developer/README.md +371 -371
  514. package/docs/personas/executive/README.md +172 -172
  515. package/docs/personas/qa/README.md +350 -350
  516. package/docs/processo-projeto.md +138 -138
  517. package/docs/produto/factsheet-marketing.md +151 -0
  518. package/docs/produto/roteiro-demo.md +47 -0
  519. package/docs/publishing.md +377 -377
  520. package/docs/quick-reference.md +409 -409
  521. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  522. package/docs/structure.md +360 -360
  523. package/docs/token-optimization.md +502 -502
  524. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  525. package/memory/00-global/mission.md +15 -15
  526. package/memory/00-global/shared-knowledge.md +8 -8
  527. package/memory/00-global/standards.md +47 -47
  528. package/memory/10-product/personas.md +21 -21
  529. package/memory/10-product/vision.md +27 -27
  530. package/memory/30-projects/README.md +15 -15
  531. package/memory/40-delivery/backlog.md +15 -15
  532. package/memory/40-delivery/current-sprint.md +23 -26
  533. package/memory/50-orchestration/gsd-harness.md +55 -55
  534. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  535. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  536. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  537. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  538. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  539. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  540. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  541. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  542. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  543. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  544. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  545. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  546. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  547. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  548. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  549. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  550. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  551. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  552. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  553. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  554. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  555. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  556. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  557. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  558. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  559. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  560. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  561. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  562. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  563. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  564. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  565. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  566. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  567. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  568. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  569. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  570. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  571. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  572. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  573. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  574. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  575. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  576. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  577. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  578. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  579. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  580. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  581. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  582. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  583. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  584. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  585. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  586. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  587. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  588. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  589. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  590. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  591. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  592. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  593. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  594. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  595. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  596. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  597. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  598. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  599. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  600. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  601. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  602. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  603. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  604. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  605. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  606. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  607. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  608. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  609. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  610. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  611. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  612. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  613. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  614. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  615. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  616. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  617. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  618. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  619. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  620. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  621. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  622. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  623. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  624. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  625. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  626. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  627. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  628. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  629. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  630. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  631. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  632. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  633. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  634. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  635. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  636. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  637. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  638. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  639. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  640. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  641. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  642. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  643. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  644. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  645. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  646. package/memory/90-decisions/_template.md +28 -28
  647. package/package.json +157 -150
  648. package/prompts/context-engineer-agent.md +19 -19
  649. package/prompts/governance-agent.md +16 -16
  650. package/prompts/marketing-agent.md +13 -13
  651. package/prompts/orchestrator-agent.md +18 -18
  652. package/prompts/product-agent.md +13 -13
  653. package/prompts/sdd-architect-agent.md +20 -20
  654. package/specs/README.md +70 -70
  655. package/specs/_templates/plan.md +43 -43
  656. package/specs/_templates/spec.md +43 -43
  657. package/specs/_templates/tasks.md +32 -32
  658. package/specs/clean-arch-boilerplate/plan.md +137 -137
  659. package/specs/clean-arch-boilerplate/spec.md +121 -121
  660. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  661. package/specs/cli-first-operacao/plan.md +53 -53
  662. package/specs/cli-first-operacao/spec.md +53 -53
  663. package/specs/cli-first-operacao/tasks.md +53 -53
  664. package/specs/code-context/spec.md +56 -56
  665. package/specs/coerencia-do-sistema/plan.md +155 -155
  666. package/specs/coerencia-do-sistema/spec.md +123 -123
  667. package/specs/coerencia-do-sistema/tasks.md +115 -115
  668. package/specs/dev-token-assets-db/plan.md +71 -71
  669. package/specs/dev-token-assets-db/spec.md +58 -58
  670. package/specs/dev-token-assets-db/tasks.md +58 -58
  671. package/specs/doctor-do-nucleo/plan.md +165 -165
  672. package/specs/doctor-do-nucleo/spec.md +139 -139
  673. package/specs/doctor-do-nucleo/tasks.md +172 -172
  674. package/specs/forja-core/spec.md +71 -71
  675. package/specs/gates/spec.md +63 -63
  676. package/specs/governanca-visivel/plan.md +122 -122
  677. package/specs/governanca-visivel/spec.md +112 -112
  678. package/specs/governanca-visivel/tasks.md +60 -60
  679. package/specs/harness-codegraph/spec.md +71 -71
  680. package/specs/memory-audit/spec.md +54 -54
  681. package/specs/orchestrate/spec.md +108 -108
  682. package/specs/orchestration-coherent/spec.md +95 -95
  683. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  684. package/specs/project-smoke/spec.md +96 -96
  685. package/specs/project-upgrade/spec.md +58 -58
  686. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  687. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  688. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  689. package/specs/release-auditor-health/plan.md +88 -0
  690. package/specs/release-auditor-health/spec.md +82 -0
  691. package/specs/release-auditor-health/tasks.md +72 -0
  692. package/specs/release-gate/plan.md +174 -174
  693. package/specs/release-gate/spec.md +122 -122
  694. package/specs/release-gate/tasks.md +183 -183
  695. package/specs/ts-migration/plan.md +200 -200
  696. package/specs/ts-migration/spec.md +119 -119
  697. package/specs/ts-migration/tasks.md +110 -110
  698. package/dist/scripts/server-persistence-probe.d.ts +0 -1
  699. package/dist/scripts/server-persistence-probe.js +0 -52
  700. package/dist/scripts/server-persistence-probe.mjs +0 -52
  701. /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
@@ -1,1014 +1,1014 @@
1
- # Manual Operacional CLI-First, SDD, GSD e Orquestracao
2
-
3
- Este manual e o guia principal para operar o framework de agentes com excelencia, sem depender do dashboard web. A web fica como consulta opcional. A operacao diaria, o acompanhamento de sprint, as passagens entre papeis, a validacao e a governanca acontecem por linha de comando.
4
-
5
- ## 1. Visao Geral
6
-
7
- O framework organiza desenvolvimento com agentes em quatro pilares:
8
-
9
- 1. **Orquestracao**: cada demanda passa pelo papel certo, no momento certo.
10
- 2. **SDD**: toda entrega relevante e descrita antes como `spec -> plan -> tasks`.
11
- 3. **GSD**: cada execucao vira um runbook com gates verificaveis.
12
- 4. **Hermes**: toda passagem de responsabilidade vira handoff registrado com 7 campos obrigatorios.
13
-
14
- O objetivo nao e criar burocracia. O objetivo e impedir retrabalho, decisao perdida, implementacao sem criterio de aceite e sprint sem visibilidade.
15
-
16
- ## 2. Mentalidade CLI-First
17
-
18
- Use o terminal como console operacional. O dashboard nao deve ser necessario para responder:
19
-
20
- - O que esta na sprint?
21
- - Qual spec esta ativa?
22
- - Quem recebeu o handoff?
23
- - O que falta para implementar?
24
- - A entrega passou nos gates?
25
- - O projeto esta pronto para release?
26
-
27
- Comandos centrais:
28
-
29
- ```bash
30
- npm run sprint:status
31
- npm run gsd:plan -- <slug> "<objetivo>"
32
- npm run gsd:handoff -- spec <slug>
33
- npm run gsd:handoff -- plan <slug>
34
- npm run gsd:handoff -- implement <slug>
35
- npm run gsd:handoff -- review <slug>
36
- npm run gsd:check -- <slug>
37
- npm run project:check
38
- ```
39
-
40
- ## 3. Estrutura do Framework
41
-
42
- Pastas principais:
43
-
44
- ```text
45
- AGENTS.md Papéis e regras canonicas
46
- prompts/ Prompts portaveis por papel
47
- .claude/agents/ Sub-agents Claude Code
48
- specs/ Pipeline SDD por feature
49
- memory/40-delivery/ Backlog e sprint atual
50
- memory/50-orchestration/ Protocolos de orquestracao
51
- memory/90-decisions/ ADRs e decisoes estruturais
52
- scripts/ Harness CLI, sprint, specs, checks
53
- .context/ Runbooks GSD e context packs
54
- dashboard/ Web opcional/legada
55
- ```
56
-
57
- Arquivos que voce vai abrir com frequencia:
58
-
59
- ```bash
60
- AGENTS.md
61
- docs/manual-operacional-cli-sdd-gsd.md
62
- docs/cli-first-operacao.md
63
- memory/40-delivery/backlog.md
64
- memory/40-delivery/current-sprint.md
65
- memory/50-orchestration/gsd-harness.md
66
- specs/<slug>/spec.md
67
- specs/<slug>/plan.md
68
- specs/<slug>/tasks.md
69
- .context/gsd-<slug>.md
70
- ```
71
-
72
- ## 4. Os 6 Papeis
73
-
74
- Cada papel existe em tres lugares:
75
-
76
- - `.claude/agents/<name>.md`: sub-agent executavel no Claude Code.
77
- - `prompts/<name>-agent.md`: prompt portavel para Copilot, Gemini, Codex etc.
78
- - `AGENTS.md`: referencia canonica de responsabilidade.
79
-
80
- ### 4.1 Orchestrator
81
-
82
- Use quando a demanda atravessa multiplos papeis ou quando voce quer coordenar uma execucao.
83
-
84
- Responsabilidades:
85
-
86
- - Decompor a demanda.
87
- - Escolher o proximo papel.
88
- - Criar ou acionar runbook GSD.
89
- - Registrar handoffs Hermes.
90
- - Consolidar memoria ao fim de sprint.
91
-
92
- Nao faz:
93
-
94
- - Implementacao direta.
95
- - Decisao de produto sozinho.
96
- - Aprovar release sem Governance.
97
-
98
- Comandos tipicos:
99
-
100
- ```bash
101
- npm run gsd:plan -- <slug> "<objetivo>"
102
- npm run gsd:handoff -- spec <slug>
103
- npm run gsd:handoff -- plan <slug>
104
- npm run gsd:handoff -- implement <slug>
105
- npm run gsd:handoff -- review <slug>
106
- ```
107
-
108
- ### 4.2 Context Engineer
109
-
110
- Use antes de tarefa pesada, refator multi-arquivo, analise longa ou quando o assunto envolve tokens/cache.
111
-
112
- Responsabilidades:
113
-
114
- - Montar contexto inteligente.
115
- - Gerar `.context/context-*.md`.
116
- - Medir e reduzir tokens.
117
- - Compactar memoria quando necessario.
118
-
119
- Comandos tipicos:
120
-
121
- ```bash
122
- npm run dev -- context:build global <projeto>
123
- npm run dev -- context:build domain <projeto> "<dominio>"
124
- npm run dev -- context:build task <slug> "<palavras-chave>"
125
- npm run memory:vacuum
126
- ```
127
-
128
- ### 4.3 Product
129
-
130
- Use quando ainda nao esta claro o que deve ser entregue.
131
-
132
- Responsabilidades:
133
-
134
- - Criar `spec.md`.
135
- - Definir problema, proposta de valor, user stories e escopo.
136
- - Definir metrica de sucesso em 30 dias.
137
- - Priorizar backlog via RICE.
138
-
139
- Comandos tipicos:
140
-
141
- ```bash
142
- npm run spec:new -- <slug>
143
- npm run spec:check -- <slug>
144
- ```
145
-
146
- ### 4.4 SDD Architect
147
-
148
- Use quando a spec esta aprovada e precisa virar plano tecnico.
149
-
150
- Responsabilidades:
151
-
152
- - Criar `plan.md`.
153
- - Criar `tasks.md`.
154
- - Abrir ADRs quando houver decisao estrutural.
155
- - Recusar specs vagas.
156
-
157
- Comandos tipicos:
158
-
159
- ```bash
160
- npm run spec:plan -- <slug>
161
- npm run spec:tasks -- <slug>
162
- npm run gsd:handoff -- plan <slug>
163
- ```
164
-
165
- ### 4.5 Marketing
166
-
167
- Use antes de release, landing, copy, posicionamento, instrumentacao AARRR ou analise pos-launch.
168
-
169
- Responsabilidades:
170
-
171
- - Escrever copy conectada a dor da spec.
172
- - Propor eventos de funil.
173
- - Analisar metricas reais.
174
-
175
- Nao faz:
176
-
177
- - Inventar numeros.
178
- - Decidir arquitetura.
179
- - Mudar escopo tecnico.
180
-
181
- ### 4.6 Governance
182
-
183
- Use antes de merge, release ou encerramento de sprint.
184
-
185
- Responsabilidades:
186
-
187
- - Rodar checks.
188
- - Auditar handoffs.
189
- - Validar criterios de aceite.
190
- - Bloquear entrega se houver risco, falta de spec, falta de teste ou quebra de seguranca.
191
-
192
- Comandos tipicos:
193
-
194
- ```bash
195
- npm run gsd:check -- <slug>
196
- npm run spec:check -- <slug>
197
- npm test
198
- npm run project:check
199
- ```
200
-
201
- ## 5. Fluxo SDD
202
-
203
- SDD significa Spec-Driven Development. O codigo so deve vir depois de clareza.
204
-
205
- Fluxo:
206
-
207
- ```text
208
- Product -> spec.md -> por que fazer
209
- SDD Architect -> plan.md -> como fazer
210
- SDD Architect -> tasks.md -> passos executaveis
211
- Worker -> codigo -> implementacao
212
- Governance -> checks -> validacao
213
- ```
214
-
215
- ### 5.1 Spec
216
-
217
- Arquivo:
218
-
219
- ```text
220
- specs/<slug>/spec.md
221
- ```
222
-
223
- Deve responder:
224
-
225
- - Qual problema esta sendo resolvido?
226
- - Quem sente essa dor?
227
- - O que fica dentro e fora do escopo?
228
- - Quais criterios de aceite provam que acabou?
229
- - Quais restricoes existem?
230
- - Qual metrica de sucesso em 30 dias?
231
-
232
- Criar spec:
233
-
234
- ```bash
235
- npm run spec:new -- <slug>
236
- ```
237
-
238
- Validar spec:
239
-
240
- ```bash
241
- npm run spec:check -- <slug>
242
- ```
243
-
244
- ### 5.2 Plan
245
-
246
- Arquivo:
247
-
248
- ```text
249
- specs/<slug>/plan.md
250
- ```
251
-
252
- Deve responder:
253
-
254
- - Qual abordagem tecnica?
255
- - Quais modulos mudam?
256
- - Quais contratos/API/CLI/schema mudam?
257
- - Quais decisoes foram tomadas?
258
- - Quais alternativas foram rejeitadas?
259
- - Precisa de ADR?
260
-
261
- Gerar plan:
262
-
263
- ```bash
264
- npm run spec:plan -- <slug>
265
- ```
266
-
267
- Regra: `spec:plan` so deve rodar quando a spec estiver aprovada.
268
-
269
- ### 5.3 Tasks
270
-
271
- Arquivo:
272
-
273
- ```text
274
- specs/<slug>/tasks.md
275
- ```
276
-
277
- Deve conter tarefas executaveis com:
278
-
279
- - ID da tarefa.
280
- - Owner.
281
- - Dependencias.
282
- - Paths afetados.
283
- - Criterio de done.
284
-
285
- Gerar tasks:
286
-
287
- ```bash
288
- npm run spec:tasks -- <slug>
289
- ```
290
-
291
- Regra: `spec:tasks` so deve rodar quando o plano estiver aprovado.
292
-
293
- ## 6. Fluxo GSD
294
-
295
- GSD e o harness de execucao. Ele cria e valida um runbook para a entrega.
296
-
297
- Criar runbook:
298
-
299
- ```bash
300
- npm run gsd:plan -- <slug> "<objetivo>"
301
- ```
302
-
303
- Isso gera:
304
-
305
- ```text
306
- .context/gsd-<slug>.md
307
- ```
308
-
309
- Esse arquivo acompanha os gates:
310
-
311
- 1. Briefing.
312
- 2. Estrutura.
313
- 3. Sprints.
314
- 4. Contexto.
315
- 5. Spec.
316
- 6. Design, somente se houver UI.
317
- 7. Plano.
318
- 8. Desenvolvimento.
319
- 9. Validacao.
320
- 10. Governance.
321
-
322
- Validar:
323
-
324
- ```bash
325
- npm run gsd:check -- <slug>
326
- ```
327
-
328
- Se houver impacto visual:
329
-
330
- ```bash
331
- npm run design:select -- agent-console tecnico
332
- npm run design:check -- design-md/examples/agent-console-brief.md
333
- npm run gsd:check -- <slug> design-md/examples/agent-console-brief.md
334
- ```
335
-
336
- Se nao houver UI, nao passe brief. O fluxo CLI-only nao deve ser bloqueado por design.
337
-
338
- ## 7. Handoffs Hermes
339
-
340
- Handoff e passagem formal de responsabilidade.
341
-
342
- Todo handoff precisa dos 7 campos da ADR-0005:
343
-
344
- | Campo | Significado |
345
- |---|---|
346
- | `from` | Quem esta entregando |
347
- | `to` | Quem recebe |
348
- | `intent` | Intencao da passagem |
349
- | `context` | Contexto minimo para continuar |
350
- | `acceptance` | Como saber que o trabalho foi aceito |
351
- | `constraints` | Restrições obrigatorias |
352
- | `return` | Para quem devolver |
353
-
354
- Comando generico:
355
-
356
- ```bash
357
- npm run hermes:handoff -- '{"from":"orchestrator","to":"product","intent":"spec","context":"specs/<slug>","acceptance":"spec aprovada com AC testaveis","constraints":"pt-BR; nao implementar codigo","return":"orchestrator"}'
358
- ```
359
-
360
- Atalhos do GSD:
361
-
362
- ```bash
363
- npm run gsd:handoff -- spec <slug>
364
- npm run gsd:handoff -- plan <slug>
365
- npm run gsd:handoff -- implement <slug>
366
- npm run gsd:handoff -- review <slug>
367
- ```
368
-
369
- Ordem recomendada:
370
-
371
- ```text
372
- Orchestrator -> Product spec
373
- Product -> SDD Architect plan
374
- SDD Architect-> Worker implement
375
- Worker -> Governance review
376
- Governance -> Orchestrator fechamento
377
- ```
378
-
379
- ## 8. Sprints
380
-
381
- O acompanhamento de sprint fica em:
382
-
383
- ```text
384
- memory/40-delivery/current-sprint.md
385
- ```
386
-
387
- O backlog fica em:
388
-
389
- ```text
390
- memory/40-delivery/backlog.md
391
- ```
392
-
393
- ### 8.1 Iniciar sprint no framework raiz
394
-
395
- ```bash
396
- npm run sprint:start
397
- ```
398
-
399
- O script busca itens de alta prioridade. Se o backlog estiver em tabela RICE, ele seleciona itens `P0` e `P1`.
400
-
401
- ### 8.2 Ver status
402
-
403
- ```bash
404
- npm run sprint:status
405
- ```
406
-
407
- ### 8.3 Encerrar sprint
408
-
409
- ```bash
410
- npm run sprint:complete
411
- ```
412
-
413
- O fechamento cria relatorio em:
414
-
415
- ```text
416
- memory/60-runs/sprint-close-<timestamp>.md
417
- ```
418
-
419
- ### 8.4 Operar sprint de um projeto no workspace
420
-
421
- ```bash
422
- npm run sprint:start -- NomeDoProjeto
423
- npm run sprint:status -- NomeDoProjeto
424
- npm run sprint:complete -- NomeDoProjeto
425
- ```
426
-
427
- Os projetos de produto vivem em `~/forja-workspace/projects/<NomeDoProjeto>` (configurável via `FORJA_WORKSPACE` ou `~/.forjarc.json`). Veja ADR-0019.
428
-
429
- ## 9. Rotina Recomendada
430
-
431
- ### 9.1 Inicio do dia
432
-
433
- ```bash
434
- git status --short
435
- npm run sprint:status
436
- npm run spec:check
437
- ```
438
-
439
- Leia:
440
-
441
- ```bash
442
- memory/40-delivery/current-sprint.md
443
- ```
444
-
445
- Escolha uma entrega e confirme se existe:
446
-
447
- ```text
448
- specs/<slug>/spec.md
449
- specs/<slug>/plan.md
450
- specs/<slug>/tasks.md
451
- ```
452
-
453
- ### 9.2 Antes de mexer em codigo
454
-
455
- ```bash
456
- npm run dev -- context:build task <slug> "<palavras-chave>"
457
- npm run gsd:plan -- <slug> "<objetivo>"
458
- npm run gsd:handoff -- implement <slug>
459
- ```
460
-
461
- Leia:
462
-
463
- ```text
464
- .context/gsd-<slug>.md
465
- specs/<slug>/tasks.md
466
- ```
467
-
468
- ### 9.3 Durante a implementacao
469
-
470
- Mantenha foco em:
471
-
472
- - Paths definidos em `tasks.md`.
473
- - Criterios de aceite da spec.
474
- - Contratos do plano.
475
- - Nenhuma refatoracao fora do escopo.
476
-
477
- Checklist local:
478
-
479
- ```bash
480
- npm run spec:check -- <slug>
481
- npm run gsd:check -- <slug>
482
- ```
483
-
484
- ### 9.4 Antes de entregar
485
-
486
- ```bash
487
- npm run gsd:handoff -- review <slug>
488
- npm run gsd:check -- <slug>
489
- npm run spec:check -- <slug>
490
- npm test
491
- npm run project:check
492
- ```
493
-
494
- Se algum comando falhar, nao entregue como pronto. Registre a pendencia no handoff ou em `tasks.md`.
495
-
496
- ### 9.5 Fechamento da sprint
497
-
498
- ```bash
499
- npm run sprint:status
500
- npm run sprint:complete
501
- ```
502
-
503
- Depois consolide memoria:
504
-
505
- ```bash
506
- npm run memory:vacuum
507
- npm run sync:universal
508
- ```
509
-
510
- ## 10. Governanca
511
-
512
- Governance nao e opiniao. Governance e evidencia.
513
-
514
- Uma entrega so esta pronta quando:
515
-
516
- - A spec existe e esta coerente.
517
- - O plano existe quando houve decisao tecnica.
518
- - As tasks refletem o que foi implementado.
519
- - O GSD check passa.
520
- - Testes relevantes passaram.
521
- - `project:check` passou.
522
- - Handoffs foram registrados.
523
- - Riscos residuais foram explicitados.
524
-
525
- Comandos:
526
-
527
- ```bash
528
- npm run gsd:check -- <slug>
529
- npm run spec:check -- <slug>
530
- npm test
531
- npm run project:check
532
- ```
533
-
534
- `project:check` sem argumento valida o framework raiz. Com argumento, valida projeto em `~/forja-workspace/projects/<nome>`.
535
-
536
- ```bash
537
- npm run project:check
538
- npm run project:check -- NomeDoProjeto
539
- ```
540
-
541
- ## 11. Contexto e Memoria
542
-
543
- Use contexto inteligente para reduzir custo mental e tokens.
544
-
545
- Modos:
546
-
547
- | Modo | Uso |
548
- |---|---|
549
- | `global` | Entender padroes gerais |
550
- | `domain` | Entender um dominio especifico |
551
- | `task` | Executar uma entrega |
552
-
553
- Comandos:
554
-
555
- ```bash
556
- npm run dev -- context:build global <projeto>
557
- npm run dev -- context:build domain <projeto> "<dominio>"
558
- npm run dev -- context:build task <slug> "<palavras-chave>"
559
- ```
560
-
561
- Memoria relevante:
562
-
563
- ```text
564
- memory/00-global/ Missao e padroes
565
- memory/10-product/ Produto e personas
566
- memory/20-architecture/ Arquitetura
567
- memory/40-delivery/ Backlog e sprint
568
- memory/50-orchestration Protocolos
569
- memory/60-runs/ Logs e fechamentos
570
- memory/90-decisions/ ADRs
571
-
572
- # Workspace (fora do repo do framework)
573
- ~/forja-workspace/projects/ Projetos de produto
574
- ~/forja-workspace/memory/30-projects/ Projetos rastreados
575
- ~/forja-workspace/memory/sqlite/ Memoria universal
576
- ```
577
-
578
- Sincronizar memoria universal:
579
-
580
- ```bash
581
- npm run sync:universal
582
- ```
583
-
584
- Consultar memoria:
585
-
586
- ```bash
587
- npm run query:universal -- "<termo>"
588
- ```
589
-
590
- Compactar:
591
-
592
- ```bash
593
- npm run memory:vacuum
594
- ```
595
-
596
- ## 12. Potencia de Desenvolvimento e Economia de Tokens
597
-
598
- Use estes comandos para transformar contexto em artefatos pequenos, medidos e reutilizaveis.
599
-
600
- ### 12.1 Schema auxiliar do banco
601
-
602
- ```bash
603
- npm run memory:schema
604
- ```
605
-
606
- Cria tabelas aditivas em `~/forja-workspace/memory/sqlite/universal.db`:
607
-
608
- | Tabela | Uso |
609
- |---|---|
610
- | `spec_summaries` | resumo compacto por spec |
611
- | `context_runs` | historico de contextos gerados e budget |
612
- | `asset_catalog` | boilerplates e referencias design-md catalogados |
613
-
614
- Essas tabelas nao substituem `memory_nodes` nem `handoffs`. Elas melhoram consulta e governanca sem quebrar o schema principal.
615
-
616
- ### 12.2 Sprint pack
617
-
618
- ```bash
619
- npm run context:sprint
620
- ```
621
-
622
- Gera:
623
-
624
- ```text
625
- .context/sprint-pack.md
626
- ```
627
-
628
- Use como primeiro contexto de qualquer sessao. Ele inclui somente sprint atual, specs ativas, handoffs abertos e ADRs recentes.
629
-
630
- ### 12.3 Agent brief
631
-
632
- ```bash
633
- npm run agent:brief -- <role> <slug>
634
- ```
635
-
636
- Exemplo:
637
-
638
- ```bash
639
- npm run agent:brief -- governance dev-token-assets-db
640
- ```
641
-
642
- Gera:
643
-
644
- ```text
645
- .context/agent-brief-<role>-<slug>.md
646
- ```
647
-
648
- Use antes de chamar um agente especifico. Ele evita carregar `spec.md`, `plan.md` e `tasks.md` completos quando um resumo operacional basta.
649
-
650
- ### 12.4 Token budget
651
-
652
- ```bash
653
- npm run context:budget -- <slug|arquivo> [limite]
654
- ```
655
-
656
- Exemplos:
657
-
658
- ```bash
659
- npm run context:budget -- .context/sprint-pack.md
660
- npm run context:budget -- .context/asset-catalog.md 12000
661
- ```
662
-
663
- Padrao: usa `tokenLimits.task` de `.memoryrc.json`, hoje 8000 tokens.
664
-
665
- Se passar do limite, o comando falha. Isso deve ser tratado como sinal de contexto inchado.
666
-
667
- ### 12.5 Catalogo de boilerplates e design system
668
-
669
- Gere ou atualize manifests normalizados:
670
-
671
- ```bash
672
- npm run catalog:manifests
673
- ```
674
-
675
- Isso cria:
676
-
677
- ```text
678
- boilerplates/<nome>/boilerplate.manifest.json
679
- design-md/<nome>/design.manifest.json
680
- ```
681
-
682
- Depois gere o catalogo:
683
-
684
- ```bash
685
- npm run catalog:assets
686
- ```
687
-
688
- Gera:
689
-
690
- ```text
691
- .context/asset-catalog.md
692
- ```
693
-
694
- Tambem popula `asset_catalog` no SQLite com:
695
-
696
- - boilerplates
697
- - referencias de `design-md`
698
- - caminho do README
699
- - resumo curto
700
- - tags vindas dos manifests
701
-
702
- Use antes de escolher base tecnica ou referencia visual.
703
-
704
- ### 12.6 Benchmark de tokens
705
-
706
- ```bash
707
- npm run token:benchmark
708
- ```
709
-
710
- Use para comparar contexto completo versus modos `global`, `domain` e `task`.
711
-
712
- ## 13. Design e Web
713
-
714
- Design entra apenas quando existe impacto visual real.
715
-
716
- Use:
717
-
718
- ```bash
719
- npm run design:select -- <surface> <tom>
720
- npm run design:check -- <brief.md>
721
- ```
722
-
723
- Exemplo:
724
-
725
- ```bash
726
- npm run design:select -- agent-console tecnico
727
- npm run design:check -- design-md/examples/agent-console-brief.md
728
- ```
729
-
730
- Nao use design como etapa obrigatoria para:
731
-
732
- - CLI.
733
- - Scripts.
734
- - Specs.
735
- - Handoffs.
736
- - Checks.
737
- - Refatoracoes sem interface.
738
-
739
- Dashboard:
740
-
741
- ```bash
742
- npm run dashboard
743
- ```
744
-
745
- Use somente para consulta visual ou depuracao de telas. Nao trate como fonte primaria de operacao.
746
-
747
- ## 14. Comandos por Objetivo
748
-
749
- ### Criar nova entrega
750
-
751
- ```bash
752
- npm run spec:new -- <slug>
753
- npm run gsd:plan -- <slug> "<objetivo>"
754
- npm run gsd:handoff -- spec <slug>
755
- ```
756
-
757
- ### Planejar entrega aprovada
758
-
759
- ```bash
760
- npm run spec:plan -- <slug>
761
- npm run spec:tasks -- <slug>
762
- npm run gsd:handoff -- plan <slug>
763
- ```
764
-
765
- ### Implementar
766
-
767
- ```bash
768
- npm run dev -- context:build task <slug> "<palavras-chave>"
769
- npm run gsd:handoff -- implement <slug>
770
- ```
771
-
772
- ### Revisar
773
-
774
- ```bash
775
- npm run gsd:handoff -- review <slug>
776
- npm run gsd:check -- <slug>
777
- npm run spec:check -- <slug>
778
- npm test
779
- npm run project:check
780
- ```
781
-
782
- ### Auditar todas as specs
783
-
784
- ```bash
785
- npm run spec:check
786
- ```
787
-
788
- ### Ver sprint
789
-
790
- ```bash
791
- npm run sprint:status
792
- ```
793
-
794
- ### Encerrar sprint
795
-
796
- ```bash
797
- npm run sprint:complete
798
- ```
799
-
800
- ## 15. Padroes de Qualidade
801
-
802
- ### 14.1 Uma spec boa
803
-
804
- Uma spec boa tem:
805
-
806
- - Problema concreto.
807
- - Persona clara.
808
- - Criterios de aceite testaveis.
809
- - Escopo fora explicito.
810
- - NFRs objetivos.
811
- - Metrica de sucesso.
812
-
813
- Uma spec ruim diz:
814
-
815
- - "Melhorar o sistema."
816
- - "Deixar mais bonito."
817
- - "Fazer funcionar."
818
- - "Otimizar performance" sem numero.
819
-
820
- ### 14.2 Um plan bom
821
-
822
- Um plan bom tem:
823
-
824
- - Modulos afetados.
825
- - Contratos alterados.
826
- - Riscos.
827
- - Alternativas rejeitadas.
828
- - Necessidade ou nao de ADR.
829
-
830
- ### 14.3 Tasks boas
831
-
832
- Tasks boas tem:
833
-
834
- - Owner.
835
- - Paths.
836
- - Dependencias.
837
- - Done verificavel.
838
- - Teste ou check associado.
839
-
840
- ### 14.4 Handoff bom
841
-
842
- Handoff bom permite que outro agente continue sem perguntar:
843
-
844
- - O que foi feito?
845
- - O que falta?
846
- - Onde esta o contexto?
847
- - Qual criterio de aceite?
848
- - Quais restricoes?
849
- - Para quem devolver?
850
-
851
- ## 16. Erros Comuns
852
-
853
- ### Erro: implementar sem spec
854
-
855
- Sintoma:
856
-
857
- ```text
858
- Codigo muda, mas ninguem sabe qual AC ele atende.
859
- ```
860
-
861
- Correcao:
862
-
863
- ```bash
864
- npm run spec:new -- <slug>
865
- ```
866
-
867
- ### Erro: plan criado com spec em draft
868
-
869
- Sintoma:
870
-
871
- ```text
872
- spec:check falha porque plan existe antes da spec aprovada.
873
- ```
874
-
875
- Correcao:
876
-
877
- - Aprovar ou corrigir status da spec.
878
- - Ou remover plan/tasks se foram criados cedo demais e ainda nao devem existir.
879
-
880
- ### Erro: design bloqueando CLI
881
-
882
- Sintoma:
883
-
884
- ```text
885
- Entrega sem UI tentando passar por design:check.
886
- ```
887
-
888
- Correcao:
889
-
890
- ```bash
891
- npm run gsd:check -- <slug>
892
- ```
893
-
894
- Sem brief visual.
895
-
896
- ### Erro: sprint sem criterio de fechamento
897
-
898
- Sintoma:
899
-
900
- ```text
901
- Itens ficam eternamente em current-sprint.md.
902
- ```
903
-
904
- Correcao:
905
-
906
- ```bash
907
- npm run sprint:complete
908
- ```
909
-
910
- Pendencias voltam para backlog quando aplicavel.
911
-
912
- ## 17. Exemplo Completo
913
-
914
- Objetivo: criar uma feature `inventario-ativos`.
915
-
916
- ### 16.1 Criar spec
917
-
918
- ```bash
919
- npm run spec:new -- inventario-ativos
920
- ```
921
-
922
- Editar:
923
-
924
- ```text
925
- specs/inventario-ativos/spec.md
926
- ```
927
-
928
- Quando aprovada:
929
-
930
- ```bash
931
- npm run spec:check -- inventario-ativos
932
- ```
933
-
934
- ### 16.2 Criar runbook GSD
935
-
936
- ```bash
937
- npm run gsd:plan -- inventario-ativos "criar inventario multiempresa e CRUD de ativos"
938
- ```
939
-
940
- ### 16.3 Registrar handoff para Product
941
-
942
- ```bash
943
- npm run gsd:handoff -- spec inventario-ativos
944
- ```
945
-
946
- ### 16.4 Planejar
947
-
948
- ```bash
949
- npm run spec:plan -- inventario-ativos
950
- npm run spec:tasks -- inventario-ativos
951
- npm run gsd:handoff -- plan inventario-ativos
952
- ```
953
-
954
- ### 16.5 Implementar
955
-
956
- ```bash
957
- npm run dev -- context:build task inventario-ativos "inventario ativos CRUD empresa"
958
- npm run gsd:handoff -- implement inventario-ativos
959
- ```
960
-
961
- Implementar somente o que esta em `tasks.md`.
962
-
963
- ### 16.6 Revisar
964
-
965
- ```bash
966
- npm run gsd:handoff -- review inventario-ativos
967
- npm run gsd:check -- inventario-ativos
968
- npm run spec:check -- inventario-ativos
969
- npm test
970
- npm run project:check
971
- ```
972
-
973
- ### 16.7 Fechar sprint
974
-
975
- ```bash
976
- npm run sprint:status
977
- npm run sprint:complete
978
- ```
979
-
980
- ## 18. Checklist de Excelencia
981
-
982
- Antes de dizer "pronto", confira:
983
-
984
- - [ ] Existe `spec.md`.
985
- - [ ] Existe `plan.md` quando houve decisao tecnica.
986
- - [ ] Existe `tasks.md`.
987
- - [ ] Handoff Hermes foi registrado.
988
- - [ ] `gsd:check` passou.
989
- - [ ] `spec:check` passou.
990
- - [ ] Testes relevantes passaram.
991
- - [ ] `project:check` passou.
992
- - [ ] Sprint foi atualizada.
993
- - [ ] Riscos residuais foram reportados.
994
- - [ ] Web/design nao foi usado como bloqueio quando a tarefa era CLI-only.
995
-
996
- ## 19. Comando de Bolso
997
-
998
- Para operar uma entrega comum:
999
-
1000
- ```bash
1001
- npm run sprint:status
1002
- npm run dev -- context:build task <slug> "<palavras-chave>"
1003
- npm run gsd:plan -- <slug> "<objetivo>"
1004
- npm run gsd:handoff -- spec <slug>
1005
- npm run gsd:handoff -- plan <slug>
1006
- npm run gsd:handoff -- implement <slug>
1007
- npm run gsd:handoff -- review <slug>
1008
- npm run gsd:check -- <slug>
1009
- npm run spec:check -- <slug>
1010
- npm test
1011
- npm run project:check
1012
- ```
1013
-
1014
- Se isso estiver verde, a operacao esta sob controle.
1
+ # Manual Operacional CLI-First, SDD, GSD e Orquestracao
2
+
3
+ Este manual e o guia principal para operar o framework de agentes com excelencia, sem depender do dashboard web. A web fica como consulta opcional. A operacao diaria, o acompanhamento de sprint, as passagens entre papeis, a validacao e a governanca acontecem por linha de comando.
4
+
5
+ ## 1. Visao Geral
6
+
7
+ O framework organiza desenvolvimento com agentes em quatro pilares:
8
+
9
+ 1. **Orquestracao**: cada demanda passa pelo papel certo, no momento certo.
10
+ 2. **SDD**: toda entrega relevante e descrita antes como `spec -> plan -> tasks`.
11
+ 3. **GSD**: cada execucao vira um runbook com gates verificaveis.
12
+ 4. **Hermes**: toda passagem de responsabilidade vira handoff registrado com 7 campos obrigatorios.
13
+
14
+ O objetivo nao e criar burocracia. O objetivo e impedir retrabalho, decisao perdida, implementacao sem criterio de aceite e sprint sem visibilidade.
15
+
16
+ ## 2. Mentalidade CLI-First
17
+
18
+ Use o terminal como console operacional. O dashboard nao deve ser necessario para responder:
19
+
20
+ - O que esta na sprint?
21
+ - Qual spec esta ativa?
22
+ - Quem recebeu o handoff?
23
+ - O que falta para implementar?
24
+ - A entrega passou nos gates?
25
+ - O projeto esta pronto para release?
26
+
27
+ Comandos centrais:
28
+
29
+ ```bash
30
+ npm run sprint:status
31
+ npm run gsd:plan -- <slug> "<objetivo>"
32
+ npm run gsd:handoff -- spec <slug>
33
+ npm run gsd:handoff -- plan <slug>
34
+ npm run gsd:handoff -- implement <slug>
35
+ npm run gsd:handoff -- review <slug>
36
+ npm run gsd:check -- <slug>
37
+ npm run project:check
38
+ ```
39
+
40
+ ## 3. Estrutura do Framework
41
+
42
+ Pastas principais:
43
+
44
+ ```text
45
+ AGENTS.md Papéis e regras canonicas
46
+ prompts/ Prompts portaveis por papel
47
+ .claude/agents/ Sub-agents Claude Code
48
+ specs/ Pipeline SDD por feature
49
+ memory/40-delivery/ Backlog e sprint atual
50
+ memory/50-orchestration/ Protocolos de orquestracao
51
+ memory/90-decisions/ ADRs e decisoes estruturais
52
+ scripts/ Harness CLI, sprint, specs, checks
53
+ .context/ Runbooks GSD e context packs
54
+ dashboard/ Web opcional/legada
55
+ ```
56
+
57
+ Arquivos que voce vai abrir com frequencia:
58
+
59
+ ```bash
60
+ AGENTS.md
61
+ docs/manual-operacional-cli-sdd-gsd.md
62
+ docs/cli-first-operacao.md
63
+ memory/40-delivery/backlog.md
64
+ memory/40-delivery/current-sprint.md
65
+ memory/50-orchestration/gsd-harness.md
66
+ specs/<slug>/spec.md
67
+ specs/<slug>/plan.md
68
+ specs/<slug>/tasks.md
69
+ .context/gsd-<slug>.md
70
+ ```
71
+
72
+ ## 4. Os 6 Papeis
73
+
74
+ Cada papel existe em tres lugares:
75
+
76
+ - `.claude/agents/<name>.md`: sub-agent executavel no Claude Code.
77
+ - `prompts/<name>-agent.md`: prompt portavel para Copilot, Gemini, Codex etc.
78
+ - `AGENTS.md`: referencia canonica de responsabilidade.
79
+
80
+ ### 4.1 Orchestrator
81
+
82
+ Use quando a demanda atravessa multiplos papeis ou quando voce quer coordenar uma execucao.
83
+
84
+ Responsabilidades:
85
+
86
+ - Decompor a demanda.
87
+ - Escolher o proximo papel.
88
+ - Criar ou acionar runbook GSD.
89
+ - Registrar handoffs Hermes.
90
+ - Consolidar memoria ao fim de sprint.
91
+
92
+ Nao faz:
93
+
94
+ - Implementacao direta.
95
+ - Decisao de produto sozinho.
96
+ - Aprovar release sem Governance.
97
+
98
+ Comandos tipicos:
99
+
100
+ ```bash
101
+ npm run gsd:plan -- <slug> "<objetivo>"
102
+ npm run gsd:handoff -- spec <slug>
103
+ npm run gsd:handoff -- plan <slug>
104
+ npm run gsd:handoff -- implement <slug>
105
+ npm run gsd:handoff -- review <slug>
106
+ ```
107
+
108
+ ### 4.2 Context Engineer
109
+
110
+ Use antes de tarefa pesada, refator multi-arquivo, analise longa ou quando o assunto envolve tokens/cache.
111
+
112
+ Responsabilidades:
113
+
114
+ - Montar contexto inteligente.
115
+ - Gerar `.context/context-*.md`.
116
+ - Medir e reduzir tokens.
117
+ - Compactar memoria quando necessario.
118
+
119
+ Comandos tipicos:
120
+
121
+ ```bash
122
+ npm run dev -- context:build global <projeto>
123
+ npm run dev -- context:build domain <projeto> "<dominio>"
124
+ npm run dev -- context:build task <slug> "<palavras-chave>"
125
+ npm run memory:vacuum
126
+ ```
127
+
128
+ ### 4.3 Product
129
+
130
+ Use quando ainda nao esta claro o que deve ser entregue.
131
+
132
+ Responsabilidades:
133
+
134
+ - Criar `spec.md`.
135
+ - Definir problema, proposta de valor, user stories e escopo.
136
+ - Definir metrica de sucesso em 30 dias.
137
+ - Priorizar backlog via RICE.
138
+
139
+ Comandos tipicos:
140
+
141
+ ```bash
142
+ npm run spec:new -- <slug>
143
+ npm run spec:check -- <slug>
144
+ ```
145
+
146
+ ### 4.4 SDD Architect
147
+
148
+ Use quando a spec esta aprovada e precisa virar plano tecnico.
149
+
150
+ Responsabilidades:
151
+
152
+ - Criar `plan.md`.
153
+ - Criar `tasks.md`.
154
+ - Abrir ADRs quando houver decisao estrutural.
155
+ - Recusar specs vagas.
156
+
157
+ Comandos tipicos:
158
+
159
+ ```bash
160
+ npm run spec:plan -- <slug>
161
+ npm run spec:tasks -- <slug>
162
+ npm run gsd:handoff -- plan <slug>
163
+ ```
164
+
165
+ ### 4.5 Marketing
166
+
167
+ Use antes de release, landing, copy, posicionamento, instrumentacao AARRR ou analise pos-launch.
168
+
169
+ Responsabilidades:
170
+
171
+ - Escrever copy conectada a dor da spec.
172
+ - Propor eventos de funil.
173
+ - Analisar metricas reais.
174
+
175
+ Nao faz:
176
+
177
+ - Inventar numeros.
178
+ - Decidir arquitetura.
179
+ - Mudar escopo tecnico.
180
+
181
+ ### 4.6 Governance
182
+
183
+ Use antes de merge, release ou encerramento de sprint.
184
+
185
+ Responsabilidades:
186
+
187
+ - Rodar checks.
188
+ - Auditar handoffs.
189
+ - Validar criterios de aceite.
190
+ - Bloquear entrega se houver risco, falta de spec, falta de teste ou quebra de seguranca.
191
+
192
+ Comandos tipicos:
193
+
194
+ ```bash
195
+ npm run gsd:check -- <slug>
196
+ npm run spec:check -- <slug>
197
+ npm test
198
+ npm run project:check
199
+ ```
200
+
201
+ ## 5. Fluxo SDD
202
+
203
+ SDD significa Spec-Driven Development. O codigo so deve vir depois de clareza.
204
+
205
+ Fluxo:
206
+
207
+ ```text
208
+ Product -> spec.md -> por que fazer
209
+ SDD Architect -> plan.md -> como fazer
210
+ SDD Architect -> tasks.md -> passos executaveis
211
+ Worker -> codigo -> implementacao
212
+ Governance -> checks -> validacao
213
+ ```
214
+
215
+ ### 5.1 Spec
216
+
217
+ Arquivo:
218
+
219
+ ```text
220
+ specs/<slug>/spec.md
221
+ ```
222
+
223
+ Deve responder:
224
+
225
+ - Qual problema esta sendo resolvido?
226
+ - Quem sente essa dor?
227
+ - O que fica dentro e fora do escopo?
228
+ - Quais criterios de aceite provam que acabou?
229
+ - Quais restricoes existem?
230
+ - Qual metrica de sucesso em 30 dias?
231
+
232
+ Criar spec:
233
+
234
+ ```bash
235
+ npm run spec:new -- <slug>
236
+ ```
237
+
238
+ Validar spec:
239
+
240
+ ```bash
241
+ npm run spec:check -- <slug>
242
+ ```
243
+
244
+ ### 5.2 Plan
245
+
246
+ Arquivo:
247
+
248
+ ```text
249
+ specs/<slug>/plan.md
250
+ ```
251
+
252
+ Deve responder:
253
+
254
+ - Qual abordagem tecnica?
255
+ - Quais modulos mudam?
256
+ - Quais contratos/API/CLI/schema mudam?
257
+ - Quais decisoes foram tomadas?
258
+ - Quais alternativas foram rejeitadas?
259
+ - Precisa de ADR?
260
+
261
+ Gerar plan:
262
+
263
+ ```bash
264
+ npm run spec:plan -- <slug>
265
+ ```
266
+
267
+ Regra: `spec:plan` so deve rodar quando a spec estiver aprovada.
268
+
269
+ ### 5.3 Tasks
270
+
271
+ Arquivo:
272
+
273
+ ```text
274
+ specs/<slug>/tasks.md
275
+ ```
276
+
277
+ Deve conter tarefas executaveis com:
278
+
279
+ - ID da tarefa.
280
+ - Owner.
281
+ - Dependencias.
282
+ - Paths afetados.
283
+ - Criterio de done.
284
+
285
+ Gerar tasks:
286
+
287
+ ```bash
288
+ npm run spec:tasks -- <slug>
289
+ ```
290
+
291
+ Regra: `spec:tasks` so deve rodar quando o plano estiver aprovado.
292
+
293
+ ## 6. Fluxo GSD
294
+
295
+ GSD e o harness de execucao. Ele cria e valida um runbook para a entrega.
296
+
297
+ Criar runbook:
298
+
299
+ ```bash
300
+ npm run gsd:plan -- <slug> "<objetivo>"
301
+ ```
302
+
303
+ Isso gera:
304
+
305
+ ```text
306
+ .context/gsd-<slug>.md
307
+ ```
308
+
309
+ Esse arquivo acompanha os gates:
310
+
311
+ 1. Briefing.
312
+ 2. Estrutura.
313
+ 3. Sprints.
314
+ 4. Contexto.
315
+ 5. Spec.
316
+ 6. Design, somente se houver UI.
317
+ 7. Plano.
318
+ 8. Desenvolvimento.
319
+ 9. Validacao.
320
+ 10. Governance.
321
+
322
+ Validar:
323
+
324
+ ```bash
325
+ npm run gsd:check -- <slug>
326
+ ```
327
+
328
+ Se houver impacto visual:
329
+
330
+ ```bash
331
+ npm run design:select -- agent-console tecnico
332
+ npm run design:check -- design-md/examples/agent-console-brief.md
333
+ npm run gsd:check -- <slug> design-md/examples/agent-console-brief.md
334
+ ```
335
+
336
+ Se nao houver UI, nao passe brief. O fluxo CLI-only nao deve ser bloqueado por design.
337
+
338
+ ## 7. Handoffs Hermes
339
+
340
+ Handoff e passagem formal de responsabilidade.
341
+
342
+ Todo handoff precisa dos 7 campos da ADR-0005:
343
+
344
+ | Campo | Significado |
345
+ |---|---|
346
+ | `from` | Quem esta entregando |
347
+ | `to` | Quem recebe |
348
+ | `intent` | Intencao da passagem |
349
+ | `context` | Contexto minimo para continuar |
350
+ | `acceptance` | Como saber que o trabalho foi aceito |
351
+ | `constraints` | Restrições obrigatorias |
352
+ | `return` | Para quem devolver |
353
+
354
+ Comando generico:
355
+
356
+ ```bash
357
+ npm run hermes:handoff -- '{"from":"orchestrator","to":"product","intent":"spec","context":"specs/<slug>","acceptance":"spec aprovada com AC testaveis","constraints":"pt-BR; nao implementar codigo","return":"orchestrator"}'
358
+ ```
359
+
360
+ Atalhos do GSD:
361
+
362
+ ```bash
363
+ npm run gsd:handoff -- spec <slug>
364
+ npm run gsd:handoff -- plan <slug>
365
+ npm run gsd:handoff -- implement <slug>
366
+ npm run gsd:handoff -- review <slug>
367
+ ```
368
+
369
+ Ordem recomendada:
370
+
371
+ ```text
372
+ Orchestrator -> Product spec
373
+ Product -> SDD Architect plan
374
+ SDD Architect-> Worker implement
375
+ Worker -> Governance review
376
+ Governance -> Orchestrator fechamento
377
+ ```
378
+
379
+ ## 8. Sprints
380
+
381
+ O acompanhamento de sprint fica em:
382
+
383
+ ```text
384
+ memory/40-delivery/current-sprint.md
385
+ ```
386
+
387
+ O backlog fica em:
388
+
389
+ ```text
390
+ memory/40-delivery/backlog.md
391
+ ```
392
+
393
+ ### 8.1 Iniciar sprint no framework raiz
394
+
395
+ ```bash
396
+ npm run sprint:start
397
+ ```
398
+
399
+ O script busca itens de alta prioridade. Se o backlog estiver em tabela RICE, ele seleciona itens `P0` e `P1`.
400
+
401
+ ### 8.2 Ver status
402
+
403
+ ```bash
404
+ npm run sprint:status
405
+ ```
406
+
407
+ ### 8.3 Encerrar sprint
408
+
409
+ ```bash
410
+ npm run sprint:complete
411
+ ```
412
+
413
+ O fechamento cria relatorio em:
414
+
415
+ ```text
416
+ memory/60-runs/sprint-close-<timestamp>.md
417
+ ```
418
+
419
+ ### 8.4 Operar sprint de um projeto no workspace
420
+
421
+ ```bash
422
+ npm run sprint:start -- NomeDoProjeto
423
+ npm run sprint:status -- NomeDoProjeto
424
+ npm run sprint:complete -- NomeDoProjeto
425
+ ```
426
+
427
+ Os projetos de produto vivem em `~/forja-workspace/projects/<NomeDoProjeto>` (configurável via `FORJA_WORKSPACE` ou `~/.forjarc.json`). Veja ADR-0019.
428
+
429
+ ## 9. Rotina Recomendada
430
+
431
+ ### 9.1 Inicio do dia
432
+
433
+ ```bash
434
+ git status --short
435
+ npm run sprint:status
436
+ npm run spec:check
437
+ ```
438
+
439
+ Leia:
440
+
441
+ ```bash
442
+ memory/40-delivery/current-sprint.md
443
+ ```
444
+
445
+ Escolha uma entrega e confirme se existe:
446
+
447
+ ```text
448
+ specs/<slug>/spec.md
449
+ specs/<slug>/plan.md
450
+ specs/<slug>/tasks.md
451
+ ```
452
+
453
+ ### 9.2 Antes de mexer em codigo
454
+
455
+ ```bash
456
+ npm run dev -- context:build task <slug> "<palavras-chave>"
457
+ npm run gsd:plan -- <slug> "<objetivo>"
458
+ npm run gsd:handoff -- implement <slug>
459
+ ```
460
+
461
+ Leia:
462
+
463
+ ```text
464
+ .context/gsd-<slug>.md
465
+ specs/<slug>/tasks.md
466
+ ```
467
+
468
+ ### 9.3 Durante a implementacao
469
+
470
+ Mantenha foco em:
471
+
472
+ - Paths definidos em `tasks.md`.
473
+ - Criterios de aceite da spec.
474
+ - Contratos do plano.
475
+ - Nenhuma refatoracao fora do escopo.
476
+
477
+ Checklist local:
478
+
479
+ ```bash
480
+ npm run spec:check -- <slug>
481
+ npm run gsd:check -- <slug>
482
+ ```
483
+
484
+ ### 9.4 Antes de entregar
485
+
486
+ ```bash
487
+ npm run gsd:handoff -- review <slug>
488
+ npm run gsd:check -- <slug>
489
+ npm run spec:check -- <slug>
490
+ npm test
491
+ npm run project:check
492
+ ```
493
+
494
+ Se algum comando falhar, nao entregue como pronto. Registre a pendencia no handoff ou em `tasks.md`.
495
+
496
+ ### 9.5 Fechamento da sprint
497
+
498
+ ```bash
499
+ npm run sprint:status
500
+ npm run sprint:complete
501
+ ```
502
+
503
+ Depois consolide memoria:
504
+
505
+ ```bash
506
+ npm run memory:vacuum
507
+ npm run sync:universal
508
+ ```
509
+
510
+ ## 10. Governanca
511
+
512
+ Governance nao e opiniao. Governance e evidencia.
513
+
514
+ Uma entrega so esta pronta quando:
515
+
516
+ - A spec existe e esta coerente.
517
+ - O plano existe quando houve decisao tecnica.
518
+ - As tasks refletem o que foi implementado.
519
+ - O GSD check passa.
520
+ - Testes relevantes passaram.
521
+ - `project:check` passou.
522
+ - Handoffs foram registrados.
523
+ - Riscos residuais foram explicitados.
524
+
525
+ Comandos:
526
+
527
+ ```bash
528
+ npm run gsd:check -- <slug>
529
+ npm run spec:check -- <slug>
530
+ npm test
531
+ npm run project:check
532
+ ```
533
+
534
+ `project:check` sem argumento valida o framework raiz. Com argumento, valida projeto em `~/forja-workspace/projects/<nome>`.
535
+
536
+ ```bash
537
+ npm run project:check
538
+ npm run project:check -- NomeDoProjeto
539
+ ```
540
+
541
+ ## 11. Contexto e Memoria
542
+
543
+ Use contexto inteligente para reduzir custo mental e tokens.
544
+
545
+ Modos:
546
+
547
+ | Modo | Uso |
548
+ |---|---|
549
+ | `global` | Entender padroes gerais |
550
+ | `domain` | Entender um dominio especifico |
551
+ | `task` | Executar uma entrega |
552
+
553
+ Comandos:
554
+
555
+ ```bash
556
+ npm run dev -- context:build global <projeto>
557
+ npm run dev -- context:build domain <projeto> "<dominio>"
558
+ npm run dev -- context:build task <slug> "<palavras-chave>"
559
+ ```
560
+
561
+ Memoria relevante:
562
+
563
+ ```text
564
+ memory/00-global/ Missao e padroes
565
+ memory/10-product/ Produto e personas
566
+ memory/20-architecture/ Arquitetura
567
+ memory/40-delivery/ Backlog e sprint
568
+ memory/50-orchestration Protocolos
569
+ memory/60-runs/ Logs e fechamentos
570
+ memory/90-decisions/ ADRs
571
+
572
+ # Workspace (fora do repo do framework)
573
+ ~/forja-workspace/projects/ Projetos de produto
574
+ ~/forja-workspace/memory/30-projects/ Projetos rastreados
575
+ ~/forja-workspace/memory/sqlite/ Memoria universal
576
+ ```
577
+
578
+ Sincronizar memoria universal:
579
+
580
+ ```bash
581
+ npm run sync:universal
582
+ ```
583
+
584
+ Consultar memoria:
585
+
586
+ ```bash
587
+ npm run query:universal -- "<termo>"
588
+ ```
589
+
590
+ Compactar:
591
+
592
+ ```bash
593
+ npm run memory:vacuum
594
+ ```
595
+
596
+ ## 12. Potencia de Desenvolvimento e Economia de Tokens
597
+
598
+ Use estes comandos para transformar contexto em artefatos pequenos, medidos e reutilizaveis.
599
+
600
+ ### 12.1 Schema auxiliar do banco
601
+
602
+ ```bash
603
+ npm run memory:schema
604
+ ```
605
+
606
+ Cria tabelas aditivas em `~/forja-workspace/memory/sqlite/universal.db`:
607
+
608
+ | Tabela | Uso |
609
+ |---|---|
610
+ | `spec_summaries` | resumo compacto por spec |
611
+ | `context_runs` | historico de contextos gerados e budget |
612
+ | `asset_catalog` | boilerplates e referencias design-md catalogados |
613
+
614
+ Essas tabelas nao substituem `memory_nodes` nem `handoffs`. Elas melhoram consulta e governanca sem quebrar o schema principal.
615
+
616
+ ### 12.2 Sprint pack
617
+
618
+ ```bash
619
+ npm run context:sprint
620
+ ```
621
+
622
+ Gera:
623
+
624
+ ```text
625
+ .context/sprint-pack.md
626
+ ```
627
+
628
+ Use como primeiro contexto de qualquer sessao. Ele inclui somente sprint atual, specs ativas, handoffs abertos e ADRs recentes.
629
+
630
+ ### 12.3 Agent brief
631
+
632
+ ```bash
633
+ npm run agent:brief -- <role> <slug>
634
+ ```
635
+
636
+ Exemplo:
637
+
638
+ ```bash
639
+ npm run agent:brief -- governance dev-token-assets-db
640
+ ```
641
+
642
+ Gera:
643
+
644
+ ```text
645
+ .context/agent-brief-<role>-<slug>.md
646
+ ```
647
+
648
+ Use antes de chamar um agente especifico. Ele evita carregar `spec.md`, `plan.md` e `tasks.md` completos quando um resumo operacional basta.
649
+
650
+ ### 12.4 Token budget
651
+
652
+ ```bash
653
+ npm run context:budget -- <slug|arquivo> [limite]
654
+ ```
655
+
656
+ Exemplos:
657
+
658
+ ```bash
659
+ npm run context:budget -- .context/sprint-pack.md
660
+ npm run context:budget -- .context/asset-catalog.md 12000
661
+ ```
662
+
663
+ Padrao: usa `tokenLimits.task` de `.memoryrc.json`, hoje 8000 tokens.
664
+
665
+ Se passar do limite, o comando falha. Isso deve ser tratado como sinal de contexto inchado.
666
+
667
+ ### 12.5 Catalogo de boilerplates e design system
668
+
669
+ Gere ou atualize manifests normalizados:
670
+
671
+ ```bash
672
+ npm run catalog:manifests
673
+ ```
674
+
675
+ Isso cria:
676
+
677
+ ```text
678
+ boilerplates/<nome>/boilerplate.manifest.json
679
+ design-md/<nome>/design.manifest.json
680
+ ```
681
+
682
+ Depois gere o catalogo:
683
+
684
+ ```bash
685
+ npm run catalog:assets
686
+ ```
687
+
688
+ Gera:
689
+
690
+ ```text
691
+ .context/asset-catalog.md
692
+ ```
693
+
694
+ Tambem popula `asset_catalog` no SQLite com:
695
+
696
+ - boilerplates
697
+ - referencias de `design-md`
698
+ - caminho do README
699
+ - resumo curto
700
+ - tags vindas dos manifests
701
+
702
+ Use antes de escolher base tecnica ou referencia visual.
703
+
704
+ ### 12.6 Benchmark de tokens
705
+
706
+ ```bash
707
+ npm run token:benchmark
708
+ ```
709
+
710
+ Use para comparar contexto completo versus modos `global`, `domain` e `task`.
711
+
712
+ ## 13. Design e Web
713
+
714
+ Design entra apenas quando existe impacto visual real.
715
+
716
+ Use:
717
+
718
+ ```bash
719
+ npm run design:select -- <surface> <tom>
720
+ npm run design:check -- <brief.md>
721
+ ```
722
+
723
+ Exemplo:
724
+
725
+ ```bash
726
+ npm run design:select -- agent-console tecnico
727
+ npm run design:check -- design-md/examples/agent-console-brief.md
728
+ ```
729
+
730
+ Nao use design como etapa obrigatoria para:
731
+
732
+ - CLI.
733
+ - Scripts.
734
+ - Specs.
735
+ - Handoffs.
736
+ - Checks.
737
+ - Refatoracoes sem interface.
738
+
739
+ Dashboard:
740
+
741
+ ```bash
742
+ npm run dashboard
743
+ ```
744
+
745
+ Use somente para consulta visual ou depuracao de telas. Nao trate como fonte primaria de operacao.
746
+
747
+ ## 14. Comandos por Objetivo
748
+
749
+ ### Criar nova entrega
750
+
751
+ ```bash
752
+ npm run spec:new -- <slug>
753
+ npm run gsd:plan -- <slug> "<objetivo>"
754
+ npm run gsd:handoff -- spec <slug>
755
+ ```
756
+
757
+ ### Planejar entrega aprovada
758
+
759
+ ```bash
760
+ npm run spec:plan -- <slug>
761
+ npm run spec:tasks -- <slug>
762
+ npm run gsd:handoff -- plan <slug>
763
+ ```
764
+
765
+ ### Implementar
766
+
767
+ ```bash
768
+ npm run dev -- context:build task <slug> "<palavras-chave>"
769
+ npm run gsd:handoff -- implement <slug>
770
+ ```
771
+
772
+ ### Revisar
773
+
774
+ ```bash
775
+ npm run gsd:handoff -- review <slug>
776
+ npm run gsd:check -- <slug>
777
+ npm run spec:check -- <slug>
778
+ npm test
779
+ npm run project:check
780
+ ```
781
+
782
+ ### Auditar todas as specs
783
+
784
+ ```bash
785
+ npm run spec:check
786
+ ```
787
+
788
+ ### Ver sprint
789
+
790
+ ```bash
791
+ npm run sprint:status
792
+ ```
793
+
794
+ ### Encerrar sprint
795
+
796
+ ```bash
797
+ npm run sprint:complete
798
+ ```
799
+
800
+ ## 15. Padroes de Qualidade
801
+
802
+ ### 14.1 Uma spec boa
803
+
804
+ Uma spec boa tem:
805
+
806
+ - Problema concreto.
807
+ - Persona clara.
808
+ - Criterios de aceite testaveis.
809
+ - Escopo fora explicito.
810
+ - NFRs objetivos.
811
+ - Metrica de sucesso.
812
+
813
+ Uma spec ruim diz:
814
+
815
+ - "Melhorar o sistema."
816
+ - "Deixar mais bonito."
817
+ - "Fazer funcionar."
818
+ - "Otimizar performance" sem numero.
819
+
820
+ ### 14.2 Um plan bom
821
+
822
+ Um plan bom tem:
823
+
824
+ - Modulos afetados.
825
+ - Contratos alterados.
826
+ - Riscos.
827
+ - Alternativas rejeitadas.
828
+ - Necessidade ou nao de ADR.
829
+
830
+ ### 14.3 Tasks boas
831
+
832
+ Tasks boas tem:
833
+
834
+ - Owner.
835
+ - Paths.
836
+ - Dependencias.
837
+ - Done verificavel.
838
+ - Teste ou check associado.
839
+
840
+ ### 14.4 Handoff bom
841
+
842
+ Handoff bom permite que outro agente continue sem perguntar:
843
+
844
+ - O que foi feito?
845
+ - O que falta?
846
+ - Onde esta o contexto?
847
+ - Qual criterio de aceite?
848
+ - Quais restricoes?
849
+ - Para quem devolver?
850
+
851
+ ## 16. Erros Comuns
852
+
853
+ ### Erro: implementar sem spec
854
+
855
+ Sintoma:
856
+
857
+ ```text
858
+ Codigo muda, mas ninguem sabe qual AC ele atende.
859
+ ```
860
+
861
+ Correcao:
862
+
863
+ ```bash
864
+ npm run spec:new -- <slug>
865
+ ```
866
+
867
+ ### Erro: plan criado com spec em draft
868
+
869
+ Sintoma:
870
+
871
+ ```text
872
+ spec:check falha porque plan existe antes da spec aprovada.
873
+ ```
874
+
875
+ Correcao:
876
+
877
+ - Aprovar ou corrigir status da spec.
878
+ - Ou remover plan/tasks se foram criados cedo demais e ainda nao devem existir.
879
+
880
+ ### Erro: design bloqueando CLI
881
+
882
+ Sintoma:
883
+
884
+ ```text
885
+ Entrega sem UI tentando passar por design:check.
886
+ ```
887
+
888
+ Correcao:
889
+
890
+ ```bash
891
+ npm run gsd:check -- <slug>
892
+ ```
893
+
894
+ Sem brief visual.
895
+
896
+ ### Erro: sprint sem criterio de fechamento
897
+
898
+ Sintoma:
899
+
900
+ ```text
901
+ Itens ficam eternamente em current-sprint.md.
902
+ ```
903
+
904
+ Correcao:
905
+
906
+ ```bash
907
+ npm run sprint:complete
908
+ ```
909
+
910
+ Pendencias voltam para backlog quando aplicavel.
911
+
912
+ ## 17. Exemplo Completo
913
+
914
+ Objetivo: criar uma feature `inventario-ativos`.
915
+
916
+ ### 16.1 Criar spec
917
+
918
+ ```bash
919
+ npm run spec:new -- inventario-ativos
920
+ ```
921
+
922
+ Editar:
923
+
924
+ ```text
925
+ specs/inventario-ativos/spec.md
926
+ ```
927
+
928
+ Quando aprovada:
929
+
930
+ ```bash
931
+ npm run spec:check -- inventario-ativos
932
+ ```
933
+
934
+ ### 16.2 Criar runbook GSD
935
+
936
+ ```bash
937
+ npm run gsd:plan -- inventario-ativos "criar inventario multiempresa e CRUD de ativos"
938
+ ```
939
+
940
+ ### 16.3 Registrar handoff para Product
941
+
942
+ ```bash
943
+ npm run gsd:handoff -- spec inventario-ativos
944
+ ```
945
+
946
+ ### 16.4 Planejar
947
+
948
+ ```bash
949
+ npm run spec:plan -- inventario-ativos
950
+ npm run spec:tasks -- inventario-ativos
951
+ npm run gsd:handoff -- plan inventario-ativos
952
+ ```
953
+
954
+ ### 16.5 Implementar
955
+
956
+ ```bash
957
+ npm run dev -- context:build task inventario-ativos "inventario ativos CRUD empresa"
958
+ npm run gsd:handoff -- implement inventario-ativos
959
+ ```
960
+
961
+ Implementar somente o que esta em `tasks.md`.
962
+
963
+ ### 16.6 Revisar
964
+
965
+ ```bash
966
+ npm run gsd:handoff -- review inventario-ativos
967
+ npm run gsd:check -- inventario-ativos
968
+ npm run spec:check -- inventario-ativos
969
+ npm test
970
+ npm run project:check
971
+ ```
972
+
973
+ ### 16.7 Fechar sprint
974
+
975
+ ```bash
976
+ npm run sprint:status
977
+ npm run sprint:complete
978
+ ```
979
+
980
+ ## 18. Checklist de Excelencia
981
+
982
+ Antes de dizer "pronto", confira:
983
+
984
+ - [ ] Existe `spec.md`.
985
+ - [ ] Existe `plan.md` quando houve decisao tecnica.
986
+ - [ ] Existe `tasks.md`.
987
+ - [ ] Handoff Hermes foi registrado.
988
+ - [ ] `gsd:check` passou.
989
+ - [ ] `spec:check` passou.
990
+ - [ ] Testes relevantes passaram.
991
+ - [ ] `project:check` passou.
992
+ - [ ] Sprint foi atualizada.
993
+ - [ ] Riscos residuais foram reportados.
994
+ - [ ] Web/design nao foi usado como bloqueio quando a tarefa era CLI-only.
995
+
996
+ ## 19. Comando de Bolso
997
+
998
+ Para operar uma entrega comum:
999
+
1000
+ ```bash
1001
+ npm run sprint:status
1002
+ npm run dev -- context:build task <slug> "<palavras-chave>"
1003
+ npm run gsd:plan -- <slug> "<objetivo>"
1004
+ npm run gsd:handoff -- spec <slug>
1005
+ npm run gsd:handoff -- plan <slug>
1006
+ npm run gsd:handoff -- implement <slug>
1007
+ npm run gsd:handoff -- review <slug>
1008
+ npm run gsd:check -- <slug>
1009
+ npm run spec:check -- <slug>
1010
+ npm test
1011
+ npm run project:check
1012
+ ```
1013
+
1014
+ Se isso estiver verde, a operacao esta sob controle.