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,119 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * code-intel — camada de code intelligence sobre o codegraph (ADR-0017).
4
+ *
5
+ * Auto-contido: depende apenas do binario `codegraph` no PATH. Se ausente,
6
+ * degrada graciosamente (avisa e segue) — nunca trava o fluxo.
7
+ *
8
+ * Comandos:
9
+ * check Valida indice (worktree + freshness)
10
+ * impact <simbolo> [d] Chamadores e blast radius de um simbolo
11
+ *
12
+ * Emitido por forja/init-project.js. Veja docs do framework para o GSD completo.
13
+ */
14
+
15
+ import { spawnSync } from 'node:child_process';
16
+
17
+ function runCodegraph(args) {
18
+ const result = spawnSync('codegraph', args, { encoding: 'utf8' });
19
+ if (result.error && result.error.code === 'ENOENT') return { missing: true };
20
+ return {
21
+ missing: false,
22
+ status: result.status ?? 1,
23
+ stdout: (result.stdout || '').trim(),
24
+ stderr: (result.stderr || '').trim(),
25
+ };
26
+ }
27
+
28
+ function codegraphStatus() {
29
+ const res = runCodegraph(['status', '--json']);
30
+ if (res.missing) return { missing: true };
31
+ let data = null;
32
+ try {
33
+ data = JSON.parse(res.stdout);
34
+ } catch {
35
+ return { missing: false, parseError: true, raw: res.stdout || res.stderr };
36
+ }
37
+ const pending = data.pendingChanges || {};
38
+ const pendingTotal = (pending.added || 0) + (pending.modified || 0) + (pending.removed || 0);
39
+ return {
40
+ missing: false,
41
+ initialized: Boolean(data.initialized),
42
+ worktreeMismatch: data.worktreeMismatch || null,
43
+ fileCount: data.fileCount || 0,
44
+ pendingTotal,
45
+ reindexRecommended: Boolean(data.index && data.index.reindexRecommended),
46
+ };
47
+ }
48
+
49
+ function fail(msg) {
50
+ console.error(msg);
51
+ process.exit(1);
52
+ }
53
+
54
+ function cmdCheck() {
55
+ const s = codegraphStatus();
56
+ if (s.missing) {
57
+ console.log('Codegraph nao instalado no PATH. Code intelligence ignorado.');
58
+ console.log('Instale com: npm i -g @codegraph/cli');
59
+ process.exit(0);
60
+ }
61
+ if (s.parseError) {
62
+ console.log('Codegraph respondeu, mas status --json nao pode ser lido.');
63
+ fail(s.raw || 'sem saida');
64
+ }
65
+ const lines = [];
66
+ let blocking = false;
67
+ if (!s.initialized) {
68
+ blocking = true;
69
+ lines.push('FAIL indice ausente: rode `npm run code:index`.');
70
+ } else {
71
+ lines.push(`OK indice inicializado (${s.fileCount} arquivos).`);
72
+ }
73
+ if (s.worktreeMismatch) {
74
+ blocking = true;
75
+ lines.push(`FAIL indice de outro worktree: ${s.worktreeMismatch}. Rode \`codegraph init -i\`.`);
76
+ } else if (s.initialized) {
77
+ lines.push('OK indice pertence a este worktree.');
78
+ }
79
+ if (s.pendingTotal > 0 || s.reindexRecommended) {
80
+ lines.push(`WARN indice defasado (${s.pendingTotal} pend.). Rode \`npm run code:sync\`.`);
81
+ } else if (s.initialized) {
82
+ lines.push('OK indice em dia.');
83
+ }
84
+ console.log('Codegraph check:\n');
85
+ for (const line of lines) console.log(line);
86
+ if (blocking) fail('\nResultado: gate de code intelligence reprovado.');
87
+ console.log('\nResultado: code intelligence confiavel.');
88
+ }
89
+
90
+ function cmdImpact(symbol, depthArg) {
91
+ if (!symbol) fail('Uso: code-intel impact <simbolo> [profundidade]');
92
+ const probe = runCodegraph(['status', '--json']);
93
+ if (probe.missing) {
94
+ console.log('Codegraph nao instalado. Sem mapa de impacto automatico.');
95
+ console.log(`Fallback manual: grep -rn "${symbol}" . e leia os chamadores.`);
96
+ process.exit(0);
97
+ }
98
+ const depth = String(parseInt(depthArg, 10) || 2);
99
+ console.log(`Mapa de impacto: ${symbol} (profundidade ${depth})\n`);
100
+ const impact = runCodegraph(['impact', symbol, '-d', depth]);
101
+ if (impact.stdout) console.log(impact.stdout);
102
+ const callers = runCodegraph(['callers', symbol]);
103
+ if (callers.stdout) {
104
+ console.log('\n--- Chamadores diretos ---');
105
+ console.log(callers.stdout);
106
+ }
107
+ if (!impact.stdout && !callers.stdout) {
108
+ console.log('Nenhum no encontrado. Confirme o nome ou rode `npm run code:sync`.');
109
+ }
110
+ }
111
+
112
+ const [cmd, ...rest] = process.argv.slice(2);
113
+ switch (cmd) {
114
+ case 'check': cmdCheck(); break;
115
+ case 'impact': cmdImpact(rest[0], rest[1]); break;
116
+ default:
117
+ console.log('Uso: node scripts/code-intel.mjs <check|impact> [args]');
118
+ process.exit(cmd ? 1 : 0);
119
+ }
@@ -0,0 +1,10 @@
1
+ {
2
+ "mcpServers": {
3
+ "codegraph": {
4
+ "type": "stdio",
5
+ "command": "codegraph",
6
+ "args": ["serve", "--mcp"],
7
+ "env": {}
8
+ }
9
+ }
10
+ }
@@ -0,0 +1,40 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+
4
+ /**
5
+ * Funções utilitárias compartilhadas para geração de arquivos
6
+ */
7
+
8
+ export function ensureDir(dirPath) {
9
+ fs.mkdirSync(dirPath, { recursive: true });
10
+ }
11
+
12
+ export function writeFileSafe(filePath, content, options = {}) {
13
+ const { force = false } = options;
14
+ if (fs.existsSync(filePath) && !force) {
15
+ throw new Error(`Arquivo ja existe: ${filePath}. Use --force para sobrescrever.`);
16
+ }
17
+ ensureDir(path.dirname(filePath));
18
+ fs.writeFileSync(filePath, content, 'utf8');
19
+ }
20
+
21
+ export function maybeGitkeep(dirPath, options = {}) {
22
+ const { noGitkeep = false } = options;
23
+ if (noGitkeep) return;
24
+ const keepFile = path.join(dirPath, '.gitkeep');
25
+ if (!fs.existsSync(keepFile)) {
26
+ fs.writeFileSync(keepFile, '', 'utf8');
27
+ }
28
+ }
29
+
30
+ export function log(message) {
31
+ console.log(message);
32
+ }
33
+
34
+ export function logError(message) {
35
+ console.error(`❌ ${message}`);
36
+ }
37
+
38
+ export function logSuccess(message) {
39
+ console.log(`✅ ${message}`);
40
+ }
@@ -0,0 +1,253 @@
1
+ /**
2
+ * Structure Validator - Valida integridade da estrutura gerada
3
+ * Garante que todos os diretórios e arquivos críticos foram criados
4
+ */
5
+
6
+ import fs from 'node:fs';
7
+ import path from 'node:path';
8
+
9
+ /**
10
+ * Lista dos arquivos críticos que devem existir
11
+ */
12
+ const CRITICAL_FILES = [
13
+ 'memory/00-global/mission.md',
14
+ 'memory/00-global/standards.md',
15
+ 'memory/10-product/vision.md',
16
+ 'memory/20-architecture/backend.md',
17
+ 'memory/40-delivery/current-sprint.md',
18
+ 'memory/50-orchestration/topology.md',
19
+ 'AGENTS.md',
20
+ '.memoryrc.json',
21
+ ];
22
+
23
+ /**
24
+ * Lista de diretórios críticos
25
+ */
26
+ const CRITICAL_DIRS = [
27
+ 'memory',
28
+ 'memory/00-global',
29
+ 'memory/10-product',
30
+ 'memory/20-architecture',
31
+ 'memory/30-domains',
32
+ 'memory/40-delivery',
33
+ 'memory/50-orchestration',
34
+ 'memory/60-runs',
35
+ 'memory/70-summaries',
36
+ 'agents',
37
+ 'skills',
38
+ 'prompts',
39
+ '.memory/sqlite',
40
+ ];
41
+
42
+ /**
43
+ * Validações específicas do NestJS backend
44
+ */
45
+ const NEST_CRITICAL_FILES = [
46
+ 'backend/package.json',
47
+ 'backend/src/main.ts',
48
+ 'backend/src/app.module.ts',
49
+ 'backend/src/app.controller.ts',
50
+ 'backend/src/app.service.ts',
51
+ 'backend/tsconfig.json',
52
+ ];
53
+
54
+ const NEST_CRITICAL_DIRS = [
55
+ 'backend/src',
56
+ 'backend/src/modules/ops',
57
+ 'backend/test',
58
+ 'backend/scripts',
59
+ ];
60
+
61
+ /**
62
+ * Valida estrutura de memória
63
+ * @param {string} baseDir - Diretório base
64
+ * @returns {Object} Resultado da validação
65
+ */
66
+ export function validateMemoryStructure(baseDir) {
67
+ const errors = [];
68
+ const warnings = [];
69
+
70
+ // Validar arquivos críticos
71
+ for (const filePath of CRITICAL_FILES) {
72
+ const abs = path.join(baseDir, filePath);
73
+ if (!fs.existsSync(abs)) {
74
+ errors.push(`Arquivo crítico não encontrado: ${filePath}`);
75
+ }
76
+ }
77
+
78
+ // Validar diretórios críticos
79
+ for (const dirPath of CRITICAL_DIRS) {
80
+ const abs = path.join(baseDir, dirPath);
81
+ if (!fs.existsSync(abs)) {
82
+ errors.push(`Diretório crítico não encontrado: ${dirPath}`);
83
+ } else if (!fs.statSync(abs).isDirectory()) {
84
+ errors.push(`Não é um diretório: ${dirPath}`);
85
+ }
86
+ }
87
+
88
+ // Validar conteúdo de mission.md
89
+ const missionPath = path.join(baseDir, 'memory/00-global/mission.md');
90
+ if (fs.existsSync(missionPath)) {
91
+ const content = fs.readFileSync(missionPath, 'utf8');
92
+ if (!content.includes('Missao') && !content.includes('Missão')) {
93
+ warnings.push('mission.md parece estar vazio ou incorreto');
94
+ }
95
+ }
96
+
97
+ // Validar .memoryrc.json é JSON válido
98
+ const memoryrcPath = path.join(baseDir, '.memoryrc.json');
99
+ if (fs.existsSync(memoryrcPath)) {
100
+ try {
101
+ const content = fs.readFileSync(memoryrcPath, 'utf8');
102
+ JSON.parse(content);
103
+ } catch (e) {
104
+ errors.push('.memoryrc.json é JSON inválido');
105
+ }
106
+ }
107
+
108
+ return {
109
+ isValid: errors.length === 0,
110
+ errors,
111
+ warnings,
112
+ checklist: {
113
+ memoryStructure: CRITICAL_DIRS.length,
114
+ memoryFiles: CRITICAL_FILES.length,
115
+ },
116
+ };
117
+ }
118
+
119
+ /**
120
+ * Valida estrutura NestJS
121
+ * @param {string} baseDir - Diretório base
122
+ * @returns {Object} Resultado da validação
123
+ */
124
+ export function validateNestStructure(baseDir) {
125
+ const errors = [];
126
+ const warnings = [];
127
+
128
+ // Validar arquivos críticos do NestJS
129
+ for (const filePath of NEST_CRITICAL_FILES) {
130
+ const abs = path.join(baseDir, filePath);
131
+ if (!fs.existsSync(abs)) {
132
+ errors.push(`Arquivo NestJS não encontrado: ${filePath}`);
133
+ }
134
+ }
135
+
136
+ // Validar diretórios críticos do NestJS
137
+ for (const dirPath of NEST_CRITICAL_DIRS) {
138
+ const abs = path.join(baseDir, dirPath);
139
+ if (!fs.existsSync(abs)) {
140
+ errors.push(`Diretório NestJS não encontrado: ${dirPath}`);
141
+ }
142
+ }
143
+
144
+ // Validar package.json
145
+ const pkgPath = path.join(baseDir, 'backend/package.json');
146
+ if (fs.existsSync(pkgPath)) {
147
+ try {
148
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
149
+ if (!pkg.dependencies['@nestjs/common']) {
150
+ errors.push('package.json não contém @nestjs/common');
151
+ }
152
+ } catch (e) {
153
+ errors.push('backend/package.json é JSON inválido');
154
+ }
155
+ }
156
+
157
+ // Validar tsconfig.json
158
+ const tsconfigPath = path.join(baseDir, 'backend/tsconfig.json');
159
+ if (fs.existsSync(tsconfigPath)) {
160
+ try {
161
+ JSON.parse(fs.readFileSync(tsconfigPath, 'utf8'));
162
+ } catch (e) {
163
+ errors.push('backend/tsconfig.json é JSON inválido');
164
+ }
165
+ }
166
+
167
+ return {
168
+ isValid: errors.length === 0,
169
+ errors,
170
+ warnings,
171
+ checklist: {
172
+ nestDirectories: NEST_CRITICAL_DIRS.length,
173
+ nestFiles: NEST_CRITICAL_FILES.length,
174
+ },
175
+ };
176
+ }
177
+
178
+ /**
179
+ * Valida estrutura completa do projeto
180
+ * @param {string} baseDir - Diretório base
181
+ * @param {Object} options - Opções { includeNest: boolean }
182
+ * @returns {Object} Resultado completo
183
+ */
184
+ export function validateProjectStructure(baseDir, options = {}) {
185
+ const { includeNest = false } = options;
186
+
187
+ const memoryResult = validateMemoryStructure(baseDir);
188
+ const results = { memory: memoryResult };
189
+
190
+ if (includeNest) {
191
+ results.nest = validateNestStructure(baseDir);
192
+ }
193
+
194
+ const allErrors = [
195
+ ...memoryResult.errors,
196
+ ...(results.nest?.errors || []),
197
+ ];
198
+
199
+ return {
200
+ isValid: allErrors.length === 0,
201
+ errors: allErrors,
202
+ warnings: [
203
+ ...memoryResult.warnings,
204
+ ...(results.nest?.warnings || []),
205
+ ],
206
+ results,
207
+ summary: {
208
+ totalErrors: allErrors.length,
209
+ hasNest: includeNest,
210
+ timestamp: new Date().toISOString(),
211
+ },
212
+ };
213
+ }
214
+
215
+ /**
216
+ * Imprime relatório de validação de forma amigável
217
+ * @param {Object} report - Resultado de validateProjectStructure
218
+ */
219
+ export function printValidationReport(report) {
220
+ if (report.isValid) {
221
+ console.log('✅ Estrutura do projeto é válida!');
222
+ } else {
223
+ console.log('❌ Estrutura do projeto tem problemas:');
224
+ console.log('');
225
+ for (const error of report.errors) {
226
+ console.log(` ❌ ${error}`);
227
+ }
228
+ }
229
+
230
+ if (report.warnings.length > 0) {
231
+ console.log('');
232
+ console.log('⚠️ Avisos:');
233
+ for (const warning of report.warnings) {
234
+ console.log(` ⚠️ ${warning}`);
235
+ }
236
+ }
237
+
238
+ if (report.summary) {
239
+ console.log('');
240
+ console.log(`📊 Verificado em: ${report.summary.timestamp}`);
241
+ }
242
+ }
243
+
244
+ export default {
245
+ validateProjectStructure,
246
+ validateMemoryStructure,
247
+ validateNestStructure,
248
+ printValidationReport,
249
+ CRITICAL_FILES,
250
+ CRITICAL_DIRS,
251
+ NEST_CRITICAL_FILES,
252
+ NEST_CRITICAL_DIRS,
253
+ };
@@ -0,0 +1,213 @@
1
+ /**
2
+ * lib/workspace.mjs
3
+ *
4
+ * Centraliza a resolução de caminhos do workspace Forja.
5
+ *
6
+ * Regras de prioridade para descobrir o workspace:
7
+ * 1. Variável de ambiente FORJA_WORKSPACE
8
+ * 2. Arquivo ~/.forjarc.json (campo workspaceRoot)
9
+ * 3. Default: ~/forja-workspace
10
+ *
11
+ * O workspace é o "canto fixo" onde projetos de produto vivem:
12
+ * ~/forja-workspace/
13
+ * projects/ # projetos gerados
14
+ * memory/ # memória universal do workspace
15
+ * sqlite/universal.db # SQLite FTS5
16
+ * 30-projects/ # fichas de projetos
17
+ * specs/ # specs de produto
18
+ * .context/ # runbooks GSD de produto
19
+ * .forjarc.json # config local do workspace (opcional)
20
+ */
21
+
22
+ import fs from 'node:fs';
23
+ import path from 'node:path';
24
+ import os from 'node:os';
25
+ import { fileURLToPath } from 'node:url';
26
+
27
+ const __filename = fileURLToPath(import.meta.url);
28
+ const __dirname = path.dirname(__filename);
29
+
30
+ const DEFAULT_WORKSPACE_NAME = 'forja-workspace';
31
+
32
+ function getHomeDir() {
33
+ return os.homedir();
34
+ }
35
+
36
+ function readJsonSafe(filePath) {
37
+ try {
38
+ const raw = fs.readFileSync(filePath, 'utf8');
39
+ return JSON.parse(raw);
40
+ } catch {
41
+ return null;
42
+ }
43
+ }
44
+
45
+ export function getUserConfigPath() {
46
+ return path.join(getHomeDir(), '.forjarc.json');
47
+ }
48
+
49
+ export function getWorkspaceRoot() {
50
+ if (process.env.FORJA_WORKSPACE) {
51
+ return path.resolve(process.env.FORJA_WORKSPACE);
52
+ }
53
+
54
+ const userConfig = readJsonSafe(getUserConfigPath());
55
+ if (userConfig?.workspaceRoot) {
56
+ return path.resolve(userConfig.workspaceRoot);
57
+ }
58
+
59
+ return path.join(getHomeDir(), DEFAULT_WORKSPACE_NAME);
60
+ }
61
+
62
+ export function getWorkspaceInfo() {
63
+ const root = getWorkspaceRoot();
64
+ return {
65
+ root,
66
+ source: process.env.FORJA_WORKSPACE
67
+ ? 'FORJA_WORKSPACE'
68
+ : fs.existsSync(getUserConfigPath())
69
+ ? '~/.forjarc.json'
70
+ : 'default',
71
+ exists: fs.existsSync(root),
72
+ };
73
+ }
74
+
75
+ export function getProjectsDir() {
76
+ return path.join(getWorkspaceRoot(), 'projects');
77
+ }
78
+
79
+ export function getWorkspaceMemoryDir() {
80
+ return path.join(getWorkspaceRoot(), 'memory');
81
+ }
82
+
83
+ export function getWorkspaceDbDir() {
84
+ return path.join(getWorkspaceMemoryDir(), 'sqlite');
85
+ }
86
+
87
+ export function getWorkspaceDbPath() {
88
+ return path.join(getWorkspaceDbDir(), 'universal.db');
89
+ }
90
+
91
+ export function getWorkspaceProjectsMemoryDir() {
92
+ return path.join(getWorkspaceMemoryDir(), '30-projects');
93
+ }
94
+
95
+ export function getWorkspaceSpecsDir() {
96
+ return path.join(getWorkspaceRoot(), 'specs');
97
+ }
98
+
99
+ export function getWorkspaceContextDir() {
100
+ return path.join(getWorkspaceRoot(), '.context');
101
+ }
102
+
103
+ export function resolveProject(name) {
104
+ if (!name || typeof name !== 'string') {
105
+ throw new Error('Nome do projeto é obrigatório');
106
+ }
107
+ const safe = name.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
108
+ if (!safe) {
109
+ throw new Error(`Nome de projeto inválido: ${name}`);
110
+ }
111
+ return path.join(getProjectsDir(), safe);
112
+ }
113
+
114
+ export function listProjects() {
115
+ const dir = getProjectsDir();
116
+ if (!fs.existsSync(dir)) return [];
117
+ return fs
118
+ .readdirSync(dir, { withFileTypes: true })
119
+ .filter((entry) => entry.isDirectory())
120
+ .map((entry) => entry.name);
121
+ }
122
+
123
+ export function ensureDir(dir) {
124
+ if (!fs.existsSync(dir)) {
125
+ fs.mkdirSync(dir, { recursive: true });
126
+ }
127
+ return dir;
128
+ }
129
+
130
+ export function initWorkspace() {
131
+ const root = ensureDir(getWorkspaceRoot());
132
+ ensureDir(getProjectsDir());
133
+ ensureDir(getWorkspaceMemoryDir());
134
+ ensureDir(getWorkspaceDbDir());
135
+ ensureDir(getWorkspaceProjectsMemoryDir());
136
+ ensureDir(getWorkspaceSpecsDir());
137
+ ensureDir(getWorkspaceContextDir());
138
+
139
+ // Cria README de convenção no workspace
140
+ const readmePath = path.join(root, 'README.md');
141
+ if (!fs.existsSync(readmePath)) {
142
+ fs.writeFileSync(
143
+ readmePath,
144
+ `# Forja Workspace
145
+
146
+ Este é o workspace de produção do Forja. Aqui vivem projetos gerados, memória universal e specs de produto.
147
+
148
+ ## Estrutura
149
+
150
+ - \`projects/\` — projetos gerados pelo Forja.
151
+ - \`memory/sqlite/universal.db\` — memória universal indexada (SQLite + FTS5).
152
+ - \`memory/30-projects/\` — fichas dos projetos.
153
+ - \`specs/\` — specs de produto.
154
+ - \`.context/\` — runbooks GSD de produto.
155
+
156
+ ## Configuração
157
+
158
+ O caminho do workspace é resolvido por prioridade:
159
+
160
+ 1. Variável \`FORJA_WORKSPACE\`
161
+ 2. Campo \`workspaceRoot\` em \`~/.forjarc.json\`
162
+ 3. Padrão: \`~/forja-workspace\`
163
+
164
+ ## Comandos úteis
165
+
166
+ - \`npm run dev -- workspace:init\` — recria estrutura base.
167
+ - \`npm run dev -- project:new <nome>\` — cria novo projeto.
168
+ - \`npm run dev -- project:list\` — lista projetos.
169
+ - \`npm run dev -- project:check <nome>\` — valida padrões.
170
+ `,
171
+ 'utf8'
172
+ );
173
+ }
174
+
175
+ // Cria .forjarc.json local apenas se não houver config global
176
+ const localConfigPath = path.join(root, '.forjarc.json');
177
+ if (!fs.existsSync(localConfigPath) && !fs.existsSync(getUserConfigPath()) && !process.env.FORJA_WORKSPACE) {
178
+ fs.writeFileSync(
179
+ localConfigPath,
180
+ JSON.stringify({ workspaceRoot: root }, null, 2) + '\n',
181
+ 'utf8'
182
+ );
183
+ }
184
+
185
+ // Cria README em 30-projects
186
+ const projectsMemoryReadme = path.join(getWorkspaceProjectsMemoryDir(), 'README.md');
187
+ if (!fs.existsSync(projectsMemoryReadme)) {
188
+ fs.writeFileSync(
189
+ projectsMemoryReadme,
190
+ `# Projetos do Workspace
191
+
192
+ Fichas de projetos gerados pelo Forja. Cada arquivo representa um produto ativo ou arquivado.
193
+ `,
194
+ 'utf8'
195
+ );
196
+ }
197
+
198
+ return root;
199
+ }
200
+
201
+ export function isInsideFrameworkRepo(filePath) {
202
+ const frameworkRoot = path.resolve(__dirname, '..');
203
+ const resolved = path.resolve(filePath);
204
+ return resolved === frameworkRoot || resolved.startsWith(frameworkRoot + path.sep);
205
+ }
206
+
207
+ export function assertOutsideFrameworkRepo(filePath, operation = 'operacao') {
208
+ if (isInsideFrameworkRepo(filePath)) {
209
+ throw new Error(
210
+ `${operation} não pode ser executada dentro do repositório do framework Forja. Use o workspace externo (~/forja-workspace).`
211
+ );
212
+ }
213
+ }
@@ -0,0 +1,15 @@
1
+ # Missão Universal: Projeto Agentes
2
+
3
+ ## Propósito
4
+ Criar um ecossistema de agentes orquestrados, independentes de LLM, com memória persistente e universal para acelerar o desenvolvimento de produtos escaláveis.
5
+
6
+ ## Objetivos
7
+ 1. **Independência de LLM**: Funcionar com Gemini, Claude, OpenAI, etc.
8
+ 2. **Memória Universal**: Banco de dados SQLite central que indexa documentação de todos os projetos.
9
+ 3. **Escalabilidade**: Camadas de metodologia para crescimento do produto (Growth, Scaling).
10
+ 4. **Isolamento**: Projetos gerados são isolados e não poluem o repositório principal.
11
+
12
+ ## Pilares
13
+ - **Memória Hierárquica**: Global -> Projeto -> Domínio -> Tarefa.
14
+ - **Orquestração**: Divisão clara de papéis e responsabilidades.
15
+ - **Continuidade**: Handoffs que preservam o contexto entre sessões e agentes.
@@ -0,0 +1,8 @@
1
+ # Base de Conhecimento Compartilhada (Patterns)
2
+
3
+ > Preenchida via Cross-Project Analysis (`npm run memory:extract`): padrões que se
4
+ > repetem em 2+ projetos do workspace são promovidos para cá, **sem dados de
5
+ > produto** — apenas o padrão generalizado.
6
+
7
+ Nenhum padrão promovido ainda nesta instalação. Conhecimento específico de cada
8
+ produto vive na ficha do projeto em `<workspace>/memory/30-projects/`.