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,87 +1,87 @@
|
|
|
1
|
-
# Instruções para GitHub Copilot — Forja
|
|
2
|
-
|
|
3
|
-
> Guia para o Copilot operar a Forja. O conteúdo é o mesmo para Claude, Gemini 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 GitHub Copilot — Forja
|
|
2
|
+
|
|
3
|
+
> Guia para o Copilot operar a Forja. O conteúdo é o mesmo para Claude, Gemini 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.
|
package/.memoryrc.json
CHANGED
|
@@ -1,104 +1,104 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "https://example.com/memoryrc.schema.json",
|
|
3
|
-
"version": "1.0.0",
|
|
4
|
-
"description": "Global configuration for memory management, token economy, and context optimization",
|
|
5
|
-
|
|
6
|
-
"context": {
|
|
7
|
-
"description": "Smart context building & caching",
|
|
8
|
-
"maxCacheSize": 50,
|
|
9
|
-
"maxContextLength": 100000,
|
|
10
|
-
"modes": {
|
|
11
|
-
"global": {
|
|
12
|
-
"description": "Only mission, standards, recent ADRs",
|
|
13
|
-
"priority": ["mission.md", "standards.md", "ADR-*"],
|
|
14
|
-
"maxFiles": 10
|
|
15
|
-
},
|
|
16
|
-
"domain": {
|
|
17
|
-
"description": "Project vision, design, rules + globals",
|
|
18
|
-
"priority": ["vision.md", "design-md/", "rules.md", "summary.md"],
|
|
19
|
-
"maxFiles": 20
|
|
20
|
-
},
|
|
21
|
-
"task": {
|
|
22
|
-
"description": "Task-specific context via FTS5 + domain + globals (most compact)",
|
|
23
|
-
"priority": ["keyword-search", "design-md/INDEX.md"],
|
|
24
|
-
"maxFiles": 30
|
|
25
|
-
}
|
|
26
|
-
},
|
|
27
|
-
"cache": {
|
|
28
|
-
"enabled": true,
|
|
29
|
-
"ttl": 604800000,
|
|
30
|
-
"location": ".context/cache",
|
|
31
|
-
"strategy": "lru"
|
|
32
|
-
}
|
|
33
|
-
},
|
|
34
|
-
|
|
35
|
-
"compression": {
|
|
36
|
-
"description": "Memory vacuum settings for .memory/sqlite/",
|
|
37
|
-
"archiveAge": 30,
|
|
38
|
-
"maxDbSize": 50,
|
|
39
|
-
"cacheTtl": 7,
|
|
40
|
-
"vacuumInterval": 86400000,
|
|
41
|
-
"archiveLocation": ".memory/archive"
|
|
42
|
-
},
|
|
43
|
-
|
|
44
|
-
"indexing": {
|
|
45
|
-
"description": "Full-text search (FTS5) configuration",
|
|
46
|
-
"enabled": true,
|
|
47
|
-
"contentFields": ["title", "content", "path"],
|
|
48
|
-
"rebuildOnModified": true,
|
|
49
|
-
"rebuildInterval": 3600000
|
|
50
|
-
},
|
|
51
|
-
|
|
52
|
-
"logging": {
|
|
53
|
-
"description": "Execution logging for audit trail",
|
|
54
|
-
"enabled": true,
|
|
55
|
-
"location": ".memory/runs",
|
|
56
|
-
"level": "info",
|
|
57
|
-
"retentionDays": 30
|
|
58
|
-
},
|
|
59
|
-
|
|
60
|
-
"tokenLimits": {
|
|
61
|
-
"description": "Hard limits per context mode (estimation: 1KB ≈ 250 tokens)",
|
|
62
|
-
"global": 2000,
|
|
63
|
-
"domain": 5000,
|
|
64
|
-
"task": 8000,
|
|
65
|
-
"buffer": 500
|
|
66
|
-
},
|
|
67
|
-
|
|
68
|
-
"optimization": {
|
|
69
|
-
"description": "Token economy strategies",
|
|
70
|
-
"strategies": [
|
|
71
|
-
"deduplication",
|
|
72
|
-
"priority-weighting",
|
|
73
|
-
"time-decay",
|
|
74
|
-
"relevance-ranking"
|
|
75
|
-
],
|
|
76
|
-
"enableSmartContext": true,
|
|
77
|
-
"enableCompression": true,
|
|
78
|
-
"enableCaching": true,
|
|
79
|
-
"targetReduction": 0.5
|
|
80
|
-
},
|
|
81
|
-
|
|
82
|
-
"handoff": {
|
|
83
|
-
"description": "Agent handoff protocol settings (ADR-0005 + ADR-0008)",
|
|
84
|
-
"storage": "sqlite",
|
|
85
|
-
"table": ".memory/sqlite/universal.db::handoffs",
|
|
86
|
-
"legacyLocation": "memory/50-orchestration/handoffs",
|
|
87
|
-
"requiredFields": ["from", "to", "intent", "context", "acceptance", "constraints", "return"]
|
|
88
|
-
},
|
|
89
|
-
|
|
90
|
-
"hooks": {
|
|
91
|
-
"description": "Claude Code hook config (.claude/settings.json points here for caps)",
|
|
92
|
-
"userPromptCap": 4000,
|
|
93
|
-
"sessionStartCap": 2000,
|
|
94
|
-
"triggerKeywordsHint": "implement|refactor|criar feature|spec:|plan:|tasks:|arquitet",
|
|
95
|
-
"injectOptIn": "Set FRAMEWORK_HOOK_INJECT=1 to enable UserPromptSubmit injection"
|
|
96
|
-
},
|
|
97
|
-
|
|
98
|
-
"metadata": {
|
|
99
|
-
"description": "Project metadata stored in universal.db",
|
|
100
|
-
"projectId": "auto",
|
|
101
|
-
"createdAt": "auto",
|
|
102
|
-
"version": "1.0.0"
|
|
103
|
-
}
|
|
104
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://example.com/memoryrc.schema.json",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Global configuration for memory management, token economy, and context optimization",
|
|
5
|
+
|
|
6
|
+
"context": {
|
|
7
|
+
"description": "Smart context building & caching",
|
|
8
|
+
"maxCacheSize": 50,
|
|
9
|
+
"maxContextLength": 100000,
|
|
10
|
+
"modes": {
|
|
11
|
+
"global": {
|
|
12
|
+
"description": "Only mission, standards, recent ADRs",
|
|
13
|
+
"priority": ["mission.md", "standards.md", "ADR-*"],
|
|
14
|
+
"maxFiles": 10
|
|
15
|
+
},
|
|
16
|
+
"domain": {
|
|
17
|
+
"description": "Project vision, design, rules + globals",
|
|
18
|
+
"priority": ["vision.md", "design-md/", "rules.md", "summary.md"],
|
|
19
|
+
"maxFiles": 20
|
|
20
|
+
},
|
|
21
|
+
"task": {
|
|
22
|
+
"description": "Task-specific context via FTS5 + domain + globals (most compact)",
|
|
23
|
+
"priority": ["keyword-search", "design-md/INDEX.md"],
|
|
24
|
+
"maxFiles": 30
|
|
25
|
+
}
|
|
26
|
+
},
|
|
27
|
+
"cache": {
|
|
28
|
+
"enabled": true,
|
|
29
|
+
"ttl": 604800000,
|
|
30
|
+
"location": ".context/cache",
|
|
31
|
+
"strategy": "lru"
|
|
32
|
+
}
|
|
33
|
+
},
|
|
34
|
+
|
|
35
|
+
"compression": {
|
|
36
|
+
"description": "Memory vacuum settings for .memory/sqlite/",
|
|
37
|
+
"archiveAge": 30,
|
|
38
|
+
"maxDbSize": 50,
|
|
39
|
+
"cacheTtl": 7,
|
|
40
|
+
"vacuumInterval": 86400000,
|
|
41
|
+
"archiveLocation": ".memory/archive"
|
|
42
|
+
},
|
|
43
|
+
|
|
44
|
+
"indexing": {
|
|
45
|
+
"description": "Full-text search (FTS5) configuration",
|
|
46
|
+
"enabled": true,
|
|
47
|
+
"contentFields": ["title", "content", "path"],
|
|
48
|
+
"rebuildOnModified": true,
|
|
49
|
+
"rebuildInterval": 3600000
|
|
50
|
+
},
|
|
51
|
+
|
|
52
|
+
"logging": {
|
|
53
|
+
"description": "Execution logging for audit trail",
|
|
54
|
+
"enabled": true,
|
|
55
|
+
"location": ".memory/runs",
|
|
56
|
+
"level": "info",
|
|
57
|
+
"retentionDays": 30
|
|
58
|
+
},
|
|
59
|
+
|
|
60
|
+
"tokenLimits": {
|
|
61
|
+
"description": "Hard limits per context mode (estimation: 1KB ≈ 250 tokens)",
|
|
62
|
+
"global": 2000,
|
|
63
|
+
"domain": 5000,
|
|
64
|
+
"task": 8000,
|
|
65
|
+
"buffer": 500
|
|
66
|
+
},
|
|
67
|
+
|
|
68
|
+
"optimization": {
|
|
69
|
+
"description": "Token economy strategies",
|
|
70
|
+
"strategies": [
|
|
71
|
+
"deduplication",
|
|
72
|
+
"priority-weighting",
|
|
73
|
+
"time-decay",
|
|
74
|
+
"relevance-ranking"
|
|
75
|
+
],
|
|
76
|
+
"enableSmartContext": true,
|
|
77
|
+
"enableCompression": true,
|
|
78
|
+
"enableCaching": true,
|
|
79
|
+
"targetReduction": 0.5
|
|
80
|
+
},
|
|
81
|
+
|
|
82
|
+
"handoff": {
|
|
83
|
+
"description": "Agent handoff protocol settings (ADR-0005 + ADR-0008)",
|
|
84
|
+
"storage": "sqlite",
|
|
85
|
+
"table": ".memory/sqlite/universal.db::handoffs",
|
|
86
|
+
"legacyLocation": "memory/50-orchestration/handoffs",
|
|
87
|
+
"requiredFields": ["from", "to", "intent", "context", "acceptance", "constraints", "return"]
|
|
88
|
+
},
|
|
89
|
+
|
|
90
|
+
"hooks": {
|
|
91
|
+
"description": "Claude Code hook config (.claude/settings.json points here for caps)",
|
|
92
|
+
"userPromptCap": 4000,
|
|
93
|
+
"sessionStartCap": 2000,
|
|
94
|
+
"triggerKeywordsHint": "implement|refactor|criar feature|spec:|plan:|tasks:|arquitet",
|
|
95
|
+
"injectOptIn": "Set FRAMEWORK_HOOK_INJECT=1 to enable UserPromptSubmit injection"
|
|
96
|
+
},
|
|
97
|
+
|
|
98
|
+
"metadata": {
|
|
99
|
+
"description": "Project metadata stored in universal.db",
|
|
100
|
+
"projectId": "auto",
|
|
101
|
+
"createdAt": "auto",
|
|
102
|
+
"version": "1.0.0"
|
|
103
|
+
}
|
|
104
|
+
}
|
package/.openai-instructions.md
CHANGED
|
@@ -1,87 +1,87 @@
|
|
|
1
|
-
# Instruções para OpenAI Codex — Forja
|
|
2
|
-
|
|
3
|
-
> Guia para o Codex operar a Forja. O conteúdo é o mesmo para Claude, Copilot e Gemini — 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 OpenAI Codex — Forja
|
|
2
|
+
|
|
3
|
+
> Guia para o Codex operar a Forja. O conteúdo é o mesmo para Claude, Copilot e Gemini — 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.
|