forjajs 2.0.2 → 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 -317
- package/README.pt-BR.md +345 -323
- 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/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- 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 +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -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-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -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-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- 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.d.ts +1 -0
- 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 -132
- 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 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- 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 -0
- 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 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- 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 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- 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 -140
- 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/specs/README.md
CHANGED
|
@@ -1,70 +1,70 @@
|
|
|
1
|
-
# Specs — Pipeline SDD
|
|
2
|
-
|
|
3
|
-
Toda feature não-trivial passa por **spec → plan → tasks** antes de virar código.
|
|
4
|
-
|
|
5
|
-
## Fluxo
|
|
6
|
-
|
|
7
|
-
```
|
|
8
|
-
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
9
|
-
│ spec │ → │ plan │ → │ tasks │ → │ código │
|
|
10
|
-
│ (porquê) │ │ (como) │ │ (passos) │ │ (impl.) │
|
|
11
|
-
└──────────┘ └──────────┘ └──────────┘ └──────────┘
|
|
12
|
-
Product SDD Architect SDD Architect Worker
|
|
13
|
-
+ Governance
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Comandos
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
npm run spec:new <feature> # cria specs/<feature>/spec.md
|
|
20
|
-
npm run spec:plan <feature> # cria plan.md (após spec aprovada)
|
|
21
|
-
npm run spec:tasks <feature> # cria tasks.md (após plan aprovado)
|
|
22
|
-
npm run spec:check <feature> # valida que as 3 fases existem e foram preenchidas
|
|
23
|
-
npm run spec:check # valida todas
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Estrutura de uma feature
|
|
27
|
-
|
|
28
|
-
```
|
|
29
|
-
specs/
|
|
30
|
-
<feature-slug>/
|
|
31
|
-
spec.md # problema, AC, NFRs, escopo
|
|
32
|
-
plan.md # arquitetura, contratos, decisões
|
|
33
|
-
tasks.md # decomposição executável
|
|
34
|
-
notes/ # opcional: research, mockups
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## Critérios de "spec aprovada"
|
|
38
|
-
|
|
39
|
-
- Problema descrito em 1 frase
|
|
40
|
-
- Pelo menos 1 user story com persona, ação, benefício
|
|
41
|
-
- ≥3 critérios de aceite observáveis
|
|
42
|
-
- Escopo fora explicitado
|
|
43
|
-
- NFRs com números (não "rápido", mas "p95 < 200ms")
|
|
44
|
-
|
|
45
|
-
## Quando NÃO precisa de spec
|
|
46
|
-
|
|
47
|
-
- Bugfix de 1 linha
|
|
48
|
-
- Renomeação/rearranjo sem mudança de contrato
|
|
49
|
-
- Atualização de documentação
|
|
50
|
-
- Bump de dependência sem breaking change
|
|
51
|
-
|
|
52
|
-
Em dúvida: escreva spec. Custa 10min, salva retrabalho.
|
|
53
|
-
|
|
54
|
-
## Relação com ADRs
|
|
55
|
-
|
|
56
|
-
- **Spec** = "vamos fazer X"
|
|
57
|
-
- **ADR** = "decidimos fazer X **deste jeito** por **estas razões**"
|
|
58
|
-
|
|
59
|
-
Plan da spec pode gerar 0..N ADRs novas. Toda decisão estrutural irreversível mencionada no plan vira ADR em `memory/90-decisions/`.
|
|
60
|
-
|
|
61
|
-
## Estados
|
|
62
|
-
|
|
63
|
-
| Estado | Significado |
|
|
64
|
-
|---|---|
|
|
65
|
-
| `draft` | Em escrita, não revise ainda |
|
|
66
|
-
| `review` | Pronto para feedback |
|
|
67
|
-
| `approved` | OK para próxima fase (plan ou tasks) |
|
|
68
|
-
| `implementing` | Código sendo escrito |
|
|
69
|
-
| `done` | Mergeado e validado |
|
|
70
|
-
| `abandoned` | Não vai acontecer (mantemos por histórico) |
|
|
1
|
+
# Specs — Pipeline SDD
|
|
2
|
+
|
|
3
|
+
Toda feature não-trivial passa por **spec → plan → tasks** antes de virar código.
|
|
4
|
+
|
|
5
|
+
## Fluxo
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
9
|
+
│ spec │ → │ plan │ → │ tasks │ → │ código │
|
|
10
|
+
│ (porquê) │ │ (como) │ │ (passos) │ │ (impl.) │
|
|
11
|
+
└──────────┘ └──────────┘ └──────────┘ └──────────┘
|
|
12
|
+
Product SDD Architect SDD Architect Worker
|
|
13
|
+
+ Governance
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Comandos
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm run spec:new <feature> # cria specs/<feature>/spec.md
|
|
20
|
+
npm run spec:plan <feature> # cria plan.md (após spec aprovada)
|
|
21
|
+
npm run spec:tasks <feature> # cria tasks.md (após plan aprovado)
|
|
22
|
+
npm run spec:check <feature> # valida que as 3 fases existem e foram preenchidas
|
|
23
|
+
npm run spec:check # valida todas
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Estrutura de uma feature
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
specs/
|
|
30
|
+
<feature-slug>/
|
|
31
|
+
spec.md # problema, AC, NFRs, escopo
|
|
32
|
+
plan.md # arquitetura, contratos, decisões
|
|
33
|
+
tasks.md # decomposição executável
|
|
34
|
+
notes/ # opcional: research, mockups
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Critérios de "spec aprovada"
|
|
38
|
+
|
|
39
|
+
- Problema descrito em 1 frase
|
|
40
|
+
- Pelo menos 1 user story com persona, ação, benefício
|
|
41
|
+
- ≥3 critérios de aceite observáveis
|
|
42
|
+
- Escopo fora explicitado
|
|
43
|
+
- NFRs com números (não "rápido", mas "p95 < 200ms")
|
|
44
|
+
|
|
45
|
+
## Quando NÃO precisa de spec
|
|
46
|
+
|
|
47
|
+
- Bugfix de 1 linha
|
|
48
|
+
- Renomeação/rearranjo sem mudança de contrato
|
|
49
|
+
- Atualização de documentação
|
|
50
|
+
- Bump de dependência sem breaking change
|
|
51
|
+
|
|
52
|
+
Em dúvida: escreva spec. Custa 10min, salva retrabalho.
|
|
53
|
+
|
|
54
|
+
## Relação com ADRs
|
|
55
|
+
|
|
56
|
+
- **Spec** = "vamos fazer X"
|
|
57
|
+
- **ADR** = "decidimos fazer X **deste jeito** por **estas razões**"
|
|
58
|
+
|
|
59
|
+
Plan da spec pode gerar 0..N ADRs novas. Toda decisão estrutural irreversível mencionada no plan vira ADR em `memory/90-decisions/`.
|
|
60
|
+
|
|
61
|
+
## Estados
|
|
62
|
+
|
|
63
|
+
| Estado | Significado |
|
|
64
|
+
|---|---|
|
|
65
|
+
| `draft` | Em escrita, não revise ainda |
|
|
66
|
+
| `review` | Pronto para feedback |
|
|
67
|
+
| `approved` | OK para próxima fase (plan ou tasks) |
|
|
68
|
+
| `implementing` | Código sendo escrito |
|
|
69
|
+
| `done` | Mergeado e validado |
|
|
70
|
+
| `abandoned` | Não vai acontecer (mantemos por histórico) |
|
package/specs/_templates/plan.md
CHANGED
|
@@ -1,43 +1,43 @@
|
|
|
1
|
-
# Plan: {{FEATURE}}
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Status**: draft | review | approved
|
|
5
|
-
- **Criado em**: {{DATE}}
|
|
6
|
-
|
|
7
|
-
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
-
|
|
9
|
-
## 1. Abordagem técnica
|
|
10
|
-
<Visão geral em 3-5 linhas. Qual estratégia (extend vs. rewrite, lib vs. service, sync vs. async).>
|
|
11
|
-
|
|
12
|
-
## 2. Módulos afetados
|
|
13
|
-
| Caminho | Mudança | Risco |
|
|
14
|
-
|---|---|---|
|
|
15
|
-
| `lib/...` | criar / editar / remover | B/M/A |
|
|
16
|
-
| `scripts/...` | ... | ... |
|
|
17
|
-
|
|
18
|
-
## 3. Diagrama de fluxo
|
|
19
|
-
```
|
|
20
|
-
<ASCII ou descrição textual do fluxo de dados/controle>
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
## 4. Contratos (API/CLI/Schema)
|
|
24
|
-
<Assinatura de funções públicas, endpoints, formato de arquivos novos.>
|
|
25
|
-
|
|
26
|
-
## 5. Decisões e alternativas
|
|
27
|
-
**D1**: <decisão> — alternativas rejeitadas: <A> (por X), <B> (por Y)
|
|
28
|
-
**D2**: ...
|
|
29
|
-
|
|
30
|
-
Se alguma D é estrutural ou irreversível, abra ADR em `memory/90-decisions/` e referencie aqui.
|
|
31
|
-
|
|
32
|
-
## 6. Dependências
|
|
33
|
-
- Outras specs: ...
|
|
34
|
-
- Pacotes npm: ...
|
|
35
|
-
- Migrações de dado/memory: ...
|
|
36
|
-
|
|
37
|
-
## 7. Rollout
|
|
38
|
-
- [ ] Feature flag necessária?
|
|
39
|
-
- [ ] Migração de dados existentes?
|
|
40
|
-
- [ ] Doc/persona impactada?
|
|
41
|
-
|
|
42
|
-
## 8. Sinais de fracasso (kill criteria)
|
|
43
|
-
<O que faria abandonar essa abordagem mid-flight?>
|
|
1
|
+
# Plan: {{FEATURE}}
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: draft | review | approved
|
|
5
|
+
- **Criado em**: {{DATE}}
|
|
6
|
+
|
|
7
|
+
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
+
|
|
9
|
+
## 1. Abordagem técnica
|
|
10
|
+
<Visão geral em 3-5 linhas. Qual estratégia (extend vs. rewrite, lib vs. service, sync vs. async).>
|
|
11
|
+
|
|
12
|
+
## 2. Módulos afetados
|
|
13
|
+
| Caminho | Mudança | Risco |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| `lib/...` | criar / editar / remover | B/M/A |
|
|
16
|
+
| `scripts/...` | ... | ... |
|
|
17
|
+
|
|
18
|
+
## 3. Diagrama de fluxo
|
|
19
|
+
```
|
|
20
|
+
<ASCII ou descrição textual do fluxo de dados/controle>
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## 4. Contratos (API/CLI/Schema)
|
|
24
|
+
<Assinatura de funções públicas, endpoints, formato de arquivos novos.>
|
|
25
|
+
|
|
26
|
+
## 5. Decisões e alternativas
|
|
27
|
+
**D1**: <decisão> — alternativas rejeitadas: <A> (por X), <B> (por Y)
|
|
28
|
+
**D2**: ...
|
|
29
|
+
|
|
30
|
+
Se alguma D é estrutural ou irreversível, abra ADR em `memory/90-decisions/` e referencie aqui.
|
|
31
|
+
|
|
32
|
+
## 6. Dependências
|
|
33
|
+
- Outras specs: ...
|
|
34
|
+
- Pacotes npm: ...
|
|
35
|
+
- Migrações de dado/memory: ...
|
|
36
|
+
|
|
37
|
+
## 7. Rollout
|
|
38
|
+
- [ ] Feature flag necessária?
|
|
39
|
+
- [ ] Migração de dados existentes?
|
|
40
|
+
- [ ] Doc/persona impactada?
|
|
41
|
+
|
|
42
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
43
|
+
<O que faria abandonar essa abordagem mid-flight?>
|
package/specs/_templates/spec.md
CHANGED
|
@@ -1,43 +1,43 @@
|
|
|
1
|
-
# Spec: {{FEATURE}}
|
|
2
|
-
|
|
3
|
-
- **ID**: {{ID}}
|
|
4
|
-
- **Status**: draft | review | approved | implementing | done | abandoned
|
|
5
|
-
- **Owner**: {{OWNER}}
|
|
6
|
-
- **Criado em**: {{DATE}}
|
|
7
|
-
- **Sprint alvo**: <S?>
|
|
8
|
-
- **ADRs relacionadas**: <links para memory/90-decisions/>
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
<O que está doendo? Quem sente a dor? Como medimos hoje?>
|
|
12
|
-
|
|
13
|
-
## 2. Proposta de valor
|
|
14
|
-
<O que muda quando isto existir? Frase única, mensurável.>
|
|
15
|
-
|
|
16
|
-
## 3. User stories
|
|
17
|
-
- **Como** <persona>, **quero** <ação>, **para que** <benefício>
|
|
18
|
-
- ...
|
|
19
|
-
|
|
20
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
21
|
-
- [ ] AC-1: <observável, testável>
|
|
22
|
-
- [ ] AC-2: ...
|
|
23
|
-
|
|
24
|
-
## 5. Escopo
|
|
25
|
-
**Dentro**:
|
|
26
|
-
- ...
|
|
27
|
-
|
|
28
|
-
**Fora** (explícito, evita scope creep):
|
|
29
|
-
- ...
|
|
30
|
-
|
|
31
|
-
## 6. NFRs / restrições
|
|
32
|
-
- Performance: <ex: p95 < 200ms>
|
|
33
|
-
- Segurança: <ex: validação class-validator obrigatória — ADR-0004>
|
|
34
|
-
- Observabilidade: <ex: log estruturado por endpoint>
|
|
35
|
-
- Compatibilidade: <ex: não quebra `init-project.js`>
|
|
36
|
-
|
|
37
|
-
## 7. Riscos e mitigação
|
|
38
|
-
| Risco | Probabilidade | Impacto | Mitigação |
|
|
39
|
-
|---|---|---|---|
|
|
40
|
-
| ... | M | A | ... |
|
|
41
|
-
|
|
42
|
-
## 8. Métricas de sucesso
|
|
43
|
-
<Como saberemos se foi um sucesso 30 dias após o release?>
|
|
1
|
+
# Spec: {{FEATURE}}
|
|
2
|
+
|
|
3
|
+
- **ID**: {{ID}}
|
|
4
|
+
- **Status**: draft | review | approved | implementing | done | abandoned
|
|
5
|
+
- **Owner**: {{OWNER}}
|
|
6
|
+
- **Criado em**: {{DATE}}
|
|
7
|
+
- **Sprint alvo**: <S?>
|
|
8
|
+
- **ADRs relacionadas**: <links para memory/90-decisions/>
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
<O que está doendo? Quem sente a dor? Como medimos hoje?>
|
|
12
|
+
|
|
13
|
+
## 2. Proposta de valor
|
|
14
|
+
<O que muda quando isto existir? Frase única, mensurável.>
|
|
15
|
+
|
|
16
|
+
## 3. User stories
|
|
17
|
+
- **Como** <persona>, **quero** <ação>, **para que** <benefício>
|
|
18
|
+
- ...
|
|
19
|
+
|
|
20
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
21
|
+
- [ ] AC-1: <observável, testável>
|
|
22
|
+
- [ ] AC-2: ...
|
|
23
|
+
|
|
24
|
+
## 5. Escopo
|
|
25
|
+
**Dentro**:
|
|
26
|
+
- ...
|
|
27
|
+
|
|
28
|
+
**Fora** (explícito, evita scope creep):
|
|
29
|
+
- ...
|
|
30
|
+
|
|
31
|
+
## 6. NFRs / restrições
|
|
32
|
+
- Performance: <ex: p95 < 200ms>
|
|
33
|
+
- Segurança: <ex: validação class-validator obrigatória — ADR-0004>
|
|
34
|
+
- Observabilidade: <ex: log estruturado por endpoint>
|
|
35
|
+
- Compatibilidade: <ex: não quebra `init-project.js`>
|
|
36
|
+
|
|
37
|
+
## 7. Riscos e mitigação
|
|
38
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
39
|
+
|---|---|---|---|
|
|
40
|
+
| ... | M | A | ... |
|
|
41
|
+
|
|
42
|
+
## 8. Métricas de sucesso
|
|
43
|
+
<Como saberemos se foi um sucesso 30 dias após o release?>
|
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
# Tasks: {{FEATURE}}
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: draft
|
|
6
|
-
- **Criado em**: {{DATE}}
|
|
7
|
-
|
|
8
|
-
> Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
|
|
9
|
-
|
|
10
|
-
Convenção de IDs: `T1`, `T2`, ... Sequência reflete ordem de execução padrão (pode ser paralelizada quando indicado).
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## T1 — <título curto>
|
|
15
|
-
- **Owner**: <agente ou pessoa>
|
|
16
|
-
- **Estimativa**: <P/M/G>
|
|
17
|
-
- **Depende de**: —
|
|
18
|
-
- **Paths**: `lib/...`, `scripts/...`
|
|
19
|
-
- **Done quando**:
|
|
20
|
-
- [ ] ...
|
|
21
|
-
- [ ] testes passando
|
|
22
|
-
- [ ] doc atualizada (se aplicável)
|
|
23
|
-
|
|
24
|
-
## T2 — ...
|
|
25
|
-
- **Owner**: ...
|
|
26
|
-
- **Depende de**: T1
|
|
27
|
-
- ...
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
## Handoffs entre agentes
|
|
32
|
-
Se este conjunto de tasks atravessa papéis (Product → SDD Architect → Worker → Governance), registre handoff via `scripts/append-handoff.mjs` ou tabela `handoffs` do `universal.db` (ADR-0005).
|
|
1
|
+
# Tasks: {{FEATURE}}
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: draft
|
|
6
|
+
- **Criado em**: {{DATE}}
|
|
7
|
+
|
|
8
|
+
> Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
|
|
9
|
+
|
|
10
|
+
Convenção de IDs: `T1`, `T2`, ... Sequência reflete ordem de execução padrão (pode ser paralelizada quando indicado).
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## T1 — <título curto>
|
|
15
|
+
- **Owner**: <agente ou pessoa>
|
|
16
|
+
- **Estimativa**: <P/M/G>
|
|
17
|
+
- **Depende de**: —
|
|
18
|
+
- **Paths**: `lib/...`, `scripts/...`
|
|
19
|
+
- **Done quando**:
|
|
20
|
+
- [ ] ...
|
|
21
|
+
- [ ] testes passando
|
|
22
|
+
- [ ] doc atualizada (se aplicável)
|
|
23
|
+
|
|
24
|
+
## T2 — ...
|
|
25
|
+
- **Owner**: ...
|
|
26
|
+
- **Depende de**: T1
|
|
27
|
+
- ...
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Handoffs entre agentes
|
|
32
|
+
Se este conjunto de tasks atravessa papéis (Product → SDD Architect → Worker → Governance), registre handoff via `scripts/append-handoff.mjs` ou tabela `handoffs` do `universal.db` (ADR-0005).
|
|
@@ -1,137 +1,137 @@
|
|
|
1
|
-
# Plan: clean-arch-boilerplate
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Status**: approved
|
|
5
|
-
- **Criado em**: 2026-07-18
|
|
6
|
-
|
|
7
|
-
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
-
|
|
9
|
-
## 1. Abordagem técnica
|
|
10
|
-
|
|
11
|
-
Um boilerplate NestJS + TypeScript com a **regra de dependência para dentro** (Clean Architecture /
|
|
12
|
-
Hexagonal). A fatia rica é **Order** (invariante: não confirma sem estoque, não envia sem
|
|
13
|
-
pagamento) — vive no domínio, testável sem Nest. O contraponto enxuto é **Product** (CRUD),
|
|
14
|
-
demonstrando o caminho de 1 camada. O `WHEN-CLEAN-WHEN-LEAN.md` é o coração da spec: ensina o
|
|
15
|
-
critério, não a ceremônia.
|
|
16
|
-
|
|
17
|
-
O mecanismo de inversão no Nest: a **porta é uma `interface` no domínio + um token de injeção**; o
|
|
18
|
-
adapter (repo ORM) a implementa; o módulo faz o bind `{ provide: ORDER_REPO, useClass: TypeOrmOrderRepo }`.
|
|
19
|
-
O use-case injeta a porta, nunca o adapter. É o padrão documentado uma vez e repetido.
|
|
20
|
-
|
|
21
|
-
## 2. Estrutura de diretórios (o contrato visual)
|
|
22
|
-
|
|
23
|
-
```
|
|
24
|
-
boilerplates/06-clean-arch/
|
|
25
|
-
backend/src/
|
|
26
|
-
modules/orders/ # FATIA RICA — as 4 camadas
|
|
27
|
-
domain/
|
|
28
|
-
order.entity.ts # agregado: invariantes vivem aqui (pure TS, zero Nest/ORM)
|
|
29
|
-
order-status.vo.ts # value object (máquina de estados)
|
|
30
|
-
order.repository.ts # PORTA (interface) + token ORDER_REPOSITORY
|
|
31
|
-
application/
|
|
32
|
-
place-order.usecase.ts # input/output tipados; orquestra domínio + porta
|
|
33
|
-
ship-order.usecase.ts
|
|
34
|
-
dtos.ts # contratos de aplicação (não HTTP)
|
|
35
|
-
infrastructure/
|
|
36
|
-
typeorm-order.repository.ts # ADAPTER: implementa a porta
|
|
37
|
-
order.orm-entity.ts # entity do ORM (mapper domínio↔persistência)
|
|
38
|
-
presentation/
|
|
39
|
-
orders.controller.ts # HTTP DTOs + mapeia p/ use-case
|
|
40
|
-
orders.http.dto.ts
|
|
41
|
-
orders.module.ts # bind porta→adapter (inversão)
|
|
42
|
-
modules/products/ # CAMINHO ENXUTO — CRUD, 1 camada
|
|
43
|
-
products.controller.ts # controller → repo direto; sem use-case/porta
|
|
44
|
-
product.entity.ts
|
|
45
|
-
products.module.ts
|
|
46
|
-
shared/ # Result/Either, base VO, erros de domínio
|
|
47
|
-
main.ts · app.module.ts
|
|
48
|
-
backend/test/
|
|
49
|
-
orders/place-order.spec.ts # testa a INVARIANTE sem subir o Nest (AC-8)
|
|
50
|
-
memory/30-domains/orders/context.md # linguagem ubíqua — o agente lê ISTO antes do código
|
|
51
|
-
memory/30-domains/products/context.md
|
|
52
|
-
WHEN-CLEAN-WHEN-LEAN.md # o critério de calibração
|
|
53
|
-
boilerplate.manifest.json · README.md
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
O `orders/` e o `products/` lado a lado **são** a spec: um mostra Clean Architecture onde se paga, o
|
|
57
|
-
outro mostra o custo evitado. O dev/agente vê os dois e entende o critério pela estrutura.
|
|
58
|
-
|
|
59
|
-
## 3. Fluxo de dependência (a regra)
|
|
60
|
-
|
|
61
|
-
```
|
|
62
|
-
presentation ─┐
|
|
63
|
-
├─► application ─► domain ◄─ (ports: interfaces)
|
|
64
|
-
infrastructure┘ ▲
|
|
65
|
-
(adapters implementam ports) ─┘
|
|
66
|
-
dependências apontam p/ DENTRO. domain não importa nada de fora.
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
## 4. Contratos (o que se lê sem a implementação)
|
|
70
|
-
|
|
71
|
-
```ts
|
|
72
|
-
// domain/order.repository.ts — a PORTA
|
|
73
|
-
export const ORDER_REPOSITORY = Symbol('OrderRepository');
|
|
74
|
-
export interface OrderRepository {
|
|
75
|
-
save(order: Order): Promise<void>;
|
|
76
|
-
byId(id: OrderId): Promise<Order | null>;
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
// application/place-order.usecase.ts — o contrato legível (AC-5)
|
|
80
|
-
export interface PlaceOrderInput { customerId: string; items: OrderLine[]; }
|
|
81
|
-
export interface PlaceOrderOutput { orderId: string; total: Money; }
|
|
82
|
-
// a assinatura basta para o agente saber o que a feature faz — sem ler o corpo
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
## 5. Decisões e alternativas
|
|
86
|
-
|
|
87
|
-
**D1: Order como fatia rica.** Invariante cross-aggregate universal e reconhecível ("não envia sem
|
|
88
|
-
pagamento"). Alternativa (Subscription/máquina de estados) é boa mas menos imediata; fica como VO
|
|
89
|
-
dentro de Order (`order-status.vo.ts`), aproveitando os dois.
|
|
90
|
-
|
|
91
|
-
**D2: Product como caminho enxuto — lado a lado, não escondido.** A calibração precisa ser *visível*.
|
|
92
|
-
Um CRUD que atravessa controller→repo direto, sem use-case nem porta, no mesmo boilerplate. É o AC-4
|
|
93
|
-
materializado em código, não só no doc.
|
|
94
|
-
|
|
95
|
-
**D3: Porta = interface no domínio + token Nest.** O domínio define o contrato; o Nest só faz o bind.
|
|
96
|
-
Alternativa rejeitada: repositório abstrato como classe base (acopla o domínio ao mecanismo de
|
|
97
|
-
herança e, na prática, ao Nest). Interface + token mantém o domínio puro.
|
|
98
|
-
|
|
99
|
-
**D4: Domínio puro, zero `@nestjs` e zero ORM.** É o que torna o teste-sem-Nest (AC-8) possível e é a
|
|
100
|
-
prova concreta do isolamento. O ORM vive só em `infrastructure/`, com mapper explícito
|
|
101
|
-
domínio↔orm-entity. Sem `@Entity` decorando o agregado de domínio.
|
|
102
|
-
|
|
103
|
-
**D5: Memória por contexto é o vetor de token (AC-6).** `context.md` descreve o domínio na linguagem
|
|
104
|
-
ubíqua. O agente lê ele + a assinatura do use-case; só desce ao código quando vai *editar*. É onde a
|
|
105
|
-
economia de token se materializa — e onde a mediremos.
|
|
106
|
-
|
|
107
|
-
**D6: Aditivo, sem tocar 01-05.** Novo diretório, novo manifesto. Os geradores existentes não mudam;
|
|
108
|
-
só o catálogo de boilerplates ganha uma entrada.
|
|
109
|
-
|
|
110
|
-
D1–D5 são estruturais → **ADR-0027** (Clean Architecture calibrada; o porquê da calibração e do token).
|
|
111
|
-
|
|
112
|
-
## 6. Dependências
|
|
113
|
-
|
|
114
|
-
- **Specs**: SPEC-012 (TS) — o domínio é tipado; alinhado, não bloqueante.
|
|
115
|
-
- **Pacotes** (do projeto *gerado*, não do Forja): `@nestjs/*`, `typeorm`, `jest`. Ficam no
|
|
116
|
-
`package.json` do boilerplate — e por isso entram na allowlist derivada do `docs-commands` (SPEC-011).
|
|
117
|
-
- **Migrações**: nenhuma no framework.
|
|
118
|
-
|
|
119
|
-
## 7. Rollout
|
|
120
|
-
|
|
121
|
-
- [ ] Esqueleto + `shared/` (Result, erros de domínio, base VO) primeiro.
|
|
122
|
-
- [ ] Fatia rica Orders (domain → application → infra → presentation), com o teste-sem-Nest a cada camada.
|
|
123
|
-
- [ ] Caminho enxuto Products.
|
|
124
|
-
- [ ] Memória por contexto + `WHEN-CLEAN-WHEN-LEAN.md`.
|
|
125
|
-
- [ ] Manifesto + entrada no catálogo + `boilerplates/README.md`.
|
|
126
|
-
- [ ] **Medir (AC-6/métrica-norte)**: `context:smart` para "adicionar regra ao contexto orders" aqui
|
|
127
|
-
vs. no `02-saas-starter` flat. Registrar os números no ADR. Se não cair, recalibra antes de fechar.
|
|
128
|
-
- [ ] Gates: `release:check` (boilerplate no `files[]`, instala limpo), `tools:doctor` (coerência de doc).
|
|
129
|
-
|
|
130
|
-
## 8. Sinais de fracasso (kill criteria)
|
|
131
|
-
|
|
132
|
-
- **O caminho enxuto não existe de verdade** — se no fim tudo virou 4 camadas, a spec falhou (o
|
|
133
|
-
cargo-cult que ela existe para evitar). Products tem que ser genuinamente 1 camada.
|
|
134
|
-
- **O token não cai** (AC-6). Se o pacote de contexto não encolher vs. o flat, a arquitetura virou
|
|
135
|
-
custo. Reconhecer e recalibrar, não maquiar.
|
|
136
|
-
- **O domínio importa `@nestjs` ou ORM.** Qualquer import de framework no `domain/` quebra a premissa
|
|
137
|
-
inteira; o teste-sem-Nest é o detector.
|
|
1
|
+
# Plan: clean-arch-boilerplate
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-07-18
|
|
6
|
+
|
|
7
|
+
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
+
|
|
9
|
+
## 1. Abordagem técnica
|
|
10
|
+
|
|
11
|
+
Um boilerplate NestJS + TypeScript com a **regra de dependência para dentro** (Clean Architecture /
|
|
12
|
+
Hexagonal). A fatia rica é **Order** (invariante: não confirma sem estoque, não envia sem
|
|
13
|
+
pagamento) — vive no domínio, testável sem Nest. O contraponto enxuto é **Product** (CRUD),
|
|
14
|
+
demonstrando o caminho de 1 camada. O `WHEN-CLEAN-WHEN-LEAN.md` é o coração da spec: ensina o
|
|
15
|
+
critério, não a ceremônia.
|
|
16
|
+
|
|
17
|
+
O mecanismo de inversão no Nest: a **porta é uma `interface` no domínio + um token de injeção**; o
|
|
18
|
+
adapter (repo ORM) a implementa; o módulo faz o bind `{ provide: ORDER_REPO, useClass: TypeOrmOrderRepo }`.
|
|
19
|
+
O use-case injeta a porta, nunca o adapter. É o padrão documentado uma vez e repetido.
|
|
20
|
+
|
|
21
|
+
## 2. Estrutura de diretórios (o contrato visual)
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
boilerplates/06-clean-arch/
|
|
25
|
+
backend/src/
|
|
26
|
+
modules/orders/ # FATIA RICA — as 4 camadas
|
|
27
|
+
domain/
|
|
28
|
+
order.entity.ts # agregado: invariantes vivem aqui (pure TS, zero Nest/ORM)
|
|
29
|
+
order-status.vo.ts # value object (máquina de estados)
|
|
30
|
+
order.repository.ts # PORTA (interface) + token ORDER_REPOSITORY
|
|
31
|
+
application/
|
|
32
|
+
place-order.usecase.ts # input/output tipados; orquestra domínio + porta
|
|
33
|
+
ship-order.usecase.ts
|
|
34
|
+
dtos.ts # contratos de aplicação (não HTTP)
|
|
35
|
+
infrastructure/
|
|
36
|
+
typeorm-order.repository.ts # ADAPTER: implementa a porta
|
|
37
|
+
order.orm-entity.ts # entity do ORM (mapper domínio↔persistência)
|
|
38
|
+
presentation/
|
|
39
|
+
orders.controller.ts # HTTP DTOs + mapeia p/ use-case
|
|
40
|
+
orders.http.dto.ts
|
|
41
|
+
orders.module.ts # bind porta→adapter (inversão)
|
|
42
|
+
modules/products/ # CAMINHO ENXUTO — CRUD, 1 camada
|
|
43
|
+
products.controller.ts # controller → repo direto; sem use-case/porta
|
|
44
|
+
product.entity.ts
|
|
45
|
+
products.module.ts
|
|
46
|
+
shared/ # Result/Either, base VO, erros de domínio
|
|
47
|
+
main.ts · app.module.ts
|
|
48
|
+
backend/test/
|
|
49
|
+
orders/place-order.spec.ts # testa a INVARIANTE sem subir o Nest (AC-8)
|
|
50
|
+
memory/30-domains/orders/context.md # linguagem ubíqua — o agente lê ISTO antes do código
|
|
51
|
+
memory/30-domains/products/context.md
|
|
52
|
+
WHEN-CLEAN-WHEN-LEAN.md # o critério de calibração
|
|
53
|
+
boilerplate.manifest.json · README.md
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
O `orders/` e o `products/` lado a lado **são** a spec: um mostra Clean Architecture onde se paga, o
|
|
57
|
+
outro mostra o custo evitado. O dev/agente vê os dois e entende o critério pela estrutura.
|
|
58
|
+
|
|
59
|
+
## 3. Fluxo de dependência (a regra)
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
presentation ─┐
|
|
63
|
+
├─► application ─► domain ◄─ (ports: interfaces)
|
|
64
|
+
infrastructure┘ ▲
|
|
65
|
+
(adapters implementam ports) ─┘
|
|
66
|
+
dependências apontam p/ DENTRO. domain não importa nada de fora.
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## 4. Contratos (o que se lê sem a implementação)
|
|
70
|
+
|
|
71
|
+
```ts
|
|
72
|
+
// domain/order.repository.ts — a PORTA
|
|
73
|
+
export const ORDER_REPOSITORY = Symbol('OrderRepository');
|
|
74
|
+
export interface OrderRepository {
|
|
75
|
+
save(order: Order): Promise<void>;
|
|
76
|
+
byId(id: OrderId): Promise<Order | null>;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
// application/place-order.usecase.ts — o contrato legível (AC-5)
|
|
80
|
+
export interface PlaceOrderInput { customerId: string; items: OrderLine[]; }
|
|
81
|
+
export interface PlaceOrderOutput { orderId: string; total: Money; }
|
|
82
|
+
// a assinatura basta para o agente saber o que a feature faz — sem ler o corpo
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## 5. Decisões e alternativas
|
|
86
|
+
|
|
87
|
+
**D1: Order como fatia rica.** Invariante cross-aggregate universal e reconhecível ("não envia sem
|
|
88
|
+
pagamento"). Alternativa (Subscription/máquina de estados) é boa mas menos imediata; fica como VO
|
|
89
|
+
dentro de Order (`order-status.vo.ts`), aproveitando os dois.
|
|
90
|
+
|
|
91
|
+
**D2: Product como caminho enxuto — lado a lado, não escondido.** A calibração precisa ser *visível*.
|
|
92
|
+
Um CRUD que atravessa controller→repo direto, sem use-case nem porta, no mesmo boilerplate. É o AC-4
|
|
93
|
+
materializado em código, não só no doc.
|
|
94
|
+
|
|
95
|
+
**D3: Porta = interface no domínio + token Nest.** O domínio define o contrato; o Nest só faz o bind.
|
|
96
|
+
Alternativa rejeitada: repositório abstrato como classe base (acopla o domínio ao mecanismo de
|
|
97
|
+
herança e, na prática, ao Nest). Interface + token mantém o domínio puro.
|
|
98
|
+
|
|
99
|
+
**D4: Domínio puro, zero `@nestjs` e zero ORM.** É o que torna o teste-sem-Nest (AC-8) possível e é a
|
|
100
|
+
prova concreta do isolamento. O ORM vive só em `infrastructure/`, com mapper explícito
|
|
101
|
+
domínio↔orm-entity. Sem `@Entity` decorando o agregado de domínio.
|
|
102
|
+
|
|
103
|
+
**D5: Memória por contexto é o vetor de token (AC-6).** `context.md` descreve o domínio na linguagem
|
|
104
|
+
ubíqua. O agente lê ele + a assinatura do use-case; só desce ao código quando vai *editar*. É onde a
|
|
105
|
+
economia de token se materializa — e onde a mediremos.
|
|
106
|
+
|
|
107
|
+
**D6: Aditivo, sem tocar 01-05.** Novo diretório, novo manifesto. Os geradores existentes não mudam;
|
|
108
|
+
só o catálogo de boilerplates ganha uma entrada.
|
|
109
|
+
|
|
110
|
+
D1–D5 são estruturais → **ADR-0027** (Clean Architecture calibrada; o porquê da calibração e do token).
|
|
111
|
+
|
|
112
|
+
## 6. Dependências
|
|
113
|
+
|
|
114
|
+
- **Specs**: SPEC-012 (TS) — o domínio é tipado; alinhado, não bloqueante.
|
|
115
|
+
- **Pacotes** (do projeto *gerado*, não do Forja): `@nestjs/*`, `typeorm`, `jest`. Ficam no
|
|
116
|
+
`package.json` do boilerplate — e por isso entram na allowlist derivada do `docs-commands` (SPEC-011).
|
|
117
|
+
- **Migrações**: nenhuma no framework.
|
|
118
|
+
|
|
119
|
+
## 7. Rollout
|
|
120
|
+
|
|
121
|
+
- [ ] Esqueleto + `shared/` (Result, erros de domínio, base VO) primeiro.
|
|
122
|
+
- [ ] Fatia rica Orders (domain → application → infra → presentation), com o teste-sem-Nest a cada camada.
|
|
123
|
+
- [ ] Caminho enxuto Products.
|
|
124
|
+
- [ ] Memória por contexto + `WHEN-CLEAN-WHEN-LEAN.md`.
|
|
125
|
+
- [ ] Manifesto + entrada no catálogo + `boilerplates/README.md`.
|
|
126
|
+
- [ ] **Medir (AC-6/métrica-norte)**: `context:smart` para "adicionar regra ao contexto orders" aqui
|
|
127
|
+
vs. no `02-saas-starter` flat. Registrar os números no ADR. Se não cair, recalibra antes de fechar.
|
|
128
|
+
- [ ] Gates: `release:check` (boilerplate no `files[]`, instala limpo), `tools:doctor` (coerência de doc).
|
|
129
|
+
|
|
130
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
131
|
+
|
|
132
|
+
- **O caminho enxuto não existe de verdade** — se no fim tudo virou 4 camadas, a spec falhou (o
|
|
133
|
+
cargo-cult que ela existe para evitar). Products tem que ser genuinamente 1 camada.
|
|
134
|
+
- **O token não cai** (AC-6). Se o pacote de contexto não encolher vs. o flat, a arquitetura virou
|
|
135
|
+
custo. Reconhecer e recalibrar, não maquiar.
|
|
136
|
+
- **O domínio importa `@nestjs` ou ORM.** Qualquer import de framework no `domain/` quebra a premissa
|
|
137
|
+
inteira; o teste-sem-Nest é o detector.
|