forjajs 1.1.0

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 (558) hide show
  1. package/.claude/agents/context-engineer.md +25 -0
  2. package/.claude/agents/governance.md +32 -0
  3. package/.claude/agents/marketing.md +24 -0
  4. package/.claude/agents/orchestrator.md +31 -0
  5. package/.claude/agents/product.md +26 -0
  6. package/.claude/agents/sdd-architect.md +34 -0
  7. package/.claude/settings.json +41 -0
  8. package/.gemini-instructions.md +87 -0
  9. package/.github/copilot-instructions.md +87 -0
  10. package/.memoryrc.json +104 -0
  11. package/.openai-instructions.md +87 -0
  12. package/AGENTS.md +132 -0
  13. package/CHANGELOG.md +106 -0
  14. package/CONTRIBUTING.md +32 -0
  15. package/DOC-MAP.md +65 -0
  16. package/LICENSE +21 -0
  17. package/README.md +260 -0
  18. package/bin/create-memory-nest-kit.js +125 -0
  19. package/bin/forja.mjs +143 -0
  20. package/bin/init-project.js +612 -0
  21. package/boilerplates/01-api-rest/README.md +336 -0
  22. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -0
  23. package/boilerplates/02-saas-starter/.env.example +25 -0
  24. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -0
  25. package/boilerplates/02-saas-starter/INFO.md +252 -0
  26. package/boilerplates/02-saas-starter/QUICK_START.md +194 -0
  27. package/boilerplates/02-saas-starter/README.md +305 -0
  28. package/boilerplates/02-saas-starter/START-HERE.md +259 -0
  29. package/boilerplates/02-saas-starter/backend/package.json +87 -0
  30. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -0
  31. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -0
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -0
  33. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -0
  34. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -0
  35. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -0
  36. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -0
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -0
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -0
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -0
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -0
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -0
  42. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -0
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -0
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -0
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -0
  46. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -0
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -0
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -0
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -0
  50. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -0
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -0
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -0
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -0
  54. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -0
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -0
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -0
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -0
  58. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -0
  59. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -0
  60. package/boilerplates/02-saas-starter/docker-compose.yml +34 -0
  61. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -0
  62. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -0
  63. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -0
  64. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -0
  65. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -0
  66. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -0
  67. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -0
  68. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -0
  69. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -0
  70. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -0
  71. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -0
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -0
  73. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -0
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -0
  75. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -0
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -0
  77. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -0
  78. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -0
  79. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -0
  80. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -0
  81. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -0
  82. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -0
  83. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -0
  84. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -0
  85. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -0
  86. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -0
  87. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -0
  88. package/boilerplates/03-ecommerce-starter/README.md +465 -0
  89. package/boilerplates/03-ecommerce-starter/agents/.gitkeep +0 -0
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -0
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -0
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -0
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -0
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -0
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -0
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -0
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -0
  98. package/boilerplates/03-ecommerce-starter/backend/src/common/.gitkeep +0 -0
  99. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -0
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -0
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -0
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -0
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -0
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -0
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -0
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -0
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -0
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -0
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -0
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -0
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -0
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -0
  113. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -0
  114. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -0
  115. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -0
  116. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -0
  117. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -0
  118. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -0
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -0
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -0
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -0
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -0
  123. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -0
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -0
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -0
  126. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -0
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -0
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -0
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -0
  130. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -0
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -0
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -0
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -0
  134. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -0
  135. package/boilerplates/03-ecommerce-starter/memory/40-delivery/.gitkeep +0 -0
  136. package/boilerplates/03-ecommerce-starter/memory/50-orchestration/.gitkeep +0 -0
  137. package/boilerplates/03-ecommerce-starter/memory/60-runs/.gitkeep +0 -0
  138. package/boilerplates/03-ecommerce-starter/memory/70-summaries/.gitkeep +0 -0
  139. package/boilerplates/03-ecommerce-starter/memory/80-data/.gitkeep +0 -0
  140. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -0
  141. package/boilerplates/03-ecommerce-starter/memory/90-decisions/.gitkeep +0 -0
  142. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -0
  143. package/boilerplates/03-ecommerce-starter/prompts/.gitkeep +0 -0
  144. package/boilerplates/03-ecommerce-starter/skills/.gitkeep +0 -0
  145. package/boilerplates/04-microservices-starter/.env.example +43 -0
  146. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -0
  147. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -0
  148. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -0
  149. package/boilerplates/04-microservices-starter/INDEX.md +377 -0
  150. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -0
  151. package/boilerplates/04-microservices-starter/README.md +466 -0
  152. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -0
  153. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -0
  154. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -0
  155. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -0
  156. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -0
  157. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -0
  158. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -0
  159. package/boilerplates/04-microservices-starter/backend/api-gateway/test/.gitkeep +0 -0
  160. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -0
  161. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -0
  162. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -0
  163. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -0
  164. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -0
  165. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -0
  166. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -0
  167. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -0
  168. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -0
  169. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -0
  170. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/notification/.gitkeep +0 -0
  171. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/user/.gitkeep +0 -0
  172. package/boilerplates/04-microservices-starter/backend/services/auth-service/test/.gitkeep +0 -0
  173. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -0
  174. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -0
  175. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -0
  176. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -0
  177. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -0
  178. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/auth/.gitkeep +0 -0
  179. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -0
  180. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -0
  181. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -0
  182. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/user/.gitkeep +0 -0
  183. package/boilerplates/04-microservices-starter/backend/services/notification-service/test/.gitkeep +0 -0
  184. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -0
  185. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -0
  186. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -0
  187. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -0
  188. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -0
  189. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/auth/.gitkeep +0 -0
  190. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/notification/.gitkeep +0 -0
  191. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -0
  192. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -0
  193. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -0
  194. package/boilerplates/04-microservices-starter/backend/services/user-service/test/.gitkeep +0 -0
  195. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -0
  196. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -0
  197. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -0
  198. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -0
  199. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -0
  200. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -0
  201. package/boilerplates/04-microservices-starter/backend/shared/src/types/.gitkeep +0 -0
  202. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -0
  203. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -0
  204. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -0
  205. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -0
  206. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -0
  207. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -0
  208. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -0
  209. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -0
  210. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -0
  211. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -0
  212. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -0
  213. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -0
  214. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -0
  215. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -0
  216. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -0
  217. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -0
  218. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -0
  219. package/boilerplates/04-microservices-starter/memory/40-delivery/.gitkeep +0 -0
  220. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -0
  221. package/boilerplates/04-microservices-starter/memory/60-runs/.gitkeep +0 -0
  222. package/boilerplates/04-microservices-starter/memory/70-summaries/.gitkeep +0 -0
  223. package/boilerplates/04-microservices-starter/memory/80-data/.gitkeep +0 -0
  224. package/boilerplates/04-microservices-starter/memory/90-decisions/.gitkeep +0 -0
  225. package/boilerplates/04-microservices-starter/package.json +21 -0
  226. package/boilerplates/05-monorepo-starter/.env.example +1 -0
  227. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -0
  228. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -0
  229. package/boilerplates/05-monorepo-starter/Dockerfile +35 -0
  230. package/boilerplates/05-monorepo-starter/README.md +318 -0
  231. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -0
  232. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -0
  233. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -0
  234. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -0
  235. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -0
  236. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -0
  237. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -0
  238. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -0
  239. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -0
  240. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -0
  241. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -0
  242. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -0
  243. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -0
  244. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -0
  245. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -0
  246. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -0
  247. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -0
  248. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -0
  249. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -0
  250. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -0
  251. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -0
  252. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -0
  253. package/boilerplates/05-monorepo-starter/memory/40-delivery/.gitkeep +0 -0
  254. package/boilerplates/05-monorepo-starter/memory/50-orchestration/.gitkeep +0 -0
  255. package/boilerplates/05-monorepo-starter/memory/60-runs/.gitkeep +0 -0
  256. package/boilerplates/05-monorepo-starter/memory/70-summaries/.gitkeep +0 -0
  257. package/boilerplates/05-monorepo-starter/memory/80-data/.gitkeep +0 -0
  258. package/boilerplates/05-monorepo-starter/memory/90-decisions/.gitkeep +0 -0
  259. package/boilerplates/05-monorepo-starter/package.json +30 -0
  260. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -0
  261. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -0
  262. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -0
  263. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -0
  264. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -0
  265. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -0
  266. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -0
  267. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -0
  268. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -0
  269. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -0
  270. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -0
  271. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -0
  272. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -0
  273. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -0
  274. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -0
  275. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -0
  276. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -0
  277. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -0
  278. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -0
  279. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -0
  280. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -0
  281. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -0
  282. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -0
  283. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -0
  284. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -0
  285. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -0
  286. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -0
  287. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -0
  288. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -0
  289. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -0
  290. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -0
  291. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -0
  292. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -0
  293. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -0
  294. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -0
  295. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -0
  296. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -0
  297. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -0
  298. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -0
  299. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -0
  300. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -0
  301. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -0
  302. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -0
  303. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -0
  304. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -0
  305. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -0
  306. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -0
  307. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -0
  308. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -0
  309. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -0
  310. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -0
  311. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -0
  312. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -0
  313. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -0
  314. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -0
  315. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -0
  316. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -0
  317. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -0
  318. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -0
  319. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -0
  320. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -0
  321. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -0
  322. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -0
  323. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -0
  324. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -0
  325. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -0
  326. package/boilerplates/05-monorepo-starter/turbo.json +35 -0
  327. package/boilerplates/README.md +407 -0
  328. package/design-md/BRIEF-TEMPLATE.md +47 -0
  329. package/design-md/INDEX.md +35 -0
  330. package/design-md/MATRIX.md +24 -0
  331. package/design-md/PLAYBOOK.md +35 -0
  332. package/design-md/examples/agent-console-brief.md +48 -0
  333. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -0
  334. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -0
  335. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -0
  336. package/docs/agent-harnesses.md +122 -0
  337. package/docs/archive/CHECKLIST-FINAL.md +295 -0
  338. package/docs/archive/FASE2-SUMMARY.md +263 -0
  339. package/docs/archive/FASE3-PROGRESS.md +355 -0
  340. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -0
  341. package/docs/archive/INDICE-MASTER.md +282 -0
  342. package/docs/archive/PROJETO-COMPLETO.md +363 -0
  343. package/docs/archive/README-REFINAMENTO.md +293 -0
  344. package/docs/archive/REFERENCIA-RAPIDA.md +324 -0
  345. package/docs/archive/REFINAMENTO-v1.0.md +565 -0
  346. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -0
  347. package/docs/archive/START-HERE.md +319 -0
  348. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -0
  349. package/docs/archive/examples/v1/AGENTS.md +10 -0
  350. package/docs/archive/examples/v1/README.md +36 -0
  351. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -0
  352. package/docs/archive/examples/v1/backend/nest-cli.json +4 -0
  353. package/docs/archive/examples/v1/backend/package.json +42 -0
  354. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -0
  355. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -0
  356. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -0
  357. package/docs/archive/examples/v1/backend/src/main.ts +10 -0
  358. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -0
  359. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -0
  360. package/docs/archive/examples/v1/backend/tsconfig.json +17 -0
  361. package/docs/archive/examples/v1/docs/.gitkeep +0 -0
  362. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -0
  363. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -0
  364. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -0
  365. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -0
  366. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -0
  367. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -0
  368. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -0
  369. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -0
  370. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -0
  371. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -0
  372. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -0
  373. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -0
  374. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -0
  375. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -0
  376. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -0
  377. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -0
  378. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -0
  379. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -0
  380. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -0
  381. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -0
  382. package/docs/archive/examples/v1/memory/30-domains/shared/.gitkeep +0 -0
  383. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -0
  384. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -0
  385. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -0
  386. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -0
  387. package/docs/archive/examples/v1/memory/90-decisions/archive/.gitkeep +0 -0
  388. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -0
  389. package/docs/archive/examples/v1/scripts/.gitkeep +0 -0
  390. package/docs/archive/examples/v2/.memoryrc.json +8 -0
  391. package/docs/archive/examples/v2/AGENTS.md +16 -0
  392. package/docs/archive/examples/v2/README.md +35 -0
  393. package/docs/archive/examples/v2/agents/README.md +3 -0
  394. package/docs/archive/examples/v2/agents/backend-nest.md +9 -0
  395. package/docs/archive/examples/v2/agents/dba.md +4 -0
  396. package/docs/archive/examples/v2/agents/frontend.md +4 -0
  397. package/docs/archive/examples/v2/agents/orchestrator.md +9 -0
  398. package/docs/archive/examples/v2/agents/reviewer.md +6 -0
  399. package/docs/archive/examples/v2/agents/security.md +4 -0
  400. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -0
  401. package/docs/archive/examples/v2/backend/nest-cli.json +4 -0
  402. package/docs/archive/examples/v2/backend/package.json +42 -0
  403. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -0
  404. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -0
  405. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -0
  406. package/docs/archive/examples/v2/backend/src/main.ts +10 -0
  407. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -0
  408. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -0
  409. package/docs/archive/examples/v2/backend/tsconfig.json +17 -0
  410. package/docs/archive/examples/v2/docs/.gitkeep +0 -0
  411. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -0
  412. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -0
  413. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -0
  414. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -0
  415. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -0
  416. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -0
  417. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -0
  418. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -0
  419. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -0
  420. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -0
  421. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -0
  422. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -0
  423. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -0
  424. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -0
  425. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -0
  426. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -0
  427. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -0
  428. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -0
  429. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -0
  430. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -0
  431. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -0
  432. package/docs/archive/examples/v2/memory/30-domains/shared/.gitkeep +0 -0
  433. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -0
  434. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -0
  435. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -0
  436. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -0
  437. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -0
  438. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -0
  439. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -0
  440. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -0
  441. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -0
  442. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -0
  443. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -0
  444. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -0
  445. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -0
  446. package/docs/archive/examples/v2/memory/90-decisions/archive/.gitkeep +0 -0
  447. package/docs/archive/examples/v2/memory/README.md +8 -0
  448. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -0
  449. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -0
  450. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -0
  451. package/docs/archive/examples/v2/scripts/.gitkeep +0 -0
  452. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -0
  453. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -0
  454. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -0
  455. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -0
  456. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -0
  457. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -0
  458. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -0
  459. package/docs/capacidades-externas.md +70 -0
  460. package/docs/cli-first-operacao.md +74 -0
  461. package/docs/dashboard.md +102 -0
  462. package/docs/dev-workflow.md +421 -0
  463. package/docs/examples.md +546 -0
  464. package/docs/fluxo.md +103 -0
  465. package/docs/glossary.md +453 -0
  466. package/docs/init-project.md +457 -0
  467. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -0
  468. package/docs/personas/architect/README.md +333 -0
  469. package/docs/personas/developer/README.md +371 -0
  470. package/docs/personas/executive/README.md +172 -0
  471. package/docs/personas/qa/README.md +350 -0
  472. package/docs/processo-projeto.md +138 -0
  473. package/docs/publishing.md +377 -0
  474. package/docs/quick-reference.md +409 -0
  475. package/docs/structure.md +360 -0
  476. package/docs/token-optimization.md +494 -0
  477. package/lib/context-builder.js +257 -0
  478. package/lib/core/registry.mjs +284 -0
  479. package/lib/generators/memory-generator.js +844 -0
  480. package/lib/generators/nest-generator.js +496 -0
  481. package/lib/generators/readme-generator.js +213 -0
  482. package/lib/templates/harness/code-intel.mjs +119 -0
  483. package/lib/templates/harness/mcp.json +10 -0
  484. package/lib/utils/file-helpers.js +40 -0
  485. package/lib/validators/structure-validator.js +253 -0
  486. package/lib/workspace.mjs +213 -0
  487. package/memory/00-global/mission.md +15 -0
  488. package/memory/00-global/shared-knowledge.md +8 -0
  489. package/memory/00-global/standards.md +47 -0
  490. package/memory/10-product/personas.md +21 -0
  491. package/memory/10-product/vision.md +27 -0
  492. package/memory/30-projects/README.md +15 -0
  493. package/memory/40-delivery/backlog.md +15 -0
  494. package/memory/40-delivery/current-sprint.md +21 -0
  495. package/memory/50-orchestration/gsd-harness.md +55 -0
  496. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -0
  497. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -0
  498. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -0
  499. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -0
  500. package/memory/90-decisions/0005-handoff-7-campos.md +32 -0
  501. package/memory/90-decisions/0006-docs-por-persona.md +23 -0
  502. package/memory/90-decisions/0007-sdd-pipeline.md +33 -0
  503. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -0
  504. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -0
  505. package/memory/90-decisions/0010-banco-postgres.md +30 -0
  506. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -0
  507. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -0
  508. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -0
  509. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -0
  510. package/memory/90-decisions/0019-workspace-separado.md +45 -0
  511. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -0
  512. package/memory/90-decisions/_template.md +28 -0
  513. package/package.json +107 -0
  514. package/prompts/context-engineer-agent.md +19 -0
  515. package/prompts/governance-agent.md +15 -0
  516. package/prompts/marketing-agent.md +13 -0
  517. package/prompts/orchestrator-agent.md +18 -0
  518. package/prompts/product-agent.md +13 -0
  519. package/prompts/sdd-architect-agent.md +20 -0
  520. package/scripts/agent-harness.mjs +578 -0
  521. package/scripts/agent-router.mjs +189 -0
  522. package/scripts/build-smart-context.js +87 -0
  523. package/scripts/check-standards.js +98 -0
  524. package/scripts/compress-memory.mjs +198 -0
  525. package/scripts/compress-project-memory.js +58 -0
  526. package/scripts/context-ops.mjs +463 -0
  527. package/scripts/dev.mjs +349 -0
  528. package/scripts/extract-global-knowledge.js +52 -0
  529. package/scripts/generate-dashboard.js +59 -0
  530. package/scripts/hook-session-start.mjs +70 -0
  531. package/scripts/hook-user-prompt.mjs +185 -0
  532. package/scripts/memory-schema.mjs +68 -0
  533. package/scripts/pre-commit.sh +102 -0
  534. package/scripts/query-universal-memory.js +50 -0
  535. package/scripts/spec-cli.mjs +193 -0
  536. package/scripts/sprint-manager.js +200 -0
  537. package/scripts/sync-universal-memory.js +278 -0
  538. package/scripts/token-benchmark.mjs +203 -0
  539. package/scripts/tools-doctor.mjs +77 -0
  540. package/specs/README.md +70 -0
  541. package/specs/_templates/plan.md +43 -0
  542. package/specs/_templates/spec.md +43 -0
  543. package/specs/_templates/tasks.md +32 -0
  544. package/specs/agent-dashboard/plan.md +165 -0
  545. package/specs/agent-dashboard/spec.md +89 -0
  546. package/specs/agent-dashboard/tasks.md +168 -0
  547. package/specs/cli-first-operacao/plan.md +53 -0
  548. package/specs/cli-first-operacao/spec.md +53 -0
  549. package/specs/cli-first-operacao/tasks.md +53 -0
  550. package/specs/dev-token-assets-db/plan.md +71 -0
  551. package/specs/dev-token-assets-db/spec.md +58 -0
  552. package/specs/dev-token-assets-db/tasks.md +58 -0
  553. package/specs/forja-core/spec.md +71 -0
  554. package/specs/harness-codegraph/spec.md +71 -0
  555. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -0
  556. package/specs/reestruturacao-forja-v2/plan.md +95 -0
  557. package/specs/reestruturacao-forja-v2/spec.md +70 -0
  558. package/specs/reestruturacao-forja-v2/tasks.md +113 -0
