forjajs 2.0.3 β 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -339
- package/README.pt-BR.md +345 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.js +2 -2
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -150
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts β llm-fit.d.ts} +0 -0
|
@@ -10,761 +10,763 @@ import { writeFileSafe, ensureDir, maybeGitkeep } from "../utils/file-helpers.js
|
|
|
10
10
|
*/
|
|
11
11
|
const memoryTemplates = {
|
|
12
12
|
// === GLOBAL (00-global) ===
|
|
13
|
-
'memory/README.md': `# Memoria do Projeto
|
|
14
|
-
|
|
15
|
-
Esta estrutura foi desenhada para reduzir perda de contexto em projetos grandes.
|
|
16
|
-
|
|
17
|
-
## Principio
|
|
18
|
-
- Nao depender de um unico contexto gigante.
|
|
19
|
-
- Trabalhar com memoria em camadas + handoff incremental.
|
|
20
|
-
- Registrar decisoes, resumos e execucoes para continuidade.
|
|
21
|
-
`,
|
|
22
|
-
'memory/00-global/mission.md': `# Missao do Projeto
|
|
23
|
-
|
|
24
|
-
Construir software com clareza arquitetural, seguranca by-default e entrega continua.
|
|
25
|
-
|
|
26
|
-
## Principios
|
|
27
|
-
- Simplicidade primeiro
|
|
28
|
-
- Decisoes explicitas em ADR
|
|
29
|
-
- Qualidade e seguranca desde o inicio
|
|
30
|
-
- Documentacao viva
|
|
31
|
-
`,
|
|
32
|
-
'memory/00-global/standards.md': `# Padroes Globais
|
|
33
|
-
|
|
34
|
-
## Idioma
|
|
35
|
-
- Toda comunicacao e documentacao em **pt-BR**.
|
|
36
|
-
|
|
37
|
-
## Backend
|
|
38
|
-
- API criada em **NestJS** por padrao.
|
|
39
|
-
- Arquitetura modular por dominio.
|
|
40
|
-
|
|
41
|
-
## Qualidade
|
|
42
|
-
- Cada mudanca deve registrar impacto, risco e rollback.
|
|
43
|
-
- Priorizar padroes reutilizaveis.
|
|
44
|
-
`,
|
|
45
|
-
'memory/00-global/context-policy.md': `# Politica de Contexto Longo
|
|
46
|
-
|
|
47
|
-
## Objetivo
|
|
48
|
-
Permitir trabalho em larga escala sem depender de janela unica gigantesca.
|
|
49
|
-
|
|
50
|
-
## Regras
|
|
51
|
-
- Usar contexto em camadas: global -> dominio -> tarefa -> diff.
|
|
52
|
-
- Antes de cada tarefa: carregar apenas arquivos necessarios.
|
|
53
|
-
- A cada entrega: gerar resumo curto em memory/70-summaries.
|
|
54
|
-
- Em mudancas grandes: registrar handoff em memory/50-orchestration/handoffs.
|
|
55
|
-
|
|
56
|
-
## π Protocolo de Recuperacao (Engine Switch)
|
|
57
|
-
Se houver esgotamento de cota ou necessidade de mudar de IA:
|
|
58
|
-
1. Localize o arquivo \`.ia-instructions/models.json\`.
|
|
59
|
-
2. Identifique o proximo motor na \`fallback_chain\`.
|
|
60
|
-
3. Carregue as instrucoes do novo motor.
|
|
61
|
-
4. Forneca o conteΓΊdo de \`.context/context-pack.md\` + o ultimo arquivo em \`memory/50-orchestration/handoffs/\`.
|
|
62
|
-
5. O novo motor assumira o trabalho a partir do ponto exato da ultima entrega.
|
|
63
|
-
|
|
64
|
-
## Nota importante
|
|
65
|
-
Esta estrutura **nao aumenta** limite nativo do modelo.
|
|
66
|
-
Ela reduz perda de memoria por segmentacao, resumo e continuidade operacional.
|
|
67
|
-
`,
|
|
68
|
-
'memory/00-global/agent-contract.md': `# Contrato de Agentes
|
|
69
|
-
|
|
70
|
-
## Orquestrador
|
|
71
|
-
- DecompΓ΅e trabalho em subtarefas independentes.
|
|
72
|
-
- Define dono por escopo de arquivo.
|
|
73
|
-
- Consolida handoffs e conflitos.
|
|
74
|
-
|
|
75
|
-
## Workers
|
|
76
|
-
- Implementam subtarefas com escopo claro.
|
|
77
|
-
- Nao alteram areas de outros agentes sem alinhamento.
|
|
78
|
-
- Entregam: alteracoes, riscos, testes e pendencias.
|
|
79
|
-
|
|
80
|
-
## Reviewer
|
|
81
|
-
- Verifica regressao, seguranca e cobertura de testes.
|
|
82
|
-
- Bloqueia merge se encontrar risco critico.
|
|
83
|
-
`,
|
|
84
|
-
'memory/00-global/context-index.md': `# Indice de Contexto
|
|
85
|
-
|
|
86
|
-
## Ordem de Leitura
|
|
87
|
-
1. memory/00-global/mission.md
|
|
88
|
-
2. memory/00-global/standards.md
|
|
89
|
-
3. memory/00-global/context-policy.md
|
|
90
|
-
4. memory/10-product/*
|
|
91
|
-
5. memory/20-architecture/*
|
|
92
|
-
6. memory/30-domains/<dominio>/*
|
|
93
|
-
7. memory/40-delivery/current-sprint.md
|
|
94
|
-
8. memory/90-decisions/ADR-*.md
|
|
95
|
-
9. memory/70-summaries/*
|
|
13
|
+
'memory/README.md': `# Memoria do Projeto
|
|
14
|
+
|
|
15
|
+
Esta estrutura foi desenhada para reduzir perda de contexto em projetos grandes.
|
|
16
|
+
|
|
17
|
+
## Principio
|
|
18
|
+
- Nao depender de um unico contexto gigante.
|
|
19
|
+
- Trabalhar com memoria em camadas + handoff incremental.
|
|
20
|
+
- Registrar decisoes, resumos e execucoes para continuidade.
|
|
21
|
+
`,
|
|
22
|
+
'memory/00-global/mission.md': `# Missao do Projeto
|
|
23
|
+
|
|
24
|
+
Construir software com clareza arquitetural, seguranca by-default e entrega continua.
|
|
25
|
+
|
|
26
|
+
## Principios
|
|
27
|
+
- Simplicidade primeiro
|
|
28
|
+
- Decisoes explicitas em ADR
|
|
29
|
+
- Qualidade e seguranca desde o inicio
|
|
30
|
+
- Documentacao viva
|
|
31
|
+
`,
|
|
32
|
+
'memory/00-global/standards.md': `# Padroes Globais
|
|
33
|
+
|
|
34
|
+
## Idioma
|
|
35
|
+
- Toda comunicacao e documentacao em **pt-BR**.
|
|
36
|
+
|
|
37
|
+
## Backend
|
|
38
|
+
- API criada em **NestJS** por padrao.
|
|
39
|
+
- Arquitetura modular por dominio.
|
|
40
|
+
|
|
41
|
+
## Qualidade
|
|
42
|
+
- Cada mudanca deve registrar impacto, risco e rollback.
|
|
43
|
+
- Priorizar padroes reutilizaveis.
|
|
44
|
+
`,
|
|
45
|
+
'memory/00-global/context-policy.md': `# Politica de Contexto Longo
|
|
46
|
+
|
|
47
|
+
## Objetivo
|
|
48
|
+
Permitir trabalho em larga escala sem depender de janela unica gigantesca.
|
|
49
|
+
|
|
50
|
+
## Regras
|
|
51
|
+
- Usar contexto em camadas: global -> dominio -> tarefa -> diff.
|
|
52
|
+
- Antes de cada tarefa: carregar apenas arquivos necessarios.
|
|
53
|
+
- A cada entrega: gerar resumo curto em memory/70-summaries.
|
|
54
|
+
- Em mudancas grandes: registrar handoff em memory/50-orchestration/handoffs.
|
|
55
|
+
|
|
56
|
+
## π Protocolo de Recuperacao (Engine Switch)
|
|
57
|
+
Se houver esgotamento de cota ou necessidade de mudar de IA:
|
|
58
|
+
1. Localize o arquivo \`.ia-instructions/models.json\`.
|
|
59
|
+
2. Identifique o proximo motor na \`fallback_chain\`.
|
|
60
|
+
3. Carregue as instrucoes do novo motor.
|
|
61
|
+
4. Forneca o conteΓΊdo de \`.context/context-pack.md\` + o ultimo arquivo em \`memory/50-orchestration/handoffs/\`.
|
|
62
|
+
5. O novo motor assumira o trabalho a partir do ponto exato da ultima entrega.
|
|
63
|
+
|
|
64
|
+
## Nota importante
|
|
65
|
+
Esta estrutura **nao aumenta** limite nativo do modelo.
|
|
66
|
+
Ela reduz perda de memoria por segmentacao, resumo e continuidade operacional.
|
|
67
|
+
`,
|
|
68
|
+
'memory/00-global/agent-contract.md': `# Contrato de Agentes
|
|
69
|
+
|
|
70
|
+
## Orquestrador
|
|
71
|
+
- DecompΓ΅e trabalho em subtarefas independentes.
|
|
72
|
+
- Define dono por escopo de arquivo.
|
|
73
|
+
- Consolida handoffs e conflitos.
|
|
74
|
+
|
|
75
|
+
## Workers
|
|
76
|
+
- Implementam subtarefas com escopo claro.
|
|
77
|
+
- Nao alteram areas de outros agentes sem alinhamento.
|
|
78
|
+
- Entregam: alteracoes, riscos, testes e pendencias.
|
|
79
|
+
|
|
80
|
+
## Reviewer
|
|
81
|
+
- Verifica regressao, seguranca e cobertura de testes.
|
|
82
|
+
- Bloqueia merge se encontrar risco critico.
|
|
83
|
+
`,
|
|
84
|
+
'memory/00-global/context-index.md': `# Indice de Contexto
|
|
85
|
+
|
|
86
|
+
## Ordem de Leitura
|
|
87
|
+
1. memory/00-global/mission.md
|
|
88
|
+
2. memory/00-global/standards.md
|
|
89
|
+
3. memory/00-global/context-policy.md
|
|
90
|
+
4. memory/10-product/*
|
|
91
|
+
5. memory/20-architecture/*
|
|
92
|
+
6. memory/30-domains/<dominio>/*
|
|
93
|
+
7. memory/40-delivery/current-sprint.md
|
|
94
|
+
8. memory/90-decisions/ADR-*.md
|
|
95
|
+
9. memory/70-summaries/*
|
|
96
96
|
`,
|
|
97
97
|
// === PRODUCT (10-product) ===
|
|
98
|
-
'memory/10-product/vision.md': `# Visao de Produto
|
|
99
|
-
|
|
100
|
-
Descreva objetivo, publico-alvo, problema e proposta de valor.
|
|
98
|
+
'memory/10-product/vision.md': `# Visao de Produto
|
|
99
|
+
|
|
100
|
+
Descreva objetivo, publico-alvo, problema e proposta de valor.
|
|
101
101
|
`,
|
|
102
|
-
'memory/10-product/personas.md': `# Personas
|
|
103
|
-
|
|
104
|
-
Liste personas e dores principais.
|
|
102
|
+
'memory/10-product/personas.md': `# Personas
|
|
103
|
+
|
|
104
|
+
Liste personas e dores principais.
|
|
105
105
|
`,
|
|
106
|
-
'memory/10-product/business-rules.md': `# Regras de Negocio
|
|
107
|
-
|
|
108
|
-
Documente regras imutaveis e validacoes criticas.
|
|
106
|
+
'memory/10-product/business-rules.md': `# Regras de Negocio
|
|
107
|
+
|
|
108
|
+
Documente regras imutaveis e validacoes criticas.
|
|
109
109
|
`,
|
|
110
|
-
'memory/10-product/nfrs.md': `# Requisitos Nao Funcionais
|
|
111
|
-
|
|
112
|
-
- Performance
|
|
113
|
-
- Seguranca
|
|
114
|
-
- Observabilidade
|
|
115
|
-
- Escalabilidade
|
|
110
|
+
'memory/10-product/nfrs.md': `# Requisitos Nao Funcionais
|
|
111
|
+
|
|
112
|
+
- Performance
|
|
113
|
+
- Seguranca
|
|
114
|
+
- Observabilidade
|
|
115
|
+
- Escalabilidade
|
|
116
116
|
`,
|
|
117
117
|
// === ARCHITECTURE (20-architecture) ===
|
|
118
|
-
'memory/20-architecture/system-overview.md': `# Visao Geral da Arquitetura
|
|
119
|
-
|
|
120
|
-
Descreva contexto, fronteiras e integracoes principais.
|
|
121
|
-
`,
|
|
122
|
-
'memory/20-architecture/frontend.md': `# Frontend
|
|
123
|
-
|
|
124
|
-
Defina padroes de componentizacao, acessibilidade e performance.
|
|
125
|
-
`,
|
|
126
|
-
'memory/20-architecture/backend.md': `# Backend
|
|
127
|
-
|
|
128
|
-
## Diretriz principal
|
|
129
|
-
- Backend em **NestJS** por padrao.
|
|
130
|
-
|
|
131
|
-
## Estrutura sugerida
|
|
132
|
-
- Modulos por dominio
|
|
133
|
-
- DTO + validacao
|
|
134
|
-
- Servicos com regras de negocio
|
|
135
|
-
- Repositorios/integradores isolados
|
|
136
|
-
`,
|
|
137
|
-
'memory/20-architecture/data.md': `# Dados
|
|
138
|
-
|
|
139
|
-
Descreva entidades, relacionamentos e politicas de retencao.
|
|
140
|
-
`,
|
|
141
|
-
'memory/20-architecture/security.md': `# Seguranca
|
|
142
|
-
|
|
143
|
-
- Principio do menor privilegio
|
|
144
|
-
- Segredos fora do codigo
|
|
145
|
-
- Validacao de entrada em todas as rotas
|
|
146
|
-
- Logs sem dados sensiveis
|
|
147
|
-
`,
|
|
148
|
-
'memory/20-architecture/observability.md': `# Observabilidade
|
|
149
|
-
|
|
150
|
-
- Logs estruturados
|
|
151
|
-
- Metricas e tracing
|
|
152
|
-
- Alertas por SLO
|
|
118
|
+
'memory/20-architecture/system-overview.md': `# Visao Geral da Arquitetura
|
|
119
|
+
|
|
120
|
+
Descreva contexto, fronteiras e integracoes principais.
|
|
121
|
+
`,
|
|
122
|
+
'memory/20-architecture/frontend.md': `# Frontend
|
|
123
|
+
|
|
124
|
+
Defina padroes de componentizacao, acessibilidade e performance.
|
|
125
|
+
`,
|
|
126
|
+
'memory/20-architecture/backend.md': `# Backend
|
|
127
|
+
|
|
128
|
+
## Diretriz principal
|
|
129
|
+
- Backend em **NestJS** por padrao.
|
|
130
|
+
|
|
131
|
+
## Estrutura sugerida
|
|
132
|
+
- Modulos por dominio
|
|
133
|
+
- DTO + validacao
|
|
134
|
+
- Servicos com regras de negocio
|
|
135
|
+
- Repositorios/integradores isolados
|
|
136
|
+
`,
|
|
137
|
+
'memory/20-architecture/data.md': `# Dados
|
|
138
|
+
|
|
139
|
+
Descreva entidades, relacionamentos e politicas de retencao.
|
|
140
|
+
`,
|
|
141
|
+
'memory/20-architecture/security.md': `# Seguranca
|
|
142
|
+
|
|
143
|
+
- Principio do menor privilegio
|
|
144
|
+
- Segredos fora do codigo
|
|
145
|
+
- Validacao de entrada em todas as rotas
|
|
146
|
+
- Logs sem dados sensiveis
|
|
147
|
+
`,
|
|
148
|
+
'memory/20-architecture/observability.md': `# Observabilidade
|
|
149
|
+
|
|
150
|
+
- Logs estruturados
|
|
151
|
+
- Metricas e tracing
|
|
152
|
+
- Alertas por SLO
|
|
153
153
|
`,
|
|
154
154
|
// === DOMAINS (30-domains) ===
|
|
155
|
-
'memory/30-domains/auth/context.md': `# Contexto de Auth
|
|
156
|
-
|
|
157
|
-
Defina escopo funcional de autenticacao/autorizacao.
|
|
155
|
+
'memory/30-domains/auth/context.md': `# Contexto de Auth
|
|
156
|
+
|
|
157
|
+
Defina escopo funcional de autenticacao/autorizacao.
|
|
158
158
|
`,
|
|
159
|
-
'memory/30-domains/auth/rules.md': `# Regras de Auth
|
|
160
|
-
|
|
161
|
-
Liste regras e restricoes de seguranca.
|
|
159
|
+
'memory/30-domains/auth/rules.md': `# Regras de Auth
|
|
160
|
+
|
|
161
|
+
Liste regras e restricoes de seguranca.
|
|
162
162
|
`,
|
|
163
|
-
'memory/30-domains/auth/api.md': `# API de Auth
|
|
164
|
-
|
|
165
|
-
Documente endpoints, payloads e erros.
|
|
163
|
+
'memory/30-domains/auth/api.md': `# API de Auth
|
|
164
|
+
|
|
165
|
+
Documente endpoints, payloads e erros.
|
|
166
166
|
`,
|
|
167
|
-
'memory/30-domains/billing/context.md': `# Contexto de Billing
|
|
168
|
-
|
|
169
|
-
Defina cobranca, ciclo e integracoes.
|
|
167
|
+
'memory/30-domains/billing/context.md': `# Contexto de Billing
|
|
168
|
+
|
|
169
|
+
Defina cobranca, ciclo e integracoes.
|
|
170
170
|
`,
|
|
171
|
-
'memory/30-domains/billing/rules.md': `# Regras de Billing
|
|
172
|
-
|
|
173
|
-
Descreva calculos, status e excecoes.
|
|
171
|
+
'memory/30-domains/billing/rules.md': `# Regras de Billing
|
|
172
|
+
|
|
173
|
+
Descreva calculos, status e excecoes.
|
|
174
174
|
`,
|
|
175
|
-
'memory/30-domains/billing/api.md': `# API de Billing
|
|
176
|
-
|
|
177
|
-
Documente endpoints e regras de idempotencia.
|
|
175
|
+
'memory/30-domains/billing/api.md': `# API de Billing
|
|
176
|
+
|
|
177
|
+
Documente endpoints e regras de idempotencia.
|
|
178
178
|
`,
|
|
179
179
|
// === DELIVERY (40-delivery) ===
|
|
180
|
-
'memory/40-delivery/roadmap.md': `# Roadmap
|
|
181
|
-
|
|
182
|
-
Mapeie entregas por trimestre/sprint.
|
|
183
|
-
`,
|
|
184
|
-
'memory/40-delivery/current-sprint.md': `# Sprint Atual
|
|
185
|
-
|
|
186
|
-
## Objetivos
|
|
187
|
-
-
|
|
188
|
-
|
|
189
|
-
## Itens
|
|
190
|
-
-
|
|
191
|
-
|
|
192
|
-
## Riscos
|
|
193
|
-
-
|
|
194
|
-
`,
|
|
195
|
-
'memory/40-delivery/backlog.md': `# Backlog
|
|
196
|
-
|
|
197
|
-
Liste itens priorizados com contexto minimo.
|
|
180
|
+
'memory/40-delivery/roadmap.md': `# Roadmap
|
|
181
|
+
|
|
182
|
+
Mapeie entregas por trimestre/sprint.
|
|
183
|
+
`,
|
|
184
|
+
'memory/40-delivery/current-sprint.md': `# Sprint Atual
|
|
185
|
+
|
|
186
|
+
## Objetivos
|
|
187
|
+
-
|
|
188
|
+
|
|
189
|
+
## Itens
|
|
190
|
+
-
|
|
191
|
+
|
|
192
|
+
## Riscos
|
|
193
|
+
-
|
|
194
|
+
`,
|
|
195
|
+
'memory/40-delivery/backlog.md': `# Backlog
|
|
196
|
+
|
|
197
|
+
Liste itens priorizados com contexto minimo.
|
|
198
198
|
`,
|
|
199
199
|
// === ORCHESTRATION (50-orchestration) ===
|
|
200
|
-
'memory/50-orchestration/topology.md': `# Topologia Multiagente
|
|
201
|
-
|
|
202
|
-
## Papeis
|
|
203
|
-
- Orquestrador
|
|
204
|
-
- Worker Backend (NestJS)
|
|
205
|
-
- Worker Frontend
|
|
206
|
-
- Worker DBA
|
|
207
|
-
- Worker Security
|
|
208
|
-
- Reviewer
|
|
209
|
-
|
|
210
|
-
## Fluxo
|
|
211
|
-
1. Orquestrador cria plano e fatia trabalho.
|
|
212
|
-
2. Workers executam em paralelo com escopo isolado.
|
|
213
|
-
3. Handoffs sao registrados.
|
|
214
|
-
4. Reviewer valida e aprova.
|
|
215
|
-
`,
|
|
216
|
-
'memory/50-orchestration/routing.md': `# Roteamento de Tarefas
|
|
217
|
-
|
|
218
|
-
## Regras de roteamento
|
|
219
|
-
- API e dominio server-side -> backend-nest
|
|
220
|
-
- Schema/migracao/query -> dba
|
|
221
|
-
- Auth, hardening, segredos -> security
|
|
222
|
-
- UX/componentes -> frontend
|
|
223
|
-
|
|
224
|
-
## Critico
|
|
225
|
-
Subtarefas devem ter dono unico por arquivo para evitar conflito.
|
|
226
|
-
`,
|
|
227
|
-
'memory/50-orchestration/handoff-protocol.md': `# Protocolo de Handoff
|
|
228
|
-
|
|
229
|
-
Cada handoff deve conter:
|
|
230
|
-
- contexto minimo
|
|
231
|
-
- alteracoes realizadas
|
|
232
|
-
- arquivos tocados
|
|
233
|
-
- riscos e pontos abertos
|
|
234
|
-
- proximos passos objetivos
|
|
235
|
-
`,
|
|
236
|
-
'memory/50-orchestration/parallel-playbook.md': `# Playbook de Paralelizacao
|
|
237
|
-
|
|
238
|
-
## Quando paralelizar
|
|
239
|
-
- Subtarefas independentes por dominio.
|
|
240
|
-
- Escopo de escrita sem sobreposicao.
|
|
241
|
-
|
|
242
|
-
## Quando nao paralelizar
|
|
243
|
-
- Mudanca bloqueante para a proxima etapa.
|
|
244
|
-
- Refactor altamente acoplado no mesmo modulo.
|
|
245
|
-
`,
|
|
246
|
-
'memory/50-orchestration/handoffs/README.md': `# Handoffs
|
|
247
|
-
|
|
248
|
-
Registre cada transicao em arquivos markdown com timestamp.
|
|
249
|
-
Exemplo: 2026-04-18T12-30_worker-backend_para_reviewer.md
|
|
200
|
+
'memory/50-orchestration/topology.md': `# Topologia Multiagente
|
|
201
|
+
|
|
202
|
+
## Papeis
|
|
203
|
+
- Orquestrador
|
|
204
|
+
- Worker Backend (NestJS)
|
|
205
|
+
- Worker Frontend
|
|
206
|
+
- Worker DBA
|
|
207
|
+
- Worker Security
|
|
208
|
+
- Reviewer
|
|
209
|
+
|
|
210
|
+
## Fluxo
|
|
211
|
+
1. Orquestrador cria plano e fatia trabalho.
|
|
212
|
+
2. Workers executam em paralelo com escopo isolado.
|
|
213
|
+
3. Handoffs sao registrados.
|
|
214
|
+
4. Reviewer valida e aprova.
|
|
215
|
+
`,
|
|
216
|
+
'memory/50-orchestration/routing.md': `# Roteamento de Tarefas
|
|
217
|
+
|
|
218
|
+
## Regras de roteamento
|
|
219
|
+
- API e dominio server-side -> backend-nest
|
|
220
|
+
- Schema/migracao/query -> dba
|
|
221
|
+
- Auth, hardening, segredos -> security
|
|
222
|
+
- UX/componentes -> frontend
|
|
223
|
+
|
|
224
|
+
## Critico
|
|
225
|
+
Subtarefas devem ter dono unico por arquivo para evitar conflito.
|
|
226
|
+
`,
|
|
227
|
+
'memory/50-orchestration/handoff-protocol.md': `# Protocolo de Handoff
|
|
228
|
+
|
|
229
|
+
Cada handoff deve conter:
|
|
230
|
+
- contexto minimo
|
|
231
|
+
- alteracoes realizadas
|
|
232
|
+
- arquivos tocados
|
|
233
|
+
- riscos e pontos abertos
|
|
234
|
+
- proximos passos objetivos
|
|
235
|
+
`,
|
|
236
|
+
'memory/50-orchestration/parallel-playbook.md': `# Playbook de Paralelizacao
|
|
237
|
+
|
|
238
|
+
## Quando paralelizar
|
|
239
|
+
- Subtarefas independentes por dominio.
|
|
240
|
+
- Escopo de escrita sem sobreposicao.
|
|
241
|
+
|
|
242
|
+
## Quando nao paralelizar
|
|
243
|
+
- Mudanca bloqueante para a proxima etapa.
|
|
244
|
+
- Refactor altamente acoplado no mesmo modulo.
|
|
245
|
+
`,
|
|
246
|
+
'memory/50-orchestration/handoffs/README.md': `# Handoffs
|
|
247
|
+
|
|
248
|
+
Registre cada transicao em arquivos markdown com timestamp.
|
|
249
|
+
Exemplo: 2026-04-18T12-30_worker-backend_para_reviewer.md
|
|
250
250
|
`,
|
|
251
251
|
// === RUNS (60-runs) ===
|
|
252
|
-
'memory/60-runs/README.md': `# Runs
|
|
253
|
-
|
|
254
|
-
Log de execucao por ciclo/sprint.
|
|
252
|
+
'memory/60-runs/README.md': `# Runs
|
|
253
|
+
|
|
254
|
+
Log de execucao por ciclo/sprint.
|
|
255
255
|
`,
|
|
256
256
|
// === SUMMARIES (70-summaries) ===
|
|
257
|
-
'memory/70-summaries/global-summary.md': `# Resumo Global
|
|
258
|
-
|
|
259
|
-
Atualize a cada marco importante com:
|
|
260
|
-
- estado atual
|
|
261
|
-
- decisoes novas
|
|
262
|
-
- riscos ativos
|
|
257
|
+
'memory/70-summaries/global-summary.md': `# Resumo Global
|
|
258
|
+
|
|
259
|
+
Atualize a cada marco importante com:
|
|
260
|
+
- estado atual
|
|
261
|
+
- decisoes novas
|
|
262
|
+
- riscos ativos
|
|
263
263
|
`,
|
|
264
|
-
'memory/70-summaries/domain-summary.md': `# Resumo por Dominio
|
|
265
|
-
|
|
266
|
-
Mantenha resumos curtos por dominio para carregamento rapido de contexto.
|
|
264
|
+
'memory/70-summaries/domain-summary.md': `# Resumo por Dominio
|
|
265
|
+
|
|
266
|
+
Mantenha resumos curtos por dominio para carregamento rapido de contexto.
|
|
267
267
|
`,
|
|
268
268
|
// === DATA (80-data) ===
|
|
269
|
-
'memory/80-data/memory-db.md': `# Memory DB (SQLite)
|
|
270
|
-
|
|
271
|
-
## Objetivo
|
|
272
|
-
Armazenar indice operacional da documentacao para busca e continuidade de contexto.
|
|
273
|
-
|
|
274
|
-
## Fonte da verdade
|
|
275
|
-
- Arquivos Markdown em memory/, docs/, agents/, skills/, prompts/
|
|
276
|
-
|
|
277
|
-
## Banco
|
|
278
|
-
- SQLite em .memory/sqlite/context.db
|
|
279
|
-
|
|
280
|
-
## Fluxo
|
|
281
|
-
1. Atualizar markdown
|
|
282
|
-
2. Rodar sincronizacao
|
|
283
|
-
3. Consultar contexto por texto ou tipo
|
|
269
|
+
'memory/80-data/memory-db.md': `# Memory DB (SQLite)
|
|
270
|
+
|
|
271
|
+
## Objetivo
|
|
272
|
+
Armazenar indice operacional da documentacao para busca e continuidade de contexto.
|
|
273
|
+
|
|
274
|
+
## Fonte da verdade
|
|
275
|
+
- Arquivos Markdown em memory/, docs/, agents/, skills/, prompts/
|
|
276
|
+
|
|
277
|
+
## Banco
|
|
278
|
+
- SQLite em .memory/sqlite/context.db
|
|
279
|
+
|
|
280
|
+
## Fluxo
|
|
281
|
+
1. Atualizar markdown
|
|
282
|
+
2. Rodar sincronizacao
|
|
283
|
+
3. Consultar contexto por texto ou tipo
|
|
284
284
|
`,
|
|
285
285
|
// === DECISIONS (90-decisions) ===
|
|
286
|
-
'memory/90-decisions/ADR-0001-template.md': `# ADR-0001: Titulo da Decisao
|
|
287
|
-
|
|
288
|
-
## Contexto
|
|
289
|
-
|
|
290
|
-
## Decisao
|
|
291
|
-
|
|
292
|
-
## Consequencias
|
|
293
|
-
|
|
294
|
-
## Alternativas consideradas
|
|
286
|
+
'memory/90-decisions/ADR-0001-template.md': `# ADR-0001: Titulo da Decisao
|
|
287
|
+
|
|
288
|
+
## Contexto
|
|
289
|
+
|
|
290
|
+
## Decisao
|
|
291
|
+
|
|
292
|
+
## Consequencias
|
|
293
|
+
|
|
294
|
+
## Alternativas consideradas
|
|
295
295
|
`,
|
|
296
296
|
};
|
|
297
297
|
/**
|
|
298
298
|
* Gera estrutura de agentes
|
|
299
299
|
*/
|
|
300
300
|
const agentTemplates = {
|
|
301
|
-
'agents/README.md': `# Agents
|
|
302
|
-
|
|
303
|
-
Agentes especializados para dividir trabalho em paralelo.
|
|
304
|
-
`,
|
|
305
|
-
'agents/orchestrator.md': `# Agent: Orchestrator
|
|
306
|
-
|
|
307
|
-
## Responsabilidade
|
|
308
|
-
Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
|
|
309
|
-
|
|
310
|
-
## Entrega minima
|
|
311
|
-
- plano objetivo
|
|
312
|
-
- distribuicao por agentes
|
|
313
|
-
- consolidacao de handoffs
|
|
314
|
-
`,
|
|
315
|
-
'agents/backend-nest.md': `# Agent: Backend NestJS
|
|
316
|
-
|
|
317
|
-
## Escopo
|
|
318
|
-
- modulos, controllers, services, dto, guard, pipe
|
|
319
|
-
- testes unitarios e e2e da API
|
|
320
|
-
|
|
321
|
-
## Padrao
|
|
322
|
-
- NestJS por padrao
|
|
323
|
-
- validacao de entrada obrigatoria
|
|
324
|
-
`,
|
|
325
|
-
'agents/frontend.md': `# Agent: Frontend
|
|
326
|
-
|
|
327
|
-
## Escopo
|
|
328
|
-
- componentes, acessibilidade, performance, UX
|
|
329
|
-
`,
|
|
330
|
-
'agents/dba.md': `# Agent: DBA
|
|
331
|
-
|
|
332
|
-
## Escopo
|
|
333
|
-
- modelagem, indices, migracoes, tuning de query
|
|
334
|
-
`,
|
|
335
|
-
'agents/security.md': `# Agent: Security
|
|
336
|
-
|
|
337
|
-
## Escopo
|
|
338
|
-
- threat modeling, hardening, authz/authn, secrets, auditoria
|
|
339
|
-
`,
|
|
340
|
-
'agents/reviewer.md': `# Agent: Reviewer
|
|
341
|
-
|
|
342
|
-
## Escopo
|
|
343
|
-
- regressao funcional
|
|
344
|
-
- riscos de seguranca
|
|
345
|
-
- cobertura de testes
|
|
301
|
+
'agents/README.md': `# Agents
|
|
302
|
+
|
|
303
|
+
Agentes especializados para dividir trabalho em paralelo.
|
|
304
|
+
`,
|
|
305
|
+
'agents/orchestrator.md': `# Agent: Orchestrator
|
|
306
|
+
|
|
307
|
+
## Responsabilidade
|
|
308
|
+
Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
|
|
309
|
+
|
|
310
|
+
## Entrega minima
|
|
311
|
+
- plano objetivo
|
|
312
|
+
- distribuicao por agentes
|
|
313
|
+
- consolidacao de handoffs
|
|
314
|
+
`,
|
|
315
|
+
'agents/backend-nest.md': `# Agent: Backend NestJS
|
|
316
|
+
|
|
317
|
+
## Escopo
|
|
318
|
+
- modulos, controllers, services, dto, guard, pipe
|
|
319
|
+
- testes unitarios e e2e da API
|
|
320
|
+
|
|
321
|
+
## Padrao
|
|
322
|
+
- NestJS por padrao
|
|
323
|
+
- validacao de entrada obrigatoria
|
|
324
|
+
`,
|
|
325
|
+
'agents/frontend.md': `# Agent: Frontend
|
|
326
|
+
|
|
327
|
+
## Escopo
|
|
328
|
+
- componentes, acessibilidade, performance, UX
|
|
329
|
+
`,
|
|
330
|
+
'agents/dba.md': `# Agent: DBA
|
|
331
|
+
|
|
332
|
+
## Escopo
|
|
333
|
+
- modelagem, indices, migracoes, tuning de query
|
|
334
|
+
`,
|
|
335
|
+
'agents/security.md': `# Agent: Security
|
|
336
|
+
|
|
337
|
+
## Escopo
|
|
338
|
+
- threat modeling, hardening, authz/authn, secrets, auditoria
|
|
339
|
+
`,
|
|
340
|
+
'agents/reviewer.md': `# Agent: Reviewer
|
|
341
|
+
|
|
342
|
+
## Escopo
|
|
343
|
+
- regressao funcional
|
|
344
|
+
- riscos de seguranca
|
|
345
|
+
- cobertura de testes
|
|
346
346
|
`,
|
|
347
347
|
};
|
|
348
348
|
/**
|
|
349
349
|
* Gera estrutura de skills
|
|
350
350
|
*/
|
|
351
351
|
const skillTemplates = {
|
|
352
|
-
'skills/triage-task/SKILL.md': `# Skill: Triage de Tarefa
|
|
353
|
-
|
|
354
|
-
## Objetivo
|
|
355
|
-
Classificar demanda em: rapido, medio, complexo.
|
|
356
|
-
|
|
357
|
-
## Saida
|
|
358
|
-
- resumo
|
|
359
|
-
- risco
|
|
360
|
-
- owner sugerido
|
|
361
|
-
- fatias de execucao
|
|
362
|
-
`,
|
|
363
|
-
'skills/context-compaction/SKILL.md': `# Skill: Compactacao de Contexto
|
|
364
|
-
|
|
365
|
-
## Objetivo
|
|
366
|
-
Gerar resumo operacional sem perder decisoes chave.
|
|
367
|
-
|
|
368
|
-
## Regras
|
|
369
|
-
- manter fatos verificaveis
|
|
370
|
-
- remover redundancia
|
|
371
|
-
- preservar links para fontes internas
|
|
372
|
-
`,
|
|
373
|
-
'skills/handoff/SKILL.md': `# Skill: Handoff
|
|
374
|
-
|
|
375
|
-
## Template
|
|
376
|
-
- contexto
|
|
377
|
-
- alteracoes
|
|
378
|
-
- riscos
|
|
379
|
-
- pendencias
|
|
380
|
-
- proximo agente
|
|
381
|
-
`,
|
|
382
|
-
'skills/nest-api/SKILL.md': `# Skill: Nest API
|
|
383
|
-
|
|
384
|
-
## Checklist
|
|
385
|
-
- modulo criado
|
|
386
|
-
- dto com validacao
|
|
387
|
-
- controller + service
|
|
388
|
-
- testes
|
|
389
|
-
`,
|
|
390
|
-
'skills/self-healing/SKILL.md': `# Skill: Auto-DiagnΓ³stico (Self-Healing)
|
|
391
|
-
|
|
392
|
-
## Objetivo
|
|
393
|
-
Resolver falhas de build, testes ou tipos sem intervenΓ§Γ£o humana.
|
|
394
|
-
|
|
395
|
-
## Fluxo
|
|
396
|
-
1. Analisar a stack trace completa do erro.
|
|
397
|
-
2. Identificar se Γ©: erro de sintaxe, falta de dependΓͺncia, erro de tipo ou lΓ³gica.
|
|
398
|
-
3. Consultar documentaΓ§Γ£o interna ou padrΓ΅es do projeto.
|
|
399
|
-
4. Propor correΓ§Γ£o mΓnima e rodar validaΓ§Γ£o novamente.
|
|
400
|
-
`,
|
|
401
|
-
'skills/validate-handoff/SKILL.md': `# Skill: ValidaΓ§Γ£o e Review de SeguranΓ§a (Gatekeeper)
|
|
402
|
-
|
|
403
|
-
## Objetivo
|
|
404
|
-
Atuar como Gatekeeper final para garantir que nenhum cΓ³digo inseguro ou incompleto entre no pipeline.
|
|
405
|
-
|
|
406
|
-
## Protocolo de Review (ObrigatΓ³rio)
|
|
407
|
-
Antes de aceitar um handoff, o Reviewer deve validar:
|
|
408
|
-
|
|
409
|
-
1. **Compliance de RaciocΓnio**: O Worker preencheu o bloco \`## RaciocΓnio Estruturado\`? (Se nΓ£o, rejeite imediatamente).
|
|
410
|
-
2. **Scan de SeguranΓ§a**:
|
|
411
|
-
- HΓ‘ logs sensΓveis (PII, tokens) sendo impressos?
|
|
412
|
-
- As validaΓ§Γ΅es de input estΓ£o no DTO?
|
|
413
|
-
3. **VerificaΓ§Γ£o de Handoff**:
|
|
414
|
-
- Os arquivos listados no handoff condizem com o diff real?
|
|
415
|
-
- Existem pendΓͺncias (riscos) nΓ£o documentadas?
|
|
416
|
-
|
|
417
|
-
## SaΓda do Reviewer
|
|
418
|
-
- [ ] Aprovado (Status: \`done\` no DB)
|
|
419
|
-
- [ ] Rejeitado (Status: \`blocked\` + pendΓͺncias listadas)
|
|
420
|
-
`,
|
|
421
|
-
'skills/ui-fidelity/SKILL.md': `# Skill: Fidelidade Visual
|
|
422
|
-
|
|
423
|
-
## Objetivo
|
|
424
|
-
Garantir que a UI segue padrΓ΅es de elite.
|
|
425
|
-
|
|
426
|
-
## InstruΓ§Γ£o
|
|
427
|
-
1. Consultar a biblioteca \`design-md/\` para inspiraΓ§Γ£o de marca/padrΓ£o.
|
|
428
|
-
2. Comparar o cΓ³digo gerado com os padrΓ΅es de espaΓ§amento, tipografia e cores da referΓͺncia.
|
|
429
|
-
3. Ajustar CSS/Componentes para atingir qualidade visual de nΓvel mundial.
|
|
430
|
-
`,
|
|
431
|
-
'skills/reasoning-protocol/SKILL.md': `# Skill: RaciocΓnio Estruturado (Chain-of-Thought)
|
|
432
|
-
|
|
433
|
-
## Objetivo
|
|
434
|
-
Reduzir erros de implementaΓ§Γ£o atravΓ©s de anΓ‘lise lΓ³gica explΓcita.
|
|
435
|
-
|
|
436
|
-
## Protocolo ObrigatΓ³rio
|
|
437
|
-
Antes de qualquer cΓ³digo ou plano de aΓ§Γ£o, preencha o bloco \`## RaciocΓnio Estruturado\`:
|
|
438
|
-
|
|
439
|
-
1. **Entendimento**: O que foi pedido e qual o impacto no sistema?
|
|
440
|
-
2. **RestriΓ§Γ΅es**: Quais arquivos NΓO posso tocar? Quais padrΓ΅es devo seguir?
|
|
441
|
-
3. **Alternativas**: Existe mais de uma forma de fazer? Por que escolhi esta?
|
|
442
|
-
4. **Plano de Ataque**: Passo-a-passo lΓ³gico da implementaΓ§Γ£o.
|
|
443
|
-
`,
|
|
444
|
-
'skills/llm-provider-routing/SKILL.md': `# Skill: Roteamento de LLM Providers
|
|
445
|
-
|
|
446
|
-
## Objetivo
|
|
447
|
-
Selecionar e configurar uma LLM por papel sem amarrar o projeto a um unico fornecedor.
|
|
448
|
-
|
|
449
|
-
## Quando usar
|
|
450
|
-
- O usuario pedir DeepSeek, MiniMax, Mistral, Qwen, Ollama, OpenRouter, Together, Groq, xAI, Cohere, Perplexity ou outro provider.
|
|
451
|
-
- Um papel precisar trocar de modelo por custo, cota, latencia, contexto, privacidade ou qualidade.
|
|
452
|
-
- Uma CLI/API externa precisar entrar no fluxo de handoffs sem alterar o SDD.
|
|
453
|
-
|
|
454
|
-
## Regras
|
|
455
|
-
- Preferir providers locais para tarefas sensiveis quando o modelo disponivel for suficiente.
|
|
456
|
-
- Usar \`manual\` quando o provider nao tiver CLI local confiavel.
|
|
457
|
-
- Registrar \`provider\`, \`model\`, \`command\`, \`
|
|
458
|
-
- Nao assumir que uma CLI existe: validar o binario ou documentar o comando esperado.
|
|
459
|
-
- Nao colocar API keys em memoria, specs, handoffs ou logs.
|
|
460
|
-
|
|
461
|
-
## Checklist
|
|
462
|
-
1. Identificar papel e tipo de tarefa.
|
|
463
|
-
2.
|
|
464
|
-
3. Preencher \`command\` com
|
|
465
|
-
4. Rodar
|
|
466
|
-
5.
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
{ "id": "
|
|
474
|
-
{ "id": "
|
|
475
|
-
{ "id": "
|
|
476
|
-
{ "id": "
|
|
477
|
-
{ "id": "
|
|
478
|
-
{ "id": "
|
|
479
|
-
{ "id": "
|
|
480
|
-
|
|
481
|
-
}
|
|
352
|
+
'skills/triage-task/SKILL.md': `# Skill: Triage de Tarefa
|
|
353
|
+
|
|
354
|
+
## Objetivo
|
|
355
|
+
Classificar demanda em: rapido, medio, complexo.
|
|
356
|
+
|
|
357
|
+
## Saida
|
|
358
|
+
- resumo
|
|
359
|
+
- risco
|
|
360
|
+
- owner sugerido
|
|
361
|
+
- fatias de execucao
|
|
362
|
+
`,
|
|
363
|
+
'skills/context-compaction/SKILL.md': `# Skill: Compactacao de Contexto
|
|
364
|
+
|
|
365
|
+
## Objetivo
|
|
366
|
+
Gerar resumo operacional sem perder decisoes chave.
|
|
367
|
+
|
|
368
|
+
## Regras
|
|
369
|
+
- manter fatos verificaveis
|
|
370
|
+
- remover redundancia
|
|
371
|
+
- preservar links para fontes internas
|
|
372
|
+
`,
|
|
373
|
+
'skills/handoff/SKILL.md': `# Skill: Handoff
|
|
374
|
+
|
|
375
|
+
## Template
|
|
376
|
+
- contexto
|
|
377
|
+
- alteracoes
|
|
378
|
+
- riscos
|
|
379
|
+
- pendencias
|
|
380
|
+
- proximo agente
|
|
381
|
+
`,
|
|
382
|
+
'skills/nest-api/SKILL.md': `# Skill: Nest API
|
|
383
|
+
|
|
384
|
+
## Checklist
|
|
385
|
+
- modulo criado
|
|
386
|
+
- dto com validacao
|
|
387
|
+
- controller + service
|
|
388
|
+
- testes
|
|
389
|
+
`,
|
|
390
|
+
'skills/self-healing/SKILL.md': `# Skill: Auto-DiagnΓ³stico (Self-Healing)
|
|
391
|
+
|
|
392
|
+
## Objetivo
|
|
393
|
+
Resolver falhas de build, testes ou tipos sem intervenΓ§Γ£o humana.
|
|
394
|
+
|
|
395
|
+
## Fluxo
|
|
396
|
+
1. Analisar a stack trace completa do erro.
|
|
397
|
+
2. Identificar se Γ©: erro de sintaxe, falta de dependΓͺncia, erro de tipo ou lΓ³gica.
|
|
398
|
+
3. Consultar documentaΓ§Γ£o interna ou padrΓ΅es do projeto.
|
|
399
|
+
4. Propor correΓ§Γ£o mΓnima e rodar validaΓ§Γ£o novamente.
|
|
400
|
+
`,
|
|
401
|
+
'skills/validate-handoff/SKILL.md': `# Skill: ValidaΓ§Γ£o e Review de SeguranΓ§a (Gatekeeper)
|
|
402
|
+
|
|
403
|
+
## Objetivo
|
|
404
|
+
Atuar como Gatekeeper final para garantir que nenhum cΓ³digo inseguro ou incompleto entre no pipeline.
|
|
405
|
+
|
|
406
|
+
## Protocolo de Review (ObrigatΓ³rio)
|
|
407
|
+
Antes de aceitar um handoff, o Reviewer deve validar:
|
|
408
|
+
|
|
409
|
+
1. **Compliance de RaciocΓnio**: O Worker preencheu o bloco \`## RaciocΓnio Estruturado\`? (Se nΓ£o, rejeite imediatamente).
|
|
410
|
+
2. **Scan de SeguranΓ§a**:
|
|
411
|
+
- HΓ‘ logs sensΓveis (PII, tokens) sendo impressos?
|
|
412
|
+
- As validaΓ§Γ΅es de input estΓ£o no DTO?
|
|
413
|
+
3. **VerificaΓ§Γ£o de Handoff**:
|
|
414
|
+
- Os arquivos listados no handoff condizem com o diff real?
|
|
415
|
+
- Existem pendΓͺncias (riscos) nΓ£o documentadas?
|
|
416
|
+
|
|
417
|
+
## SaΓda do Reviewer
|
|
418
|
+
- [ ] Aprovado (Status: \`done\` no DB)
|
|
419
|
+
- [ ] Rejeitado (Status: \`blocked\` + pendΓͺncias listadas)
|
|
420
|
+
`,
|
|
421
|
+
'skills/ui-fidelity/SKILL.md': `# Skill: Fidelidade Visual
|
|
422
|
+
|
|
423
|
+
## Objetivo
|
|
424
|
+
Garantir que a UI segue padrΓ΅es de elite.
|
|
425
|
+
|
|
426
|
+
## InstruΓ§Γ£o
|
|
427
|
+
1. Consultar a biblioteca \`design-md/\` para inspiraΓ§Γ£o de marca/padrΓ£o.
|
|
428
|
+
2. Comparar o cΓ³digo gerado com os padrΓ΅es de espaΓ§amento, tipografia e cores da referΓͺncia.
|
|
429
|
+
3. Ajustar CSS/Componentes para atingir qualidade visual de nΓvel mundial.
|
|
430
|
+
`,
|
|
431
|
+
'skills/reasoning-protocol/SKILL.md': `# Skill: RaciocΓnio Estruturado (Chain-of-Thought)
|
|
432
|
+
|
|
433
|
+
## Objetivo
|
|
434
|
+
Reduzir erros de implementaΓ§Γ£o atravΓ©s de anΓ‘lise lΓ³gica explΓcita.
|
|
435
|
+
|
|
436
|
+
## Protocolo ObrigatΓ³rio
|
|
437
|
+
Antes de qualquer cΓ³digo ou plano de aΓ§Γ£o, preencha o bloco \`## RaciocΓnio Estruturado\`:
|
|
438
|
+
|
|
439
|
+
1. **Entendimento**: O que foi pedido e qual o impacto no sistema?
|
|
440
|
+
2. **RestriΓ§Γ΅es**: Quais arquivos NΓO posso tocar? Quais padrΓ΅es devo seguir?
|
|
441
|
+
3. **Alternativas**: Existe mais de uma forma de fazer? Por que escolhi esta?
|
|
442
|
+
4. **Plano de Ataque**: Passo-a-passo lΓ³gico da implementaΓ§Γ£o.
|
|
443
|
+
`,
|
|
444
|
+
'skills/llm-provider-routing/SKILL.md': `# Skill: Roteamento de LLM Providers
|
|
445
|
+
|
|
446
|
+
## Objetivo
|
|
447
|
+
Selecionar e configurar uma LLM por papel sem amarrar o projeto a um unico fornecedor, usando o ciclo verificΓ‘vel do Forja.
|
|
448
|
+
|
|
449
|
+
## Quando usar
|
|
450
|
+
- O usuario pedir DeepSeek, MiniMax, Mistral, Qwen, Ollama, OpenRouter, Together, Groq, xAI, Cohere, Perplexity ou outro provider.
|
|
451
|
+
- Um papel precisar trocar de modelo por custo, cota, latencia, contexto, privacidade ou qualidade.
|
|
452
|
+
- Uma CLI/API externa precisar entrar no fluxo de handoffs sem alterar o SDD.
|
|
453
|
+
|
|
454
|
+
## Regras
|
|
455
|
+
- Preferir providers locais para tarefas sensiveis quando o modelo disponivel for suficiente.
|
|
456
|
+
- Usar \`manual\` quando o provider nao tiver CLI local confiavel.
|
|
457
|
+
- Registrar perfis no workspace em \`.context/llm-profiles.json\` com \`provider\`, \`model\`, \`command\`, \`commandArgs\`, \`roles\`, \`taskTypes\`, \`privacy\` e \`enabled\`.
|
|
458
|
+
- Nao assumir que uma CLI existe: validar o binario ou documentar o comando esperado.
|
|
459
|
+
- Nao colocar API keys em memoria, specs, handoffs ou logs.
|
|
460
|
+
|
|
461
|
+
## Checklist
|
|
462
|
+
1. Identificar papel e tipo de tarefa.
|
|
463
|
+
2. Inicializar ou revisar os perfis com \`forja llm:profiles:init\`.
|
|
464
|
+
3. Preencher \`command\` com um ΓΊnico executΓ‘vel e \`commandArgs\` para argumentos fixos; nunca use shell ou grave credenciais.
|
|
465
|
+
4. Rodar \`forja llm:probe <perfil>\` antes de delegar uma sprint inteira.
|
|
466
|
+
5. Consultar \`forja llm:recommend --role <papel> --task <tipo>\` e aprovar explicitamente a escolha.
|
|
467
|
+
6. Executar \`forja llm:run --profile <perfil> --task <arquivo>\` e avaliar com \`forja llm:eval --scope model --id <provider:model>\`.
|
|
468
|
+
7. Registrar handoff Hermes quando a troca impactar entrega.
|
|
469
|
+
`,
|
|
470
|
+
'skills/MANIFEST.json': `{
|
|
471
|
+
"version": "0.5.0",
|
|
472
|
+
"skills": [
|
|
473
|
+
{ "id": "triage", "path": "skills/triage-task/SKILL.md", "description": "ClassificaΓ§Γ£o de tarefas" },
|
|
474
|
+
{ "id": "compaction", "path": "skills/context-compaction/SKILL.md", "description": "CompactaΓ§Γ£o de memΓ³ria" },
|
|
475
|
+
{ "id": "handoff", "path": "skills/handoff/SKILL.md", "description": "Protocolo de transiΓ§Γ£o" },
|
|
476
|
+
{ "id": "nest-api", "path": "skills/nest-api/SKILL.md", "description": "GeraΓ§Γ£o de endpoints NestJS" },
|
|
477
|
+
{ "id": "self-healing", "path": "skills/self-healing/SKILL.md", "description": "ResoluΓ§Γ£o autΓ΄noma de erros" },
|
|
478
|
+
{ "id": "validate-handoff", "path": "skills/validate-handoff/SKILL.md", "description": "Checklist de qualidade de handoff" },
|
|
479
|
+
{ "id": "ui-fidelity", "path": "skills/ui-fidelity/SKILL.md", "description": "Auditoria estΓ©tica de UI" },
|
|
480
|
+
{ "id": "reasoning", "path": "skills/reasoning-protocol/SKILL.md", "description": "Protocolo de raciocΓnio lΓ³gico" },
|
|
481
|
+
{ "id": "llm-provider-routing", "path": "skills/llm-provider-routing/SKILL.md", "description": "Roteamento multi-LLM por papel" }
|
|
482
|
+
]
|
|
483
|
+
}
|
|
482
484
|
`,
|
|
483
485
|
};
|
|
484
486
|
/**
|
|
485
487
|
* Gera estrutura de prompts
|
|
486
488
|
*/
|
|
487
489
|
const promptTemplates = {
|
|
488
|
-
'prompts/project-prompt-base.md': `# Prompt Base do Projeto
|
|
489
|
-
|
|
490
|
-
Voce e um agente de engenharia sΓͺnior neste repositorio.
|
|
491
|
-
|
|
492
|
-
Prioridade de contexto:
|
|
493
|
-
1. memory/00-global/mission.md
|
|
494
|
-
2. memory/00-global/standards.md
|
|
495
|
-
3. memory/00-global/context-policy.md
|
|
496
|
-
4. memory/10-product/*
|
|
497
|
-
5. memory/20-architecture/*
|
|
498
|
-
6. memory/30-domains/<dominio>/*
|
|
499
|
-
7. memory/40-delivery/current-sprint.md
|
|
500
|
-
8. memory/90-decisions/ADR-*.md
|
|
501
|
-
9. memory/70-summaries/*
|
|
502
|
-
|
|
503
|
-
Regras:
|
|
504
|
-
- comunicacao em pt-BR
|
|
505
|
-
- API em NestJS por padrao
|
|
506
|
-
- nao contradizer ADR sem sinalizar
|
|
507
|
-
- explicitar suposicoes
|
|
508
|
-
- **OBRIGATΓRIO**: Usar a skill \`reasoning\` e preencher o bloco \`## RaciocΓnio Estruturado\` antes de cada resposta tΓ©cnica.
|
|
509
|
-
- entregar: raciocΓnio, entendimento, plano, implementacao, validacao e proximos passos
|
|
510
|
-
`,
|
|
511
|
-
'prompts/multi-agent-orchestrator.md': `# Prompt Orquestrador Multiagente
|
|
512
|
-
|
|
513
|
-
Atue como orquestrador. Divida o trabalho em subtarefas independentes, com ownership por arquivo.
|
|
514
|
-
|
|
515
|
-
Para cada subtarefa, entregue:
|
|
516
|
-
- objetivo
|
|
517
|
-
- escopo de escrita
|
|
518
|
-
- criterio de pronto
|
|
519
|
-
- risco principal
|
|
520
|
-
- agente dono
|
|
521
|
-
|
|
522
|
-
No final, consolide os handoffs em ordem cronologica.
|
|
523
|
-
`,
|
|
524
|
-
'prompts/worker-task-template.md': `# Prompt Worker
|
|
525
|
-
|
|
526
|
-
Voce recebeu uma subtarefa.
|
|
527
|
-
|
|
528
|
-
Responda com:
|
|
529
|
-
1. **RaciocΓnio Estruturado** (Uso obrigatΓ³rio da skill \`reasoning\`)
|
|
530
|
-
2. Entendimento
|
|
531
|
-
3. Implementacao realizada
|
|
532
|
-
4. Arquivos alterados
|
|
533
|
-
5. Validacao/testes
|
|
534
|
-
6. Riscos e pendencias
|
|
490
|
+
'prompts/project-prompt-base.md': `# Prompt Base do Projeto
|
|
491
|
+
|
|
492
|
+
Voce e um agente de engenharia sΓͺnior neste repositorio.
|
|
493
|
+
|
|
494
|
+
Prioridade de contexto:
|
|
495
|
+
1. memory/00-global/mission.md
|
|
496
|
+
2. memory/00-global/standards.md
|
|
497
|
+
3. memory/00-global/context-policy.md
|
|
498
|
+
4. memory/10-product/*
|
|
499
|
+
5. memory/20-architecture/*
|
|
500
|
+
6. memory/30-domains/<dominio>/*
|
|
501
|
+
7. memory/40-delivery/current-sprint.md
|
|
502
|
+
8. memory/90-decisions/ADR-*.md
|
|
503
|
+
9. memory/70-summaries/*
|
|
504
|
+
|
|
505
|
+
Regras:
|
|
506
|
+
- comunicacao em pt-BR
|
|
507
|
+
- API em NestJS por padrao
|
|
508
|
+
- nao contradizer ADR sem sinalizar
|
|
509
|
+
- explicitar suposicoes
|
|
510
|
+
- **OBRIGATΓRIO**: Usar a skill \`reasoning\` e preencher o bloco \`## RaciocΓnio Estruturado\` antes de cada resposta tΓ©cnica.
|
|
511
|
+
- entregar: raciocΓnio, entendimento, plano, implementacao, validacao e proximos passos
|
|
512
|
+
`,
|
|
513
|
+
'prompts/multi-agent-orchestrator.md': `# Prompt Orquestrador Multiagente
|
|
514
|
+
|
|
515
|
+
Atue como orquestrador. Divida o trabalho em subtarefas independentes, com ownership por arquivo.
|
|
516
|
+
|
|
517
|
+
Para cada subtarefa, entregue:
|
|
518
|
+
- objetivo
|
|
519
|
+
- escopo de escrita
|
|
520
|
+
- criterio de pronto
|
|
521
|
+
- risco principal
|
|
522
|
+
- agente dono
|
|
523
|
+
|
|
524
|
+
No final, consolide os handoffs em ordem cronologica.
|
|
525
|
+
`,
|
|
526
|
+
'prompts/worker-task-template.md': `# Prompt Worker
|
|
527
|
+
|
|
528
|
+
Voce recebeu uma subtarefa.
|
|
529
|
+
|
|
530
|
+
Responda com:
|
|
531
|
+
1. **RaciocΓnio Estruturado** (Uso obrigatΓ³rio da skill \`reasoning\`)
|
|
532
|
+
2. Entendimento
|
|
533
|
+
3. Implementacao realizada
|
|
534
|
+
4. Arquivos alterados
|
|
535
|
+
5. Validacao/testes
|
|
536
|
+
6. Riscos e pendencias
|
|
535
537
|
`,
|
|
536
538
|
};
|
|
537
539
|
/**
|
|
538
540
|
* Gera arquivos de configuraΓ§Γ£o globais
|
|
539
541
|
*/
|
|
540
542
|
const configTemplates = {
|
|
541
|
-
'AGENTS.md': `# AGENTS
|
|
542
|
-
|
|
543
|
-
## Linguagem
|
|
544
|
-
- Sempre responder e documentar em **pt-BR**.
|
|
545
|
-
|
|
546
|
-
## Stack
|
|
547
|
-
- API padrao do projeto: **NestJS**.
|
|
548
|
-
|
|
549
|
-
## Modo multiagente
|
|
550
|
-
- Orquestrador decompΓ΅e tarefas
|
|
551
|
-
- Workers executam em paralelo por ownership
|
|
552
|
-
- Reviewer valida riscos
|
|
553
|
-
|
|
554
|
-
## Memoria
|
|
555
|
-
- Seguir hierarchy em /memory
|
|
556
|
-
- Registrar handoff e resumo ao fim de cada entrega relevante
|
|
557
|
-
`,
|
|
558
|
-
'.memoryrc.json': `{
|
|
559
|
-
"strategy": "hierarchical",
|
|
560
|
-
"maxContextHint": "1M+ por segmentacao e resumo incremental",
|
|
561
|
-
"handoffDir": "memory/50-orchestration/handoffs",
|
|
562
|
-
"summaryDir": "memory/70-summaries",
|
|
563
|
-
"sqlitePath": ".memory/sqlite/context.db",
|
|
564
|
-
"language": "pt-BR",
|
|
565
|
-
"backendDefault": "nestjs"
|
|
566
|
-
}
|
|
567
|
-
`,
|
|
568
|
-
'.gitignore': `node_modules
|
|
569
|
-
dist
|
|
570
|
-
.env
|
|
571
|
-
.DS_Store
|
|
572
|
-
coverage
|
|
573
|
-
.context
|
|
543
|
+
'AGENTS.md': `# AGENTS
|
|
544
|
+
|
|
545
|
+
## Linguagem
|
|
546
|
+
- Sempre responder e documentar em **pt-BR**.
|
|
547
|
+
|
|
548
|
+
## Stack
|
|
549
|
+
- API padrao do projeto: **NestJS**.
|
|
550
|
+
|
|
551
|
+
## Modo multiagente
|
|
552
|
+
- Orquestrador decompΓ΅e tarefas
|
|
553
|
+
- Workers executam em paralelo por ownership
|
|
554
|
+
- Reviewer valida riscos
|
|
555
|
+
|
|
556
|
+
## Memoria
|
|
557
|
+
- Seguir hierarchy em /memory
|
|
558
|
+
- Registrar handoff e resumo ao fim de cada entrega relevante
|
|
559
|
+
`,
|
|
560
|
+
'.memoryrc.json': `{
|
|
561
|
+
"strategy": "hierarchical",
|
|
562
|
+
"maxContextHint": "1M+ por segmentacao e resumo incremental",
|
|
563
|
+
"handoffDir": "memory/50-orchestration/handoffs",
|
|
564
|
+
"summaryDir": "memory/70-summaries",
|
|
565
|
+
"sqlitePath": ".memory/sqlite/context.db",
|
|
566
|
+
"language": "pt-BR",
|
|
567
|
+
"backendDefault": "nestjs"
|
|
568
|
+
}
|
|
569
|
+
`,
|
|
570
|
+
'.gitignore': `node_modules
|
|
571
|
+
dist
|
|
572
|
+
.env
|
|
573
|
+
.DS_Store
|
|
574
|
+
coverage
|
|
575
|
+
.context
|
|
574
576
|
`,
|
|
575
577
|
};
|
|
576
578
|
/**
|
|
577
579
|
* Gera scripts utilitΓ‘rios
|
|
578
580
|
*/
|
|
579
581
|
const scriptTemplates = {
|
|
580
|
-
'scripts/build-context-pack.mjs': `import fs from 'node:fs';
|
|
581
|
-
import path from 'node:path';
|
|
582
|
-
import { fileURLToPath } from 'node:url';
|
|
583
|
-
|
|
584
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
585
|
-
const __dirname = path.dirname(__filename);
|
|
586
|
-
const root = path.resolve(__dirname, '..');
|
|
587
|
-
const outputDir = path.join(root, '.context');
|
|
588
|
-
const outFile = path.join(outputDir, 'context-pack.md');
|
|
589
|
-
|
|
590
|
-
const priorityFiles = [
|
|
591
|
-
'memory/00-global/mission.md',
|
|
592
|
-
'memory/00-global/standards.md',
|
|
593
|
-
'memory/00-global/context-policy.md',
|
|
594
|
-
'memory/20-architecture/backend.md',
|
|
595
|
-
'memory/40-delivery/current-sprint.md',
|
|
596
|
-
'memory/70-summaries/global-summary.md'
|
|
597
|
-
];
|
|
598
|
-
|
|
599
|
-
fs.mkdirSync(outputDir, { recursive: true });
|
|
600
|
-
let content = '# Context Pack\\n\\n';
|
|
601
|
-
|
|
602
|
-
for (const rel of priorityFiles) {
|
|
603
|
-
const abs = path.join(root, rel);
|
|
604
|
-
if (!fs.existsSync(abs)) continue;
|
|
605
|
-
const raw = fs.readFileSync(abs, 'utf8').slice(0, 6000);
|
|
606
|
-
content += '## ' + rel + '\\n\\n' + raw + '\\n\\n';
|
|
607
|
-
}
|
|
608
|
-
|
|
609
|
-
fs.writeFileSync(outFile, content, 'utf8');
|
|
610
|
-
console.log('Context pack gerado em: ' + outFile);
|
|
611
|
-
`,
|
|
612
|
-
'scripts/append-handoff.mjs': `import fs from 'node:fs';
|
|
613
|
-
import path from 'node:path';
|
|
614
|
-
import { fileURLToPath } from 'node:url';
|
|
615
|
-
|
|
616
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
617
|
-
const __dirname = path.dirname(__filename);
|
|
618
|
-
const root = path.resolve(__dirname, '..');
|
|
619
|
-
|
|
620
|
-
const [from = 'agente-a', to = 'agente-b', title = 'handoff'] = process.argv.slice(2);
|
|
621
|
-
const dir = path.join(root, 'memory/50-orchestration/handoffs');
|
|
622
|
-
fs.mkdirSync(dir, { recursive: true });
|
|
623
|
-
|
|
624
|
-
const stamp = new Date().toISOString().replace(/[:]/g, '-');
|
|
625
|
-
const file = path.join(dir, stamp + '_' + from + '_para_' + to + '.md');
|
|
626
|
-
|
|
627
|
-
const template = '# Handoff: ' + from + ' -> ' + to + '\\n\\n'
|
|
628
|
-
+ '## Titulo\\n' + title + '\\n\\n'
|
|
629
|
-
+ '## Contexto\\n-\\n\\n'
|
|
630
|
-
+ '## Alteracoes\\n-\\n\\n'
|
|
631
|
-
+ '## Riscos\\n-\\n\\n'
|
|
632
|
-
+ '## Pendencias\\n-\\n\\n'
|
|
633
|
-
+ '## Proximo passo\\n-\\n';
|
|
634
|
-
|
|
635
|
-
fs.writeFileSync(file, template, 'utf8');
|
|
636
|
-
console.log('Handoff criado: ' + file);
|
|
637
|
-
`,
|
|
638
|
-
'scripts/check-memory-maps.mjs': `import fs from 'node:fs';
|
|
639
|
-
import path from 'node:path';
|
|
640
|
-
import { fileURLToPath } from 'node:url';
|
|
641
|
-
|
|
642
|
-
// Gate herdado do Forja (ADR-0030): os mapas de memoria (context.md) nao mentem sobre o codigo.
|
|
643
|
-
// Self-contained, zero dependencia. Rode no CI: node scripts/check-memory-maps.mjs
|
|
644
|
-
const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
|
645
|
-
const domainsDir = path.join(root, 'memory/30-domains');
|
|
646
|
-
const modulesDir = path.join(root, 'backend/src/modules');
|
|
647
|
-
const BT = String.fromCharCode(96);
|
|
648
|
-
const CODE_REF = new RegExp(BT + '([a-z][a-zA-Z0-9/._-]*/[a-zA-Z0-9/._-]*[.]ts)' + BT, 'g');
|
|
649
|
-
|
|
650
|
-
function dirs(p) {
|
|
651
|
-
try { return fs.readdirSync(p).filter((e) => fs.statSync(path.join(p, e)).isDirectory()); }
|
|
652
|
-
catch { return []; }
|
|
653
|
-
}
|
|
654
|
-
function resolves(domain, ref) {
|
|
655
|
-
const bases = [path.join(modulesDir, domain), path.join(root, 'backend'), root];
|
|
656
|
-
return bases.some((b) => fs.existsSync(path.join(b, ref)));
|
|
657
|
-
}
|
|
658
|
-
|
|
659
|
-
let dangling = 0;
|
|
660
|
-
const domains = dirs(domainsDir);
|
|
661
|
-
for (const d of domains) {
|
|
662
|
-
let src;
|
|
663
|
-
try { src = fs.readFileSync(path.join(domainsDir, d, 'context.md'), 'utf8'); }
|
|
664
|
-
catch { continue; }
|
|
665
|
-
const refs = [...new Set([...src.matchAll(CODE_REF)].map((m) => m[1]))];
|
|
666
|
-
const bad = refs.filter((r) => !resolves(d, r));
|
|
667
|
-
if (bad.length) { dangling += bad.length; console.log('x ' + d + ': ' + bad.join(', ') + ' -- o mapa aponta, o arquivo nao existe'); }
|
|
668
|
-
else { console.log('ok ' + d + ' -- ' + refs.length + ' referencia(s)'); }
|
|
669
|
-
}
|
|
670
|
-
const mapped = new Set(domains);
|
|
671
|
-
for (const m of dirs(modulesDir)) {
|
|
672
|
-
if (!mapped.has(m)) console.log('! modulo ' + m + ' sem context.md -- economia de token perdida');
|
|
673
|
-
}
|
|
674
|
-
if (dangling) {
|
|
675
|
-
console.log('');
|
|
676
|
-
console.log('REPROVADO -- ' + dangling + ' referencia(s) pendurada(s). Corrija o context.md ou o path.');
|
|
677
|
-
process.exit(1);
|
|
678
|
-
}
|
|
679
|
-
console.log('');
|
|
680
|
-
console.log('OK -- os mapas de memoria batem com o codigo.');
|
|
681
|
-
`,
|
|
682
|
-
'scripts/lib/skill-loader.mjs': `import fs from 'node:fs';
|
|
683
|
-
import path from 'node:path';
|
|
684
|
-
import { fileURLToPath } from 'node:url';
|
|
685
|
-
|
|
686
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
687
|
-
const __dirname = path.dirname(__filename);
|
|
688
|
-
const root = path.resolve(__dirname, '..', '..');
|
|
689
|
-
|
|
690
|
-
export function loadSkills() {
|
|
691
|
-
const manifestPath = path.join(root, 'skills', 'MANIFEST.json');
|
|
692
|
-
if (!fs.existsSync(manifestPath)) return [];
|
|
693
|
-
const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
|
|
694
|
-
return manifest.skills;
|
|
695
|
-
}
|
|
696
|
-
|
|
697
|
-
export function getSkill(id) {
|
|
698
|
-
const skills = loadSkills();
|
|
699
|
-
return skills.find(s => s.id === id);
|
|
700
|
-
}
|
|
701
|
-
`,
|
|
702
|
-
'scripts/memory-vacuum.mjs': `import fs from 'node:fs';
|
|
703
|
-
import path from 'node:path';
|
|
704
|
-
import { fileURLToPath } from 'node:url';
|
|
705
|
-
|
|
706
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
707
|
-
const __dirname = path.dirname(__filename);
|
|
708
|
-
const root = path.resolve(__dirname, '..');
|
|
709
|
-
const runsDir = path.join(root, 'memory/60-runs');
|
|
710
|
-
const archiveDir = path.join(runsDir, 'archive');
|
|
711
|
-
|
|
712
|
-
const TTL_DAYS = 30;
|
|
713
|
-
const now = Date.now();
|
|
714
|
-
|
|
715
|
-
if (!fs.existsSync(runsDir)) process.exit(0);
|
|
716
|
-
if (!fs.existsSync(archiveDir)) fs.mkdirSync(archiveDir, { recursive: true });
|
|
717
|
-
|
|
718
|
-
const entries = fs.readdirSync(runsDir, { withFileTypes: true });
|
|
719
|
-
|
|
720
|
-
let archived = 0;
|
|
721
|
-
for (const entry of entries) {
|
|
722
|
-
if (entry.name === 'README.md' || entry.name === 'archive' || entry.name === '.gitkeep') continue;
|
|
723
|
-
|
|
724
|
-
const abs = path.join(runsDir, entry.name);
|
|
725
|
-
const stats = fs.statSync(abs);
|
|
726
|
-
const ageDays = (now - stats.mtimeMs) / (1000 * 60 * 60 * 24);
|
|
727
|
-
|
|
728
|
-
if (ageDays > TTL_DAYS) {
|
|
729
|
-
const dest = path.join(archiveDir, entry.name);
|
|
730
|
-
fs.renameSync(abs, dest);
|
|
731
|
-
archived++;
|
|
732
|
-
}
|
|
733
|
-
}
|
|
734
|
-
|
|
735
|
-
if (archived > 0) {
|
|
736
|
-
console.log('Vacuum: ' + archived + ' runs movidas para archive/');
|
|
737
|
-
}
|
|
738
|
-
`,
|
|
739
|
-
'scripts/memory-watcher.mjs': `import { watch } from 'node:fs';
|
|
740
|
-
import { exec } from 'node:child_process';
|
|
741
|
-
import path from 'node:path';
|
|
742
|
-
import { fileURLToPath } from 'node:url';
|
|
743
|
-
|
|
744
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
745
|
-
const __dirname = path.dirname(__filename);
|
|
746
|
-
const root = path.resolve(__dirname, '..');
|
|
747
|
-
|
|
748
|
-
const watchDirs = ['memory', 'agents', 'skills', 'prompts', 'docs'];
|
|
749
|
-
let timeout = null;
|
|
750
|
-
|
|
751
|
-
console.log('π Memory Watcher iniciado...');
|
|
752
|
-
|
|
753
|
-
watchDirs.forEach(dir => {
|
|
754
|
-
const absDir = path.join(root, dir);
|
|
755
|
-
watch(absDir, { recursive: true }, (eventType, filename) => {
|
|
756
|
-
if (filename && filename.endsWith('.md')) {
|
|
757
|
-
if (timeout) clearTimeout(timeout);
|
|
758
|
-
timeout = setTimeout(() => {
|
|
759
|
-
console.log('π MudanΓ§a detectada em: ' + filename + '. Sincronizando SQLite...');
|
|
760
|
-
exec('npm run memory:db:sync', { cwd: path.join(root, 'backend') }, (err, stdout) => {
|
|
761
|
-
if (err) console.error('β Erro no sync: ' + err.message);
|
|
762
|
-
else console.log('β
SQLite sincronizado.');
|
|
763
|
-
});
|
|
764
|
-
}, 1000);
|
|
765
|
-
}
|
|
766
|
-
});
|
|
767
|
-
});
|
|
582
|
+
'scripts/build-context-pack.mjs': `import fs from 'node:fs';
|
|
583
|
+
import path from 'node:path';
|
|
584
|
+
import { fileURLToPath } from 'node:url';
|
|
585
|
+
|
|
586
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
587
|
+
const __dirname = path.dirname(__filename);
|
|
588
|
+
const root = path.resolve(__dirname, '..');
|
|
589
|
+
const outputDir = path.join(root, '.context');
|
|
590
|
+
const outFile = path.join(outputDir, 'context-pack.md');
|
|
591
|
+
|
|
592
|
+
const priorityFiles = [
|
|
593
|
+
'memory/00-global/mission.md',
|
|
594
|
+
'memory/00-global/standards.md',
|
|
595
|
+
'memory/00-global/context-policy.md',
|
|
596
|
+
'memory/20-architecture/backend.md',
|
|
597
|
+
'memory/40-delivery/current-sprint.md',
|
|
598
|
+
'memory/70-summaries/global-summary.md'
|
|
599
|
+
];
|
|
600
|
+
|
|
601
|
+
fs.mkdirSync(outputDir, { recursive: true });
|
|
602
|
+
let content = '# Context Pack\\n\\n';
|
|
603
|
+
|
|
604
|
+
for (const rel of priorityFiles) {
|
|
605
|
+
const abs = path.join(root, rel);
|
|
606
|
+
if (!fs.existsSync(abs)) continue;
|
|
607
|
+
const raw = fs.readFileSync(abs, 'utf8').slice(0, 6000);
|
|
608
|
+
content += '## ' + rel + '\\n\\n' + raw + '\\n\\n';
|
|
609
|
+
}
|
|
610
|
+
|
|
611
|
+
fs.writeFileSync(outFile, content, 'utf8');
|
|
612
|
+
console.log('Context pack gerado em: ' + outFile);
|
|
613
|
+
`,
|
|
614
|
+
'scripts/append-handoff.mjs': `import fs from 'node:fs';
|
|
615
|
+
import path from 'node:path';
|
|
616
|
+
import { fileURLToPath } from 'node:url';
|
|
617
|
+
|
|
618
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
619
|
+
const __dirname = path.dirname(__filename);
|
|
620
|
+
const root = path.resolve(__dirname, '..');
|
|
621
|
+
|
|
622
|
+
const [from = 'agente-a', to = 'agente-b', title = 'handoff'] = process.argv.slice(2);
|
|
623
|
+
const dir = path.join(root, 'memory/50-orchestration/handoffs');
|
|
624
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
625
|
+
|
|
626
|
+
const stamp = new Date().toISOString().replace(/[:]/g, '-');
|
|
627
|
+
const file = path.join(dir, stamp + '_' + from + '_para_' + to + '.md');
|
|
628
|
+
|
|
629
|
+
const template = '# Handoff: ' + from + ' -> ' + to + '\\n\\n'
|
|
630
|
+
+ '## Titulo\\n' + title + '\\n\\n'
|
|
631
|
+
+ '## Contexto\\n-\\n\\n'
|
|
632
|
+
+ '## Alteracoes\\n-\\n\\n'
|
|
633
|
+
+ '## Riscos\\n-\\n\\n'
|
|
634
|
+
+ '## Pendencias\\n-\\n\\n'
|
|
635
|
+
+ '## Proximo passo\\n-\\n';
|
|
636
|
+
|
|
637
|
+
fs.writeFileSync(file, template, 'utf8');
|
|
638
|
+
console.log('Handoff criado: ' + file);
|
|
639
|
+
`,
|
|
640
|
+
'scripts/check-memory-maps.mjs': `import fs from 'node:fs';
|
|
641
|
+
import path from 'node:path';
|
|
642
|
+
import { fileURLToPath } from 'node:url';
|
|
643
|
+
|
|
644
|
+
// Gate herdado do Forja (ADR-0030): os mapas de memoria (context.md) nao mentem sobre o codigo.
|
|
645
|
+
// Self-contained, zero dependencia. Rode no CI: node scripts/check-memory-maps.mjs
|
|
646
|
+
const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
|
647
|
+
const domainsDir = path.join(root, 'memory/30-domains');
|
|
648
|
+
const modulesDir = path.join(root, 'backend/src/modules');
|
|
649
|
+
const BT = String.fromCharCode(96);
|
|
650
|
+
const CODE_REF = new RegExp(BT + '([a-z][a-zA-Z0-9/._-]*/[a-zA-Z0-9/._-]*[.]ts)' + BT, 'g');
|
|
651
|
+
|
|
652
|
+
function dirs(p) {
|
|
653
|
+
try { return fs.readdirSync(p).filter((e) => fs.statSync(path.join(p, e)).isDirectory()); }
|
|
654
|
+
catch { return []; }
|
|
655
|
+
}
|
|
656
|
+
function resolves(domain, ref) {
|
|
657
|
+
const bases = [path.join(modulesDir, domain), path.join(root, 'backend'), root];
|
|
658
|
+
return bases.some((b) => fs.existsSync(path.join(b, ref)));
|
|
659
|
+
}
|
|
660
|
+
|
|
661
|
+
let dangling = 0;
|
|
662
|
+
const domains = dirs(domainsDir);
|
|
663
|
+
for (const d of domains) {
|
|
664
|
+
let src;
|
|
665
|
+
try { src = fs.readFileSync(path.join(domainsDir, d, 'context.md'), 'utf8'); }
|
|
666
|
+
catch { continue; }
|
|
667
|
+
const refs = [...new Set([...src.matchAll(CODE_REF)].map((m) => m[1]))];
|
|
668
|
+
const bad = refs.filter((r) => !resolves(d, r));
|
|
669
|
+
if (bad.length) { dangling += bad.length; console.log('x ' + d + ': ' + bad.join(', ') + ' -- o mapa aponta, o arquivo nao existe'); }
|
|
670
|
+
else { console.log('ok ' + d + ' -- ' + refs.length + ' referencia(s)'); }
|
|
671
|
+
}
|
|
672
|
+
const mapped = new Set(domains);
|
|
673
|
+
for (const m of dirs(modulesDir)) {
|
|
674
|
+
if (!mapped.has(m)) console.log('! modulo ' + m + ' sem context.md -- economia de token perdida');
|
|
675
|
+
}
|
|
676
|
+
if (dangling) {
|
|
677
|
+
console.log('');
|
|
678
|
+
console.log('REPROVADO -- ' + dangling + ' referencia(s) pendurada(s). Corrija o context.md ou o path.');
|
|
679
|
+
process.exit(1);
|
|
680
|
+
}
|
|
681
|
+
console.log('');
|
|
682
|
+
console.log('OK -- os mapas de memoria batem com o codigo.');
|
|
683
|
+
`,
|
|
684
|
+
'scripts/lib/skill-loader.mjs': `import fs from 'node:fs';
|
|
685
|
+
import path from 'node:path';
|
|
686
|
+
import { fileURLToPath } from 'node:url';
|
|
687
|
+
|
|
688
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
689
|
+
const __dirname = path.dirname(__filename);
|
|
690
|
+
const root = path.resolve(__dirname, '..', '..');
|
|
691
|
+
|
|
692
|
+
export function loadSkills() {
|
|
693
|
+
const manifestPath = path.join(root, 'skills', 'MANIFEST.json');
|
|
694
|
+
if (!fs.existsSync(manifestPath)) return [];
|
|
695
|
+
const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
|
|
696
|
+
return manifest.skills;
|
|
697
|
+
}
|
|
698
|
+
|
|
699
|
+
export function getSkill(id) {
|
|
700
|
+
const skills = loadSkills();
|
|
701
|
+
return skills.find(s => s.id === id);
|
|
702
|
+
}
|
|
703
|
+
`,
|
|
704
|
+
'scripts/memory-vacuum.mjs': `import fs from 'node:fs';
|
|
705
|
+
import path from 'node:path';
|
|
706
|
+
import { fileURLToPath } from 'node:url';
|
|
707
|
+
|
|
708
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
709
|
+
const __dirname = path.dirname(__filename);
|
|
710
|
+
const root = path.resolve(__dirname, '..');
|
|
711
|
+
const runsDir = path.join(root, 'memory/60-runs');
|
|
712
|
+
const archiveDir = path.join(runsDir, 'archive');
|
|
713
|
+
|
|
714
|
+
const TTL_DAYS = 30;
|
|
715
|
+
const now = Date.now();
|
|
716
|
+
|
|
717
|
+
if (!fs.existsSync(runsDir)) process.exit(0);
|
|
718
|
+
if (!fs.existsSync(archiveDir)) fs.mkdirSync(archiveDir, { recursive: true });
|
|
719
|
+
|
|
720
|
+
const entries = fs.readdirSync(runsDir, { withFileTypes: true });
|
|
721
|
+
|
|
722
|
+
let archived = 0;
|
|
723
|
+
for (const entry of entries) {
|
|
724
|
+
if (entry.name === 'README.md' || entry.name === 'archive' || entry.name === '.gitkeep') continue;
|
|
725
|
+
|
|
726
|
+
const abs = path.join(runsDir, entry.name);
|
|
727
|
+
const stats = fs.statSync(abs);
|
|
728
|
+
const ageDays = (now - stats.mtimeMs) / (1000 * 60 * 60 * 24);
|
|
729
|
+
|
|
730
|
+
if (ageDays > TTL_DAYS) {
|
|
731
|
+
const dest = path.join(archiveDir, entry.name);
|
|
732
|
+
fs.renameSync(abs, dest);
|
|
733
|
+
archived++;
|
|
734
|
+
}
|
|
735
|
+
}
|
|
736
|
+
|
|
737
|
+
if (archived > 0) {
|
|
738
|
+
console.log('Vacuum: ' + archived + ' runs movidas para archive/');
|
|
739
|
+
}
|
|
740
|
+
`,
|
|
741
|
+
'scripts/memory-watcher.mjs': `import { watch } from 'node:fs';
|
|
742
|
+
import { exec } from 'node:child_process';
|
|
743
|
+
import path from 'node:path';
|
|
744
|
+
import { fileURLToPath } from 'node:url';
|
|
745
|
+
|
|
746
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
747
|
+
const __dirname = path.dirname(__filename);
|
|
748
|
+
const root = path.resolve(__dirname, '..');
|
|
749
|
+
|
|
750
|
+
const watchDirs = ['memory', 'agents', 'skills', 'prompts', 'docs'];
|
|
751
|
+
let timeout = null;
|
|
752
|
+
|
|
753
|
+
console.log('π Memory Watcher iniciado...');
|
|
754
|
+
|
|
755
|
+
watchDirs.forEach(dir => {
|
|
756
|
+
const absDir = path.join(root, dir);
|
|
757
|
+
watch(absDir, { recursive: true }, (eventType, filename) => {
|
|
758
|
+
if (filename && filename.endsWith('.md')) {
|
|
759
|
+
if (timeout) clearTimeout(timeout);
|
|
760
|
+
timeout = setTimeout(() => {
|
|
761
|
+
console.log('π MudanΓ§a detectada em: ' + filename + '. Sincronizando SQLite...');
|
|
762
|
+
exec('npm run memory:db:sync', { cwd: path.join(root, 'backend') }, (err, stdout) => {
|
|
763
|
+
if (err) console.error('β Erro no sync: ' + err.message);
|
|
764
|
+
else console.log('β
SQLite sincronizado.');
|
|
765
|
+
});
|
|
766
|
+
}, 1000);
|
|
767
|
+
}
|
|
768
|
+
});
|
|
769
|
+
});
|
|
768
770
|
`,
|
|
769
771
|
};
|
|
770
772
|
/**
|