forjajs 2.0.4 → 4.0.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.
- package/.claude/agents/context-engineer.md +19 -25
- package/.claude/agents/governance.md +19 -55
- package/.claude/agents/marketing.md +19 -24
- package/.claude/agents/orchestrator.md +19 -31
- package/.claude/agents/product.md +19 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +19 -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 +93 -87
- package/.github/copilot-instructions.md +93 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +93 -87
- package/AGENTS.md +137 -134
- package/CHANGELOG.md +656 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +68 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -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/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +17 -1
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/release.js +3 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/llm/codex-output.d.ts +12 -0
- package/dist/lib/llm/codex-output.js +56 -0
- package/dist/lib/llm/context.d.ts +5 -0
- package/dist/lib/llm/context.js +17 -0
- package/dist/lib/llm/session.d.ts +18 -0
- package/dist/lib/llm/session.js +34 -0
- package/dist/lib/llm/validation.d.ts +37 -0
- package/dist/lib/llm/validation.js +88 -0
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/evals/src/index.js +6 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.d.ts +8 -1
- package/dist/packages/llm/src/index.js +64 -7
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- 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/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +85 -9
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- 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/agent-operating-contract.md +26 -0
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- 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-evolution.md +51 -0
- package/docs/llm-fit-loop.md +134 -5
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- 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/publishing.md +49 -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 +20 -20
- 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/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
- package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +159 -157
- package/prompts/context-engineer-agent.md +13 -19
- package/prompts/governance-agent.md +13 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +13 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +13 -20
- package/skills/MANIFEST.json +10 -0
- package/skills/llm-provider-routing/SKILL.md +18 -0
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +50 -43
- package/specs/_templates/spec.md +50 -43
- package/specs/_templates/tasks.md +39 -32
- package/specs/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-instructions-v4/plan.md +8 -0
- package/specs/agent-instructions-v4/spec.md +21 -0
- package/specs/agent-instructions-v4/tasks.md +12 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- 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/cost-aware-autonomy-budget/spec.md +102 -0
- 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/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- 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/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/llm-integration-v2/plan.md +55 -0
- package/specs/llm-integration-v2/spec.md +61 -0
- package/specs/llm-integration-v2/tasks.md +28 -0
- package/specs/llm-resume-validation/plan.md +50 -0
- package/specs/llm-resume-validation/spec.md +35 -0
- package/specs/llm-resume-validation/tasks.md +19 -0
- 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/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- 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/spec.md +23 -23
- 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/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,565 +1,565 @@
|
|
|
1
|
-
# Refinamento de Agentes Orquestrados - Especificação de Melhoras v1.0
|
|
2
|
-
|
|
3
|
-
Documento vivo com decisões, padrões e implementações para elevar o kit a padrão profissional.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## 🎯 1. Qualidade & Segurança
|
|
8
|
-
|
|
9
|
-
### Status Atual
|
|
10
|
-
- Testes: básicos (apenas app.controller.spec.ts na geração NestJS)
|
|
11
|
-
- Validação: DTO com `class-validator` disponível, não obrigatório
|
|
12
|
-
- Segurança: documentação (security.md) mas sem implementação forçada
|
|
13
|
-
- Sanitização: ausente
|
|
14
|
-
|
|
15
|
-
### Melhoras Tier 1
|
|
16
|
-
**[SEC-001] Adicionar validação obrigatória em rotas**
|
|
17
|
-
- Toda rota deve usar DTOs com `@IsString()`, `@IsEmail()`, etc
|
|
18
|
-
- Tratamento de erro estruturado (HttpException com código específico)
|
|
19
|
-
- Template de DTO gerado automaticamente
|
|
20
|
-
|
|
21
|
-
**[SEC-002] Implementar rate-limiting no gerador**
|
|
22
|
-
- Gerar middleware de rate-limiting no backend
|
|
23
|
-
- Config: 100 req/min por IP por padrão
|
|
24
|
-
- Template pronto em `backend/src/middleware/rate-limit.ts`
|
|
25
|
-
|
|
26
|
-
**[SEC-003] Sanitização de entrada**
|
|
27
|
-
- Remover caracteres perigosos em strings de entrada
|
|
28
|
-
- Validar tamanho máximo de payloads (10MB por padrão)
|
|
29
|
-
- Usar `helmet` no NestJS
|
|
30
|
-
|
|
31
|
-
**[SEC-004] Testes obrigatórios**
|
|
32
|
-
- Gerar `*.spec.ts` para todo controller novo
|
|
33
|
-
- Coverage mínimo: 80% em rotas críticas
|
|
34
|
-
- Incluir testes de segurança (SQL injection, XSS simulation)
|
|
35
|
-
|
|
36
|
-
### Decisões
|
|
37
|
-
- ✅ **Usar class-validator + class-transformer**: padrão NestJS, suporta nestação
|
|
38
|
-
- ✅ **Helmet para headers de segurança**: reduz vetores de ataque
|
|
39
|
-
- ✅ **Coverage mínimo 80%**: viável em projetos novos
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
## 🧠 2. Design de Agentes
|
|
44
|
-
|
|
45
|
-
### Status Atual
|
|
46
|
-
- Agentes: 7 tipos (orchestrator, backend-nest, frontend, dba, security, reviewer, sem specialistas adicionais)
|
|
47
|
-
- Prompts: 3 templates genéricos, muito curtos
|
|
48
|
-
- Comunicação: contrato explícito no AGENTS.md mas pouco estruturado
|
|
49
|
-
- Especialização: baixa (agentes genéricos)
|
|
50
|
-
|
|
51
|
-
### Melhoras Tier 1
|
|
52
|
-
**[AGENT-001] Criar especificação estruturada de agentes**
|
|
53
|
-
```
|
|
54
|
-
Cada agente terá:
|
|
55
|
-
- ID único (ex: agent-backend-nest-v1)
|
|
56
|
-
- Missão clara (1-2 frases)
|
|
57
|
-
- Entrada esperada (formato, tamanho, estrutura)
|
|
58
|
-
- Saída esperada (formato, qualidade, critério de aceite)
|
|
59
|
-
- Contexto prioritário (quais docs ler)
|
|
60
|
-
- Proibições explícitas (o que NÃO fazer)
|
|
61
|
-
- Escala: 1-10 (complexidade, especificidade)
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
**[AGENT-002] Melhorar prompts com estrutura de contexto**
|
|
65
|
-
- Adicionar seção: "Você é especialista em [domínio]"
|
|
66
|
-
- Incluir exemplos de input/output (few-shot)
|
|
67
|
-
- Definir tom (formal, técnico, direto)
|
|
68
|
-
- Incluir checklist de validação final
|
|
69
|
-
|
|
70
|
-
**[AGENT-003] Protocolo de handoff estruturado**
|
|
71
|
-
- Formato obrigatório com 7 campos (contexto, mudanças, riscos, pendências, próximo passo, checklist, metadados)
|
|
72
|
-
- Validação de handoff antes de aceitar (revisor detecta gaps)
|
|
73
|
-
- Template em `memory/50-orchestration/handoff-template.md`
|
|
74
|
-
|
|
75
|
-
**[AGENT-004] Roteamento inteligente de tarefas**
|
|
76
|
-
- Matriz de compatibilidade: tarefa -> agentes capazes
|
|
77
|
-
- Score de "fit" (expertise match, carga atual, contexto carregado)
|
|
78
|
-
- Orquestrador escolhe melhor agente automaticamente
|
|
79
|
-
|
|
80
|
-
**[AGENT-005] Contrato de agentes em JSON Schema**
|
|
81
|
-
- Definir input/output como JSON Schema
|
|
82
|
-
- Validar payloads antes de enviar para agente
|
|
83
|
-
- Permitir "strict" mode (erro se saída não match)
|
|
84
|
-
|
|
85
|
-
### Decisões
|
|
86
|
-
- ✅ **JSON Schema para contratos**: interoperável, validável
|
|
87
|
-
- ✅ **7 campos obrigatórios no handoff**: reduz gaps e retrabalho
|
|
88
|
-
- ✅ **Few-shot em prompts**: aumenta qualidade de resposta 30-50%
|
|
89
|
-
|
|
90
|
-
---
|
|
91
|
-
|
|
92
|
-
## 🤖 3. Otimização para IAs (Copilot/Gemini/Codex/Claude)
|
|
93
|
-
|
|
94
|
-
### Status Atual
|
|
95
|
-
- Contexto: compactação básica (build-context-pack.mjs)
|
|
96
|
-
- Prompts: genéricos, sem otimização para modelos específicos
|
|
97
|
-
- Rastreamento: não há detecção de qual modelo está usando
|
|
98
|
-
- Estrutura: Markdown, sem hints de estrutura semântica
|
|
99
|
-
|
|
100
|
-
### Melhoras Tier 1
|
|
101
|
-
**[AI-OPT-001] Context packing com model-aware**
|
|
102
|
-
- Detectar modelo via header HTTP ou variável env
|
|
103
|
-
- Ajustar tamanho do context-pack conforme modelo (Claude: 100k, GPT-4: 8k, Gemini: 32k)
|
|
104
|
-
- Priorizar docs conforme modelo (IA legal: segurança; IA dev: código)
|
|
105
|
-
|
|
106
|
-
**[AI-OPT-002] Estrutura de prompt "Instruction Bundle"**
|
|
107
|
-
```markdown
|
|
108
|
-
# [ID] Tarefa
|
|
109
|
-
## 👤 Contexto
|
|
110
|
-
- Você é: [especialista]
|
|
111
|
-
- Objetivo: [claro]
|
|
112
|
-
|
|
113
|
-
## 📥 Entrada
|
|
114
|
-
- Formato: [structure]
|
|
115
|
-
- Restrições: [limits]
|
|
116
|
-
|
|
117
|
-
## 📤 Saída esperada
|
|
118
|
-
- Formato: [structure]
|
|
119
|
-
- Validação: [checklist]
|
|
120
|
-
|
|
121
|
-
## 🚫 Proibições
|
|
122
|
-
- NUNCA fazer: [list]
|
|
123
|
-
|
|
124
|
-
## ✅ Checklist Final
|
|
125
|
-
- [ ] Step 1
|
|
126
|
-
- [ ] Step 2
|
|
127
|
-
```
|
|
128
|
-
|
|
129
|
-
**[AI-OPT-003] Integração com .context/model-config.yml**
|
|
130
|
-
```yaml
|
|
131
|
-
models:
|
|
132
|
-
claude:
|
|
133
|
-
max_tokens: 100000
|
|
134
|
-
priority_sections: [global, architecture]
|
|
135
|
-
prompt_style: structured
|
|
136
|
-
gpt-4:
|
|
137
|
-
max_tokens: 8000
|
|
138
|
-
priority_sections: [current-task]
|
|
139
|
-
prompt_style: concise
|
|
140
|
-
gemini:
|
|
141
|
-
max_tokens: 32000
|
|
142
|
-
priority_sections: [global, domain]
|
|
143
|
-
prompt_style: narrative
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
**[AI-OPT-004] Memory compression com inline links**
|
|
147
|
-
- Em vez de copiar conteúdo inteiro, usar referências: `[[ref:memory/10-product/vision.md:l1-20]]`
|
|
148
|
-
- IAs entendem contexto com links
|
|
149
|
-
- Reduz tamanho do prompt 60-70%
|
|
150
|
-
|
|
151
|
-
**[AI-OPT-005] Strict mode para output**
|
|
152
|
-
- Definir JSON Schema obrigatório
|
|
153
|
-
- IA deve validar contra schema antes de responder
|
|
154
|
-
- Se não match: recusar e explicar por quê
|
|
155
|
-
|
|
156
|
-
### Decisões
|
|
157
|
-
- ✅ **JSON Schema para contratos**: validável por qualquer IA
|
|
158
|
-
- ✅ **Model-aware context packing**: otimiza para cada modelo
|
|
159
|
-
- ✅ **Instruction Bundle format**: estrutura clara, reduz alucinação
|
|
160
|
-
- ⚠️ **Inline links**: depende de suporte do modelo (Claude sim, GPT-4 parcial)
|
|
161
|
-
|
|
162
|
-
---
|
|
163
|
-
|
|
164
|
-
## 📋 4. ADR & Sistema de Decisões Inteligentes
|
|
165
|
-
|
|
166
|
-
### Status Atual
|
|
167
|
-
- Template: basic (ADR-0001-template.md)
|
|
168
|
-
- Rastreamento: banco tem tabela `adrs` mas vazia
|
|
169
|
-
- Sem validação de qualidade
|
|
170
|
-
- Sem rastreamento de impacto
|
|
171
|
-
|
|
172
|
-
### Melhoras Tier 1
|
|
173
|
-
**[ADR-001] Estrutura robusta de ADR**
|
|
174
|
-
```
|
|
175
|
-
# ADR-NNNN: [Título conciso]
|
|
176
|
-
|
|
177
|
-
## Data
|
|
178
|
-
2026-04-21
|
|
179
|
-
|
|
180
|
-
## Contexto
|
|
181
|
-
[Por que estamos decidindo isso agora?]
|
|
182
|
-
[Constraints técnicas e de negócio]
|
|
183
|
-
[Quem precisa saber]
|
|
184
|
-
|
|
185
|
-
## Questão
|
|
186
|
-
[Qual exatamente é a decisão?]
|
|
187
|
-
|
|
188
|
-
## Opções Consideradas
|
|
189
|
-
### Opção A: [Nome]
|
|
190
|
-
- ✅ Pros
|
|
191
|
-
- ❌ Cons
|
|
192
|
-
- 💰 Custo
|
|
193
|
-
- ⏱️ Tempo
|
|
194
|
-
|
|
195
|
-
### Opção B: [Nome]
|
|
196
|
-
...
|
|
197
|
-
|
|
198
|
-
## Decisão
|
|
199
|
-
[Qual escolhemos e por quê]
|
|
200
|
-
|
|
201
|
-
## Impacto Esperado
|
|
202
|
-
- Arquitetura: [mudanças]
|
|
203
|
-
- Equipe: [skill necessária]
|
|
204
|
-
- Cronograma: [efeito]
|
|
205
|
-
- Risco: [novo risco]
|
|
206
|
-
|
|
207
|
-
## Status
|
|
208
|
-
- `accepted` / `deprecated` / `superseded` / `proposed`
|
|
209
|
-
|
|
210
|
-
## Rastreamento
|
|
211
|
-
- Issue: #123
|
|
212
|
-
- Commit: abc1234
|
|
213
|
-
- PR: #456
|
|
214
|
-
```
|
|
215
|
-
|
|
216
|
-
**[ADR-002] Sistema de versionamento e impacto**
|
|
217
|
-
- Cada ADR recebe ID único (ADR-0001, ADR-0002, etc)
|
|
218
|
-
- Versão no nome (ADR-0001-v1.md, ADR-0001-v2-superseded.md)
|
|
219
|
-
- Tabela de impacto: qual código/documentação mudou
|
|
220
|
-
|
|
221
|
-
**[ADR-003] Decisões registradas no banco**
|
|
222
|
-
- Sync automático: script lê ADR-*.md e popula tabela `decisions`
|
|
223
|
-
- Query: listar decisões por data, status, impacto
|
|
224
|
-
- Relatório: "Decisões críticas dos últimos 30 dias"
|
|
225
|
-
|
|
226
|
-
**[ADR-004] Integração com handoff**
|
|
227
|
-
- Handoff deve referenciar ADRs impactadas: "Veja ADR-0003 para context"
|
|
228
|
-
- ADRs devem listar handoffs relacionados
|
|
229
|
-
- Bidirecional
|
|
230
|
-
|
|
231
|
-
### Decisões
|
|
232
|
-
- ✅ **ADR com status lifecycle**: rastreabilidade
|
|
233
|
-
- ✅ **Impacto explícito**: facilita revisão de risco
|
|
234
|
-
- ✅ **Versioning**: permite evolução sem perder histórico
|
|
235
|
-
|
|
236
|
-
---
|
|
237
|
-
|
|
238
|
-
## 📚 5. Gestão de Memória (Compactação & Handoff)
|
|
239
|
-
|
|
240
|
-
### Status Atual
|
|
241
|
-
- Compactação: build-context-pack.mjs concatena 6 arquivos prioritários
|
|
242
|
-
- Handoff: template básico, sem estrutura de validação
|
|
243
|
-
- Recovery: `memory-db-query.mjs` faz busca genérica
|
|
244
|
-
- Sem análise de "size creep"
|
|
245
|
-
|
|
246
|
-
### Melhoras Tier 1
|
|
247
|
-
**[MEM-001] Compactação inteligente em 3 níveis**
|
|
248
|
-
```
|
|
249
|
-
Level 1 (Minimal): 500 tokens
|
|
250
|
-
- mission.md + standards.md + current-sprint.md
|
|
251
|
-
|
|
252
|
-
Level 2 (Standard): 2000 tokens
|
|
253
|
-
- L1 + 20-architecture + 70-summaries/global
|
|
254
|
-
|
|
255
|
-
Level 3 (Full): 8000+ tokens
|
|
256
|
-
- L2 + domain/* + handoffs/
|
|
257
|
-
|
|
258
|
-
Seleção automática: usuário escolhe nível ou sistema elige conforme modelo.
|
|
259
|
-
```
|
|
260
|
-
|
|
261
|
-
**[MEM-002] Compactação com preservação de estrutura**
|
|
262
|
-
- Adicionar metadata JSON: `{ "sections": [...], "tokens": 1234, "checksum": "abc123" }`
|
|
263
|
-
- Permitir "diff" entre versões de context-pack
|
|
264
|
-
- Detectar mudanças significativas (novo capítulo, alteração crítica)
|
|
265
|
-
|
|
266
|
-
**[MEM-003] Handoff com contexto mínimo garantido**
|
|
267
|
-
- Template obrigatório: 7 campos
|
|
268
|
-
- Validação: deve incluir "próximo passo" explícito
|
|
269
|
-
- Sistema recusa handoff incompleto
|
|
270
|
-
|
|
271
|
-
**[MEM-004] Recovery inteligente**
|
|
272
|
-
- Se agente volta do contexto incompleto, script sugere contexto adicional
|
|
273
|
-
- Cache local: docs carregadas recentemente reutilizadas
|
|
274
|
-
- Rastreamento: "Último contexto carregado: 2h atrás, 4 mudanças pendentes"
|
|
275
|
-
|
|
276
|
-
**[MEM-005] Análise de "tamanho creep"**
|
|
277
|
-
- Script mensal: "memory size analysis"
|
|
278
|
-
- Alerta se memory > 20MB (sinal de documentação não compactada)
|
|
279
|
-
- Recomendação: arquivar e.g. handoffs antigos (> 3 meses)
|
|
280
|
-
|
|
281
|
-
### Decisões
|
|
282
|
-
- ✅ **3 níveis de compactação**: flexível para diferentes contextos
|
|
283
|
-
- ✅ **7 campos obrigatórios no handoff**: qualidade mínima
|
|
284
|
-
- ✅ **Metadata com checksum**: detecta mudanças
|
|
285
|
-
|
|
286
|
-
---
|
|
287
|
-
|
|
288
|
-
## 📖 6. Documentação de Produto (Padrão Profissional)
|
|
289
|
-
|
|
290
|
-
### Status Atual
|
|
291
|
-
- Documentação: 478 linhas em docs/, aleatória
|
|
292
|
-
- Sem padrão de qualidade
|
|
293
|
-
- Sem "getting started" estruturado
|
|
294
|
-
- Sem diagrama/visual
|
|
295
|
-
|
|
296
|
-
### Melhoras Tier 1
|
|
297
|
-
**[DOC-001] Estrutura de documentação tipo Stripe/Vercel**
|
|
298
|
-
```
|
|
299
|
-
📚 Documentação Root
|
|
300
|
-
├─ 📄 Getting Started (5 min)
|
|
301
|
-
│ ├─ O que é
|
|
302
|
-
│ ├─ Instalação 3 linhas
|
|
303
|
-
│ ├─ "Hello World"
|
|
304
|
-
│ └─ Próximos passos
|
|
305
|
-
├─ 🏗️ Conceitos Fundamentais
|
|
306
|
-
│ ├─ Memória Hierárquica
|
|
307
|
-
│ ├─ Agentes e Roles
|
|
308
|
-
│ ├─ Orquestração
|
|
309
|
-
│ └─ Handoff & Continuidade
|
|
310
|
-
├─ 🔧 Guia de Uso
|
|
311
|
-
│ ├─ Criar Novo Projeto
|
|
312
|
-
│ ├─ Adicionar Domínio
|
|
313
|
-
│ ├─ Configurar Agentes
|
|
314
|
-
│ └─ Usar Scripts
|
|
315
|
-
├─ 🎓 Tutoriais
|
|
316
|
-
│ ├─ [Caso 1] Projeto com 1 backend + 1 worker
|
|
317
|
-
│ ├─ [Caso 2] Projeto com múltiplos domínios
|
|
318
|
-
│ └─ [Caso 3] Integração com seu CLI favorito
|
|
319
|
-
├─ 🔍 Referência API
|
|
320
|
-
│ ├─ CLI flags
|
|
321
|
-
│ ├─ Memory structure
|
|
322
|
-
│ └─ Database schema
|
|
323
|
-
├─ ⚙️ Configuração Avançada
|
|
324
|
-
│ ├─ Custom agents
|
|
325
|
-
│ ├─ Model-specific tuning
|
|
326
|
-
│ └─ Security hardening
|
|
327
|
-
└─ ❓ FAQ & Troubleshooting
|
|
328
|
-
```
|
|
329
|
-
|
|
330
|
-
**[DOC-002] Padrão de escrita**
|
|
331
|
-
- Cada arquivo: < 500 linhas
|
|
332
|
-
- Títulos H1-H3 apenas
|
|
333
|
-
- Code samples: 5-10 linhas máximo, contexto claro
|
|
334
|
-
- Links internos: `[topic](../path/to/doc.md)`
|
|
335
|
-
- "Próximo passo" em todo artigo
|
|
336
|
-
|
|
337
|
-
**[DOC-003] Diagramas em ASCII + Mermaid**
|
|
338
|
-
- Arquitetura: diagram ASCII em README
|
|
339
|
-
- Fluxo de agentes: Mermaid graph
|
|
340
|
-
- Memory hierarchy: tree ASCII
|
|
341
|
-
|
|
342
|
-
**[DOC-004] Changelog estruturado**
|
|
343
|
-
- Arquivo: `docs/CHANGELOG.md`
|
|
344
|
-
- Versão: major.minor.patch
|
|
345
|
-
- Seções: Added, Changed, Deprecated, Removed, Fixed, Security
|
|
346
|
-
- Link para ADRs relacionadas
|
|
347
|
-
|
|
348
|
-
**[DOC-005] Contributing Guide**
|
|
349
|
-
- Padrão de branches: `feat/`, `fix/`, `docs/`
|
|
350
|
-
- Commit message: `[type] Description`
|
|
351
|
-
- PR template: checklist + referência a ADR
|
|
352
|
-
- Teste: instruções passo a passo
|
|
353
|
-
|
|
354
|
-
### Decisões
|
|
355
|
-
- ✅ **Estrutura em camadas**: escalável
|
|
356
|
-
- ✅ **Padrão Stripe/Vercel**: familiar, profissional
|
|
357
|
-
- ✅ **Diagrama + texto**: clareza
|
|
358
|
-
|
|
359
|
-
---
|
|
360
|
-
|
|
361
|
-
## ⚙️ 7. Metodologia Ágil (Sprint & Entregáveis)
|
|
362
|
-
|
|
363
|
-
### Status Atual
|
|
364
|
-
- Template de sprint: `current-sprint.md` básico
|
|
365
|
-
- Sem estrutura de planning, retrospectiva
|
|
366
|
-
- Sem definição de "pronto"
|
|
367
|
-
- Sem métricas de velocidade
|
|
368
|
-
|
|
369
|
-
### Melhoras Tier 1
|
|
370
|
-
**[AGILE-001] Estrutura de sprint**
|
|
371
|
-
```
|
|
372
|
-
# Sprint NN (Data início - Data fim)
|
|
373
|
-
|
|
374
|
-
## Objetivo (1-2 frases)
|
|
375
|
-
[O que queremos conseguir]
|
|
376
|
-
|
|
377
|
-
## Capacidade
|
|
378
|
-
- Devs: 2 pessoas × 5 dias × 6h = 60 horas
|
|
379
|
-
- QA: 1 pessoa × 5 dias × 4h = 20 horas
|
|
380
|
-
- Total: 80 horas
|
|
381
|
-
|
|
382
|
-
## User Stories
|
|
383
|
-
### [ID] Título
|
|
384
|
-
- Como [ator]
|
|
385
|
-
- Quero [ação]
|
|
386
|
-
- Para [benefício]
|
|
387
|
-
- AC1: [critério]
|
|
388
|
-
- AC2: [critério]
|
|
389
|
-
- Estimativa: [horas]
|
|
390
|
-
- Dono: [person]
|
|
391
|
-
- Status: `todo` / `in-progress` / `review` / `done`
|
|
392
|
-
|
|
393
|
-
## Riscos Sprint
|
|
394
|
-
| Risco | Impacto | Mitigation |
|
|
395
|
-
|-------|---------|-----------|
|
|
396
|
-
| ... | ... | ... |
|
|
397
|
-
|
|
398
|
-
## Métricas
|
|
399
|
-
- Velocity: NN story points
|
|
400
|
-
- Burn down: conforme esperado
|
|
401
|
-
- Bugs encontrados: NN
|
|
402
|
-
```
|
|
403
|
-
|
|
404
|
-
**[AGILE-002] Definição de "Pronto" (Definition of Done)**
|
|
405
|
-
```
|
|
406
|
-
- Código implementado
|
|
407
|
-
- Testes escritos (cobertura > 80%)
|
|
408
|
-
- Code review + approval
|
|
409
|
-
- Documentação atualizada
|
|
410
|
-
- ADR criado (se mudança estrutural)
|
|
411
|
-
- Handoff registrado (se cross-agent)
|
|
412
|
-
- Passou em CI/CD
|
|
413
|
-
- Deploy para staging
|
|
414
|
-
```
|
|
415
|
-
|
|
416
|
-
**[AGILE-003] Estrutura de ceremônias**
|
|
417
|
-
- Planning (2h): decomposição de stories
|
|
418
|
-
- Standup diário (15min): sync
|
|
419
|
-
- Review (1h): demo + feedback
|
|
420
|
-
- Retro (1h): o que foi bem, o que melhorar, ações
|
|
421
|
-
|
|
422
|
-
**[AGILE-004] Matriz de rastreamento**
|
|
423
|
-
- Integrar com `improvement_items` no BD
|
|
424
|
-
- Query: status de todas as melhoras
|
|
425
|
-
- Dashboard: % completo por categoria
|
|
426
|
-
|
|
427
|
-
**[AGILE-005] Release notes profissional**
|
|
428
|
-
- Template: v0.2.0 (YYYY-MM-DD)
|
|
429
|
-
- Seções: Features, Improvements, Fixes, Breaking Changes
|
|
430
|
-
- Incluir: migration guide (se necessário)
|
|
431
|
-
|
|
432
|
-
### Decisões
|
|
433
|
-
- ✅ **User stories com AC**: clareza de aceite
|
|
434
|
-
- ✅ **Definition of Done explícito**: qualidade
|
|
435
|
-
- ✅ **Rastreamento em BD**: visibilidade
|
|
436
|
-
|
|
437
|
-
---
|
|
438
|
-
|
|
439
|
-
## 📊 8. Observabilidade (Logs, Métricas, Tracing)
|
|
440
|
-
|
|
441
|
-
### Status Atual
|
|
442
|
-
- Logs: genéricos, sem estrutura
|
|
443
|
-
- Métricas: ausentes
|
|
444
|
-
- Tracing: não existe
|
|
445
|
-
- Observabilidade de agentes: 0
|
|
446
|
-
|
|
447
|
-
### Melhoras Tier 1
|
|
448
|
-
**[OBS-001] Logs estruturados com contexto**
|
|
449
|
-
```json
|
|
450
|
-
{
|
|
451
|
-
"timestamp": "2026-04-21T09:51:33.423Z",
|
|
452
|
-
"level": "info",
|
|
453
|
-
"agent": "orchestrator",
|
|
454
|
-
"task_id": "task-123",
|
|
455
|
-
"action": "task_decomposed",
|
|
456
|
-
"owner_count": 3,
|
|
457
|
-
"duration_ms": 245,
|
|
458
|
-
"context": {
|
|
459
|
-
"file_count": 12,
|
|
460
|
-
"size_bytes": 45000
|
|
461
|
-
}
|
|
462
|
-
}
|
|
463
|
-
```
|
|
464
|
-
|
|
465
|
-
**[OBS-002] Decorator para log estruturado em NestJS**
|
|
466
|
-
```typescript
|
|
467
|
-
@LogStructured('backend-nest', 'implement_endpoint')
|
|
468
|
-
async createUser(dto: CreateUserDto) {
|
|
469
|
-
// Log automático com agent, ação, duração, resultado
|
|
470
|
-
}
|
|
471
|
-
```
|
|
472
|
-
|
|
473
|
-
**[OBS-003] Métricas de agentes**
|
|
474
|
-
- `agent_task_count`: quantas tarefas por agente
|
|
475
|
-
- `agent_success_rate`: % de sucesso (com base em handoff quality)
|
|
476
|
-
- `agent_context_size`: tamanho médio de contexto carregado
|
|
477
|
-
- `handoff_quality_score`: 1-10 baseado em preenchimento
|
|
478
|
-
|
|
479
|
-
**[OBS-004] Tracing de handoff**
|
|
480
|
-
- Cada handoff recebe ID único: `handoff-uuid-timestamp`
|
|
481
|
-
- Trace: orchestrator -> worker-a -> reviewer -> worker-b
|
|
482
|
-
- Latência entre handoffs: rastreada
|
|
483
|
-
- Alertas: handoff aberto > 1h
|
|
484
|
-
|
|
485
|
-
**[OBS-005] Dashboard de observabilidade**
|
|
486
|
-
- Script: `backend/scripts/memory-db-observability.mjs`
|
|
487
|
-
- Queries pré-prontas:
|
|
488
|
-
- "Handoffs abertos"
|
|
489
|
-
- "Agente com menor taxa de sucesso"
|
|
490
|
-
- "Documentação > 20MB"
|
|
491
|
-
- "ADRs sem impacto vinculado"
|
|
492
|
-
|
|
493
|
-
### Decisões
|
|
494
|
-
- ✅ **Logs estruturados em JSON**: parseável
|
|
495
|
-
- ✅ **Decorator para automação**: menos boilerplate
|
|
496
|
-
- ✅ **Métricas por agente**: visibilidade
|
|
497
|
-
|
|
498
|
-
---
|
|
499
|
-
|
|
500
|
-
## 📈 Roadmap de Implementação
|
|
501
|
-
|
|
502
|
-
### Fase 1 (Semanas 1-2): Tier 1 Foundation
|
|
503
|
-
- [ ] SEC-001, SEC-002: Validação + Rate-limiting
|
|
504
|
-
- [ ] AGENT-001, AGENT-002: Prompts estruturados
|
|
505
|
-
- [ ] AI-OPT-001: Context packing model-aware
|
|
506
|
-
- [ ] ADR-001: Estrutura robusta
|
|
507
|
-
- [ ] MEM-001: 3 níveis de compactação
|
|
508
|
-
- [ ] DOC-001: Estrutura de documentação
|
|
509
|
-
- [ ] AGILE-001, AGILE-002: Sprint template + DoD
|
|
510
|
-
- [ ] OBS-001: Logs estruturados
|
|
511
|
-
|
|
512
|
-
### Fase 2 (Semanas 3-4): Tier 1 Completion
|
|
513
|
-
- [ ] SEC-003, SEC-004: Sanitização + Testes
|
|
514
|
-
- [ ] AGENT-003, AGENT-004, AGENT-005: Handoff, roteamento, schema
|
|
515
|
-
- [ ] AI-OPT-002 até AI-OPT-005: Advanced AI optimization
|
|
516
|
-
- [ ] ADR-002, ADR-003, ADR-004: Versionamento + BD + integração
|
|
517
|
-
- [ ] MEM-002 até MEM-005: Compactação inteligente + recovery
|
|
518
|
-
- [ ] DOC-002 até DOC-005: Padrão + diagramas + changelog
|
|
519
|
-
- [ ] AGILE-003, AGILE-004, AGILE-005: Ceremônias + matriz + release notes
|
|
520
|
-
- [ ] OBS-002 até OBS-005: Decorator + métricas + tracing + dashboard
|
|
521
|
-
|
|
522
|
-
### Fase 3 (Semanas 5-6): Tier 2 + Integração
|
|
523
|
-
- Documentação de Produto (completa)
|
|
524
|
-
- Metodologia Ágil (full ceremonies)
|
|
525
|
-
- Observabilidade (full stack)
|
|
526
|
-
|
|
527
|
-
---
|
|
528
|
-
|
|
529
|
-
## 💾 Rastreamento em Banco de Dados
|
|
530
|
-
|
|
531
|
-
Todos os items estão registrados na tabela `improvement_items`:
|
|
532
|
-
|
|
533
|
-
```sql
|
|
534
|
-
SELECT * FROM improvement_items
|
|
535
|
-
WHERE status != 'done'
|
|
536
|
-
ORDER BY area_id, complexity;
|
|
537
|
-
|
|
538
|
-
-- Atualizar status conforme progresso
|
|
539
|
-
UPDATE improvement_items SET status = 'in_progress'
|
|
540
|
-
WHERE id = 'SEC-001';
|
|
541
|
-
```
|
|
542
|
-
|
|
543
|
-
Decisões vinculadas em `decisions`:
|
|
544
|
-
|
|
545
|
-
```sql
|
|
546
|
-
SELECT d.* FROM decisions d
|
|
547
|
-
JOIN improvement_items i ON d.item_id = i.id
|
|
548
|
-
WHERE i.area_id = 'ai-optimization'
|
|
549
|
-
ORDER BY d.created_at DESC;
|
|
550
|
-
```
|
|
551
|
-
|
|
552
|
-
---
|
|
553
|
-
|
|
554
|
-
## ✨ Próximos Passos
|
|
555
|
-
|
|
556
|
-
1. **Review este documento** com stakeholders
|
|
557
|
-
2. **Ajustar prioridades** se necessário
|
|
558
|
-
3. **Começar Fase 1** na próxima sprint
|
|
559
|
-
4. **Atualizar BD** conforme progresso
|
|
560
|
-
5. **Documentar decisões** em ADRs quando relevante
|
|
561
|
-
|
|
562
|
-
---
|
|
563
|
-
|
|
564
|
-
**Versão**: 1.0 | **Data**: 2026-04-21 | **Autor**: Copilot Analysis | **Status**: Aceito para Implementação
|
|
565
|
-
|
|
1
|
+
# Refinamento de Agentes Orquestrados - Especificação de Melhoras v1.0
|
|
2
|
+
|
|
3
|
+
Documento vivo com decisões, padrões e implementações para elevar o kit a padrão profissional.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 🎯 1. Qualidade & Segurança
|
|
8
|
+
|
|
9
|
+
### Status Atual
|
|
10
|
+
- Testes: básicos (apenas app.controller.spec.ts na geração NestJS)
|
|
11
|
+
- Validação: DTO com `class-validator` disponível, não obrigatório
|
|
12
|
+
- Segurança: documentação (security.md) mas sem implementação forçada
|
|
13
|
+
- Sanitização: ausente
|
|
14
|
+
|
|
15
|
+
### Melhoras Tier 1
|
|
16
|
+
**[SEC-001] Adicionar validação obrigatória em rotas**
|
|
17
|
+
- Toda rota deve usar DTOs com `@IsString()`, `@IsEmail()`, etc
|
|
18
|
+
- Tratamento de erro estruturado (HttpException com código específico)
|
|
19
|
+
- Template de DTO gerado automaticamente
|
|
20
|
+
|
|
21
|
+
**[SEC-002] Implementar rate-limiting no gerador**
|
|
22
|
+
- Gerar middleware de rate-limiting no backend
|
|
23
|
+
- Config: 100 req/min por IP por padrão
|
|
24
|
+
- Template pronto em `backend/src/middleware/rate-limit.ts`
|
|
25
|
+
|
|
26
|
+
**[SEC-003] Sanitização de entrada**
|
|
27
|
+
- Remover caracteres perigosos em strings de entrada
|
|
28
|
+
- Validar tamanho máximo de payloads (10MB por padrão)
|
|
29
|
+
- Usar `helmet` no NestJS
|
|
30
|
+
|
|
31
|
+
**[SEC-004] Testes obrigatórios**
|
|
32
|
+
- Gerar `*.spec.ts` para todo controller novo
|
|
33
|
+
- Coverage mínimo: 80% em rotas críticas
|
|
34
|
+
- Incluir testes de segurança (SQL injection, XSS simulation)
|
|
35
|
+
|
|
36
|
+
### Decisões
|
|
37
|
+
- ✅ **Usar class-validator + class-transformer**: padrão NestJS, suporta nestação
|
|
38
|
+
- ✅ **Helmet para headers de segurança**: reduz vetores de ataque
|
|
39
|
+
- ✅ **Coverage mínimo 80%**: viável em projetos novos
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 🧠 2. Design de Agentes
|
|
44
|
+
|
|
45
|
+
### Status Atual
|
|
46
|
+
- Agentes: 7 tipos (orchestrator, backend-nest, frontend, dba, security, reviewer, sem specialistas adicionais)
|
|
47
|
+
- Prompts: 3 templates genéricos, muito curtos
|
|
48
|
+
- Comunicação: contrato explícito no AGENTS.md mas pouco estruturado
|
|
49
|
+
- Especialização: baixa (agentes genéricos)
|
|
50
|
+
|
|
51
|
+
### Melhoras Tier 1
|
|
52
|
+
**[AGENT-001] Criar especificação estruturada de agentes**
|
|
53
|
+
```
|
|
54
|
+
Cada agente terá:
|
|
55
|
+
- ID único (ex: agent-backend-nest-v1)
|
|
56
|
+
- Missão clara (1-2 frases)
|
|
57
|
+
- Entrada esperada (formato, tamanho, estrutura)
|
|
58
|
+
- Saída esperada (formato, qualidade, critério de aceite)
|
|
59
|
+
- Contexto prioritário (quais docs ler)
|
|
60
|
+
- Proibições explícitas (o que NÃO fazer)
|
|
61
|
+
- Escala: 1-10 (complexidade, especificidade)
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
**[AGENT-002] Melhorar prompts com estrutura de contexto**
|
|
65
|
+
- Adicionar seção: "Você é especialista em [domínio]"
|
|
66
|
+
- Incluir exemplos de input/output (few-shot)
|
|
67
|
+
- Definir tom (formal, técnico, direto)
|
|
68
|
+
- Incluir checklist de validação final
|
|
69
|
+
|
|
70
|
+
**[AGENT-003] Protocolo de handoff estruturado**
|
|
71
|
+
- Formato obrigatório com 7 campos (contexto, mudanças, riscos, pendências, próximo passo, checklist, metadados)
|
|
72
|
+
- Validação de handoff antes de aceitar (revisor detecta gaps)
|
|
73
|
+
- Template em `memory/50-orchestration/handoff-template.md`
|
|
74
|
+
|
|
75
|
+
**[AGENT-004] Roteamento inteligente de tarefas**
|
|
76
|
+
- Matriz de compatibilidade: tarefa -> agentes capazes
|
|
77
|
+
- Score de "fit" (expertise match, carga atual, contexto carregado)
|
|
78
|
+
- Orquestrador escolhe melhor agente automaticamente
|
|
79
|
+
|
|
80
|
+
**[AGENT-005] Contrato de agentes em JSON Schema**
|
|
81
|
+
- Definir input/output como JSON Schema
|
|
82
|
+
- Validar payloads antes de enviar para agente
|
|
83
|
+
- Permitir "strict" mode (erro se saída não match)
|
|
84
|
+
|
|
85
|
+
### Decisões
|
|
86
|
+
- ✅ **JSON Schema para contratos**: interoperável, validável
|
|
87
|
+
- ✅ **7 campos obrigatórios no handoff**: reduz gaps e retrabalho
|
|
88
|
+
- ✅ **Few-shot em prompts**: aumenta qualidade de resposta 30-50%
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## 🤖 3. Otimização para IAs (Copilot/Gemini/Codex/Claude)
|
|
93
|
+
|
|
94
|
+
### Status Atual
|
|
95
|
+
- Contexto: compactação básica (build-context-pack.mjs)
|
|
96
|
+
- Prompts: genéricos, sem otimização para modelos específicos
|
|
97
|
+
- Rastreamento: não há detecção de qual modelo está usando
|
|
98
|
+
- Estrutura: Markdown, sem hints de estrutura semântica
|
|
99
|
+
|
|
100
|
+
### Melhoras Tier 1
|
|
101
|
+
**[AI-OPT-001] Context packing com model-aware**
|
|
102
|
+
- Detectar modelo via header HTTP ou variável env
|
|
103
|
+
- Ajustar tamanho do context-pack conforme modelo (Claude: 100k, GPT-4: 8k, Gemini: 32k)
|
|
104
|
+
- Priorizar docs conforme modelo (IA legal: segurança; IA dev: código)
|
|
105
|
+
|
|
106
|
+
**[AI-OPT-002] Estrutura de prompt "Instruction Bundle"**
|
|
107
|
+
```markdown
|
|
108
|
+
# [ID] Tarefa
|
|
109
|
+
## 👤 Contexto
|
|
110
|
+
- Você é: [especialista]
|
|
111
|
+
- Objetivo: [claro]
|
|
112
|
+
|
|
113
|
+
## 📥 Entrada
|
|
114
|
+
- Formato: [structure]
|
|
115
|
+
- Restrições: [limits]
|
|
116
|
+
|
|
117
|
+
## 📤 Saída esperada
|
|
118
|
+
- Formato: [structure]
|
|
119
|
+
- Validação: [checklist]
|
|
120
|
+
|
|
121
|
+
## 🚫 Proibições
|
|
122
|
+
- NUNCA fazer: [list]
|
|
123
|
+
|
|
124
|
+
## ✅ Checklist Final
|
|
125
|
+
- [ ] Step 1
|
|
126
|
+
- [ ] Step 2
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
**[AI-OPT-003] Integração com .context/model-config.yml**
|
|
130
|
+
```yaml
|
|
131
|
+
models:
|
|
132
|
+
claude:
|
|
133
|
+
max_tokens: 100000
|
|
134
|
+
priority_sections: [global, architecture]
|
|
135
|
+
prompt_style: structured
|
|
136
|
+
gpt-4:
|
|
137
|
+
max_tokens: 8000
|
|
138
|
+
priority_sections: [current-task]
|
|
139
|
+
prompt_style: concise
|
|
140
|
+
gemini:
|
|
141
|
+
max_tokens: 32000
|
|
142
|
+
priority_sections: [global, domain]
|
|
143
|
+
prompt_style: narrative
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
**[AI-OPT-004] Memory compression com inline links**
|
|
147
|
+
- Em vez de copiar conteúdo inteiro, usar referências: `[[ref:memory/10-product/vision.md:l1-20]]`
|
|
148
|
+
- IAs entendem contexto com links
|
|
149
|
+
- Reduz tamanho do prompt 60-70%
|
|
150
|
+
|
|
151
|
+
**[AI-OPT-005] Strict mode para output**
|
|
152
|
+
- Definir JSON Schema obrigatório
|
|
153
|
+
- IA deve validar contra schema antes de responder
|
|
154
|
+
- Se não match: recusar e explicar por quê
|
|
155
|
+
|
|
156
|
+
### Decisões
|
|
157
|
+
- ✅ **JSON Schema para contratos**: validável por qualquer IA
|
|
158
|
+
- ✅ **Model-aware context packing**: otimiza para cada modelo
|
|
159
|
+
- ✅ **Instruction Bundle format**: estrutura clara, reduz alucinação
|
|
160
|
+
- ⚠️ **Inline links**: depende de suporte do modelo (Claude sim, GPT-4 parcial)
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## 📋 4. ADR & Sistema de Decisões Inteligentes
|
|
165
|
+
|
|
166
|
+
### Status Atual
|
|
167
|
+
- Template: basic (ADR-0001-template.md)
|
|
168
|
+
- Rastreamento: banco tem tabela `adrs` mas vazia
|
|
169
|
+
- Sem validação de qualidade
|
|
170
|
+
- Sem rastreamento de impacto
|
|
171
|
+
|
|
172
|
+
### Melhoras Tier 1
|
|
173
|
+
**[ADR-001] Estrutura robusta de ADR**
|
|
174
|
+
```
|
|
175
|
+
# ADR-NNNN: [Título conciso]
|
|
176
|
+
|
|
177
|
+
## Data
|
|
178
|
+
2026-04-21
|
|
179
|
+
|
|
180
|
+
## Contexto
|
|
181
|
+
[Por que estamos decidindo isso agora?]
|
|
182
|
+
[Constraints técnicas e de negócio]
|
|
183
|
+
[Quem precisa saber]
|
|
184
|
+
|
|
185
|
+
## Questão
|
|
186
|
+
[Qual exatamente é a decisão?]
|
|
187
|
+
|
|
188
|
+
## Opções Consideradas
|
|
189
|
+
### Opção A: [Nome]
|
|
190
|
+
- ✅ Pros
|
|
191
|
+
- ❌ Cons
|
|
192
|
+
- 💰 Custo
|
|
193
|
+
- ⏱️ Tempo
|
|
194
|
+
|
|
195
|
+
### Opção B: [Nome]
|
|
196
|
+
...
|
|
197
|
+
|
|
198
|
+
## Decisão
|
|
199
|
+
[Qual escolhemos e por quê]
|
|
200
|
+
|
|
201
|
+
## Impacto Esperado
|
|
202
|
+
- Arquitetura: [mudanças]
|
|
203
|
+
- Equipe: [skill necessária]
|
|
204
|
+
- Cronograma: [efeito]
|
|
205
|
+
- Risco: [novo risco]
|
|
206
|
+
|
|
207
|
+
## Status
|
|
208
|
+
- `accepted` / `deprecated` / `superseded` / `proposed`
|
|
209
|
+
|
|
210
|
+
## Rastreamento
|
|
211
|
+
- Issue: #123
|
|
212
|
+
- Commit: abc1234
|
|
213
|
+
- PR: #456
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
**[ADR-002] Sistema de versionamento e impacto**
|
|
217
|
+
- Cada ADR recebe ID único (ADR-0001, ADR-0002, etc)
|
|
218
|
+
- Versão no nome (ADR-0001-v1.md, ADR-0001-v2-superseded.md)
|
|
219
|
+
- Tabela de impacto: qual código/documentação mudou
|
|
220
|
+
|
|
221
|
+
**[ADR-003] Decisões registradas no banco**
|
|
222
|
+
- Sync automático: script lê ADR-*.md e popula tabela `decisions`
|
|
223
|
+
- Query: listar decisões por data, status, impacto
|
|
224
|
+
- Relatório: "Decisões críticas dos últimos 30 dias"
|
|
225
|
+
|
|
226
|
+
**[ADR-004] Integração com handoff**
|
|
227
|
+
- Handoff deve referenciar ADRs impactadas: "Veja ADR-0003 para context"
|
|
228
|
+
- ADRs devem listar handoffs relacionados
|
|
229
|
+
- Bidirecional
|
|
230
|
+
|
|
231
|
+
### Decisões
|
|
232
|
+
- ✅ **ADR com status lifecycle**: rastreabilidade
|
|
233
|
+
- ✅ **Impacto explícito**: facilita revisão de risco
|
|
234
|
+
- ✅ **Versioning**: permite evolução sem perder histórico
|
|
235
|
+
|
|
236
|
+
---
|
|
237
|
+
|
|
238
|
+
## 📚 5. Gestão de Memória (Compactação & Handoff)
|
|
239
|
+
|
|
240
|
+
### Status Atual
|
|
241
|
+
- Compactação: build-context-pack.mjs concatena 6 arquivos prioritários
|
|
242
|
+
- Handoff: template básico, sem estrutura de validação
|
|
243
|
+
- Recovery: `memory-db-query.mjs` faz busca genérica
|
|
244
|
+
- Sem análise de "size creep"
|
|
245
|
+
|
|
246
|
+
### Melhoras Tier 1
|
|
247
|
+
**[MEM-001] Compactação inteligente em 3 níveis**
|
|
248
|
+
```
|
|
249
|
+
Level 1 (Minimal): 500 tokens
|
|
250
|
+
- mission.md + standards.md + current-sprint.md
|
|
251
|
+
|
|
252
|
+
Level 2 (Standard): 2000 tokens
|
|
253
|
+
- L1 + 20-architecture + 70-summaries/global
|
|
254
|
+
|
|
255
|
+
Level 3 (Full): 8000+ tokens
|
|
256
|
+
- L2 + domain/* + handoffs/
|
|
257
|
+
|
|
258
|
+
Seleção automática: usuário escolhe nível ou sistema elige conforme modelo.
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
**[MEM-002] Compactação com preservação de estrutura**
|
|
262
|
+
- Adicionar metadata JSON: `{ "sections": [...], "tokens": 1234, "checksum": "abc123" }`
|
|
263
|
+
- Permitir "diff" entre versões de context-pack
|
|
264
|
+
- Detectar mudanças significativas (novo capítulo, alteração crítica)
|
|
265
|
+
|
|
266
|
+
**[MEM-003] Handoff com contexto mínimo garantido**
|
|
267
|
+
- Template obrigatório: 7 campos
|
|
268
|
+
- Validação: deve incluir "próximo passo" explícito
|
|
269
|
+
- Sistema recusa handoff incompleto
|
|
270
|
+
|
|
271
|
+
**[MEM-004] Recovery inteligente**
|
|
272
|
+
- Se agente volta do contexto incompleto, script sugere contexto adicional
|
|
273
|
+
- Cache local: docs carregadas recentemente reutilizadas
|
|
274
|
+
- Rastreamento: "Último contexto carregado: 2h atrás, 4 mudanças pendentes"
|
|
275
|
+
|
|
276
|
+
**[MEM-005] Análise de "tamanho creep"**
|
|
277
|
+
- Script mensal: "memory size analysis"
|
|
278
|
+
- Alerta se memory > 20MB (sinal de documentação não compactada)
|
|
279
|
+
- Recomendação: arquivar e.g. handoffs antigos (> 3 meses)
|
|
280
|
+
|
|
281
|
+
### Decisões
|
|
282
|
+
- ✅ **3 níveis de compactação**: flexível para diferentes contextos
|
|
283
|
+
- ✅ **7 campos obrigatórios no handoff**: qualidade mínima
|
|
284
|
+
- ✅ **Metadata com checksum**: detecta mudanças
|
|
285
|
+
|
|
286
|
+
---
|
|
287
|
+
|
|
288
|
+
## 📖 6. Documentação de Produto (Padrão Profissional)
|
|
289
|
+
|
|
290
|
+
### Status Atual
|
|
291
|
+
- Documentação: 478 linhas em docs/, aleatória
|
|
292
|
+
- Sem padrão de qualidade
|
|
293
|
+
- Sem "getting started" estruturado
|
|
294
|
+
- Sem diagrama/visual
|
|
295
|
+
|
|
296
|
+
### Melhoras Tier 1
|
|
297
|
+
**[DOC-001] Estrutura de documentação tipo Stripe/Vercel**
|
|
298
|
+
```
|
|
299
|
+
📚 Documentação Root
|
|
300
|
+
├─ 📄 Getting Started (5 min)
|
|
301
|
+
│ ├─ O que é
|
|
302
|
+
│ ├─ Instalação 3 linhas
|
|
303
|
+
│ ├─ "Hello World"
|
|
304
|
+
│ └─ Próximos passos
|
|
305
|
+
├─ 🏗️ Conceitos Fundamentais
|
|
306
|
+
│ ├─ Memória Hierárquica
|
|
307
|
+
│ ├─ Agentes e Roles
|
|
308
|
+
│ ├─ Orquestração
|
|
309
|
+
│ └─ Handoff & Continuidade
|
|
310
|
+
├─ 🔧 Guia de Uso
|
|
311
|
+
│ ├─ Criar Novo Projeto
|
|
312
|
+
│ ├─ Adicionar Domínio
|
|
313
|
+
│ ├─ Configurar Agentes
|
|
314
|
+
│ └─ Usar Scripts
|
|
315
|
+
├─ 🎓 Tutoriais
|
|
316
|
+
│ ├─ [Caso 1] Projeto com 1 backend + 1 worker
|
|
317
|
+
│ ├─ [Caso 2] Projeto com múltiplos domínios
|
|
318
|
+
│ └─ [Caso 3] Integração com seu CLI favorito
|
|
319
|
+
├─ 🔍 Referência API
|
|
320
|
+
│ ├─ CLI flags
|
|
321
|
+
│ ├─ Memory structure
|
|
322
|
+
│ └─ Database schema
|
|
323
|
+
├─ ⚙️ Configuração Avançada
|
|
324
|
+
│ ├─ Custom agents
|
|
325
|
+
│ ├─ Model-specific tuning
|
|
326
|
+
│ └─ Security hardening
|
|
327
|
+
└─ ❓ FAQ & Troubleshooting
|
|
328
|
+
```
|
|
329
|
+
|
|
330
|
+
**[DOC-002] Padrão de escrita**
|
|
331
|
+
- Cada arquivo: < 500 linhas
|
|
332
|
+
- Títulos H1-H3 apenas
|
|
333
|
+
- Code samples: 5-10 linhas máximo, contexto claro
|
|
334
|
+
- Links internos: `[topic](../path/to/doc.md)`
|
|
335
|
+
- "Próximo passo" em todo artigo
|
|
336
|
+
|
|
337
|
+
**[DOC-003] Diagramas em ASCII + Mermaid**
|
|
338
|
+
- Arquitetura: diagram ASCII em README
|
|
339
|
+
- Fluxo de agentes: Mermaid graph
|
|
340
|
+
- Memory hierarchy: tree ASCII
|
|
341
|
+
|
|
342
|
+
**[DOC-004] Changelog estruturado**
|
|
343
|
+
- Arquivo: `docs/CHANGELOG.md`
|
|
344
|
+
- Versão: major.minor.patch
|
|
345
|
+
- Seções: Added, Changed, Deprecated, Removed, Fixed, Security
|
|
346
|
+
- Link para ADRs relacionadas
|
|
347
|
+
|
|
348
|
+
**[DOC-005] Contributing Guide**
|
|
349
|
+
- Padrão de branches: `feat/`, `fix/`, `docs/`
|
|
350
|
+
- Commit message: `[type] Description`
|
|
351
|
+
- PR template: checklist + referência a ADR
|
|
352
|
+
- Teste: instruções passo a passo
|
|
353
|
+
|
|
354
|
+
### Decisões
|
|
355
|
+
- ✅ **Estrutura em camadas**: escalável
|
|
356
|
+
- ✅ **Padrão Stripe/Vercel**: familiar, profissional
|
|
357
|
+
- ✅ **Diagrama + texto**: clareza
|
|
358
|
+
|
|
359
|
+
---
|
|
360
|
+
|
|
361
|
+
## ⚙️ 7. Metodologia Ágil (Sprint & Entregáveis)
|
|
362
|
+
|
|
363
|
+
### Status Atual
|
|
364
|
+
- Template de sprint: `current-sprint.md` básico
|
|
365
|
+
- Sem estrutura de planning, retrospectiva
|
|
366
|
+
- Sem definição de "pronto"
|
|
367
|
+
- Sem métricas de velocidade
|
|
368
|
+
|
|
369
|
+
### Melhoras Tier 1
|
|
370
|
+
**[AGILE-001] Estrutura de sprint**
|
|
371
|
+
```
|
|
372
|
+
# Sprint NN (Data início - Data fim)
|
|
373
|
+
|
|
374
|
+
## Objetivo (1-2 frases)
|
|
375
|
+
[O que queremos conseguir]
|
|
376
|
+
|
|
377
|
+
## Capacidade
|
|
378
|
+
- Devs: 2 pessoas × 5 dias × 6h = 60 horas
|
|
379
|
+
- QA: 1 pessoa × 5 dias × 4h = 20 horas
|
|
380
|
+
- Total: 80 horas
|
|
381
|
+
|
|
382
|
+
## User Stories
|
|
383
|
+
### [ID] Título
|
|
384
|
+
- Como [ator]
|
|
385
|
+
- Quero [ação]
|
|
386
|
+
- Para [benefício]
|
|
387
|
+
- AC1: [critério]
|
|
388
|
+
- AC2: [critério]
|
|
389
|
+
- Estimativa: [horas]
|
|
390
|
+
- Dono: [person]
|
|
391
|
+
- Status: `todo` / `in-progress` / `review` / `done`
|
|
392
|
+
|
|
393
|
+
## Riscos Sprint
|
|
394
|
+
| Risco | Impacto | Mitigation |
|
|
395
|
+
|-------|---------|-----------|
|
|
396
|
+
| ... | ... | ... |
|
|
397
|
+
|
|
398
|
+
## Métricas
|
|
399
|
+
- Velocity: NN story points
|
|
400
|
+
- Burn down: conforme esperado
|
|
401
|
+
- Bugs encontrados: NN
|
|
402
|
+
```
|
|
403
|
+
|
|
404
|
+
**[AGILE-002] Definição de "Pronto" (Definition of Done)**
|
|
405
|
+
```
|
|
406
|
+
- Código implementado
|
|
407
|
+
- Testes escritos (cobertura > 80%)
|
|
408
|
+
- Code review + approval
|
|
409
|
+
- Documentação atualizada
|
|
410
|
+
- ADR criado (se mudança estrutural)
|
|
411
|
+
- Handoff registrado (se cross-agent)
|
|
412
|
+
- Passou em CI/CD
|
|
413
|
+
- Deploy para staging
|
|
414
|
+
```
|
|
415
|
+
|
|
416
|
+
**[AGILE-003] Estrutura de ceremônias**
|
|
417
|
+
- Planning (2h): decomposição de stories
|
|
418
|
+
- Standup diário (15min): sync
|
|
419
|
+
- Review (1h): demo + feedback
|
|
420
|
+
- Retro (1h): o que foi bem, o que melhorar, ações
|
|
421
|
+
|
|
422
|
+
**[AGILE-004] Matriz de rastreamento**
|
|
423
|
+
- Integrar com `improvement_items` no BD
|
|
424
|
+
- Query: status de todas as melhoras
|
|
425
|
+
- Dashboard: % completo por categoria
|
|
426
|
+
|
|
427
|
+
**[AGILE-005] Release notes profissional**
|
|
428
|
+
- Template: v0.2.0 (YYYY-MM-DD)
|
|
429
|
+
- Seções: Features, Improvements, Fixes, Breaking Changes
|
|
430
|
+
- Incluir: migration guide (se necessário)
|
|
431
|
+
|
|
432
|
+
### Decisões
|
|
433
|
+
- ✅ **User stories com AC**: clareza de aceite
|
|
434
|
+
- ✅ **Definition of Done explícito**: qualidade
|
|
435
|
+
- ✅ **Rastreamento em BD**: visibilidade
|
|
436
|
+
|
|
437
|
+
---
|
|
438
|
+
|
|
439
|
+
## 📊 8. Observabilidade (Logs, Métricas, Tracing)
|
|
440
|
+
|
|
441
|
+
### Status Atual
|
|
442
|
+
- Logs: genéricos, sem estrutura
|
|
443
|
+
- Métricas: ausentes
|
|
444
|
+
- Tracing: não existe
|
|
445
|
+
- Observabilidade de agentes: 0
|
|
446
|
+
|
|
447
|
+
### Melhoras Tier 1
|
|
448
|
+
**[OBS-001] Logs estruturados com contexto**
|
|
449
|
+
```json
|
|
450
|
+
{
|
|
451
|
+
"timestamp": "2026-04-21T09:51:33.423Z",
|
|
452
|
+
"level": "info",
|
|
453
|
+
"agent": "orchestrator",
|
|
454
|
+
"task_id": "task-123",
|
|
455
|
+
"action": "task_decomposed",
|
|
456
|
+
"owner_count": 3,
|
|
457
|
+
"duration_ms": 245,
|
|
458
|
+
"context": {
|
|
459
|
+
"file_count": 12,
|
|
460
|
+
"size_bytes": 45000
|
|
461
|
+
}
|
|
462
|
+
}
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
**[OBS-002] Decorator para log estruturado em NestJS**
|
|
466
|
+
```typescript
|
|
467
|
+
@LogStructured('backend-nest', 'implement_endpoint')
|
|
468
|
+
async createUser(dto: CreateUserDto) {
|
|
469
|
+
// Log automático com agent, ação, duração, resultado
|
|
470
|
+
}
|
|
471
|
+
```
|
|
472
|
+
|
|
473
|
+
**[OBS-003] Métricas de agentes**
|
|
474
|
+
- `agent_task_count`: quantas tarefas por agente
|
|
475
|
+
- `agent_success_rate`: % de sucesso (com base em handoff quality)
|
|
476
|
+
- `agent_context_size`: tamanho médio de contexto carregado
|
|
477
|
+
- `handoff_quality_score`: 1-10 baseado em preenchimento
|
|
478
|
+
|
|
479
|
+
**[OBS-004] Tracing de handoff**
|
|
480
|
+
- Cada handoff recebe ID único: `handoff-uuid-timestamp`
|
|
481
|
+
- Trace: orchestrator -> worker-a -> reviewer -> worker-b
|
|
482
|
+
- Latência entre handoffs: rastreada
|
|
483
|
+
- Alertas: handoff aberto > 1h
|
|
484
|
+
|
|
485
|
+
**[OBS-005] Dashboard de observabilidade**
|
|
486
|
+
- Script: `backend/scripts/memory-db-observability.mjs`
|
|
487
|
+
- Queries pré-prontas:
|
|
488
|
+
- "Handoffs abertos"
|
|
489
|
+
- "Agente com menor taxa de sucesso"
|
|
490
|
+
- "Documentação > 20MB"
|
|
491
|
+
- "ADRs sem impacto vinculado"
|
|
492
|
+
|
|
493
|
+
### Decisões
|
|
494
|
+
- ✅ **Logs estruturados em JSON**: parseável
|
|
495
|
+
- ✅ **Decorator para automação**: menos boilerplate
|
|
496
|
+
- ✅ **Métricas por agente**: visibilidade
|
|
497
|
+
|
|
498
|
+
---
|
|
499
|
+
|
|
500
|
+
## 📈 Roadmap de Implementação
|
|
501
|
+
|
|
502
|
+
### Fase 1 (Semanas 1-2): Tier 1 Foundation
|
|
503
|
+
- [ ] SEC-001, SEC-002: Validação + Rate-limiting
|
|
504
|
+
- [ ] AGENT-001, AGENT-002: Prompts estruturados
|
|
505
|
+
- [ ] AI-OPT-001: Context packing model-aware
|
|
506
|
+
- [ ] ADR-001: Estrutura robusta
|
|
507
|
+
- [ ] MEM-001: 3 níveis de compactação
|
|
508
|
+
- [ ] DOC-001: Estrutura de documentação
|
|
509
|
+
- [ ] AGILE-001, AGILE-002: Sprint template + DoD
|
|
510
|
+
- [ ] OBS-001: Logs estruturados
|
|
511
|
+
|
|
512
|
+
### Fase 2 (Semanas 3-4): Tier 1 Completion
|
|
513
|
+
- [ ] SEC-003, SEC-004: Sanitização + Testes
|
|
514
|
+
- [ ] AGENT-003, AGENT-004, AGENT-005: Handoff, roteamento, schema
|
|
515
|
+
- [ ] AI-OPT-002 até AI-OPT-005: Advanced AI optimization
|
|
516
|
+
- [ ] ADR-002, ADR-003, ADR-004: Versionamento + BD + integração
|
|
517
|
+
- [ ] MEM-002 até MEM-005: Compactação inteligente + recovery
|
|
518
|
+
- [ ] DOC-002 até DOC-005: Padrão + diagramas + changelog
|
|
519
|
+
- [ ] AGILE-003, AGILE-004, AGILE-005: Ceremônias + matriz + release notes
|
|
520
|
+
- [ ] OBS-002 até OBS-005: Decorator + métricas + tracing + dashboard
|
|
521
|
+
|
|
522
|
+
### Fase 3 (Semanas 5-6): Tier 2 + Integração
|
|
523
|
+
- Documentação de Produto (completa)
|
|
524
|
+
- Metodologia Ágil (full ceremonies)
|
|
525
|
+
- Observabilidade (full stack)
|
|
526
|
+
|
|
527
|
+
---
|
|
528
|
+
|
|
529
|
+
## 💾 Rastreamento em Banco de Dados
|
|
530
|
+
|
|
531
|
+
Todos os items estão registrados na tabela `improvement_items`:
|
|
532
|
+
|
|
533
|
+
```sql
|
|
534
|
+
SELECT * FROM improvement_items
|
|
535
|
+
WHERE status != 'done'
|
|
536
|
+
ORDER BY area_id, complexity;
|
|
537
|
+
|
|
538
|
+
-- Atualizar status conforme progresso
|
|
539
|
+
UPDATE improvement_items SET status = 'in_progress'
|
|
540
|
+
WHERE id = 'SEC-001';
|
|
541
|
+
```
|
|
542
|
+
|
|
543
|
+
Decisões vinculadas em `decisions`:
|
|
544
|
+
|
|
545
|
+
```sql
|
|
546
|
+
SELECT d.* FROM decisions d
|
|
547
|
+
JOIN improvement_items i ON d.item_id = i.id
|
|
548
|
+
WHERE i.area_id = 'ai-optimization'
|
|
549
|
+
ORDER BY d.created_at DESC;
|
|
550
|
+
```
|
|
551
|
+
|
|
552
|
+
---
|
|
553
|
+
|
|
554
|
+
## ✨ Próximos Passos
|
|
555
|
+
|
|
556
|
+
1. **Review este documento** com stakeholders
|
|
557
|
+
2. **Ajustar prioridades** se necessário
|
|
558
|
+
3. **Começar Fase 1** na próxima sprint
|
|
559
|
+
4. **Atualizar BD** conforme progresso
|
|
560
|
+
5. **Documentar decisões** em ADRs quando relevante
|
|
561
|
+
|
|
562
|
+
---
|
|
563
|
+
|
|
564
|
+
**Versão**: 1.0 | **Data**: 2026-04-21 | **Autor**: Copilot Analysis | **Status**: Aceito para Implementação
|
|
565
|
+
|