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
|
@@ -1,72 +1,72 @@
|
|
|
1
|
-
# ForjaJS 2.0 — Visão
|
|
2
|
-
|
|
3
|
-
## Problema
|
|
4
|
-
|
|
5
|
-
Agentes de desenvolvimento conseguem editar código, mas não mantêm memória verificável,
|
|
6
|
-
limites de autonomia, contexto econômico ou uma trilha uniforme de decisão. O ForjaJS 1.x
|
|
7
|
-
resolve parte disso como CLI; a 2.0 transforma essas capacidades em contratos e serviços
|
|
8
|
-
programáveis, preservando a operação CLI-first.
|
|
9
|
-
|
|
10
|
-
## Usuário principal e casos de uso
|
|
11
|
-
|
|
12
|
-
O usuário principal é o desenvolvedor solo ou time pequeno que opera um ou mais repositórios
|
|
13
|
-
com agentes. Casos prioritários:
|
|
14
|
-
|
|
15
|
-
- descobrir e executar uma capability com entrada e saída validadas;
|
|
16
|
-
- executar uma tarefa supervisionada, pausá-la e retomá-la com checkpoint;
|
|
17
|
-
- entregar contexto mínimo baseado em memória, grafo, evidência e orçamento;
|
|
18
|
-
- bloquear escrita, rede ou ações destrutivas por política;
|
|
19
|
-
- revisar um resultado com evidências independentes antes de marcar a tarefa concluída;
|
|
20
|
-
- consumir o mesmo núcleo pela CLI, SDK, MCP, worker e backend.
|
|
21
|
-
|
|
22
|
-
## Proposta de valor verificável
|
|
23
|
-
|
|
24
|
-
ForjaJS 2.0 é uma plataforma local-first para memória, contexto, execução, governança e
|
|
25
|
-
autonomia de agentes de desenvolvimento. A promessa é limitada às seguintes provas:
|
|
26
|
-
|
|
27
|
-
| Promessa | Prova esperada |
|
|
28
|
-
| --- | --- |
|
|
29
|
-
| Ações descobríveis | registry versionado e introspectável |
|
|
30
|
-
| Autonomia limitada | decisão de política, aprovação, orçamento e sandbox por execução |
|
|
31
|
-
| Memória confiável | evidência, validade temporal e status de conhecimento |
|
|
32
|
-
| Contexto econômico | refs, checksums, cache e métricas de tokens |
|
|
33
|
-
| Falsa conclusão bloqueada | validator independente com resultado estruturado |
|
|
34
|
-
|
|
35
|
-
## Diferenciação técnica
|
|
36
|
-
|
|
37
|
-
CLIs de agentes normalmente são superfícies de comando; frameworks de agentes normalmente
|
|
38
|
-
orquestram loops; ferramentas de memória normalmente não governam execução. O Forja combina
|
|
39
|
-
essas três preocupações em um núcleo de domínio independente de framework, com adapters para
|
|
40
|
-
CLI, MCP, REST, SQLite e NestJS. GraphLoop é o grafo verificável de trabalho e contexto; não
|
|
41
|
-
é apenas um índice de símbolos.
|
|
42
|
-
|
|
43
|
-
## Princípios
|
|
44
|
-
|
|
45
|
-
1. local-first e offline por padrão;
|
|
46
|
-
2. domínio independente de NestJS, Next.js, transporte e persistência;
|
|
47
|
-
3. contratos versionados, validação na entrada e resultados auditáveis;
|
|
48
|
-
4. determinismo antes de LLM;
|
|
49
|
-
5. autonomia supervisionada por padrão;
|
|
50
|
-
6. contexto mínimo suficiente e orçamento explícito;
|
|
51
|
-
7. migração 1.x aditiva e não destrutiva;
|
|
52
|
-
8. evidência separada de afirmação e hipótese.
|
|
53
|
-
|
|
54
|
-
## Fora do escopo da 2.0 inicial
|
|
55
|
-
|
|
56
|
-
Hospedagem multi-tenant, execução remota obrigatória, dependência de um provedor de LLM,
|
|
57
|
-
treinamento de modelos, substituição de Git, IDE própria, sincronização em nuvem obrigatória
|
|
58
|
-
e dashboard como requisito para operar o produto.
|
|
59
|
-
|
|
60
|
-
## Sucesso e métricas
|
|
61
|
-
|
|
62
|
-
O release candidate deve demonstrar: uma IA descobre uma capability sem documentação humana,
|
|
63
|
-
executa uma tarefa supervisionada, pausa/retoma, é bloqueada por política e não conclui sem
|
|
64
|
-
validação. Métricas mínimas: taxa de execuções auditadas, taxa de bloqueios corretos, taxa de
|
|
65
|
-
retomada, tokens por tarefa, cache hit rate, retrabalho, afirmações sem evidência e falhas de
|
|
66
|
-
validator.
|
|
67
|
-
|
|
68
|
-
## Estratégia de entrega
|
|
69
|
-
|
|
70
|
-
A 2.0 será incremental: primeiro contratos e registry; depois runtime controlado, policy,
|
|
71
|
-
sprint/task/handoff, MCP/Nest, GraphLoop/contexto, autonomia, multiagente, dashboard e plugins.
|
|
72
|
-
O ForjaJS 1.x continua sendo a superfície CLI compatível durante a migração.
|
|
1
|
+
# ForjaJS 2.0 — Visão
|
|
2
|
+
|
|
3
|
+
## Problema
|
|
4
|
+
|
|
5
|
+
Agentes de desenvolvimento conseguem editar código, mas não mantêm memória verificável,
|
|
6
|
+
limites de autonomia, contexto econômico ou uma trilha uniforme de decisão. O ForjaJS 1.x
|
|
7
|
+
resolve parte disso como CLI; a 2.0 transforma essas capacidades em contratos e serviços
|
|
8
|
+
programáveis, preservando a operação CLI-first.
|
|
9
|
+
|
|
10
|
+
## Usuário principal e casos de uso
|
|
11
|
+
|
|
12
|
+
O usuário principal é o desenvolvedor solo ou time pequeno que opera um ou mais repositórios
|
|
13
|
+
com agentes. Casos prioritários:
|
|
14
|
+
|
|
15
|
+
- descobrir e executar uma capability com entrada e saída validadas;
|
|
16
|
+
- executar uma tarefa supervisionada, pausá-la e retomá-la com checkpoint;
|
|
17
|
+
- entregar contexto mínimo baseado em memória, grafo, evidência e orçamento;
|
|
18
|
+
- bloquear escrita, rede ou ações destrutivas por política;
|
|
19
|
+
- revisar um resultado com evidências independentes antes de marcar a tarefa concluída;
|
|
20
|
+
- consumir o mesmo núcleo pela CLI, SDK, MCP, worker e backend.
|
|
21
|
+
|
|
22
|
+
## Proposta de valor verificável
|
|
23
|
+
|
|
24
|
+
ForjaJS 2.0 é uma plataforma local-first para memória, contexto, execução, governança e
|
|
25
|
+
autonomia de agentes de desenvolvimento. A promessa é limitada às seguintes provas:
|
|
26
|
+
|
|
27
|
+
| Promessa | Prova esperada |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| Ações descobríveis | registry versionado e introspectável |
|
|
30
|
+
| Autonomia limitada | decisão de política, aprovação, orçamento e sandbox por execução |
|
|
31
|
+
| Memória confiável | evidência, validade temporal e status de conhecimento |
|
|
32
|
+
| Contexto econômico | refs, checksums, cache e métricas de tokens |
|
|
33
|
+
| Falsa conclusão bloqueada | validator independente com resultado estruturado |
|
|
34
|
+
|
|
35
|
+
## Diferenciação técnica
|
|
36
|
+
|
|
37
|
+
CLIs de agentes normalmente são superfícies de comando; frameworks de agentes normalmente
|
|
38
|
+
orquestram loops; ferramentas de memória normalmente não governam execução. O Forja combina
|
|
39
|
+
essas três preocupações em um núcleo de domínio independente de framework, com adapters para
|
|
40
|
+
CLI, MCP, REST, SQLite e NestJS. GraphLoop é o grafo verificável de trabalho e contexto; não
|
|
41
|
+
é apenas um índice de símbolos.
|
|
42
|
+
|
|
43
|
+
## Princípios
|
|
44
|
+
|
|
45
|
+
1. local-first e offline por padrão;
|
|
46
|
+
2. domínio independente de NestJS, Next.js, transporte e persistência;
|
|
47
|
+
3. contratos versionados, validação na entrada e resultados auditáveis;
|
|
48
|
+
4. determinismo antes de LLM;
|
|
49
|
+
5. autonomia supervisionada por padrão;
|
|
50
|
+
6. contexto mínimo suficiente e orçamento explícito;
|
|
51
|
+
7. migração 1.x aditiva e não destrutiva;
|
|
52
|
+
8. evidência separada de afirmação e hipótese.
|
|
53
|
+
|
|
54
|
+
## Fora do escopo da 2.0 inicial
|
|
55
|
+
|
|
56
|
+
Hospedagem multi-tenant, execução remota obrigatória, dependência de um provedor de LLM,
|
|
57
|
+
treinamento de modelos, substituição de Git, IDE própria, sincronização em nuvem obrigatória
|
|
58
|
+
e dashboard como requisito para operar o produto.
|
|
59
|
+
|
|
60
|
+
## Sucesso e métricas
|
|
61
|
+
|
|
62
|
+
O release candidate deve demonstrar: uma IA descobre uma capability sem documentação humana,
|
|
63
|
+
executa uma tarefa supervisionada, pausa/retoma, é bloqueada por política e não conclui sem
|
|
64
|
+
validação. Métricas mínimas: taxa de execuções auditadas, taxa de bloqueios corretos, taxa de
|
|
65
|
+
retomada, tokens por tarefa, cache hit rate, retrabalho, afirmações sem evidência e falhas de
|
|
66
|
+
validator.
|
|
67
|
+
|
|
68
|
+
## Estratégia de entrega
|
|
69
|
+
|
|
70
|
+
A 2.0 será incremental: primeiro contratos e registry; depois runtime controlado, policy,
|
|
71
|
+
sprint/task/handoff, MCP/Nest, GraphLoop/contexto, autonomia, multiagente, dashboard e plugins.
|
|
72
|
+
O ForjaJS 1.x continua sendo a superfície CLI compatível durante a migração.
|
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
# Missão Universal: Projeto Agentes
|
|
2
|
-
|
|
3
|
-
## Propósito
|
|
4
|
-
Criar um ecossistema de agentes orquestrados, independentes de LLM, com memória persistente e universal para acelerar o desenvolvimento de produtos escaláveis.
|
|
5
|
-
|
|
6
|
-
## Objetivos
|
|
7
|
-
1. **Independência de LLM**: Funcionar com Gemini, Claude, OpenAI, etc.
|
|
8
|
-
2. **Memória Universal**: Banco de dados SQLite central que indexa documentação de todos os projetos.
|
|
9
|
-
3. **Escalabilidade**: Camadas de metodologia para crescimento do produto (Growth, Scaling).
|
|
10
|
-
4. **Isolamento**: Projetos gerados são isolados e não poluem o repositório principal.
|
|
11
|
-
|
|
12
|
-
## Pilares
|
|
13
|
-
- **Memória Hierárquica**: Global -> Projeto -> Domínio -> Tarefa.
|
|
14
|
-
- **Orquestração**: Divisão clara de papéis e responsabilidades.
|
|
15
|
-
- **Continuidade**: Handoffs que preservam o contexto entre sessões e agentes.
|
|
1
|
+
# Missão Universal: Projeto Agentes
|
|
2
|
+
|
|
3
|
+
## Propósito
|
|
4
|
+
Criar um ecossistema de agentes orquestrados, independentes de LLM, com memória persistente e universal para acelerar o desenvolvimento de produtos escaláveis.
|
|
5
|
+
|
|
6
|
+
## Objetivos
|
|
7
|
+
1. **Independência de LLM**: Funcionar com Gemini, Claude, OpenAI, etc.
|
|
8
|
+
2. **Memória Universal**: Banco de dados SQLite central que indexa documentação de todos os projetos.
|
|
9
|
+
3. **Escalabilidade**: Camadas de metodologia para crescimento do produto (Growth, Scaling).
|
|
10
|
+
4. **Isolamento**: Projetos gerados são isolados e não poluem o repositório principal.
|
|
11
|
+
|
|
12
|
+
## Pilares
|
|
13
|
+
- **Memória Hierárquica**: Global -> Projeto -> Domínio -> Tarefa.
|
|
14
|
+
- **Orquestração**: Divisão clara de papéis e responsabilidades.
|
|
15
|
+
- **Continuidade**: Handoffs que preservam o contexto entre sessões e agentes.
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# Base de Conhecimento Compartilhada (Patterns)
|
|
2
|
-
|
|
3
|
-
> Preenchida via Cross-Project Analysis (`npm run memory:extract`): padrões que se
|
|
4
|
-
> repetem em 2+ projetos do workspace são promovidos para cá, **sem dados de
|
|
5
|
-
> produto** — apenas o padrão generalizado.
|
|
6
|
-
|
|
7
|
-
Nenhum padrão promovido ainda nesta instalação. Conhecimento específico de cada
|
|
8
|
-
produto vive na ficha do projeto em `<workspace>/memory/30-projects/`.
|
|
1
|
+
# Base de Conhecimento Compartilhada (Patterns)
|
|
2
|
+
|
|
3
|
+
> Preenchida via Cross-Project Analysis (`npm run memory:extract`): padrões que se
|
|
4
|
+
> repetem em 2+ projetos do workspace são promovidos para cá, **sem dados de
|
|
5
|
+
> produto** — apenas o padrão generalizado.
|
|
6
|
+
|
|
7
|
+
Nenhum padrão promovido ainda nesta instalação. Conhecimento específico de cada
|
|
8
|
+
produto vive na ficha do projeto em `<workspace>/memory/30-projects/`.
|
|
@@ -1,47 +1,47 @@
|
|
|
1
|
-
# Padrões Globais de Engenharia e Crescimento
|
|
2
|
-
|
|
3
|
-
## Camada de Metodologia Ágil (Agile)
|
|
4
|
-
- **Sprints**: Ciclos de 1 a 2 semanas focados em entregas de valor.
|
|
5
|
-
- **Backlog**: Única fonte de verdade para futuras implementações.
|
|
6
|
-
- **Current Sprint**: Itens em execução imediata. Cada item deve ter um `owner_agent`.
|
|
7
|
-
- **Handoffs**: Obrigatórios após cada subtarefa para manter a continuidade.
|
|
8
|
-
|
|
9
|
-
## Camada de Crescimento (Growth - AARRR)
|
|
10
|
-
Todo projeto deve mapear e otimizar o funil:
|
|
11
|
-
1. **Aquisição**: Como o usuário chega (SEO, Ads, APIs).
|
|
12
|
-
2. **Ativação**: Primeira experiência de valor (Onboarding).
|
|
13
|
-
3. **Retenção**: Uso contínuo (Engajamento, Notificações).
|
|
14
|
-
4. **Receita**: Monetização (Abacate Pay, Assinaturas).
|
|
15
|
-
5. **Recomendação**: Viralidade e indicações.
|
|
16
|
-
|
|
17
|
-
## Camada de Escalonamento (Scaling - 12-Factor)
|
|
18
|
-
Padrões para aplicações modernas e resilientes:
|
|
19
|
-
- **Codebase**: Um repositório, múltiplos deploys.
|
|
20
|
-
- **Dependencies**: Declaradas e isoladas explicitamente.
|
|
21
|
-
- **Config**: Armazenada no ambiente (Environment variables).
|
|
22
|
-
- **Backing Services**: Tratados como recursos anexados.
|
|
23
|
-
- **Stateless**: Processos devem ser sem estado e compartilhar nada.
|
|
24
|
-
|
|
25
|
-
## Camada de Produto (Product Discovery)
|
|
26
|
-
Protocolo mandatório para o **Agente de Produto**:
|
|
27
|
-
- **Definição de Problema**: Antes de qualquer feature, o problema deve ser explicitado.
|
|
28
|
-
- **Métricas de Sucesso**: Como mediremos se a feature foi bem-sucedida?
|
|
29
|
-
- **Documentação**: Atualização obrigatória de `memory/10-product/business-rules.md`.
|
|
30
|
-
|
|
31
|
-
## Camada de Marketing e Growth (AARRR Metrics)
|
|
32
|
-
Protocolo para o **Agente de Marketing**:
|
|
33
|
-
- **SEO & Copy**: Todo projeto deve ter uma estratégia de conteúdo técnico.
|
|
34
|
-
- **Loops de Viralidade**: Identificar mecanismos de indicação e compartilhamento (Recomendação).
|
|
35
|
-
- **Ativação**: O "Aha! Moment" do usuário deve ser o foco do primeiro deploy.
|
|
36
|
-
|
|
37
|
-
## Camada de Governança e Compliance
|
|
38
|
-
Protocolo para o **Agente de Governança**:
|
|
39
|
-
- **Auditoria de Decisão**: Nenhuma mudança arquitetural sem `ADR`.
|
|
40
|
-
- **Privacidade by Design**: Verificação de vazamento de PII em logs e tabelas.
|
|
41
|
-
- **Qualidade de Handoff**: O score de maturidade (`project:check`) deve ser mantido acima de 80%.
|
|
42
|
-
|
|
43
|
-
## Qualidade de Código (Clean Code)
|
|
44
|
-
...
|
|
45
|
-
- **SOLID**: Princípios fundamentais em toda implementação.
|
|
46
|
-
- **Surgical Changes**: Evitar refatorações globais em tarefas de feature.
|
|
47
|
-
- **Test-First**: Priorizar a criação de testes antes da implementação final.
|
|
1
|
+
# Padrões Globais de Engenharia e Crescimento
|
|
2
|
+
|
|
3
|
+
## Camada de Metodologia Ágil (Agile)
|
|
4
|
+
- **Sprints**: Ciclos de 1 a 2 semanas focados em entregas de valor.
|
|
5
|
+
- **Backlog**: Única fonte de verdade para futuras implementações.
|
|
6
|
+
- **Current Sprint**: Itens em execução imediata. Cada item deve ter um `owner_agent`.
|
|
7
|
+
- **Handoffs**: Obrigatórios após cada subtarefa para manter a continuidade.
|
|
8
|
+
|
|
9
|
+
## Camada de Crescimento (Growth - AARRR)
|
|
10
|
+
Todo projeto deve mapear e otimizar o funil:
|
|
11
|
+
1. **Aquisição**: Como o usuário chega (SEO, Ads, APIs).
|
|
12
|
+
2. **Ativação**: Primeira experiência de valor (Onboarding).
|
|
13
|
+
3. **Retenção**: Uso contínuo (Engajamento, Notificações).
|
|
14
|
+
4. **Receita**: Monetização (Abacate Pay, Assinaturas).
|
|
15
|
+
5. **Recomendação**: Viralidade e indicações.
|
|
16
|
+
|
|
17
|
+
## Camada de Escalonamento (Scaling - 12-Factor)
|
|
18
|
+
Padrões para aplicações modernas e resilientes:
|
|
19
|
+
- **Codebase**: Um repositório, múltiplos deploys.
|
|
20
|
+
- **Dependencies**: Declaradas e isoladas explicitamente.
|
|
21
|
+
- **Config**: Armazenada no ambiente (Environment variables).
|
|
22
|
+
- **Backing Services**: Tratados como recursos anexados.
|
|
23
|
+
- **Stateless**: Processos devem ser sem estado e compartilhar nada.
|
|
24
|
+
|
|
25
|
+
## Camada de Produto (Product Discovery)
|
|
26
|
+
Protocolo mandatório para o **Agente de Produto**:
|
|
27
|
+
- **Definição de Problema**: Antes de qualquer feature, o problema deve ser explicitado.
|
|
28
|
+
- **Métricas de Sucesso**: Como mediremos se a feature foi bem-sucedida?
|
|
29
|
+
- **Documentação**: Atualização obrigatória de `memory/10-product/business-rules.md`.
|
|
30
|
+
|
|
31
|
+
## Camada de Marketing e Growth (AARRR Metrics)
|
|
32
|
+
Protocolo para o **Agente de Marketing**:
|
|
33
|
+
- **SEO & Copy**: Todo projeto deve ter uma estratégia de conteúdo técnico.
|
|
34
|
+
- **Loops de Viralidade**: Identificar mecanismos de indicação e compartilhamento (Recomendação).
|
|
35
|
+
- **Ativação**: O "Aha! Moment" do usuário deve ser o foco do primeiro deploy.
|
|
36
|
+
|
|
37
|
+
## Camada de Governança e Compliance
|
|
38
|
+
Protocolo para o **Agente de Governança**:
|
|
39
|
+
- **Auditoria de Decisão**: Nenhuma mudança arquitetural sem `ADR`.
|
|
40
|
+
- **Privacidade by Design**: Verificação de vazamento de PII em logs e tabelas.
|
|
41
|
+
- **Qualidade de Handoff**: O score de maturidade (`project:check`) deve ser mantido acima de 80%.
|
|
42
|
+
|
|
43
|
+
## Qualidade de Código (Clean Code)
|
|
44
|
+
...
|
|
45
|
+
- **SOLID**: Princípios fundamentais em toda implementação.
|
|
46
|
+
- **Surgical Changes**: Evitar refatorações globais em tarefas de feature.
|
|
47
|
+
- **Test-First**: Priorizar a criação de testes antes da implementação final.
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# Personas — Forja
|
|
2
|
-
|
|
3
|
-
## 1. Dev solo multi-produto (persona primária)
|
|
4
|
-
|
|
5
|
-
- **Contexto**: opera 2–10 produtos simultaneamente usando IA como principal força de trabalho; não tem PM, arquiteto nem QA dedicados.
|
|
6
|
-
- **Dores**: cada sessão de IA recomeça do zero; decisões evaporam; contexto de um produto vaza no outro; disciplina de processo depende só da própria memória.
|
|
7
|
-
- **Ganhos esperados**: retomar qualquer produto em minutos (memória + smart-context), decisões rastreadas (ADRs), pipeline que impede código sem spec, trilha de auditoria do que rodou (core, ADR-0020).
|
|
8
|
-
|
|
9
|
-
## 2. Time pequeno com IA intensiva (persona secundária)
|
|
10
|
-
|
|
11
|
-
- **Contexto**: 2–5 pessoas compartilhando agentes e convenções; múltiplas IAs no mesmo repo (Claude, Copilot, Gemini, Codex).
|
|
12
|
-
- **Dores**: cada pessoa opera a IA de um jeito; handoffs informais; retrabalho por falta de fonte única de decisão.
|
|
13
|
-
- **Ganhos esperados**: papéis e handoffs padronizados (7 campos), memória universal compartilhada, gates de governança iguais para todos.
|
|
14
|
-
|
|
15
|
-
## 3. Operador de agentes ("agent wrangler")
|
|
16
|
-
|
|
17
|
-
- **Contexto**: desenha e roda times de agentes por projeto (harness); trata a IA como equipe, não como autocomplete.
|
|
18
|
-
- **Dores**: sem topologia clara, agentes pisam um no outro; sem gates, entregam código não verificável.
|
|
19
|
-
- **Ganhos esperados**: topologia de 6 papéis pronta, codegraph como gate de impacto, runbooks GSD verificáveis por comando.
|
|
20
|
-
|
|
21
|
-
> Personas de produtos gerados vivem na ficha de cada projeto no workspace, não aqui.
|
|
1
|
+
# Personas — Forja
|
|
2
|
+
|
|
3
|
+
## 1. Dev solo multi-produto (persona primária)
|
|
4
|
+
|
|
5
|
+
- **Contexto**: opera 2–10 produtos simultaneamente usando IA como principal força de trabalho; não tem PM, arquiteto nem QA dedicados.
|
|
6
|
+
- **Dores**: cada sessão de IA recomeça do zero; decisões evaporam; contexto de um produto vaza no outro; disciplina de processo depende só da própria memória.
|
|
7
|
+
- **Ganhos esperados**: retomar qualquer produto em minutos (memória + smart-context), decisões rastreadas (ADRs), pipeline que impede código sem spec, trilha de auditoria do que rodou (core, ADR-0020).
|
|
8
|
+
|
|
9
|
+
## 2. Time pequeno com IA intensiva (persona secundária)
|
|
10
|
+
|
|
11
|
+
- **Contexto**: 2–5 pessoas compartilhando agentes e convenções; múltiplas IAs no mesmo repo (Claude, Copilot, Gemini, Codex).
|
|
12
|
+
- **Dores**: cada pessoa opera a IA de um jeito; handoffs informais; retrabalho por falta de fonte única de decisão.
|
|
13
|
+
- **Ganhos esperados**: papéis e handoffs padronizados (7 campos), memória universal compartilhada, gates de governança iguais para todos.
|
|
14
|
+
|
|
15
|
+
## 3. Operador de agentes ("agent wrangler")
|
|
16
|
+
|
|
17
|
+
- **Contexto**: desenha e roda times de agentes por projeto (harness); trata a IA como equipe, não como autocomplete.
|
|
18
|
+
- **Dores**: sem topologia clara, agentes pisam um no outro; sem gates, entregam código não verificável.
|
|
19
|
+
- **Ganhos esperados**: topologia de 6 papéis pronta, codegraph como gate de impacto, runbooks GSD verificáveis por comando.
|
|
20
|
+
|
|
21
|
+
> Personas de produtos gerados vivem na ficha de cada projeto no workspace, não aqui.
|
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
# Visão de Produto — Forja
|
|
2
|
-
|
|
3
|
-
> A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.
|
|
4
|
-
|
|
5
|
-
## O problema (o inimigo)
|
|
6
|
-
|
|
7
|
-
Agentes de IA são amnésicos e indisciplinados. Cada sessão recomeça do zero, decisões de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao mesmo tempo paga esse imposto multiplicado por N. Um assistente brilhante sem processo produz velocidade sem direção.
|
|
8
|
-
|
|
9
|
-
## A aposta
|
|
10
|
-
|
|
11
|
-
O diferencial durável não é o modelo (commodity que melhora sozinho), é o que fica em volta dele:
|
|
12
|
-
|
|
13
|
-
1. **Memória que sobrevive** — contexto hierárquico, buscável (SQLite FTS5), compartilhado entre sessões e entre IAs (ADR-0001/0002/0003).
|
|
14
|
-
2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs auditáveis de 7 campos (ADR-0005); comandos passam por um core único com gates e trilha de auditoria (ADR-0020).
|
|
15
|
-
3. **Fábrica, não projeto único** — workspace multi-produto com canto fixo (ADR-0019), times de agentes desenhados por projeto (harness), code intelligence como gate (ADR-0017).
|
|
16
|
-
|
|
17
|
-
## Posicionamento
|
|
18
|
-
|
|
19
|
-
- **Claude Code sozinho** é um engenheiro brilhante e amnésico; a Forja é o estúdio em volta dele.
|
|
20
|
-
- **Frameworks de agentes** (LangGraph etc.) são infraestrutura para *construir* agentes; a Forja é a camada de cima — o sistema operacional do estúdio de software de uma pessoa só.
|
|
21
|
-
- **Multi-IA por design** (Claude, Copilot, Gemini, Codex): nenhum vendor entrega isso, e a memória/processo não fica refém de um fornecedor.
|
|
22
|
-
|
|
23
|
-
A stack gerada (NestJS hoje) é **um boilerplate entre vários** — a identidade da Forja é o processo + a memória, não o framework de backend.
|
|
24
|
-
|
|
25
|
-
## Métrica-norte
|
|
26
|
-
|
|
27
|
-
Tempo entre "ideia" e "primeira feature governada em produção" num workspace com N projetos ativos, sem perda de contexto entre sessões e sem decisão estrutural fora de ADR.
|
|
1
|
+
# Visão de Produto — Forja
|
|
2
|
+
|
|
3
|
+
> A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.
|
|
4
|
+
|
|
5
|
+
## O problema (o inimigo)
|
|
6
|
+
|
|
7
|
+
Agentes de IA são amnésicos e indisciplinados. Cada sessão recomeça do zero, decisões de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao mesmo tempo paga esse imposto multiplicado por N. Um assistente brilhante sem processo produz velocidade sem direção.
|
|
8
|
+
|
|
9
|
+
## A aposta
|
|
10
|
+
|
|
11
|
+
O diferencial durável não é o modelo (commodity que melhora sozinho), é o que fica em volta dele:
|
|
12
|
+
|
|
13
|
+
1. **Memória que sobrevive** — contexto hierárquico, buscável (SQLite FTS5), compartilhado entre sessões e entre IAs (ADR-0001/0002/0003).
|
|
14
|
+
2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs auditáveis de 7 campos (ADR-0005); comandos passam por um core único com gates e trilha de auditoria (ADR-0020).
|
|
15
|
+
3. **Fábrica, não projeto único** — workspace multi-produto com canto fixo (ADR-0019), times de agentes desenhados por projeto (harness), code intelligence como gate (ADR-0017).
|
|
16
|
+
|
|
17
|
+
## Posicionamento
|
|
18
|
+
|
|
19
|
+
- **Claude Code sozinho** é um engenheiro brilhante e amnésico; a Forja é o estúdio em volta dele.
|
|
20
|
+
- **Frameworks de agentes** (LangGraph etc.) são infraestrutura para *construir* agentes; a Forja é a camada de cima — o sistema operacional do estúdio de software de uma pessoa só.
|
|
21
|
+
- **Multi-IA por design** (Claude, Copilot, Gemini, Codex): nenhum vendor entrega isso, e a memória/processo não fica refém de um fornecedor.
|
|
22
|
+
|
|
23
|
+
A stack gerada (NestJS hoje) é **um boilerplate entre vários** — a identidade da Forja é o processo + a memória, não o framework de backend.
|
|
24
|
+
|
|
25
|
+
## Métrica-norte
|
|
26
|
+
|
|
27
|
+
Tempo entre "ideia" e "primeira feature governada em produção" num workspace com N projetos ativos, sem perda de contexto entre sessões e sem decisão estrutural fora de ADR.
|
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
# memory/30-projects — fichas de projetos (privadas)
|
|
2
|
-
|
|
3
|
-
Este diretório registra os projetos rastreados pela Memória Universal. Cada projeto
|
|
4
|
-
gera uma ficha `<nome>.md` (criada por `init-project.js` ou pela sincronização de
|
|
5
|
-
memória).
|
|
6
|
-
|
|
7
|
-
## Privacidade
|
|
8
|
-
|
|
9
|
-
As fichas de projeto carregam dados de produto/cliente e por isso **não são
|
|
10
|
-
versionadas** — `.gitignore` ignora `memory/30-projects/*` exceto este README.
|
|
11
|
-
A mesma convenção vale para `specs/<produto>/` e `.context/` (ver `.gitignore`).
|
|
12
|
-
|
|
13
|
-
As fichas continuam existindo em disco e funcionando localmente; apenas não entram
|
|
14
|
-
no repositório público do framework. Para regenerar a ficha de um projeto, rode o
|
|
15
|
-
fluxo de init/sync de memória correspondente.
|
|
1
|
+
# memory/30-projects — fichas de projetos (privadas)
|
|
2
|
+
|
|
3
|
+
Este diretório registra os projetos rastreados pela Memória Universal. Cada projeto
|
|
4
|
+
gera uma ficha `<nome>.md` (criada por `init-project.js` ou pela sincronização de
|
|
5
|
+
memória).
|
|
6
|
+
|
|
7
|
+
## Privacidade
|
|
8
|
+
|
|
9
|
+
As fichas de projeto carregam dados de produto/cliente e por isso **não são
|
|
10
|
+
versionadas** — `.gitignore` ignora `memory/30-projects/*` exceto este README.
|
|
11
|
+
A mesma convenção vale para `specs/<produto>/` e `.context/` (ver `.gitignore`).
|
|
12
|
+
|
|
13
|
+
As fichas continuam existindo em disco e funcionando localmente; apenas não entram
|
|
14
|
+
no repositório público do framework. Para regenerar a ficha de um projeto, rode o
|
|
15
|
+
fluxo de init/sync de memória correspondente.
|
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
# Backlog
|
|
2
|
-
|
|
3
|
-
Priorizacao via RICE (Reach x Impact x Confidence / Effort).
|
|
4
|
-
|
|
5
|
-
Assumptions: 1 usuario, ~5 empresas, ~60 ativos, 2 NAS.
|
|
6
|
-
|
|
7
|
-
| Prioridade | Item | Reach | Impact | Confidence | Effort | RICE | Dependencias | Notas |
|
|
8
|
-
|---|---:|---:|---:|---:|---:|---:|---|---|
|
|
9
|
-
| P0 | Inventario multiempresa + CRUD de ativos | 60 | 3.0 | 0.8 | 6 | 24.0 | - | Base do sistema |
|
|
10
|
-
| P0 | Monitoramento de disponibilidade + status | 60 | 3.0 | 0.7 | 8 | 15.8 | Inventario | Checks ICMP/TCP |
|
|
11
|
-
| P1 | Alertas (regras + notificacao) | 60 | 2.0 | 0.7 | 6 | 14.0 | Monitoramento | SLA alerta <= 2 min |
|
|
12
|
-
| P1 | Storage/NAS (capacidade/uso) | 10 | 2.0 | 0.6 | 4 | 3.0 | Inventario | Medir volumes |
|
|
13
|
-
| P2 | Relatorios mensais + export CSV | 5 | 1.5 | 0.6 | 4 | 1.1 | Monitoramento | Foco em uptime |
|
|
14
|
-
| P2 | Deploy Dokploy + Debian 13 | 1 | 2.5 | 0.8 | 3 | 0.7 | - | Bloqueador de validacao final |
|
|
15
|
-
| P3 | Observabilidade (Prometheus/Grafana) | 1 | 2.0 | 0.6 | 3 | 0.4 | Monitoramento | /metrics + dashboard |
|
|
1
|
+
# Backlog
|
|
2
|
+
|
|
3
|
+
Priorizacao via RICE (Reach x Impact x Confidence / Effort).
|
|
4
|
+
|
|
5
|
+
Assumptions: 1 usuario, ~5 empresas, ~60 ativos, 2 NAS.
|
|
6
|
+
|
|
7
|
+
| Prioridade | Item | Reach | Impact | Confidence | Effort | RICE | Dependencias | Notas |
|
|
8
|
+
|---|---:|---:|---:|---:|---:|---:|---|---|
|
|
9
|
+
| P0 | Inventario multiempresa + CRUD de ativos | 60 | 3.0 | 0.8 | 6 | 24.0 | - | Base do sistema |
|
|
10
|
+
| P0 | Monitoramento de disponibilidade + status | 60 | 3.0 | 0.7 | 8 | 15.8 | Inventario | Checks ICMP/TCP |
|
|
11
|
+
| P1 | Alertas (regras + notificacao) | 60 | 2.0 | 0.7 | 6 | 14.0 | Monitoramento | SLA alerta <= 2 min |
|
|
12
|
+
| P1 | Storage/NAS (capacidade/uso) | 10 | 2.0 | 0.6 | 4 | 3.0 | Inventario | Medir volumes |
|
|
13
|
+
| P2 | Relatorios mensais + export CSV | 5 | 1.5 | 0.6 | 4 | 1.1 | Monitoramento | Foco em uptime |
|
|
14
|
+
| P2 | Deploy Dokploy + Debian 13 | 1 | 2.5 | 0.8 | 3 | 0.7 | - | Bloqueador de validacao final |
|
|
15
|
+
| P3 | Observabilidade (Prometheus/Grafana) | 1 | 2.0 | 0.6 | 3 | 0.4 | Monitoramento | /metrics + dashboard |
|
|
@@ -1,27 +1,24 @@
|
|
|
1
|
-
# Sprint Atual
|
|
2
|
-
|
|
3
|
-
## Projeto
|
|
4
|
-
framework-root (o repo do Forja — produtos vivem no workspace, ADR-0019)
|
|
5
|
-
|
|
6
|
-
## Objetivos
|
|
7
|
-
- Fechar a classe de falha "erra sem avisar" (ADR-0021) com gates executáveis, não correções pontuais.
|
|
8
|
-
|
|
9
|
-
## Itens da Sprint
|
|
10
|
-
- [x] SPEC-009 — Doctor do núcleo (`specs/doctor-do-nucleo/`, ADR-0023)
|
|
11
|
-
`tools:doctor` deixa de auditar só ferramentas opcionais e passa a ser gate do núcleo:
|
|
12
|
-
ABI nativa, memória, workspace, deps de runtime, `.mcp.json`. Exit 1 no que trava o fluxo.
|
|
1
|
+
# Sprint Atual
|
|
2
|
+
|
|
3
|
+
## Projeto
|
|
4
|
+
framework-root (o repo do Forja — produtos vivem no workspace, ADR-0019)
|
|
5
|
+
|
|
6
|
+
## Objetivos
|
|
7
|
+
- Fechar a classe de falha "erra sem avisar" (ADR-0021) com gates executáveis, não correções pontuais.
|
|
8
|
+
|
|
9
|
+
## Itens da Sprint
|
|
10
|
+
- [x] SPEC-009 — Doctor do núcleo (`specs/doctor-do-nucleo/`, ADR-0023)
|
|
11
|
+
`tools:doctor` deixa de auditar só ferramentas opcionais e passa a ser gate do núcleo:
|
|
12
|
+
ABI nativa, memória, workspace, deps de runtime, `.mcp.json`. Exit 1 no que trava o fluxo.
|
|
13
13
|
- [x] `spec:new` mantém a allow-list do `.gitignore` — spec nova do framework nascia invisível ao git.
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
- Handoff implement: npm run gsd:handoff -- implement <slug>
|
|
26
|
-
- Validar: npm run gsd:check -- <slug>
|
|
27
|
-
- Governança: npm run project:check && npm run tools:doctor
|
|
14
|
+
- [x] SPEC-022 — Release Auditor consome a saúde canônica (`specs/release-auditor-health/`)
|
|
15
|
+
`tools:doctor` passa a anteceder o gate estrito `release:check --publish`, sem probes duplicados
|
|
16
|
+
e sem substituir o modo de publicação por `check:all --full`.
|
|
17
|
+
|
|
18
|
+
## Ritual CLI
|
|
19
|
+
- Planejar: npm run gsd:plan -- <slug> "<objetivo>"
|
|
20
|
+
- Handoff spec: npm run gsd:handoff -- spec <slug>
|
|
21
|
+
- Handoff plan: npm run gsd:handoff -- plan <slug>
|
|
22
|
+
- Handoff implement: npm run gsd:handoff -- implement <slug>
|
|
23
|
+
- Validar: npm run gsd:check -- <slug>
|
|
24
|
+
- Governança: npm run project:check && npm run tools:doctor
|
|
@@ -1,55 +1,55 @@
|
|
|
1
|
-
# GSD + Hermes Harness
|
|
2
|
-
|
|
3
|
-
GSD e a camada operacional que liga SDD, sprints e handoffs Hermes por linha de comando. `design-md` entra somente quando ha impacto visual.
|
|
4
|
-
|
|
5
|
-
## Contratos
|
|
6
|
-
|
|
7
|
-
- `gsd:plan` cria `.context/gsd-<slug>.md` com gates verificaveis.
|
|
8
|
-
- `gsd:handoff` registra passagens padronizadas no SQLite via Hermes.
|
|
9
|
-
- `gsd:check` valida runbook, spec e indice codegraph. Brief visual e opcional em fluxo CLI-only.
|
|
10
|
-
- `code:check` valida indice codegraph (worktree + freshness) — gate de code intelligence (ADR-0017).
|
|
11
|
-
- `code:impact <simbolo>` mostra chamadores e blast radius antes de editar.
|
|
12
|
-
- `tools:doctor` faz o raio-x das ferramentas de processo (ADR-0018).
|
|
13
|
-
- `design:select` escolhe referencias locais de `design-md/`.
|
|
14
|
-
- `design:check` bloqueia brief incompleto antes de implementacao visual.
|
|
15
|
-
|
|
16
|
-
## Sequencia padrao
|
|
17
|
-
|
|
18
|
-
Todo projeto deve andar em steps, sem pular briefing, estrutura, sprints e validacao:
|
|
19
|
-
|
|
20
|
-
1. Briefing, com slug gerado
|
|
21
|
-
2. Estrutura do projeto
|
|
22
|
-
3. Sprints definidas
|
|
23
|
-
4. Contexto inteligente montado
|
|
24
|
-
5. Mapa de impacto via codegraph (`code:check` + `code:impact`) — ADR-0017
|
|
25
|
-
6. Spec de produto aprovada
|
|
26
|
-
7. Brief visual validado somente se houver UI
|
|
27
|
-
8. Plano tecnico e ADRs definidos
|
|
28
|
-
9. Desenvolvimento por Worker
|
|
29
|
-
10. Validacao dos passos
|
|
30
|
-
11. Gate final de Governance (inclui `code:check` e `tools:doctor`)
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
npm run dev -- gsd:plan <slug> "<objetivo>"
|
|
34
|
-
npm run dev -- gsd:handoff spec <slug>
|
|
35
|
-
npm run dev -- gsd:handoff plan <slug>
|
|
36
|
-
npm run dev -- gsd:handoff implement <slug>
|
|
37
|
-
npm run dev -- gsd:handoff review <slug>
|
|
38
|
-
npm run dev -- gsd:check <slug>
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
Se a entrega tiver UI:
|
|
42
|
-
|
|
43
|
-
```bash
|
|
44
|
-
npm run dev -- design:select <surface> <tom>
|
|
45
|
-
npm run dev -- design:check <brief.md>
|
|
46
|
-
npm run dev -- gsd:check <slug> <brief.md>
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
## Uso por papel
|
|
50
|
-
|
|
51
|
-
- Orchestrator: inicia `gsd:plan` e registra `gsd:handoff spec`.
|
|
52
|
-
- Product: garante que `spec.md` tenha dor, escopo, AC e metrica 30d.
|
|
53
|
-
- SDD Architect: roda `code:impact` para fundamentar modulos afetados, transforma spec aprovada em plan/tasks e registra implementacao.
|
|
54
|
-
- Worker: roda `code:impact <simbolo>` antes de editar, implementa dentro do ownership e devolve review.
|
|
55
|
-
- Governance: roda `gsd:check`, `code:check`, `tools:doctor`, `spec:check`, testes e `project:check`.
|
|
1
|
+
# GSD + Hermes Harness
|
|
2
|
+
|
|
3
|
+
GSD e a camada operacional que liga SDD, sprints e handoffs Hermes por linha de comando. `design-md` entra somente quando ha impacto visual.
|
|
4
|
+
|
|
5
|
+
## Contratos
|
|
6
|
+
|
|
7
|
+
- `gsd:plan` cria `.context/gsd-<slug>.md` com gates verificaveis.
|
|
8
|
+
- `gsd:handoff` registra passagens padronizadas no SQLite via Hermes.
|
|
9
|
+
- `gsd:check` valida runbook, spec e indice codegraph. Brief visual e opcional em fluxo CLI-only.
|
|
10
|
+
- `code:check` valida indice codegraph (worktree + freshness) — gate de code intelligence (ADR-0017).
|
|
11
|
+
- `code:impact <simbolo>` mostra chamadores e blast radius antes de editar.
|
|
12
|
+
- `tools:doctor` faz o raio-x das ferramentas de processo (ADR-0018).
|
|
13
|
+
- `design:select` escolhe referencias locais de `design-md/`.
|
|
14
|
+
- `design:check` bloqueia brief incompleto antes de implementacao visual.
|
|
15
|
+
|
|
16
|
+
## Sequencia padrao
|
|
17
|
+
|
|
18
|
+
Todo projeto deve andar em steps, sem pular briefing, estrutura, sprints e validacao:
|
|
19
|
+
|
|
20
|
+
1. Briefing, com slug gerado
|
|
21
|
+
2. Estrutura do projeto
|
|
22
|
+
3. Sprints definidas
|
|
23
|
+
4. Contexto inteligente montado
|
|
24
|
+
5. Mapa de impacto via codegraph (`code:check` + `code:impact`) — ADR-0017
|
|
25
|
+
6. Spec de produto aprovada
|
|
26
|
+
7. Brief visual validado somente se houver UI
|
|
27
|
+
8. Plano tecnico e ADRs definidos
|
|
28
|
+
9. Desenvolvimento por Worker
|
|
29
|
+
10. Validacao dos passos
|
|
30
|
+
11. Gate final de Governance (inclui `code:check` e `tools:doctor`)
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
npm run dev -- gsd:plan <slug> "<objetivo>"
|
|
34
|
+
npm run dev -- gsd:handoff spec <slug>
|
|
35
|
+
npm run dev -- gsd:handoff plan <slug>
|
|
36
|
+
npm run dev -- gsd:handoff implement <slug>
|
|
37
|
+
npm run dev -- gsd:handoff review <slug>
|
|
38
|
+
npm run dev -- gsd:check <slug>
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Se a entrega tiver UI:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
npm run dev -- design:select <surface> <tom>
|
|
45
|
+
npm run dev -- design:check <brief.md>
|
|
46
|
+
npm run dev -- gsd:check <slug> <brief.md>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Uso por papel
|
|
50
|
+
|
|
51
|
+
- Orchestrator: inicia `gsd:plan` e registra `gsd:handoff spec`.
|
|
52
|
+
- Product: garante que `spec.md` tenha dor, escopo, AC e metrica 30d.
|
|
53
|
+
- SDD Architect: roda `code:impact` para fundamentar modulos afetados, transforma spec aprovada em plan/tasks e registra implementacao.
|
|
54
|
+
- Worker: roda `code:impact <simbolo>` antes de editar, implementa dentro do ownership e devolve review.
|
|
55
|
+
- Governance: roda `gsd:check`, `code:check`, `tools:doctor`, `spec:check`, testes e `project:check`.
|