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,546 @@
1
+ # 💻 Exemplos de Código - Quick Reference
2
+
3
+ Snippets prontos para copiar/colar na implementação de Fase 1.
4
+
5
+ ---
6
+
7
+ ## 🔒 SEC-001: Validação em DTOs
8
+
9
+ ### Arquivo: `backend/src/common/dto/create-user.dto.ts`
10
+
11
+ ```typescript
12
+ import { IsString, IsEmail, IsNotEmpty, MinLength, MaxLength } from 'class-validator';
13
+
14
+ export class CreateUserDto {
15
+ @IsNotEmpty({ message: 'Nome é obrigatório' })
16
+ @IsString()
17
+ @MinLength(3, { message: 'Nome deve ter no mínimo 3 caracteres' })
18
+ @MaxLength(100)
19
+ name: string;
20
+
21
+ @IsNotEmpty()
22
+ @IsEmail({}, { message: 'Email inválido' })
23
+ email: string;
24
+
25
+ @IsNotEmpty()
26
+ @MinLength(8, { message: 'Senha deve ter no mínimo 8 caracteres' })
27
+ @MaxLength(255)
28
+ password: string;
29
+ }
30
+ ```
31
+
32
+ ### Arquivo: `backend/src/app.controller.ts`
33
+
34
+ ```typescript
35
+ import { Controller, Get, Post, Body, HttpException, HttpStatus } from '@nestjs/common';
36
+ import { CreateUserDto } from './common/dto/create-user.dto';
37
+ import { AppService } from './app.service';
38
+
39
+ @Controller()
40
+ export class AppController {
41
+ constructor(private readonly appService: AppService) {}
42
+
43
+ @Get('health')
44
+ health(): { status: string } {
45
+ return this.appService.health();
46
+ }
47
+
48
+ @Post('users')
49
+ createUser(@Body() dto: CreateUserDto) {
50
+ try {
51
+ return {
52
+ id: 'user-' + Date.now(),
53
+ ...dto,
54
+ createdAt: new Date().toISOString()
55
+ };
56
+ } catch (error) {
57
+ throw new HttpException(
58
+ 'Erro ao criar usuário',
59
+ HttpStatus.INTERNAL_SERVER_ERROR
60
+ );
61
+ }
62
+ }
63
+ }
64
+ ```
65
+
66
+ ### Teste (com cURL)
67
+
68
+ ```bash
69
+ # ✅ Sucesso
70
+ curl -X POST http://localhost:3000/api/users \
71
+ -H "Content-Type: application/json" \
72
+ -d '{
73
+ "name": "João Silva",
74
+ "email": "joao@example.com",
75
+ "password": "senha123456"
76
+ }'
77
+
78
+ # ❌ Erro: Email inválido
79
+ curl -X POST http://localhost:3000/api/users \
80
+ -H "Content-Type: application/json" \
81
+ -d '{
82
+ "name": "João",
83
+ "email": "invalid-email",
84
+ "password": "senha123456"
85
+ }'
86
+ # Resposta: 400 Bad Request
87
+ ```
88
+
89
+ ---
90
+
91
+ ## 🚦 SEC-002: Rate-Limiting Middleware
92
+
93
+ ### Arquivo: `backend/src/middleware/rate-limit.middleware.ts`
94
+
95
+ ```typescript
96
+ import { Injectable, NestMiddleware, HttpException, HttpStatus } from '@nestjs/common';
97
+ import { Request, Response, NextFunction } from 'express';
98
+
99
+ interface RateLimitRecord {
100
+ count: number;
101
+ resetAt: number;
102
+ }
103
+
104
+ @Injectable()
105
+ export class RateLimitMiddleware implements NestMiddleware {
106
+ private store = new Map<string, RateLimitRecord>();
107
+ private readonly MAX_REQUESTS = 100;
108
+ private readonly WINDOW_MS = 60 * 1000; // 1 minuto
109
+
110
+ use(req: Request, res: Response, next: NextFunction) {
111
+ const ip = this.getClientIp(req);
112
+ const now = Date.now();
113
+
114
+ if (!this.store.has(ip)) {
115
+ this.store.set(ip, { count: 1, resetAt: now + this.WINDOW_MS });
116
+ return next();
117
+ }
118
+
119
+ const record = this.store.get(ip)!;
120
+
121
+ // Reset window se expirou
122
+ if (now > record.resetAt) {
123
+ this.store.set(ip, { count: 1, resetAt: now + this.WINDOW_MS });
124
+ return next();
125
+ }
126
+
127
+ // Excedeu limite
128
+ if (record.count >= this.MAX_REQUESTS) {
129
+ throw new HttpException(
130
+ `Rate limit exceeded. Max ${this.MAX_REQUESTS} requests per minute.`,
131
+ HttpStatus.TOO_MANY_REQUESTS
132
+ );
133
+ }
134
+
135
+ record.count++;
136
+ res.setHeader('X-RateLimit-Remaining', this.MAX_REQUESTS - record.count);
137
+ next();
138
+ }
139
+
140
+ private getClientIp(req: Request): string {
141
+ return (
142
+ (req.headers['x-forwarded-for'] as string)?.split(',')[0].trim() ||
143
+ req.socket.remoteAddress ||
144
+ 'unknown'
145
+ );
146
+ }
147
+ }
148
+ ```
149
+
150
+ ### Arquivo: `backend/src/app.module.ts`
151
+
152
+ ```typescript
153
+ import { Module, MiddlewareConsumer, NestModule } from '@nestjs/common';
154
+ import { AppController } from './app.controller';
155
+ import { AppService } from './app.service';
156
+ import { RateLimitMiddleware } from './middleware/rate-limit.middleware';
157
+
158
+ @Module({
159
+ imports: [],
160
+ controllers: [AppController],
161
+ providers: [AppService]
162
+ })
163
+ export class AppModule implements NestModule {
164
+ configure(consumer: MiddlewareConsumer) {
165
+ consumer
166
+ .apply(RateLimitMiddleware)
167
+ .forRoutes('*'); // Aplicar a todas as rotas
168
+ }
169
+ }
170
+ ```
171
+
172
+ ---
173
+
174
+ ## 📝 OBS-001: Logs Estruturados em JSON
175
+
176
+ ### Arquivo: `backend/src/common/decorators/log.decorator.ts`
177
+
178
+ ```typescript
179
+ import { SetMetadata } from '@nestjs/common';
180
+
181
+ export interface LogMetadata {
182
+ agent: string;
183
+ action: string;
184
+ }
185
+
186
+ export const LogStructured = (agent: string, action: string) =>
187
+ SetMetadata('log', { agent, action });
188
+ ```
189
+
190
+ ### Arquivo: `backend/src/common/interceptors/logging.interceptor.ts`
191
+
192
+ ```typescript
193
+ import { Injectable, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
194
+ import { Observable } from 'rxjs';
195
+ import { tap } from 'rxjs/operators';
196
+ import { Reflector } from '@nestjs/core';
197
+
198
+ interface StructuredLog {
199
+ timestamp: string;
200
+ level: string;
201
+ agent: string;
202
+ action: string;
203
+ duration_ms: number;
204
+ success: boolean;
205
+ error?: string;
206
+ }
207
+
208
+ @Injectable()
209
+ export class LoggingInterceptor implements NestInterceptor {
210
+ constructor(private reflector: Reflector) {}
211
+
212
+ intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
213
+ const request = context.switchToHttp().getRequest();
214
+ const handler = context.getHandler();
215
+ const logMetadata = this.reflector.get<any>('log', handler);
216
+
217
+ const startTime = Date.now();
218
+
219
+ return next.handle().pipe(
220
+ tap(
221
+ (data) => this.logStructured(logMetadata, startTime, true, null),
222
+ (error) => this.logStructured(logMetadata, startTime, false, error)
223
+ )
224
+ );
225
+ }
226
+
227
+ private logStructured(
228
+ metadata: any,
229
+ startTime: number,
230
+ success: boolean,
231
+ error: any
232
+ ) {
233
+ const duration = Date.now() - startTime;
234
+
235
+ const log: StructuredLog = {
236
+ timestamp: new Date().toISOString(),
237
+ level: success ? 'info' : 'error',
238
+ agent: metadata?.agent || 'unknown',
239
+ action: metadata?.action || 'unknown',
240
+ duration_ms: duration,
241
+ success,
242
+ };
243
+
244
+ if (error) {
245
+ log.error = error.message;
246
+ }
247
+
248
+ console.log(JSON.stringify(log));
249
+ }
250
+ }
251
+ ```
252
+
253
+ ### Uso em Controller
254
+
255
+ ```typescript
256
+ import { Controller, Post, Body } from '@nestjs/common';
257
+ import { LogStructured } from './common/decorators/log.decorator';
258
+ import { CreateUserDto } from './common/dto/create-user.dto';
259
+
260
+ @Controller('users')
261
+ export class UserController {
262
+ @Post()
263
+ @LogStructured('backend-nest', 'create_user')
264
+ create(@Body() dto: CreateUserDto) {
265
+ return { id: 'user-1', ...dto };
266
+ }
267
+ }
268
+ ```
269
+
270
+ ### Saída de Log
271
+
272
+ ```json
273
+ {
274
+ "timestamp": "2026-04-21T09:51:33.423Z",
275
+ "level": "info",
276
+ "agent": "backend-nest",
277
+ "action": "create_user",
278
+ "duration_ms": 45,
279
+ "success": true
280
+ }
281
+ ```
282
+
283
+ ---
284
+
285
+ ## 🧠 AGENT-002: Prompt com Few-Shot
286
+
287
+ ### Template: `prompts/worker-create-endpoint.md`
288
+
289
+ ```markdown
290
+ # TASK-001: Implementar Endpoint GET /users/:id
291
+
292
+ ## 👤 Contexto (Quem você é)
293
+ Você é um especialista em NestJS e arquitetura REST API.
294
+ Objetivo: Criar endpoint seguro, validado e com cobertura de teste.
295
+ Nível: Senior (decisões arquiteturais esperadas)
296
+
297
+ ## 📥 Entrada
298
+ ```json
299
+ {
300
+ "task_id": "TASK-001",
301
+ "endpoint": "GET /users/:id",
302
+ "repository": "user-repository.ts",
303
+ "dto_out": "GetUserResponseDto",
304
+ "validations": ["id must be UUID", "user must exist"],
305
+ "owner_file": "src/users/"
306
+ }
307
+ ```
308
+
309
+ Restrições:
310
+ - ID deve ser UUID válido
311
+ - Usar DTOs para response
312
+ - Retornar 404 se usuário não existe
313
+ - Sem dados sensíveis (senha, etc)
314
+
315
+ ## 📤 Saída Esperada
316
+ ```typescript
317
+ // Arquivo: src/users/users.controller.ts
318
+ @Get(':id')
319
+ async getUser(@Param('id', ParseUUIDPipe) id: string) {
320
+ return this.userService.findOne(id);
321
+ }
322
+
323
+ // Arquivo: src/users/dtos/get-user-response.dto.ts
324
+ export class GetUserResponseDto {
325
+ id: string;
326
+ name: string;
327
+ email: string;
328
+ createdAt: Date;
329
+ }
330
+
331
+ // Arquivo: src/users/users.controller.spec.ts
332
+ describe('GET /users/:id', () => {
333
+ it('should return user when exists', async () => {
334
+ const result = await controller.getUser(validUUID);
335
+ expect(result.id).toBe(validUUID);
336
+ });
337
+
338
+ it('should throw 404 when user not found', async () => {
339
+ await expect(controller.getUser(nonExistentUUID))
340
+ .rejects.toThrow(NotFoundException);
341
+ });
342
+ });
343
+ ```
344
+
345
+ Validação:
346
+ - [ ] Código TypeScript válido
347
+ - [ ] DTOs com @IsUUID()
348
+ - [ ] 2 testes (sucesso + erro)
349
+ - [ ] Sem dados sensíveis na response
350
+ - [ ] Documentado (JSDoc)
351
+
352
+ ## 🚫 Proibições (MUITO IMPORTANTE)
353
+ - ❌ NUNCA retornar senha ou dados sensíveis
354
+ - ❌ NUNCA criar novo roteamento sem passar por app.controller
355
+ - ❌ NUNCA ignorar validação de UUID
356
+ - ❌ NÃO adicione dependências novas sem ADR
357
+
358
+ ## ✅ Checklist Final
359
+ - [ ] Arquivo criado em `src/users/`
360
+ - [ ] DTOs implementados e validados
361
+ - [ ] Controller tem rota GET
362
+ - [ ] Tests estão passando (npm test)
363
+ - [ ] Sem build errors (npm run build)
364
+ - [ ] Sem lint errors (npm run lint)
365
+ - [ ] Documentação atualizada (docstring)
366
+ - [ ] Handoff pronto em memory/50-orchestration/handoffs/
367
+
368
+ ---
369
+
370
+ ## 📚 Exemplos
371
+
372
+ ### Exemplo 1: Sucesso
373
+ **Input**: GET /users/550e8400-e29b-41d4-a716-446655440000
374
+ **Output**:
375
+ ```json
376
+ {
377
+ "id": "550e8400-e29b-41d4-a716-446655440000",
378
+ "name": "João Silva",
379
+ "email": "joao@example.com",
380
+ "createdAt": "2026-04-21T09:51:33.423Z"
381
+ }
382
+ ```
383
+
384
+ ### Exemplo 2: Erro (ID inválido)
385
+ **Input**: GET /users/invalid-id
386
+ **Output**: 400 Bad Request - "Validation failed for param id"
387
+
388
+ ### Exemplo 3: Erro (User não existe)
389
+ **Input**: GET /users/550e8400-e29b-41d4-a716-999999999999
390
+ **Output**: 404 Not Found - "User not found"
391
+ ```
392
+
393
+ ---
394
+
395
+ ## 🤖 AI-OPT-001: Model Config YAML
396
+
397
+ ### Arquivo: `.context/model-config.yml`
398
+
399
+ ```yaml
400
+ models:
401
+ claude-opus:
402
+ max_tokens: 100000
403
+ priority_sections:
404
+ - memory/00-global/mission.md
405
+ - memory/00-global/standards.md
406
+ - memory/20-architecture/backend.md
407
+ - memory/40-delivery/current-sprint.md
408
+ - memory/70-summaries/global-summary.md
409
+ prompt_style: structured
410
+ context_multiplier: 1.0
411
+
412
+ gpt-4-turbo:
413
+ max_tokens: 8000
414
+ priority_sections:
415
+ - memory/00-global/mission.md
416
+ - memory/40-delivery/current-sprint.md
417
+ prompt_style: concise
418
+ context_multiplier: 0.3
419
+
420
+ gemini-pro:
421
+ max_tokens: 32000
422
+ priority_sections:
423
+ - memory/00-global/mission.md
424
+ - memory/20-architecture/backend.md
425
+ - memory/70-summaries/global-summary.md
426
+ prompt_style: narrative
427
+ context_multiplier: 0.7
428
+
429
+ compression_levels:
430
+ minimal:
431
+ tokens: 500
432
+ includes: [mission.md, standards.md, current-sprint.md]
433
+ standard:
434
+ tokens: 2000
435
+ includes: [level-minimal, 20-architecture/*, summaries/]
436
+ full:
437
+ tokens: 8000
438
+ includes: [all]
439
+ ```
440
+
441
+ ---
442
+
443
+ ## 💾 MEM-001: 3 Níveis de Compactação
444
+
445
+ ### Script: `scripts/build-context-pack-smart.mjs`
446
+
447
+ ```javascript
448
+ import fs from 'node:fs';
449
+ import path from 'node:path';
450
+
451
+ const model = process.argv[2] || 'standard'; // minimal, standard, full
452
+
453
+ const levels = {
454
+ minimal: {
455
+ maxTokens: 500,
456
+ files: [
457
+ 'memory/00-global/mission.md',
458
+ 'memory/00-global/standards.md',
459
+ 'memory/40-delivery/current-sprint.md'
460
+ ]
461
+ },
462
+ standard: {
463
+ maxTokens: 2000,
464
+ files: [
465
+ ...levels.minimal.files,
466
+ 'memory/20-architecture/system-overview.md',
467
+ 'memory/20-architecture/backend.md',
468
+ 'memory/70-summaries/global-summary.md'
469
+ ]
470
+ },
471
+ full: {
472
+ maxTokens: 8000,
473
+ files: [
474
+ ...levels.standard.files,
475
+ 'memory/10-product/vision.md',
476
+ 'memory/30-domains/auth/rules.md',
477
+ 'memory/30-domains/billing/rules.md'
478
+ ]
479
+ }
480
+ };
481
+
482
+ const config = levels[model];
483
+ if (!config) {
484
+ console.error(`Level não reconhecido: ${model}`);
485
+ process.exit(1);
486
+ }
487
+
488
+ let content = `# Context Pack (${model.toUpperCase()})\n\n`;
489
+ let tokenCount = 0;
490
+
491
+ for (const file of config.files) {
492
+ const path = `../../${file}`;
493
+ if (!fs.existsSync(path)) continue;
494
+
495
+ const data = fs.readFileSync(path, 'utf-8');
496
+ const tokens = Math.ceil(data.length / 4);
497
+
498
+ if (tokenCount + tokens > config.maxTokens) {
499
+ console.log(`⚠️ Limite de tokens (${config.maxTokens}) atingido`);
500
+ break;
501
+ }
502
+
503
+ content += `## ${file}\n\n${data}\n\n---\n\n`;
504
+ tokenCount += tokens;
505
+ }
506
+
507
+ content += `\n\n_Pack: ${model} | Tokens: ~${tokenCount} / ${config.maxTokens}_`;
508
+
509
+ const outDir = '../.context';
510
+ if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
511
+
512
+ fs.writeFileSync(
513
+ path.join(outDir, `context-pack-${model}.md`),
514
+ content
515
+ );
516
+
517
+ console.log(`✅ Context pack criado: ${config.maxTokens} tokens, nível: ${model}`);
518
+ ```
519
+
520
+ ### Uso
521
+
522
+ ```bash
523
+ # Minimal (500 tokens)
524
+ node scripts/build-context-pack-smart.mjs minimal
525
+
526
+ # Standard (2000 tokens)
527
+ node scripts/build-context-pack-smart.mjs standard
528
+
529
+ # Full (8000 tokens)
530
+ node scripts/build-context-pack-smart.mjs full
531
+ ```
532
+
533
+ ---
534
+
535
+ ## ⚙️ Próximos Exemplos
536
+
537
+ Em breve:
538
+ - ADR-001: Template estruturado
539
+ - AGENT-001: Especificação JSON Schema
540
+ - DOC-001: Índice de documentação
541
+ - AGILE-001: Sprint markdown template
542
+
543
+ ---
544
+
545
+ **Último Update**: 2026-04-21 | **Items Cobertos**: 5 | **Código Pronto**: ✅ 100%
546
+
package/docs/fluxo.md ADDED
@@ -0,0 +1,103 @@
1
+ # Fluxo do 2-projeto-agents — mapa operacional
2
+
3
+ **Princípio:** CLI-first. Todo o ciclo roda por linha de comando. O dashboard web
4
+ (`npm run dashboard`, porta 7777) é **visão opcional read-only** — nunca é gate de
5
+ spec, handoff, sprint ou entrega.
6
+
7
+ As 3 capacidades externas (ADR-0016) entram em pontos específicos do ciclo, sem mudar
8
+ o pipeline SDD+GSD existente:
9
+
10
+ - **codegraph** (MCP/CLI) → entender o código e medir impacto.
11
+ - **harness** (plugin) → desenhar o time de agentes de uma feature/domínio.
12
+ - **ai-engineering** (referência) → fundamentar decisões técnicas de IA.
13
+
14
+ ---
15
+
16
+ ## Mapa do ciclo
17
+
18
+ ```mermaid
19
+ flowchart LR
20
+ subgraph TRANSVERSAL["🧠 Memória & Contexto (transversal)"]
21
+ M["sync:universal · query:universal · context:smart"]
22
+ end
23
+
24
+ IDEIA(["💡 Ideia / demanda"])
25
+
26
+ subgraph CICLO["Ciclo CLI-first (SDD + GSD)"]
27
+ direction LR
28
+ E1["1· ENTENDER<br/>codegraph explore/query<br/>ai-engineering (ref)"]
29
+ E2["2· ESPECIFICAR<br/>product · spec:new<br/>specs/&lt;slug&gt;/spec.md"]
30
+ E3["3· ARQUITETAR<br/>sdd-architect · spec:plan<br/>ADR + harness (time)"]
31
+ E4["4· DECOMPOR<br/>spec:tasks<br/>tasks.md + ownership"]
32
+ E5["5· IMPLEMENTAR<br/>orchestrator + worker<br/>handoffs · codegraph MCP"]
33
+ E6["6· GOVERNAR<br/>governance · spec:check<br/>project:check · npm test"]
34
+ E1 --> E2 --> E3 --> E4 --> E5 --> E6
35
+ end
36
+
37
+ ENTREGA(["✅ Entrega"])
38
+ VISAO["👁 dashboard 7777 (opcional)"]
39
+
40
+ IDEIA --> E1
41
+ E6 --> ENTREGA
42
+ M -.alimenta.-> CICLO
43
+ CICLO -.estado.-> VISAO
44
+ ```
45
+
46
+ ### Fallback ASCII (sem render)
47
+
48
+ ```
49
+ ┌──────────── 🧠 MEMÓRIA & CONTEXTO (transversal) ────────────┐
50
+ │ sync:universal · query:universal · context:smart │
51
+ └──────────────────────────────┬──────────────────────────────┘
52
+ ↓ alimenta
53
+ 💡 ─► 1·ENTENDER ─► 2·ESPECIFICAR ─► 3·ARQUITETAR ─► 4·DECOMPOR ─► 5·IMPLEMENTAR ─► 6·GOVERNAR ─► ✅
54
+ codegraph product sdd-arch tasks worker governance
55
+ ai-eng (ref) spec:new spec:plan+ADR spec:tasks codegraph MCP spec:check
56
+ harness (time) handoffs project:check
57
+ ──────────────► 👁 dashboard 7777 (opcional, read-only)
58
+ ```
59
+
60
+ ---
61
+
62
+ ## Etapa → papel → comando → capacidade
63
+
64
+ | # | Etapa | Papel | Comando(s) CLI | Capacidade usada |
65
+ |---|-------|-------|----------------|------------------|
66
+ | 1 | Entender | context-engineer | `codegraph explore "<área>"` · `npm run code:query "<x>"` · `npm run context:smart` | **codegraph** · **ai-engineering** |
67
+ | 2 | Especificar | product | `npm run spec:new -- <slug>` | — |
68
+ | 3 | Arquitetar | sdd-architect | `npm run spec:plan -- <slug>` · ADR em `memory/90-decisions/` | **harness** (desenhar time) |
69
+ | 4 | Decompor | sdd-architect | `npm run spec:tasks -- <slug>` | — |
70
+ | 5 | Implementar | orchestrator + worker | `npm run gsd:handoff -- implement <slug>` · MCP `codegraph_explore`/`codegraph_node` | **codegraph** |
71
+ | 6 | Governar | governance | `npm run spec:check -- <slug>` · `npm test` · `npm run project:check` · `codegraph affected` | **codegraph** (impacto) |
72
+
73
+ Handoffs entre papéis: `npm run gsd:handoff -- <intent> <slug>` (7 campos, ADR-0005),
74
+ gravados na tabela `handoffs` do `~/forja-workspace/memory/sqlite/universal.db` (ADR-0008).
75
+
76
+ ---
77
+
78
+ ## Onde cada capacidade entra (estratégico)
79
+
80
+ **codegraph — análise de código.** Use *antes* de mexer (etapa 1) para mapear símbolos
81
+ e call paths sem ler arquivo por arquivo, e *durante* a implementação (etapa 5) via
82
+ ferramentas MCP. Na governança (etapa 6), `codegraph affected <arquivos>` mostra os
83
+ testes impactados por uma mudança. Mantenha o índice fresco com `npm run code:sync`.
84
+
85
+ **harness — orquestração.** Quando uma feature/domínio nova precisa de um time de agentes
86
+ próprio, na etapa 3 peça _"build a harness for this project"_ numa sessão Claude Code:
87
+ ele escolhe um dos 6 padrões e gera `.claude/agents/` + `.claude/skills/`. O framework
88
+ então *opera* esses agentes pelos handoffs existentes — harness desenha, GSD executa.
89
+
90
+ **ai-engineering — base de conhecimento.** Referência para decisões técnicas de IA
91
+ (etapa 1 e ao escrever ADRs na etapa 3). Consulte `projects/ai-engineering-from-scratch-main/`
92
+ (`ROADMAP.md`, `phases/`, `glossary/`).
93
+
94
+ ---
95
+
96
+ ## Front (opcional)
97
+
98
+ O dashboard sobe com `npm run dashboard` em `http://127.0.0.1:7777` e oferece uma visão
99
+ read-only de specs, handoffs e agentes (`/api/health`, `/api/specs`, `/api/handoffs`,
100
+ `/api/agents`). É conveniência de leitura — se não subir, **o fluxo segue 100% pela CLI**.
101
+
102
+ Ver também: `docs/cli-first-operacao.md` (comandos), `docs/capacidades-externas.md`
103
+ (detalhe das 3 capacidades), `AGENTS.md` (papéis), ADR-0016.