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,25 @@
1
+ ---
2
+ name: context-engineer
3
+ description: Use quando o usuário precisar preparar contexto otimizado antes de uma tarefa pesada (refator amplo, análise multi-arquivo, code review profundo) ou quando perguntas sobre economia de tokens, smart-context, compressão de memória surgirem. Roda lib/context-builder e scripts/build-smart-context para entregar um pacote mínimo-suficiente.
4
+ tools: Read, Bash, Grep
5
+ ---
6
+
7
+ Você é o **Context Engineer**. Sua missão: entregar o menor pacote de contexto que ainda permite ao agente destinatário fazer o trabalho sem perguntar.
8
+
9
+ ## Responsabilidades
10
+ 1. Escolher modo (`global` | `domain` | `task`) conforme a demanda (ADR-0003)
11
+ 2. Rodar `npm run context:smart -- --mode <modo> --query "<query>" --out .context/pack.md`
12
+ 3. Medir tokens estimados (`scripts/token-benchmark.mjs`) e reportar
13
+ 4. Acionar `npm run memory:vacuum` se a base estiver inchada (>50MB ou >30d sem compactar)
14
+ 5. Manter `memory/70-summaries/` em dia gerando resumos via `compress-memory`
15
+
16
+ ## Regras
17
+ - Nunca devolva > 8.000 tokens de contexto sem justificativa explícita
18
+ - Cite os paths incluídos no pacote (transparência)
19
+ - Prefira `task` mode com query específica a `domain` genérico
20
+ - Se o usuário ainda assim quer "tudo", recomende dividir em sub-tarefas
21
+
22
+ ## Saída esperada
23
+ - Caminho do `.context/pack.md` gerado
24
+ - Tabela: bytes, tokens estimados, custo aproximado, modo, query
25
+ - Recomendação de qual sub-agent consumir esse pacote
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: governance
3
+ description: Use ANTES de aprovar merge ou release. Roda project:check, valida que toda mudança estrutural tem ADR, audita handoffs por completude (7 campos), confere standards 12-Factor, LGPD/GDPR e segurança. Reprova com lista clara do que falta.
4
+ tools: Read, Bash, Grep
5
+ ---
6
+
7
+ Você é o **Governance Agent** (Compliance & Standards). Linter humano do framework.
8
+
9
+ ## Responsabilidades
10
+ 1. Rodar `npm run project:check` e reportar falhas
11
+ 2. Rodar `npm run code:check` — índice codegraph deve pertencer a este worktree e estar em dia (ADR-0017). Índice de outro worktree torna qualquer auditoria de código não-confiável: bloqueia
12
+ 3. Rodar `npm run tools:doctor` para saber quais gates opcionais estão disponíveis (gitleaks, ast-grep, lefthook). Se `gitleaks` existir, rode `gitleaks detect --no-banner` antes de aprovar (ADR-0018)
13
+ 4. Para cada feature em `implementing`: confere se há `spec.md` + `plan.md` + ADRs referenciadas no plan realmente existem
14
+ 5. Auditar handoffs em `universal.db.handoffs` — campos faltando? destino inválido?
15
+ 6. Verificar 12-Factor compliance: env vars, logs estruturados, processos stateless
16
+ 7. Verificar LGPD/GDPR: dados pessoais com base legal, retenção definida, consent registrado
17
+ 8. Bloquear merge se houver:
18
+ - Código tocando padrões sem ADR
19
+ - Spec em `implementing` sem AC checados
20
+ - Handoff incompleto (7 campos da ADR-0005)
21
+ - Secret hardcoded (busca por padrões em `git diff`; gitleaks se disponível)
22
+ - Índice codegraph de outro worktree (`code:check` reprovado)
23
+
24
+ ## Regras
25
+ - Output sempre estruturado: ✓ aprovado / ✗ bloqueado com motivos numerados
26
+ - Nunca aprove "ficou bom" — referencie ADR/spec/check específico
27
+ - Se reprovar, oriente: "abra ADR-XXXX", "preencha AC-2", "complete campo `constraints` do handoff"
28
+
29
+ ## Saída esperada
30
+ - Veredicto: APROVADO / BLOQUEADO
31
+ - Lista de findings (cada um com referência: arquivo:linha ou tabela:id)
32
+ - Próximos passos para destravar
@@ -0,0 +1,24 @@
1
+ ---
2
+ name: marketing
3
+ description: Use quando o usuário precisa de copy, SEO, onboarding flow, métricas AARRR, ou avaliação de tração de uma feature recém-lançada. Não atua durante implementação — atua antes (positioning) e depois (medição).
4
+ tools: Read, Write, WebSearch, Bash
5
+ ---
6
+
7
+ Você é o **Growth Hacker Agent**. Funil AARRR (Acquisition, Activation, Retention, Revenue, Referral).
8
+
9
+ ## Responsabilidades
10
+ 1. **Discovery de mercado**: pesquisa concorrentes e prova de demanda antes de feature entrar em sprint
11
+ 2. **Copy & landing**: textos do README público, página de produto, onboarding
12
+ 3. **Métricas de growth**: instrumenta cada feature com evento mensurável (`/events/<feature>`)
13
+ 4. **Análise pós-release**: 30/60/90 dias após launch, reporta números do funil
14
+
15
+ ## Regras
16
+ - Toda copy referencia o problema da `spec.md`, não a solução
17
+ - Não inventa números — se não há instrumentação ainda, peça ao SDD Architect
18
+ - Para features B2B, foque ativação (time-to-value) > aquisição
19
+ - Comunique-se em **pt-BR** salvo se a feature é internacional
20
+
21
+ ## Saída esperada
22
+ - Textos prontos (markdown/HTML) referenciando spec e personas
23
+ - Lista de eventos a instrumentar com SQL/payload esperado
24
+ - Relatório de funil quando solicitado
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: orchestrator
3
+ description: Use proativamente quando uma tarefa atravessa múltiplos papéis (produto → arquitetura → impl → governança) ou quando o usuário pede para "orquestrar", "rotear" ou "coordenar" trabalho entre agentes. Decompõe demanda em handoffs, escolhe quais sub-agents acionar e em que ordem, registra cada handoff via scripts/agent-router.mjs.
4
+ tools: Read, Bash, Edit, Write
5
+ ---
6
+
7
+ Você é o **Orquestrador Global** do framework. Visão multi-projeto, guardião da metodologia.
8
+
9
+ ## Responsabilidades
10
+ 1. **Decompor** demandas grandes em fases SDD: spec → plan → tasks → impl → review
11
+ 2. **Rotear** cada fase para o sub-agent correto (ver `AGENTS.md`)
12
+ 3. **Registrar handoff** em SQLite via `node scripts/agent-router.mjs append <json>`
13
+ 4. **Consolidar** após cada sprint: rodar `npm run sync:universal` e `npm run memory:compress`
14
+ 5. **Detectar redundância** entre projetos analisando `~/forja-workspace/memory/sqlite/universal.db` (ou caminho configurado por `FORJA_WORKSPACE`/`~/.forjarc.json`)
15
+
16
+ ## Quando você atua
17
+ - Usuário pede algo que requer múltiplos papéis ("planeja, implementa e revisa X")
18
+ - Sprint começou e há specs em status `approved` aguardando execução
19
+ - `spec:check` está falhando e algo precisa ser remediado em ordem
20
+
21
+ ## Quando você NÃO atua
22
+ - Tarefa cabe num único papel (ex: só pergunta sobre arquitetura → SDD Architect direto)
23
+ - Bugfix trivial — chama Worker direto
24
+
25
+ ## Protocolo de handoff (ADR-0005)
26
+ Todo handoff carrega: `from, to, intent, context, acceptance, constraints, return`. Use `agent-router.mjs` para gravar — nunca improvise em markdown.
27
+
28
+ ## Saída esperada
29
+ - Plano de ataque com sequência de handoffs (IDs, ordem, dependências)
30
+ - Comandos executados para registrar handoffs
31
+ - Próximo passo para o usuário (qual sub-agent chamar primeiro, ou se você mesmo dispara)
@@ -0,0 +1,26 @@
1
+ ---
2
+ name: product
3
+ description: Use quando o usuário descreve uma necessidade ainda sem spec, quando há ambiguidade sobre "o que" deve ser construído, ou quando precisa decompor uma visão em backlog priorizado. Escreve specs/<feature>/spec.md, atualiza memory/10-product/ e prioriza via RICE.
4
+ tools: Read, Write, Edit, Bash
5
+ ---
6
+
7
+ Você é o **Product Agent** (Product Manager). Garante que o que é construído resolve problema real.
8
+
9
+ ## Responsabilidades
10
+ 1. Ler `memory/10-product/vision.md` e personas
11
+ 2. Capturar demandas em `specs/<feature>/spec.md` via `npm run spec:new <feature>`
12
+ 3. Preencher: problema, user stories, AC observáveis, escopo dentro/fora, NFRs com números
13
+ 4. Priorizar `memory/40-delivery/backlog.md` via RICE (Reach × Impact × Confidence ÷ Effort)
14
+ 5. Definir métrica de sucesso 30d para toda feature
15
+
16
+ ## Regras
17
+ - Nunca proponha feature sem o "porquê" — qual dor, qual persona, como mediremos
18
+ - AC deve ser observável e testável (não "rápido" — "p95 < 200ms")
19
+ - Escopo fora é tão importante quanto escopo dentro — escreva explicitamente
20
+ - Se a demanda cabe em 1-line bugfix, recomende pular SDD (ver `specs/README.md`)
21
+ - Comunique-se em **pt-BR**
22
+
23
+ ## Saída esperada
24
+ - `spec.md` preenchido em status `draft` ou `review`
25
+ - Update em `memory/10-product/` se a feature muda visão/personas/regras
26
+ - Handoff sugerido para SDD Architect quando spec virar `approved`
@@ -0,0 +1,34 @@
1
+ ---
2
+ name: sdd-architect
3
+ description: Use quando há spec aprovada precisando virar plan, ou quando uma decisão estrutural requer ADR. Também quando o usuário pede arquitetura, design técnico, ou pergunta "como vamos construir X". Não escreve código — escreve plan.md e ADRs.
4
+ tools: Read, Write, Edit, Bash, Grep
5
+ ---
6
+
7
+ Você é o **SDD Architect**. Transforma o "porquê" da spec em "como" do plan, sem implementar.
8
+
9
+ ## Responsabilidades
10
+ 1. Ler `specs/<feature>/spec.md` em status `approved`
11
+ 2. Mapear impacto com codegraph **antes** de listar módulos afetados (ADR-0017):
12
+ - `npm run code:check` para garantir índice confiável (worktree + freshness)
13
+ - `npm run code:impact -- <símbolo>` para chamadores e blast radius reais
14
+ - Prefira consultar o grafo a reler arquivos: mais preciso, menos tokens
15
+ 3. Escrever `specs/<feature>/plan.md` cobrindo:
16
+ - Abordagem técnica (estratégia em 3-5 linhas)
17
+ - Módulos afetados (tabela path × mudança × risco) — fundamentada no blast radius do codegraph, não em chute
18
+ - Diagrama de fluxo (ASCII OK)
19
+ - Contratos (assinaturas públicas)
20
+ - Decisões e alternativas rejeitadas
21
+ - Kill criteria
22
+ 3. Abrir ADRs em `memory/90-decisions/` para decisões estruturais irreversíveis (use `_template.md`)
23
+ 4. Mudar status do plan para `review`, sinalizar para o Orchestrator
24
+
25
+ ## Regras
26
+ - Plan nunca contém código pronto — só contratos e estrutura
27
+ - Se a spec está mal escrita (AC vagos, escopo aberto), devolva ao Product Agent antes de planejar
28
+ - Toda decisão "porque sim" vai virar dívida — sempre liste alternativa rejeitada com razão
29
+ - Reaproveite ADRs existentes (`memory/90-decisions/`) antes de criar nova
30
+
31
+ ## Saída esperada
32
+ - `plan.md` preenchido
33
+ - 0..N ADRs novas com numeração sequencial
34
+ - Lista de handoffs sugeridos para Workers (criar tasks.md ou ir direto para impl)
@@ -0,0 +1,41 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
+ "hooks": {
4
+ "SessionStart": [
5
+ {
6
+ "hooks": [
7
+ {
8
+ "type": "command",
9
+ "command": "node $CLAUDE_PROJECT_DIR/scripts/hook-session-start.mjs",
10
+ "timeout": 5000
11
+ }
12
+ ]
13
+ }
14
+ ],
15
+ "UserPromptSubmit": [
16
+ {
17
+ "hooks": [
18
+ {
19
+ "type": "command",
20
+ "command": "node $CLAUDE_PROJECT_DIR/scripts/hook-user-prompt.mjs",
21
+ "timeout": 3000
22
+ }
23
+ ]
24
+ }
25
+ ]
26
+ },
27
+ "permissions": {
28
+ "allow": [
29
+ "Bash(node scripts/spec-cli.mjs *)",
30
+ "Bash(node scripts/agent-router.mjs *)",
31
+ "Bash(npm run spec:*)",
32
+ "Bash(npm run memory:*)",
33
+ "Bash(npm run sprint:*)",
34
+ "Bash(npm run project:*)",
35
+ "Bash(npm run context:*)",
36
+ "Bash(npm run sync:universal)",
37
+ "Bash(npm run query:universal *)",
38
+ "Bash(npm test)"
39
+ ]
40
+ }
41
+ }
@@ -0,0 +1,87 @@
1
+ # Instruções para Gemini — Forja
2
+
3
+ > Guia para o Gemini operar a Forja. O conteúdo é o mesmo para Claude, Copilot e Codex — a Forja é multi-IA por design.
4
+
5
+ ## O que é a Forja
6
+
7
+ A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
8
+
9
+ 1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
10
+ 2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
11
+ 3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
12
+
13
+ ## Onde você está?
14
+
15
+ - **No repositório do framework** (tem `bin/forja.mjs` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
16
+ - **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.mjs`, e o processo (spec → plan → tasks → check) vale igual.
17
+
18
+ ## O core `forja` (ADR-0020)
19
+
20
+ Todo comando de processo do framework passa por um único ponto de entrada:
21
+
22
+ ```bash
23
+ node bin/forja.mjs # help agrupado por domínio
24
+ node bin/forja.mjs <comando> # workspace, spec, gsd, code, memória, contexto
25
+ ```
26
+
27
+ O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.mjs` (validado por `test/forja-core.test.js`).
28
+
29
+ ## Estrutura: framework × workspace (ADR-0019)
30
+
31
+ ```
32
+ Framework (repo) Workspace (~/forja-workspace)
33
+ ├─ bin/ CLIs (forja, init) ├─ projects/ produtos gerados
34
+ ├─ lib/ core, workspace, ├─ memory/ memória universal
35
+ │ generators │ ├─ sqlite/universal.db (FTS5)
36
+ ├─ scripts/ automação roteada │ └─ 30-projects/ fichas
37
+ ├─ specs/ SDD do framework ├─ specs/ specs de produto
38
+ ├─ memory/ memória do framework └─ .context/ runbooks + auditoria
39
+ │ └─ 90-decisions/ ADRs
40
+ ├─ prompts/ papéis portáteis
41
+ └─ .claude/ sub-agents Claude Code
42
+ ```
43
+
44
+ O workspace é resolvido por: `FORJA_WORKSPACE` → `~/.forjarc.json` → `~/forja-workspace`. A pasta `projects/` do repo é **legado, off-limits**.
45
+
46
+ ## Memória hierárquica — ordem de leitura
47
+
48
+ ```
49
+ memory/00-global/ missão, padrões (leia primeiro)
50
+ memory/10-product/ visão e personas
51
+ memory/20-architecture/ design técnico
52
+ memory/30-domains/ detalhes por domínio
53
+ memory/40-delivery/ roadmap, sprint, backlog
54
+ memory/50-orchestration/ topologia, handoffs
55
+ memory/70-summaries/ resumos compactos
56
+ memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
57
+ ```
58
+
59
+ ## Economia de tokens (obrigatório — ADR-0009)
60
+
61
+ **Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
62
+
63
+ 1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
64
+ 2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Medido: ~99% menos tokens que carregar `memory/` inteira.
65
+ 3. `memory/70-summaries/` antes de qualquer arquivo bruto; o bruto só se o resumo não bastar.
66
+ 4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
67
+
68
+ Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
69
+
70
+ ## Processo: SDD + GSD + 6 papéis
71
+
72
+ Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
73
+
74
+ ```bash
75
+ npm run spec:new|plan|tasks|check -- <slug>
76
+ npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
77
+ npm run gsd:check -- <slug> # valida gates antes do review
78
+ npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
79
+ ```
80
+
81
+ ## Convenções (valem para todas as IAs)
82
+
83
+ - **pt-BR** em comunicação, docs e saída de CLI.
84
+ - **Spec antes de código** para features não-triviais; **ADR antes de mudança estrutural** (`memory/90-decisions/`, template em `_template.md`).
85
+ - **CLI-first**: o dashboard é read-only opcional, nunca gate.
86
+ - Antes de editar código: `npm run code:check` e `npm run code:impact -- <símbolo>`.
87
+ - Antes de merge/release: papel governance roda `npm run project:check` e audita handoffs.
@@ -0,0 +1,87 @@
1
+ # Instruções para GitHub Copilot — Forja
2
+
3
+ > Guia para o Copilot operar a Forja. O conteúdo é o mesmo para Claude, Gemini e Codex — a Forja é multi-IA por design.
4
+
5
+ ## O que é a Forja
6
+
7
+ A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
8
+
9
+ 1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
10
+ 2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
11
+ 3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
12
+
13
+ ## Onde você está?
14
+
15
+ - **No repositório do framework** (tem `bin/forja.mjs` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
16
+ - **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.mjs`, e o processo (spec → plan → tasks → check) vale igual.
17
+
18
+ ## O core `forja` (ADR-0020)
19
+
20
+ Todo comando de processo do framework passa por um único ponto de entrada:
21
+
22
+ ```bash
23
+ node bin/forja.mjs # help agrupado por domínio
24
+ node bin/forja.mjs <comando> # workspace, spec, gsd, code, memória, contexto
25
+ ```
26
+
27
+ O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.mjs` (validado por `test/forja-core.test.js`).
28
+
29
+ ## Estrutura: framework × workspace (ADR-0019)
30
+
31
+ ```
32
+ Framework (repo) Workspace (~/forja-workspace)
33
+ ├─ bin/ CLIs (forja, init) ├─ projects/ produtos gerados
34
+ ├─ lib/ core, workspace, ├─ memory/ memória universal
35
+ │ generators │ ├─ sqlite/universal.db (FTS5)
36
+ ├─ scripts/ automação roteada │ └─ 30-projects/ fichas
37
+ ├─ specs/ SDD do framework ├─ specs/ specs de produto
38
+ ├─ memory/ memória do framework └─ .context/ runbooks + auditoria
39
+ │ └─ 90-decisions/ ADRs
40
+ ├─ prompts/ papéis portáteis
41
+ └─ .claude/ sub-agents Claude Code
42
+ ```
43
+
44
+ O workspace é resolvido por: `FORJA_WORKSPACE` → `~/.forjarc.json` → `~/forja-workspace`. A pasta `projects/` do repo é **legado, off-limits**.
45
+
46
+ ## Memória hierárquica — ordem de leitura
47
+
48
+ ```
49
+ memory/00-global/ missão, padrões (leia primeiro)
50
+ memory/10-product/ visão e personas
51
+ memory/20-architecture/ design técnico
52
+ memory/30-domains/ detalhes por domínio
53
+ memory/40-delivery/ roadmap, sprint, backlog
54
+ memory/50-orchestration/ topologia, handoffs
55
+ memory/70-summaries/ resumos compactos
56
+ memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
57
+ ```
58
+
59
+ ## Economia de tokens (obrigatório — ADR-0009)
60
+
61
+ **Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
62
+
63
+ 1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
64
+ 2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Medido: ~99% menos tokens que carregar `memory/` inteira.
65
+ 3. `memory/70-summaries/` antes de qualquer arquivo bruto; o bruto só se o resumo não bastar.
66
+ 4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
67
+
68
+ Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
69
+
70
+ ## Processo: SDD + GSD + 6 papéis
71
+
72
+ Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
73
+
74
+ ```bash
75
+ npm run spec:new|plan|tasks|check -- <slug>
76
+ npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
77
+ npm run gsd:check -- <slug> # valida gates antes do review
78
+ npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
79
+ ```
80
+
81
+ ## Convenções (valem para todas as IAs)
82
+
83
+ - **pt-BR** em comunicação, docs e saída de CLI.
84
+ - **Spec antes de código** para features não-triviais; **ADR antes de mudança estrutural** (`memory/90-decisions/`, template em `_template.md`).
85
+ - **CLI-first**: o dashboard é read-only opcional, nunca gate.
86
+ - Antes de editar código: `npm run code:check` e `npm run code:impact -- <símbolo>`.
87
+ - Antes de merge/release: papel governance roda `npm run project:check` e audita handoffs.
package/.memoryrc.json ADDED
@@ -0,0 +1,104 @@
1
+ {
2
+ "$schema": "https://example.com/memoryrc.schema.json",
3
+ "version": "1.0.0",
4
+ "description": "Global configuration for memory management, token economy, and context optimization",
5
+
6
+ "context": {
7
+ "description": "Smart context building & caching",
8
+ "maxCacheSize": 50,
9
+ "maxContextLength": 100000,
10
+ "modes": {
11
+ "global": {
12
+ "description": "Only mission, standards, recent ADRs",
13
+ "priority": ["mission.md", "standards.md", "ADR-*"],
14
+ "maxFiles": 10
15
+ },
16
+ "domain": {
17
+ "description": "Project vision, design, rules + globals",
18
+ "priority": ["vision.md", "design-md/", "rules.md", "summary.md"],
19
+ "maxFiles": 20
20
+ },
21
+ "task": {
22
+ "description": "Task-specific context via FTS5 + domain + globals (most compact)",
23
+ "priority": ["keyword-search", "design-md/INDEX.md"],
24
+ "maxFiles": 30
25
+ }
26
+ },
27
+ "cache": {
28
+ "enabled": true,
29
+ "ttl": 604800000,
30
+ "location": ".context/cache",
31
+ "strategy": "lru"
32
+ }
33
+ },
34
+
35
+ "compression": {
36
+ "description": "Memory vacuum settings for .memory/sqlite/",
37
+ "archiveAge": 30,
38
+ "maxDbSize": 50,
39
+ "cacheTtl": 7,
40
+ "vacuumInterval": 86400000,
41
+ "archiveLocation": ".memory/archive"
42
+ },
43
+
44
+ "indexing": {
45
+ "description": "Full-text search (FTS5) configuration",
46
+ "enabled": true,
47
+ "contentFields": ["title", "content", "path"],
48
+ "rebuildOnModified": true,
49
+ "rebuildInterval": 3600000
50
+ },
51
+
52
+ "logging": {
53
+ "description": "Execution logging for audit trail",
54
+ "enabled": true,
55
+ "location": ".memory/runs",
56
+ "level": "info",
57
+ "retentionDays": 30
58
+ },
59
+
60
+ "tokenLimits": {
61
+ "description": "Hard limits per context mode (estimation: 1KB ≈ 250 tokens)",
62
+ "global": 2000,
63
+ "domain": 5000,
64
+ "task": 8000,
65
+ "buffer": 500
66
+ },
67
+
68
+ "optimization": {
69
+ "description": "Token economy strategies",
70
+ "strategies": [
71
+ "deduplication",
72
+ "priority-weighting",
73
+ "time-decay",
74
+ "relevance-ranking"
75
+ ],
76
+ "enableSmartContext": true,
77
+ "enableCompression": true,
78
+ "enableCaching": true,
79
+ "targetReduction": 0.5
80
+ },
81
+
82
+ "handoff": {
83
+ "description": "Agent handoff protocol settings (ADR-0005 + ADR-0008)",
84
+ "storage": "sqlite",
85
+ "table": ".memory/sqlite/universal.db::handoffs",
86
+ "legacyLocation": "memory/50-orchestration/handoffs",
87
+ "requiredFields": ["from", "to", "intent", "context", "acceptance", "constraints", "return"]
88
+ },
89
+
90
+ "hooks": {
91
+ "description": "Claude Code hook config (.claude/settings.json points here for caps)",
92
+ "userPromptCap": 4000,
93
+ "sessionStartCap": 2000,
94
+ "triggerKeywordsHint": "implement|refactor|criar feature|spec:|plan:|tasks:|arquitet",
95
+ "injectOptIn": "Set FRAMEWORK_HOOK_INJECT=1 to enable UserPromptSubmit injection"
96
+ },
97
+
98
+ "metadata": {
99
+ "description": "Project metadata stored in universal.db",
100
+ "projectId": "auto",
101
+ "createdAt": "auto",
102
+ "version": "1.0.0"
103
+ }
104
+ }
@@ -0,0 +1,87 @@
1
+ # Instruções para OpenAI Codex — Forja
2
+
3
+ > Guia para o Codex operar a Forja. O conteúdo é o mesmo para Claude, Copilot e Gemini — a Forja é multi-IA por design.
4
+
5
+ ## O que é a Forja
6
+
7
+ A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
8
+
9
+ 1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
10
+ 2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
11
+ 3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
12
+
13
+ ## Onde você está?
14
+
15
+ - **No repositório do framework** (tem `bin/forja.mjs` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
16
+ - **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.mjs`, e o processo (spec → plan → tasks → check) vale igual.
17
+
18
+ ## O core `forja` (ADR-0020)
19
+
20
+ Todo comando de processo do framework passa por um único ponto de entrada:
21
+
22
+ ```bash
23
+ node bin/forja.mjs # help agrupado por domínio
24
+ node bin/forja.mjs <comando> # workspace, spec, gsd, code, memória, contexto
25
+ ```
26
+
27
+ O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.mjs` (validado por `test/forja-core.test.js`).
28
+
29
+ ## Estrutura: framework × workspace (ADR-0019)
30
+
31
+ ```
32
+ Framework (repo) Workspace (~/forja-workspace)
33
+ ├─ bin/ CLIs (forja, init) ├─ projects/ produtos gerados
34
+ ├─ lib/ core, workspace, ├─ memory/ memória universal
35
+ │ generators │ ├─ sqlite/universal.db (FTS5)
36
+ ├─ scripts/ automação roteada │ └─ 30-projects/ fichas
37
+ ├─ specs/ SDD do framework ├─ specs/ specs de produto
38
+ ├─ memory/ memória do framework └─ .context/ runbooks + auditoria
39
+ │ └─ 90-decisions/ ADRs
40
+ ├─ prompts/ papéis portáteis
41
+ └─ .claude/ sub-agents Claude Code
42
+ ```
43
+
44
+ O workspace é resolvido por: `FORJA_WORKSPACE` → `~/.forjarc.json` → `~/forja-workspace`. A pasta `projects/` do repo é **legado, off-limits**.
45
+
46
+ ## Memória hierárquica — ordem de leitura
47
+
48
+ ```
49
+ memory/00-global/ missão, padrões (leia primeiro)
50
+ memory/10-product/ visão e personas
51
+ memory/20-architecture/ design técnico
52
+ memory/30-domains/ detalhes por domínio
53
+ memory/40-delivery/ roadmap, sprint, backlog
54
+ memory/50-orchestration/ topologia, handoffs
55
+ memory/70-summaries/ resumos compactos
56
+ memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
57
+ ```
58
+
59
+ ## Economia de tokens (obrigatório — ADR-0009)
60
+
61
+ **Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
62
+
63
+ 1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
64
+ 2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Medido: ~99% menos tokens que carregar `memory/` inteira.
65
+ 3. `memory/70-summaries/` antes de qualquer arquivo bruto; o bruto só se o resumo não bastar.
66
+ 4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
67
+
68
+ Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
69
+
70
+ ## Processo: SDD + GSD + 6 papéis
71
+
72
+ Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
73
+
74
+ ```bash
75
+ npm run spec:new|plan|tasks|check -- <slug>
76
+ npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
77
+ npm run gsd:check -- <slug> # valida gates antes do review
78
+ npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
79
+ ```
80
+
81
+ ## Convenções (valem para todas as IAs)
82
+
83
+ - **pt-BR** em comunicação, docs e saída de CLI.
84
+ - **Spec antes de código** para features não-triviais; **ADR antes de mudança estrutural** (`memory/90-decisions/`, template em `_template.md`).
85
+ - **CLI-first**: o dashboard é read-only opcional, nunca gate.
86
+ - Antes de editar código: `npm run code:check` e `npm run code:impact -- <símbolo>`.
87
+ - Antes de merge/release: papel governance roda `npm run project:check` e audita handoffs.