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
package/AGENTS.md ADDED
@@ -0,0 +1,132 @@
1
+ # AGENTS — Topologia do framework
2
+
3
+ ## Modo operacional
4
+
5
+ Este projeto e **CLI-first**. Use comandos para operar sprints, SDD, GSD, contexto e handoffs. Dashboard/web e recursos visuais sao opcionais e nao devem bloquear operacao, governanca ou entrega quando a tarefa nao tiver impacto visual.
6
+
7
+ Todo comando de processo passa pelo **core** `bin/forja.mjs` (ADR-0020): registry declarativo em `lib/core/registry.mjs`, gates transversais (workspace) e auditoria de cada execucao em `<workspace>/.context/forja-runs.jsonl` — e essa trilha que Governance usa no review. Os scripts npm abaixo sao aliases finos do core; `node bin/forja.mjs` lista tudo por dominio.
8
+
9
+ Os **produtos gerados** vivem no **workspace Forja** (`~/forja-workspace` por padrao, configuravel via `FORJA_WORKSPACE` ou `~/.forjarc.json`). O repositorio atual e apenas o motor/framework. Veja ADR-0019. Toda IA que abre este repo ou um projeto gerado deve entender essa estrutura pelas instrucoes nativas (`CLAUDE.md`, `.github/copilot-instructions.md`, `.gemini-instructions.md`, `.openai-instructions.md` — conteudo canonico identico).
10
+
11
+ Comandos de rotina:
12
+
13
+ ```bash
14
+ npm run workspace:init
15
+ npm run project:new <nome> -- --ai claude,copilot
16
+ npm run project:list
17
+ npm run project:check <nome>
18
+
19
+ npm run sprint:status
20
+ npm run gsd:plan -- <slug> "<objetivo>"
21
+ npm run gsd:handoff -- spec <slug>
22
+ npm run gsd:handoff -- plan <slug>
23
+ npm run gsd:handoff -- implement <slug>
24
+ npm run gsd:handoff -- review <slug>
25
+ npm run gsd:check -- <slug>
26
+ npm run project:check
27
+ ```
28
+
29
+ 6 papéis, cada um materializado em três lugares:
30
+
31
+ - **Sub-agent Claude Code** em `.claude/agents/<name>.md` (invocável via Task tool)
32
+ - **Prompt portátil** em `prompts/<name>-agent.md` (para Copilot/Gemini/Codex)
33
+ - **Descrição neste arquivo** (referência canônica de responsabilidades)
34
+
35
+ Handoffs entre eles passam pela tabela `handoffs` em `~/forja-workspace/memory/sqlite/universal.db` (configurável via `FORJA_WORKSPACE`/`~/.forjarc.json`), registrados via Hermes (`npm run hermes:handoff` ou `npm run gsd:handoff`) sobre `scripts/agent-router.mjs` (ADR-0008). Campos obrigatórios em todo handoff: `from, to, intent, context, acceptance, constraints, return` (ADR-0005).
36
+
37
+ ---
38
+
39
+ ## 1. Orchestrator (Master)
40
+ **Quando**: demanda atravessa múltiplos papéis ou usuário pede para "orquestrar/coordenar".
41
+ **Faz**: decompõe em handoffs, escolhe sub-agents, registra via agent-router, consolida memória ao fim de sprint.
42
+ **Não faz**: implementação direta.
43
+
44
+ ## 2. Context Engineer
45
+ **Quando**: antes de tarefa pesada (refator amplo, análise multi-arquivo) ou em perguntas sobre tokens/cache.
46
+ **Faz**: monta `.context/pack.md` no modo certo (`global`|`domain`|`task` — ADR-0003), mede tokens, comprime memória.
47
+ **Não faz**: decisões de produto ou arquitetura.
48
+
49
+ ## 3. SDD Architect
50
+ **Quando**: spec aprovada precisando virar plan, ou decisão estrutural pedindo ADR.
51
+ **Faz**: escreve `specs/<feat>/plan.md`, abre ADRs em `memory/90-decisions/`, devolve specs mal-escritas.
52
+ **Não faz**: código de implementação.
53
+
54
+ ## 4. Product
55
+ **Quando**: demanda nova sem spec, ambiguidade sobre "o quê", priorização.
56
+ **Faz**: roda `npm run spec:new`, preenche `spec.md`, prioriza `backlog.md` via RICE, define métrica 30d.
57
+ **Não faz**: decisões de "como".
58
+
59
+ ## 5. Marketing (Growth)
60
+ **Quando**: positioning antes do release, copy/landing, instrumentação AARRR, análise pós-launch.
61
+ **Faz**: copy referenciando dor da spec, lista de eventos a instrumentar, relatório de funil.
62
+ **Não faz**: invenção de números sem instrumentação.
63
+
64
+ ## 6. Governance
65
+ **Quando**: antes de aprovar merge/release.
66
+ **Faz**: roda `project:check`, audita handoffs por completude, valida 12-Factor/LGPD/segurança, bloqueia se algo falta.
67
+ **Não faz**: aprovar "ficou bom" sem referência verificável.
68
+
69
+ ---
70
+
71
+ ## Fluxo SDD padrão
72
+
73
+ ```
74
+ usuário → Product (spec.md)
75
+ ↓ approved
76
+ SDD Architect (plan.md + ADRs)
77
+ ↓ approved
78
+ SDD Architect (tasks.md)
79
+ ↓ handoff "implement"
80
+ Worker (código)
81
+ ↓ handoff "review"
82
+ Governance (project:check)
83
+ ↓ aprovado
84
+ merge → Orchestrator consolida memória
85
+ ```
86
+
87
+ Context Engineer pode ser invocado em qualquer ponto. Marketing entra antes (positioning) e depois (métricas).
88
+
89
+ ## GSD + Harness
90
+
91
+ GSD e o harness de execucao do fluxo SDD. Ele roda sempre em steps, valida gates e padroniza handoffs Hermes.
92
+
93
+ Ordem operacional:
94
+
95
+ ```
96
+ briefing → estrutura → sprints → contexto → impacto (codegraph) → spec → design → plan → desenvolvimento → validação → governança
97
+ ```
98
+
99
+ Comandos principais:
100
+
101
+ ```bash
102
+ npm run dev -- gsd:plan <slug> "<objetivo>"
103
+ npm run dev -- gsd:handoff spec <slug>
104
+ npm run dev -- gsd:handoff plan <slug>
105
+ npm run dev -- gsd:handoff implement <slug>
106
+ npm run dev -- gsd:handoff review <slug>
107
+ npm run dev -- gsd:check <slug> <brief.md>
108
+ ```
109
+
110
+ Antes de planejar/editar, mapeie o impacto com codegraph (ADR-0017) e cheque ferramentas de processo (ADR-0018):
111
+
112
+ ```bash
113
+ npm run code:check # indice codegraph confiavel (worktree + freshness)
114
+ npm run code:impact -- <simbolo> # chamadores + blast radius
115
+ npm run tools:doctor # raio-x: codegraph, gitleaks, ast-grep, lefthook, markdownlint
116
+ ```
117
+
118
+ Use `design:select` e `design:check` antes de qualquer implementacao com impacto visual:
119
+
120
+ ```bash
121
+ npm run dev -- design:select agent-console tecnico
122
+ npm run dev -- design:check design-md/examples/agent-console-brief.md
123
+ ```
124
+
125
+ ## Onde olhar
126
+ - `.claude/agents/` — sub-agents Claude Code (system prompts)
127
+ - `prompts/` — prompts portáveis para outras IAs
128
+ - `memory/50-orchestration/` — protocolos detalhados (não-executáveis)
129
+ - `memory/90-decisions/0005-handoff-7-campos.md` e `0008-sub-agents-claude-handoff-sqlite.md`
130
+ - `scripts/agent-harness.mjs` — Hermes/GSD/design harness
131
+ - `scripts/agent-router.mjs` — CLI base de handoff
132
+ - `specs/` — pipeline SDD
package/CHANGELOG.md ADDED
@@ -0,0 +1,106 @@
1
+ # Changelog
2
+
3
+ Histórico consolidado das mudanças estruturais do framework. Para decisões arquiteturais com rationale, ver `memory/90-decisions/`.
4
+
5
+ ---
6
+
7
+ ## [Unreleased] — Workspace separado
8
+
9
+ SPEC-028 (`specs/reestruturacao-forja-v2/`): separação do framework Forja do workspace de produção.
10
+
11
+ - `lib/workspace.mjs` — resolução centralizada do workspace (`FORJA_WORKSPACE` > `~/.forjarc.json` > `~/forja-workspace`).
12
+ - `bin/init-project.js` — projetos de produto obrigatoriamente em `~/forja-workspace/projects/<nome>`.
13
+ - `scripts/sync-universal-memory.js`, `query-universal-memory.js`, `build-smart-context.js`, `memory-schema.mjs` — memória universal (SQLite) movida para o workspace.
14
+ - `scripts/check-standards.js` — `npm run project:check <nome>` resolve projeto no workspace.
15
+ - `scripts/agent-harness.mjs` + `package.json` — comandos `workspace:init`, `project:new`, `project:list`, `workspace:project:check`.
16
+ - Documentação atualizada: `README.md`, `AGENTS.md`, `docs/init-project.md`, `docs/structure.md`.
17
+ - ADR-0019 (`memory/90-decisions/0019-workspace-separado.md`) documenta a decisão.
18
+ - `.gitignore` reforça que projetos de produto não entram no repo do framework.
19
+
20
+ ## [Unreleased] — Dashboard local
21
+
22
+ SPEC-002 (`specs/agent-dashboard/`) implementada em 12 tasks (T1-T12).
23
+
24
+ - `dashboard/server/` — Fastify 5 com 7 rotas (specs, handoffs, projects, tokens, commands SSE, briefing, health)
25
+ - `dashboard/web/` — Vite + React + Tailwind + Recharts; 6 telas; bundle 166KB gzip (NFR < 500KB ✓)
26
+ - `dashboard/server/lib/` — allowlist hard-coded, run-command, spec-parser, briefing-parser, token-estimator
27
+ - Scripts: `npm run dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:build`
28
+ - **60 testes verde** (55 dashboard + 5 root)
29
+ - `docs/dashboard.md` cobre uso, allowlist, troubleshooting, segurança
30
+
31
+ ## [v1.1] — 2026-05-10 — Refator SDD + Orquestração
32
+
33
+ ### Frente 1 — Cleanup + ADRs
34
+ - 13 relatórios históricos movidos para `docs/archive/`
35
+ - 4 guias úteis migrados para `docs/{structure,init-project,examples,publishing}.md`
36
+ - 2 exemplos antigos arquivados em `docs/archive/examples/`
37
+ - Monolito bin (1486 LOC) preservado em `docs/archive/legacy-bin/`
38
+ - `DOC-MAP.md` reescrito (204 → 50 linhas)
39
+ - 6 ADRs criados a partir de decisões dispersas (`memory/90-decisions/0001-0006`)
40
+
41
+ ### Frente 2 — Bins e exemplos consolidados
42
+ - `bin/create-memory-nest-kit-v2.js` promovido a oficial (substituiu monolito)
43
+ - `package.json`: bin secundário, novos scripts `spec:*`, `agent:route`, `memory:vacuum`
44
+ - `exemplo-v3` mantido como exemplo canônico
45
+
46
+ ### Frente 3 — Pipeline SDD
47
+ - `specs/_templates/{spec,plan,tasks}.md`
48
+ - `scripts/spec-cli.mjs` com `new`/`plan`/`tasks`/`check` (4/4 testes verdes)
49
+ - ADR-0007 estabelece SDD como obrigatório para features não-triviais
50
+ - SPEC-001 (`specs/pipeline-sdd-e-orquestracao/`) é a meta-spec deste refator
51
+
52
+ ### Frente 4 — Sub-agents executáveis
53
+ - 6 sub-agents em `.claude/agents/`: orchestrator, context-engineer, sdd-architect, product, marketing, governance
54
+ - 3 prompts portáveis novos em `prompts/`
55
+ - `scripts/agent-router.mjs` persiste handoffs em `universal.db.handoffs` (7 campos validados)
56
+ - ADR-0008 documenta migração handoff markdown → SQLite
57
+ - `AGENTS.md` reescrito
58
+
59
+ ### Frente 5 — Hooks token-economy
60
+ - `.claude/settings.json` com hooks `SessionStart` e `UserPromptSubmit`
61
+ - `scripts/hook-session-start.mjs` injeta status de specs + handoffs abertos
62
+ - `scripts/hook-user-prompt.mjs` opt-in (`FRAMEWORK_HOOK_INJECT=1`), cache 30min, cap 4KB
63
+ - `scripts/pre-commit.sh` agora roda `spec:check` + `check-standards`
64
+ - ADR-0009 documenta trade-offs
65
+ - `.memoryrc.json` ganha seção `hooks`; `handoff` aponta para SQLite
66
+
67
+ ---
68
+
69
+ ## [v1.0] — 2026-05-02 — 4 Fases Estruturais
70
+
71
+ Detalhes completos em `docs/archive/PROJETO-COMPLETO.md`.
72
+
73
+ ### Fase 1 — Arquitetura
74
+ - Monolito `bin/create-memory-nest-kit.js` (1486 LOC) refatorado em 5 módulos em `lib/`
75
+ - Orquestrador final: 125 LOC (redução de 91%)
76
+ - 1.820 LOC reutilizáveis em `lib/generators/`, `lib/validators/`, `lib/utils/`, `lib/context-builder.js`
77
+ - 7/7 testes passando; backward compatible
78
+
79
+ ### Fase 2 — Documentação por Persona
80
+ - `docs/personas/{executive,architect,developer,qa}/` — guias estruturados
81
+ - `docs/quick-reference.md`, `docs/glossary.md`, `DOC-MAP.md`
82
+ - Onboarding reduzido em ~83% (medido em tempo de leitura)
83
+
84
+ ### Fase 3 — Economia de Tokens
85
+ - `lib/context-builder.js` — API com 3 modos (`global`, `domain`, `task`), FTS5, cache LRU
86
+ - `scripts/compress-memory.mjs` — archive de runs > 30 dias, VACUUM
87
+ - `.memoryrc.json` — configuração centralizada
88
+ - `docs/token-optimization.md`, `scripts/token-benchmark.mjs`
89
+ - Redução estimada: 40-60% em tokens enviados ao modelo
90
+
91
+ ### Fase 4 — Dev Workflow
92
+ - `scripts/dev.mjs` — CLI unificada (health/build-context/sprint/check)
93
+ - `scripts/pre-commit.sh` — validação automática
94
+ - `scripts/check-standards.js`, `scripts/generate-dashboard.js`
95
+ - 100% das operações cobertas por scripts npm
96
+
97
+ ---
98
+
99
+ ## [v0.x] — 2026-04 — Bootstrap
100
+
101
+ - Estrutura inicial `memory/` hierárquica (00-global a 90-decisions)
102
+ - `bin/create-memory-nest-kit.js` — scaffold inicial monolítico
103
+ - SQLite universal (`.memory/sqlite/universal.db`) com FTS5
104
+ - Scripts `sprint-manager.js`, `sync-universal-memory.js`, `query-universal-memory.js`
105
+ - AGENTS.md com topologia de 6 papéis
106
+ - `exemplo-projeto/`, `exemplo-v2/`, `exemplo-v3/` — outputs de referência
@@ -0,0 +1,32 @@
1
+ # Contribuindo com a Forja
2
+
3
+ A Forja usa o próprio processo que ela prega. Contribuições seguem o mesmo pipeline:
4
+
5
+ ## Regras do jogo
6
+
7
+ 1. **Feature não-trivial começa por spec** — `npm run spec:new -- <slug>` e preencha `specs/<slug>/spec.md` antes de escrever código.
8
+ 2. **Decisão estrutural vira ADR** — `memory/90-decisions/NNNN-titulo.md` (template em `_template.md`).
9
+ 3. **Comando novo entra no registry** — `lib/core/registry.mjs` (o teste `test/forja-core.test.js` valida a integridade). Nada de script npm apontando direto para um script solto.
10
+ 4. **pt-BR** em docs, mensagens e saída de CLI.
11
+ 5. **Testes verdes** — `npm test` (Node ≥ 20).
12
+
13
+ ## Setup
14
+
15
+ ```bash
16
+ npm ci
17
+ npm test
18
+ node bin/forja.mjs # help do core
19
+ ```
20
+
21
+ ## Antes de abrir o PR
22
+
23
+ ```bash
24
+ npm test
25
+ npm run project:check
26
+ npm run spec:check -- <slug-da-sua-feature>
27
+ ```
28
+
29
+ ## O que não entra neste repo
30
+
31
+ - Dados de produto/cliente — vivem no workspace externo (`~/forja-workspace`, ADR-0019).
32
+ - Specs de produto — `specs/` do repo é allowlist (só specs do próprio framework, ver `.gitignore`).
package/DOC-MAP.md ADDED
@@ -0,0 +1,65 @@
1
+ # Mapa de Documentação
2
+
3
+ Ponto de entrada por papel. Para histórico de fases ver `CHANGELOG.md`; para decisões com rationale ver `memory/90-decisions/`.
4
+
5
+ ---
6
+
7
+ ## Por papel
8
+
9
+ ### Operacao CLI / Orquestracao
10
+ - `docs/processo-projeto.md` — **processo nível 0**: criar vs atualizar projeto com a IA (decisão de entrada)
11
+ - `docs/fluxo.md` — **mapa do ciclo** (CLI-first) com as 3 capacidades integradas (codegraph/harness/ai-engineering)
12
+ - `docs/manual-operacional-cli-sdd-gsd.md` — manual principal para operar CLI-first, SDD, GSD, sprints, handoffs e governanca
13
+ - `docs/cli-first-operacao.md` — guia curto de comandos
14
+
15
+ ### Executivo / PM
16
+ - `docs/personas/executive/README.md` — overview, ROI, status
17
+
18
+ ### Arquiteto / Tech Lead
19
+ - `docs/personas/architect/README.md`
20
+ - `docs/token-optimization.md` — economia de tokens e cache
21
+ - `docs/structure.md` — hierarquia de diretórios gerados
22
+ - `memory/90-decisions/` — ADRs
23
+
24
+ ### Developer
25
+ - `docs/personas/developer/README.md`
26
+ - `docs/quick-reference.md` — atalhos e comandos
27
+ - `docs/examples.md` — snippets prontos
28
+ - `docs/dev-workflow.md`
29
+ - `docs/init-project.md` — como gerar novo projeto
30
+ - `docs/dashboard.md` — painel web local (`npm run dashboard`)
31
+
32
+ ### QA
33
+ - `docs/personas/qa/README.md`
34
+
35
+ ### Agentes / IA
36
+ - `AGENTS.md` — papéis e topologia
37
+ - `CLAUDE.md` — instruções específicas para Claude Code
38
+ - `.claude/agents/` — sub-agents executáveis (em construção)
39
+ - `memory/50-orchestration/` — protocolos de handoff
40
+ - `docs/capacidades-externas.md` — codegraph (MCP), harness (plugin) e ai-engineering (base de conhecimento) integrados (ADR-0016)
41
+
42
+ ---
43
+
44
+ ## Por tópico
45
+
46
+ | Tópico | Arquivo |
47
+ |---|---|
48
+ | Manual operacional CLI-first | `docs/manual-operacional-cli-sdd-gsd.md` |
49
+ | Guia curto CLI-first | `docs/cli-first-operacao.md` |
50
+ | Mudanças recentes | `CHANGELOG.md` |
51
+ | Decisões arquiteturais | `memory/90-decisions/` |
52
+ | Glossário | `docs/glossary.md` |
53
+ | Otimização de tokens | `docs/token-optimization.md` |
54
+ | Capacidades externas (codegraph/harness/ai-engineering) | `docs/capacidades-externas.md` |
55
+ | Workflow de dev | `docs/dev-workflow.md` |
56
+ | Publicação npm | `docs/publishing.md` |
57
+ | Estrutura gerada | `docs/structure.md` |
58
+ | Exemplos de código | `docs/examples.md` |
59
+ | Dashboard web | `docs/dashboard.md` |
60
+
61
+ ---
62
+
63
+ ## Histórico
64
+
65
+ Relatórios de fases anteriores estão em `docs/archive/`. Não edite — referenciar via `CHANGELOG.md` ou ADRs apropriadas.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,260 @@
1
+ <h1 align="center">🔨 Forja</h1>
2
+
3
+ <p align="center">
4
+ <strong>Transforme IA de codificação em uma equipe de engenharia com processo e memória:<br>todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.</strong>
5
+ </p>
6
+
7
+ <p align="center">
8
+ <img src="https://github.com/allanpablo/forja/actions/workflows/ci.yml/badge.svg" alt="CI">
9
+ <img src="https://img.shields.io/badge/operação-CLI--first-3553ff?style=flat-square" alt="CLI-first">
10
+ <img src="https://img.shields.io/badge/agentes-6_papéis-orange?style=flat-square" alt="6 agentes">
11
+ <img src="https://img.shields.io/badge/pipeline-SDD_+_GSD-teal?style=flat-square" alt="SDD+GSD">
12
+ <img src="https://img.shields.io/badge/memória-SQLite_FTS5-green?style=flat-square" alt="Memória">
13
+ <img src="https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 20">
14
+ <img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT">
15
+ <img src="https://img.shields.io/badge/PRs-welcome-8957e5?style=flat-square" alt="PRs welcome">
16
+ </p>
17
+
18
+ ---
19
+
20
+ ## Por que a Forja existe
21
+
22
+ Agentes de IA são **amnésicos e indisciplinados**: cada sessão recomeça do zero, decisões
23
+ de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao
24
+ mesmo tempo paga esse imposto multiplicado por N.
25
+
26
+ A **Forja** é o estúdio em volta da IA. Ela coordena **6 papéis de agentes** num pipeline
27
+ **Spec-Driven (SDD)** + **Get-Stuff-Done (GSD)**, mantém uma **memória hierárquica**
28
+ indexada em SQLite que sobrevive entre sessões, e amarra tudo num **core CLI único com
29
+ gates e trilha de auditoria** (`forja`, ADR-0020). Multi-IA por design (Claude, Copilot,
30
+ Gemini, Codex) — o dashboard web é apenas uma visão opcional read-only.
31
+
32
+ **Para quem**: o dev solo ou time pequeno que opera múltiplos produtos com IA como
33
+ principal força de trabalho — e precisa da disciplina de um time grande sem ter esse time.
34
+
35
+ ## Os 3 pilares
36
+
37
+ | Pilar | O que entrega | Prova |
38
+ |---|---|---|
39
+ | **Memória que sobrevive** | contexto hierárquico, buscável, compartilhado entre sessões e IAs | SQLite FTS5, smart-context (ADR-0003) |
40
+ | **Processo que governa** | nada vira código sem spec; nada estrutural sem ADR; comandos auditados | SDD+GSD, handoffs 7 campos (ADR-0005), core `forja` (ADR-0020) |
41
+ | **Fábrica, não projeto único** | workspace multi-produto, times de agentes por projeto | ADR-0019, harness, codegraph (ADR-0017) |
42
+
43
+ > Este repositório é o **motor (framework)** — não hospeda aplicações em produção.
44
+ > Os produtos do usuário vivem no **workspace Forja** (`~/forja-workspace` por padrão), fora deste repo.
45
+ > Veja ADR-0019 para a rationale.
46
+
47
+ ## 60 segundos de Forja
48
+
49
+ ```console
50
+ $ forja spec:new pagamentos-pix
51
+ ✓ Spec criada: specs/pagamentos-pix/spec.md # nada vira código sem isso
52
+
53
+ $ forja gsd:handoff -- plan pagamentos-pix
54
+ Handoff registrado: product → sdd-architect # 7 campos, auditável (ADR-0005)
55
+
56
+ $ forja code:impact -- processPayment
57
+ Mapa de impacto: processPayment (profundidade 2) # blast radius ANTES de editar
58
+ --- Chamadores diretos ---
59
+ BillingController.charge · RetryWorker.run
60
+
61
+ $ forja gsd:check -- pagamentos-pix
62
+ OK GSD runbook OK Spec directory
63
+ OK SDD spec check OK Codegraph
64
+ Resultado: gates básicos prontos. # governança executável, não checklist
65
+ ```
66
+
67
+ E cada comando acima ficou gravado em `.context/forja-runs.jsonl` — quando a governança pergunta "o processo foi seguido?", a resposta é um arquivo, não uma promessa.
68
+
69
+ ## Por que não só…?
70
+
71
+ | Alternativa | Onde ela para | O que a Forja acrescenta |
72
+ |---|---|---|
73
+ | **Claude Code / Copilot puros** | brilhantes na sessão, amnésicos entre sessões | memória FTS5 + processo + auditoria em volta da IA |
74
+ | **LangGraph / CrewAI** | infraestrutura para *construir* agentes | a camada de cima: opera o time de agentes no dia a dia |
75
+ | **Templates & spec kits** | param quando a spec está escrita | pipeline completo até a governança, com gates que executam |
76
+
77
+ ## Capacidades-chave
78
+
79
+ - **Core CLI único** — todo comando de processo passa por `forja <comando>`: registry declarativo, gates transversais (workspace) e auditoria append-only em `.context/forja-runs.jsonl` (ADR-0020).
80
+ - **Orquestração multiagente** — 6 papéis (orchestrator, context-engineer, sdd-architect, product, marketing, governance) com handoffs rastreados (7 campos, ADR-0005).
81
+ - **Memória hierárquica** — global → domínio → tarefa → resumo, com busca FTS5 e *smart-context* em 3 modos (ADR-0003).
82
+ - **Pipeline SDD + GSD** — `spec → plan → tasks → check`, decisões registradas como ADRs.
83
+ - **Geração de projetos** — `project:new` cria scaffold completo no workspace (memória, agentes, instruções multi-IA, backend NestJS como boilerplate padrão) e registra a ficha do projeto automaticamente.
84
+ - **3 capacidades integradas** (ADR-0016): **codegraph** (análise de código via MCP), **harness** (desenho de times de agentes), **ai-engineering** (base de conhecimento).
85
+
86
+ ## ⚡ Quick start
87
+
88
+ ```bash
89
+ # Preparar o workspace de produção (canto fixo dos projetos)
90
+ npm run workspace:init
91
+
92
+ # Criar um projeto novo (gera em ~/forja-workspace/projects/<nome>)
93
+ npm run project:new meu-projeto -- --ai claude,copilot
94
+
95
+ # Entrar no ciclo SDD/GSD da primeira feature
96
+ npm run spec:new -- minha-feature
97
+ npm run spec:plan -- minha-feature
98
+ npm run spec:tasks -- minha-feature
99
+ npm run spec:check -- minha-feature
100
+ ```
101
+
102
+ Passo a passo de **criar vs atualizar** projeto: [`docs/processo-projeto.md`](docs/processo-projeto.md).
103
+
104
+ ## Como funciona — o processo
105
+
106
+ ```
107
+ 💡 Demanda
108
+ ├─ projeto NÃO existe ─► init:project + boilerplate + harness (desenha o time)
109
+ └─ projeto JÁ existe ──► overlay --only-memory + codegraph init (entende o código)
110
+ │
111
+ ▼
112
+ CICLO CLI-first (docs/fluxo.md):
113
+ 1·Entender → 2·Especificar → 3·Arquitetar → 4·Decompor → 5·Implementar → 6·Governar → ✅
114
+ ```
115
+
116
+ | Etapa | Papel | Capacidade |
117
+ |-------|-------|------------|
118
+ | 1 Entender | context-engineer | codegraph · ai-engineering |
119
+ | 2 Especificar | product | — |
120
+ | 3 Arquitetar | sdd-architect | harness · ADR |
121
+ | 4 Decompor | sdd-architect | — |
122
+ | 5 Implementar | orchestrator + worker | codegraph (MCP) |
123
+ | 6 Governar | governance | codegraph (`affected`) |
124
+
125
+ Mapa completo do ciclo: [`docs/fluxo.md`](docs/fluxo.md).
126
+
127
+ ## As 3 capacidades integradas
128
+
129
+ | Capacidade | Papel | Como usar |
130
+ |---|---|---|
131
+ | **codegraph** | análise de código (MCP local) | `npm run code:index` · `codegraph explore "<área>"` · ferramentas MCP `codegraph_explore`/`codegraph_node` |
132
+ | **harness** | desenho de times de agentes (plugin) | na sessão Claude Code: _"build a harness for this project"_ → gera `.claude/agents` + `.claude/skills` |
133
+ | **ai-engineering** | base de conhecimento (referência) | `projects/ai-engineering-from-scratch-main/` (ROADMAP, phases, glossary) |
134
+
135
+ Detalhes e reinstalação: [`docs/capacidades-externas.md`](docs/capacidades-externas.md) · [ADR-0016](memory/90-decisions/0016-integracao-capacidades-externas.md).
136
+
137
+ ## O core `forja`
138
+
139
+ Todos os comandos de processo passam por um único ponto de entrada (ADR-0020):
140
+
141
+ ```bash
142
+ node bin/forja.mjs # help agrupado por domínio
143
+ node bin/forja.mjs <comando> # ou, com o pacote linkado: forja <comando>
144
+ ```
145
+
146
+ O core aplica **gates** antes de executar (ex.: comandos de produto falham cedo sem
147
+ workspace) e grava **auditoria** de cada execução (comando, args, exit code, duração)
148
+ em `<workspace>/.context/forja-runs.jsonl` — a trilha que a governança usa no review.
149
+ Os scripts npm abaixo são aliases finos que roteiam pelo core.
150
+
151
+ ## Comandos essenciais
152
+
153
+ ```bash
154
+ # Workspace & projetos
155
+ npm run workspace:init # cria ~/forja-workspace
156
+ npm run project:new <nome> -- --ai claude,copilot # cria projeto no workspace
157
+ npm run project:list # lista projetos do workspace
158
+ npm run project:check <nome> # valida padrões no projeto
159
+
160
+ # Pipeline SDD
161
+ npm run spec:new|plan|tasks|check -- <slug>
162
+
163
+ # Sprint & handoffs (GSD)
164
+ npm run sprint:start | sprint:status | sprint:complete
165
+ npm run gsd:handoff -- <intent> <slug> # handoff entre papéis (ADR-0005)
166
+
167
+ # Análise de código (codegraph)
168
+ npm run code:index | code:sync | code:status
169
+ npm run code:query "<termo>"
170
+
171
+ # Memória & contexto (workspace)
172
+ npm run sync:universal # reindexa SQLite FTS5 do workspace
173
+ npm run query:universal "<query>"
174
+ npm run context:smart # smart-context
175
+
176
+ # Qualidade & visão
177
+ npm run project:check # standards do framework
178
+ npm run dashboard # front opcional (http://127.0.0.1:7777)
179
+ ```
180
+
181
+ ## Separação framework × workspace
182
+
183
+ O Forja é dividido em duas partes:
184
+
185
+ 1. **Framework** (este repositório): motor, convenções, scripts e memória do próprio framework.
186
+ 2. **Workspace** (`~/forja-workspace` por padrão): "canto fixo" onde vivem os projetos de produto, a memória universal deles e as specs de produto.
187
+
188
+ O caminho do workspace é resolvido por prioridade:
189
+
190
+ 1. Variável de ambiente `FORJA_WORKSPACE`
191
+ 2. Campo `workspaceRoot` em `~/.forjarc.json`
192
+ 3. Padrão: `~/forja-workspace`
193
+
194
+ Veja ADR-0019 para a decisão arquitetural.
195
+
196
+ ## Estrutura do repositório (framework)
197
+
198
+ ```
199
+ bin/ CLIs (init-project, create-memory-nest-kit)
200
+ lib/ Módulos reutilizáveis (workspace, generators, validators, context-builder)
201
+ scripts/ Automação (sprint-manager, agent-router, sync-universal-memory, …)
202
+ specs/ Pipeline SDD do próprio framework (spec → plan → tasks)
203
+ boilerplates/ Templates de stack (api-rest, saas, ecommerce, microservices, monorepo)
204
+ memory/ Memória do framework (00-global … 90-decisions/ADRs)
205
+ docs/ Documentação por persona e por tópico (ver DOC-MAP.md)
206
+ prompts/ Prompts portáteis dos 6 papéis
207
+ .claude/ Sub-agents e settings do Claude Code
208
+ projects/ LEGADO — não usar; projetos vivem no workspace externo
209
+ ```
210
+
211
+ ## Estrutura do workspace
212
+
213
+ ```
214
+ ~/forja-workspace/
215
+ projects/ # produtos gerados
216
+ memory/
217
+ sqlite/universal.db # SQLite FTS5 dos produtos
218
+ 30-projects/ # fichas dos projetos
219
+ specs/ # specs de produto
220
+ .context/ # runbooks GSD de produto
221
+ README.md
222
+ ```
223
+
224
+ ## Documentação
225
+
226
+ - [`DOC-MAP.md`](DOC-MAP.md) — mapa por papel e por tópico (comece aqui)
227
+ - [`docs/processo-projeto.md`](docs/processo-projeto.md) — criar vs atualizar projeto
228
+ - [`docs/fluxo.md`](docs/fluxo.md) — mapa do ciclo CLI-first
229
+ - [`AGENTS.md`](AGENTS.md) — os 6 papéis e a topologia
230
+ - [`memory/90-decisions/`](memory/90-decisions/) — ADRs com rationale
231
+ - [`CHANGELOG.md`](CHANGELOG.md) — histórico
232
+
233
+ ## Convenções
234
+
235
+ - **CLI-first** — sprints, SDD, GSD, handoffs e governança por comando; o front nunca é gate.
236
+ - **ADRs** — toda decisão estrutural vira `memory/90-decisions/NNNN-titulo.md`.
237
+ - **Handoffs** — 7 campos obrigatórios (ADR-0005), gravados no SQLite (ADR-0008).
238
+ - **pt-BR** — comunicação e documentação em português.
239
+
240
+ ## Roadmap
241
+
242
+ - [ ] **Core fase 2** — CLI `forja` embutida nos projetos gerados (hoje herdam harness + instruções)
243
+ - [ ] **Auditoria no SQLite** — promover `forja-runs.jsonl` a tabela consultável via FTS5
244
+ - [ ] **Boilerplates além de NestJS** — o processo é agnóstico de stack; os templates vão atrás
245
+ - [ ] **Docs em inglês** — pt-BR continua sendo a língua do projeto
246
+
247
+ Sugestões? Abra uma issue — feature não-trivial aqui começa por spec, inclusive as suas.
248
+
249
+ ## English summary
250
+
251
+ **Forja** turns coding AI into an engineering team with process and memory: every project starts from a spec, every structural decision becomes an ADR, and nothing is lost between sessions. It orchestrates 6 agent roles through a Spec-Driven + GSD pipeline, keeps hierarchical memory indexed in SQLite FTS5, routes every command through a single audited core CLI (`forja`), and works with Claude, Copilot, Gemini and Codex by design. Documentation is in Brazilian Portuguese — that's part of the project's identity; the CLI and the code are readable regardless.
252
+
253
+ ---
254
+
255
+ <p align="center">
256
+ <strong>A Forja te ajudou a domar seus agentes?</strong><br>
257
+ Uma ⭐ é o que faz o projeto chegar a mais devs que estão pagando o imposto da IA amnésica.
258
+ </p>
259
+
260
+ <p align="center"><sub>Forja (npm: <code>forjajs</code>) · MIT License · <a href="CONTRIBUTING.md">Contribuindo</a></sub></p>