forjajs 2.0.4 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +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 +50 -50
- 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 +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +15 -0
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +32 -3
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/publishing.md +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 +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -157
- 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/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/cost-aware-autonomy-budget/spec.md +102 -0
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/spec.md +23 -23
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
package/.claude/settings.json
CHANGED
|
@@ -1,76 +1,76 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "https://json.schemastore.org/claude-code-settings.json",
|
|
3
|
-
"hooks": {
|
|
4
|
-
"SessionStart": [
|
|
5
|
-
{
|
|
6
|
-
"hooks": [
|
|
7
|
-
{
|
|
8
|
-
"type": "command",
|
|
9
|
-
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-session-start.ts",
|
|
10
|
-
"timeout": 5000
|
|
11
|
-
}
|
|
12
|
-
]
|
|
13
|
-
}
|
|
14
|
-
],
|
|
15
|
-
"UserPromptSubmit": [
|
|
16
|
-
{
|
|
17
|
-
"hooks": [
|
|
18
|
-
{
|
|
19
|
-
"type": "command",
|
|
20
|
-
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-user-prompt.ts",
|
|
21
|
-
"timeout": 3000
|
|
22
|
-
}
|
|
23
|
-
]
|
|
24
|
-
}
|
|
25
|
-
],
|
|
26
|
-
"PreToolUse": [
|
|
27
|
-
{
|
|
28
|
-
"matcher": "Edit|Write|NotebookEdit",
|
|
29
|
-
"hooks": [
|
|
30
|
-
{
|
|
31
|
-
"type": "command",
|
|
32
|
-
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-guard-paths.ts",
|
|
33
|
-
"timeout": 5000
|
|
34
|
-
}
|
|
35
|
-
]
|
|
36
|
-
}
|
|
37
|
-
],
|
|
38
|
-
"PostToolUse": [
|
|
39
|
-
{
|
|
40
|
-
"matcher": "Edit|Write",
|
|
41
|
-
"hooks": [
|
|
42
|
-
{
|
|
43
|
-
"type": "command",
|
|
44
|
-
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-post-edit.ts",
|
|
45
|
-
"timeout": 60000
|
|
46
|
-
}
|
|
47
|
-
]
|
|
48
|
-
}
|
|
49
|
-
]
|
|
50
|
-
},
|
|
51
|
-
"permissions": {
|
|
52
|
-
"allow": [
|
|
53
|
-
"Bash(node bin/forja.ts *)",
|
|
54
|
-
"Bash(node scripts/spec-cli.ts *)",
|
|
55
|
-
"Bash(node scripts/agent-router.ts *)",
|
|
56
|
-
"Bash(npm run spec:*)",
|
|
57
|
-
"Bash(npm run memory:*)",
|
|
58
|
-
"Bash(npm run sprint:*)",
|
|
59
|
-
"Bash(npm run project:*)",
|
|
60
|
-
"Bash(npm run context:*)",
|
|
61
|
-
"Bash(npm run code:*)",
|
|
62
|
-
"Bash(npm run design:*)",
|
|
63
|
-
"Bash(npm run gsd:*)",
|
|
64
|
-
"Bash(npm run ops:*)",
|
|
65
|
-
"Bash(npm run agent:*)",
|
|
66
|
-
"Bash(npm run catalog:*)",
|
|
67
|
-
"Bash(npm run workspace:*)",
|
|
68
|
-
"Bash(npm run hermes:handoff *)",
|
|
69
|
-
"Bash(npm run token:benchmark)",
|
|
70
|
-
"Bash(npm run tools:doctor)",
|
|
71
|
-
"Bash(npm run sync:universal)",
|
|
72
|
-
"Bash(npm run query:universal *)",
|
|
73
|
-
"Bash(npm test)"
|
|
74
|
-
]
|
|
75
|
-
}
|
|
76
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json.schemastore.org/claude-code-settings.json",
|
|
3
|
+
"hooks": {
|
|
4
|
+
"SessionStart": [
|
|
5
|
+
{
|
|
6
|
+
"hooks": [
|
|
7
|
+
{
|
|
8
|
+
"type": "command",
|
|
9
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-session-start.ts",
|
|
10
|
+
"timeout": 5000
|
|
11
|
+
}
|
|
12
|
+
]
|
|
13
|
+
}
|
|
14
|
+
],
|
|
15
|
+
"UserPromptSubmit": [
|
|
16
|
+
{
|
|
17
|
+
"hooks": [
|
|
18
|
+
{
|
|
19
|
+
"type": "command",
|
|
20
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-user-prompt.ts",
|
|
21
|
+
"timeout": 3000
|
|
22
|
+
}
|
|
23
|
+
]
|
|
24
|
+
}
|
|
25
|
+
],
|
|
26
|
+
"PreToolUse": [
|
|
27
|
+
{
|
|
28
|
+
"matcher": "Edit|Write|NotebookEdit",
|
|
29
|
+
"hooks": [
|
|
30
|
+
{
|
|
31
|
+
"type": "command",
|
|
32
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-guard-paths.ts",
|
|
33
|
+
"timeout": 5000
|
|
34
|
+
}
|
|
35
|
+
]
|
|
36
|
+
}
|
|
37
|
+
],
|
|
38
|
+
"PostToolUse": [
|
|
39
|
+
{
|
|
40
|
+
"matcher": "Edit|Write",
|
|
41
|
+
"hooks": [
|
|
42
|
+
{
|
|
43
|
+
"type": "command",
|
|
44
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-post-edit.ts",
|
|
45
|
+
"timeout": 60000
|
|
46
|
+
}
|
|
47
|
+
]
|
|
48
|
+
}
|
|
49
|
+
]
|
|
50
|
+
},
|
|
51
|
+
"permissions": {
|
|
52
|
+
"allow": [
|
|
53
|
+
"Bash(node bin/forja.ts *)",
|
|
54
|
+
"Bash(node scripts/spec-cli.ts *)",
|
|
55
|
+
"Bash(node scripts/agent-router.ts *)",
|
|
56
|
+
"Bash(npm run spec:*)",
|
|
57
|
+
"Bash(npm run memory:*)",
|
|
58
|
+
"Bash(npm run sprint:*)",
|
|
59
|
+
"Bash(npm run project:*)",
|
|
60
|
+
"Bash(npm run context:*)",
|
|
61
|
+
"Bash(npm run code:*)",
|
|
62
|
+
"Bash(npm run design:*)",
|
|
63
|
+
"Bash(npm run gsd:*)",
|
|
64
|
+
"Bash(npm run ops:*)",
|
|
65
|
+
"Bash(npm run agent:*)",
|
|
66
|
+
"Bash(npm run catalog:*)",
|
|
67
|
+
"Bash(npm run workspace:*)",
|
|
68
|
+
"Bash(npm run hermes:handoff *)",
|
|
69
|
+
"Bash(npm run token:benchmark)",
|
|
70
|
+
"Bash(npm run tools:doctor)",
|
|
71
|
+
"Bash(npm run sync:universal)",
|
|
72
|
+
"Bash(npm run query:universal *)",
|
|
73
|
+
"Bash(npm test)"
|
|
74
|
+
]
|
|
75
|
+
}
|
|
76
|
+
}
|
|
@@ -1,61 +1,61 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: new-adr
|
|
3
|
-
description: Cria um ADR numerado em memory/90-decisions/ a partir do _template.md, preenchendo contexto, decisão, alternativas e consequências.
|
|
4
|
-
disable-model-invocation: true
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Novo ADR
|
|
8
|
-
|
|
9
|
-
Registra uma decisão arquitetural em `memory/90-decisions/NNNN-titulo.md`.
|
|
10
|
-
|
|
11
|
-
Um ADR existe para preservar o **rationale**, não o resultado. O código já diz o que
|
|
12
|
-
foi feito; só o ADR diz por que as alternativas foram rejeitadas. Se não há alternativa
|
|
13
|
-
rejeitada, provavelmente não há decisão — e não há ADR a escrever.
|
|
14
|
-
|
|
15
|
-
## Quando usar
|
|
16
|
-
|
|
17
|
-
Toda mudança estrutural: novo comando no core, mudança de contrato entre agentes,
|
|
18
|
-
troca de armazenamento, nova convenção de memória. O subagent `governance` reprova
|
|
19
|
-
merge de mudança estrutural sem ADR.
|
|
20
|
-
|
|
21
|
-
## Passos
|
|
22
|
-
|
|
23
|
-
1. **Descobrir o próximo número.** Nunca reutilize nem adivinhe:
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
ls memory/90-decisions/ | grep -E '^[0-9]{4}-' | sort | tail -1
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
O próximo é esse + 1, com zero-padding em 4 dígitos.
|
|
30
|
-
|
|
31
|
-
2. **Verificar se já existe ADR sobre o tema.** Uma decisão que revisa outra não
|
|
32
|
-
ganha ADR novo do zero — ela *supersedes* a anterior:
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
npm run query:universal "<tema da decisão>"
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
Se encontrar, o ADR novo declara `superseded by` no antigo e o antigo passa a
|
|
39
|
-
`Status: superseded by ADR-NNNN`.
|
|
40
|
-
|
|
41
|
-
3. **Copiar o template** `memory/90-decisions/_template.md` para o novo caminho.
|
|
42
|
-
O slug do arquivo é o título em kebab-case, sem artigos: `0021-guardrails-de-harness.md`.
|
|
43
|
-
|
|
44
|
-
4. **Preencher.** Regras que importam:
|
|
45
|
-
- `Status`: `proposed` até haver merge; `accepted` depois.
|
|
46
|
-
- `Contexto`: o problema e as restrições. Sem solução aqui.
|
|
47
|
-
- `Decisão`: no imperativo, direto. "Adotar X", não "decidimos que talvez X".
|
|
48
|
-
- `Alternativas consideradas`: no mínimo uma, com o motivo real da rejeição.
|
|
49
|
-
"Rejeitada porque é pior" não é motivo.
|
|
50
|
-
- `Consequências`: inclua os trade-offs negativos. Um ADR só com positivas mente.
|
|
51
|
-
- `Rastreamento`: paths reais de implementação.
|
|
52
|
-
|
|
53
|
-
5. **Reindexar a memória**, senão o ADR fica invisível para `query:universal`:
|
|
54
|
-
|
|
55
|
-
```bash
|
|
56
|
-
npm run sync:universal
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
6. **Referenciar de volta.** Se o ADR muda uma convenção descrita no `CLAUDE.md`
|
|
60
|
-
ou no `AGENTS.md`, atualize esses arquivos no mesmo commit. Documentação que
|
|
61
|
-
contradiz o ADR é pior que documentação ausente.
|
|
1
|
+
---
|
|
2
|
+
name: new-adr
|
|
3
|
+
description: Cria um ADR numerado em memory/90-decisions/ a partir do _template.md, preenchendo contexto, decisão, alternativas e consequências.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Novo ADR
|
|
8
|
+
|
|
9
|
+
Registra uma decisão arquitetural em `memory/90-decisions/NNNN-titulo.md`.
|
|
10
|
+
|
|
11
|
+
Um ADR existe para preservar o **rationale**, não o resultado. O código já diz o que
|
|
12
|
+
foi feito; só o ADR diz por que as alternativas foram rejeitadas. Se não há alternativa
|
|
13
|
+
rejeitada, provavelmente não há decisão — e não há ADR a escrever.
|
|
14
|
+
|
|
15
|
+
## Quando usar
|
|
16
|
+
|
|
17
|
+
Toda mudança estrutural: novo comando no core, mudança de contrato entre agentes,
|
|
18
|
+
troca de armazenamento, nova convenção de memória. O subagent `governance` reprova
|
|
19
|
+
merge de mudança estrutural sem ADR.
|
|
20
|
+
|
|
21
|
+
## Passos
|
|
22
|
+
|
|
23
|
+
1. **Descobrir o próximo número.** Nunca reutilize nem adivinhe:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
ls memory/90-decisions/ | grep -E '^[0-9]{4}-' | sort | tail -1
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
O próximo é esse + 1, com zero-padding em 4 dígitos.
|
|
30
|
+
|
|
31
|
+
2. **Verificar se já existe ADR sobre o tema.** Uma decisão que revisa outra não
|
|
32
|
+
ganha ADR novo do zero — ela *supersedes* a anterior:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
npm run query:universal "<tema da decisão>"
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Se encontrar, o ADR novo declara `superseded by` no antigo e o antigo passa a
|
|
39
|
+
`Status: superseded by ADR-NNNN`.
|
|
40
|
+
|
|
41
|
+
3. **Copiar o template** `memory/90-decisions/_template.md` para o novo caminho.
|
|
42
|
+
O slug do arquivo é o título em kebab-case, sem artigos: `0021-guardrails-de-harness.md`.
|
|
43
|
+
|
|
44
|
+
4. **Preencher.** Regras que importam:
|
|
45
|
+
- `Status`: `proposed` até haver merge; `accepted` depois.
|
|
46
|
+
- `Contexto`: o problema e as restrições. Sem solução aqui.
|
|
47
|
+
- `Decisão`: no imperativo, direto. "Adotar X", não "decidimos que talvez X".
|
|
48
|
+
- `Alternativas consideradas`: no mínimo uma, com o motivo real da rejeição.
|
|
49
|
+
"Rejeitada porque é pior" não é motivo.
|
|
50
|
+
- `Consequências`: inclua os trade-offs negativos. Um ADR só com positivas mente.
|
|
51
|
+
- `Rastreamento`: paths reais de implementação.
|
|
52
|
+
|
|
53
|
+
5. **Reindexar a memória**, senão o ADR fica invisível para `query:universal`:
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
npm run sync:universal
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
6. **Referenciar de volta.** Se o ADR muda uma convenção descrita no `CLAUDE.md`
|
|
60
|
+
ou no `AGENTS.md`, atualize esses arquivos no mesmo commit. Documentação que
|
|
61
|
+
contradiz o ADR é pior que documentação ausente.
|
|
@@ -1,67 +1,67 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: new-command
|
|
3
|
-
description: Adiciona um comando ao core Forja (registry + alias npm + script + teste), respeitando a invariante do ADR-0020.
|
|
4
|
-
disable-model-invocation: true
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Novo comando do core
|
|
8
|
-
|
|
9
|
-
O ADR-0020 estabelece uma invariante: **todo comando de processo passa por
|
|
10
|
-
`bin/forja.mjs`**. Não existe script solto. Adicionar um comando é um ato de quatro
|
|
11
|
-
partes acopladas — esquecer qualquer uma quebra `test/forja-core.test.js`.
|
|
12
|
-
|
|
13
|
-
## As quatro partes
|
|
14
|
-
|
|
15
|
-
| Parte | Onde | Por quê |
|
|
16
|
-
|---|---|---|
|
|
17
|
-
| Entrada no registry | `lib/core/registry.mjs` | É a fonte da verdade: help, gates e auditoria derivam dela |
|
|
18
|
-
| Script alvo | `scripts/<nome>.mjs` | O trabalho de fato |
|
|
19
|
-
| Alias npm | `package.json` → `scripts` | Ergonomia; deve delegar ao core, nunca ao script direto |
|
|
20
|
-
| Teste | `test/forja-core.test.js` | Já cobre integridade automaticamente — só precisa passar |
|
|
21
|
-
|
|
22
|
-
## Passos
|
|
23
|
-
|
|
24
|
-
1. **Escolher o domínio.** Os válidos estão em `DOMAINS` no topo de
|
|
25
|
-
`lib/core/registry.mjs`: `workspace`, `sdd`, `gsd`, `design`, `code`, `memoria`,
|
|
26
|
-
`contexto`, `governanca`, `geracao`. Um domínio novo é mudança estrutural — peça
|
|
27
|
-
um ADR primeiro (skill `new-adr`).
|
|
28
|
-
|
|
29
|
-
2. **Escrever o script** em `scripts/`. ESM, imports com prefixo `node:`, cabeçalho
|
|
30
|
-
comentando o *porquê* do script. Ele recebe os args depois de `args[]`.
|
|
31
|
-
|
|
32
|
-
3. **Declarar no registry**, em ordem, dentro do bloco do domínio:
|
|
33
|
-
|
|
34
|
-
```js
|
|
35
|
-
'dominio:acao': {
|
|
36
|
-
domain: 'memoria',
|
|
37
|
-
desc: 'Frase curta no infinitivo, aparece no help',
|
|
38
|
-
node: 'scripts/meu-script.mjs',
|
|
39
|
-
args: ['subcomando'], // opcional: args fixos antes dos do usuário
|
|
40
|
-
gate: 'workspace', // opcional: 'workspace' | 'workspace-warn'
|
|
41
|
-
},
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
Use `gate: 'workspace'` se o comando escreve no workspace externo (ADR-0019);
|
|
45
|
-
`workspace-warn` se apenas lê.
|
|
46
|
-
|
|
47
|
-
4. **Adicionar o alias** em `package.json`. Ele delega ao core, nunca ao script:
|
|
48
|
-
|
|
49
|
-
```json
|
|
50
|
-
"dominio:acao": "node bin/forja.mjs dominio:acao"
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
Chamar `node scripts/meu-script.mjs` direto pula os gates e a auditoria em
|
|
54
|
-
`.context/forja-runs.jsonl` — é exatamente o que o ADR-0020 proíbe.
|
|
55
|
-
|
|
56
|
-
5. **Verificar.** O hook `PostToolUse` já dispara o teste ao salvar o registry, mas
|
|
57
|
-
confirme o conjunto e o help:
|
|
58
|
-
|
|
59
|
-
```bash
|
|
60
|
-
node --test test/forja-core.test.js
|
|
61
|
-
node bin/forja.mjs # o comando deve aparecer sob seu domínio
|
|
62
|
-
node bin/forja.mjs dominio:acao # execução real
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
6. **Permissão.** Se o comando será chamado por agentes, acrescente
|
|
66
|
-
`Bash(npm run dominio:*)` em `.claude/settings.json` → `permissions.allow`,
|
|
67
|
-
senão cada chamada vira um prompt.
|
|
1
|
+
---
|
|
2
|
+
name: new-command
|
|
3
|
+
description: Adiciona um comando ao core Forja (registry + alias npm + script + teste), respeitando a invariante do ADR-0020.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Novo comando do core
|
|
8
|
+
|
|
9
|
+
O ADR-0020 estabelece uma invariante: **todo comando de processo passa por
|
|
10
|
+
`bin/forja.mjs`**. Não existe script solto. Adicionar um comando é um ato de quatro
|
|
11
|
+
partes acopladas — esquecer qualquer uma quebra `test/forja-core.test.js`.
|
|
12
|
+
|
|
13
|
+
## As quatro partes
|
|
14
|
+
|
|
15
|
+
| Parte | Onde | Por quê |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| Entrada no registry | `lib/core/registry.mjs` | É a fonte da verdade: help, gates e auditoria derivam dela |
|
|
18
|
+
| Script alvo | `scripts/<nome>.mjs` | O trabalho de fato |
|
|
19
|
+
| Alias npm | `package.json` → `scripts` | Ergonomia; deve delegar ao core, nunca ao script direto |
|
|
20
|
+
| Teste | `test/forja-core.test.js` | Já cobre integridade automaticamente — só precisa passar |
|
|
21
|
+
|
|
22
|
+
## Passos
|
|
23
|
+
|
|
24
|
+
1. **Escolher o domínio.** Os válidos estão em `DOMAINS` no topo de
|
|
25
|
+
`lib/core/registry.mjs`: `workspace`, `sdd`, `gsd`, `design`, `code`, `memoria`,
|
|
26
|
+
`contexto`, `governanca`, `geracao`. Um domínio novo é mudança estrutural — peça
|
|
27
|
+
um ADR primeiro (skill `new-adr`).
|
|
28
|
+
|
|
29
|
+
2. **Escrever o script** em `scripts/`. ESM, imports com prefixo `node:`, cabeçalho
|
|
30
|
+
comentando o *porquê* do script. Ele recebe os args depois de `args[]`.
|
|
31
|
+
|
|
32
|
+
3. **Declarar no registry**, em ordem, dentro do bloco do domínio:
|
|
33
|
+
|
|
34
|
+
```js
|
|
35
|
+
'dominio:acao': {
|
|
36
|
+
domain: 'memoria',
|
|
37
|
+
desc: 'Frase curta no infinitivo, aparece no help',
|
|
38
|
+
node: 'scripts/meu-script.mjs',
|
|
39
|
+
args: ['subcomando'], // opcional: args fixos antes dos do usuário
|
|
40
|
+
gate: 'workspace', // opcional: 'workspace' | 'workspace-warn'
|
|
41
|
+
},
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Use `gate: 'workspace'` se o comando escreve no workspace externo (ADR-0019);
|
|
45
|
+
`workspace-warn` se apenas lê.
|
|
46
|
+
|
|
47
|
+
4. **Adicionar o alias** em `package.json`. Ele delega ao core, nunca ao script:
|
|
48
|
+
|
|
49
|
+
```json
|
|
50
|
+
"dominio:acao": "node bin/forja.mjs dominio:acao"
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Chamar `node scripts/meu-script.mjs` direto pula os gates e a auditoria em
|
|
54
|
+
`.context/forja-runs.jsonl` — é exatamente o que o ADR-0020 proíbe.
|
|
55
|
+
|
|
56
|
+
5. **Verificar.** O hook `PostToolUse` já dispara o teste ao salvar o registry, mas
|
|
57
|
+
confirme o conjunto e o help:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
node --test test/forja-core.test.js
|
|
61
|
+
node bin/forja.mjs # o comando deve aparecer sob seu domínio
|
|
62
|
+
node bin/forja.mjs dominio:acao # execução real
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
6. **Permissão.** Se o comando será chamado por agentes, acrescente
|
|
66
|
+
`Bash(npm run dominio:*)` em `.claude/settings.json` → `permissions.allow`,
|
|
67
|
+
senão cada chamada vira um prompt.
|
package/.gemini-instructions.md
CHANGED
|
@@ -1,87 +1,87 @@
|
|
|
1
|
-
# Instruções para Gemini — Forja
|
|
2
|
-
|
|
3
|
-
> Guia para o Gemini operar a Forja. O conteúdo é o mesmo para Claude, Copilot e Codex — a Forja é multi-IA por design.
|
|
4
|
-
|
|
5
|
-
## O que é a Forja
|
|
6
|
-
|
|
7
|
-
A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
|
|
8
|
-
|
|
9
|
-
1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
|
|
10
|
-
2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
|
|
11
|
-
3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
|
|
12
|
-
|
|
13
|
-
## Onde você está?
|
|
14
|
-
|
|
15
|
-
- **No repositório do framework** (tem `bin/forja.mjs` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
|
|
16
|
-
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.mjs`, e o processo (spec → plan → tasks → check) vale igual.
|
|
17
|
-
|
|
18
|
-
## O core `forja` (ADR-0020)
|
|
19
|
-
|
|
20
|
-
Todo comando de processo do framework passa por um único ponto de entrada:
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
node bin/forja.mjs # help agrupado por domínio
|
|
24
|
-
node bin/forja.mjs <comando> # workspace, spec, gsd, code, memória, contexto
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.mjs` (validado por `test/forja-core.test.js`).
|
|
28
|
-
|
|
29
|
-
## Estrutura: framework × workspace (ADR-0019)
|
|
30
|
-
|
|
31
|
-
```
|
|
32
|
-
Framework (repo) Workspace (~/forja-workspace)
|
|
33
|
-
├─ bin/ CLIs (forja, init) ├─ projects/ produtos gerados
|
|
34
|
-
├─ lib/ core, workspace, ├─ memory/ memória universal
|
|
35
|
-
│ generators │ ├─ sqlite/universal.db (FTS5)
|
|
36
|
-
├─ scripts/ automação roteada │ └─ 30-projects/ fichas
|
|
37
|
-
├─ specs/ SDD do framework ├─ specs/ specs de produto
|
|
38
|
-
├─ memory/ memória do framework └─ .context/ runbooks + auditoria
|
|
39
|
-
│ └─ 90-decisions/ ADRs
|
|
40
|
-
├─ prompts/ papéis portáteis
|
|
41
|
-
└─ .claude/ sub-agents Claude Code
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
O workspace é resolvido por: `FORJA_WORKSPACE` → `~/.forjarc.json` → `~/forja-workspace`. A pasta `projects/` do repo é **legado, off-limits**.
|
|
45
|
-
|
|
46
|
-
## Memória hierárquica — ordem de leitura
|
|
47
|
-
|
|
48
|
-
```
|
|
49
|
-
memory/00-global/ missão, padrões (leia primeiro)
|
|
50
|
-
memory/10-product/ visão e personas
|
|
51
|
-
memory/20-architecture/ design técnico
|
|
52
|
-
memory/30-domains/ detalhes por domínio
|
|
53
|
-
memory/40-delivery/ roadmap, sprint, backlog
|
|
54
|
-
memory/50-orchestration/ topologia, handoffs
|
|
55
|
-
memory/70-summaries/ resumos compactos
|
|
56
|
-
memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
## Economia de tokens (obrigatório — ADR-0009)
|
|
60
|
-
|
|
61
|
-
**Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
|
|
62
|
-
|
|
63
|
-
1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
|
|
64
|
-
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Medido: ~99% menos tokens que carregar `memory/` inteira.
|
|
65
|
-
3. `memory/70-summaries/` antes de qualquer arquivo bruto; o bruto só se o resumo não bastar.
|
|
66
|
-
4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
|
|
67
|
-
|
|
68
|
-
Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
|
|
69
|
-
|
|
70
|
-
## Processo: SDD + GSD + 6 papéis
|
|
71
|
-
|
|
72
|
-
Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
|
|
73
|
-
|
|
74
|
-
```bash
|
|
75
|
-
npm run spec:new|plan|tasks|check -- <slug>
|
|
76
|
-
npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
|
|
77
|
-
npm run gsd:check -- <slug> # valida gates antes do review
|
|
78
|
-
npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
## Convenções (valem para todas as IAs)
|
|
82
|
-
|
|
83
|
-
- **pt-BR** em comunicação, docs e saída de CLI.
|
|
84
|
-
- **Spec antes de código** para features não-triviais; **ADR antes de mudança estrutural** (`memory/90-decisions/`, template em `_template.md`).
|
|
85
|
-
- **CLI-first**: o dashboard é read-only opcional, nunca gate.
|
|
86
|
-
- Antes de editar código: `npm run code:check` e `npm run code:impact -- <símbolo>`.
|
|
87
|
-
- Antes de merge/release: papel governance roda `npm run project:check` e audita handoffs.
|
|
1
|
+
# Instruções para Gemini — Forja
|
|
2
|
+
|
|
3
|
+
> Guia para o Gemini operar a Forja. O conteúdo é o mesmo para Claude, Copilot e Codex — a Forja é multi-IA por design.
|
|
4
|
+
|
|
5
|
+
## O que é a Forja
|
|
6
|
+
|
|
7
|
+
A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
|
|
8
|
+
|
|
9
|
+
1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
|
|
10
|
+
2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
|
|
11
|
+
3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
|
|
12
|
+
|
|
13
|
+
## Onde você está?
|
|
14
|
+
|
|
15
|
+
- **No repositório do framework** (tem `bin/forja.mjs` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
|
|
16
|
+
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.mjs`, e o processo (spec → plan → tasks → check) vale igual.
|
|
17
|
+
|
|
18
|
+
## O core `forja` (ADR-0020)
|
|
19
|
+
|
|
20
|
+
Todo comando de processo do framework passa por um único ponto de entrada:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
node bin/forja.mjs # help agrupado por domínio
|
|
24
|
+
node bin/forja.mjs <comando> # workspace, spec, gsd, code, memória, contexto
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.mjs` (validado por `test/forja-core.test.js`).
|
|
28
|
+
|
|
29
|
+
## Estrutura: framework × workspace (ADR-0019)
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
Framework (repo) Workspace (~/forja-workspace)
|
|
33
|
+
├─ bin/ CLIs (forja, init) ├─ projects/ produtos gerados
|
|
34
|
+
├─ lib/ core, workspace, ├─ memory/ memória universal
|
|
35
|
+
│ generators │ ├─ sqlite/universal.db (FTS5)
|
|
36
|
+
├─ scripts/ automação roteada │ └─ 30-projects/ fichas
|
|
37
|
+
├─ specs/ SDD do framework ├─ specs/ specs de produto
|
|
38
|
+
├─ memory/ memória do framework └─ .context/ runbooks + auditoria
|
|
39
|
+
│ └─ 90-decisions/ ADRs
|
|
40
|
+
├─ prompts/ papéis portáteis
|
|
41
|
+
└─ .claude/ sub-agents Claude Code
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
O workspace é resolvido por: `FORJA_WORKSPACE` → `~/.forjarc.json` → `~/forja-workspace`. A pasta `projects/` do repo é **legado, off-limits**.
|
|
45
|
+
|
|
46
|
+
## Memória hierárquica — ordem de leitura
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
memory/00-global/ missão, padrões (leia primeiro)
|
|
50
|
+
memory/10-product/ visão e personas
|
|
51
|
+
memory/20-architecture/ design técnico
|
|
52
|
+
memory/30-domains/ detalhes por domínio
|
|
53
|
+
memory/40-delivery/ roadmap, sprint, backlog
|
|
54
|
+
memory/50-orchestration/ topologia, handoffs
|
|
55
|
+
memory/70-summaries/ resumos compactos
|
|
56
|
+
memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Economia de tokens (obrigatório — ADR-0009)
|
|
60
|
+
|
|
61
|
+
**Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
|
|
62
|
+
|
|
63
|
+
1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
|
|
64
|
+
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Medido: ~99% menos tokens que carregar `memory/` inteira.
|
|
65
|
+
3. `memory/70-summaries/` antes de qualquer arquivo bruto; o bruto só se o resumo não bastar.
|
|
66
|
+
4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
|
|
67
|
+
|
|
68
|
+
Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
|
|
69
|
+
|
|
70
|
+
## Processo: SDD + GSD + 6 papéis
|
|
71
|
+
|
|
72
|
+
Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npm run spec:new|plan|tasks|check -- <slug>
|
|
76
|
+
npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
|
|
77
|
+
npm run gsd:check -- <slug> # valida gates antes do review
|
|
78
|
+
npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Convenções (valem para todas as IAs)
|
|
82
|
+
|
|
83
|
+
- **pt-BR** em comunicação, docs e saída de CLI.
|
|
84
|
+
- **Spec antes de código** para features não-triviais; **ADR antes de mudança estrutural** (`memory/90-decisions/`, template em `_template.md`).
|
|
85
|
+
- **CLI-first**: o dashboard é read-only opcional, nunca gate.
|
|
86
|
+
- Antes de editar código: `npm run code:check` e `npm run code:impact -- <símbolo>`.
|
|
87
|
+
- Antes de merge/release: papel governance roda `npm run project:check` e audita handoffs.
|