@@ -0,0 +1,35 @@
1
+ # Biblioteca de Design (design-md)
2
+
3
+ Camada operacional de design do fluxo GSD: garante que toda feature com impacto
4
+ visual passe por **referência escolhida → brief preenchido → gate validado**,
5
+ em vez de "faz uma UI aí".
6
+
7
+ ## Como funciona
8
+
9
+ 1. **Escolha a referência** por superfície: [MATRIX.md](./MATRIX.md) mapeia
10
+ superfícies (agent console, dashboard, docs, landing…) para nomes de
11
+ referência (`linear.app`, `stripe`, `vercel`…). Os nomes são **vocabulário
12
+ compartilhado** entre agentes — apontam para produtos publicamente
13
+ conhecidos, não para cópias locais.
14
+ 2. **Preencha o brief**: [BRIEF-TEMPLATE.md](./BRIEF-TEMPLATE.md) é obrigatório
15
+ para features com impacto visual (9 campos, incluindo estados e critérios
16
+ de aceite visual).
17
+ 3. **Valide antes do handoff**: `forja design:check <brief.md>` reprova brief
18
+ incompleto; `gsd:check` puxa esse gate quando há brief.
19
+
20
+ ```bash
21
+ npm run design:select -- agent-console tecnico # sugere referências pela MATRIX
22
+ npm run design:check -- <caminho-do-brief.md> # gate de completude
23
+ ```
24
+
25
+ Regras de uso por agentes e checklist de handoff visual: [PLAYBOOK.md](./PLAYBOOK.md).
26
+ Exemplo de brief preenchido: [examples/agent-console-brief.md](./examples/agent-console-brief.md).
27
+
28
+ ## Cache local de referências (opcional)
29
+
30
+ Detalhes de cada sistema de design (tokens, componentes, padrões) podem ser
31
+ mantidos como cache local em `design-md/<nome>/README.md` + `design.manifest.json`.
32
+ O harness degrada graciosamente sem eles: `design:select` indica "sem cache
33
+ local" e o agente usa o conhecimento público da referência.
34
+
35
+ > Nunca copie identidade visual proprietária — referência é direção, não clone.
@@ -0,0 +1,24 @@
1
+ # Matriz de Referencias design-md
2
+
3
+ Use esta matriz para escolher referencias por tipo de superficie. Ela nao substitui o julgamento do designer/agente; ela reduz escolhas aleatorias.
4
+
5
+ | Superficie | Primarias recomendadas | Secundarias uteis | Evitar |
6
+ |---|---|---|---|
7
+ | Agent console / ops | linear.app, cursor, raycast | sentry, posthog, claude | visual de landing ou excesso decorativo |
8
+ | Dashboard executivo | stripe, linear.app, posthog | airbnb, sentry, supabase | cards gigantes sem densidade informacional |
9
+ | Docs / developer portal | mintlify, stripe, vercel | resend, supabase, hashicorp | layouts promocionais que escondem exemplos |
10
+ | SaaS operacional / CRM | linear.app, intercom, airtable | clay, notion, zapier | paleta de uma cor so e baixa densidade |
11
+ | Landing de produto tecnico | vercel, stripe, resend | cursor, x.ai, cohere | hero abstrato sem produto real |
12
+ | Ferramenta colaborativa | figma, miro, notion | cal, airtable, intercom | navegacao escondida ou comandos ambiguos |
13
+ | IA / agent workflow | claude, cursor, x.ai | mistral.ai, together.ai, cohere | magia visual sem rastreabilidade de execucao |
14
+ | Fintech / trust | wise, revolut, coinbase | stripe, kraken | linguagem visual agressiva sem confianca |
15
+ | Premium / marca forte | apple, bmw, ferrari | tesla, lamborghini, spacex | copiar identidade visual proprietaria |
16
+ | Observabilidade / incidentes | sentry, posthog, datadog-style local se existir | linear.app, stripe | esconder erros em UI decorativa |
17
+
18
+ ## Heuristica rapida
19
+
20
+ - Se a tela sera usada muitas vezes por dia, escolha referencias de produtividade: `linear.app`, `raycast`, `cursor`.
21
+ - Se a tela precisa ensinar ou vender uma API, escolha docs/devtools: `mintlify`, `stripe`, `vercel`.
22
+ - Se a tela precisa passar confianca, escolha sistemas com clareza financeira/operacional: `wise`, `stripe`, `sentry`.
23
+ - Se a tela e para agentes, sempre inclua rastreabilidade: fila, status, logs, handoffs e criterio de aceite visivel.
24
+
@@ -0,0 +1,35 @@
1
+ # Design Playbook para Agentes
2
+
3
+ Este playbook transforma `design-md/` em entrada operacional para Product, Frontend, SDD Architect e Governance. A pasta de marcas continua sendo biblioteca de referencia; este arquivo define como escolher, aplicar e auditar uma direcao visual sem depender de memoria solta.
4
+
5
+ ## Quando usar
6
+
7
+ - Antes de criar uma tela nova, componente critico, dashboard ou landing.
8
+ - Durante `spec.md`, quando a experiencia visual influencia conversao, confianca ou produtividade.
9
+ - Antes de merge/release, quando Governance precisa auditar fidelidade visual.
10
+
11
+ ## Fluxo minimo
12
+
13
+ 1. Defina a superficie: `dashboard`, `docs`, `landing`, `tool`, `mobile`, `checkout`, `agent-console`.
14
+ 2. Escolha 1 referencia primaria e ate 2 secundarias em `MATRIX.md`.
15
+ 3. Preencha `BRIEF-TEMPLATE.md` para o contexto da feature.
16
+ 4. Anexe o brief ao handoff de implementacao.
17
+ 5. Governance valida com `npm run design:check -- <brief.md>`.
18
+
19
+ ## Regras para agentes
20
+
21
+ - Nunca copie marca, logo, texto proprietario ou identidade visual completa.
22
+ - Use referencias como principios: densidade, ritmo, hierarquia, tom, navegacao, estados e padroes de interacao.
23
+ - Para SaaS, CRM, ops e dashboards: priorize legibilidade, densidade organizada e estados claros.
24
+ - Para landing: a primeira dobra deve comunicar objeto/oferta real, nao apenas estilo abstrato.
25
+ - Para ferramentas de agente: prefira affordances explicitas, logs verificaveis, controles previsiveis e feedback de estado.
26
+
27
+ ## Checklist de handoff visual
28
+
29
+ - Superficie e persona estao definidos.
30
+ - Referencia primaria tem justificativa clara.
31
+ - Tokens visuais foram definidos: cor, tipografia, raio, espacamento, densidade.
32
+ - Componentes esperados foram listados.
33
+ - Estados obrigatorios foram listados: vazio, carregando, erro, sucesso, permissao negada quando aplicavel.
34
+ - Criterios de aceite visual sao verificaveis por screenshot ou revisao objetiva.
35
+
@@ -0,0 +1,48 @@
1
+ # Design Brief
2
+
3
+ - **Feature/superficie**: agent console operacional
4
+ - **Persona principal**: desenvolvedor ou coordenador que acompanha handoffs, contexto e status de agentes durante uma sprint.
5
+ - **Objetivo da UI**: reduzir ambiguidade operacional mostrando fila, dono, aceite, status e proximo comando verificavel.
6
+ - **Referencia primaria**: linear.app, pela densidade organizada, hierarquia clara e foco em produtividade diaria.
7
+ - **Referencias secundarias**: cursor para contexto de IA; sentry para tratamento de estados e incidentes.
8
+ - **Densidade**: alta
9
+ - **Tom visual**: tecnico
10
+
11
+ ## Principios aplicados
12
+
13
+ - Navegacao lateral previsivel com conteudo principal orientado a tarefas.
14
+ - Estados de trabalho sempre visiveis: aberto, em andamento, bloqueado, concluido.
15
+ - Cada item acionavel mostra dono, criterio de aceite e proximo passo.
16
+
17
+ ## Tokens visuais
18
+
19
+ - **Cores**: neutros claros para fundo, texto de alto contraste, acentos funcionais para status.
20
+ - **Tipografia**: escala compacta, labels menores, headings restritos ao contexto da tela.
21
+ - **Espacamento**: grid de 8px, alta densidade sem sobreposicao.
22
+ - **Raios/bordas/sombras**: raio ate 8px, bordas sutis, sombras apenas para overlays.
23
+ - **Iconografia**: lucide ou equivalente, sempre com tooltip para acoes ambiguas.
24
+
25
+ ## Componentes esperados
26
+
27
+ - Lista de handoffs com status e filtros.
28
+ - Painel de detalhe com os 7 campos do ADR-0005.
29
+ - Log de eventos e comandos sugeridos.
30
+ - Indicadores de saude de contexto, design e spec.
31
+
32
+ ## Estados obrigatorios
33
+
34
+ - [x] Carregando
35
+ - [x] Vazio
36
+ - [x] Erro
37
+ - [x] Sucesso
38
+ - [x] Permissao/sem acesso, se aplicavel
39
+ - [x] Responsivo mobile, se aplicavel
40
+
41
+ ## Criterios de aceite visual
42
+
43
+ - [x] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
44
+ - [x] Texto nao quebra nem sobrepoe em mobile e desktop.
45
+ - [x] A hierarquia deixa clara a proxima acao do usuario.
46
+ - [x] Estados obrigatorios existem e sao coerentes.
47
+ - [x] A UI pode ser validada por screenshot ou checklist objetivo.
48
+
@@ -0,0 +1,63 @@
1
+ # Guia Executivo de Onboarding (1 página)
2
+
3
+ ## Objetivo
4
+ Garantir que o projeto seja iniciado, executado e levado para produção sem perda de contexto, com governança de decisão e risco.
5
+
6
+ ## Resultado Esperado
7
+ - Time alinhado em objetivos e escopo.
8
+ - Execução com steps claros, donos e critérios de pronto.
9
+ - Decisão Go/No-Go baseada em evidências.
10
+ - Continuidade operacional via documentação + handoff + resumos.
11
+
12
+ ## Como Iniciar (rápido)
13
+ 1. Criar projeto com scaffold:
14
+ ```bash
15
+ npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
16
+ ```
17
+ 2. Subir backend e memória operacional:
18
+ ```bash
19
+ cd nome-do-projeto/backend
20
+ npm install
21
+ npm run memory:db:init
22
+ npm run memory:db:sync
23
+ npm run start:dev
24
+ ```
25
+
26
+ ## Governança Mínima
27
+ - **Fonte da verdade**: markdown versionado (`memory/`, `docs/`).
28
+ - **Índice operacional**: SQLite para busca rápida de contexto.
29
+ - **Decisões arquiteturais**: ADR obrigatório para mudanças estruturais.
30
+ - **Troca entre responsáveis**: handoff obrigatório.
31
+
32
+ ## Modelo de Execução
33
+ - Orquestrador decompõe o plano em steps menores.
34
+ - Workers executam por ownership de arquivo.
35
+ - Reviewer valida regressão, segurança e qualidade.
36
+ - Resumos globais/dominio são atualizados ao final de cada ciclo.
37
+
38
+ ## Indicadores de Controle
39
+ - % steps com DoD completo
40
+ - # riscos críticos abertos
41
+ - cobertura de testes críticos
42
+ - incidentes pós-deploy
43
+ - tempo médio de handoff
44
+
45
+ ## Gate de Produção (Go/No-Go)
46
+ ### GO apenas se:
47
+ - build/testes/lint críticos verdes
48
+ - segurança validada (segredos, auth, validação de entrada)
49
+ - rollback definido e testado
50
+ - critérios de aceite aprovados
51
+
52
+ ### NO-GO se:
53
+ - risco crítico sem mitigação
54
+ - falha de segurança/integridade
55
+ - ausência de rollback executável
56
+
57
+ ## Responsabilidade da Liderança
58
+ - Cobrar clareza do plano e dos riscos antes da execução.
59
+ - Bloquear deploy sem checklist completo.
60
+ - Garantir atualização de documentação como parte da entrega.
61
+
62
+ ## Mensagem-chave
63
+ O projeto não depende de “memória da conversa”; depende de disciplina de documentação operacional e decisão rastreável.
@@ -0,0 +1,136 @@
1
+ # Guia Operacional por Papel
2
+
3
+ Este guia define responsabilidades objetivas por papel para execução previsível e validação segura até produção.
4
+
5
+ ## 1) DEV
6
+
7
+ ### Missão
8
+ Implementar com qualidade, manter contexto atualizado e reduzir retrabalho.
9
+
10
+ ### Checklist Diário
11
+ - Ler contexto mínimo (`memory/00-global`, `20-architecture`, `current-sprint`).
12
+ - Executar tarefa com dono de escopo claro.
13
+ - Rodar testes mínimos da mudança.
14
+ - Atualizar documentação impactada.
15
+ - Atualizar resumo/handoff quando necessário.
16
+ - Rodar sync da memória operacional:
17
+ ```bash
18
+ cd backend
19
+ npm run memory:db:sync
20
+ ```
21
+
22
+ ### Critério de Pronto (DEV)
23
+ - Código implementado
24
+ - Teste mínimo ok
25
+ - Sem quebra conhecida
26
+ - Documentação atualizada
27
+ - Risco registrado
28
+
29
+ ## 2) QA
30
+
31
+ ### Missão
32
+ Garantir que comportamento, qualidade e critérios de aceite estejam validados.
33
+
34
+ ### Checklist QA
35
+ - Validar critérios de aceite do step.
36
+ - Rodar cenários críticos (feliz + erro).
37
+ - Verificar regressão funcional.
38
+ - Validar contrato de API (status, payload, erro).
39
+ - Registrar evidências objetivas.
40
+
41
+ ### Saída QA
42
+ - `Aprovado` / `Aprovado com ressalvas` / `Reprovado`
43
+ - Bugs com severidade e impacto
44
+ - Recomendação para gate de produção
45
+
46
+ ## 3) SRE
47
+
48
+ ### Missão
49
+ Assegurar estabilidade operacional, observabilidade e rollback.
50
+
51
+ ### Checklist SRE
52
+ - Healthcheck funcional.
53
+ - Logs e métricas essenciais disponíveis.
54
+ - Alertas mínimos ativos.
55
+ - Rollback documentado e testável.
56
+ - Dependências externas validadas.
57
+
58
+ ### Gate SRE
59
+ Sem rollback executável e sem observabilidade mínima: **NO-GO**.
60
+
61
+ ## 4) TECH LEAD
62
+
63
+ ### Missão
64
+ Orquestrar plano, reduzir risco sistêmico e garantir decisão técnica coerente.
65
+
66
+ ### Checklist Tech Lead
67
+ - Quebrar demanda em steps testáveis.
68
+ - Validar dependências e ordem de execução.
69
+ - Garantir ownership sem sobreposição de escrita.
70
+ - Exigir ADR em decisão estrutural.
71
+ - Consolidar riscos antes de produção.
72
+
73
+ ### Entregável Tech Lead
74
+ - Plano final da sprint
75
+ - Matriz de risco
76
+ - Recomendação Go/No-Go
77
+
78
+ ## 5) Fluxo Integrado (papéis)
79
+
80
+ 1. Tech Lead/Orchestrator define steps e donos.
81
+ 2. Dev implementa + testa + documenta.
82
+ 3. QA valida critérios e regressão.
83
+ 4. SRE valida operação e rollback.
84
+ 5. Tech Lead consolida e decide com stakeholders.
85
+
86
+ ## 6) Questionamento Obrigatório por Step
87
+
88
+ Antes de executar, todos devem responder:
89
+ - Está claro o objetivo e o critério de sucesso?
90
+ - Dependências e bloqueios estão explícitos?
91
+ - Risco e impacto foram mapeados?
92
+ - Existe forma de validar e de reverter?
93
+
94
+ Se qualquer item for “não”: refinar step antes da execução.
95
+
96
+ ## 7) Comandos Úteis
97
+
98
+ ### Setup
99
+ ```bash
100
+ cd backend
101
+ npm install
102
+ npm run memory:db:init
103
+ npm run memory:db:sync
104
+ ```
105
+
106
+ ### Consulta de contexto
107
+ ```bash
108
+ npm run memory:db:query -- "search" "auth" 10
109
+ npm run memory:db:query -- handoffs 10
110
+ npm run memory:db:query -- adrs 20
111
+ ```
112
+
113
+ ### Registrar handoff
114
+ ```bash
115
+ cd ..
116
+ node scripts/append-handoff.mjs orchestrator backend-nest "implementar modulo auth"
117
+ ```
118
+
119
+ ## 8) Gate Final de Produção
120
+
121
+ ### GO quando:
122
+ - DEV, QA e SRE aprovaram seus checklists
123
+ - riscos críticos mitigados
124
+ - rollback pronto
125
+
126
+ ### NO-GO quando:
127
+ - risco crítico aberto
128
+ - falha de segurança
129
+ - ausência de evidência de validação
130
+
131
+ ---
132
+
133
+ ## 9) Princípio de operação
134
+
135
+ Qualidade, documentação e continuidade de contexto são parte da entrega técnica.
136
+ Não são atividades opcionais.
@@ -0,0 +1,279 @@
1
+ # Guia de Onboarding do Projeto
2
+
3
+ Este documento ensina como iniciar, estruturar, executar e validar um projeto usando o scaffold `create-memory-nest-kit`.
4
+
5
+ ## 1) Objetivo do Guia
6
+
7
+ Ao final deste guia, a pessoa responsável deve conseguir:
8
+ - criar um projeto com `npx`
9
+ - entender a estrutura de memória/documentação
10
+ - gerar e revisar os steps de execução
11
+ - questionar o plano antes de executar
12
+ - validar com checklist técnico e de produção
13
+ - realizar go-live com segurança
14
+
15
+ ## 2) Pré-requisitos
16
+
17
+ - Node.js 18+
18
+ - npm 9+
19
+ - Git instalado
20
+ - Conta GitHub (se for publicar remoto)
21
+ - (Opcional) Conta npm (se for publicar pacote)
22
+
23
+ Validação rápida:
24
+
25
+ ```bash
26
+ node -v
27
+ npm -v
28
+ git --version
29
+ ```
30
+
31
+ ## 3) Criar Projeto com npx
32
+
33
+ ### Opção A: via GitHub
34
+
35
+ ```bash
36
+ npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
37
+ ```
38
+
39
+ ### Opção B: via npm
40
+
41
+ ```bash
42
+ npx create-memory-nest-kit@latest nome-do-projeto
43
+ ```
44
+
45
+ ### Opção C: local (desenvolvimento)
46
+
47
+ ```bash
48
+ node ./bin/create-memory-nest-kit.js nome-do-projeto
49
+ ```
50
+
51
+ Entrar no projeto:
52
+
53
+ ```bash
54
+ cd nome-do-projeto
55
+ ```
56
+
57
+ ## 4) Estrutura Gerada (resumo)
58
+
59
+ - `memory/`: base de contexto e continuidade
60
+ - `agents/`: responsabilidades por tipo de agente
61
+ - `skills/`: playbooks operacionais reutilizáveis
62
+ - `prompts/`: templates de orquestração e execução
63
+ - `scripts/`: utilitários de contexto e handoff
64
+ - `backend/`: API NestJS base
65
+ - `.memory/sqlite/`: índice SQLite operacional
66
+
67
+ ## 5) Primeiro Setup
68
+
69
+ ### 5.1 Backend
70
+
71
+ ```bash
72
+ cd backend
73
+ npm install
74
+ npm run start:dev
75
+ ```
76
+
77
+ Checagem esperada:
78
+ - API sobe sem erro
79
+ - rota de saúde responde (`/api/health`)
80
+
81
+ ### 5.2 Memória operacional (SQLite)
82
+
83
+ Ainda dentro de `backend/`:
84
+
85
+ ```bash
86
+ npm run memory:db:init
87
+ npm run memory:db:sync
88
+ npm run memory:db:query -- "search" "contexto" 10
89
+ ```
90
+
91
+ O que isso faz:
92
+ - `init`: cria schema do banco de memória
93
+ - `sync`: indexa os markdowns (memory/docs/agents/skills/prompts)
94
+ - `query`: consulta rápida de contexto
95
+
96
+ ## 6) Como Gerar os Steps do Projeto
97
+
98
+ Use este fluxo para definir plano e execução:
99
+
100
+ 1. Ler contexto mínimo:
101
+ - `memory/00-global/*`
102
+ - `memory/10-product/*`
103
+ - `memory/20-architecture/*`
104
+ - `memory/40-delivery/current-sprint.md`
105
+
106
+ 2. Criar plano inicial em `memory/40-delivery/current-sprint.md` com:
107
+ - objetivo
108
+ - steps técnicos
109
+ - riscos
110
+ - dono por step
111
+
112
+ 3. Quebrar em subtarefas (se necessário) no padrão multiagente:
113
+ - Orchestrator define escopo
114
+ - Worker por domínio executa
115
+ - Reviewer valida
116
+
117
+ 4. Registrar handoffs:
118
+
119
+ ```bash
120
+ node scripts/append-handoff.mjs orchestrator backend-nest "implementar modulo auth"
121
+ ```
122
+
123
+ 5. Atualizar resumo operacional:
124
+ - `memory/70-summaries/global-summary.md`
125
+ - `memory/70-summaries/domain-summary.md`
126
+
127
+ ## 7) Questionando os Steps (obrigatório)
128
+
129
+ Antes de executar qualquer step, responder:
130
+
131
+ ### 7.1 Clareza
132
+ - O step está claro e testável?
133
+ - O resultado esperado está explícito?
134
+
135
+ ### 7.2 Dependências
136
+ - Esse step depende de outro?
137
+ - Há bloqueio externo (infra, credencial, API de terceiro)?
138
+
139
+ ### 7.3 Risco
140
+ - Qual risco funcional?
141
+ - Qual risco de segurança?
142
+ - Qual risco de regressão?
143
+
144
+ ### 7.4 Observabilidade
145
+ - Como saber se deu certo?
146
+ - Que métrica/log/teste confirma o sucesso?
147
+
148
+ ### 7.5 Rollback
149
+ - Se falhar, como desfazer com segurança?
150
+
151
+ Se qualquer resposta estiver fraca, o step volta para refinamento antes de execução.
152
+
153
+ ## 8) Critério de Pronto por Step (Definition of Done)
154
+
155
+ Um step só é concluído quando:
156
+ - código implementado
157
+ - teste mínimo executado
158
+ - risco registrado
159
+ - documentação atualizada
160
+ - resumo/handoff atualizado (se houve troca de agente)
161
+
162
+ ## 9) Validação Pré-Produção
163
+
164
+ Checklist mínimo:
165
+
166
+ ### 9.1 Técnica
167
+ - build ok
168
+ - testes críticos ok
169
+ - lint/qualidade ok
170
+ - migrations validadas (se houver)
171
+
172
+ ### 9.2 Segurança
173
+ - sem segredo hardcoded
174
+ - validação de entrada ativa
175
+ - autorização revisada
176
+ - logs sem dados sensíveis
177
+
178
+ ### 9.3 Operação
179
+ - healthcheck ok
180
+ - monitoramento/alertas definidos
181
+ - rollback pronto e testado
182
+
183
+ ### 9.4 Produto
184
+ - critérios de aceite atendidos
185
+ - fluxos críticos validados com negócio
186
+
187
+ ## 10) Go/No-Go para Produção
188
+
189
+ Regra prática:
190
+ - **GO**: todos checklists verdes + riscos aceitáveis + rollback pronto
191
+ - **NO-GO**: qualquer falha crítica em segurança, integridade de dados ou indisponibilidade sem plano de retorno
192
+
193
+ Template de decisão:
194
+
195
+ ```text
196
+ Decisão: GO | NO-GO
197
+ Data:
198
+ Responsável:
199
+ Motivos:
200
+ Riscos remanescentes:
201
+ Plano de rollback:
202
+ ```
203
+
204
+ ## 11) Pós-Deploy (produção)
205
+
206
+ Após subir:
207
+ - monitorar logs e métricas por janela definida
208
+ - validar rotas críticas
209
+ - registrar resultado em `memory/60-runs/` e resumo em `memory/70-summaries/global-summary.md`
210
+
211
+ Template pós-deploy:
212
+
213
+ ```text
214
+ Deploy realizado em:
215
+ Versão:
216
+ Status inicial:
217
+ Incidentes:
218
+ Ações corretivas:
219
+ Próximos passos:
220
+ ```
221
+
222
+ ## 12) Fluxo Recomendado de Trabalho Diário
223
+
224
+ 1. Sincronizar memória:
225
+ ```bash
226
+ cd backend
227
+ npm run memory:db:sync
228
+ ```
229
+
230
+ 2. Buscar contexto da tarefa:
231
+ ```bash
232
+ npm run memory:db:query -- "search" "tema da tarefa" 10
233
+ ```
234
+
235
+ 3. Executar step
236
+ 4. Atualizar docs + resumo
237
+ 5. Registrar handoff (se houver troca de responsável)
238
+
239
+ ## 13) Erros Comuns e Como Evitar
240
+
241
+ - Erro: executar sem refinar step.
242
+ - Evitar: aplicar seção 7 (questionamento obrigatório).
243
+
244
+ - Erro: esquecer atualização de memória.
245
+ - Evitar: sempre rodar `memory:db:sync` após mudanças relevantes.
246
+
247
+ - Erro: deploy sem rollback claro.
248
+ - Evitar: incluir rollback como item obrigatório no DoD.
249
+
250
+ - Erro: contexto disperso em chat apenas.
251
+ - Evitar: registrar decisão em `memory/90-decisions` e resumo em `memory/70-summaries`.
252
+
253
+ ## 14) Comandos Rápidos (cola)
254
+
255
+ ```bash
256
+ # criar projeto
257
+ npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
258
+
259
+ # setup inicial
260
+ cd nome-do-projeto/backend
261
+ npm install
262
+ npm run memory:db:init
263
+ npm run memory:db:sync
264
+ npm run start:dev
265
+
266
+ # consultar contexto
267
+ npm run memory:db:query -- "search" "auth" 10
268
+
269
+ # registrar handoff (na raiz do projeto)
270
+ cd ..
271
+ node scripts/append-handoff.mjs orchestrator backend-nest "step de auth"
272
+ ```
273
+
274
+ ---
275
+
276
+ ## 15) Ponto Mais Importante
277
+
278
+ Este projeto foi desenhado para **não perder contexto operacional**.
279
+ A disciplina de documentação + handoff + resumo é parte da entrega, não “extra”.