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,172 @@
1
+ # 👔 Guia para Executivos
2
+
3
+ Você é executor, quer know ROI, timeline, risco. Vai reto ao ponto.
4
+
5
+ ---
6
+
7
+ ## ⏱️ Leia em 10 minutos
8
+
9
+ ### O que é isso?
10
+
11
+ **create-memory-nest-kit** é uma ferramenta que gera projetos prontos com:
12
+
13
+ - **Memória estruturada** — Documentação organizada para escalar sem perder contexto
14
+ - **Agentes orquestrados** — IAs trabalham em paralelo sem conflito
15
+ - **Backend NestJS** — API moderna, escalável, production-ready
16
+ - **Dashboards operacionais** — Visualize tudo em tempo real
17
+
18
+ ### O que ganhamos?
19
+
20
+ | Aspecto | Antes | Depois |
21
+ |--------|-------|--------|
22
+ | **Contexto** | Uma IA = 1 pessoa | Múltiplas IAs = squad |
23
+ | **Qualidade** | Manual | Automática (validação + testes) |
24
+ | **Escala** | Até 100K tokens | 1M+ tokens com segmentação |
25
+ | **Setup** | ~1 semana | ~30 minutos |
26
+
27
+ ### Quanto tempo?
28
+
29
+ - **Gerar estrutura:** 2 minutos
30
+ - **Setup backend:** 10 minutos
31
+ - **Começar a desenvolver:** 15 minutos
32
+ - **Total:** ~30 minutos até primeira feature
33
+
34
+ ---
35
+
36
+ ## 📊 Números que Importam
37
+
38
+ ### Produtividade
39
+
40
+ - **Antes:** 1 developer = ~8h/dia de código
41
+ - **Depois:** 1 developer + 3 agents = ~40h/dia equivalente (paralelo)
42
+ - **ROI:** 5x velocidade, ~2 semanas para break-even
43
+
44
+ ### Qualidade
45
+
46
+ - Testes automáticos: >80% coverage
47
+ - Validação de entrada obrigatória
48
+ - Revisão automática (revisor-agent)
49
+ - Zero regressões (handoff protocol)
50
+
51
+ ### Risco
52
+
53
+ - ✅ Segurança: OWASP Top 10 mitigado
54
+ - ✅ Continuidade: Sem perda de contexto entre sprints
55
+ - ✅ Revert: Rollback automático via ADRs
56
+
57
+ ---
58
+
59
+ ## 🚀 Primeiros Passos
60
+
61
+ ### 1. Gerar um projeto (2 min)
62
+
63
+ ```bash
64
+ npm run workspace:init
65
+ npm run project:new meu-produto
66
+ cd ~/forja-workspace/projects/meu-produto
67
+ ```
68
+
69
+ ### 2. Ver estrutura (1 min)
70
+
71
+ ```bash
72
+ ls -la memory/
73
+ cat AGENTS.md
74
+ ```
75
+
76
+ ### 3. Entender timeline (5 min)
77
+
78
+ Leia `memory/00-global/mission.md` + `memory/40-delivery/roadmap.md`
79
+
80
+ ---
81
+
82
+ ## 📈 KPIs para Acompanhar
83
+
84
+ ### Velocidade
85
+
86
+ - **Sprint 0:** Setup completo (15 min)
87
+ - **Sprint 1:** Primeira feature (3 dias com agents)
88
+ - **Sprint N:** Velocity estabiliza em 2-3x baseline
89
+
90
+ ### Qualidade
91
+
92
+ - **Coverage:** Target 80%+ em rotas críticas
93
+ - **Bugs:** Redução de 60% vs manual (validação obrigatória)
94
+ - **Tempo de review:** -70% (revisor-agent automático)
95
+
96
+ ### Escala
97
+
98
+ - **Linhas de código:** +3x em mesmo esforço
99
+ - **Agentes paralelos:** 3-6 simultâneos
100
+ - **Memória:** 1M+ tokens sem perda
101
+
102
+ ---
103
+
104
+ ## 💰 Investimento
105
+
106
+ ### Custo
107
+ - **Primeira semana:** ~10h (setup + onboarding)
108
+ - **Semanal:** ~5h (orchestration + reviews)
109
+ - **Ferramental:** Gratuito (open source)
110
+
111
+ ### Retorno
112
+ - **Break-even:** ~2 semanas
113
+ - **Velocity gain:** 2-5x a partir de Sprint 2
114
+ - **Bug reduction:** 60% (automação de validação)
115
+
116
+ ---
117
+
118
+ ## ⚠️ Riscos & Mitigação
119
+
120
+ | Risco | Impacto | Mitigação |
121
+ |-------|---------|-----------|
122
+ | Agentes conflitam | Alto | Handoff protocol obrigatório |
123
+ | Contexto se perde | Alto | Memory structure + resumos |
124
+ | Deploy quebrado | Médio | Testes automáticos |
125
+ | Segredos expostos | Crítico | .env fora do git |
126
+
127
+ ---
128
+
129
+ ## 📋 Decisões Necessárias
130
+
131
+ ### Decisão 1: Que persona você é?
132
+
133
+ - **Executivo** → Este guia ✅
134
+ - **Arquiteto** → [Guia de Arquiteto](../architect/README.md)
135
+ - **Developer** → [Guia de Developer](../developer/README.md)
136
+
137
+ ### Decisão 2: Começar quando?
138
+
139
+ - **Já** → Execute os "Primeiros Passos" agora
140
+ - **Próxima sprint** → Ler REFINAMENTO-v1.0 antes
141
+
142
+ ### Decisão 3: Qual escala?
143
+
144
+ - **Pequena** (1-3 agents): Este guia é suficiente
145
+ - **Grande** (6+ agents): Ler playbook de paralelização
146
+
147
+ ---
148
+
149
+ ## 📞 Próximos Passos
150
+
151
+ 1. **Aprove o setup** — "Ok, vamos de 30 min de setup"
152
+ 2. **Designe um tech lead** — Ele lê o guia de Arquiteto
153
+ 3. **Reserve 1h para kickoff** — Apresentar a estrutura ao squad
154
+ 4. **Primeira sprint** — Já com 1-2 features em paralelo
155
+
156
+ ---
157
+
158
+ ## 🎯 Checklist de Onboarding (Executivo)
159
+
160
+ - [ ] Li este guia (10 min)
161
+ - [ ] Aprovi o approach (5 min)
162
+ - [ ] Designei tech lead
163
+ - [ ] Marcamos kickoff do squad
164
+ - [ ] Pronto!
165
+
166
+ ---
167
+
168
+ **Tempo total para decisão:** 15 min
169
+ **Tempo até primeira feature:** 2-3 dias (com agents paralelos)
170
+ **ROI esperado:** 2-3x velocidade
171
+
172
+ 📞 Próximo: Designe um **Tech Lead** para ler o [Guia de Arquiteto](../architect/README.md)
@@ -0,0 +1,350 @@
1
+ # 🧪 Guia para QA / Testers
2
+
3
+ Você valida qualidade. Quer critérios, checklists, automação.
4
+
5
+ ---
6
+
7
+ ## ⏱️ Leia em 10 minutos
8
+
9
+ ### O que você precisa saber
10
+
11
+ **create-memory-nest-kit** gera projetos com:
12
+
13
+ - **Testes automáticos** — >80% coverage obrigatório
14
+ - **Validação de entrada** — Sem dados inválidos na API
15
+ - **Revisão automática** — Revisor-agent bloqueia código ruim
16
+
17
+ ### Seu papel
18
+
19
+ 1. **Validar critérios de aceite** (antes do deploy)
20
+ 2. **Testar handoffs** (qualidade entre agentes)
21
+ 3. **Verificar checklist de segurança** (OWASP Top 10)
22
+
23
+ ---
24
+
25
+ ## 🎯 Critérios de Aceite (Obrigatório)
26
+
27
+ ### Para TODA feature:
28
+
29
+ - [ ] **Código**
30
+ - ✅ Lint passa (ESLint)
31
+ - ✅ Sem TypeScript errors
32
+ - ✅ >80% coverage em rotas críticas
33
+ - ✅ Sem console.log deixado
34
+
35
+ - [ ] **Testes**
36
+ - ✅ Unit tests passam
37
+ - ✅ E2E tests cobrem happy path + error cases
38
+ - ✅ Sem testes "skip" ou "todo"
39
+
40
+ - [ ] **Segurança**
41
+ - ✅ DTO com validação (obrigatório)
42
+ - ✅ Sem secrets em logs/erro
43
+ - ✅ Sem SQL injection
44
+ - ✅ Rate limiting habilitado
45
+
46
+ - [ ] **Documentação**
47
+ - ✅ Handoff preenchido completamente
48
+ - ✅ ADR criado (se decisão)
49
+ - ✅ memory/30-domains/[dominio]/api.md atualizado
50
+
51
+ - [ ] **Performance**
52
+ - ✅ Endpoint responde <200ms
53
+ - ✅ Sem N+1 queries
54
+ - ✅ Sem memory leaks
55
+
56
+ ---
57
+
58
+ ## 📋 Checklist Pre-Commit
59
+
60
+ Execute ANTES de aprovar:
61
+
62
+ ```bash
63
+ # 1. Lint + Build
64
+ npm run lint
65
+ npm run build
66
+
67
+ # 2. Testes
68
+ npm test
69
+ npm run test:cov # Verificar coverage > 80%
70
+
71
+ # 3. E2E
72
+ npm run test:e2e
73
+
74
+ # 4. Segurança básica
75
+ grep -r "TODO\|FIXME\|HACK" src/ # Sem deixadas
76
+ grep -r "console\." src/ # Sem logs em prod
77
+ grep -r "password\|secret\|api_key" src/ --exclude="*.env*" # Secretos expostos?
78
+ ```
79
+
80
+ ---
81
+
82
+ ## 🔍 Teste Manual: 5 Passos
83
+
84
+ ### 1. Health Check
85
+
86
+ ```bash
87
+ curl http://localhost:3000/api/health
88
+ # Esperado: { "status": "ok" }
89
+ ```
90
+
91
+ ### 2. Seu Endpoint
92
+
93
+ ```bash
94
+ curl -X POST http://localhost:3000/api/seu-endpoint \
95
+ -H "Content-Type: application/json" \
96
+ -d '{"campo":"valor"}'
97
+ # Esperado: 200 OK ou erro específico
98
+ ```
99
+
100
+ ### 3. Validação (enviando lixo)
101
+
102
+ ```bash
103
+ # Teste com email inválido
104
+ curl -X POST http://localhost:3000/api/login \
105
+ -H "Content-Type: application/json" \
106
+ -d '{"email":"nao-e-email","password":"123"}'
107
+ # Esperado: 400 Bad Request (DTO rejection)
108
+ ```
109
+
110
+ ### 4. Autenticação
111
+
112
+ ```bash
113
+ # Sem token
114
+ curl http://localhost:3000/api/protegido
115
+ # Esperado: 401 Unauthorized
116
+
117
+ # Com token válido
118
+ curl -H "Authorization: Bearer TOKEN" http://localhost:3000/api/protegido
119
+ # Esperado: 200 OK (se implementado)
120
+ ```
121
+
122
+ ### 5. Rate Limiting
123
+
124
+ ```bash
125
+ # Enviar 150 requests em 1 min
126
+ for i in {1..150}; do curl http://localhost:3000/api/health; done
127
+ # Esperado: Após 100, retorna 429 Too Many Requests
128
+ ```
129
+
130
+ ---
131
+
132
+ ## 🧪 Teste de Handoff
133
+
134
+ Quando agent A passa para agent B:
135
+
136
+ **Validar:**
137
+ - [ ] Contexto está claro (não precisa adivinhar)
138
+ - [ ] Alterações listadas = arquivos reais modificados
139
+ - [ ] Riscos são verdadeiros (não alarmes)
140
+ - [ ] Pendências têm dono (quem faz?)
141
+ - [ ] Próximo passo é executável (não vago)
142
+
143
+ **Exemplo BOM:**
144
+ ```markdown
145
+ # Handoff: Backend → Reviewer
146
+
147
+ ## Contexto
148
+ Implementei GET /api/users/{id} com JWT validation
149
+
150
+ ## Alterações
151
+ - src/features/users/users.controller.ts
152
+ - src/features/users/users.service.ts
153
+ - src/features/users/dto/get-user.dto.ts
154
+
155
+ ## Riscos
156
+ - 404 para user não encontrado (testado)
157
+ - JWT secret em .env apenas (seguro)
158
+
159
+ ## Pendências
160
+ - Nenhuma
161
+
162
+ ## Próximo passo
163
+ Revisor: Validar testes, fazer E2E
164
+ ```
165
+
166
+ **Exemplo RUIM:**
167
+ ```markdown
168
+ # Handoff: Backend → Reviewer
169
+
170
+ ## Contexto
171
+ Implementei coisas
172
+
173
+ ## Alterações
174
+ - Vários arquivos
175
+
176
+ ## Riscos
177
+ - Talvez segurança?
178
+
179
+ ## Pendências
180
+ - Talvez testes?
181
+
182
+ ## Próximo passo
183
+ Aprova?
184
+ ```
185
+
186
+ ---
187
+
188
+ ## 🔐 Checklist de Segurança (OWASP Top 10)
189
+
190
+ Para CADA endpoint novo:
191
+
192
+ - [ ] **A01:2021 – Broken Access Control**
193
+ - [ ] JWT/Auth obrigatório em rotas protegidas?
194
+ - [ ] Sem hardcoded roles/permissions?
195
+
196
+ - [ ] **A02:2021 – Cryptographic Failures**
197
+ - [ ] Senhas hasheadas? (bcrypt)
198
+ - [ ] Secrets em .env (não em código)?
199
+ - [ ] HTTPS only em prod?
200
+
201
+ - [ ] **A03:2021 – Injection**
202
+ - [ ] DTO com validação bloqueia SQL injection?
203
+ - [ ] Sem concatenação de queries?
204
+
205
+ - [ ] **A04:2021 – Insecure Design**
206
+ - [ ] Rate limiting ativado?
207
+ - [ ] CORS restritivo?
208
+
209
+ - [ ] **A05:2021 – Security Misconfiguration**
210
+ - [ ] Sem console.log de dados sensíveis?
211
+ - [ ] Helmet headers presente?
212
+
213
+ - [ ] **A06:2021 – Vulnerable Components**
214
+ - [ ] npm audit limpo? (npm audit)
215
+ - [ ] Dependências atualizadas?
216
+
217
+ ---
218
+
219
+ ## 📊 Teste Coverage
220
+
221
+ ### Alvo: >80% em código crítico
222
+
223
+ ```bash
224
+ npm run test:cov
225
+ # Abre coverage/index.html
226
+
227
+ # Verificar:
228
+ # - Statements > 80%
229
+ # - Branches > 75%
230
+ # - Functions > 80%
231
+ # - Lines > 80%
232
+ ```
233
+
234
+ ---
235
+
236
+ ## 🚀 Teste E2E Rápido
237
+
238
+ ```typescript
239
+ // test/features.e2e-spec.ts
240
+ describe('Features (e2e)', () => {
241
+ let app: INestApplication;
242
+
243
+ beforeAll(async () => {
244
+ const moduleFixture = await Test.createTestingModule({
245
+ imports: [AppModule]
246
+ }).compile();
247
+ app = moduleFixture.createNestApplication();
248
+ await app.init();
249
+ });
250
+
251
+ it('POST /api/seu-endpoint com dados válidos', () => {
252
+ return request(app.getHttpServer())
253
+ .post('/api/seu-endpoint')
254
+ .send({ campo: 'valor' })
255
+ .expect(201)
256
+ .expect((res) => {
257
+ expect(res.body.id).toBeDefined();
258
+ });
259
+ });
260
+
261
+ it('POST /api/seu-endpoint com dados inválidos', () => {
262
+ return request(app.getHttpServer())
263
+ .post('/api/seu-endpoint')
264
+ .send({ campo: '' }) // Inválido
265
+ .expect(400); // Bad Request
266
+ });
267
+ });
268
+ ```
269
+
270
+ Rodar:
271
+ ```bash
272
+ npm run test:e2e
273
+ ```
274
+
275
+ ---
276
+
277
+ ## 🎯 Fluxo de Validação
278
+
279
+ ```
280
+ 1. Developer cria feature
281
+ ↓
282
+ 2. Cria handoff em memory/50-orchestration/handoffs/
283
+ ↓
284
+ 3. Você valida handoff (checklist acima)
285
+ ↓ Se ruim → Rejeita, Developer corrige
286
+ ↓ Se bom → Aprova
287
+ ↓
288
+ 4. Você roda testes + validação
289
+ npm test && npm run test:cov
290
+ ↓ Se falha → Rejeita
291
+ ↓ Se passa → Aprova
292
+ ↓
293
+ 5. Você faz teste manual dos 5 passos
294
+ ↓ Se quebra → Rejeita
295
+ ↓ Se tudo bem → Aprova
296
+ ↓
297
+ 6. Deploy! 🚀
298
+ ```
299
+
300
+ ---
301
+
302
+ ## 🐛 Bug Reporting
303
+
304
+ Quando encontrar bug:
305
+
306
+ ```markdown
307
+ # Bug: Endpoint X retorna 500
308
+
309
+ ## Reprodução
310
+ POST /api/seu-endpoint com payload { "campo": "valor especial" }
311
+
312
+ ## Esperado
313
+ 200 OK com response válido
314
+
315
+ ## Atual
316
+ 500 Internal Server Error
317
+
318
+ ## Logs
319
+ [Cole stack trace aqui]
320
+
321
+ ## Severidade
322
+ 🔴 Critical (quebra feature)
323
+ ```
324
+
325
+ ---
326
+
327
+ ## 📋 Checklist de Onboarding (QA)
328
+
329
+ - [ ] Li este guia (10 min)
330
+ - [ ] Rodei o generator (5 min)
331
+ - [ ] Executei os 5 testes manuais (5 min)
332
+ - [ ] Verifiquei coverage (5 min)
333
+ - [ ] Aprovei primeiro handoff ✅
334
+ - [ ] Pronto!
335
+
336
+ ---
337
+
338
+ ## 📞 Recursos
339
+
340
+ | Recurso | Quando usar |
341
+ |---------|------------|
342
+ | [CHECKLIST-FINAL.md](../../CHECKLIST-FINAL.md) | Critérios globais |
343
+ | [DASHBOARD-PROGRESSO.md](../../DASHBOARD-PROGRESSO.md) | Status do projeto |
344
+ | [REFINAMENTO-v1.0.md](../../REFINAMENTO-v1.0.md) | Segurança (SEC-*) |
345
+
346
+ ---
347
+
348
+ **Tempo total:** ~30 min por feature até habituado
349
+
350
+ ✅ Você é o guardião da qualidade!
@@ -0,0 +1,138 @@
1
+ # Processo de projeto com a IA — criar ou atualizar
2
+
3
+ Mapa de **nível 0**: como a demanda entra no framework e vira trabalho. Decide entre
4
+ **criar** um projeto novo e **atualizar** um existente; ambos convergem no ciclo
5
+ CLI-first de 6 etapas detalhado em [`docs/fluxo.md`](./fluxo.md).
6
+
7
+ > "Nossa IA" = os 6 papéis (`AGENTS.md`) operando via Claude Code, apoiados pelas 3
8
+ > capacidades do [ADR-0016](../memory/90-decisions/0016-integracao-capacidades-externas.md):
9
+ > **codegraph** (entender código), **harness** (desenhar time), **ai-engineering** (referência).
10
+
11
+ ---
12
+
13
+ ## Mapa de decisão
14
+
15
+ ```mermaid
16
+ flowchart TD
17
+ D(["💡 Demanda"]) --> Q{"Projeto já<br/>existe?"}
18
+
19
+ %% ── Ramo A: NOVO ──
20
+ Q -- "Não" --> A1["A1· Gerar scaffold<br/>npm run init:project &lt;nome&gt; --ai claude,copilot"]
21
+ A1 --> A2["A2· Escolher boilerplate<br/>api-rest · saas · ecommerce · microservices · monorepo"]
22
+ A2 --> A3["A3· (opcional) harness<br/>desenha o time de agentes do domínio"]
23
+ A3 --> C0
24
+
25
+ %% ── Ramo B: EXISTENTE ──
26
+ Q -- "Sim" --> B0{"Já tem<br/>memory/?"}
27
+ B0 -- "Não" --> B1["B1· Overlay de memória<br/>init:project detecta backend → --only-memory"]
28
+ B0 -- "Sim" --> B2["B2· Indexar código<br/>codegraph init (entender o que existe)"]
29
+ B1 --> B2
30
+ B2 --> C0
31
+
32
+ %% ── Convergência: ciclo SDD+GSD ──
33
+ C0(["▶ Entra no ciclo CLI-first"]) --> CICLO
34
+ subgraph CICLO["docs/fluxo.md — 6 etapas"]
35
+ direction LR
36
+ c1["1·Entender"] --> c2["2·Especificar"] --> c3["3·Arquitetar"] --> c4["4·Decompor"] --> c5["5·Implementar"] --> c6["6·Governar"]
37
+ end
38
+ CICLO --> OUT(["✅ Entrega + memória atualizada"])
39
+ ```
40
+
41
+ ### Fallback ASCII
42
+
43
+ ```
44
+ 💡 Demanda
45
+ │
46
+ ├─ projeto NÃO existe ─► A1 init:project <nome> --ai …
47
+ │ A2 escolher boilerplate
48
+ │ A3 (opc.) harness desenha o time ─┐
49
+ │ │
50
+ └─ projeto JÁ existe ──► tem memory/? │
51
+ ├─ não ► B1 overlay --only-memory │
52
+ └─ sim ─┘ │
53
+ B2 codegraph init ────────┤
54
+ ▼
55
+ ▶ CICLO (docs/fluxo.md):
56
+ 1·Entender → 2·Especificar → 3·Arquitetar
57
+ → 4·Decompor → 5·Implementar → 6·Governar ─► ✅
58
+ ```
59
+
60
+ ---
61
+
62
+ ## Ramo A — Criar projeto novo
63
+
64
+ O gerador (`bin/init-project.js`) roda 8 passos: git-init → estrutura agentes+memória
65
+ → design-lib → instruções multi-IA → install-backend → init memória SQLite →
66
+ context-pack → next-steps. Cada projeto nasce com `memory/`, `.ia-instructions/`
67
+ (claude/copilot/gemini/codex) e seu próprio banco de memória.
68
+
69
+ Projetos de produto vivem no **workspace Forja** (`~/forja-workspace/projects/<nome>`
70
+ por padrão), fora do repo do framework. Veja ADR-0019.
71
+
72
+ ```bash
73
+ # 1. preparar workspace (uma vez)
74
+ npm run workspace:init
75
+
76
+ # 2. gerar (cria em ~/forja-workspace/projects/<nome>)
77
+ npm run project:new <nome> -- --ai claude,copilot,gemini
78
+
79
+ # 3. (opcional) escolher boilerplate de stack
80
+ ls boilerplates/ # 01-api-rest · 02-saas-starter · 03-ecommerce · 04-microservices · 05-monorepo
81
+
82
+ # 4. (opcional) na sessão Claude Code, desenhar o time de agentes do domínio:
83
+ # "build a harness for this project" → gera .claude/agents + .claude/skills
84
+
85
+ # 5. entrar no ciclo: começa pela spec
86
+ npm run spec:new -- <slug>
87
+ ```
88
+
89
+ ---
90
+
91
+ ## Ramo B — Atualizar projeto existente
92
+
93
+ ```bash
94
+ # B1. projeto sem memória ainda? sobrepõe só a camada de memória/agentes
95
+ # (init:project detecta backend e aplica --only-memory automaticamente)
96
+ npm run init:project <nome> # apontando para o projeto existente
97
+
98
+ # B2. indexar o código atual ANTES de mexer (entender sem ler arquivo a arquivo)
99
+ codegraph init # ou: npm run code:index
100
+ codegraph explore "<área a mudar>"
101
+
102
+ # entra no ciclo pela spec da mudança
103
+ npm run spec:new -- <slug>
104
+ ```
105
+
106
+ A diferença essencial do ramo B é a **etapa 1 (Entender) com codegraph**: antes de
107
+ especificar a mudança, mapeie símbolos, callers e impacto no código que já existe.
108
+
109
+ ---
110
+
111
+ ## Convergência — o ciclo (resumo)
112
+
113
+ Os dois ramos terminam no mesmo ciclo de 6 etapas. Quem dirige cada uma:
114
+
115
+ | # | Etapa | Papel | Capacidade |
116
+ |---|-------|-------|------------|
117
+ | 1 | Entender | context-engineer | codegraph · ai-engineering |
118
+ | 2 | Especificar | product | — |
119
+ | 3 | Arquitetar | sdd-architect | harness · ADR |
120
+ | 4 | Decompor | sdd-architect | — |
121
+ | 5 | Implementar | orchestrator + worker | codegraph (MCP) |
122
+ | 6 | Governar | governance | codegraph (`affected`) |
123
+
124
+ Detalhe de comandos por etapa, handoffs (7 campos, ADR-0005) e o papel do dashboard
125
+ opcional: **[`docs/fluxo.md`](./fluxo.md)**.
126
+
127
+ ---
128
+
129
+ ## Onde "nossa IA" age em cada ramo
130
+
131
+ - **Novo projeto:** a IA gera o scaffold, e o **harness** desenha o time de agentes
132
+ inicial sob medida para o domínio. ai-engineering fundamenta escolhas técnicas.
133
+ - **Projeto existente:** **codegraph** dá à IA o mapa do código atual (símbolos,
134
+ call paths, testes afetados) — é o que evita refator às cegas. O overlay
135
+ `--only-memory` dá ao projeto a camada de memória/agentes sem tocar no código.
136
+ - **Sempre:** memória e contexto são transversais (`sync:universal`,
137
+ `query:universal`, `context:smart`) e cada handoff entre papéis fica registrado em
138
+ `~/forja-workspace/memory/sqlite/universal.db`.