forjajs 2.0.2 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -317
- package/README.pt-BR.md +345 -323
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.d.ts +1 -0
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -140
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
package/docs/init-project.md
CHANGED
|
@@ -1,457 +1,457 @@
|
|
|
1
|
-
# 🚀 Init Project - Guia de Uso
|
|
2
|
-
|
|
3
|
-
Comando universal para iniciar novo projeto com agentes orquestrados e configuração automática de IAs.
|
|
4
|
-
|
|
5
|
-
> **Atenção**: projetos de produto vivem no **workspace Forja** (`~/forja-workspace` por padrão), fora do repo do framework. Veja ADR-0019.
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## Quick Start (2 minutos)
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
# 1. Ir para repo root do framework Forja
|
|
13
|
-
cd /home/apk/Documentos/GitHub/Projetos/2-Projeto-Agents/projects/forja
|
|
14
|
-
|
|
15
|
-
# 2. Inicializar o workspace (canto fixo dos projetos)
|
|
16
|
-
npm run workspace:init
|
|
17
|
-
|
|
18
|
-
# 3. Criar novo projeto (setup automático completo)
|
|
19
|
-
npm run project:new meu-projeto
|
|
20
|
-
|
|
21
|
-
# 4. Entrar no projeto
|
|
22
|
-
cd ~/forja-workspace/projects/meu-projeto
|
|
23
|
-
|
|
24
|
-
# 5. Ver estrutura
|
|
25
|
-
ls -la
|
|
26
|
-
tree memory/ | head -30
|
|
27
|
-
|
|
28
|
-
# 6. Carregar instruções para sua IA favorita
|
|
29
|
-
cat .ia-instructions/copilot.md
|
|
30
|
-
cat .ia-instructions/claude.md
|
|
31
|
-
cat .ia-instructions/gemini.md
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
**Resultado**: Projeto totalmente setup com:
|
|
35
|
-
- ✅ Estrutura de memória hierárquica
|
|
36
|
-
- ✅ Backend NestJS pronto
|
|
37
|
-
- ✅ Instruções para 3 IAs (Copilot, Claude, Gemini)
|
|
38
|
-
- ✅ SQLite inicializado
|
|
39
|
-
- ✅ Context pack construído
|
|
40
|
-
- ✅ Git configurado
|
|
41
|
-
|
|
42
|
-
---
|
|
43
|
-
|
|
44
|
-
## Sintaxe Completa
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
# Via harness (recomendado — resolve workspace automaticamente)
|
|
48
|
-
npm run project:new <project-name> [opções]
|
|
49
|
-
|
|
50
|
-
# Via binário direto (ainda válido, mas sempre cria no workspace)
|
|
51
|
-
node bin/init-project.js <project-name> [opções]
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
### Opções
|
|
55
|
-
|
|
56
|
-
| Flag | Padrão | O quê |
|
|
57
|
-
|------|--------|-------|
|
|
58
|
-
| `--ai <list>` | copilot,claude,gemini,codex | IAs para configurar (comma-separated) |
|
|
59
|
-
| `--skip-backend` | false | Pula geração do backend NestJS |
|
|
60
|
-
| `--skip-db` | false | Pula inicialização do SQLite |
|
|
61
|
-
| `--skip-git` | false | Pula inicialização do Git |
|
|
62
|
-
| `--skip-design` | false | Pula cópia da biblioteca design-md |
|
|
63
|
-
| `--interactive` | false | Modo interativo (perguntas) |
|
|
64
|
-
| `--verbose` | false | Output detalhado |
|
|
65
|
-
|
|
66
|
-
### Workspace
|
|
67
|
-
|
|
68
|
-
O caminho do workspace é resolvido por prioridade:
|
|
69
|
-
|
|
70
|
-
1. Variável de ambiente `FORJA_WORKSPACE`
|
|
71
|
-
2. Campo `workspaceRoot` em `~/.forjarc.json`
|
|
72
|
-
3. Padrão: `~/forja-workspace`
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
76
|
-
## Exemplos de Uso
|
|
77
|
-
|
|
78
|
-
### 1. Setup Completo (Recomendado)
|
|
79
|
-
```bash
|
|
80
|
-
npm run project:new meu-projeto
|
|
81
|
-
```
|
|
82
|
-
Resultado:
|
|
83
|
-
- Projeto em `~/forja-workspace/projects/meu-projeto/`
|
|
84
|
-
- Estrutura memória + backend NestJS
|
|
85
|
-
- IAs: Copilot, Claude, Gemini, Codex
|
|
86
|
-
- Git inicializado
|
|
87
|
-
- DB setup
|
|
88
|
-
|
|
89
|
-
### 2. Só com Copilot e Claude
|
|
90
|
-
```bash
|
|
91
|
-
npm run project:new meu-projeto -- --ai copilot,claude
|
|
92
|
-
```
|
|
93
|
-
Resultado:
|
|
94
|
-
- Instruções apenas para Copilot e Claude
|
|
95
|
-
- Resto completo
|
|
96
|
-
|
|
97
|
-
### 3. Só Memória (Sem Backend)
|
|
98
|
-
```bash
|
|
99
|
-
npm run project:new meu-projeto -- --skip-backend
|
|
100
|
-
```
|
|
101
|
-
Resultado:
|
|
102
|
-
- Estrutura memória + agentes + skills
|
|
103
|
-
- SEM backend NestJS
|
|
104
|
-
- SEM npm install
|
|
105
|
-
- Útil para projetos frontend-only
|
|
106
|
-
|
|
107
|
-
### 4. Backend sem DB
|
|
108
|
-
```bash
|
|
109
|
-
npm run project:new meu-projeto -- --skip-db
|
|
110
|
-
```
|
|
111
|
-
Resultado:
|
|
112
|
-
- Projeto completo
|
|
113
|
-
- SQLite NÃO inicializado
|
|
114
|
-
- Útil se quer setupar BD depois
|
|
115
|
-
|
|
116
|
-
### 5. Setup Verbose (Debug)
|
|
117
|
-
```bash
|
|
118
|
-
npm run project:new meu-projeto -- --verbose
|
|
119
|
-
```
|
|
120
|
-
Resultado:
|
|
121
|
-
- Mostra todos os comandos executados
|
|
122
|
-
- Útil para troubleshooting
|
|
123
|
-
|
|
124
|
-
### 6. Modo Interativo (Perguntas)
|
|
125
|
-
```bash
|
|
126
|
-
npm run project:new -- --interactive
|
|
127
|
-
```
|
|
128
|
-
Resultado:
|
|
129
|
-
- Pergunta nome do projeto
|
|
130
|
-
- Pergunta quais IAs configurar
|
|
131
|
-
- Pergunta se quer backend
|
|
132
|
-
- Etc
|
|
133
|
-
|
|
134
|
-
---
|
|
135
|
-
|
|
136
|
-
## O que o Comando Faz (Step-by-Step)
|
|
137
|
-
|
|
138
|
-
### 1️⃣ Git Init
|
|
139
|
-
- Cria `.git` se não existir
|
|
140
|
-
- Cria `.gitignore` básico
|
|
141
|
-
|
|
142
|
-
### 2️⃣ Generate Structure
|
|
143
|
-
- Roda `bin/create-memory-nest-kit.js`
|
|
144
|
-
- Cria `memory/`, `agents/`, `skills/`, `prompts/`
|
|
145
|
-
- Cria `backend/` (se não --skip-backend)
|
|
146
|
-
- Cria scripts úteis
|
|
147
|
-
|
|
148
|
-
### 3️⃣ Copy Instructions
|
|
149
|
-
- Copia `.github/copilot-instructions.md`
|
|
150
|
-
- Copia `CLAUDE.md`
|
|
151
|
-
- Copia `.gemini-instructions.md`
|
|
152
|
-
- Coloca em `.ia-instructions/README.md`
|
|
153
|
-
|
|
154
|
-
### 4️⃣ Install Backend
|
|
155
|
-
- Roda `npm install` no backend
|
|
156
|
-
- Instala: NestJS, Jest, Prettier, ESLint, etc
|
|
157
|
-
- Toma alguns minutos na primeira vez
|
|
158
|
-
|
|
159
|
-
### 5️⃣ Init Memory DB
|
|
160
|
-
- Roda `npm run memory:db:init`
|
|
161
|
-
- Cria `.memory/sqlite/context.db`
|
|
162
|
-
- Setup schema SQLite
|
|
163
|
-
|
|
164
|
-
### 6️⃣ Build Context Pack
|
|
165
|
-
- Roda `node scripts/build-context-pack.mjs`
|
|
166
|
-
- Cria `.context/context-pack.md`
|
|
167
|
-
- Resumo compacto para IA ler
|
|
168
|
-
|
|
169
|
-
### 7️⃣ Show Next Steps
|
|
170
|
-
- Exibe checklist de próximos passos
|
|
171
|
-
- Mostra comandos importantes
|
|
172
|
-
|
|
173
|
-
---
|
|
174
|
-
|
|
175
|
-
## Estrutura Criada
|
|
176
|
-
|
|
177
|
-
Após `npm run project:new meu-projeto`, o projeto é criado em `~/forja-workspace/projects/meu-projeto/`:
|
|
178
|
-
|
|
179
|
-
```
|
|
180
|
-
~/forja-workspace/projects/meu-projeto/
|
|
181
|
-
├─ .git/ # Git repository
|
|
182
|
-
├─ .gitignore
|
|
183
|
-
├─ .ia-instructions/ # Instruções por IA
|
|
184
|
-
│ ├─ README.md
|
|
185
|
-
│ ├─ copilot.md
|
|
186
|
-
│ ├─ claude.md
|
|
187
|
-
│ └─ gemini.md
|
|
188
|
-
├─ .context/
|
|
189
|
-
│ └─ context-pack.md # Resumo compacto
|
|
190
|
-
├─ .memory/
|
|
191
|
-
│ └─ sqlite/
|
|
192
|
-
│ └─ context.db # SQLite DB
|
|
193
|
-
├─ memory/ # Estrutura hierárquica
|
|
194
|
-
│ ├─ 00-global/
|
|
195
|
-
│ ├─ 10-product/
|
|
196
|
-
│ ├─ 20-architecture/
|
|
197
|
-
│ ├─ 30-domains/
|
|
198
|
-
│ ├─ 40-delivery/
|
|
199
|
-
│ ├─ 50-orchestration/
|
|
200
|
-
│ ├─ 60-runs/
|
|
201
|
-
│ ├─ 70-summaries/
|
|
202
|
-
│ ├─ 80-data/
|
|
203
|
-
│ └─ 90-decisions/
|
|
204
|
-
├─ agents/ # Especificação de agentes
|
|
205
|
-
│ ├─ orchestrator.md
|
|
206
|
-
│ ├─ backend-nest.md
|
|
207
|
-
│ ├─ frontend.md
|
|
208
|
-
│ ├─ dba.md
|
|
209
|
-
│ ├─ security.md
|
|
210
|
-
│ ├─ reviewer.md
|
|
211
|
-
│ └─ README.md
|
|
212
|
-
├─ skills/ # Skills operacionais
|
|
213
|
-
│ ├─ triage-task/
|
|
214
|
-
│ ├─ context-compaction/
|
|
215
|
-
│ ├─ handoff/
|
|
216
|
-
│ └─ nest-api/
|
|
217
|
-
├─ prompts/ # Templates de prompts
|
|
218
|
-
│ ├─ project-prompt-base.md
|
|
219
|
-
│ ├─ multi-agent-orchestrator.md
|
|
220
|
-
│ └─ worker-task-template.md
|
|
221
|
-
├─ scripts/
|
|
222
|
-
│ ├─ build-context-pack.mjs # Compactar contexto
|
|
223
|
-
│ └─ append-handoff.mjs # Criar handoff
|
|
224
|
-
├─ docs/ # Documentação adicional
|
|
225
|
-
├─ backend/ # NestJS (se não --skip-backend)
|
|
226
|
-
│ ├─ src/
|
|
227
|
-
│ ├─ test/
|
|
228
|
-
│ ├─ scripts/
|
|
229
|
-
│ │ ├─ memory-db-init.mjs
|
|
230
|
-
│ │ ├─ memory-db-sync.mjs
|
|
231
|
-
│ │ ├─ memory-db-query.mjs
|
|
232
|
-
│ │ └─ memory-db-schema.sql
|
|
233
|
-
│ ├─ package.json
|
|
234
|
-
│ ├─ tsconfig.json
|
|
235
|
-
│ └─ nest-cli.json
|
|
236
|
-
├─ README.md
|
|
237
|
-
└─ AGENTS.md
|
|
238
|
-
```
|
|
239
|
-
|
|
240
|
-
---
|
|
241
|
-
|
|
242
|
-
## Workflow Após Init
|
|
243
|
-
|
|
244
|
-
### Copilot / Claude / Gemini Setup
|
|
245
|
-
|
|
246
|
-
```bash
|
|
247
|
-
# 1. Ver instruções
|
|
248
|
-
cat ~/forja-workspace/projects/meu-projeto/.ia-instructions/copilot.md
|
|
249
|
-
|
|
250
|
-
# 2. Copiar para IA assistant
|
|
251
|
-
# - Abra seu editor com Copilot/Claude
|
|
252
|
-
# - New chat
|
|
253
|
-
# - Paste conteúdo do arquivo
|
|
254
|
-
# - Pronto! IA entende seu projeto
|
|
255
|
-
|
|
256
|
-
# 3. Pedir para IA:
|
|
257
|
-
# "Implemente endpoint GET /users/:id com validação de UUID"
|
|
258
|
-
# "Crie teste para criar novo usuário"
|
|
259
|
-
# etc
|
|
260
|
-
```
|
|
261
|
-
|
|
262
|
-
### Desenvolvimento Local
|
|
263
|
-
|
|
264
|
-
```bash
|
|
265
|
-
cd ~/forja-workspace/projects/meu-projeto
|
|
266
|
-
|
|
267
|
-
# Ver estrutura de memória
|
|
268
|
-
tree memory/ -L 2
|
|
269
|
-
|
|
270
|
-
# Carregar contexto para IA
|
|
271
|
-
cat .context/context-pack.md | head -100
|
|
272
|
-
|
|
273
|
-
# Iniciar backend em dev
|
|
274
|
-
cd backend && npm run start:dev
|
|
275
|
-
|
|
276
|
-
# Rodar testes
|
|
277
|
-
cd backend && npm test
|
|
278
|
-
|
|
279
|
-
# Sincronizar BD (após mudanças grandes)
|
|
280
|
-
cd backend && npm run memory:db:sync
|
|
281
|
-
|
|
282
|
-
# Consultar contexto
|
|
283
|
-
cd backend && npm run memory:db:query -- "search" "auth" 10
|
|
284
|
-
```
|
|
285
|
-
|
|
286
|
-
### Registrar Handoff (Quando Passar para Outro Agente)
|
|
287
|
-
|
|
288
|
-
```bash
|
|
289
|
-
cd meu-projeto
|
|
290
|
-
|
|
291
|
-
# Criar handoff estruturado
|
|
292
|
-
node scripts/append-handoff.mjs orchestrator backend-nest "Implementar módulo de autenticação com JWT"
|
|
293
|
-
|
|
294
|
-
# Resultado: novo arquivo em memory/50-orchestration/handoffs/
|
|
295
|
-
```
|
|
296
|
-
|
|
297
|
-
### Atualizar Documentação
|
|
298
|
-
|
|
299
|
-
```bash
|
|
300
|
-
# Após mudanças importantes
|
|
301
|
-
vim memory/20-architecture/backend.md
|
|
302
|
-
vim memory/30-domains/auth/rules.md
|
|
303
|
-
|
|
304
|
-
# Sincronizar DB
|
|
305
|
-
cd backend && npm run memory:db:sync
|
|
306
|
-
```
|
|
307
|
-
|
|
308
|
-
---
|
|
309
|
-
|
|
310
|
-
## Troubleshooting
|
|
311
|
-
|
|
312
|
-
### "Node not found"
|
|
313
|
-
```bash
|
|
314
|
-
# Instalar Node.js >= 18
|
|
315
|
-
curl -fsSL https://fnm.io/install | bash
|
|
316
|
-
fnm install 18
|
|
317
|
-
fnm use 18
|
|
318
|
-
node --version
|
|
319
|
-
```
|
|
320
|
-
|
|
321
|
-
### "npm install falha"
|
|
322
|
-
```bash
|
|
323
|
-
# Limpar cache
|
|
324
|
-
npm cache clean --force
|
|
325
|
-
|
|
326
|
-
# Atualizar npm
|
|
327
|
-
npm install -g npm@latest
|
|
328
|
-
|
|
329
|
-
# Tentar novamente
|
|
330
|
-
node bin/init-project.js meu-projeto --verbose
|
|
331
|
-
```
|
|
332
|
-
|
|
333
|
-
### "Git conflicts"
|
|
334
|
-
```bash
|
|
335
|
-
# Se projeto já existe com Git
|
|
336
|
-
node bin/init-project.js meu-projeto --force --skip-git
|
|
337
|
-
```
|
|
338
|
-
|
|
339
|
-
### "BD não inicializa"
|
|
340
|
-
```bash
|
|
341
|
-
# Manual
|
|
342
|
-
cd meu-projeto/backend
|
|
343
|
-
npm run memory:db:init
|
|
344
|
-
npm run memory:db:sync
|
|
345
|
-
```
|
|
346
|
-
|
|
347
|
-
### "Backend não compila"
|
|
348
|
-
```bash
|
|
349
|
-
# Debug detalhado
|
|
350
|
-
cd meu-projeto/backend
|
|
351
|
-
npm run build -- --verbose
|
|
352
|
-
npm run lint
|
|
353
|
-
npm test
|
|
354
|
-
```
|
|
355
|
-
|
|
356
|
-
---
|
|
357
|
-
|
|
358
|
-
## Integração com CI/CD
|
|
359
|
-
|
|
360
|
-
### GitHub Actions
|
|
361
|
-
|
|
362
|
-
```yaml
|
|
363
|
-
# .github/workflows/init-new-project.yml
|
|
364
|
-
name: Create New Project
|
|
365
|
-
on:
|
|
366
|
-
workflow_dispatch:
|
|
367
|
-
inputs:
|
|
368
|
-
project_name:
|
|
369
|
-
description: "Nome do projeto"
|
|
370
|
-
required: true
|
|
371
|
-
|
|
372
|
-
jobs:
|
|
373
|
-
init:
|
|
374
|
-
runs-on: ubuntu-latest
|
|
375
|
-
steps:
|
|
376
|
-
- uses: actions/checkout@v3
|
|
377
|
-
- uses: actions/setup-node@v3
|
|
378
|
-
with:
|
|
379
|
-
node-version: "18"
|
|
380
|
-
|
|
381
|
-
- name: Init project
|
|
382
|
-
run: |
|
|
383
|
-
node bin/init-project.js ${{ github.event.inputs.project_name }} \
|
|
384
|
-
--ai copilot,claude,gemini
|
|
385
|
-
|
|
386
|
-
- name: Commit and push
|
|
387
|
-
run: |
|
|
388
|
-
git config user.email "bot@example.com"
|
|
389
|
-
git config user.name "Bot"
|
|
390
|
-
git add .
|
|
391
|
-
git commit -m "feat: init project ${{ github.event.inputs.project_name }}"
|
|
392
|
-
git push
|
|
393
|
-
```
|
|
394
|
-
|
|
395
|
-
---
|
|
396
|
-
|
|
397
|
-
## Próximas Features Planejadas
|
|
398
|
-
|
|
399
|
-
- [ ] --ai-config: arquivo YAML com config por IA
|
|
400
|
-
- [ ] --template: escolher template (web, api, fullstack)
|
|
401
|
-
- [ ] --preset: preset de IAs (solo, team, enterprise)
|
|
402
|
-
- [ ] --github-org: criar repo automático
|
|
403
|
-
- [ ] --docker: Dockerfile pronto
|
|
404
|
-
- [ ] --k8s: deployment manifests
|
|
405
|
-
|
|
406
|
-
---
|
|
407
|
-
|
|
408
|
-
## Sumário de Comandos Frequentes
|
|
409
|
-
|
|
410
|
-
```bash
|
|
411
|
-
# Inicializar workspace (uma vez)
|
|
412
|
-
npm run workspace:init
|
|
413
|
-
|
|
414
|
-
# Criar novo projeto (tudo automático)
|
|
415
|
-
npm run project:new meu-projeto
|
|
416
|
-
|
|
417
|
-
# Variantes
|
|
418
|
-
npm run project:new meu-projeto -- --skip-backend
|
|
419
|
-
npm run project:new meu-projeto -- --ai claude,copilot
|
|
420
|
-
npm run project:new meu-projeto -- --verbose
|
|
421
|
-
|
|
422
|
-
# Dentro do projeto
|
|
423
|
-
cd ~/forja-workspace/projects/meu-projeto
|
|
424
|
-
|
|
425
|
-
# Ver instruções para IA
|
|
426
|
-
cat .ia-instructions/copilot.md
|
|
427
|
-
|
|
428
|
-
# Ver contexto resumido
|
|
429
|
-
cat .context/context-pack.md | head -50
|
|
430
|
-
|
|
431
|
-
# Rodar backend
|
|
432
|
-
cd backend && npm run start:dev
|
|
433
|
-
|
|
434
|
-
# Sincronizar memória
|
|
435
|
-
cd backend && npm run memory:db:sync
|
|
436
|
-
|
|
437
|
-
# Criar handoff
|
|
438
|
-
node scripts/append-handoff.mjs orchestrator backend-nest "tarefa"
|
|
439
|
-
|
|
440
|
-
# Query contexto
|
|
441
|
-
cd backend && npm run memory:db:query -- "search" "auth" 10
|
|
442
|
-
```
|
|
443
|
-
|
|
444
|
-
---
|
|
445
|
-
|
|
446
|
-
## Help Rápido
|
|
447
|
-
|
|
448
|
-
```bash
|
|
449
|
-
node bin/init-project.js --help
|
|
450
|
-
```
|
|
451
|
-
|
|
452
|
-
---
|
|
453
|
-
|
|
454
|
-
**Criado**: 2026-04-21
|
|
455
|
-
**Status**: 🟢 Pronto para Uso
|
|
456
|
-
**Próximo**: Implementar em `bin/init-project.js` (já feito!)
|
|
457
|
-
|
|
1
|
+
# 🚀 Init Project - Guia de Uso
|
|
2
|
+
|
|
3
|
+
Comando universal para iniciar novo projeto com agentes orquestrados e configuração automática de IAs.
|
|
4
|
+
|
|
5
|
+
> **Atenção**: projetos de produto vivem no **workspace Forja** (`~/forja-workspace` por padrão), fora do repo do framework. Veja ADR-0019.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Quick Start (2 minutos)
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
# 1. Ir para repo root do framework Forja
|
|
13
|
+
cd /home/apk/Documentos/GitHub/Projetos/2-Projeto-Agents/projects/forja
|
|
14
|
+
|
|
15
|
+
# 2. Inicializar o workspace (canto fixo dos projetos)
|
|
16
|
+
npm run workspace:init
|
|
17
|
+
|
|
18
|
+
# 3. Criar novo projeto (setup automático completo)
|
|
19
|
+
npm run project:new meu-projeto
|
|
20
|
+
|
|
21
|
+
# 4. Entrar no projeto
|
|
22
|
+
cd ~/forja-workspace/projects/meu-projeto
|
|
23
|
+
|
|
24
|
+
# 5. Ver estrutura
|
|
25
|
+
ls -la
|
|
26
|
+
tree memory/ | head -30
|
|
27
|
+
|
|
28
|
+
# 6. Carregar instruções para sua IA favorita
|
|
29
|
+
cat .ia-instructions/copilot.md
|
|
30
|
+
cat .ia-instructions/claude.md
|
|
31
|
+
cat .ia-instructions/gemini.md
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
**Resultado**: Projeto totalmente setup com:
|
|
35
|
+
- ✅ Estrutura de memória hierárquica
|
|
36
|
+
- ✅ Backend NestJS pronto
|
|
37
|
+
- ✅ Instruções para 3 IAs (Copilot, Claude, Gemini)
|
|
38
|
+
- ✅ SQLite inicializado
|
|
39
|
+
- ✅ Context pack construído
|
|
40
|
+
- ✅ Git configurado
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Sintaxe Completa
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
# Via harness (recomendado — resolve workspace automaticamente)
|
|
48
|
+
npm run project:new <project-name> [opções]
|
|
49
|
+
|
|
50
|
+
# Via binário direto (ainda válido, mas sempre cria no workspace)
|
|
51
|
+
node bin/init-project.js <project-name> [opções]
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### Opções
|
|
55
|
+
|
|
56
|
+
| Flag | Padrão | O quê |
|
|
57
|
+
|------|--------|-------|
|
|
58
|
+
| `--ai <list>` | copilot,claude,gemini,codex | IAs para configurar (comma-separated) |
|
|
59
|
+
| `--skip-backend` | false | Pula geração do backend NestJS |
|
|
60
|
+
| `--skip-db` | false | Pula inicialização do SQLite |
|
|
61
|
+
| `--skip-git` | false | Pula inicialização do Git |
|
|
62
|
+
| `--skip-design` | false | Pula cópia da biblioteca design-md |
|
|
63
|
+
| `--interactive` | false | Modo interativo (perguntas) |
|
|
64
|
+
| `--verbose` | false | Output detalhado |
|
|
65
|
+
|
|
66
|
+
### Workspace
|
|
67
|
+
|
|
68
|
+
O caminho do workspace é resolvido por prioridade:
|
|
69
|
+
|
|
70
|
+
1. Variável de ambiente `FORJA_WORKSPACE`
|
|
71
|
+
2. Campo `workspaceRoot` em `~/.forjarc.json`
|
|
72
|
+
3. Padrão: `~/forja-workspace`
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## Exemplos de Uso
|
|
77
|
+
|
|
78
|
+
### 1. Setup Completo (Recomendado)
|
|
79
|
+
```bash
|
|
80
|
+
npm run project:new meu-projeto
|
|
81
|
+
```
|
|
82
|
+
Resultado:
|
|
83
|
+
- Projeto em `~/forja-workspace/projects/meu-projeto/`
|
|
84
|
+
- Estrutura memória + backend NestJS
|
|
85
|
+
- IAs: Copilot, Claude, Gemini, Codex
|
|
86
|
+
- Git inicializado
|
|
87
|
+
- DB setup
|
|
88
|
+
|
|
89
|
+
### 2. Só com Copilot e Claude
|
|
90
|
+
```bash
|
|
91
|
+
npm run project:new meu-projeto -- --ai copilot,claude
|
|
92
|
+
```
|
|
93
|
+
Resultado:
|
|
94
|
+
- Instruções apenas para Copilot e Claude
|
|
95
|
+
- Resto completo
|
|
96
|
+
|
|
97
|
+
### 3. Só Memória (Sem Backend)
|
|
98
|
+
```bash
|
|
99
|
+
npm run project:new meu-projeto -- --skip-backend
|
|
100
|
+
```
|
|
101
|
+
Resultado:
|
|
102
|
+
- Estrutura memória + agentes + skills
|
|
103
|
+
- SEM backend NestJS
|
|
104
|
+
- SEM npm install
|
|
105
|
+
- Útil para projetos frontend-only
|
|
106
|
+
|
|
107
|
+
### 4. Backend sem DB
|
|
108
|
+
```bash
|
|
109
|
+
npm run project:new meu-projeto -- --skip-db
|
|
110
|
+
```
|
|
111
|
+
Resultado:
|
|
112
|
+
- Projeto completo
|
|
113
|
+
- SQLite NÃO inicializado
|
|
114
|
+
- Útil se quer setupar BD depois
|
|
115
|
+
|
|
116
|
+
### 5. Setup Verbose (Debug)
|
|
117
|
+
```bash
|
|
118
|
+
npm run project:new meu-projeto -- --verbose
|
|
119
|
+
```
|
|
120
|
+
Resultado:
|
|
121
|
+
- Mostra todos os comandos executados
|
|
122
|
+
- Útil para troubleshooting
|
|
123
|
+
|
|
124
|
+
### 6. Modo Interativo (Perguntas)
|
|
125
|
+
```bash
|
|
126
|
+
npm run project:new -- --interactive
|
|
127
|
+
```
|
|
128
|
+
Resultado:
|
|
129
|
+
- Pergunta nome do projeto
|
|
130
|
+
- Pergunta quais IAs configurar
|
|
131
|
+
- Pergunta se quer backend
|
|
132
|
+
- Etc
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## O que o Comando Faz (Step-by-Step)
|
|
137
|
+
|
|
138
|
+
### 1️⃣ Git Init
|
|
139
|
+
- Cria `.git` se não existir
|
|
140
|
+
- Cria `.gitignore` básico
|
|
141
|
+
|
|
142
|
+
### 2️⃣ Generate Structure
|
|
143
|
+
- Roda `bin/create-memory-nest-kit.js`
|
|
144
|
+
- Cria `memory/`, `agents/`, `skills/`, `prompts/`
|
|
145
|
+
- Cria `backend/` (se não --skip-backend)
|
|
146
|
+
- Cria scripts úteis
|
|
147
|
+
|
|
148
|
+
### 3️⃣ Copy Instructions
|
|
149
|
+
- Copia `.github/copilot-instructions.md`
|
|
150
|
+
- Copia `CLAUDE.md`
|
|
151
|
+
- Copia `.gemini-instructions.md`
|
|
152
|
+
- Coloca em `.ia-instructions/README.md`
|
|
153
|
+
|
|
154
|
+
### 4️⃣ Install Backend
|
|
155
|
+
- Roda `npm install` no backend
|
|
156
|
+
- Instala: NestJS, Jest, Prettier, ESLint, etc
|
|
157
|
+
- Toma alguns minutos na primeira vez
|
|
158
|
+
|
|
159
|
+
### 5️⃣ Init Memory DB
|
|
160
|
+
- Roda `npm run memory:db:init`
|
|
161
|
+
- Cria `.memory/sqlite/context.db`
|
|
162
|
+
- Setup schema SQLite
|
|
163
|
+
|
|
164
|
+
### 6️⃣ Build Context Pack
|
|
165
|
+
- Roda `node scripts/build-context-pack.mjs`
|
|
166
|
+
- Cria `.context/context-pack.md`
|
|
167
|
+
- Resumo compacto para IA ler
|
|
168
|
+
|
|
169
|
+
### 7️⃣ Show Next Steps
|
|
170
|
+
- Exibe checklist de próximos passos
|
|
171
|
+
- Mostra comandos importantes
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## Estrutura Criada
|
|
176
|
+
|
|
177
|
+
Após `npm run project:new meu-projeto`, o projeto é criado em `~/forja-workspace/projects/meu-projeto/`:
|
|
178
|
+
|
|
179
|
+
```
|
|
180
|
+
~/forja-workspace/projects/meu-projeto/
|
|
181
|
+
├─ .git/ # Git repository
|
|
182
|
+
├─ .gitignore
|
|
183
|
+
├─ .ia-instructions/ # Instruções por IA
|
|
184
|
+
│ ├─ README.md
|
|
185
|
+
│ ├─ copilot.md
|
|
186
|
+
│ ├─ claude.md
|
|
187
|
+
│ └─ gemini.md
|
|
188
|
+
├─ .context/
|
|
189
|
+
│ └─ context-pack.md # Resumo compacto
|
|
190
|
+
├─ .memory/
|
|
191
|
+
│ └─ sqlite/
|
|
192
|
+
│ └─ context.db # SQLite DB
|
|
193
|
+
├─ memory/ # Estrutura hierárquica
|
|
194
|
+
│ ├─ 00-global/
|
|
195
|
+
│ ├─ 10-product/
|
|
196
|
+
│ ├─ 20-architecture/
|
|
197
|
+
│ ├─ 30-domains/
|
|
198
|
+
│ ├─ 40-delivery/
|
|
199
|
+
│ ├─ 50-orchestration/
|
|
200
|
+
│ ├─ 60-runs/
|
|
201
|
+
│ ├─ 70-summaries/
|
|
202
|
+
│ ├─ 80-data/
|
|
203
|
+
│ └─ 90-decisions/
|
|
204
|
+
├─ agents/ # Especificação de agentes
|
|
205
|
+
│ ├─ orchestrator.md
|
|
206
|
+
│ ├─ backend-nest.md
|
|
207
|
+
│ ├─ frontend.md
|
|
208
|
+
│ ├─ dba.md
|
|
209
|
+
│ ├─ security.md
|
|
210
|
+
│ ├─ reviewer.md
|
|
211
|
+
│ └─ README.md
|
|
212
|
+
├─ skills/ # Skills operacionais
|
|
213
|
+
│ ├─ triage-task/
|
|
214
|
+
│ ├─ context-compaction/
|
|
215
|
+
│ ├─ handoff/
|
|
216
|
+
│ └─ nest-api/
|
|
217
|
+
├─ prompts/ # Templates de prompts
|
|
218
|
+
│ ├─ project-prompt-base.md
|
|
219
|
+
│ ├─ multi-agent-orchestrator.md
|
|
220
|
+
│ └─ worker-task-template.md
|
|
221
|
+
├─ scripts/
|
|
222
|
+
│ ├─ build-context-pack.mjs # Compactar contexto
|
|
223
|
+
│ └─ append-handoff.mjs # Criar handoff
|
|
224
|
+
├─ docs/ # Documentação adicional
|
|
225
|
+
├─ backend/ # NestJS (se não --skip-backend)
|
|
226
|
+
│ ├─ src/
|
|
227
|
+
│ ├─ test/
|
|
228
|
+
│ ├─ scripts/
|
|
229
|
+
│ │ ├─ memory-db-init.mjs
|
|
230
|
+
│ │ ├─ memory-db-sync.mjs
|
|
231
|
+
│ │ ├─ memory-db-query.mjs
|
|
232
|
+
│ │ └─ memory-db-schema.sql
|
|
233
|
+
│ ├─ package.json
|
|
234
|
+
│ ├─ tsconfig.json
|
|
235
|
+
│ └─ nest-cli.json
|
|
236
|
+
├─ README.md
|
|
237
|
+
└─ AGENTS.md
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
---
|
|
241
|
+
|
|
242
|
+
## Workflow Após Init
|
|
243
|
+
|
|
244
|
+
### Copilot / Claude / Gemini Setup
|
|
245
|
+
|
|
246
|
+
```bash
|
|
247
|
+
# 1. Ver instruções
|
|
248
|
+
cat ~/forja-workspace/projects/meu-projeto/.ia-instructions/copilot.md
|
|
249
|
+
|
|
250
|
+
# 2. Copiar para IA assistant
|
|
251
|
+
# - Abra seu editor com Copilot/Claude
|
|
252
|
+
# - New chat
|
|
253
|
+
# - Paste conteúdo do arquivo
|
|
254
|
+
# - Pronto! IA entende seu projeto
|
|
255
|
+
|
|
256
|
+
# 3. Pedir para IA:
|
|
257
|
+
# "Implemente endpoint GET /users/:id com validação de UUID"
|
|
258
|
+
# "Crie teste para criar novo usuário"
|
|
259
|
+
# etc
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
### Desenvolvimento Local
|
|
263
|
+
|
|
264
|
+
```bash
|
|
265
|
+
cd ~/forja-workspace/projects/meu-projeto
|
|
266
|
+
|
|
267
|
+
# Ver estrutura de memória
|
|
268
|
+
tree memory/ -L 2
|
|
269
|
+
|
|
270
|
+
# Carregar contexto para IA
|
|
271
|
+
cat .context/context-pack.md | head -100
|
|
272
|
+
|
|
273
|
+
# Iniciar backend em dev
|
|
274
|
+
cd backend && npm run start:dev
|
|
275
|
+
|
|
276
|
+
# Rodar testes
|
|
277
|
+
cd backend && npm test
|
|
278
|
+
|
|
279
|
+
# Sincronizar BD (após mudanças grandes)
|
|
280
|
+
cd backend && npm run memory:db:sync
|
|
281
|
+
|
|
282
|
+
# Consultar contexto
|
|
283
|
+
cd backend && npm run memory:db:query -- "search" "auth" 10
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
### Registrar Handoff (Quando Passar para Outro Agente)
|
|
287
|
+
|
|
288
|
+
```bash
|
|
289
|
+
cd meu-projeto
|
|
290
|
+
|
|
291
|
+
# Criar handoff estruturado
|
|
292
|
+
node scripts/append-handoff.mjs orchestrator backend-nest "Implementar módulo de autenticação com JWT"
|
|
293
|
+
|
|
294
|
+
# Resultado: novo arquivo em memory/50-orchestration/handoffs/
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
### Atualizar Documentação
|
|
298
|
+
|
|
299
|
+
```bash
|
|
300
|
+
# Após mudanças importantes
|
|
301
|
+
vim memory/20-architecture/backend.md
|
|
302
|
+
vim memory/30-domains/auth/rules.md
|
|
303
|
+
|
|
304
|
+
# Sincronizar DB
|
|
305
|
+
cd backend && npm run memory:db:sync
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
---
|
|
309
|
+
|
|
310
|
+
## Troubleshooting
|
|
311
|
+
|
|
312
|
+
### "Node not found"
|
|
313
|
+
```bash
|
|
314
|
+
# Instalar Node.js >= 18
|
|
315
|
+
curl -fsSL https://fnm.io/install | bash
|
|
316
|
+
fnm install 18
|
|
317
|
+
fnm use 18
|
|
318
|
+
node --version
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
### "npm install falha"
|
|
322
|
+
```bash
|
|
323
|
+
# Limpar cache
|
|
324
|
+
npm cache clean --force
|
|
325
|
+
|
|
326
|
+
# Atualizar npm
|
|
327
|
+
npm install -g npm@latest
|
|
328
|
+
|
|
329
|
+
# Tentar novamente
|
|
330
|
+
node bin/init-project.js meu-projeto --verbose
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
### "Git conflicts"
|
|
334
|
+
```bash
|
|
335
|
+
# Se projeto já existe com Git
|
|
336
|
+
node bin/init-project.js meu-projeto --force --skip-git
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
### "BD não inicializa"
|
|
340
|
+
```bash
|
|
341
|
+
# Manual
|
|
342
|
+
cd meu-projeto/backend
|
|
343
|
+
npm run memory:db:init
|
|
344
|
+
npm run memory:db:sync
|
|
345
|
+
```
|
|
346
|
+
|
|
347
|
+
### "Backend não compila"
|
|
348
|
+
```bash
|
|
349
|
+
# Debug detalhado
|
|
350
|
+
cd meu-projeto/backend
|
|
351
|
+
npm run build -- --verbose
|
|
352
|
+
npm run lint
|
|
353
|
+
npm test
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
---
|
|
357
|
+
|
|
358
|
+
## Integração com CI/CD
|
|
359
|
+
|
|
360
|
+
### GitHub Actions
|
|
361
|
+
|
|
362
|
+
```yaml
|
|
363
|
+
# .github/workflows/init-new-project.yml
|
|
364
|
+
name: Create New Project
|
|
365
|
+
on:
|
|
366
|
+
workflow_dispatch:
|
|
367
|
+
inputs:
|
|
368
|
+
project_name:
|
|
369
|
+
description: "Nome do projeto"
|
|
370
|
+
required: true
|
|
371
|
+
|
|
372
|
+
jobs:
|
|
373
|
+
init:
|
|
374
|
+
runs-on: ubuntu-latest
|
|
375
|
+
steps:
|
|
376
|
+
- uses: actions/checkout@v3
|
|
377
|
+
- uses: actions/setup-node@v3
|
|
378
|
+
with:
|
|
379
|
+
node-version: "18"
|
|
380
|
+
|
|
381
|
+
- name: Init project
|
|
382
|
+
run: |
|
|
383
|
+
node bin/init-project.js ${{ github.event.inputs.project_name }} \
|
|
384
|
+
--ai copilot,claude,gemini
|
|
385
|
+
|
|
386
|
+
- name: Commit and push
|
|
387
|
+
run: |
|
|
388
|
+
git config user.email "bot@example.com"
|
|
389
|
+
git config user.name "Bot"
|
|
390
|
+
git add .
|
|
391
|
+
git commit -m "feat: init project ${{ github.event.inputs.project_name }}"
|
|
392
|
+
git push
|
|
393
|
+
```
|
|
394
|
+
|
|
395
|
+
---
|
|
396
|
+
|
|
397
|
+
## Próximas Features Planejadas
|
|
398
|
+
|
|
399
|
+
- [ ] --ai-config: arquivo YAML com config por IA
|
|
400
|
+
- [ ] --template: escolher template (web, api, fullstack)
|
|
401
|
+
- [ ] --preset: preset de IAs (solo, team, enterprise)
|
|
402
|
+
- [ ] --github-org: criar repo automático
|
|
403
|
+
- [ ] --docker: Dockerfile pronto
|
|
404
|
+
- [ ] --k8s: deployment manifests
|
|
405
|
+
|
|
406
|
+
---
|
|
407
|
+
|
|
408
|
+
## Sumário de Comandos Frequentes
|
|
409
|
+
|
|
410
|
+
```bash
|
|
411
|
+
# Inicializar workspace (uma vez)
|
|
412
|
+
npm run workspace:init
|
|
413
|
+
|
|
414
|
+
# Criar novo projeto (tudo automático)
|
|
415
|
+
npm run project:new meu-projeto
|
|
416
|
+
|
|
417
|
+
# Variantes
|
|
418
|
+
npm run project:new meu-projeto -- --skip-backend
|
|
419
|
+
npm run project:new meu-projeto -- --ai claude,copilot
|
|
420
|
+
npm run project:new meu-projeto -- --verbose
|
|
421
|
+
|
|
422
|
+
# Dentro do projeto
|
|
423
|
+
cd ~/forja-workspace/projects/meu-projeto
|
|
424
|
+
|
|
425
|
+
# Ver instruções para IA
|
|
426
|
+
cat .ia-instructions/copilot.md
|
|
427
|
+
|
|
428
|
+
# Ver contexto resumido
|
|
429
|
+
cat .context/context-pack.md | head -50
|
|
430
|
+
|
|
431
|
+
# Rodar backend
|
|
432
|
+
cd backend && npm run start:dev
|
|
433
|
+
|
|
434
|
+
# Sincronizar memória
|
|
435
|
+
cd backend && npm run memory:db:sync
|
|
436
|
+
|
|
437
|
+
# Criar handoff
|
|
438
|
+
node scripts/append-handoff.mjs orchestrator backend-nest "tarefa"
|
|
439
|
+
|
|
440
|
+
# Query contexto
|
|
441
|
+
cd backend && npm run memory:db:query -- "search" "auth" 10
|
|
442
|
+
```
|
|
443
|
+
|
|
444
|
+
---
|
|
445
|
+
|
|
446
|
+
## Help Rápido
|
|
447
|
+
|
|
448
|
+
```bash
|
|
449
|
+
node bin/init-project.js --help
|
|
450
|
+
```
|
|
451
|
+
|
|
452
|
+
---
|
|
453
|
+
|
|
454
|
+
**Criado**: 2026-04-21
|
|
455
|
+
**Status**: 🟢 Pronto para Uso
|
|
456
|
+
**Próximo**: Implementar em `bin/init-project.js` (já feito!)
|
|
457
|
+
|