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,293 @@
1
+ # 🎯 README Refinamento - Comece Aqui
2
+
3
+ Este repositório foi **refinado para qualidade profissional** com foco em agentes orquestrados.
4
+
5
+ ---
6
+
7
+ ## 🚀 Começar em 5 Minutos
8
+
9
+ ### 1️⃣ Entender o Projeto
10
+ ```bash
11
+ # Leia primeiro
12
+ cat SUMARIO-EXECUTIVO.md
13
+ ```
14
+
15
+ ### 2️⃣ Ver a Especificação
16
+ ```bash
17
+ # Especificação completa (8 áreas, 38 items)
18
+ cat REFINAMENTO-v1.0.md | head -100
19
+ ```
20
+
21
+ ### 3️⃣ Ver o Dashboard
22
+ ```bash
23
+ # Status de implementação
24
+ cat DASHBOARD-PROGRESSO.md
25
+ ```
26
+
27
+ ### 4️⃣ Começar Implementação
28
+ ```bash
29
+ # Guia prático com código pronto
30
+ cat IMPLEMENTACAO-FASE1.md | head -100
31
+ ```
32
+
33
+ ### 5️⃣ Ver Exemplos
34
+ ```bash
35
+ # Código pronto para copiar/colar
36
+ cat EXEMPLOS-CODIGO.md | head -100
37
+ ```
38
+
39
+ ---
40
+
41
+ ## 📚 Documentação de Refinamento
42
+
43
+ | Arquivo | Tamanho | Conteúdo |
44
+ |---------|---------|----------|
45
+ | **INDICE-MASTER.md** | 7 KB | 👈 COMECE AQUI - mapa completo |
46
+ | **SUMARIO-EXECUTIVO.md** | 7 KB | Overview, números, decisões |
47
+ | **REFINAMENTO-v1.0.md** | 16 KB | Spec completa de 8 áreas |
48
+ | **IMPLEMENTACAO-FASE1.md** | 10 KB | Guia prático + código |
49
+ | **DASHBOARD-PROGRESSO.md** | 5 KB | Rastreamento visual |
50
+ | **EXEMPLOS-CODIGO.md** | 15 KB | Snippets prontos |
51
+ | **README-REFINAMENTO.md** | Este arquivo | Quick start |
52
+
53
+ ---
54
+
55
+ ## 🎯 8 Áreas de Melhoria
56
+
57
+ ### Tier 1 (CRÍTICO)
58
+ 1. ✅ **Qualidade & Segurança** - Validação, rate-limit, sanitização, testes
59
+ 2. ✅ **Design de Agentes** - Especificação, prompts, handoff, roteamento
60
+ 3. ✅ **Otimização para IAs** - Context packing, Instruction Bundle, model config
61
+ 4. ✅ **ADR & Decisões** - Estrutura, versionamento, BD, integração
62
+ 5. ✅ **Gestão de Memória** - 3 níveis compactação, recovery, análise
63
+
64
+ ### Tier 2 (IMPORTANTE)
65
+ 6. 🟡 **Documentação** - Stripe-like structure, padrão escrita, diagrama
66
+ 7. 🟡 **Metodologia Ágil** - Sprint, DoD, ceremônias, métricas
67
+ 8. 🟡 **Observabilidade** - Logs, decorator, métricas, tracing, dashboard
68
+
69
+ ---
70
+
71
+ ## 📊 Status Atual
72
+
73
+ ```
74
+ Itens: 38 / 38 mapeados ✅
75
+ Áreas: 8 / 8 estruturadas ✅
76
+ Decisões: 5+ arquiteturais registradas ✅
77
+ Documentação: 7 arquivos, ~42 KB ✅
78
+ BD Rastreamento: Pronto para usar ✅
79
+ Código Exemplo: 15+ snippets ✅
80
+
81
+ Status: 🟢 PRONTO PARA IMPLEMENTAÇÃO
82
+ ```
83
+
84
+ ---
85
+
86
+ ## 🔥 Quick Wins (Começar HOJE)
87
+
88
+ Se tem 2-3 horas, implemente:
89
+
90
+ ```bash
91
+ # 1. SEC-001: Validação em DTOs (30 min)
92
+ # Ver código em EXEMPLOS-CODIGO.md
93
+ # Guia em IMPLEMENTACAO-FASE1.md
94
+
95
+ # 2. SEC-002: Rate-limiting (30 min)
96
+ # Ver código em EXEMPLOS-CODIGO.md
97
+ # Guia em IMPLEMENTACAO-FASE1.md
98
+
99
+ # 3. OBS-001: Logs estruturados (30 min)
100
+ # Ver código em EXEMPLOS-CODIGO.md
101
+ # Guia em IMPLEMENTACAO-FASE1.md
102
+
103
+ # 4. Testar tudo (30 min)
104
+ cd /tmp/test-project
105
+ npm install && npm run build && npm test
106
+ ```
107
+
108
+ **Resultado**: 3 items feitos = 8% de progresso em um dia!
109
+
110
+ ---
111
+
112
+ ## 💾 Banco de Dados de Rastreamento
113
+
114
+ Já populado com 38 items + 5 decisões.
115
+
116
+ ### Ver Progresso
117
+ ```sql
118
+ SELECT area_id,
119
+ COUNT(*) as total,
120
+ SUM(CASE WHEN status='done' THEN 1 ELSE 0 END) as done,
121
+ ROUND(100.0 * SUM(CASE WHEN status='done' THEN 1 ELSE 0 END) / COUNT(*)) as pct
122
+ FROM improvement_items
123
+ GROUP BY area_id
124
+ ORDER BY area_id;
125
+ ```
126
+
127
+ ### Atualizar Status
128
+ ```sql
129
+ UPDATE improvement_items
130
+ SET status='in_progress'
131
+ WHERE id='SEC-001';
132
+
133
+ UPDATE improvement_items
134
+ SET status='done'
135
+ WHERE id='SEC-001';
136
+ ```
137
+
138
+ ---
139
+
140
+ ## 🛠️ Tech Stack Recomendado
141
+
142
+ | Layer | Tech | Por quê |
143
+ |-------|------|--------|
144
+ | **Validação** | class-validator | Padrão NestJS, suporta nestação |
145
+ | **Rate-limit** | In-memory Map | Simples, sem dependências |
146
+ | **Logs** | JSON stdout | Parseável, pronto para observabilidade |
147
+ | **Testes** | Jest + Supertest | Padrão NestJS, e2e + unit |
148
+ | **Documentação** | Markdown | Versionável, simples |
149
+ | **BD Memória** | SQLite + better-sqlite3 | Índice de contexto |
150
+ | **Segurança** | Helmet | Headers seguros OWASP |
151
+
152
+ ---
153
+
154
+ ## 📈 Timeline Estimada
155
+
156
+ ```
157
+ Semana 1 (10 items) ─────────────────────→ 26% completo
158
+ SEC-001, SEC-002, AGENT-001, AGENT-002, AI-OPT-001,
159
+ ADR-001, MEM-001, DOC-001, AGILE-001, OBS-001
160
+
161
+ Semana 2 (28 items) ─────────────────────→ 100% Tier 1
162
+ SEC-003, SEC-004, AGENT-003-005, AI-OPT-002-005,
163
+ ADR-002-004, MEM-002-005, DOC-002-005, AGILE-002-005, OBS-002-005
164
+
165
+ Semana 3-4: Tier 2
166
+ Semana 5-6: Integração + Release v0.3.0
167
+ ```
168
+
169
+ ---
170
+
171
+ ## 🎓 Por Onde Começar?
172
+
173
+ ### 👔 Se você é Executivo/PM
174
+ 1. Ler: SUMARIO-EXECUTIVO.md (10 min)
175
+ 2. Ver: DASHBOARD-PROGRESSO.md (5 min)
176
+ 3. Decidir: Aprovar Fase 1? (yes/no)
177
+
178
+ ### 🏗️ Se você é Arquiteto/Tech Lead
179
+ 1. Ler: SUMARIO-EXECUTIVO.md (10 min)
180
+ 2. Ler: REFINAMENTO-v1.0.md completo (1h)
181
+ 3. Revisar: Decisões no BD (15 min)
182
+ 4. Planejar: Quebrar em sprints
183
+
184
+ ### 💻 Se você é Dev/Senior Dev
185
+ 1. Ler: SUMARIO-EXECUTIVO.md (5 min)
186
+ 2. Ler: IMPLEMENTACAO-FASE1.md (20 min)
187
+ 3. Ver: EXEMPLOS-CODIGO.md (15 min)
188
+ 4. Codificar: Escolher primeiro item (30 min+)
189
+ 5. Testar: Validar conforme checklist (15 min)
190
+ 6. Atualizar: BD com status=done (2 min)
191
+
192
+ ### 🧪 Se você é QA/Reviewer
193
+ 1. Ler: DASHBOARD-PROGRESSO.md (10 min)
194
+ 2. Ler: REFINAMENTO-v1.0.md seção SEC + OBS (20 min)
195
+ 3. Validar: Critérios de aceite por item
196
+ 4. Sign-off: Conforme checklist
197
+
198
+ ---
199
+
200
+ ## ⚡ Checklist de Implementação
201
+
202
+ Para cada item implementado:
203
+
204
+ - [ ] **Código**: Sem erros de syntax, builds
205
+ - [ ] **Teste**: Validação rápida funciona (ex: DTO inválido = 400)
206
+ - [ ] **Docs**: Parágrafo em REFINAMENTO-v1.0.md
207
+ - [ ] **BD**: `UPDATE improvement_items SET status='done' WHERE id='XXX'`
208
+ - [ ] **Integração**: Funciona em projeto novo gerado
209
+ - [ ] **Git**: `git commit -m "[ITEM-ID] implementação"`
210
+
211
+ ---
212
+
213
+ ## 🆘 Dúvidas Frequentes
214
+
215
+ **P: Por onde começo?**
216
+ R: Leia SUMARIO-EXECUTIVO.md (5 min), depois escolha seu papel acima.
217
+
218
+ **P: Quanto tempo leva?**
219
+ R: Fase 1: 1-2 semanas (dep de experiência). Tire 2-3h por dia mínimo.
220
+
221
+ **P: Pode fazer em paralelo?**
222
+ R: Sim! Items de áreas diferentes são independentes. Comece 5-6 em paralelo.
223
+
224
+ **P: O que se quebrar?**
225
+ R: Veja dependencies em DASHBOARD-PROGRESSO.md. Algumas items dependem de outras.
226
+
227
+ **P: Como rastrear?**
228
+ R: Use queries SQL em DASHBOARD-PROGRESSO.md ou leia DASHBOARD-PROGRESSO.md direto.
229
+
230
+ **P: Preciso fazer todos?**
231
+ R: Tier 1 é crítico (fase 1). Tier 2 é importante mas pode esperar.
232
+
233
+ ---
234
+
235
+ ## 📞 Suporte Rápido
236
+
237
+ ```
238
+ "O que fazer?"
239
+ → SUMARIO-EXECUTIVO.md
240
+
241
+ "Como implementar?"
242
+ → IMPLEMENTACAO-FASE1.md
243
+
244
+ "Qual status?"
245
+ → DASHBOARD-PROGRESSO.md
246
+
247
+ "Qual especificação?"
248
+ → REFINAMENTO-v1.0.md
249
+
250
+ "Exemplos de código?"
251
+ → EXEMPLOS-CODIGO.md
252
+
253
+ "Mapa completo?"
254
+ → INDICE-MASTER.md
255
+
256
+ "Não achei..."
257
+ → INDICE-MASTER.md seção "🆘 Suporte"
258
+ ```
259
+
260
+ ---
261
+
262
+ ## 🎉 Resultado Final (Fase 1)
263
+
264
+ ```
265
+ kit v0.3.0 com:
266
+
267
+ ✅ Qualidade Enterprise-grade
268
+ ✅ Agentes Profissionais (spec + prompts)
269
+ ✅ Otimização máxima para IAs
270
+ ✅ Rastreabilidade Completa (ADRs + BD)
271
+ ✅ Documentação Stripe-like
272
+ ✅ Metodologia Ágil pronta
273
+ ✅ Observabilidade Full-Stack
274
+
275
+ → Pronto para produção, escalável, profissional
276
+ ```
277
+
278
+ ---
279
+
280
+ ## 📅 Próximo Passo
281
+
282
+ **Hoje**: Ler SUMARIO-EXECUTIVO.md + decidir começar
283
+ **Amanhã**: Ler IMPLEMENTACAO-FASE1.md + fazer primeiro item
284
+ **Semana 1**: 10 items (26% completo)
285
+ **Semana 2**: 28 items (100% Tier 1)
286
+ **Semana 3-6**: Tier 2 + release v0.3.0
287
+
288
+ ---
289
+
290
+ **Criado**: 2026-04-21
291
+ **Status**: 🟢 GO (Pronto para Implementação)
292
+ **Próximo Checkpoint**: Fim de Semana 1
293
+
@@ -0,0 +1,324 @@
1
+ # 🚀 Referência Rápida
2
+
3
+ **Suas respostas em 30 segundos**
4
+
5
+ ---
6
+
7
+ ## ❓ Perguntas Comuns
8
+
9
+ ### "Por onde começo?"
10
+ ```bash
11
+ cat README.md # 5 min - visão geral
12
+ cat START-HERE.md # 2 min - quick start
13
+ ```
14
+
15
+ ### "Como criar um novo projeto?"
16
+ ```bash
17
+ node bin/init-project.js meu-projeto
18
+ cd meu-projeto
19
+ npm run start:dev # opcional
20
+ ```
21
+
22
+ ### "Qual é a estrutura?"
23
+ ```bash
24
+ cat ESTRUTURA-PROJETO.md
25
+ ```
26
+
27
+ ### "Como usar com Copilot?"
28
+ ```bash
29
+ node bin/init-project.js meu-projeto
30
+ cat meu-projeto/.ia-instructions/copilot.md
31
+ ```
32
+
33
+ ### "Como usar com Claude?"
34
+ ```bash
35
+ node bin/init-project.js meu-projeto
36
+ cat meu-projeto/.ia-instructions/claude.md
37
+ ```
38
+
39
+ ### "Como usar com Gemini?"
40
+ ```bash
41
+ node bin/init-project.js meu-projeto
42
+ cat meu-projeto/.ia-instructions/gemini.md
43
+ ```
44
+
45
+ ### "Como usar com Codex (OpenAI)?"
46
+ ```bash
47
+ node bin/init-project.js meu-projeto
48
+ cat meu-projeto/.ia-instructions/codex.md
49
+ ```
50
+
51
+ ### "Quero ver exemplos de código"
52
+ ```bash
53
+ cat EXEMPLOS-CODIGO.md
54
+ ```
55
+
56
+ ### "Qual é a especificação completa?"
57
+ ```bash
58
+ cat REFINAMENTO-v1.0.md
59
+ ```
60
+
61
+ ### "Como publicar no npm?"
62
+ ```bash
63
+ cat PUBLICACAO.md
64
+ npm publish --access public
65
+ ```
66
+
67
+ ### "Quero implementar uma melhoria"
68
+ ```bash
69
+ cat IMPLEMENTACAO-FASE1.md
70
+ ```
71
+
72
+ ### "Como rastrear progresso?"
73
+ ```bash
74
+ cat DASHBOARD-PROGRESSO.md
75
+ ```
76
+
77
+ ---
78
+
79
+ ## 📋 Bandeiras (Flags)
80
+
81
+ ```bash
82
+ # Setup completo
83
+ node bin/init-project.js meu-projeto
84
+
85
+ # Apenas memória (sem NestJS)
86
+ node bin/init-project.js meu-projeto --skip-backend
87
+
88
+ # Sem banco de dados
89
+ node bin/init-project.js meu-projeto --skip-db
90
+
91
+ # Sem git init
92
+ node bin/init-project.js meu-projeto --skip-git
93
+
94
+ # Com output detalhado
95
+ node bin/init-project.js meu-projeto --verbose
96
+
97
+ # Escolher IAs (copilot, claude, gemini)
98
+ node bin/init-project.js meu-projeto --ai copilot,claude
99
+ ```
100
+
101
+ ---
102
+
103
+ ## 📂 Estrutura Gerada
104
+
105
+ ```
106
+ meu-projeto/
107
+ ├── memory/ ← Hierarquia de conhecimento (10 níveis)
108
+ ├── agents/ ← Especificação de agentes
109
+ ├── skills/ ← Skills operacionais
110
+ ├── prompts/ ← Templates de prompts
111
+ ├── scripts/ ← Automação (context pack, handoff)
112
+ ├── .ia-instructions/ ← Instruções para Copilot/Claude/Gemini
113
+ ├── backend/ ← NestJS API (se não --skip-backend)
114
+ ├── .memoryrc.json ← Config de memória
115
+ └── README.md ← Documentação local
116
+ ```
117
+
118
+ ---
119
+
120
+ ## 🎯 3 Minutos de Setup
121
+
122
+ ```bash
123
+ # 1. Criar projeto (30 seg)
124
+ node bin/init-project.js demo
125
+
126
+ # 2. Explorar estrutura (30 seg)
127
+ cd demo
128
+ ls -la
129
+
130
+ # 3. Ver instruções para IA (60 seg)
131
+ cat .ia-instructions/copilot.md
132
+ # Ou claude.md ou gemini.md
133
+
134
+ # 4. Começar trabalho (1 min)
135
+ cat memory/00-global/contrato-agentes.md
136
+ ```
137
+
138
+ ---
139
+
140
+ ## 📚 Documentação por Papel (5 min cada)
141
+
142
+ | Papel | Leia | Depois |
143
+ |-------|------|--------|
144
+ | **PM/Executivo** | README.md + SUMARIO-EXECUTIVO.md | DASHBOARD-PROGRESSO.md |
145
+ | **Arquiteto** | ESTRUTURA-PROJETO.md + REFINAMENTO-v1.0.md | Validate decisions |
146
+ | **Dev** | START-HERE.md + EXEMPLOS-CODIGO.md | Begin implementation |
147
+ | **QA** | DASHBOARD-PROGRESSO.md + CHECKLIST-FINAL.md | Run validations |
148
+ | **DevOps** | PUBLICACAO.md | npm publish |
149
+
150
+ ---
151
+
152
+ ## 🔧 Comandos Principais
153
+
154
+ ```bash
155
+ # Criar projeto
156
+ node bin/init-project.js meu-projeto
157
+
158
+ # Compactar contexto (dentro do projeto)
159
+ node scripts/build-context-pack.mjs
160
+
161
+ # Limpar memória antiga (Vacuum)
162
+ node scripts/memory-vacuum.mjs
163
+
164
+ # Observar mudanças e auto-sync
165
+ cd backend && npm run memory:watch
166
+
167
+ # Criar handoff (dentro do projeto)
168
+ node scripts/append-handoff.mjs
169
+
170
+ # Sincronizar BD (dentro do projeto)
171
+ node backend/scripts/memory-db-sync.mjs
172
+
173
+ # Consultar BD (dentro do projeto)
174
+ node backend/scripts/memory-db-query.mjs --table improvement_items
175
+
176
+ # Publicar no npm (do kit root)
177
+ npm publish --access public
178
+
179
+ # Testar publicação
180
+ npm pack --dry-run
181
+ ```
182
+
183
+ ---
184
+
185
+ ## 🤖 Trabalho com IAs
186
+
187
+ ### Para Copilot (VSCode)
188
+ 1. Abra pasta do projeto
189
+ 2. Copilot carrega automaticamente `.ia-instructions/copilot.md`
190
+ 3. Coloque no chat: `@codebase help <pergunta>`
191
+
192
+ ### Para Claude (claude.ai)
193
+ 1. Cole em novo chat: conteúdo de `meu-projeto/.ia-instructions/claude.md`
194
+ 2. Cole depois: seu contexto de trabalho
195
+ 3. Faça perguntas
196
+
197
+ ### Para Gemini (gemini.ai)
198
+ 1. Cole em novo chat: conteúdo de `meu-projeto/.ia-instructions/gemini.md`
199
+ 2. Depois proceda normalmente
200
+
201
+ ### Para Codex (OpenAI API)
202
+ 1. Cole em novo chat: conteúdo de `meu-projeto/.ia-instructions/codex.md`
203
+ 2. Use para geração de código
204
+ 3. Respeite model-specific token limits
205
+
206
+ ---
207
+
208
+ ## 📊 Estatísticas
209
+
210
+ | Item | Valor |
211
+ |------|-------|
212
+ | Documentação | 13 arquivos |
213
+ | Linhas de código | 400+ (scripts) |
214
+ | Melhorias especificadas | 38 |
215
+ | Áreas de qualidade | 8 |
216
+ | IAs suportadas | 4 (Copilot, Claude, Gemini, Codex) |
217
+ | Snippets prontos | 15+ |
218
+ | Tempo para setup | 1 min |
219
+ | Tempo para ler tudo | 2-3 horas |
220
+
221
+ ---
222
+
223
+ ## ✅ Checklist de Setup
224
+
225
+ - [ ] Executar `node bin/init-project.js demo`
226
+ - [ ] Explorar `meu-projeto/memory/`
227
+ - [ ] Ler `.ia-instructions/copilot.md` (ou outro)
228
+ - [ ] Testar `node scripts/build-context-pack.mjs`
229
+ - [ ] Ler `ESTRUTURA-PROJETO.md`
230
+ - [ ] Entender 38 melhorias em `REFINAMENTO-v1.0.md`
231
+ - [ ] Pronto para começar!
232
+
233
+ ---
234
+
235
+ ## 🆘 Problemas?
236
+
237
+ ### Init não funciona
238
+ ```bash
239
+ cd /home/apk/Documentos/GitHub/2-Projeto-Agents
240
+ node bin/init-project.js demo
241
+ ```
242
+
243
+ ### Instruções de IA não aparecem
244
+ ```bash
245
+ ls -la demo/.ia-instructions/
246
+ # Devem ter: copilot.md, claude.md, gemini.md
247
+ ```
248
+
249
+ ### Banda muito larga
250
+ ```bash
251
+ # Usar --skip-backend para setup rápido
252
+ node bin/init-project.js demo --skip-backend
253
+ ```
254
+
255
+ ### Não consegue publicar npm
256
+ ```bash
257
+ # Verificar login
258
+ npm whoami
259
+
260
+ # Login novamente
261
+ npm login
262
+
263
+ # Depois publicar
264
+ npm publish --access public
265
+ ```
266
+
267
+ ---
268
+
269
+ ## 📞 Links Rápidos
270
+
271
+ | Arquivo | Descrição |
272
+ |---------|-----------|
273
+ | README.md | Documentação principal |
274
+ | START-HERE.md | Quick start |
275
+ | ESTRUTURA-PROJETO.md | Visual da estrutura |
276
+ | EXEMPLOS-CODIGO.md | Snippets prontos |
277
+ | REFINAMENTO-v1.0.md | Especificação 38 items |
278
+ | PUBLICACAO.md | Guia npm publish |
279
+ | INDICE-MASTER.md | Índice de documentação |
280
+ | CLAUDE.md | Instrução Claude |
281
+ | .openai-instructions.md | Instrução Codex |
282
+
283
+ ---
284
+
285
+ ## 🎯 Fluxo Básico (5 min)
286
+
287
+ ```
288
+ 1. Criar projeto
289
+ node bin/init-project.js meu-projeto
290
+
291
+ 2. Carregar em IA (Copilot/Claude/Gemini/Codex)
292
+ cat meu-projeto/.ia-instructions/[copilot|claude|gemini|codex].md
293
+
294
+ 3. Decompor tarefa
295
+ cat memory/50-orchestration/topologia.md
296
+
297
+ 4. Executar
298
+ Agentes trabalham em paralelo
299
+
300
+ 5. Criar handoff
301
+ node scripts/append-handoff.mjs
302
+
303
+ 6. Reviewer valida
304
+ cat memory/50-orchestration/handoffs/
305
+
306
+ 7. Atualizar memória
307
+ node backend/scripts/memory-db-sync.mjs
308
+ ```
309
+
310
+ ---
311
+
312
+ ## 💡 Dicas
313
+
314
+ 1. **Sempre começar com** `README.md` e `START-HERE.md`
315
+ 2. **Ler** `ESTRUTURA-PROJETO.md` antes de usar
316
+ 3. **Testar localmente** antes de publicar
317
+ 4. **Manter** `.npmignore` atualizado
318
+ 5. **Usar** `--skip-backend` para testes rápidos
319
+
320
+ ---
321
+
322
+ **Versão**: 0.3.0
323
+ **Status**: 🟢 Production-Ready
324
+ **Última Atualização**: 2026-04-21