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,47 @@
1
+ # Padrões Globais de Engenharia e Crescimento
2
+
3
+ ## Camada de Metodologia Ágil (Agile)
4
+ - **Sprints**: Ciclos de 1 a 2 semanas focados em entregas de valor.
5
+ - **Backlog**: Única fonte de verdade para futuras implementações.
6
+ - **Current Sprint**: Itens em execução imediata. Cada item deve ter um `owner_agent`.
7
+ - **Handoffs**: Obrigatórios após cada subtarefa para manter a continuidade.
8
+
9
+ ## Camada de Crescimento (Growth - AARRR)
10
+ Todo projeto deve mapear e otimizar o funil:
11
+ 1. **Aquisição**: Como o usuário chega (SEO, Ads, APIs).
12
+ 2. **Ativação**: Primeira experiência de valor (Onboarding).
13
+ 3. **Retenção**: Uso contínuo (Engajamento, Notificações).
14
+ 4. **Receita**: Monetização (Abacate Pay, Assinaturas).
15
+ 5. **Recomendação**: Viralidade e indicações.
16
+
17
+ ## Camada de Escalonamento (Scaling - 12-Factor)
18
+ Padrões para aplicações modernas e resilientes:
19
+ - **Codebase**: Um repositório, múltiplos deploys.
20
+ - **Dependencies**: Declaradas e isoladas explicitamente.
21
+ - **Config**: Armazenada no ambiente (Environment variables).
22
+ - **Backing Services**: Tratados como recursos anexados.
23
+ - **Stateless**: Processos devem ser sem estado e compartilhar nada.
24
+
25
+ ## Camada de Produto (Product Discovery)
26
+ Protocolo mandatório para o **Agente de Produto**:
27
+ - **Definição de Problema**: Antes de qualquer feature, o problema deve ser explicitado.
28
+ - **Métricas de Sucesso**: Como mediremos se a feature foi bem-sucedida?
29
+ - **Documentação**: Atualização obrigatória de `memory/10-product/business-rules.md`.
30
+
31
+ ## Camada de Marketing e Growth (AARRR Metrics)
32
+ Protocolo para o **Agente de Marketing**:
33
+ - **SEO & Copy**: Todo projeto deve ter uma estratégia de conteúdo técnico.
34
+ - **Loops de Viralidade**: Identificar mecanismos de indicação e compartilhamento (Recomendação).
35
+ - **Ativação**: O "Aha! Moment" do usuário deve ser o foco do primeiro deploy.
36
+
37
+ ## Camada de Governança e Compliance
38
+ Protocolo para o **Agente de Governança**:
39
+ - **Auditoria de Decisão**: Nenhuma mudança arquitetural sem `ADR`.
40
+ - **Privacidade by Design**: Verificação de vazamento de PII em logs e tabelas.
41
+ - **Qualidade de Handoff**: O score de maturidade (`project:check`) deve ser mantido acima de 80%.
42
+
43
+ ## Qualidade de Código (Clean Code)
44
+ ...
45
+ - **SOLID**: Princípios fundamentais em toda implementação.
46
+ - **Surgical Changes**: Evitar refatorações globais em tarefas de feature.
47
+ - **Test-First**: Priorizar a criação de testes antes da implementação final.
@@ -0,0 +1,21 @@
1
+ # Personas — Forja
2
+
3
+ ## 1. Dev solo multi-produto (persona primária)
4
+
5
+ - **Contexto**: opera 2–10 produtos simultaneamente usando IA como principal força de trabalho; não tem PM, arquiteto nem QA dedicados.
6
+ - **Dores**: cada sessão de IA recomeça do zero; decisões evaporam; contexto de um produto vaza no outro; disciplina de processo depende só da própria memória.
7
+ - **Ganhos esperados**: retomar qualquer produto em minutos (memória + smart-context), decisões rastreadas (ADRs), pipeline que impede código sem spec, trilha de auditoria do que rodou (core, ADR-0020).
8
+
9
+ ## 2. Time pequeno com IA intensiva (persona secundária)
10
+
11
+ - **Contexto**: 2–5 pessoas compartilhando agentes e convenções; múltiplas IAs no mesmo repo (Claude, Copilot, Gemini, Codex).
12
+ - **Dores**: cada pessoa opera a IA de um jeito; handoffs informais; retrabalho por falta de fonte única de decisão.
13
+ - **Ganhos esperados**: papéis e handoffs padronizados (7 campos), memória universal compartilhada, gates de governança iguais para todos.
14
+
15
+ ## 3. Operador de agentes ("agent wrangler")
16
+
17
+ - **Contexto**: desenha e roda times de agentes por projeto (harness); trata a IA como equipe, não como autocomplete.
18
+ - **Dores**: sem topologia clara, agentes pisam um no outro; sem gates, entregam código não verificável.
19
+ - **Ganhos esperados**: topologia de 6 papéis pronta, codegraph como gate de impacto, runbooks GSD verificáveis por comando.
20
+
21
+ > Personas de produtos gerados vivem na ficha de cada projeto no workspace, não aqui.
@@ -0,0 +1,27 @@
1
+ # Visão de Produto — Forja
2
+
3
+ > A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.
4
+
5
+ ## O problema (o inimigo)
6
+
7
+ Agentes de IA são amnésicos e indisciplinados. Cada sessão recomeça do zero, decisões de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao mesmo tempo paga esse imposto multiplicado por N. Um assistente brilhante sem processo produz velocidade sem direção.
8
+
9
+ ## A aposta
10
+
11
+ O diferencial durável não é o modelo (commodity que melhora sozinho), é o que fica em volta dele:
12
+
13
+ 1. **Memória que sobrevive** — contexto hierárquico, buscável (SQLite FTS5), compartilhado entre sessões e entre IAs (ADR-0001/0002/0003).
14
+ 2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs auditáveis de 7 campos (ADR-0005); comandos passam por um core único com gates e trilha de auditoria (ADR-0020).
15
+ 3. **Fábrica, não projeto único** — workspace multi-produto com canto fixo (ADR-0019), times de agentes desenhados por projeto (harness), code intelligence como gate (ADR-0017).
16
+
17
+ ## Posicionamento
18
+
19
+ - **Claude Code sozinho** é um engenheiro brilhante e amnésico; a Forja é o estúdio em volta dele.
20
+ - **Frameworks de agentes** (LangGraph etc.) são infraestrutura para *construir* agentes; a Forja é a camada de cima — o sistema operacional do estúdio de software de uma pessoa só.
21
+ - **Multi-IA por design** (Claude, Copilot, Gemini, Codex): nenhum vendor entrega isso, e a memória/processo não fica refém de um fornecedor.
22
+
23
+ A stack gerada (NestJS hoje) é **um boilerplate entre vários** — a identidade da Forja é o processo + a memória, não o framework de backend.
24
+
25
+ ## Métrica-norte
26
+
27
+ Tempo entre "ideia" e "primeira feature governada em produção" num workspace com N projetos ativos, sem perda de contexto entre sessões e sem decisão estrutural fora de ADR.
@@ -0,0 +1,15 @@
1
+ # memory/30-projects — fichas de projetos (privadas)
2
+
3
+ Este diretório registra os projetos rastreados pela Memória Universal. Cada projeto
4
+ gera uma ficha `<nome>.md` (criada por `init-project.js` ou pela sincronização de
5
+ memória).
6
+
7
+ ## Privacidade
8
+
9
+ As fichas de projeto carregam dados de produto/cliente e por isso **não são
10
+ versionadas** — `.gitignore` ignora `memory/30-projects/*` exceto este README.
11
+ A mesma convenção vale para `specs/<produto>/` e `.context/` (ver `.gitignore`).
12
+
13
+ As fichas continuam existindo em disco e funcionando localmente; apenas não entram
14
+ no repositório público do framework. Para regenerar a ficha de um projeto, rode o
15
+ fluxo de init/sync de memória correspondente.
@@ -0,0 +1,15 @@
1
+ # Backlog
2
+
3
+ Priorizacao via RICE (Reach x Impact x Confidence / Effort).
4
+
5
+ Assumptions: 1 usuario, ~5 empresas, ~60 ativos, 2 NAS.
6
+
7
+ | Prioridade | Item | Reach | Impact | Confidence | Effort | RICE | Dependencias | Notas |
8
+ |---|---:|---:|---:|---:|---:|---:|---|---|
9
+ | P0 | Inventario multiempresa + CRUD de ativos | 60 | 3.0 | 0.8 | 6 | 24.0 | - | Base do sistema |
10
+ | P0 | Monitoramento de disponibilidade + status | 60 | 3.0 | 0.7 | 8 | 15.8 | Inventario | Checks ICMP/TCP |
11
+ | P1 | Alertas (regras + notificacao) | 60 | 2.0 | 0.7 | 6 | 14.0 | Monitoramento | SLA alerta <= 2 min |
12
+ | P1 | Storage/NAS (capacidade/uso) | 10 | 2.0 | 0.6 | 4 | 3.0 | Inventario | Medir volumes |
13
+ | P2 | Relatorios mensais + export CSV | 5 | 1.5 | 0.6 | 4 | 1.1 | Monitoramento | Foco em uptime |
14
+ | P2 | Deploy Dokploy + Debian 13 | 1 | 2.5 | 0.8 | 3 | 0.7 | - | Bloqueador de validacao final |
15
+ | P3 | Observabilidade (Prometheus/Grafana) | 1 | 2.0 | 0.6 | 3 | 0.4 | Monitoramento | /metrics + dashboard |
@@ -0,0 +1,21 @@
1
+ # Sprint Atual
2
+
3
+ ## Projeto
4
+ framework-root
5
+
6
+ ## Objetivos
7
+ - Completar itens P0/P1 do backlog com handoffs GSD registrados.
8
+
9
+ ## Itens da Sprint
10
+ - [ ] P0: Inventario multiempresa + CRUD de ativos (RICE 24.0)
11
+ - [ ] P0: Monitoramento de disponibilidade + status (RICE 15.8)
12
+ - [ ] P1: Alertas (regras + notificacao) (RICE 14.0)
13
+ - [ ] P1: Storage/NAS (capacidade/uso) (RICE 3.0)
14
+
15
+ ## Ritual CLI
16
+ - Planejar: npm run gsd:plan -- <slug> "<objetivo>"
17
+ - Handoff spec: npm run gsd:handoff -- spec <slug>
18
+ - Handoff plan: npm run gsd:handoff -- plan <slug>
19
+ - Handoff implement: npm run gsd:handoff -- implement <slug>
20
+ - Validar: npm run gsd:check -- <slug>
21
+ - Governanca: npm run project:check
@@ -0,0 +1,55 @@
1
+ # GSD + Hermes Harness
2
+
3
+ GSD e a camada operacional que liga SDD, sprints e handoffs Hermes por linha de comando. `design-md` entra somente quando ha impacto visual.
4
+
5
+ ## Contratos
6
+
7
+ - `gsd:plan` cria `.context/gsd-<slug>.md` com gates verificaveis.
8
+ - `gsd:handoff` registra passagens padronizadas no SQLite via Hermes.
9
+ - `gsd:check` valida runbook, spec e indice codegraph. Brief visual e opcional em fluxo CLI-only.
10
+ - `code:check` valida indice codegraph (worktree + freshness) — gate de code intelligence (ADR-0017).
11
+ - `code:impact <simbolo>` mostra chamadores e blast radius antes de editar.
12
+ - `tools:doctor` faz o raio-x das ferramentas de processo (ADR-0018).
13
+ - `design:select` escolhe referencias locais de `design-md/`.
14
+ - `design:check` bloqueia brief incompleto antes de implementacao visual.
15
+
16
+ ## Sequencia padrao
17
+
18
+ Todo projeto deve andar em steps, sem pular briefing, estrutura, sprints e validacao:
19
+
20
+ 1. Briefing, com slug gerado
21
+ 2. Estrutura do projeto
22
+ 3. Sprints definidas
23
+ 4. Contexto inteligente montado
24
+ 5. Mapa de impacto via codegraph (`code:check` + `code:impact`) — ADR-0017
25
+ 6. Spec de produto aprovada
26
+ 7. Brief visual validado somente se houver UI
27
+ 8. Plano tecnico e ADRs definidos
28
+ 9. Desenvolvimento por Worker
29
+ 10. Validacao dos passos
30
+ 11. Gate final de Governance (inclui `code:check` e `tools:doctor`)
31
+
32
+ ```bash
33
+ npm run dev -- gsd:plan <slug> "<objetivo>"
34
+ npm run dev -- gsd:handoff spec <slug>
35
+ npm run dev -- gsd:handoff plan <slug>
36
+ npm run dev -- gsd:handoff implement <slug>
37
+ npm run dev -- gsd:handoff review <slug>
38
+ npm run dev -- gsd:check <slug>
39
+ ```
40
+
41
+ Se a entrega tiver UI:
42
+
43
+ ```bash
44
+ npm run dev -- design:select <surface> <tom>
45
+ npm run dev -- design:check <brief.md>
46
+ npm run dev -- gsd:check <slug> <brief.md>
47
+ ```
48
+
49
+ ## Uso por papel
50
+
51
+ - Orchestrator: inicia `gsd:plan` e registra `gsd:handoff spec`.
52
+ - Product: garante que `spec.md` tenha dor, escopo, AC e metrica 30d.
53
+ - SDD Architect: roda `code:impact` para fundamentar modulos afetados, transforma spec aprovada em plan/tasks e registra implementacao.
54
+ - Worker: roda `code:impact <simbolo>` antes de editar, implementa dentro do ownership e devolve review.
55
+ - Governance: roda `gsd:check`, `code:check`, `tools:doctor`, `spec:check`, testes e `project:check`.
@@ -0,0 +1,38 @@
1
+ # ADR-0001: Memória hierárquica em 9 camadas (00-90)
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-04-21
5
+ - **Tags**: memory, structure
6
+
7
+ ## Contexto
8
+ Agentes precisam de contexto durável entre sessões, mas carregar todo o histórico estoura janela de tokens. Memórias planas (single file) ficam ingovernáveis acima de ~5k linhas; pastas sem semântica viram dump.
9
+
10
+ ## Decisão
11
+ Adotar hierarquia fixa de 9 prefixos numerados em `memory/`:
12
+
13
+ | Prefixo | Conteúdo |
14
+ |---|---|
15
+ | `00-global` | Missão, padrões, política de contexto, contrato de agentes |
16
+ | `10-product` | Visão, personas, regras de negócio, NFRs |
17
+ | `20-architecture` | Frontend, backend, dados, segurança, observabilidade |
18
+ | `30-domains` | Um subdiretório por bounded-context (auth, billing, …) |
19
+ | `40-delivery` | Roadmap, sprint atual, backlog |
20
+ | `50-orchestration` | Topologia, roteamento, handoff protocol, playbook |
21
+ | `60-runs` | Log cronológico de execuções (arquivado após 30d) |
22
+ | `70-summaries` | Resumos global e por domínio (gerados por compress-memory) |
23
+ | `80-data` | Documentação do SQLite e schemas |
24
+ | `90-decisions` | ADRs |
25
+
26
+ ## Alternativas consideradas
27
+ - **Memória plana em 1 arquivo** — rejeitada: ingovernável acima de 5k linhas
28
+ - **Pastas por feature sem prefixo** — rejeitada: ordem alfabética não reflete relevância
29
+ - **Banco vetorial puro** — rejeitada: perde estrutura humana-legível e versionamento git
30
+
31
+ ## Consequências
32
+ **Positivas**: navegação previsível, prefixos ordenam por relevância de contexto, fácil arquivamento por nível.
33
+ **Negativas**: rigidez — adicionar uma camada nova exige decisão coletiva.
34
+
35
+ ## Rastreamento
36
+ - `bin/create-memory-nest-kit.js` (writeMemoryAndOps)
37
+ - `lib/generators/memory-generator.js`
38
+ - `memory/00-global/` (este repositório)
@@ -0,0 +1,25 @@
1
+ # ADR-0002: SQLite + FTS5 como camada de busca de memória
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-04-21
5
+ - **Tags**: memory, search, performance
6
+
7
+ ## Contexto
8
+ Memória cresce com o projeto. Grep linear em `memory/**/*.md` é O(n) sobre disco e ignora ranking. Indexação externa (Elastic, Meili) adiciona infra. Embeddings adicionam custo e dependência de modelo.
9
+
10
+ ## Decisão
11
+ Usar SQLite com extensão FTS5 como índice de busca local. Banco em `.memory/sqlite/universal.db`, sincronizado pelo `scripts/sync-universal-memory.js`. Consultas via `scripts/query-universal-memory.js` e `lib/context-builder.js`.
12
+
13
+ ## Alternativas consideradas
14
+ - **Grep direto** — rejeitada: sem ranking, sem stemming, lento em repos grandes
15
+ - **Embeddings (Chroma/Qdrant)** — rejeitada nesta fase: custo de embedding em cada sync e dependência de modelo externo. Mantida como evolução futura
16
+ - **Elasticsearch/Meilisearch** — rejeitada: infra externa, sem ganho para repos <10k arquivos
17
+
18
+ ## Consequências
19
+ **Positivas**: zero infra externa, FTS5 nativo, banco versionável (ou ignorável), reconstrução determinística do índice.
20
+ **Negativas**: BM25 só (sem semântica), sync manual (não há watcher), banco pode crescer — mitigado por `compress-memory`.
21
+
22
+ ## Rastreamento
23
+ - `scripts/sync-universal-memory.js`, `scripts/query-universal-memory.js`
24
+ - `lib/context-builder.js`
25
+ - `.memoryrc.json` (chave `compression`)
@@ -0,0 +1,31 @@
1
+ # ADR-0003: Smart Context com 3 modos (global/domain/task)
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-02
5
+ - **Tags**: tokens, context, performance
6
+
7
+ ## Contexto
8
+ Mandar `memory/**` inteiro para o modelo gasta tokens e dilui relevância. Por outro lado, contexto vazio força o agente a perguntar tudo. Precisamos de níveis intermediários.
9
+
10
+ ## Decisão
11
+ `lib/context-builder.js` expõe 3 modos:
12
+
13
+ - **`global`**: arquivos de `00-global`, `10-product/vision.md`, `20-architecture/overview.md`. Para onboarding de agentes novos.
14
+ - **`domain`**: tudo de `30-domains/<dominio>/` + summaries relacionados. Para trabalho focado em um bounded-context.
15
+ - **`task`**: busca FTS5 dirigida por query + top-N arquivos rankeados. Para sprints/tasks específicas.
16
+
17
+ Cada modo tem cap de bytes em `.memoryrc.json` e cache LRU.
18
+
19
+ ## Alternativas consideradas
20
+ - **1 só modo (everything-or-nothing)** — rejeitada: sem granularidade
21
+ - **Modo dinâmico baseado em prompt** — rejeitada nesta versão: latência de classificação, comportamento difícil de explicar. Pode evoluir para isso
22
+
23
+ ## Consequências
24
+ **Positivas**: redução medida de 40-60% em tokens (`scripts/token-benchmark.mjs`), comportamento determinístico.
25
+ **Negativas**: agente precisa escolher o modo — mitigado por defaults sensatos (smart-context escolhe pelo contexto da invocação).
26
+
27
+ ## Rastreamento
28
+ - `lib/context-builder.js`
29
+ - `scripts/build-smart-context.js`
30
+ - `scripts/token-benchmark.mjs`
31
+ - `.memoryrc.json` (chave `context.modes`)
@@ -0,0 +1,27 @@
1
+ # ADR-0004: Validação e segurança obrigatórias no scaffold NestJS
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-04-21
5
+ - **Tags**: security, scaffold
6
+
7
+ ## Contexto
8
+ Versão inicial do scaffold gerava controllers sem DTO, sem rate-limit, sem sanitização. Projetos derivados herdaram débito de segurança. Custo de "consertar depois" é alto.
9
+
10
+ ## Decisão
11
+ Todo controller gerado pelo kit deve:
12
+ - Usar DTOs com `class-validator` (`@IsString`, `@IsEmail`, `@MaxLength`, etc.)
13
+ - Tratar erro via `HttpException` com código específico
14
+ - Ter `*.spec.ts` gerado lado-a-lado
15
+ - Aplicar `helmet`, `rate-limit` global e payload máximo de 10MB
16
+
17
+ ## Alternativas consideradas
18
+ - **Validação opcional** — rejeitada: vira "todo mundo pula"
19
+ - **Validação só em endpoints públicos** — rejeitada: classificar "público" é ambíguo
20
+
21
+ ## Consequências
22
+ **Positivas**: baseline de segurança herdado por todos os projetos derivados.
23
+ **Negativas**: scaffold mais verboso (~30% mais arquivos no `--no-only-memory`).
24
+
25
+ ## Rastreamento
26
+ - `lib/generators/nest-generator.js`
27
+ - `docs/archive/REFINAMENTO-v1.0.md` (seção SEC-001..004)
@@ -0,0 +1,32 @@
1
+ # ADR-0005: Handoff entre agentes com 7 campos obrigatórios
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-04-26
5
+ - **Tags**: orchestration, handoff
6
+
7
+ ## Contexto
8
+ Handoffs em texto-livre entre agentes (Product → SDD Architect → Worker) perdiam contexto, geravam retrabalho e ambiguidade. Sem contrato, cada agente inventa formato.
9
+
10
+ ## Decisão
11
+ Todo handoff em `memory/50-orchestration/handoffs/` deve carregar 7 campos:
12
+
13
+ 1. **from** — agente origem
14
+ 2. **to** — agente destino
15
+ 3. **intent** — verbo curto: implement | review | plan | research
16
+ 4. **context** — referências (paths, ADRs, specs) suficientes para isolar a tarefa
17
+ 5. **acceptance** — critérios mensuráveis de "pronto"
18
+ 6. **constraints** — limites (tempo, escopo, padrões a respeitar)
19
+ 7. **return** — o que o destinatário deve devolver e onde
20
+
21
+ ## Alternativas consideradas
22
+ - **Texto-livre** — rejeitada (era o estado anterior)
23
+ - **Schema mais rico (15+ campos)** — rejeitada: fricção alta, agentes esqueciam
24
+
25
+ ## Consequências
26
+ **Positivas**: handoff verificável programaticamente, qualidade mínima garantida.
27
+ **Negativas**: precisa ferramenta (`append-handoff.mjs`) para não virar burocracia.
28
+
29
+ ## Rastreamento
30
+ - `lib/generators/memory-generator.js` (templates de `50-orchestration/`)
31
+ - `scripts/append-handoff.mjs` (no projeto gerado)
32
+ - Esta refator: migrar handoff para tabela SQLite (ADR futura)
@@ -0,0 +1,23 @@
1
+ # ADR-0006: Documentação estruturada por persona
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-02
5
+ - **Tags**: docs, onboarding
6
+
7
+ ## Contexto
8
+ Antes da refator, 30+ `.md` no root sem ordem fizeram onboarding levar horas. Cada perfil (executivo, arquiteto, dev, QA) precisava de visão diferente, mas tudo era apresentado em massa.
9
+
10
+ ## Decisão
11
+ Adotar `docs/personas/{executive,architect,developer,qa}/README.md` como ponto de entrada por papel. `DOC-MAP.md` no root indexa as personas. Documentos genéricos (`quick-reference`, `glossary`, `token-optimization`, `dev-workflow`) ficam em `docs/` raiz.
12
+
13
+ ## Alternativas consideradas
14
+ - **README único gigante** — rejeitada: ninguém lê linear
15
+ - **Wiki externa (Notion/GitBook)** — rejeitada: sai do repo, vira desincronizado
16
+
17
+ ## Consequências
18
+ **Positivas**: tempo de onboarding caiu ~83% (medido em tempo até primeiro commit produtivo).
19
+ **Negativas**: 4 entradas para manter; risco de divergência mitigado por DOC-MAP central.
20
+
21
+ ## Rastreamento
22
+ - `docs/personas/`, `docs/`, `DOC-MAP.md`
23
+ - `docs/archive/FASE2-SUMMARY.md` (relatório original)
@@ -0,0 +1,33 @@
1
+ # ADR-0007: Pipeline Spec-Driven obrigatório para features não-triviais
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-10
5
+ - **Tags**: sdd, methodology, governance
6
+
7
+ ## Contexto
8
+ AGENTS.md descrevia um "SDD Architect" mas não havia mecânica que forçasse spec antes de código. Trabalho começava direto na implementação, decisões eram tomadas no PR (tarde), e o "porquê" se perdia no tempo.
9
+
10
+ ## Decisão
11
+ Adotar pipeline em 3 fases vinculadas:
12
+
13
+ 1. **`spec.md`** — produto define problema, AC, NFRs, escopo
14
+ 2. **`plan.md`** — SDD Architect define arquitetura, contratos, alternativas; abre ADRs para decisões estruturais
15
+ 3. **`tasks.md`** — decomposição executável com owners
16
+
17
+ CLI `scripts/spec-cli.mjs` força ordem: `plan` exige `spec` em `approved+`; `tasks` exige `plan` em `approved+`. `spec:check` falha CI quando há violação.
18
+
19
+ Lista explícita de "quando NÃO precisa spec" em `specs/README.md` (bugfixes 1-line, renames, doc updates, dep bumps) — evita transformar SDD em burocracia.
20
+
21
+ ## Alternativas consideradas
22
+ - **GitHub Issues + PR template** — rejeitada: não enforça ordem, sem separação entre "o quê" e "como"
23
+ - **ADR como única forma** — rejeitada: ADR é decisão pontual, não rastreia execução
24
+ - **Spec opcional** — rejeitada: viraria letra morta como o "Spec-Driven Architect" da versão anterior
25
+
26
+ ## Consequências
27
+ **Positivas**: rastreabilidade decisão → impl, onboarding de novos agentes mais barato, AC mensuráveis evitam scope creep.
28
+ **Negativas**: fricção inicial (~10min por feature). Mitigada por templates e excluindo trabalhos triviais.
29
+
30
+ ## Rastreamento
31
+ - `specs/`, `scripts/spec-cli.mjs`
32
+ - `package.json` (scripts `spec:*`)
33
+ - SPEC-001 = pipeline-sdd-e-orquestracao (meta-spec deste trabalho)
@@ -0,0 +1,36 @@
1
+ # ADR-0008: Sub-agents executáveis + handoff em SQLite
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-10
5
+ - **Tags**: orchestration, agents, sdd
6
+ - **Supersede parcial**: comportamento de handoff em markdown da ADR-0005 (campos continuam valendo)
7
+
8
+ ## Contexto
9
+ AGENTS.md listava 6 papéis mas nenhum era executável — sub-agents existiam só como descrição. Handoffs viviam em `memory/50-orchestration/handoffs/*.md`, sem validação de campos, sem fila, sem status. Resultado: ninguém "passava o bastão" — papéis colidiam ou ficavam ociosos.
10
+
11
+ ## Decisão
12
+ 1. **6 sub-agents Claude Code** em `.claude/agents/*.md` — orchestrator, context-engineer, sdd-architect, product, marketing, governance. Cada um com frontmatter `name`/`description`/`tools` e system prompt focado.
13
+ 2. **Handoffs persistem em SQLite** (`universal.db.handoffs`), não em markdown. Campos da ADR-0005 (7) são validados em `scripts/agent-router.mjs append`.
14
+ 3. **Roteamento explícito**: agent-router CLI grava, lista, marca status (open → in_progress → done). Sem broadcast, sem polling.
15
+ 4. Markdown handoffs antigos em `memory/50-orchestration/handoffs/` ficam como histórico — não migrados.
16
+
17
+ ## Alternativas consideradas
18
+ - **Manter handoff em markdown** — rejeitada: difícil de validar/consultar, status invisível
19
+ - **Fila externa (Redis/SQS)** — rejeitada: infra extra para repo de framework
20
+ - **Um único super-agent monolítico** — rejeitada: perde especialização e força do system-prompt focado
21
+
22
+ ## Consequências
23
+ **Positivas**:
24
+ - Sub-agents Claude Code podem ser invocados via subagent_type explícito ou descobertos pela descrição
25
+ - Handoff é queryável (SQL): "todos os abertos para o sdd-architect"
26
+ - Validação de schema bloqueia handoff incompleto na origem
27
+
28
+ **Negativas**:
29
+ - Adiciona dependência soft de `better-sqlite3` para roteamento (já era devDependency)
30
+ - Outras IAs (Copilot/Gemini/Codex) não consomem os `.claude/agents/` — precisam adapter futuro
31
+
32
+ ## Rastreamento
33
+ - `.claude/agents/`
34
+ - `scripts/agent-router.mjs`
35
+ - `AGENTS.md` (atualizado para apontar para sub-agents)
36
+ - SPEC-001 AC-4..AC-6
@@ -0,0 +1,43 @@
1
+ # ADR-0009: Hooks Claude Code para contexto e economia de tokens
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-10
5
+ - **Tags**: tokens, hooks, claude-code
6
+
7
+ ## Contexto
8
+ A Fase 3 entregou smart-context API (ADR-0003) mas o agente precisava invocá-la manualmente. Resultado: economia teórica de 40-60% só se materializa quando alguém lembra de chamar. Pre-commit também era leve — não validava SDD nem standards.
9
+
10
+ ## Decisão
11
+ Três pontos de hook em `.claude/settings.json`:
12
+
13
+ 1. **`SessionStart`** → `scripts/hook-session-start.mjs`
14
+ Imprime status do framework (specs ativas, handoffs abertos) como `additionalContext`. Roda 1×/sessão. Sem custo recorrente.
15
+
16
+ 2. **`UserPromptSubmit`** → `scripts/hook-user-prompt.mjs`
17
+ Opt-in via env `FRAMEWORK_HOOK_INJECT=1`. Só injeta quando prompt casa com keywords (`implement`, `refactor`, `criar feature`, `spec:`, …). Cache TTL 30min por hash do prompt. Cap configurável em `.memoryrc.json::hooks.userPromptCap` (default 4KB).
18
+
19
+ 3. **Pre-commit ampliado** (`scripts/pre-commit.sh`)
20
+ Adicionados passos 6 (`spec:check`) e 7 (`check-standards`). Bloqueia commit se SDD inconsistente.
21
+
22
+ ## Alternativas consideradas
23
+ - **Sempre injetar contexto** — rejeitada: gasta tokens em prompts triviais, atrasa primeiros tokens
24
+ - **Injetar via slash command manual** — rejeitada: vira esquecível; já tem `npm run context:smart`
25
+ - **Hook em `PreToolUse`** — rejeitada nesta versão: ruído alto, ganho duvidoso para o caso de uso (framework, não app de produção)
26
+
27
+ ## Consequências
28
+ **Positivas**:
29
+ - Status do framework sempre visível ao iniciar sessão
30
+ - Injeção opt-in com safeguards (keyword, cache, cap)
31
+ - Pre-commit catch dívida de SDD antes do PR
32
+
33
+ **Negativas / Trade-offs**:
34
+ - `UserPromptSubmit` adiciona ≤200ms (cache) ou ≤1s (cold) ao primeiro token. Mitigado por trigger restrito.
35
+ - Comportamento muda quando `FRAMEWORK_HOOK_INJECT=1` — documentar em onboarding.
36
+ - Hooks só rodam no Claude Code; outras IAs (Copilot/Gemini) seguem fluxo manual.
37
+
38
+ ## Rastreamento
39
+ - `.claude/settings.json`
40
+ - `scripts/hook-session-start.mjs`, `scripts/hook-user-prompt.mjs`
41
+ - `scripts/pre-commit.sh` (passos 6-7)
42
+ - `.memoryrc.json` (chave `hooks`)
43
+ - SPEC-001 AC-7
@@ -0,0 +1,30 @@
1
+ # ADR-0010: Banco principal em Postgres
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-22
5
+ - **Autor(es)**: apk
6
+ - **Tags**: data, architecture
7
+
8
+ ## Contexto
9
+ O projeto precisa armazenar inventario, checks, alertas e historico de disponibilidade com retencao de 12 meses, alem de suportar consultas por empresa e relatarios mensais. A operacao e self-hosted em Debian 13 com Dokploy.
10
+
11
+ ## Decisao
12
+ Usar **Postgres** como banco de dados principal para inventario, checks, alertas e storage.
13
+
14
+ ## Alternativas consideradas
15
+ - **SQLite**: rejeitada por concorrencia limitada e maior risco de bloqueio com historico de checks.
16
+ - **Banco timeseries dedicado**: rejeitado por aumentar complexidade operacional na v1.
17
+
18
+ ## Consequencias
19
+ **Positivas**:
20
+ - Melhor concorrencia e indices para consultas por empresa e periodo.
21
+ - Evolucao de schema mais segura para crescimento futuro.
22
+
23
+ **Negativas / Trade-offs**:
24
+ - Exige container/servico Postgres e backup separado.
25
+ - Maior custo operacional que SQLite.
26
+
27
+ ## Rastreamento
28
+ - Implementacao: `backend/src/modules/*`, `backend/prisma/*`
29
+ - Issues/PRs: n/a
30
+ - ADRs relacionadas: n/a
@@ -0,0 +1,19 @@
1
+ # ADR-0011…0015: realocadas para o workspace (dados de produto)
2
+
3
+ - **Status**: superseded (realocação, não reversão)
4
+ - **Data**: 2026-07-06
5
+ - **Autor(es)**: apk
6
+ - **Tags**: governance, workspace, privacy
7
+
8
+ ## Contexto
9
+ As ADRs 0011–0015 eram decisões de **produto** (monitoramento multiprotocolo, idempotência de recorrência, scheduler, importação CSV, notificações on-demand) tomadas durante o desenvolvimento de um produto gerado — não decisões do framework. Com a separação framework × workspace (ADR-0019) e a preparação do repo para visibilidade pública, dados de produto não podem viver no decision log do framework.
10
+
11
+ ## Decisão
12
+ Mover as ADRs 0011–0015 para a ficha do produto de origem no workspace (`<workspace>/memory/30-projects/`), mantendo este tombstone para explicar o gap de numeração. A numeração do framework segue de 0016 em diante.
13
+
14
+ ## Consequências
15
+ **Positivas**: decision log do framework contém apenas decisões do framework; repo publicável.
16
+ **Negativas / Trade-offs**: gap 0011–0015 na numeração (documentado aqui).
17
+
18
+ ## Rastreamento
19
+ - ADRs relacionadas: ADR-0019 (workspace separado), ADR-0020 (core)
@@ -0,0 +1,64 @@
1
+ # ADR-0016: Integração de capacidades externas (codegraph, harness, ai-engineering)
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-06-15
5
+ - **Autor(es)**: Allan Pablo
6
+ - **Tags**: orchestration, tooling, knowledge-base, mcp, plugins
7
+
8
+ ## Contexto
9
+ Durante a refatoração do framework `2-projeto-agents`, três produtos externos
10
+ (open-source, baixados em `projects/`, que está 100% no `.gitignore`) foram
11
+ escolhidos para serem alocados como capacidades de primeira classe do framework,
12
+ cobrindo três eixos da refatoração:
13
+
14
+ - **Orquestração de agentes** → `harness-main` (plugin do Claude Code, Apache-2.0):
15
+ fábrica de arquitetura de times de agentes a partir de 6 padrões.
16
+ - **Análise de código** → `codegraph-linux-x64` (CLI binária, MIT): grafo de código
17
+ semântico com servidor MCP (`codegraph_explore`, `codegraph_node`).
18
+ - **Base de conhecimento** → `ai-engineering-from-scratch-main` (currículo, MIT):
19
+ 503 lições / 20 fases de AI engineering como material de referência.
20
+
21
+ Restrição: `projects/` é off-limits para edição e não é versionado, logo a
22
+ integração não pode depender de editar nada lá dentro, nem assumir que o conteúdo
23
+ permanece commitado no repo do framework.
24
+
25
+ ## Decisão
26
+ Integrar cada produto pelo seu mecanismo nativo, com os artefatos de fiação na raiz
27
+ do framework (versionados), e nunca dentro de `projects/`:
28
+
29
+ 1. **codegraph** — binário linkado em `~/.local/bin/codegraph` (desacopla do path
30
+ em `projects/`) e registrado como servidor MCP em **escopo project** (`.mcp.json`
31
+ na raiz do repo, comando `codegraph serve --mcp`). Scripts `npm run code:index|sync|status|query`.
32
+ 2. **harness** — marketplace local registrado (`claude plugin marketplace add`) e
33
+ plugin `harness@harness-marketplace` instalado/habilitado (escopo user).
34
+ 3. **ai-engineering** — registrado como base de conhecimento/referência em
35
+ `DOC-MAP.md` e `docs/capacidades-externas.md`; não há código a instalar.
36
+
37
+ ## Alternativas consideradas
38
+ - **Mover o código para dentro do repo (vendoring)**: rejeitada — são repos externos
39
+ com licenças próprias e tamanho elevado (codegraph traz binário node de ~123MB);
40
+ o usuário pediu "integrar como capacidade", não "mover".
41
+ - **MCP do codegraph em escopo user/global**: rejeitada — a intenção é atar a
42
+ capacidade a *este* repo; escopo project (`.mcp.json`) viaja com o framework.
43
+ - **Carregar harness só por `--plugin-dir` (sessão)**: rejeitada — não persiste;
44
+ marketplace + install dá capacidade permanente.
45
+
46
+ ## Consequências
47
+ **Positivas**:
48
+ - Capacidades nativas: harness disponível como plugin, codegraph como ferramentas MCP
49
+ dentro de qualquer sessão Claude Code no repo, ai-engineering como referência catalogada.
50
+ - `.mcp.json` versionado: quem clonar o repo herda o MCP do codegraph.
51
+ - Baixo acoplamento ao conteúdo gitignored de `projects/` para o codegraph (via PATH).
52
+
53
+ **Negativas / Trade-offs**:
54
+ - O symlink do codegraph e o marketplace do harness ainda apontam para
55
+ `projects/codegraph-linux-x64` e `projects/harness-main` no disco local; se essas
56
+ pastas forem removidas, as capacidades quebram (precisam ser reinstaladas).
57
+ - harness fica em escopo **user** (máquina do usuário), não project — não viaja com o repo.
58
+
59
+ ## Rastreamento
60
+ - Implementação: `.mcp.json`, `package.json` (scripts `code:*`), `~/.local/bin/codegraph`,
61
+ marketplace `harness-marketplace`, `docs/capacidades-externas.md`, `DOC-MAP.md`
62
+ - Fontes: github.com/colbymchenry/codegraph, github.com/revfactory/harness,
63
+ github.com/rohitg00/ai-engineering-from-scratch
64
+ - ADRs relacionadas: ADR-0008 (sub-agents), ADR-0009 (hooks/token economy)