forjajs 2.0.3 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -339
- package/README.pt-BR.md +345 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.js +2 -2
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -150
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
package/README.pt-BR.md
CHANGED
|
@@ -1,345 +1,345 @@
|
|
|
1
|
-
<h1 align="center">🔨 Forja</h1>
|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
<strong>Transforme IA de codificação em uma equipe de engenharia com processo e memória:<br>todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.</strong>
|
|
5
|
-
</p>
|
|
6
|
-
|
|
7
|
-
<p align="center">
|
|
8
|
-
<a href="https://www.npmjs.com/package/forjajs"><img src="https://img.shields.io/npm/v/forjajs?style=flat-square&color=cb3837&logo=npm" alt="npm"></a>
|
|
9
|
-
<img src="https://github.com/allanpablo/forja/actions/workflows/ci.yml/badge.svg" alt="CI">
|
|
10
|
-
<img src="https://img.shields.io/badge/operação-CLI--first-3553ff?style=flat-square" alt="CLI-first">
|
|
11
|
-
<img src="https://img.shields.io/badge/agentes-6_papéis-orange?style=flat-square" alt="6 agentes">
|
|
12
|
-
<img src="https://img.shields.io/badge/pipeline-SDD_+_GSD-teal?style=flat-square" alt="SDD+GSD">
|
|
13
|
-
<img src="https://img.shields.io/badge/memória-SQLite_FTS5-green?style=flat-square" alt="Memória">
|
|
14
|
-
<img src="https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 20">
|
|
15
|
-
<img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT">
|
|
16
|
-
<img src="https://img.shields.io/badge/PRs-welcome-8957e5?style=flat-square" alt="PRs welcome">
|
|
17
|
-
</p>
|
|
18
|
-
|
|
19
|
-
<p align="center"><sub>🌐 <a href="README.md">English</a> · <strong>Português</strong></sub></p>
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## Por que a Forja existe
|
|
24
|
-
|
|
25
|
-
Agentes de IA são **amnésicos e indisciplinados**: cada sessão recomeça do zero, decisões
|
|
26
|
-
de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao
|
|
27
|
-
mesmo tempo paga esse imposto multiplicado por N.
|
|
28
|
-
|
|
29
|
-
A **Forja** é o estúdio em volta da IA. Ela coordena **6 papéis de agentes** num pipeline
|
|
30
|
-
**Spec-Driven (SDD)** + **Get-Stuff-Done (GSD)**, mantém uma **memória hierárquica**
|
|
31
|
-
indexada em SQLite que sobrevive entre sessões, e amarra tudo num **core CLI único com
|
|
32
|
-
gates e trilha de auditoria** (`forja`, ADR-0020). Multi-IA por design (Claude, Copilot,
|
|
33
|
-
Gemini, Codex). A operação é inteiramente via CLI.
|
|
34
|
-
|
|
35
|
-
**Para quem**: o dev solo ou time pequeno que opera múltiplos produtos com IA como
|
|
36
|
-
principal força de trabalho — e precisa da disciplina de um time grande sem ter esse time.
|
|
37
|
-
|
|
38
|
-
## Os 3 pilares
|
|
39
|
-
|
|
40
|
-
| Pilar | O que entrega | Prova |
|
|
41
|
-
|---|---|---|
|
|
42
|
-
| **Memória que sobrevive** | contexto hierárquico, buscável, compartilhado entre sessões e IAs | SQLite FTS5, smart-context (ADR-0003) |
|
|
43
|
-
| **Processo que governa** | nada vira código sem spec; nada estrutural sem ADR; comandos auditados | SDD+GSD, handoffs 7 campos (ADR-0005), core `forja` (ADR-0020) |
|
|
44
|
-
| **Fábrica, não projeto único** | workspace multi-produto, times de agentes por projeto | ADR-0019, harness, codegraph (ADR-0017) |
|
|
45
|
-
|
|
46
|
-
> Este repositório é o **motor (framework)** — não hospeda aplicações em produção.
|
|
47
|
-
> Os produtos do usuário vivem no **workspace Forja** (`~/forja-workspace` por padrão), fora deste repo.
|
|
48
|
-
> Veja ADR-0019 para a rationale.
|
|
49
|
-
|
|
50
|
-
## 60 segundos de Forja
|
|
51
|
-
|
|
52
|
-
```console
|
|
53
|
-
$ forja spec:new pagamentos-pix
|
|
54
|
-
✓ Spec criada: specs/pagamentos-pix/spec.md # nada vira código sem isso
|
|
55
|
-
|
|
56
|
-
$ forja gsd:handoff plan pagamentos-pix
|
|
57
|
-
Handoff registrado: product → sdd-architect # 7 campos, auditável (ADR-0005)
|
|
58
|
-
|
|
59
|
-
$ forja code:impact processPayment
|
|
60
|
-
Mapa de impacto: processPayment (profundidade 2) # blast radius ANTES de editar
|
|
61
|
-
--- Chamadores diretos ---
|
|
62
|
-
BillingController.charge · RetryWorker.run
|
|
63
|
-
|
|
64
|
-
$ forja gsd:check pagamentos-pix
|
|
65
|
-
OK GSD runbook OK Spec directory
|
|
66
|
-
OK SDD spec check OK Codegraph
|
|
67
|
-
Resultado: gates básicos prontos. # governança executável, não checklist
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
E cada comando acima ficou gravado em `.context/forja-runs.jsonl` — quando a governança pergunta "o processo foi seguido?", a resposta é um arquivo, não uma promessa.
|
|
71
|
-
|
|
72
|
-
## Por que não só…?
|
|
73
|
-
|
|
74
|
-
| Alternativa | Onde ela para | O que a Forja acrescenta |
|
|
75
|
-
|---|---|---|
|
|
76
|
-
| **Claude Code / Copilot puros** | brilhantes na sessão, amnésicos entre sessões | memória FTS5 + processo + auditoria em volta da IA |
|
|
77
|
-
| **LangGraph / CrewAI** | infraestrutura para *construir* agentes | a camada de cima: opera o time de agentes no dia a dia |
|
|
78
|
-
| **Templates & spec kits** | param quando a spec está escrita | pipeline completo até a governança, com gates que executam |
|
|
79
|
-
|
|
80
|
-
## Capacidades-chave
|
|
81
|
-
|
|
82
|
-
- **Core CLI único** — todo comando de processo passa por `forja <comando>`: registry declarativo, gates transversais (workspace) e auditoria append-only em `.context/forja-runs.jsonl` (ADR-0020).
|
|
83
|
-
- **Orquestração multiagente** — 6 papéis (orchestrator, context-engineer, sdd-architect, product, marketing, governance) com handoffs rastreados (7 campos, ADR-0005).
|
|
84
|
-
- **Memória hierárquica** — global → domínio → tarefa → resumo, com busca FTS5 e *smart-context* em 3 modos (ADR-0003).
|
|
85
|
-
- **Pipeline SDD + GSD** — `spec → plan → tasks → check`, decisões registradas como ADRs.
|
|
86
|
-
- **Auto-verificação (invariantes que rodam)** — o framework prova a si mesmo: uma família de gates guarda cada fronteira (núcleo, tarball, coerência de doc, topologia de agentes, projeto gerado), e `check:all` roda a bateria inteira num veredito só. A governança deixa de depender de disciplina — vira harness.
|
|
87
|
-
- **Economia de token medida, não afirmada** — a memória (`context.md` como mapa) economiza ~60% vs explorar no frio, e `token:economy` **prova** isso nos seus domínios. `code:context` entrega o mapa pronto; `memory:audit` garante que ele não mente sobre o código.
|
|
88
|
-
- **Geração de projetos** — `project:new` cria scaffold completo no workspace (memória, agentes, instruções multi-IA, backend NestJS como boilerplate padrão) e registra a ficha; `project:upgrade` traz peças novas para projetos já gerados sem tocar no código do usuário.
|
|
89
|
-
- **3 capacidades integradas** (ADR-0016): **codegraph** (análise de código via MCP), **harness** (desenho de times de agentes), **ai-engineering** (base de conhecimento).
|
|
90
|
-
|
|
91
|
-
## ⚡ Quick start
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
# Instalar (o pacote é forjajs; o comando é forja)
|
|
95
|
-
npm install -g forjajs
|
|
96
|
-
forja # help agrupado por domínio
|
|
97
|
-
|
|
98
|
-
# Preparar o workspace de produção (canto fixo dos projetos)
|
|
99
|
-
forja workspace:init
|
|
100
|
-
|
|
101
|
-
# Criar um projeto novo (gera em ~/forja-workspace/projects/<nome>)
|
|
102
|
-
forja project:new meu-projeto --ai claude,copilot
|
|
103
|
-
|
|
104
|
-
# Entrar no ciclo SDD/GSD da primeira feature
|
|
105
|
-
forja spec:new minha-feature
|
|
106
|
-
forja spec:plan minha-feature
|
|
107
|
-
forja spec:tasks minha-feature
|
|
108
|
-
forja spec:check minha-feature
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
### Provar autonomia supervisionada localmente
|
|
112
|
-
|
|
113
|
-
A prova offline determinística usa uma fixture externa, Git worktree real,
|
|
114
|
-
aprovação humana, `npm test` real, validação de diff, promoção, estado SQLite,
|
|
115
|
-
evidências no GraphLoop e handoff compacto:
|
|
116
|
-
|
|
117
|
-
```bash
|
|
118
|
-
npm run demo:autonomy
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
O fluxo completo está documentado em [`docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md`](docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md).
|
|
122
|
-
|
|
123
|
-
Meça o baseline determinístico de contexto e a evidência de cache:
|
|
124
|
-
|
|
125
|
-
```bash
|
|
126
|
-
npm run benchmark:context
|
|
127
|
-
```
|
|
128
|
-
|
|
129
|
-
O sandbox também expõe rollback explícito e auditável após promoção. Os limites
|
|
130
|
-
oficiais dos plugins `@forja/plugin-github` e `@forja/plugin-docker` estão disponíveis;
|
|
131
|
-
handlers externos de rede ou Docker precisam ser injetados e permissionados pelo host.
|
|
132
|
-
|
|
133
|
-
> Clonou o repo em vez de instalar? Os mesmos comandos rodam como
|
|
134
|
-
> `node bin/forja.ts <comando>` — os scripts npm são apenas aliases finos do core.
|
|
135
|
-
> A fonte é TypeScript e roda nativa: **dev exige Node ≥ 22.6** (strip-types). O pacote *publicado*
|
|
136
|
-
> embarca `dist/*.js` e roda em **Node ≥ 20** — o `release-gate` prova isso a cada release (SPEC-012).
|
|
137
|
-
|
|
138
|
-
Passo a passo de **criar vs atualizar** projeto: [`docs/processo-projeto.md`](docs/processo-projeto.md).
|
|
139
|
-
|
|
140
|
-
## Como funciona — o processo
|
|
141
|
-
|
|
142
|
-
```
|
|
143
|
-
💡 Demanda
|
|
144
|
-
├─ projeto NÃO existe ─► project:new + boilerplate + harness (desenha o time)
|
|
145
|
-
└─ projeto JÁ existe ──► overlay --only-memory + codegraph init (entende o código)
|
|
146
|
-
│
|
|
147
|
-
▼
|
|
148
|
-
CICLO CLI-first (docs/fluxo.md):
|
|
149
|
-
1·Entender → 2·Especificar → 3·Arquitetar → 4·Decompor → 5·Implementar → 6·Governar → ✅
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
| Etapa | Papel | Capacidade |
|
|
153
|
-
|-------|-------|------------|
|
|
154
|
-
| 1 Entender | context-engineer | codegraph · ai-engineering |
|
|
155
|
-
| 2 Especificar | product | — |
|
|
156
|
-
| 3 Arquitetar | sdd-architect | harness · ADR |
|
|
157
|
-
| 4 Decompor | sdd-architect | — |
|
|
158
|
-
| 5 Implementar | orchestrator + worker | codegraph (MCP) |
|
|
159
|
-
| 6 Governar | governance | codegraph (`affected`) |
|
|
160
|
-
|
|
161
|
-
Mapa completo do ciclo: [`docs/fluxo.md`](docs/fluxo.md).
|
|
162
|
-
|
|
163
|
-
## As 3 capacidades integradas
|
|
164
|
-
|
|
165
|
-
| Capacidade | Papel | Como usar |
|
|
166
|
-
|---|---|---|
|
|
167
|
-
| **codegraph** | análise de código (MCP local) | `forja code:index` · `codegraph explore "<área>"` · ferramentas MCP `codegraph_explore`/`codegraph_node` |
|
|
168
|
-
| **harness** | desenho de times de agentes (plugin) | na sessão Claude Code: _"build a harness for this project"_ → gera `.claude/agents` + `.claude/skills` |
|
|
169
|
-
| **ai-engineering** | base de conhecimento (referência) | ver [`docs/capacidades-externas.md`](docs/capacidades-externas.md) |
|
|
170
|
-
|
|
171
|
-
Detalhes e reinstalação: [`docs/capacidades-externas.md`](docs/capacidades-externas.md) · [ADR-0016](memory/90-decisions/0016-integracao-capacidades-externas.md).
|
|
172
|
-
|
|
173
|
-
## O core `forja`
|
|
174
|
-
|
|
175
|
-
Todos os comandos de processo passam por um único ponto de entrada (ADR-0020):
|
|
176
|
-
|
|
177
|
-
```bash
|
|
178
|
-
forja # help agrupado por domínio
|
|
179
|
-
forja <comando> [args] # no repo clonado: node bin/forja.ts <comando>
|
|
180
|
-
```
|
|
181
|
-
|
|
182
|
-
O core aplica **gates** antes de executar (ex.: comandos de produto falham cedo sem
|
|
183
|
-
workspace) e grava **auditoria** de cada execução (comando, args, exit code, duração)
|
|
184
|
-
em `<workspace>/.context/forja-runs.jsonl` — a trilha que a governança usa no review.
|
|
185
|
-
Os scripts npm do repo são aliases finos que roteiam pelo core.
|
|
186
|
-
|
|
187
|
-
## Comandos essenciais
|
|
188
|
-
|
|
189
|
-
```bash
|
|
190
|
-
# Workspace & projetos
|
|
191
|
-
forja workspace:init # cria ~/forja-workspace
|
|
192
|
-
forja project:new <nome> --ai claude,copilot # cria projeto no workspace
|
|
193
|
-
forja project:list # lista projetos do workspace
|
|
194
|
-
forja project:upgrade # traz peças novas de scaffold p/ um projeto (aditivo; --apply)
|
|
195
|
-
forja workspace:project:check <nome> # valida padrões num projeto do workspace
|
|
196
|
-
|
|
197
|
-
# Pipeline SDD
|
|
198
|
-
forja spec:new <slug> # também: spec:plan · spec:tasks · spec:check
|
|
199
|
-
|
|
200
|
-
# Sprint & handoffs (GSD)
|
|
201
|
-
forja sprint:start # também: sprint:status · sprint:complete
|
|
202
|
-
forja gsd:plan <slug> # runbook GSD em .context/
|
|
203
|
-
forja gsd:handoff <intent> <slug> # handoff entre papéis (ADR-0005)
|
|
204
|
-
forja gsd:check <slug> # gates básicos do runbook
|
|
205
|
-
forja orchestrate "<objetivo>" --slug <s> # abre a corrida: a cadeia SDD/GSD como máquina de estados (SPEC-021)
|
|
206
|
-
forja orchestrate:status <slug> # o estado da máquina: etapas, gates, vereditos
|
|
207
|
-
forja orchestrate:advance <slug> # roda o gate da etapa; verde → próxima; vermelho → trava
|
|
208
|
-
|
|
209
|
-
# Análise de código (codegraph)
|
|
210
|
-
forja code:check # índice confiável (worktree + freshness)
|
|
211
|
-
forja code:impact <símbolo> # chamadores + blast radius antes de editar
|
|
212
|
-
forja code:context <domínio> # pacote de contexto mínimo (o mapa; --code p/ o código)
|
|
213
|
-
forja code:query "<termo>" # também: code:index · code:sync · code:status
|
|
214
|
-
|
|
215
|
-
# Memória & contexto (workspace)
|
|
216
|
-
forja sync:universal # reindexa SQLite FTS5 do workspace
|
|
217
|
-
forja query:universal "<query>" # busca FTS5
|
|
218
|
-
forja context:smart # smart-context (3 modos, ADR-0003)
|
|
219
|
-
forja token:economy [--project <path>] # economia de token; --project mede seus domínios reais (ADR-0009)
|
|
220
|
-
forja memory:compress # arquiva runs antigos + VACUUM
|
|
221
|
-
forja memory:extract # extrai conhecimento global da memória
|
|
222
|
-
forja memory:audit # coerência mapa↔código: mapa não mente + módulo sem mapa (SPEC-017)
|
|
223
|
-
|
|
224
|
-
# Qualidade & release
|
|
225
|
-
forja project:check # standards do framework (pre-commit)
|
|
226
|
-
forja tools:doctor # raio-x do núcleo; separa permissão/lock de corrupção; exit 1 se quebrou
|
|
227
|
-
forja release:check --publish # gate do tarball antes de publicar
|
|
228
|
-
forja project:smoke # gate do projeto gerado; --full instala e builda o backend
|
|
229
|
-
forja check:all # a bateria inteira de gates, um veredito; --full inclui os caros (SPEC-020)
|
|
230
|
-
forja project:dashboard # relatório estático de status
|
|
231
|
-
|
|
232
|
-
# Governança & auditoria
|
|
233
|
-
forja audit:sync # projeta a trilha de auditoria numa tabela consultável
|
|
234
|
-
forja audit:query --failed # consulta: --failed, --cmd <x>, --since 7d
|
|
235
|
-
forja governance:dashboard # painel HTML estático (gates, SDD, auditoria) — sem servidor
|
|
236
|
-
```
|
|
237
|
-
|
|
238
|
-
## Separação framework × workspace
|
|
239
|
-
|
|
240
|
-
O Forja é dividido em duas partes:
|
|
241
|
-
|
|
242
|
-
1. **Framework** (este repositório): motor, convenções, scripts e memória do próprio framework.
|
|
243
|
-
2. **Workspace** (`~/forja-workspace` por padrão): "canto fixo" onde vivem os projetos de produto, a memória universal deles e as specs de produto.
|
|
244
|
-
|
|
245
|
-
O caminho do workspace é resolvido por prioridade:
|
|
246
|
-
|
|
247
|
-
1. Variável de ambiente `FORJA_WORKSPACE`
|
|
248
|
-
2. Campo `workspaceRoot` em `~/.forjarc.json`
|
|
249
|
-
3. Padrão: `~/forja-workspace`
|
|
250
|
-
|
|
251
|
-
Veja ADR-0019 para a decisão arquitetural.
|
|
252
|
-
|
|
253
|
-
## Estrutura do repositório (framework)
|
|
254
|
-
|
|
255
|
-
```
|
|
256
|
-
bin/ CLIs (forja — o core; init-project, create-memory-nest-kit)
|
|
257
|
-
lib/ Módulos reutilizáveis; lib/core/ é o motor de invariantes (registry, checks, health, release, doc-graph, gates)
|
|
258
|
-
scripts/ Automação (sprint-manager, agent-router, sync-universal-memory, …)
|
|
259
|
-
specs/ Pipeline SDD do próprio framework (spec → plan → tasks)
|
|
260
|
-
boilerplates/ Templates de stack (api-rest, saas, ecommerce, microservices, monorepo)
|
|
261
|
-
memory/ Memória do framework (00-global … 90-decisions/ADRs)
|
|
262
|
-
docs/ Documentação por persona e por tópico (ver DOC-MAP.md)
|
|
263
|
-
prompts/ Prompts portáteis dos 6 papéis
|
|
264
|
-
.claude/ Sub-agents e settings do Claude Code
|
|
265
|
-
projects/ LEGADO — não usar; projetos vivem no workspace externo
|
|
266
|
-
```
|
|
267
|
-
|
|
268
|
-
## Estrutura do workspace
|
|
269
|
-
|
|
270
|
-
```
|
|
271
|
-
~/forja-workspace/
|
|
272
|
-
projects/ # produtos gerados
|
|
273
|
-
memory/
|
|
274
|
-
sqlite/universal.db # SQLite FTS5 dos produtos
|
|
275
|
-
30-projects/ # fichas dos projetos
|
|
276
|
-
specs/ # specs de produto
|
|
277
|
-
.context/ # runbooks GSD de produto
|
|
278
|
-
README.md
|
|
279
|
-
```
|
|
280
|
-
|
|
281
|
-
## Documentação
|
|
282
|
-
|
|
283
|
-
- [`DOC-MAP.md`](DOC-MAP.md) — mapa por papel e por tópico (comece aqui)
|
|
284
|
-
- [`docs/processo-projeto.md`](docs/processo-projeto.md) — criar vs atualizar projeto
|
|
285
|
-
- [`docs/fluxo.md`](docs/fluxo.md) — mapa do ciclo CLI-first
|
|
286
|
-
- [`AGENTS.md`](AGENTS.md) — os 6 papéis e a topologia
|
|
287
|
-
- [`memory/90-decisions/`](memory/90-decisions/) — ADRs com rationale
|
|
288
|
-
- [`CHANGELOG.md`](CHANGELOG.md) — histórico
|
|
289
|
-
|
|
290
|
-
## Convenções
|
|
291
|
-
|
|
292
|
-
- **CLI-first** — sprints, SDD, GSD, handoffs e governança por comando; o front nunca é gate.
|
|
293
|
-
- **ADRs** — toda decisão estrutural vira `memory/90-decisions/NNNN-titulo.md`.
|
|
294
|
-
- **Handoffs** — 7 campos obrigatórios (ADR-0005), gravados no SQLite (ADR-0008).
|
|
295
|
-
- **pt-BR** — comunicação e documentação em português.
|
|
296
|
-
|
|
297
|
-
## Roadmap
|
|
298
|
-
|
|
299
|
-
O fio condutor: **converter conhecimento que vive em convenção em invariante executável.** Cada
|
|
300
|
-
item abaixo ou fecha uma fronteira do framework por um gate, ou leva esse padrão para os projetos
|
|
301
|
-
gerados.
|
|
302
|
-
|
|
303
|
-
**Entregue** (até v1.6.0)
|
|
304
|
-
|
|
305
|
-
- [x] **Família de gates** — cada fronteira do framework guarda por um invariante que roda: núcleo
|
|
306
|
-
(`tools:doctor`, ADR-0023), tarball (`release:check`, ADR-0024), coerência de doc + ADRs + topologia
|
|
307
|
-
de agentes (ADR-0025, SPEC-019), projeto gerado (`project:smoke`, ADR-0029). E `check:all` reúne a
|
|
308
|
-
bateria num veredito (SPEC-020).
|
|
309
|
-
- [x] **Migração TypeScript completa** — fonte 100% `.ts`, publica `dist/`, `noImplicitAny` ON. Achou
|
|
310
|
-
bugs latentes que nenhum teste pegava (SPEC-012).
|
|
311
|
-
- [x] **Economia de memória como sistema** — **medida** (`token:economy` prova ~60% vs frio),
|
|
312
|
-
**entregue** (`code:context`), **protegida** (`memory:audit`, nas duas direções) e **propagada**: o
|
|
313
|
-
projeto gerado herda o gate dos mapas (ADR-0030).
|
|
314
|
-
- [x] **`project:upgrade`** — atualizar um projeto já gerado sem perder código: aditivo, nunca
|
|
315
|
-
sobrescreve (SPEC-018).
|
|
316
|
-
- [x] **Clean Architecture calibrado** — camadas onde se pagam, enxuto onde não; e a claim de token
|
|
317
|
-
**medida e corrigida** — a economia é da memória, não das camadas (ADR-0027).
|
|
318
|
-
|
|
319
|
-
**Próximos passos** (por dependência, não por desejo)
|
|
320
|
-
|
|
321
|
-
- [x] **`builds` do backend gerado sob toolchain novo** — o template alinhou o `better-sqlite3` ao
|
|
322
|
-
do framework (^12, com prebuilds); o `check:all --full` compila o backend gerado em Node 26.
|
|
323
|
-
- [x] **`release-auditor` consome o gate** — o agente executa e julga `release:check --publish`
|
|
324
|
-
(ADR-0024), incluindo o `consumer-spec-new`; não reimplementa o procedimento.
|
|
325
|
-
- [ ] **Boilerplates além de NestJS** — o processo é agnóstico de stack; os templates vão atrás.
|
|
326
|
-
- [ ] **(visão) o motor de orquestração** — a cadeia de handoffs que **roda**, não só é coerente
|
|
327
|
-
(SPEC-019 deixou como futuro). O namesake executando: candidato ao 2.0.
|
|
328
|
-
|
|
329
|
-
Sugestões? Abra uma issue — feature não-trivial aqui começa por spec, inclusive as suas.
|
|
330
|
-
|
|
331
|
-
## English
|
|
332
|
-
|
|
333
|
-
Full English version: **[README.md](README.md)**. In short — **Forja** turns coding AI into an
|
|
334
|
-
engineering team with process and memory: every project starts from a spec, every structural
|
|
335
|
-
decision becomes an ADR, and nothing is lost between sessions. Documentation is in Brazilian
|
|
336
|
-
Portuguese — that's part of the project's identity; the CLI and the code are readable regardless.
|
|
337
|
-
|
|
338
|
-
---
|
|
339
|
-
|
|
340
|
-
<p align="center">
|
|
341
|
-
<strong>A Forja te ajudou a domar seus agentes?</strong><br>
|
|
342
|
-
Uma ⭐ é o que faz o projeto chegar a mais devs que estão pagando o imposto da IA amnésica.
|
|
343
|
-
</p>
|
|
344
|
-
|
|
345
|
-
<p align="center"><sub>Forja (npm: <code>forjajs</code>) · MIT License · <a href="CONTRIBUTING.md">Contribuindo</a></sub></p>
|
|
1
|
+
<h1 align="center">🔨 Forja</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<strong>Transforme IA de codificação em uma equipe de engenharia com processo e memória:<br>todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.</strong>
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<a href="https://www.npmjs.com/package/forjajs"><img src="https://img.shields.io/npm/v/forjajs?style=flat-square&color=cb3837&logo=npm" alt="npm"></a>
|
|
9
|
+
<img src="https://github.com/allanpablo/forja/actions/workflows/ci.yml/badge.svg" alt="CI">
|
|
10
|
+
<img src="https://img.shields.io/badge/operação-CLI--first-3553ff?style=flat-square" alt="CLI-first">
|
|
11
|
+
<img src="https://img.shields.io/badge/agentes-6_papéis-orange?style=flat-square" alt="6 agentes">
|
|
12
|
+
<img src="https://img.shields.io/badge/pipeline-SDD_+_GSD-teal?style=flat-square" alt="SDD+GSD">
|
|
13
|
+
<img src="https://img.shields.io/badge/memória-SQLite_FTS5-green?style=flat-square" alt="Memória">
|
|
14
|
+
<img src="https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 20">
|
|
15
|
+
<img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT">
|
|
16
|
+
<img src="https://img.shields.io/badge/PRs-welcome-8957e5?style=flat-square" alt="PRs welcome">
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
<p align="center"><sub>🌐 <a href="README.md">English</a> · <strong>Português</strong></sub></p>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Por que a Forja existe
|
|
24
|
+
|
|
25
|
+
Agentes de IA são **amnésicos e indisciplinados**: cada sessão recomeça do zero, decisões
|
|
26
|
+
de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao
|
|
27
|
+
mesmo tempo paga esse imposto multiplicado por N.
|
|
28
|
+
|
|
29
|
+
A **Forja** é o estúdio em volta da IA. Ela coordena **6 papéis de agentes** num pipeline
|
|
30
|
+
**Spec-Driven (SDD)** + **Get-Stuff-Done (GSD)**, mantém uma **memória hierárquica**
|
|
31
|
+
indexada em SQLite que sobrevive entre sessões, e amarra tudo num **core CLI único com
|
|
32
|
+
gates e trilha de auditoria** (`forja`, ADR-0020). Multi-IA por design (Claude, Copilot,
|
|
33
|
+
Gemini, Codex). A operação é inteiramente via CLI.
|
|
34
|
+
|
|
35
|
+
**Para quem**: o dev solo ou time pequeno que opera múltiplos produtos com IA como
|
|
36
|
+
principal força de trabalho — e precisa da disciplina de um time grande sem ter esse time.
|
|
37
|
+
|
|
38
|
+
## Os 3 pilares
|
|
39
|
+
|
|
40
|
+
| Pilar | O que entrega | Prova |
|
|
41
|
+
|---|---|---|
|
|
42
|
+
| **Memória que sobrevive** | contexto hierárquico, buscável, compartilhado entre sessões e IAs | SQLite FTS5, smart-context (ADR-0003) |
|
|
43
|
+
| **Processo que governa** | nada vira código sem spec; nada estrutural sem ADR; comandos auditados | SDD+GSD, handoffs 7 campos (ADR-0005), core `forja` (ADR-0020) |
|
|
44
|
+
| **Fábrica, não projeto único** | workspace multi-produto, times de agentes por projeto | ADR-0019, harness, codegraph (ADR-0017) |
|
|
45
|
+
|
|
46
|
+
> Este repositório é o **motor (framework)** — não hospeda aplicações em produção.
|
|
47
|
+
> Os produtos do usuário vivem no **workspace Forja** (`~/forja-workspace` por padrão), fora deste repo.
|
|
48
|
+
> Veja ADR-0019 para a rationale.
|
|
49
|
+
|
|
50
|
+
## 60 segundos de Forja
|
|
51
|
+
|
|
52
|
+
```console
|
|
53
|
+
$ forja spec:new pagamentos-pix
|
|
54
|
+
✓ Spec criada: specs/pagamentos-pix/spec.md # nada vira código sem isso
|
|
55
|
+
|
|
56
|
+
$ forja gsd:handoff plan pagamentos-pix
|
|
57
|
+
Handoff registrado: product → sdd-architect # 7 campos, auditável (ADR-0005)
|
|
58
|
+
|
|
59
|
+
$ forja code:impact processPayment
|
|
60
|
+
Mapa de impacto: processPayment (profundidade 2) # blast radius ANTES de editar
|
|
61
|
+
--- Chamadores diretos ---
|
|
62
|
+
BillingController.charge · RetryWorker.run
|
|
63
|
+
|
|
64
|
+
$ forja gsd:check pagamentos-pix
|
|
65
|
+
OK GSD runbook OK Spec directory
|
|
66
|
+
OK SDD spec check OK Codegraph
|
|
67
|
+
Resultado: gates básicos prontos. # governança executável, não checklist
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
E cada comando acima ficou gravado em `.context/forja-runs.jsonl` — quando a governança pergunta "o processo foi seguido?", a resposta é um arquivo, não uma promessa.
|
|
71
|
+
|
|
72
|
+
## Por que não só…?
|
|
73
|
+
|
|
74
|
+
| Alternativa | Onde ela para | O que a Forja acrescenta |
|
|
75
|
+
|---|---|---|
|
|
76
|
+
| **Claude Code / Copilot puros** | brilhantes na sessão, amnésicos entre sessões | memória FTS5 + processo + auditoria em volta da IA |
|
|
77
|
+
| **LangGraph / CrewAI** | infraestrutura para *construir* agentes | a camada de cima: opera o time de agentes no dia a dia |
|
|
78
|
+
| **Templates & spec kits** | param quando a spec está escrita | pipeline completo até a governança, com gates que executam |
|
|
79
|
+
|
|
80
|
+
## Capacidades-chave
|
|
81
|
+
|
|
82
|
+
- **Core CLI único** — todo comando de processo passa por `forja <comando>`: registry declarativo, gates transversais (workspace) e auditoria append-only em `.context/forja-runs.jsonl` (ADR-0020).
|
|
83
|
+
- **Orquestração multiagente** — 6 papéis (orchestrator, context-engineer, sdd-architect, product, marketing, governance) com handoffs rastreados (7 campos, ADR-0005).
|
|
84
|
+
- **Memória hierárquica** — global → domínio → tarefa → resumo, com busca FTS5 e *smart-context* em 3 modos (ADR-0003).
|
|
85
|
+
- **Pipeline SDD + GSD** — `spec → plan → tasks → check`, decisões registradas como ADRs.
|
|
86
|
+
- **Auto-verificação (invariantes que rodam)** — o framework prova a si mesmo: uma família de gates guarda cada fronteira (núcleo, tarball, coerência de doc, topologia de agentes, projeto gerado), e `check:all` roda a bateria inteira num veredito só. A governança deixa de depender de disciplina — vira harness.
|
|
87
|
+
- **Economia de token medida, não afirmada** — a memória (`context.md` como mapa) economiza ~60% vs explorar no frio, e `token:economy` **prova** isso nos seus domínios. `code:context` entrega o mapa pronto; `memory:audit` garante que ele não mente sobre o código.
|
|
88
|
+
- **Geração de projetos** — `project:new` cria scaffold completo no workspace (memória, agentes, instruções multi-IA, backend NestJS como boilerplate padrão) e registra a ficha; `project:upgrade` traz peças novas para projetos já gerados sem tocar no código do usuário.
|
|
89
|
+
- **3 capacidades integradas** (ADR-0016): **codegraph** (análise de código via MCP), **harness** (desenho de times de agentes), **ai-engineering** (base de conhecimento).
|
|
90
|
+
|
|
91
|
+
## ⚡ Quick start
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
# Instalar (o pacote é forjajs; o comando é forja)
|
|
95
|
+
npm install -g forjajs
|
|
96
|
+
forja # help agrupado por domínio
|
|
97
|
+
|
|
98
|
+
# Preparar o workspace de produção (canto fixo dos projetos)
|
|
99
|
+
forja workspace:init
|
|
100
|
+
|
|
101
|
+
# Criar um projeto novo (gera em ~/forja-workspace/projects/<nome>)
|
|
102
|
+
forja project:new meu-projeto --ai claude,copilot
|
|
103
|
+
|
|
104
|
+
# Entrar no ciclo SDD/GSD da primeira feature
|
|
105
|
+
forja spec:new minha-feature
|
|
106
|
+
forja spec:plan minha-feature
|
|
107
|
+
forja spec:tasks minha-feature
|
|
108
|
+
forja spec:check minha-feature
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### Provar autonomia supervisionada localmente
|
|
112
|
+
|
|
113
|
+
A prova offline determinística usa uma fixture externa, Git worktree real,
|
|
114
|
+
aprovação humana, `npm test` real, validação de diff, promoção, estado SQLite,
|
|
115
|
+
evidências no GraphLoop e handoff compacto:
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
npm run demo:autonomy
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
O fluxo completo está documentado em [`docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md`](docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md).
|
|
122
|
+
|
|
123
|
+
Meça o baseline determinístico de contexto e a evidência de cache:
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
npm run benchmark:context
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
O sandbox também expõe rollback explícito e auditável após promoção. Os limites
|
|
130
|
+
oficiais dos plugins `@forja/plugin-github` e `@forja/plugin-docker` estão disponíveis;
|
|
131
|
+
handlers externos de rede ou Docker precisam ser injetados e permissionados pelo host.
|
|
132
|
+
|
|
133
|
+
> Clonou o repo em vez de instalar? Os mesmos comandos rodam como
|
|
134
|
+
> `node bin/forja.ts <comando>` — os scripts npm são apenas aliases finos do core.
|
|
135
|
+
> A fonte é TypeScript e roda nativa: **dev exige Node ≥ 22.6** (strip-types). O pacote *publicado*
|
|
136
|
+
> embarca `dist/*.js` e roda em **Node ≥ 20** — o `release-gate` prova isso a cada release (SPEC-012).
|
|
137
|
+
|
|
138
|
+
Passo a passo de **criar vs atualizar** projeto: [`docs/processo-projeto.md`](docs/processo-projeto.md).
|
|
139
|
+
|
|
140
|
+
## Como funciona — o processo
|
|
141
|
+
|
|
142
|
+
```
|
|
143
|
+
💡 Demanda
|
|
144
|
+
├─ projeto NÃO existe ─► project:new + boilerplate + harness (desenha o time)
|
|
145
|
+
└─ projeto JÁ existe ──► overlay --only-memory + codegraph init (entende o código)
|
|
146
|
+
│
|
|
147
|
+
▼
|
|
148
|
+
CICLO CLI-first (docs/fluxo.md):
|
|
149
|
+
1·Entender → 2·Especificar → 3·Arquitetar → 4·Decompor → 5·Implementar → 6·Governar → ✅
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
| Etapa | Papel | Capacidade |
|
|
153
|
+
|-------|-------|------------|
|
|
154
|
+
| 1 Entender | context-engineer | codegraph · ai-engineering |
|
|
155
|
+
| 2 Especificar | product | — |
|
|
156
|
+
| 3 Arquitetar | sdd-architect | harness · ADR |
|
|
157
|
+
| 4 Decompor | sdd-architect | — |
|
|
158
|
+
| 5 Implementar | orchestrator + worker | codegraph (MCP) |
|
|
159
|
+
| 6 Governar | governance | codegraph (`affected`) |
|
|
160
|
+
|
|
161
|
+
Mapa completo do ciclo: [`docs/fluxo.md`](docs/fluxo.md).
|
|
162
|
+
|
|
163
|
+
## As 3 capacidades integradas
|
|
164
|
+
|
|
165
|
+
| Capacidade | Papel | Como usar |
|
|
166
|
+
|---|---|---|
|
|
167
|
+
| **codegraph** | análise de código (MCP local) | `forja code:index` · `codegraph explore "<área>"` · ferramentas MCP `codegraph_explore`/`codegraph_node` |
|
|
168
|
+
| **harness** | desenho de times de agentes (plugin) | na sessão Claude Code: _"build a harness for this project"_ → gera `.claude/agents` + `.claude/skills` |
|
|
169
|
+
| **ai-engineering** | base de conhecimento (referência) | ver [`docs/capacidades-externas.md`](docs/capacidades-externas.md) |
|
|
170
|
+
|
|
171
|
+
Detalhes e reinstalação: [`docs/capacidades-externas.md`](docs/capacidades-externas.md) · [ADR-0016](memory/90-decisions/0016-integracao-capacidades-externas.md).
|
|
172
|
+
|
|
173
|
+
## O core `forja`
|
|
174
|
+
|
|
175
|
+
Todos os comandos de processo passam por um único ponto de entrada (ADR-0020):
|
|
176
|
+
|
|
177
|
+
```bash
|
|
178
|
+
forja # help agrupado por domínio
|
|
179
|
+
forja <comando> [args] # no repo clonado: node bin/forja.ts <comando>
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
O core aplica **gates** antes de executar (ex.: comandos de produto falham cedo sem
|
|
183
|
+
workspace) e grava **auditoria** de cada execução (comando, args, exit code, duração)
|
|
184
|
+
em `<workspace>/.context/forja-runs.jsonl` — a trilha que a governança usa no review.
|
|
185
|
+
Os scripts npm do repo são aliases finos que roteiam pelo core.
|
|
186
|
+
|
|
187
|
+
## Comandos essenciais
|
|
188
|
+
|
|
189
|
+
```bash
|
|
190
|
+
# Workspace & projetos
|
|
191
|
+
forja workspace:init # cria ~/forja-workspace
|
|
192
|
+
forja project:new <nome> --ai claude,copilot # cria projeto no workspace
|
|
193
|
+
forja project:list # lista projetos do workspace
|
|
194
|
+
forja project:upgrade # traz peças novas de scaffold p/ um projeto (aditivo; --apply)
|
|
195
|
+
forja workspace:project:check <nome> # valida padrões num projeto do workspace
|
|
196
|
+
|
|
197
|
+
# Pipeline SDD
|
|
198
|
+
forja spec:new <slug> # também: spec:plan · spec:tasks · spec:check
|
|
199
|
+
|
|
200
|
+
# Sprint & handoffs (GSD)
|
|
201
|
+
forja sprint:start # também: sprint:status · sprint:complete
|
|
202
|
+
forja gsd:plan <slug> # runbook GSD em .context/
|
|
203
|
+
forja gsd:handoff <intent> <slug> # handoff entre papéis (ADR-0005)
|
|
204
|
+
forja gsd:check <slug> # gates básicos do runbook
|
|
205
|
+
forja orchestrate "<objetivo>" --slug <s> # abre a corrida: a cadeia SDD/GSD como máquina de estados (SPEC-021)
|
|
206
|
+
forja orchestrate:status <slug> # o estado da máquina: etapas, gates, vereditos
|
|
207
|
+
forja orchestrate:advance <slug> # roda o gate da etapa; verde → próxima; vermelho → trava
|
|
208
|
+
|
|
209
|
+
# Análise de código (codegraph)
|
|
210
|
+
forja code:check # índice confiável (worktree + freshness)
|
|
211
|
+
forja code:impact <símbolo> # chamadores + blast radius antes de editar
|
|
212
|
+
forja code:context <domínio> # pacote de contexto mínimo (o mapa; --code p/ o código)
|
|
213
|
+
forja code:query "<termo>" # também: code:index · code:sync · code:status
|
|
214
|
+
|
|
215
|
+
# Memória & contexto (workspace)
|
|
216
|
+
forja sync:universal # reindexa SQLite FTS5 do workspace
|
|
217
|
+
forja query:universal "<query>" # busca FTS5
|
|
218
|
+
forja context:smart # smart-context (3 modos, ADR-0003)
|
|
219
|
+
forja token:economy [--project <path>] # economia de token; --project mede seus domínios reais (ADR-0009)
|
|
220
|
+
forja memory:compress # arquiva runs antigos + VACUUM
|
|
221
|
+
forja memory:extract # extrai conhecimento global da memória
|
|
222
|
+
forja memory:audit # coerência mapa↔código: mapa não mente + módulo sem mapa (SPEC-017)
|
|
223
|
+
|
|
224
|
+
# Qualidade & release
|
|
225
|
+
forja project:check # standards do framework (pre-commit)
|
|
226
|
+
forja tools:doctor # raio-x do núcleo; separa permissão/lock de corrupção; exit 1 se quebrou
|
|
227
|
+
forja release:check --publish # gate do tarball antes de publicar
|
|
228
|
+
forja project:smoke # gate do projeto gerado; --full instala e builda o backend
|
|
229
|
+
forja check:all # a bateria inteira de gates, um veredito; --full inclui os caros (SPEC-020)
|
|
230
|
+
forja project:dashboard # relatório estático de status
|
|
231
|
+
|
|
232
|
+
# Governança & auditoria
|
|
233
|
+
forja audit:sync # projeta a trilha de auditoria numa tabela consultável
|
|
234
|
+
forja audit:query --failed # consulta: --failed, --cmd <x>, --since 7d
|
|
235
|
+
forja governance:dashboard # painel HTML estático (gates, SDD, auditoria) — sem servidor
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
## Separação framework × workspace
|
|
239
|
+
|
|
240
|
+
O Forja é dividido em duas partes:
|
|
241
|
+
|
|
242
|
+
1. **Framework** (este repositório): motor, convenções, scripts e memória do próprio framework.
|
|
243
|
+
2. **Workspace** (`~/forja-workspace` por padrão): "canto fixo" onde vivem os projetos de produto, a memória universal deles e as specs de produto.
|
|
244
|
+
|
|
245
|
+
O caminho do workspace é resolvido por prioridade:
|
|
246
|
+
|
|
247
|
+
1. Variável de ambiente `FORJA_WORKSPACE`
|
|
248
|
+
2. Campo `workspaceRoot` em `~/.forjarc.json`
|
|
249
|
+
3. Padrão: `~/forja-workspace`
|
|
250
|
+
|
|
251
|
+
Veja ADR-0019 para a decisão arquitetural.
|
|
252
|
+
|
|
253
|
+
## Estrutura do repositório (framework)
|
|
254
|
+
|
|
255
|
+
```
|
|
256
|
+
bin/ CLIs (forja — o core; init-project, create-memory-nest-kit)
|
|
257
|
+
lib/ Módulos reutilizáveis; lib/core/ é o motor de invariantes (registry, checks, health, release, doc-graph, gates)
|
|
258
|
+
scripts/ Automação (sprint-manager, agent-router, sync-universal-memory, …)
|
|
259
|
+
specs/ Pipeline SDD do próprio framework (spec → plan → tasks)
|
|
260
|
+
boilerplates/ Templates de stack (api-rest, saas, ecommerce, microservices, monorepo)
|
|
261
|
+
memory/ Memória do framework (00-global … 90-decisions/ADRs)
|
|
262
|
+
docs/ Documentação por persona e por tópico (ver DOC-MAP.md)
|
|
263
|
+
prompts/ Prompts portáteis dos 6 papéis
|
|
264
|
+
.claude/ Sub-agents e settings do Claude Code
|
|
265
|
+
projects/ LEGADO — não usar; projetos vivem no workspace externo
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
## Estrutura do workspace
|
|
269
|
+
|
|
270
|
+
```
|
|
271
|
+
~/forja-workspace/
|
|
272
|
+
projects/ # produtos gerados
|
|
273
|
+
memory/
|
|
274
|
+
sqlite/universal.db # SQLite FTS5 dos produtos
|
|
275
|
+
30-projects/ # fichas dos projetos
|
|
276
|
+
specs/ # specs de produto
|
|
277
|
+
.context/ # runbooks GSD de produto
|
|
278
|
+
README.md
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
## Documentação
|
|
282
|
+
|
|
283
|
+
- [`DOC-MAP.md`](DOC-MAP.md) — mapa por papel e por tópico (comece aqui)
|
|
284
|
+
- [`docs/processo-projeto.md`](docs/processo-projeto.md) — criar vs atualizar projeto
|
|
285
|
+
- [`docs/fluxo.md`](docs/fluxo.md) — mapa do ciclo CLI-first
|
|
286
|
+
- [`AGENTS.md`](AGENTS.md) — os 6 papéis e a topologia
|
|
287
|
+
- [`memory/90-decisions/`](memory/90-decisions/) — ADRs com rationale
|
|
288
|
+
- [`CHANGELOG.md`](CHANGELOG.md) — histórico
|
|
289
|
+
|
|
290
|
+
## Convenções
|
|
291
|
+
|
|
292
|
+
- **CLI-first** — sprints, SDD, GSD, handoffs e governança por comando; o front nunca é gate.
|
|
293
|
+
- **ADRs** — toda decisão estrutural vira `memory/90-decisions/NNNN-titulo.md`.
|
|
294
|
+
- **Handoffs** — 7 campos obrigatórios (ADR-0005), gravados no SQLite (ADR-0008).
|
|
295
|
+
- **pt-BR** — comunicação e documentação em português.
|
|
296
|
+
|
|
297
|
+
## Roadmap
|
|
298
|
+
|
|
299
|
+
O fio condutor: **converter conhecimento que vive em convenção em invariante executável.** Cada
|
|
300
|
+
item abaixo ou fecha uma fronteira do framework por um gate, ou leva esse padrão para os projetos
|
|
301
|
+
gerados.
|
|
302
|
+
|
|
303
|
+
**Entregue** (até v1.6.0)
|
|
304
|
+
|
|
305
|
+
- [x] **Família de gates** — cada fronteira do framework guarda por um invariante que roda: núcleo
|
|
306
|
+
(`tools:doctor`, ADR-0023), tarball (`release:check`, ADR-0024), coerência de doc + ADRs + topologia
|
|
307
|
+
de agentes (ADR-0025, SPEC-019), projeto gerado (`project:smoke`, ADR-0029). E `check:all` reúne a
|
|
308
|
+
bateria num veredito (SPEC-020).
|
|
309
|
+
- [x] **Migração TypeScript completa** — fonte 100% `.ts`, publica `dist/`, `noImplicitAny` ON. Achou
|
|
310
|
+
bugs latentes que nenhum teste pegava (SPEC-012).
|
|
311
|
+
- [x] **Economia de memória como sistema** — **medida** (`token:economy` prova ~60% vs frio),
|
|
312
|
+
**entregue** (`code:context`), **protegida** (`memory:audit`, nas duas direções) e **propagada**: o
|
|
313
|
+
projeto gerado herda o gate dos mapas (ADR-0030).
|
|
314
|
+
- [x] **`project:upgrade`** — atualizar um projeto já gerado sem perder código: aditivo, nunca
|
|
315
|
+
sobrescreve (SPEC-018).
|
|
316
|
+
- [x] **Clean Architecture calibrado** — camadas onde se pagam, enxuto onde não; e a claim de token
|
|
317
|
+
**medida e corrigida** — a economia é da memória, não das camadas (ADR-0027).
|
|
318
|
+
|
|
319
|
+
**Próximos passos** (por dependência, não por desejo)
|
|
320
|
+
|
|
321
|
+
- [x] **`builds` do backend gerado sob toolchain novo** — o template alinhou o `better-sqlite3` ao
|
|
322
|
+
do framework (^12, com prebuilds); o `check:all --full` compila o backend gerado em Node 26.
|
|
323
|
+
- [x] **`release-auditor` consome o gate** — o agente executa e julga `release:check --publish`
|
|
324
|
+
(ADR-0024), incluindo o `consumer-spec-new`; não reimplementa o procedimento.
|
|
325
|
+
- [ ] **Boilerplates além de NestJS** — o processo é agnóstico de stack; os templates vão atrás.
|
|
326
|
+
- [ ] **(visão) o motor de orquestração** — a cadeia de handoffs que **roda**, não só é coerente
|
|
327
|
+
(SPEC-019 deixou como futuro). O namesake executando: candidato ao 2.0.
|
|
328
|
+
|
|
329
|
+
Sugestões? Abra uma issue — feature não-trivial aqui começa por spec, inclusive as suas.
|
|
330
|
+
|
|
331
|
+
## English
|
|
332
|
+
|
|
333
|
+
Full English version: **[README.md](README.md)**. In short — **Forja** turns coding AI into an
|
|
334
|
+
engineering team with process and memory: every project starts from a spec, every structural
|
|
335
|
+
decision becomes an ADR, and nothing is lost between sessions. Documentation is in Brazilian
|
|
336
|
+
Portuguese — that's part of the project's identity; the CLI and the code are readable regardless.
|
|
337
|
+
|
|
338
|
+
---
|
|
339
|
+
|
|
340
|
+
<p align="center">
|
|
341
|
+
<strong>A Forja te ajudou a domar seus agentes?</strong><br>
|
|
342
|
+
Uma ⭐ é o que faz o projeto chegar a mais devs que estão pagando o imposto da IA amnésica.
|
|
343
|
+
</p>
|
|
344
|
+
|
|
345
|
+
<p align="center"><sub>Forja (npm: <code>forjajs</code>) · MIT License · <a href="CONTRIBUTING.md">Contribuindo</a></sub></p>
|