forjajs 2.0.3 → 2.0.4
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.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -339
- package/README.pt-BR.md +345 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.js +2 -2
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -150
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
|
@@ -1,279 +1,279 @@
|
|
|
1
|
-
# Guia de Onboarding do Projeto
|
|
2
|
-
|
|
3
|
-
Este documento ensina como iniciar, estruturar, executar e validar um projeto usando o scaffold `create-memory-nest-kit`.
|
|
4
|
-
|
|
5
|
-
## 1) Objetivo do Guia
|
|
6
|
-
|
|
7
|
-
Ao final deste guia, a pessoa responsável deve conseguir:
|
|
8
|
-
- criar um projeto com `npx`
|
|
9
|
-
- entender a estrutura de memória/documentação
|
|
10
|
-
- gerar e revisar os steps de execução
|
|
11
|
-
- questionar o plano antes de executar
|
|
12
|
-
- validar com checklist técnico e de produção
|
|
13
|
-
- realizar go-live com segurança
|
|
14
|
-
|
|
15
|
-
## 2) Pré-requisitos
|
|
16
|
-
|
|
17
|
-
- Node.js 18+
|
|
18
|
-
- npm 9+
|
|
19
|
-
- Git instalado
|
|
20
|
-
- Conta GitHub (se for publicar remoto)
|
|
21
|
-
- (Opcional) Conta npm (se for publicar pacote)
|
|
22
|
-
|
|
23
|
-
Validação rápida:
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
node -v
|
|
27
|
-
npm -v
|
|
28
|
-
git --version
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
## 3) Criar Projeto com npx
|
|
32
|
-
|
|
33
|
-
### Opção A: via GitHub
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
### Opção B: via npm
|
|
40
|
-
|
|
41
|
-
```bash
|
|
42
|
-
npx create-memory-nest-kit@latest nome-do-projeto
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
### Opção C: local (desenvolvimento)
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
|
-
node ./bin/create-memory-nest-kit.js nome-do-projeto
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
Entrar no projeto:
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
cd nome-do-projeto
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
## 4) Estrutura Gerada (resumo)
|
|
58
|
-
|
|
59
|
-
- `memory/`: base de contexto e continuidade
|
|
60
|
-
- `agents/`: responsabilidades por tipo de agente
|
|
61
|
-
- `skills/`: playbooks operacionais reutilizáveis
|
|
62
|
-
- `prompts/`: templates de orquestração e execução
|
|
63
|
-
- `scripts/`: utilitários de contexto e handoff
|
|
64
|
-
- `backend/`: API NestJS base
|
|
65
|
-
- `.memory/sqlite/`: índice SQLite operacional
|
|
66
|
-
|
|
67
|
-
## 5) Primeiro Setup
|
|
68
|
-
|
|
69
|
-
### 5.1 Backend
|
|
70
|
-
|
|
71
|
-
```bash
|
|
72
|
-
cd backend
|
|
73
|
-
npm install
|
|
74
|
-
npm run start:dev
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
Checagem esperada:
|
|
78
|
-
- API sobe sem erro
|
|
79
|
-
- rota de saúde responde (`/api/health`)
|
|
80
|
-
|
|
81
|
-
### 5.2 Memória operacional (SQLite)
|
|
82
|
-
|
|
83
|
-
Ainda dentro de `backend/`:
|
|
84
|
-
|
|
85
|
-
```bash
|
|
86
|
-
npm run memory:db:init
|
|
87
|
-
npm run memory:db:sync
|
|
88
|
-
npm run memory:db:query -- "search" "contexto" 10
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
O que isso faz:
|
|
92
|
-
- `init`: cria schema do banco de memória
|
|
93
|
-
- `sync`: indexa os markdowns (memory/docs/agents/skills/prompts)
|
|
94
|
-
- `query`: consulta rápida de contexto
|
|
95
|
-
|
|
96
|
-
## 6) Como Gerar os Steps do Projeto
|
|
97
|
-
|
|
98
|
-
Use este fluxo para definir plano e execução:
|
|
99
|
-
|
|
100
|
-
1. Ler contexto mínimo:
|
|
101
|
-
- `memory/00-global/*`
|
|
102
|
-
- `memory/10-product/*`
|
|
103
|
-
- `memory/20-architecture/*`
|
|
104
|
-
- `memory/40-delivery/current-sprint.md`
|
|
105
|
-
|
|
106
|
-
2. Criar plano inicial em `memory/40-delivery/current-sprint.md` com:
|
|
107
|
-
- objetivo
|
|
108
|
-
- steps técnicos
|
|
109
|
-
- riscos
|
|
110
|
-
- dono por step
|
|
111
|
-
|
|
112
|
-
3. Quebrar em subtarefas (se necessário) no padrão multiagente:
|
|
113
|
-
- Orchestrator define escopo
|
|
114
|
-
- Worker por domínio executa
|
|
115
|
-
- Reviewer valida
|
|
116
|
-
|
|
117
|
-
4. Registrar handoffs:
|
|
118
|
-
|
|
119
|
-
```bash
|
|
120
|
-
node scripts/append-handoff.mjs orchestrator backend-nest "implementar modulo auth"
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
5. Atualizar resumo operacional:
|
|
124
|
-
- `memory/70-summaries/global-summary.md`
|
|
125
|
-
- `memory/70-summaries/domain-summary.md`
|
|
126
|
-
|
|
127
|
-
## 7) Questionando os Steps (obrigatório)
|
|
128
|
-
|
|
129
|
-
Antes de executar qualquer step, responder:
|
|
130
|
-
|
|
131
|
-
### 7.1 Clareza
|
|
132
|
-
- O step está claro e testável?
|
|
133
|
-
- O resultado esperado está explícito?
|
|
134
|
-
|
|
135
|
-
### 7.2 Dependências
|
|
136
|
-
- Esse step depende de outro?
|
|
137
|
-
- Há bloqueio externo (infra, credencial, API de terceiro)?
|
|
138
|
-
|
|
139
|
-
### 7.3 Risco
|
|
140
|
-
- Qual risco funcional?
|
|
141
|
-
- Qual risco de segurança?
|
|
142
|
-
- Qual risco de regressão?
|
|
143
|
-
|
|
144
|
-
### 7.4 Observabilidade
|
|
145
|
-
- Como saber se deu certo?
|
|
146
|
-
- Que métrica/log/teste confirma o sucesso?
|
|
147
|
-
|
|
148
|
-
### 7.5 Rollback
|
|
149
|
-
- Se falhar, como desfazer com segurança?
|
|
150
|
-
|
|
151
|
-
Se qualquer resposta estiver fraca, o step volta para refinamento antes de execução.
|
|
152
|
-
|
|
153
|
-
## 8) Critério de Pronto por Step (Definition of Done)
|
|
154
|
-
|
|
155
|
-
Um step só é concluído quando:
|
|
156
|
-
- código implementado
|
|
157
|
-
- teste mínimo executado
|
|
158
|
-
- risco registrado
|
|
159
|
-
- documentação atualizada
|
|
160
|
-
- resumo/handoff atualizado (se houve troca de agente)
|
|
161
|
-
|
|
162
|
-
## 9) Validação Pré-Produção
|
|
163
|
-
|
|
164
|
-
Checklist mínimo:
|
|
165
|
-
|
|
166
|
-
### 9.1 Técnica
|
|
167
|
-
- build ok
|
|
168
|
-
- testes críticos ok
|
|
169
|
-
- lint/qualidade ok
|
|
170
|
-
- migrations validadas (se houver)
|
|
171
|
-
|
|
172
|
-
### 9.2 Segurança
|
|
173
|
-
- sem segredo hardcoded
|
|
174
|
-
- validação de entrada ativa
|
|
175
|
-
- autorização revisada
|
|
176
|
-
- logs sem dados sensíveis
|
|
177
|
-
|
|
178
|
-
### 9.3 Operação
|
|
179
|
-
- healthcheck ok
|
|
180
|
-
- monitoramento/alertas definidos
|
|
181
|
-
- rollback pronto e testado
|
|
182
|
-
|
|
183
|
-
### 9.4 Produto
|
|
184
|
-
- critérios de aceite atendidos
|
|
185
|
-
- fluxos críticos validados com negócio
|
|
186
|
-
|
|
187
|
-
## 10) Go/No-Go para Produção
|
|
188
|
-
|
|
189
|
-
Regra prática:
|
|
190
|
-
- **GO**: todos checklists verdes + riscos aceitáveis + rollback pronto
|
|
191
|
-
- **NO-GO**: qualquer falha crítica em segurança, integridade de dados ou indisponibilidade sem plano de retorno
|
|
192
|
-
|
|
193
|
-
Template de decisão:
|
|
194
|
-
|
|
195
|
-
```text
|
|
196
|
-
Decisão: GO | NO-GO
|
|
197
|
-
Data:
|
|
198
|
-
Responsável:
|
|
199
|
-
Motivos:
|
|
200
|
-
Riscos remanescentes:
|
|
201
|
-
Plano de rollback:
|
|
202
|
-
```
|
|
203
|
-
|
|
204
|
-
## 11) Pós-Deploy (produção)
|
|
205
|
-
|
|
206
|
-
Após subir:
|
|
207
|
-
- monitorar logs e métricas por janela definida
|
|
208
|
-
- validar rotas críticas
|
|
209
|
-
- registrar resultado em `memory/60-runs/` e resumo em `memory/70-summaries/global-summary.md`
|
|
210
|
-
|
|
211
|
-
Template pós-deploy:
|
|
212
|
-
|
|
213
|
-
```text
|
|
214
|
-
Deploy realizado em:
|
|
215
|
-
Versão:
|
|
216
|
-
Status inicial:
|
|
217
|
-
Incidentes:
|
|
218
|
-
Ações corretivas:
|
|
219
|
-
Próximos passos:
|
|
220
|
-
```
|
|
221
|
-
|
|
222
|
-
## 12) Fluxo Recomendado de Trabalho Diário
|
|
223
|
-
|
|
224
|
-
1. Sincronizar memória:
|
|
225
|
-
```bash
|
|
226
|
-
cd backend
|
|
227
|
-
npm run memory:db:sync
|
|
228
|
-
```
|
|
229
|
-
|
|
230
|
-
2. Buscar contexto da tarefa:
|
|
231
|
-
```bash
|
|
232
|
-
npm run memory:db:query -- "search" "tema da tarefa" 10
|
|
233
|
-
```
|
|
234
|
-
|
|
235
|
-
3. Executar step
|
|
236
|
-
4. Atualizar docs + resumo
|
|
237
|
-
5. Registrar handoff (se houver troca de responsável)
|
|
238
|
-
|
|
239
|
-
## 13) Erros Comuns e Como Evitar
|
|
240
|
-
|
|
241
|
-
- Erro: executar sem refinar step.
|
|
242
|
-
- Evitar: aplicar seção 7 (questionamento obrigatório).
|
|
243
|
-
|
|
244
|
-
- Erro: esquecer atualização de memória.
|
|
245
|
-
- Evitar: sempre rodar `memory:db:sync` após mudanças relevantes.
|
|
246
|
-
|
|
247
|
-
- Erro: deploy sem rollback claro.
|
|
248
|
-
- Evitar: incluir rollback como item obrigatório no DoD.
|
|
249
|
-
|
|
250
|
-
- Erro: contexto disperso em chat apenas.
|
|
251
|
-
- Evitar: registrar decisão em `memory/90-decisions` e resumo em `memory/70-summaries`.
|
|
252
|
-
|
|
253
|
-
## 14) Comandos Rápidos (cola)
|
|
254
|
-
|
|
255
|
-
```bash
|
|
256
|
-
# criar projeto
|
|
257
|
-
npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
258
|
-
|
|
259
|
-
# setup inicial
|
|
260
|
-
cd nome-do-projeto/backend
|
|
261
|
-
npm install
|
|
262
|
-
npm run memory:db:init
|
|
263
|
-
npm run memory:db:sync
|
|
264
|
-
npm run start:dev
|
|
265
|
-
|
|
266
|
-
# consultar contexto
|
|
267
|
-
npm run memory:db:query -- "search" "auth" 10
|
|
268
|
-
|
|
269
|
-
# registrar handoff (na raiz do projeto)
|
|
270
|
-
cd ..
|
|
271
|
-
node scripts/append-handoff.mjs orchestrator backend-nest "step de auth"
|
|
272
|
-
```
|
|
273
|
-
|
|
274
|
-
---
|
|
275
|
-
|
|
276
|
-
## 15) Ponto Mais Importante
|
|
277
|
-
|
|
278
|
-
Este projeto foi desenhado para **não perder contexto operacional**.
|
|
279
|
-
A disciplina de documentação + handoff + resumo é parte da entrega, não “extra”.
|
|
1
|
+
# Guia de Onboarding do Projeto
|
|
2
|
+
|
|
3
|
+
Este documento ensina como iniciar, estruturar, executar e validar um projeto usando o scaffold `create-memory-nest-kit`.
|
|
4
|
+
|
|
5
|
+
## 1) Objetivo do Guia
|
|
6
|
+
|
|
7
|
+
Ao final deste guia, a pessoa responsável deve conseguir:
|
|
8
|
+
- criar um projeto com `npx`
|
|
9
|
+
- entender a estrutura de memória/documentação
|
|
10
|
+
- gerar e revisar os steps de execução
|
|
11
|
+
- questionar o plano antes de executar
|
|
12
|
+
- validar com checklist técnico e de produção
|
|
13
|
+
- realizar go-live com segurança
|
|
14
|
+
|
|
15
|
+
## 2) Pré-requisitos
|
|
16
|
+
|
|
17
|
+
- Node.js 18+
|
|
18
|
+
- npm 9+
|
|
19
|
+
- Git instalado
|
|
20
|
+
- Conta GitHub (se for publicar remoto)
|
|
21
|
+
- (Opcional) Conta npm (se for publicar pacote)
|
|
22
|
+
|
|
23
|
+
Validação rápida:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
node -v
|
|
27
|
+
npm -v
|
|
28
|
+
git --version
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## 3) Criar Projeto com npx
|
|
32
|
+
|
|
33
|
+
### Opção A: via GitHub
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Opção B: via npm
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npx create-memory-nest-kit@latest nome-do-projeto
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Opção C: local (desenvolvimento)
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
node ./bin/create-memory-nest-kit.js nome-do-projeto
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Entrar no projeto:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
cd nome-do-projeto
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## 4) Estrutura Gerada (resumo)
|
|
58
|
+
|
|
59
|
+
- `memory/`: base de contexto e continuidade
|
|
60
|
+
- `agents/`: responsabilidades por tipo de agente
|
|
61
|
+
- `skills/`: playbooks operacionais reutilizáveis
|
|
62
|
+
- `prompts/`: templates de orquestração e execução
|
|
63
|
+
- `scripts/`: utilitários de contexto e handoff
|
|
64
|
+
- `backend/`: API NestJS base
|
|
65
|
+
- `.memory/sqlite/`: índice SQLite operacional
|
|
66
|
+
|
|
67
|
+
## 5) Primeiro Setup
|
|
68
|
+
|
|
69
|
+
### 5.1 Backend
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
cd backend
|
|
73
|
+
npm install
|
|
74
|
+
npm run start:dev
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Checagem esperada:
|
|
78
|
+
- API sobe sem erro
|
|
79
|
+
- rota de saúde responde (`/api/health`)
|
|
80
|
+
|
|
81
|
+
### 5.2 Memória operacional (SQLite)
|
|
82
|
+
|
|
83
|
+
Ainda dentro de `backend/`:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
npm run memory:db:init
|
|
87
|
+
npm run memory:db:sync
|
|
88
|
+
npm run memory:db:query -- "search" "contexto" 10
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
O que isso faz:
|
|
92
|
+
- `init`: cria schema do banco de memória
|
|
93
|
+
- `sync`: indexa os markdowns (memory/docs/agents/skills/prompts)
|
|
94
|
+
- `query`: consulta rápida de contexto
|
|
95
|
+
|
|
96
|
+
## 6) Como Gerar os Steps do Projeto
|
|
97
|
+
|
|
98
|
+
Use este fluxo para definir plano e execução:
|
|
99
|
+
|
|
100
|
+
1. Ler contexto mínimo:
|
|
101
|
+
- `memory/00-global/*`
|
|
102
|
+
- `memory/10-product/*`
|
|
103
|
+
- `memory/20-architecture/*`
|
|
104
|
+
- `memory/40-delivery/current-sprint.md`
|
|
105
|
+
|
|
106
|
+
2. Criar plano inicial em `memory/40-delivery/current-sprint.md` com:
|
|
107
|
+
- objetivo
|
|
108
|
+
- steps técnicos
|
|
109
|
+
- riscos
|
|
110
|
+
- dono por step
|
|
111
|
+
|
|
112
|
+
3. Quebrar em subtarefas (se necessário) no padrão multiagente:
|
|
113
|
+
- Orchestrator define escopo
|
|
114
|
+
- Worker por domínio executa
|
|
115
|
+
- Reviewer valida
|
|
116
|
+
|
|
117
|
+
4. Registrar handoffs:
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
node scripts/append-handoff.mjs orchestrator backend-nest "implementar modulo auth"
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
5. Atualizar resumo operacional:
|
|
124
|
+
- `memory/70-summaries/global-summary.md`
|
|
125
|
+
- `memory/70-summaries/domain-summary.md`
|
|
126
|
+
|
|
127
|
+
## 7) Questionando os Steps (obrigatório)
|
|
128
|
+
|
|
129
|
+
Antes de executar qualquer step, responder:
|
|
130
|
+
|
|
131
|
+
### 7.1 Clareza
|
|
132
|
+
- O step está claro e testável?
|
|
133
|
+
- O resultado esperado está explícito?
|
|
134
|
+
|
|
135
|
+
### 7.2 Dependências
|
|
136
|
+
- Esse step depende de outro?
|
|
137
|
+
- Há bloqueio externo (infra, credencial, API de terceiro)?
|
|
138
|
+
|
|
139
|
+
### 7.3 Risco
|
|
140
|
+
- Qual risco funcional?
|
|
141
|
+
- Qual risco de segurança?
|
|
142
|
+
- Qual risco de regressão?
|
|
143
|
+
|
|
144
|
+
### 7.4 Observabilidade
|
|
145
|
+
- Como saber se deu certo?
|
|
146
|
+
- Que métrica/log/teste confirma o sucesso?
|
|
147
|
+
|
|
148
|
+
### 7.5 Rollback
|
|
149
|
+
- Se falhar, como desfazer com segurança?
|
|
150
|
+
|
|
151
|
+
Se qualquer resposta estiver fraca, o step volta para refinamento antes de execução.
|
|
152
|
+
|
|
153
|
+
## 8) Critério de Pronto por Step (Definition of Done)
|
|
154
|
+
|
|
155
|
+
Um step só é concluído quando:
|
|
156
|
+
- código implementado
|
|
157
|
+
- teste mínimo executado
|
|
158
|
+
- risco registrado
|
|
159
|
+
- documentação atualizada
|
|
160
|
+
- resumo/handoff atualizado (se houve troca de agente)
|
|
161
|
+
|
|
162
|
+
## 9) Validação Pré-Produção
|
|
163
|
+
|
|
164
|
+
Checklist mínimo:
|
|
165
|
+
|
|
166
|
+
### 9.1 Técnica
|
|
167
|
+
- build ok
|
|
168
|
+
- testes críticos ok
|
|
169
|
+
- lint/qualidade ok
|
|
170
|
+
- migrations validadas (se houver)
|
|
171
|
+
|
|
172
|
+
### 9.2 Segurança
|
|
173
|
+
- sem segredo hardcoded
|
|
174
|
+
- validação de entrada ativa
|
|
175
|
+
- autorização revisada
|
|
176
|
+
- logs sem dados sensíveis
|
|
177
|
+
|
|
178
|
+
### 9.3 Operação
|
|
179
|
+
- healthcheck ok
|
|
180
|
+
- monitoramento/alertas definidos
|
|
181
|
+
- rollback pronto e testado
|
|
182
|
+
|
|
183
|
+
### 9.4 Produto
|
|
184
|
+
- critérios de aceite atendidos
|
|
185
|
+
- fluxos críticos validados com negócio
|
|
186
|
+
|
|
187
|
+
## 10) Go/No-Go para Produção
|
|
188
|
+
|
|
189
|
+
Regra prática:
|
|
190
|
+
- **GO**: todos checklists verdes + riscos aceitáveis + rollback pronto
|
|
191
|
+
- **NO-GO**: qualquer falha crítica em segurança, integridade de dados ou indisponibilidade sem plano de retorno
|
|
192
|
+
|
|
193
|
+
Template de decisão:
|
|
194
|
+
|
|
195
|
+
```text
|
|
196
|
+
Decisão: GO | NO-GO
|
|
197
|
+
Data:
|
|
198
|
+
Responsável:
|
|
199
|
+
Motivos:
|
|
200
|
+
Riscos remanescentes:
|
|
201
|
+
Plano de rollback:
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
## 11) Pós-Deploy (produção)
|
|
205
|
+
|
|
206
|
+
Após subir:
|
|
207
|
+
- monitorar logs e métricas por janela definida
|
|
208
|
+
- validar rotas críticas
|
|
209
|
+
- registrar resultado em `memory/60-runs/` e resumo em `memory/70-summaries/global-summary.md`
|
|
210
|
+
|
|
211
|
+
Template pós-deploy:
|
|
212
|
+
|
|
213
|
+
```text
|
|
214
|
+
Deploy realizado em:
|
|
215
|
+
Versão:
|
|
216
|
+
Status inicial:
|
|
217
|
+
Incidentes:
|
|
218
|
+
Ações corretivas:
|
|
219
|
+
Próximos passos:
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
## 12) Fluxo Recomendado de Trabalho Diário
|
|
223
|
+
|
|
224
|
+
1. Sincronizar memória:
|
|
225
|
+
```bash
|
|
226
|
+
cd backend
|
|
227
|
+
npm run memory:db:sync
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
2. Buscar contexto da tarefa:
|
|
231
|
+
```bash
|
|
232
|
+
npm run memory:db:query -- "search" "tema da tarefa" 10
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
3. Executar step
|
|
236
|
+
4. Atualizar docs + resumo
|
|
237
|
+
5. Registrar handoff (se houver troca de responsável)
|
|
238
|
+
|
|
239
|
+
## 13) Erros Comuns e Como Evitar
|
|
240
|
+
|
|
241
|
+
- Erro: executar sem refinar step.
|
|
242
|
+
- Evitar: aplicar seção 7 (questionamento obrigatório).
|
|
243
|
+
|
|
244
|
+
- Erro: esquecer atualização de memória.
|
|
245
|
+
- Evitar: sempre rodar `memory:db:sync` após mudanças relevantes.
|
|
246
|
+
|
|
247
|
+
- Erro: deploy sem rollback claro.
|
|
248
|
+
- Evitar: incluir rollback como item obrigatório no DoD.
|
|
249
|
+
|
|
250
|
+
- Erro: contexto disperso em chat apenas.
|
|
251
|
+
- Evitar: registrar decisão em `memory/90-decisions` e resumo em `memory/70-summaries`.
|
|
252
|
+
|
|
253
|
+
## 14) Comandos Rápidos (cola)
|
|
254
|
+
|
|
255
|
+
```bash
|
|
256
|
+
# criar projeto
|
|
257
|
+
npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
258
|
+
|
|
259
|
+
# setup inicial
|
|
260
|
+
cd nome-do-projeto/backend
|
|
261
|
+
npm install
|
|
262
|
+
npm run memory:db:init
|
|
263
|
+
npm run memory:db:sync
|
|
264
|
+
npm run start:dev
|
|
265
|
+
|
|
266
|
+
# consultar contexto
|
|
267
|
+
npm run memory:db:query -- "search" "auth" 10
|
|
268
|
+
|
|
269
|
+
# registrar handoff (na raiz do projeto)
|
|
270
|
+
cd ..
|
|
271
|
+
node scripts/append-handoff.mjs orchestrator backend-nest "step de auth"
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
---
|
|
275
|
+
|
|
276
|
+
## 15) Ponto Mais Importante
|
|
277
|
+
|
|
278
|
+
Este projeto foi desenhado para **não perder contexto operacional**.
|
|
279
|
+
A disciplina de documentação + handoff + resumo é parte da entrega, não “extra”.
|