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
|
@@ -1,121 +1,121 @@
|
|
|
1
|
-
# Spec: clean-arch-boilerplate
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-013
|
|
4
|
-
- **Status**: approved
|
|
5
|
-
- **Owner**: apk
|
|
6
|
-
- **Criado em**: 2026-07-18
|
|
7
|
-
- **Sprint alvo**: S?
|
|
8
|
-
- **ADRs relacionadas**: [ADR-0009](../../memory/90-decisions/0009-claude-hooks-token-economy.md) (economia de tokens), [ADR-0016](../../memory/90-decisions/0016-integracao-capacidades-externas.md) (harness), [ADR-0001](../../memory/90-decisions/0001-memoria-hierarquica.md) (memória hierárquica)
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
|
|
12
|
-
Os boilerplates atuais são **NestJS-flat**: `modules/<x>/{controller, service, entities, dto}`, com o
|
|
13
|
-
service falando direto com a entity do TypeORM. A infraestrutura (ORM) vaza para dentro da regra de
|
|
14
|
-
negócio, não há inversão de dependência, e a regra de domínio — quando existe — fica presa dentro de
|
|
15
|
-
um `service` acoplado ao framework. Isso cobra dois preços:
|
|
16
|
-
|
|
17
|
-
1. **De manutenção**: trocar ORM, testar regra sem subir o Nest, ou mover uma invariante para onde
|
|
18
|
-
ela pertence exige cirurgia.
|
|
19
|
-
2. **De tokens** — o que mais importa aqui (ADR-0009). Um agente que opera um projeto flat precisa
|
|
20
|
-
**ler a implementação inteira** para entender o que uma feature faz, porque a regra está diluída
|
|
21
|
-
no service junto do acesso a dados e do HTTP. Não há contrato legível separado da execução.
|
|
22
|
-
|
|
23
|
-
Ao mesmo tempo, a resposta ingênua — "aplicar Clean Architecture" — tem um preço oposto e igualmente
|
|
24
|
-
real: **quatro camadas para um CRUD são mais arquivos para ler, não menos.** Um boilerplate que força
|
|
25
|
-
use-case + porta + adapter + mapper por endpoint trivial é o anti-padrão de token que estamos tentando
|
|
26
|
-
evitar, com nome bonito.
|
|
27
|
-
|
|
28
|
-
## 2. Proposta de valor
|
|
29
|
-
|
|
30
|
-
Um boilerplate Clean Architecture que **sabe quando NÃO ser Clean Architecture.** Camadas ricas onde
|
|
31
|
-
há regra de negócio de verdade; caminho enxuto explícito onde é CRUD. Estruturado para **navegação
|
|
32
|
-
barata por agente**: o contrato de um use-case se lê pela assinatura de tipo, não pela implementação;
|
|
33
|
-
cada bounded context tem um doc de memória na linguagem ubíqua que o agente lê **em vez** do código.
|
|
34
|
-
Arquitetura como compressão de contexto, não como cerimônia.
|
|
35
|
-
|
|
36
|
-
## 3. User stories
|
|
37
|
-
|
|
38
|
-
- **Como** dev iniciando um produto, **quero** um esqueleto com domínio isolado de framework e ORM,
|
|
39
|
-
**para que** a regra de negócio seja testável e sobreviva a troca de infraestrutura.
|
|
40
|
-
- **Como** agente operando o projeto gerado, **quero** ler o contrato tipado de um use-case e o doc
|
|
41
|
-
de contexto do módulo, **para que** eu entenda a feature sem carregar a implementação inteira —
|
|
42
|
-
menos tokens por tarefa.
|
|
43
|
-
- **Como** dev com uma feature CRUD trivial, **quero** um caminho enxuto documentado, **para que** eu
|
|
44
|
-
não pague 4 camadas por um `GET /x`.
|
|
45
|
-
- **Como** arquiteto, **quero** uma fatia vertical rica de referência (com invariante de negócio de
|
|
46
|
-
verdade), **para que** o padrão Clean Architecture seja demonstrado onde ele se paga, não abstrato.
|
|
47
|
-
|
|
48
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
49
|
-
|
|
50
|
-
- [ ] AC-1: Novo boilerplate `boilerplates/06-clean-arch/` com as 4 camadas e a **regra de
|
|
51
|
-
dependência** para dentro: `domain` (puro: entities, value objects, ports/interfaces — zero
|
|
52
|
-
NestJS, zero ORM) → `application` (use-cases orquestrando domínio + portas) → `infrastructure`
|
|
53
|
-
(adapters: repos ORM, mappers, serviços externos) + `presentation` (controllers, DTOs HTTP).
|
|
54
|
-
- [ ] AC-2: **Inversão de dependência real** via DI do NestJS: as portas são tokens de injeção
|
|
55
|
-
(`interface` no domínio), os adapters as implementam e são bound no módulo. O use-case depende
|
|
56
|
-
da porta, nunca da implementação.
|
|
57
|
-
- [ ] AC-3: **Fatia vertical rica de referência** — um bounded context com invariante de negócio
|
|
58
|
-
genuína (não CRUD) que vive **no domínio** (ex.: um `Order` que não pode ser enviado sem
|
|
59
|
-
pagamento; ou `Subscription` como máquina de estados). Prova que a separação se paga.
|
|
60
|
-
- [ ] AC-4: **Caminho enxuto explícito** (a calibração). Um módulo CRUD simples demonstrado com o
|
|
61
|
-
mínimo de camadas, e um doc `WHEN-CLEAN-WHEN-LEAN.md` que ensina o critério de escolha. O
|
|
62
|
-
boilerplate não força ceremônia.
|
|
63
|
-
- [ ] AC-5: **Contratos legíveis** — todo use-case tem input/output tipados (TS) que se leem sem a
|
|
64
|
-
implementação. O domínio é a linguagem ubíqua tipada.
|
|
65
|
-
- [ ] AC-6: **Memória por bounded context** (ADR-0001): cada contexto tem um doc em
|
|
66
|
-
`memory/30-domains/<ctx>/context.md` na linguagem ubíqua, que o agente lê **antes** do código.
|
|
67
|
-
Medir: o pacote de contexto de uma tarefa cai vs. o boilerplate flat (ADR-0009).
|
|
68
|
-
- [ ] AC-7: Manifesto (`boilerplate.manifest.json`) + integração com o gerador (o boilerplate aparece
|
|
69
|
-
como opção, gera com a memória e os agentes multi-IA como os outros).
|
|
70
|
-
- [ ] AC-8: **Testes de domínio sem framework**: a invariante da AC-3 tem teste unitário que roda
|
|
71
|
-
**sem subir o Nest** — a prova concreta de que o domínio está isolado.
|
|
72
|
-
- [ ] AC-9: O boilerplate passa pelos gates do próprio Forja: `release:check` (está no `files[]`,
|
|
73
|
-
instala limpo) e a coerência de doc (SPEC-011) não acusa comando fantasma nos seus docs.
|
|
74
|
-
- [ ] AC-10: ADR registrando a decisão (Clean Architecture calibrada como boilerplate; o *porquê* da
|
|
75
|
-
calibração e do ângulo de token).
|
|
76
|
-
|
|
77
|
-
## 5. Escopo
|
|
78
|
-
|
|
79
|
-
**Dentro**:
|
|
80
|
-
- `boilerplates/06-clean-arch/` completo: as 4 camadas, a fatia rica, o módulo enxuto, o
|
|
81
|
-
`WHEN-CLEAN-WHEN-LEAN.md`, a memória por contexto, o manifesto.
|
|
82
|
-
- Integração com o gerador (`lib/generators/`) para o boilerplate ser selecionável.
|
|
83
|
-
- ADR + a atualização de `boilerplates/README.md`.
|
|
84
|
-
|
|
85
|
-
**Fora** (explícito):
|
|
86
|
-
- **Refatorar os boilerplates existentes** (01-05). Eles ficam; este é aditivo. Migrar os antigos é
|
|
87
|
-
outra decisão.
|
|
88
|
-
- **Aplicar Clean Architecture ao framework Forja.** Decidido: over-engineering para um CLI; o
|
|
89
|
-
framework ganha só modelos de domínio tipados, e isso ride na migração TS (SPEC-012), não aqui.
|
|
90
|
-
- **Frontend.** Este boilerplate é backend (NestJS). Um par frontend é outra spec.
|
|
91
|
-
- **Prescrever ORM único.** O ponto é o domínio não saber do ORM; qual ORM o adapter usa é detalhe do
|
|
92
|
-
boilerplate, não da arquitetura.
|
|
93
|
-
|
|
94
|
-
## 6. NFRs / restrições
|
|
95
|
-
|
|
96
|
-
- **Token-first (a régua)**: o ganho tem que ser *medível*. AC-6 exige comparar o pacote de contexto
|
|
97
|
-
de uma tarefa-tipo neste boilerplate vs. no flat. Se não cair, a arquitetura virou custo, não
|
|
98
|
-
economia — e aí recalibra.
|
|
99
|
-
- **Calibração inegociável**: a existência do caminho enxuto (AC-4) é o que separa esta spec de um
|
|
100
|
-
cargo-cult. Sem ele, reprovado.
|
|
101
|
-
- **TypeScript**: alinhado com a migração em curso (SPEC-012) — o domínio é tipado de primeira classe.
|
|
102
|
-
- **Compatibilidade**: aditivo; não muda os geradores dos boilerplates existentes.
|
|
103
|
-
|
|
104
|
-
## 7. Riscos e mitigação
|
|
105
|
-
|
|
106
|
-
| Risco | Prob | Impacto | Mitigação |
|
|
107
|
-
|---|---|---|---|
|
|
108
|
-
| Vira cargo-cult: 4 camadas por CRUD, +tokens | **A** | A | AC-4 (caminho enxuto) + AC-6 (medir tokens) são gate; sem eles, reprova |
|
|
109
|
-
| Complexidade assusta o dev/agente | M | M | A fatia rica é 1 só; o resto é enxuto. `WHEN-CLEAN-WHEN-LEAN.md` guia |
|
|
110
|
-
| Inversão de dependência no Nest fica verbosa | M | M | Padrão de porta-como-token documentado uma vez; repetível |
|
|
111
|
-
| O ganho de token não se materializa | M | A | Medir cedo (AC-6). Se não cair, a spec falhou seu propósito — honesto reconhecer |
|
|
112
|
-
|
|
113
|
-
## 8. Métricas de sucesso
|
|
114
|
-
|
|
115
|
-
- **Tokens por tarefa** num projeto gerado com este boilerplate **caem** vs. o flat, para uma
|
|
116
|
-
tarefa-tipo ("adicionar uma regra ao contexto X") — medido via `context:smart`/`token:benchmark`.
|
|
117
|
-
É a métrica-norte; sem ela a arquitetura não se justifica.
|
|
118
|
-
- Um dev pega a fatia rica e adiciona uma invariante de negócio **sem tocar em infraestrutura**.
|
|
119
|
-
- A invariante de domínio é testável **sem subir o Nest** (AC-8).
|
|
120
|
-
- 90 dias depois: os projetos novos do usuário escolhem este boilerplate quando há regra de negócio,
|
|
121
|
-
e o flat quando é CRUD puro — a calibração usada na prática, não só documentada.
|
|
1
|
+
# Spec: clean-arch-boilerplate
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-013
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-07-18
|
|
7
|
+
- **Sprint alvo**: S?
|
|
8
|
+
- **ADRs relacionadas**: [ADR-0009](../../memory/90-decisions/0009-claude-hooks-token-economy.md) (economia de tokens), [ADR-0016](../../memory/90-decisions/0016-integracao-capacidades-externas.md) (harness), [ADR-0001](../../memory/90-decisions/0001-memoria-hierarquica.md) (memória hierárquica)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
|
|
12
|
+
Os boilerplates atuais são **NestJS-flat**: `modules/<x>/{controller, service, entities, dto}`, com o
|
|
13
|
+
service falando direto com a entity do TypeORM. A infraestrutura (ORM) vaza para dentro da regra de
|
|
14
|
+
negócio, não há inversão de dependência, e a regra de domínio — quando existe — fica presa dentro de
|
|
15
|
+
um `service` acoplado ao framework. Isso cobra dois preços:
|
|
16
|
+
|
|
17
|
+
1. **De manutenção**: trocar ORM, testar regra sem subir o Nest, ou mover uma invariante para onde
|
|
18
|
+
ela pertence exige cirurgia.
|
|
19
|
+
2. **De tokens** — o que mais importa aqui (ADR-0009). Um agente que opera um projeto flat precisa
|
|
20
|
+
**ler a implementação inteira** para entender o que uma feature faz, porque a regra está diluída
|
|
21
|
+
no service junto do acesso a dados e do HTTP. Não há contrato legível separado da execução.
|
|
22
|
+
|
|
23
|
+
Ao mesmo tempo, a resposta ingênua — "aplicar Clean Architecture" — tem um preço oposto e igualmente
|
|
24
|
+
real: **quatro camadas para um CRUD são mais arquivos para ler, não menos.** Um boilerplate que força
|
|
25
|
+
use-case + porta + adapter + mapper por endpoint trivial é o anti-padrão de token que estamos tentando
|
|
26
|
+
evitar, com nome bonito.
|
|
27
|
+
|
|
28
|
+
## 2. Proposta de valor
|
|
29
|
+
|
|
30
|
+
Um boilerplate Clean Architecture que **sabe quando NÃO ser Clean Architecture.** Camadas ricas onde
|
|
31
|
+
há regra de negócio de verdade; caminho enxuto explícito onde é CRUD. Estruturado para **navegação
|
|
32
|
+
barata por agente**: o contrato de um use-case se lê pela assinatura de tipo, não pela implementação;
|
|
33
|
+
cada bounded context tem um doc de memória na linguagem ubíqua que o agente lê **em vez** do código.
|
|
34
|
+
Arquitetura como compressão de contexto, não como cerimônia.
|
|
35
|
+
|
|
36
|
+
## 3. User stories
|
|
37
|
+
|
|
38
|
+
- **Como** dev iniciando um produto, **quero** um esqueleto com domínio isolado de framework e ORM,
|
|
39
|
+
**para que** a regra de negócio seja testável e sobreviva a troca de infraestrutura.
|
|
40
|
+
- **Como** agente operando o projeto gerado, **quero** ler o contrato tipado de um use-case e o doc
|
|
41
|
+
de contexto do módulo, **para que** eu entenda a feature sem carregar a implementação inteira —
|
|
42
|
+
menos tokens por tarefa.
|
|
43
|
+
- **Como** dev com uma feature CRUD trivial, **quero** um caminho enxuto documentado, **para que** eu
|
|
44
|
+
não pague 4 camadas por um `GET /x`.
|
|
45
|
+
- **Como** arquiteto, **quero** uma fatia vertical rica de referência (com invariante de negócio de
|
|
46
|
+
verdade), **para que** o padrão Clean Architecture seja demonstrado onde ele se paga, não abstrato.
|
|
47
|
+
|
|
48
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
49
|
+
|
|
50
|
+
- [ ] AC-1: Novo boilerplate `boilerplates/06-clean-arch/` com as 4 camadas e a **regra de
|
|
51
|
+
dependência** para dentro: `domain` (puro: entities, value objects, ports/interfaces — zero
|
|
52
|
+
NestJS, zero ORM) → `application` (use-cases orquestrando domínio + portas) → `infrastructure`
|
|
53
|
+
(adapters: repos ORM, mappers, serviços externos) + `presentation` (controllers, DTOs HTTP).
|
|
54
|
+
- [ ] AC-2: **Inversão de dependência real** via DI do NestJS: as portas são tokens de injeção
|
|
55
|
+
(`interface` no domínio), os adapters as implementam e são bound no módulo. O use-case depende
|
|
56
|
+
da porta, nunca da implementação.
|
|
57
|
+
- [ ] AC-3: **Fatia vertical rica de referência** — um bounded context com invariante de negócio
|
|
58
|
+
genuína (não CRUD) que vive **no domínio** (ex.: um `Order` que não pode ser enviado sem
|
|
59
|
+
pagamento; ou `Subscription` como máquina de estados). Prova que a separação se paga.
|
|
60
|
+
- [ ] AC-4: **Caminho enxuto explícito** (a calibração). Um módulo CRUD simples demonstrado com o
|
|
61
|
+
mínimo de camadas, e um doc `WHEN-CLEAN-WHEN-LEAN.md` que ensina o critério de escolha. O
|
|
62
|
+
boilerplate não força ceremônia.
|
|
63
|
+
- [ ] AC-5: **Contratos legíveis** — todo use-case tem input/output tipados (TS) que se leem sem a
|
|
64
|
+
implementação. O domínio é a linguagem ubíqua tipada.
|
|
65
|
+
- [ ] AC-6: **Memória por bounded context** (ADR-0001): cada contexto tem um doc em
|
|
66
|
+
`memory/30-domains/<ctx>/context.md` na linguagem ubíqua, que o agente lê **antes** do código.
|
|
67
|
+
Medir: o pacote de contexto de uma tarefa cai vs. o boilerplate flat (ADR-0009).
|
|
68
|
+
- [ ] AC-7: Manifesto (`boilerplate.manifest.json`) + integração com o gerador (o boilerplate aparece
|
|
69
|
+
como opção, gera com a memória e os agentes multi-IA como os outros).
|
|
70
|
+
- [ ] AC-8: **Testes de domínio sem framework**: a invariante da AC-3 tem teste unitário que roda
|
|
71
|
+
**sem subir o Nest** — a prova concreta de que o domínio está isolado.
|
|
72
|
+
- [ ] AC-9: O boilerplate passa pelos gates do próprio Forja: `release:check` (está no `files[]`,
|
|
73
|
+
instala limpo) e a coerência de doc (SPEC-011) não acusa comando fantasma nos seus docs.
|
|
74
|
+
- [ ] AC-10: ADR registrando a decisão (Clean Architecture calibrada como boilerplate; o *porquê* da
|
|
75
|
+
calibração e do ângulo de token).
|
|
76
|
+
|
|
77
|
+
## 5. Escopo
|
|
78
|
+
|
|
79
|
+
**Dentro**:
|
|
80
|
+
- `boilerplates/06-clean-arch/` completo: as 4 camadas, a fatia rica, o módulo enxuto, o
|
|
81
|
+
`WHEN-CLEAN-WHEN-LEAN.md`, a memória por contexto, o manifesto.
|
|
82
|
+
- Integração com o gerador (`lib/generators/`) para o boilerplate ser selecionável.
|
|
83
|
+
- ADR + a atualização de `boilerplates/README.md`.
|
|
84
|
+
|
|
85
|
+
**Fora** (explícito):
|
|
86
|
+
- **Refatorar os boilerplates existentes** (01-05). Eles ficam; este é aditivo. Migrar os antigos é
|
|
87
|
+
outra decisão.
|
|
88
|
+
- **Aplicar Clean Architecture ao framework Forja.** Decidido: over-engineering para um CLI; o
|
|
89
|
+
framework ganha só modelos de domínio tipados, e isso ride na migração TS (SPEC-012), não aqui.
|
|
90
|
+
- **Frontend.** Este boilerplate é backend (NestJS). Um par frontend é outra spec.
|
|
91
|
+
- **Prescrever ORM único.** O ponto é o domínio não saber do ORM; qual ORM o adapter usa é detalhe do
|
|
92
|
+
boilerplate, não da arquitetura.
|
|
93
|
+
|
|
94
|
+
## 6. NFRs / restrições
|
|
95
|
+
|
|
96
|
+
- **Token-first (a régua)**: o ganho tem que ser *medível*. AC-6 exige comparar o pacote de contexto
|
|
97
|
+
de uma tarefa-tipo neste boilerplate vs. no flat. Se não cair, a arquitetura virou custo, não
|
|
98
|
+
economia — e aí recalibra.
|
|
99
|
+
- **Calibração inegociável**: a existência do caminho enxuto (AC-4) é o que separa esta spec de um
|
|
100
|
+
cargo-cult. Sem ele, reprovado.
|
|
101
|
+
- **TypeScript**: alinhado com a migração em curso (SPEC-012) — o domínio é tipado de primeira classe.
|
|
102
|
+
- **Compatibilidade**: aditivo; não muda os geradores dos boilerplates existentes.
|
|
103
|
+
|
|
104
|
+
## 7. Riscos e mitigação
|
|
105
|
+
|
|
106
|
+
| Risco | Prob | Impacto | Mitigação |
|
|
107
|
+
|---|---|---|---|
|
|
108
|
+
| Vira cargo-cult: 4 camadas por CRUD, +tokens | **A** | A | AC-4 (caminho enxuto) + AC-6 (medir tokens) são gate; sem eles, reprova |
|
|
109
|
+
| Complexidade assusta o dev/agente | M | M | A fatia rica é 1 só; o resto é enxuto. `WHEN-CLEAN-WHEN-LEAN.md` guia |
|
|
110
|
+
| Inversão de dependência no Nest fica verbosa | M | M | Padrão de porta-como-token documentado uma vez; repetível |
|
|
111
|
+
| O ganho de token não se materializa | M | A | Medir cedo (AC-6). Se não cair, a spec falhou seu propósito — honesto reconhecer |
|
|
112
|
+
|
|
113
|
+
## 8. Métricas de sucesso
|
|
114
|
+
|
|
115
|
+
- **Tokens por tarefa** num projeto gerado com este boilerplate **caem** vs. o flat, para uma
|
|
116
|
+
tarefa-tipo ("adicionar uma regra ao contexto X") — medido via `context:smart`/`token:benchmark`.
|
|
117
|
+
É a métrica-norte; sem ela a arquitetura não se justifica.
|
|
118
|
+
- Um dev pega a fatia rica e adiciona uma invariante de negócio **sem tocar em infraestrutura**.
|
|
119
|
+
- A invariante de domínio é testável **sem subir o Nest** (AC-8).
|
|
120
|
+
- 90 dias depois: os projetos novos do usuário escolhem este boilerplate quando há regra de negócio,
|
|
121
|
+
e o flat quando é CRUD puro — a calibração usada na prática, não só documentada.
|
|
@@ -1,70 +1,70 @@
|
|
|
1
|
-
# Tasks: clean-arch-boilerplate
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: approved
|
|
6
|
-
- **Criado em**: 2026-07-18
|
|
7
|
-
|
|
8
|
-
> Decomposição executável. O boilerplate é **conteúdo de template** (código do projeto gerado), não
|
|
9
|
-
> código do framework — não roda na CI do Forja. Escrever para ser referência idiomática correta.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## T1 — Esqueleto + `shared/`
|
|
14
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: —
|
|
15
|
-
- **Paths**: `boilerplates/06-clean-arch/backend/src/{shared,main.ts,app.module.ts}`
|
|
16
|
-
- **Done**: `Result`/erros de domínio/base VO; `main.ts`/`app.module.ts`; `package.json` + `tsconfig`
|
|
17
|
-
do projeto (com `test:e2e`, `start:dev` etc. — entram na allowlist derivada do SPEC-011).
|
|
18
|
-
|
|
19
|
-
## T2 — Fatia rica: Orders (as 4 camadas) — AC-1/2/3/5
|
|
20
|
-
- **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
|
|
21
|
-
- **Paths**: `.../modules/orders/{domain,application,infrastructure,presentation}/*`, `orders.module.ts`
|
|
22
|
-
- **Done**:
|
|
23
|
-
- [ ] `domain/`: `Order` (agregado, invariantes: não confirma sem estoque, não envia sem pagamento),
|
|
24
|
-
`order-status.vo.ts`, `order.repository.ts` (porta = interface + token). **Zero `@nestjs`/ORM.**
|
|
25
|
-
- [ ] `application/`: `place-order`/`ship-order` use-cases com input/output tipados (contrato legível).
|
|
26
|
-
- [ ] `infrastructure/`: adapter TypeORM implementa a porta + mapper domínio↔orm-entity.
|
|
27
|
-
- [ ] `presentation/`: controller + HTTP DTOs mapeando p/ use-case.
|
|
28
|
-
- [ ] `orders.module.ts`: bind `{ provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository }`.
|
|
29
|
-
|
|
30
|
-
## T3 — Teste da invariante sem Nest — AC-8
|
|
31
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T2
|
|
32
|
-
- **Paths**: `.../backend/test/orders/place-order.spec.ts`
|
|
33
|
-
- **Done**: testa a invariante de domínio **instanciando só o agregado** (sem `Test.createTestingModule`,
|
|
34
|
-
sem ORM). É a prova concreta do isolamento — se precisar do Nest, o domínio vazou.
|
|
35
|
-
|
|
36
|
-
## T4 — Caminho enxuto: Products (1 camada) — AC-4
|
|
37
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
|
|
38
|
-
- **Paths**: `.../modules/products/*`, `WHEN-CLEAN-WHEN-LEAN.md`
|
|
39
|
-
- **Done**: CRUD controller→repo direto, **sem** use-case/porta; o doc ensina o critério de escolha.
|
|
40
|
-
Kill criteria: se Products virar 4 camadas, a spec falhou.
|
|
41
|
-
|
|
42
|
-
## T5 — Memória por contexto (o vetor de token) — AC-6
|
|
43
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T2, T4
|
|
44
|
-
- **Paths**: `.../memory/30-domains/{orders,products}/context.md`
|
|
45
|
-
- **Done**: cada contexto descrito na linguagem ubíqua — o que o agente lê **antes** do código.
|
|
46
|
-
Orders documenta as invariantes e os use-cases; Products, o CRUD raso.
|
|
47
|
-
|
|
48
|
-
## T6 — Manifesto + catálogo + README — AC-7
|
|
49
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1-T5
|
|
50
|
-
- **Paths**: `.../boilerplate.manifest.json`, `.../README.md`, `boilerplates/README.md`
|
|
51
|
-
- **Done**: manifesto no schema 1.0 (stack/useCases/commands); entrada no catálogo; README explicando
|
|
52
|
-
a estrutura e apontando o `WHEN-CLEAN-WHEN-LEAN.md`.
|
|
53
|
-
|
|
54
|
-
## T7 — Medir o token (métrica-norte) + ADR-0027 — AC-6/AC-10
|
|
55
|
-
- **Owner**: SDD Architect + Governance · **Estimativa**: P · **Depende de**: T5, T6
|
|
56
|
-
- **Paths**: `memory/90-decisions/0027-*.md`
|
|
57
|
-
- **Done**:
|
|
58
|
-
- [ ] Medir o pacote de contexto de "adicionar uma regra ao contexto orders" aqui vs. no
|
|
59
|
-
`02-saas-starter` flat. **Registrar os números.**
|
|
60
|
-
- [ ] ADR-0027: Clean Architecture calibrada; o porquê da calibração e o resultado da medição.
|
|
61
|
-
Se o token não caiu, o ADR diz isso e recalibra — não maquia.
|
|
62
|
-
|
|
63
|
-
## T8 — Gates (Governance) — AC-9
|
|
64
|
-
- **Owner**: Governance · **Estimativa**: P · **Depende de**: T6
|
|
65
|
-
- **Done**: `release:check` (boilerplate no `files[]`, instala limpo), `tools:doctor` (docs-commands
|
|
66
|
-
não acusa fantasma), `npm test` do Forja verde. spec → `done`.
|
|
67
|
-
|
|
68
|
-
---
|
|
69
|
-
## Handoffs
|
|
70
|
-
Worker (T1-T6), SDD Architect + Governance (T7-T8). `forja agent:route` a cada fronteira (ADR-0005).
|
|
1
|
+
# Tasks: clean-arch-boilerplate
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-07-18
|
|
7
|
+
|
|
8
|
+
> Decomposição executável. O boilerplate é **conteúdo de template** (código do projeto gerado), não
|
|
9
|
+
> código do framework — não roda na CI do Forja. Escrever para ser referência idiomática correta.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## T1 — Esqueleto + `shared/`
|
|
14
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: —
|
|
15
|
+
- **Paths**: `boilerplates/06-clean-arch/backend/src/{shared,main.ts,app.module.ts}`
|
|
16
|
+
- **Done**: `Result`/erros de domínio/base VO; `main.ts`/`app.module.ts`; `package.json` + `tsconfig`
|
|
17
|
+
do projeto (com `test:e2e`, `start:dev` etc. — entram na allowlist derivada do SPEC-011).
|
|
18
|
+
|
|
19
|
+
## T2 — Fatia rica: Orders (as 4 camadas) — AC-1/2/3/5
|
|
20
|
+
- **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
|
|
21
|
+
- **Paths**: `.../modules/orders/{domain,application,infrastructure,presentation}/*`, `orders.module.ts`
|
|
22
|
+
- **Done**:
|
|
23
|
+
- [ ] `domain/`: `Order` (agregado, invariantes: não confirma sem estoque, não envia sem pagamento),
|
|
24
|
+
`order-status.vo.ts`, `order.repository.ts` (porta = interface + token). **Zero `@nestjs`/ORM.**
|
|
25
|
+
- [ ] `application/`: `place-order`/`ship-order` use-cases com input/output tipados (contrato legível).
|
|
26
|
+
- [ ] `infrastructure/`: adapter TypeORM implementa a porta + mapper domínio↔orm-entity.
|
|
27
|
+
- [ ] `presentation/`: controller + HTTP DTOs mapeando p/ use-case.
|
|
28
|
+
- [ ] `orders.module.ts`: bind `{ provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository }`.
|
|
29
|
+
|
|
30
|
+
## T3 — Teste da invariante sem Nest — AC-8
|
|
31
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T2
|
|
32
|
+
- **Paths**: `.../backend/test/orders/place-order.spec.ts`
|
|
33
|
+
- **Done**: testa a invariante de domínio **instanciando só o agregado** (sem `Test.createTestingModule`,
|
|
34
|
+
sem ORM). É a prova concreta do isolamento — se precisar do Nest, o domínio vazou.
|
|
35
|
+
|
|
36
|
+
## T4 — Caminho enxuto: Products (1 camada) — AC-4
|
|
37
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
|
|
38
|
+
- **Paths**: `.../modules/products/*`, `WHEN-CLEAN-WHEN-LEAN.md`
|
|
39
|
+
- **Done**: CRUD controller→repo direto, **sem** use-case/porta; o doc ensina o critério de escolha.
|
|
40
|
+
Kill criteria: se Products virar 4 camadas, a spec falhou.
|
|
41
|
+
|
|
42
|
+
## T5 — Memória por contexto (o vetor de token) — AC-6
|
|
43
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T2, T4
|
|
44
|
+
- **Paths**: `.../memory/30-domains/{orders,products}/context.md`
|
|
45
|
+
- **Done**: cada contexto descrito na linguagem ubíqua — o que o agente lê **antes** do código.
|
|
46
|
+
Orders documenta as invariantes e os use-cases; Products, o CRUD raso.
|
|
47
|
+
|
|
48
|
+
## T6 — Manifesto + catálogo + README — AC-7
|
|
49
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1-T5
|
|
50
|
+
- **Paths**: `.../boilerplate.manifest.json`, `.../README.md`, `boilerplates/README.md`
|
|
51
|
+
- **Done**: manifesto no schema 1.0 (stack/useCases/commands); entrada no catálogo; README explicando
|
|
52
|
+
a estrutura e apontando o `WHEN-CLEAN-WHEN-LEAN.md`.
|
|
53
|
+
|
|
54
|
+
## T7 — Medir o token (métrica-norte) + ADR-0027 — AC-6/AC-10
|
|
55
|
+
- **Owner**: SDD Architect + Governance · **Estimativa**: P · **Depende de**: T5, T6
|
|
56
|
+
- **Paths**: `memory/90-decisions/0027-*.md`
|
|
57
|
+
- **Done**:
|
|
58
|
+
- [ ] Medir o pacote de contexto de "adicionar uma regra ao contexto orders" aqui vs. no
|
|
59
|
+
`02-saas-starter` flat. **Registrar os números.**
|
|
60
|
+
- [ ] ADR-0027: Clean Architecture calibrada; o porquê da calibração e o resultado da medição.
|
|
61
|
+
Se o token não caiu, o ADR diz isso e recalibra — não maquia.
|
|
62
|
+
|
|
63
|
+
## T8 — Gates (Governance) — AC-9
|
|
64
|
+
- **Owner**: Governance · **Estimativa**: P · **Depende de**: T6
|
|
65
|
+
- **Done**: `release:check` (boilerplate no `files[]`, instala limpo), `tools:doctor` (docs-commands
|
|
66
|
+
não acusa fantasma), `npm test` do Forja verde. spec → `done`.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
## Handoffs
|
|
70
|
+
Worker (T1-T6), SDD Architect + Governance (T7-T8). `forja agent:route` a cada fronteira (ADR-0005).
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# Plan: cli-first-operacao
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Status**: approved
|
|
5
|
-
- **Criado em**: 2026-06-02
|
|
6
|
-
|
|
7
|
-
## 1. Abordagem tecnica
|
|
8
|
-
Manter o dashboard existente como opcional e mover a operacao principal para comandos. Corrigir o gerenciador de sprint para funcionar no repositorio raiz, aceitar backlog RICE e expor encerramento de sprint no `package.json`. Ajustar GSD para nao exigir design em fluxo sem UI.
|
|
9
|
-
|
|
10
|
-
## 2. Modulos afetados
|
|
11
|
-
| Caminho | Mudanca | Risco |
|
|
12
|
-
|---|---|---|
|
|
13
|
-
| `scripts/sprint-manager.js` | default para raiz e suporte a tabela RICE | M |
|
|
14
|
-
| `scripts/agent-harness.mjs` | `gsd:check` aceita CLI-only sem brief visual | B |
|
|
15
|
-
| `scripts/dev.mjs` | saida textual mais limpa | B |
|
|
16
|
-
| `scripts/check-standards.js` | `project:check` valida root sem argumento | B |
|
|
17
|
-
| `package.json` | novos aliases de operacao | B |
|
|
18
|
-
| `README.md`, `AGENTS.md`, `docs/*` | documentar CLI-first | B |
|
|
19
|
-
|
|
20
|
-
## 3. Fluxo
|
|
21
|
-
```
|
|
22
|
-
sprint:start/status
|
|
23
|
-
-> context:build
|
|
24
|
-
-> gsd:plan
|
|
25
|
-
-> gsd:handoff spec/plan/implement/review
|
|
26
|
-
-> gsd:check
|
|
27
|
-
-> project:check
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
## 4. Contratos
|
|
31
|
-
- `npm run sprint:start [projeto]`
|
|
32
|
-
- `npm run sprint:status [projeto]`
|
|
33
|
-
- `npm run sprint:complete [projeto]`
|
|
34
|
-
- `npm run gsd:check -- <slug> [brief.md]`
|
|
35
|
-
|
|
36
|
-
Sem `brief.md`, o check considera design como nao aplicavel.
|
|
37
|
-
|
|
38
|
-
## 5. Decisoes
|
|
39
|
-
**D1**: Nao remover o dashboard agora. Ele fica legado/opcional para evitar quebra de scripts e preservar historico.
|
|
40
|
-
|
|
41
|
-
**D2**: Backlog RICE nao e modificado ao iniciar sprint. A sprint recebe uma selecao operacional dos P0/P1.
|
|
42
|
-
|
|
43
|
-
## 6. Dependencias
|
|
44
|
-
- Sem novos pacotes.
|
|
45
|
-
- Sem migracao de banco.
|
|
46
|
-
|
|
47
|
-
## 7. Rollout
|
|
48
|
-
- Documentacao atualizada no README, AGENTS e guia CLI-first.
|
|
49
|
-
- Testes de CLI executados localmente.
|
|
50
|
-
|
|
51
|
-
## 8. Sinais de fracasso
|
|
52
|
-
- Operador ainda precisar abrir web para acompanhar sprint.
|
|
53
|
-
- `gsd:check` bloquear tarefa CLI-only por ausencia de brief visual.
|
|
1
|
+
# Plan: cli-first-operacao
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-06-02
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem tecnica
|
|
8
|
+
Manter o dashboard existente como opcional e mover a operacao principal para comandos. Corrigir o gerenciador de sprint para funcionar no repositorio raiz, aceitar backlog RICE e expor encerramento de sprint no `package.json`. Ajustar GSD para nao exigir design em fluxo sem UI.
|
|
9
|
+
|
|
10
|
+
## 2. Modulos afetados
|
|
11
|
+
| Caminho | Mudanca | Risco |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `scripts/sprint-manager.js` | default para raiz e suporte a tabela RICE | M |
|
|
14
|
+
| `scripts/agent-harness.mjs` | `gsd:check` aceita CLI-only sem brief visual | B |
|
|
15
|
+
| `scripts/dev.mjs` | saida textual mais limpa | B |
|
|
16
|
+
| `scripts/check-standards.js` | `project:check` valida root sem argumento | B |
|
|
17
|
+
| `package.json` | novos aliases de operacao | B |
|
|
18
|
+
| `README.md`, `AGENTS.md`, `docs/*` | documentar CLI-first | B |
|
|
19
|
+
|
|
20
|
+
## 3. Fluxo
|
|
21
|
+
```
|
|
22
|
+
sprint:start/status
|
|
23
|
+
-> context:build
|
|
24
|
+
-> gsd:plan
|
|
25
|
+
-> gsd:handoff spec/plan/implement/review
|
|
26
|
+
-> gsd:check
|
|
27
|
+
-> project:check
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 4. Contratos
|
|
31
|
+
- `npm run sprint:start [projeto]`
|
|
32
|
+
- `npm run sprint:status [projeto]`
|
|
33
|
+
- `npm run sprint:complete [projeto]`
|
|
34
|
+
- `npm run gsd:check -- <slug> [brief.md]`
|
|
35
|
+
|
|
36
|
+
Sem `brief.md`, o check considera design como nao aplicavel.
|
|
37
|
+
|
|
38
|
+
## 5. Decisoes
|
|
39
|
+
**D1**: Nao remover o dashboard agora. Ele fica legado/opcional para evitar quebra de scripts e preservar historico.
|
|
40
|
+
|
|
41
|
+
**D2**: Backlog RICE nao e modificado ao iniciar sprint. A sprint recebe uma selecao operacional dos P0/P1.
|
|
42
|
+
|
|
43
|
+
## 6. Dependencias
|
|
44
|
+
- Sem novos pacotes.
|
|
45
|
+
- Sem migracao de banco.
|
|
46
|
+
|
|
47
|
+
## 7. Rollout
|
|
48
|
+
- Documentacao atualizada no README, AGENTS e guia CLI-first.
|
|
49
|
+
- Testes de CLI executados localmente.
|
|
50
|
+
|
|
51
|
+
## 8. Sinais de fracasso
|
|
52
|
+
- Operador ainda precisar abrir web para acompanhar sprint.
|
|
53
|
+
- `gsd:check` bloquear tarefa CLI-only por ausencia de brief visual.
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# Spec: cli-first-operacao
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-CLI-FIRST-001
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: orchestrator
|
|
6
|
-
- **Criado em**: 2026-06-02
|
|
7
|
-
- **Sprint alvo**: refinamento-cli-2026-06
|
|
8
|
-
- **ADRs relacionadas**: ADR-0005, ADR-0007, ADR-0008
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
O projeto tinha forte presenca de dashboard/web e referencias visuais na entrada operacional. Isso poluia a operacao diaria e desviava o uso do objetivo principal: orquestracao, SDD, GSD, sprints e handoffs por comandos.
|
|
12
|
-
|
|
13
|
-
## 2. Proposta de valor
|
|
14
|
-
Operar o framework pelo terminal com sprints, contexto, specs, handoffs, checks e governanca em uma trilha curta e repetivel.
|
|
15
|
-
|
|
16
|
-
## 3. User stories
|
|
17
|
-
- **Como** operador do framework, **quero** acompanhar sprints pelo CLI, **para que** eu nao dependa da web para saber o proximo passo.
|
|
18
|
-
- **Como** Orchestrator, **quero** registrar handoffs GSD pelo CLI, **para que** SDD e governanca tenham rastreabilidade.
|
|
19
|
-
- **Como** Governance, **quero** validar entregas CLI-only sem brief visual, **para que** design nao bloqueie trabalho sem UI.
|
|
20
|
-
|
|
21
|
-
## 4. Criterios de aceite
|
|
22
|
-
- [x] AC-1: `npm run sprint:start/status/complete` funciona no repositorio raiz sem argumento de projeto.
|
|
23
|
-
- [x] AC-2: backlog em tabela RICE gera sprint com itens P0/P1.
|
|
24
|
-
- [x] AC-3: `gsd:check` nao exige brief visual quando a entrega e CLI-only.
|
|
25
|
-
- [x] AC-4: README, AGENTS e docs apontam CLI-first como caminho operacional principal.
|
|
26
|
-
- [x] AC-5: dashboard/web permanece opcional/legado, nao gate operacional.
|
|
27
|
-
- [x] AC-6: `npm run project:check` valida o framework raiz quando chamado sem projeto.
|
|
28
|
-
|
|
29
|
-
## 5. Escopo
|
|
30
|
-
**Dentro**:
|
|
31
|
-
- Scripts de sprint e GSD.
|
|
32
|
-
- Check de governanca do projeto raiz.
|
|
33
|
-
- Documentacao de operacao CLI-first.
|
|
34
|
-
- Reducao de ruido visual no CLI principal.
|
|
35
|
-
|
|
36
|
-
**Fora**:
|
|
37
|
-
- Remover fisicamente o dashboard.
|
|
38
|
-
- Reescrever frontend.
|
|
39
|
-
- Alterar SQLite ou schema de handoffs.
|
|
40
|
-
|
|
41
|
-
## 6. NFRs / restricoes
|
|
42
|
-
- Compatibilidade: manter comandos existentes.
|
|
43
|
-
- Operabilidade: saida de terminal simples, sem depender de browser.
|
|
44
|
-
- Governanca: preservar ADR-0005 e fluxo SDD.
|
|
45
|
-
|
|
46
|
-
## 7. Riscos e mitigacao
|
|
47
|
-
| Risco | Probabilidade | Impacto | Mitigacao |
|
|
48
|
-
|---|---|---|---|
|
|
49
|
-
| Usuarios ainda abrirem dashboard por habito | M | B | README e AGENTS priorizam CLI-first |
|
|
50
|
-
| Sprint duplicar itens de backlog RICE | B | B | Tabela RICE nao e removida; sprint vira selecao operacional |
|
|
51
|
-
|
|
52
|
-
## 8. Metricas de sucesso
|
|
53
|
-
Em 30 dias, 90% das execucoes de sprint e handoff devem ser feitas por CLI, com `gsd:check` e `project:check` usados antes de entrega.
|
|
1
|
+
# Spec: cli-first-operacao
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-CLI-FIRST-001
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: orchestrator
|
|
6
|
+
- **Criado em**: 2026-06-02
|
|
7
|
+
- **Sprint alvo**: refinamento-cli-2026-06
|
|
8
|
+
- **ADRs relacionadas**: ADR-0005, ADR-0007, ADR-0008
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O projeto tinha forte presenca de dashboard/web e referencias visuais na entrada operacional. Isso poluia a operacao diaria e desviava o uso do objetivo principal: orquestracao, SDD, GSD, sprints e handoffs por comandos.
|
|
12
|
+
|
|
13
|
+
## 2. Proposta de valor
|
|
14
|
+
Operar o framework pelo terminal com sprints, contexto, specs, handoffs, checks e governanca em uma trilha curta e repetivel.
|
|
15
|
+
|
|
16
|
+
## 3. User stories
|
|
17
|
+
- **Como** operador do framework, **quero** acompanhar sprints pelo CLI, **para que** eu nao dependa da web para saber o proximo passo.
|
|
18
|
+
- **Como** Orchestrator, **quero** registrar handoffs GSD pelo CLI, **para que** SDD e governanca tenham rastreabilidade.
|
|
19
|
+
- **Como** Governance, **quero** validar entregas CLI-only sem brief visual, **para que** design nao bloqueie trabalho sem UI.
|
|
20
|
+
|
|
21
|
+
## 4. Criterios de aceite
|
|
22
|
+
- [x] AC-1: `npm run sprint:start/status/complete` funciona no repositorio raiz sem argumento de projeto.
|
|
23
|
+
- [x] AC-2: backlog em tabela RICE gera sprint com itens P0/P1.
|
|
24
|
+
- [x] AC-3: `gsd:check` nao exige brief visual quando a entrega e CLI-only.
|
|
25
|
+
- [x] AC-4: README, AGENTS e docs apontam CLI-first como caminho operacional principal.
|
|
26
|
+
- [x] AC-5: dashboard/web permanece opcional/legado, nao gate operacional.
|
|
27
|
+
- [x] AC-6: `npm run project:check` valida o framework raiz quando chamado sem projeto.
|
|
28
|
+
|
|
29
|
+
## 5. Escopo
|
|
30
|
+
**Dentro**:
|
|
31
|
+
- Scripts de sprint e GSD.
|
|
32
|
+
- Check de governanca do projeto raiz.
|
|
33
|
+
- Documentacao de operacao CLI-first.
|
|
34
|
+
- Reducao de ruido visual no CLI principal.
|
|
35
|
+
|
|
36
|
+
**Fora**:
|
|
37
|
+
- Remover fisicamente o dashboard.
|
|
38
|
+
- Reescrever frontend.
|
|
39
|
+
- Alterar SQLite ou schema de handoffs.
|
|
40
|
+
|
|
41
|
+
## 6. NFRs / restricoes
|
|
42
|
+
- Compatibilidade: manter comandos existentes.
|
|
43
|
+
- Operabilidade: saida de terminal simples, sem depender de browser.
|
|
44
|
+
- Governanca: preservar ADR-0005 e fluxo SDD.
|
|
45
|
+
|
|
46
|
+
## 7. Riscos e mitigacao
|
|
47
|
+
| Risco | Probabilidade | Impacto | Mitigacao |
|
|
48
|
+
|---|---|---|---|
|
|
49
|
+
| Usuarios ainda abrirem dashboard por habito | M | B | README e AGENTS priorizam CLI-first |
|
|
50
|
+
| Sprint duplicar itens de backlog RICE | B | B | Tabela RICE nao e removida; sprint vira selecao operacional |
|
|
51
|
+
|
|
52
|
+
## 8. Metricas de sucesso
|
|
53
|
+
Em 30 dias, 90% das execucoes de sprint e handoff devem ser feitas por CLI, com `gsd:check` e `project:check` usados antes de entrega.
|