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,1014 +1,1014 @@
|
|
|
1
|
-
# Manual Operacional CLI-First, SDD, GSD e Orquestracao
|
|
2
|
-
|
|
3
|
-
Este manual e o guia principal para operar o framework de agentes com excelencia, sem depender do dashboard web. A web fica como consulta opcional. A operacao diaria, o acompanhamento de sprint, as passagens entre papeis, a validacao e a governanca acontecem por linha de comando.
|
|
4
|
-
|
|
5
|
-
## 1. Visao Geral
|
|
6
|
-
|
|
7
|
-
O framework organiza desenvolvimento com agentes em quatro pilares:
|
|
8
|
-
|
|
9
|
-
1. **Orquestracao**: cada demanda passa pelo papel certo, no momento certo.
|
|
10
|
-
2. **SDD**: toda entrega relevante e descrita antes como `spec -> plan -> tasks`.
|
|
11
|
-
3. **GSD**: cada execucao vira um runbook com gates verificaveis.
|
|
12
|
-
4. **Hermes**: toda passagem de responsabilidade vira handoff registrado com 7 campos obrigatorios.
|
|
13
|
-
|
|
14
|
-
O objetivo nao e criar burocracia. O objetivo e impedir retrabalho, decisao perdida, implementacao sem criterio de aceite e sprint sem visibilidade.
|
|
15
|
-
|
|
16
|
-
## 2. Mentalidade CLI-First
|
|
17
|
-
|
|
18
|
-
Use o terminal como console operacional. O dashboard nao deve ser necessario para responder:
|
|
19
|
-
|
|
20
|
-
- O que esta na sprint?
|
|
21
|
-
- Qual spec esta ativa?
|
|
22
|
-
- Quem recebeu o handoff?
|
|
23
|
-
- O que falta para implementar?
|
|
24
|
-
- A entrega passou nos gates?
|
|
25
|
-
- O projeto esta pronto para release?
|
|
26
|
-
|
|
27
|
-
Comandos centrais:
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
npm run sprint:status
|
|
31
|
-
npm run gsd:plan -- <slug> "<objetivo>"
|
|
32
|
-
npm run gsd:handoff -- spec <slug>
|
|
33
|
-
npm run gsd:handoff -- plan <slug>
|
|
34
|
-
npm run gsd:handoff -- implement <slug>
|
|
35
|
-
npm run gsd:handoff -- review <slug>
|
|
36
|
-
npm run gsd:check -- <slug>
|
|
37
|
-
npm run project:check
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
## 3. Estrutura do Framework
|
|
41
|
-
|
|
42
|
-
Pastas principais:
|
|
43
|
-
|
|
44
|
-
```text
|
|
45
|
-
AGENTS.md Papéis e regras canonicas
|
|
46
|
-
prompts/ Prompts portaveis por papel
|
|
47
|
-
.claude/agents/ Sub-agents Claude Code
|
|
48
|
-
specs/ Pipeline SDD por feature
|
|
49
|
-
memory/40-delivery/ Backlog e sprint atual
|
|
50
|
-
memory/50-orchestration/ Protocolos de orquestracao
|
|
51
|
-
memory/90-decisions/ ADRs e decisoes estruturais
|
|
52
|
-
scripts/ Harness CLI, sprint, specs, checks
|
|
53
|
-
.context/ Runbooks GSD e context packs
|
|
54
|
-
dashboard/ Web opcional/legada
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
Arquivos que voce vai abrir com frequencia:
|
|
58
|
-
|
|
59
|
-
```bash
|
|
60
|
-
AGENTS.md
|
|
61
|
-
docs/manual-operacional-cli-sdd-gsd.md
|
|
62
|
-
docs/cli-first-operacao.md
|
|
63
|
-
memory/40-delivery/backlog.md
|
|
64
|
-
memory/40-delivery/current-sprint.md
|
|
65
|
-
memory/50-orchestration/gsd-harness.md
|
|
66
|
-
specs/<slug>/spec.md
|
|
67
|
-
specs/<slug>/plan.md
|
|
68
|
-
specs/<slug>/tasks.md
|
|
69
|
-
.context/gsd-<slug>.md
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
## 4. Os 6 Papeis
|
|
73
|
-
|
|
74
|
-
Cada papel existe em tres lugares:
|
|
75
|
-
|
|
76
|
-
- `.claude/agents/<name>.md`: sub-agent executavel no Claude Code.
|
|
77
|
-
- `prompts/<name>-agent.md`: prompt portavel para Copilot, Gemini, Codex etc.
|
|
78
|
-
- `AGENTS.md`: referencia canonica de responsabilidade.
|
|
79
|
-
|
|
80
|
-
### 4.1 Orchestrator
|
|
81
|
-
|
|
82
|
-
Use quando a demanda atravessa multiplos papeis ou quando voce quer coordenar uma execucao.
|
|
83
|
-
|
|
84
|
-
Responsabilidades:
|
|
85
|
-
|
|
86
|
-
- Decompor a demanda.
|
|
87
|
-
- Escolher o proximo papel.
|
|
88
|
-
- Criar ou acionar runbook GSD.
|
|
89
|
-
- Registrar handoffs Hermes.
|
|
90
|
-
- Consolidar memoria ao fim de sprint.
|
|
91
|
-
|
|
92
|
-
Nao faz:
|
|
93
|
-
|
|
94
|
-
- Implementacao direta.
|
|
95
|
-
- Decisao de produto sozinho.
|
|
96
|
-
- Aprovar release sem Governance.
|
|
97
|
-
|
|
98
|
-
Comandos tipicos:
|
|
99
|
-
|
|
100
|
-
```bash
|
|
101
|
-
npm run gsd:plan -- <slug> "<objetivo>"
|
|
102
|
-
npm run gsd:handoff -- spec <slug>
|
|
103
|
-
npm run gsd:handoff -- plan <slug>
|
|
104
|
-
npm run gsd:handoff -- implement <slug>
|
|
105
|
-
npm run gsd:handoff -- review <slug>
|
|
106
|
-
```
|
|
107
|
-
|
|
108
|
-
### 4.2 Context Engineer
|
|
109
|
-
|
|
110
|
-
Use antes de tarefa pesada, refator multi-arquivo, analise longa ou quando o assunto envolve tokens/cache.
|
|
111
|
-
|
|
112
|
-
Responsabilidades:
|
|
113
|
-
|
|
114
|
-
- Montar contexto inteligente.
|
|
115
|
-
- Gerar `.context/context-*.md`.
|
|
116
|
-
- Medir e reduzir tokens.
|
|
117
|
-
- Compactar memoria quando necessario.
|
|
118
|
-
|
|
119
|
-
Comandos tipicos:
|
|
120
|
-
|
|
121
|
-
```bash
|
|
122
|
-
npm run dev -- context:build global <projeto>
|
|
123
|
-
npm run dev -- context:build domain <projeto> "<dominio>"
|
|
124
|
-
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
125
|
-
npm run memory:vacuum
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
### 4.3 Product
|
|
129
|
-
|
|
130
|
-
Use quando ainda nao esta claro o que deve ser entregue.
|
|
131
|
-
|
|
132
|
-
Responsabilidades:
|
|
133
|
-
|
|
134
|
-
- Criar `spec.md`.
|
|
135
|
-
- Definir problema, proposta de valor, user stories e escopo.
|
|
136
|
-
- Definir metrica de sucesso em 30 dias.
|
|
137
|
-
- Priorizar backlog via RICE.
|
|
138
|
-
|
|
139
|
-
Comandos tipicos:
|
|
140
|
-
|
|
141
|
-
```bash
|
|
142
|
-
npm run spec:new -- <slug>
|
|
143
|
-
npm run spec:check -- <slug>
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
### 4.4 SDD Architect
|
|
147
|
-
|
|
148
|
-
Use quando a spec esta aprovada e precisa virar plano tecnico.
|
|
149
|
-
|
|
150
|
-
Responsabilidades:
|
|
151
|
-
|
|
152
|
-
- Criar `plan.md`.
|
|
153
|
-
- Criar `tasks.md`.
|
|
154
|
-
- Abrir ADRs quando houver decisao estrutural.
|
|
155
|
-
- Recusar specs vagas.
|
|
156
|
-
|
|
157
|
-
Comandos tipicos:
|
|
158
|
-
|
|
159
|
-
```bash
|
|
160
|
-
npm run spec:plan -- <slug>
|
|
161
|
-
npm run spec:tasks -- <slug>
|
|
162
|
-
npm run gsd:handoff -- plan <slug>
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
### 4.5 Marketing
|
|
166
|
-
|
|
167
|
-
Use antes de release, landing, copy, posicionamento, instrumentacao AARRR ou analise pos-launch.
|
|
168
|
-
|
|
169
|
-
Responsabilidades:
|
|
170
|
-
|
|
171
|
-
- Escrever copy conectada a dor da spec.
|
|
172
|
-
- Propor eventos de funil.
|
|
173
|
-
- Analisar metricas reais.
|
|
174
|
-
|
|
175
|
-
Nao faz:
|
|
176
|
-
|
|
177
|
-
- Inventar numeros.
|
|
178
|
-
- Decidir arquitetura.
|
|
179
|
-
- Mudar escopo tecnico.
|
|
180
|
-
|
|
181
|
-
### 4.6 Governance
|
|
182
|
-
|
|
183
|
-
Use antes de merge, release ou encerramento de sprint.
|
|
184
|
-
|
|
185
|
-
Responsabilidades:
|
|
186
|
-
|
|
187
|
-
- Rodar checks.
|
|
188
|
-
- Auditar handoffs.
|
|
189
|
-
- Validar criterios de aceite.
|
|
190
|
-
- Bloquear entrega se houver risco, falta de spec, falta de teste ou quebra de seguranca.
|
|
191
|
-
|
|
192
|
-
Comandos tipicos:
|
|
193
|
-
|
|
194
|
-
```bash
|
|
195
|
-
npm run gsd:check -- <slug>
|
|
196
|
-
npm run spec:check -- <slug>
|
|
197
|
-
npm test
|
|
198
|
-
npm run project:check
|
|
199
|
-
```
|
|
200
|
-
|
|
201
|
-
## 5. Fluxo SDD
|
|
202
|
-
|
|
203
|
-
SDD significa Spec-Driven Development. O codigo so deve vir depois de clareza.
|
|
204
|
-
|
|
205
|
-
Fluxo:
|
|
206
|
-
|
|
207
|
-
```text
|
|
208
|
-
Product -> spec.md -> por que fazer
|
|
209
|
-
SDD Architect -> plan.md -> como fazer
|
|
210
|
-
SDD Architect -> tasks.md -> passos executaveis
|
|
211
|
-
Worker -> codigo -> implementacao
|
|
212
|
-
Governance -> checks -> validacao
|
|
213
|
-
```
|
|
214
|
-
|
|
215
|
-
### 5.1 Spec
|
|
216
|
-
|
|
217
|
-
Arquivo:
|
|
218
|
-
|
|
219
|
-
```text
|
|
220
|
-
specs/<slug>/spec.md
|
|
221
|
-
```
|
|
222
|
-
|
|
223
|
-
Deve responder:
|
|
224
|
-
|
|
225
|
-
- Qual problema esta sendo resolvido?
|
|
226
|
-
- Quem sente essa dor?
|
|
227
|
-
- O que fica dentro e fora do escopo?
|
|
228
|
-
- Quais criterios de aceite provam que acabou?
|
|
229
|
-
- Quais restricoes existem?
|
|
230
|
-
- Qual metrica de sucesso em 30 dias?
|
|
231
|
-
|
|
232
|
-
Criar spec:
|
|
233
|
-
|
|
234
|
-
```bash
|
|
235
|
-
npm run spec:new -- <slug>
|
|
236
|
-
```
|
|
237
|
-
|
|
238
|
-
Validar spec:
|
|
239
|
-
|
|
240
|
-
```bash
|
|
241
|
-
npm run spec:check -- <slug>
|
|
242
|
-
```
|
|
243
|
-
|
|
244
|
-
### 5.2 Plan
|
|
245
|
-
|
|
246
|
-
Arquivo:
|
|
247
|
-
|
|
248
|
-
```text
|
|
249
|
-
specs/<slug>/plan.md
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
Deve responder:
|
|
253
|
-
|
|
254
|
-
- Qual abordagem tecnica?
|
|
255
|
-
- Quais modulos mudam?
|
|
256
|
-
- Quais contratos/API/CLI/schema mudam?
|
|
257
|
-
- Quais decisoes foram tomadas?
|
|
258
|
-
- Quais alternativas foram rejeitadas?
|
|
259
|
-
- Precisa de ADR?
|
|
260
|
-
|
|
261
|
-
Gerar plan:
|
|
262
|
-
|
|
263
|
-
```bash
|
|
264
|
-
npm run spec:plan -- <slug>
|
|
265
|
-
```
|
|
266
|
-
|
|
267
|
-
Regra: `spec:plan` so deve rodar quando a spec estiver aprovada.
|
|
268
|
-
|
|
269
|
-
### 5.3 Tasks
|
|
270
|
-
|
|
271
|
-
Arquivo:
|
|
272
|
-
|
|
273
|
-
```text
|
|
274
|
-
specs/<slug>/tasks.md
|
|
275
|
-
```
|
|
276
|
-
|
|
277
|
-
Deve conter tarefas executaveis com:
|
|
278
|
-
|
|
279
|
-
- ID da tarefa.
|
|
280
|
-
- Owner.
|
|
281
|
-
- Dependencias.
|
|
282
|
-
- Paths afetados.
|
|
283
|
-
- Criterio de done.
|
|
284
|
-
|
|
285
|
-
Gerar tasks:
|
|
286
|
-
|
|
287
|
-
```bash
|
|
288
|
-
npm run spec:tasks -- <slug>
|
|
289
|
-
```
|
|
290
|
-
|
|
291
|
-
Regra: `spec:tasks` so deve rodar quando o plano estiver aprovado.
|
|
292
|
-
|
|
293
|
-
## 6. Fluxo GSD
|
|
294
|
-
|
|
295
|
-
GSD e o harness de execucao. Ele cria e valida um runbook para a entrega.
|
|
296
|
-
|
|
297
|
-
Criar runbook:
|
|
298
|
-
|
|
299
|
-
```bash
|
|
300
|
-
npm run gsd:plan -- <slug> "<objetivo>"
|
|
301
|
-
```
|
|
302
|
-
|
|
303
|
-
Isso gera:
|
|
304
|
-
|
|
305
|
-
```text
|
|
306
|
-
.context/gsd-<slug>.md
|
|
307
|
-
```
|
|
308
|
-
|
|
309
|
-
Esse arquivo acompanha os gates:
|
|
310
|
-
|
|
311
|
-
1. Briefing.
|
|
312
|
-
2. Estrutura.
|
|
313
|
-
3. Sprints.
|
|
314
|
-
4. Contexto.
|
|
315
|
-
5. Spec.
|
|
316
|
-
6. Design, somente se houver UI.
|
|
317
|
-
7. Plano.
|
|
318
|
-
8. Desenvolvimento.
|
|
319
|
-
9. Validacao.
|
|
320
|
-
10. Governance.
|
|
321
|
-
|
|
322
|
-
Validar:
|
|
323
|
-
|
|
324
|
-
```bash
|
|
325
|
-
npm run gsd:check -- <slug>
|
|
326
|
-
```
|
|
327
|
-
|
|
328
|
-
Se houver impacto visual:
|
|
329
|
-
|
|
330
|
-
```bash
|
|
331
|
-
npm run design:select -- agent-console tecnico
|
|
332
|
-
npm run design:check -- design-md/examples/agent-console-brief.md
|
|
333
|
-
npm run gsd:check -- <slug> design-md/examples/agent-console-brief.md
|
|
334
|
-
```
|
|
335
|
-
|
|
336
|
-
Se nao houver UI, nao passe brief. O fluxo CLI-only nao deve ser bloqueado por design.
|
|
337
|
-
|
|
338
|
-
## 7. Handoffs Hermes
|
|
339
|
-
|
|
340
|
-
Handoff e passagem formal de responsabilidade.
|
|
341
|
-
|
|
342
|
-
Todo handoff precisa dos 7 campos da ADR-0005:
|
|
343
|
-
|
|
344
|
-
| Campo | Significado |
|
|
345
|
-
|---|---|
|
|
346
|
-
| `from` | Quem esta entregando |
|
|
347
|
-
| `to` | Quem recebe |
|
|
348
|
-
| `intent` | Intencao da passagem |
|
|
349
|
-
| `context` | Contexto minimo para continuar |
|
|
350
|
-
| `acceptance` | Como saber que o trabalho foi aceito |
|
|
351
|
-
| `constraints` | Restrições obrigatorias |
|
|
352
|
-
| `return` | Para quem devolver |
|
|
353
|
-
|
|
354
|
-
Comando generico:
|
|
355
|
-
|
|
356
|
-
```bash
|
|
357
|
-
npm run hermes:handoff -- '{"from":"orchestrator","to":"product","intent":"spec","context":"specs/<slug>","acceptance":"spec aprovada com AC testaveis","constraints":"pt-BR; nao implementar codigo","return":"orchestrator"}'
|
|
358
|
-
```
|
|
359
|
-
|
|
360
|
-
Atalhos do GSD:
|
|
361
|
-
|
|
362
|
-
```bash
|
|
363
|
-
npm run gsd:handoff -- spec <slug>
|
|
364
|
-
npm run gsd:handoff -- plan <slug>
|
|
365
|
-
npm run gsd:handoff -- implement <slug>
|
|
366
|
-
npm run gsd:handoff -- review <slug>
|
|
367
|
-
```
|
|
368
|
-
|
|
369
|
-
Ordem recomendada:
|
|
370
|
-
|
|
371
|
-
```text
|
|
372
|
-
Orchestrator -> Product spec
|
|
373
|
-
Product -> SDD Architect plan
|
|
374
|
-
SDD Architect-> Worker implement
|
|
375
|
-
Worker -> Governance review
|
|
376
|
-
Governance -> Orchestrator fechamento
|
|
377
|
-
```
|
|
378
|
-
|
|
379
|
-
## 8. Sprints
|
|
380
|
-
|
|
381
|
-
O acompanhamento de sprint fica em:
|
|
382
|
-
|
|
383
|
-
```text
|
|
384
|
-
memory/40-delivery/current-sprint.md
|
|
385
|
-
```
|
|
386
|
-
|
|
387
|
-
O backlog fica em:
|
|
388
|
-
|
|
389
|
-
```text
|
|
390
|
-
memory/40-delivery/backlog.md
|
|
391
|
-
```
|
|
392
|
-
|
|
393
|
-
### 8.1 Iniciar sprint no framework raiz
|
|
394
|
-
|
|
395
|
-
```bash
|
|
396
|
-
npm run sprint:start
|
|
397
|
-
```
|
|
398
|
-
|
|
399
|
-
O script busca itens de alta prioridade. Se o backlog estiver em tabela RICE, ele seleciona itens `P0` e `P1`.
|
|
400
|
-
|
|
401
|
-
### 8.2 Ver status
|
|
402
|
-
|
|
403
|
-
```bash
|
|
404
|
-
npm run sprint:status
|
|
405
|
-
```
|
|
406
|
-
|
|
407
|
-
### 8.3 Encerrar sprint
|
|
408
|
-
|
|
409
|
-
```bash
|
|
410
|
-
npm run sprint:complete
|
|
411
|
-
```
|
|
412
|
-
|
|
413
|
-
O fechamento cria relatorio em:
|
|
414
|
-
|
|
415
|
-
```text
|
|
416
|
-
memory/60-runs/sprint-close-<timestamp>.md
|
|
417
|
-
```
|
|
418
|
-
|
|
419
|
-
### 8.4 Operar sprint de um projeto no workspace
|
|
420
|
-
|
|
421
|
-
```bash
|
|
422
|
-
npm run sprint:start -- NomeDoProjeto
|
|
423
|
-
npm run sprint:status -- NomeDoProjeto
|
|
424
|
-
npm run sprint:complete -- NomeDoProjeto
|
|
425
|
-
```
|
|
426
|
-
|
|
427
|
-
Os projetos de produto vivem em `~/forja-workspace/projects/<NomeDoProjeto>` (configurável via `FORJA_WORKSPACE` ou `~/.forjarc.json`). Veja ADR-0019.
|
|
428
|
-
|
|
429
|
-
## 9. Rotina Recomendada
|
|
430
|
-
|
|
431
|
-
### 9.1 Inicio do dia
|
|
432
|
-
|
|
433
|
-
```bash
|
|
434
|
-
git status --short
|
|
435
|
-
npm run sprint:status
|
|
436
|
-
npm run spec:check
|
|
437
|
-
```
|
|
438
|
-
|
|
439
|
-
Leia:
|
|
440
|
-
|
|
441
|
-
```bash
|
|
442
|
-
memory/40-delivery/current-sprint.md
|
|
443
|
-
```
|
|
444
|
-
|
|
445
|
-
Escolha uma entrega e confirme se existe:
|
|
446
|
-
|
|
447
|
-
```text
|
|
448
|
-
specs/<slug>/spec.md
|
|
449
|
-
specs/<slug>/plan.md
|
|
450
|
-
specs/<slug>/tasks.md
|
|
451
|
-
```
|
|
452
|
-
|
|
453
|
-
### 9.2 Antes de mexer em codigo
|
|
454
|
-
|
|
455
|
-
```bash
|
|
456
|
-
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
457
|
-
npm run gsd:plan -- <slug> "<objetivo>"
|
|
458
|
-
npm run gsd:handoff -- implement <slug>
|
|
459
|
-
```
|
|
460
|
-
|
|
461
|
-
Leia:
|
|
462
|
-
|
|
463
|
-
```text
|
|
464
|
-
.context/gsd-<slug>.md
|
|
465
|
-
specs/<slug>/tasks.md
|
|
466
|
-
```
|
|
467
|
-
|
|
468
|
-
### 9.3 Durante a implementacao
|
|
469
|
-
|
|
470
|
-
Mantenha foco em:
|
|
471
|
-
|
|
472
|
-
- Paths definidos em `tasks.md`.
|
|
473
|
-
- Criterios de aceite da spec.
|
|
474
|
-
- Contratos do plano.
|
|
475
|
-
- Nenhuma refatoracao fora do escopo.
|
|
476
|
-
|
|
477
|
-
Checklist local:
|
|
478
|
-
|
|
479
|
-
```bash
|
|
480
|
-
npm run spec:check -- <slug>
|
|
481
|
-
npm run gsd:check -- <slug>
|
|
482
|
-
```
|
|
483
|
-
|
|
484
|
-
### 9.4 Antes de entregar
|
|
485
|
-
|
|
486
|
-
```bash
|
|
487
|
-
npm run gsd:handoff -- review <slug>
|
|
488
|
-
npm run gsd:check -- <slug>
|
|
489
|
-
npm run spec:check -- <slug>
|
|
490
|
-
npm test
|
|
491
|
-
npm run project:check
|
|
492
|
-
```
|
|
493
|
-
|
|
494
|
-
Se algum comando falhar, nao entregue como pronto. Registre a pendencia no handoff ou em `tasks.md`.
|
|
495
|
-
|
|
496
|
-
### 9.5 Fechamento da sprint
|
|
497
|
-
|
|
498
|
-
```bash
|
|
499
|
-
npm run sprint:status
|
|
500
|
-
npm run sprint:complete
|
|
501
|
-
```
|
|
502
|
-
|
|
503
|
-
Depois consolide memoria:
|
|
504
|
-
|
|
505
|
-
```bash
|
|
506
|
-
npm run memory:vacuum
|
|
507
|
-
npm run sync:universal
|
|
508
|
-
```
|
|
509
|
-
|
|
510
|
-
## 10. Governanca
|
|
511
|
-
|
|
512
|
-
Governance nao e opiniao. Governance e evidencia.
|
|
513
|
-
|
|
514
|
-
Uma entrega so esta pronta quando:
|
|
515
|
-
|
|
516
|
-
- A spec existe e esta coerente.
|
|
517
|
-
- O plano existe quando houve decisao tecnica.
|
|
518
|
-
- As tasks refletem o que foi implementado.
|
|
519
|
-
- O GSD check passa.
|
|
520
|
-
- Testes relevantes passaram.
|
|
521
|
-
- `project:check` passou.
|
|
522
|
-
- Handoffs foram registrados.
|
|
523
|
-
- Riscos residuais foram explicitados.
|
|
524
|
-
|
|
525
|
-
Comandos:
|
|
526
|
-
|
|
527
|
-
```bash
|
|
528
|
-
npm run gsd:check -- <slug>
|
|
529
|
-
npm run spec:check -- <slug>
|
|
530
|
-
npm test
|
|
531
|
-
npm run project:check
|
|
532
|
-
```
|
|
533
|
-
|
|
534
|
-
`project:check` sem argumento valida o framework raiz. Com argumento, valida projeto em `~/forja-workspace/projects/<nome>`.
|
|
535
|
-
|
|
536
|
-
```bash
|
|
537
|
-
npm run project:check
|
|
538
|
-
npm run project:check -- NomeDoProjeto
|
|
539
|
-
```
|
|
540
|
-
|
|
541
|
-
## 11. Contexto e Memoria
|
|
542
|
-
|
|
543
|
-
Use contexto inteligente para reduzir custo mental e tokens.
|
|
544
|
-
|
|
545
|
-
Modos:
|
|
546
|
-
|
|
547
|
-
| Modo | Uso |
|
|
548
|
-
|---|---|
|
|
549
|
-
| `global` | Entender padroes gerais |
|
|
550
|
-
| `domain` | Entender um dominio especifico |
|
|
551
|
-
| `task` | Executar uma entrega |
|
|
552
|
-
|
|
553
|
-
Comandos:
|
|
554
|
-
|
|
555
|
-
```bash
|
|
556
|
-
npm run dev -- context:build global <projeto>
|
|
557
|
-
npm run dev -- context:build domain <projeto> "<dominio>"
|
|
558
|
-
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
559
|
-
```
|
|
560
|
-
|
|
561
|
-
Memoria relevante:
|
|
562
|
-
|
|
563
|
-
```text
|
|
564
|
-
memory/00-global/ Missao e padroes
|
|
565
|
-
memory/10-product/ Produto e personas
|
|
566
|
-
memory/20-architecture/ Arquitetura
|
|
567
|
-
memory/40-delivery/ Backlog e sprint
|
|
568
|
-
memory/50-orchestration Protocolos
|
|
569
|
-
memory/60-runs/ Logs e fechamentos
|
|
570
|
-
memory/90-decisions/ ADRs
|
|
571
|
-
|
|
572
|
-
# Workspace (fora do repo do framework)
|
|
573
|
-
~/forja-workspace/projects/ Projetos de produto
|
|
574
|
-
~/forja-workspace/memory/30-projects/ Projetos rastreados
|
|
575
|
-
~/forja-workspace/memory/sqlite/ Memoria universal
|
|
576
|
-
```
|
|
577
|
-
|
|
578
|
-
Sincronizar memoria universal:
|
|
579
|
-
|
|
580
|
-
```bash
|
|
581
|
-
npm run sync:universal
|
|
582
|
-
```
|
|
583
|
-
|
|
584
|
-
Consultar memoria:
|
|
585
|
-
|
|
586
|
-
```bash
|
|
587
|
-
npm run query:universal -- "<termo>"
|
|
588
|
-
```
|
|
589
|
-
|
|
590
|
-
Compactar:
|
|
591
|
-
|
|
592
|
-
```bash
|
|
593
|
-
npm run memory:vacuum
|
|
594
|
-
```
|
|
595
|
-
|
|
596
|
-
## 12. Potencia de Desenvolvimento e Economia de Tokens
|
|
597
|
-
|
|
598
|
-
Use estes comandos para transformar contexto em artefatos pequenos, medidos e reutilizaveis.
|
|
599
|
-
|
|
600
|
-
### 12.1 Schema auxiliar do banco
|
|
601
|
-
|
|
602
|
-
```bash
|
|
603
|
-
npm run memory:schema
|
|
604
|
-
```
|
|
605
|
-
|
|
606
|
-
Cria tabelas aditivas em `~/forja-workspace/memory/sqlite/universal.db`:
|
|
607
|
-
|
|
608
|
-
| Tabela | Uso |
|
|
609
|
-
|---|---|
|
|
610
|
-
| `spec_summaries` | resumo compacto por spec |
|
|
611
|
-
| `context_runs` | historico de contextos gerados e budget |
|
|
612
|
-
| `asset_catalog` | boilerplates e referencias design-md catalogados |
|
|
613
|
-
|
|
614
|
-
Essas tabelas nao substituem `memory_nodes` nem `handoffs`. Elas melhoram consulta e governanca sem quebrar o schema principal.
|
|
615
|
-
|
|
616
|
-
### 12.2 Sprint pack
|
|
617
|
-
|
|
618
|
-
```bash
|
|
619
|
-
npm run context:sprint
|
|
620
|
-
```
|
|
621
|
-
|
|
622
|
-
Gera:
|
|
623
|
-
|
|
624
|
-
```text
|
|
625
|
-
.context/sprint-pack.md
|
|
626
|
-
```
|
|
627
|
-
|
|
628
|
-
Use como primeiro contexto de qualquer sessao. Ele inclui somente sprint atual, specs ativas, handoffs abertos e ADRs recentes.
|
|
629
|
-
|
|
630
|
-
### 12.3 Agent brief
|
|
631
|
-
|
|
632
|
-
```bash
|
|
633
|
-
npm run agent:brief -- <role> <slug>
|
|
634
|
-
```
|
|
635
|
-
|
|
636
|
-
Exemplo:
|
|
637
|
-
|
|
638
|
-
```bash
|
|
639
|
-
npm run agent:brief -- governance dev-token-assets-db
|
|
640
|
-
```
|
|
641
|
-
|
|
642
|
-
Gera:
|
|
643
|
-
|
|
644
|
-
```text
|
|
645
|
-
.context/agent-brief-<role>-<slug>.md
|
|
646
|
-
```
|
|
647
|
-
|
|
648
|
-
Use antes de chamar um agente especifico. Ele evita carregar `spec.md`, `plan.md` e `tasks.md` completos quando um resumo operacional basta.
|
|
649
|
-
|
|
650
|
-
### 12.4 Token budget
|
|
651
|
-
|
|
652
|
-
```bash
|
|
653
|
-
npm run context:budget -- <slug|arquivo> [limite]
|
|
654
|
-
```
|
|
655
|
-
|
|
656
|
-
Exemplos:
|
|
657
|
-
|
|
658
|
-
```bash
|
|
659
|
-
npm run context:budget -- .context/sprint-pack.md
|
|
660
|
-
npm run context:budget -- .context/asset-catalog.md 12000
|
|
661
|
-
```
|
|
662
|
-
|
|
663
|
-
Padrao: usa `tokenLimits.task` de `.memoryrc.json`, hoje 8000 tokens.
|
|
664
|
-
|
|
665
|
-
Se passar do limite, o comando falha. Isso deve ser tratado como sinal de contexto inchado.
|
|
666
|
-
|
|
667
|
-
### 12.5 Catalogo de boilerplates e design system
|
|
668
|
-
|
|
669
|
-
Gere ou atualize manifests normalizados:
|
|
670
|
-
|
|
671
|
-
```bash
|
|
672
|
-
npm run catalog:manifests
|
|
673
|
-
```
|
|
674
|
-
|
|
675
|
-
Isso cria:
|
|
676
|
-
|
|
677
|
-
```text
|
|
678
|
-
boilerplates/<nome>/boilerplate.manifest.json
|
|
679
|
-
design-md/<nome>/design.manifest.json
|
|
680
|
-
```
|
|
681
|
-
|
|
682
|
-
Depois gere o catalogo:
|
|
683
|
-
|
|
684
|
-
```bash
|
|
685
|
-
npm run catalog:assets
|
|
686
|
-
```
|
|
687
|
-
|
|
688
|
-
Gera:
|
|
689
|
-
|
|
690
|
-
```text
|
|
691
|
-
.context/asset-catalog.md
|
|
692
|
-
```
|
|
693
|
-
|
|
694
|
-
Tambem popula `asset_catalog` no SQLite com:
|
|
695
|
-
|
|
696
|
-
- boilerplates
|
|
697
|
-
- referencias de `design-md`
|
|
698
|
-
- caminho do README
|
|
699
|
-
- resumo curto
|
|
700
|
-
- tags vindas dos manifests
|
|
701
|
-
|
|
702
|
-
Use antes de escolher base tecnica ou referencia visual.
|
|
703
|
-
|
|
704
|
-
### 12.6 Benchmark de tokens
|
|
705
|
-
|
|
706
|
-
```bash
|
|
707
|
-
npm run token:benchmark
|
|
708
|
-
```
|
|
709
|
-
|
|
710
|
-
Use para comparar contexto completo versus modos `global`, `domain` e `task`.
|
|
711
|
-
|
|
712
|
-
## 13. Design e Web
|
|
713
|
-
|
|
714
|
-
Design entra apenas quando existe impacto visual real.
|
|
715
|
-
|
|
716
|
-
Use:
|
|
717
|
-
|
|
718
|
-
```bash
|
|
719
|
-
npm run design:select -- <surface> <tom>
|
|
720
|
-
npm run design:check -- <brief.md>
|
|
721
|
-
```
|
|
722
|
-
|
|
723
|
-
Exemplo:
|
|
724
|
-
|
|
725
|
-
```bash
|
|
726
|
-
npm run design:select -- agent-console tecnico
|
|
727
|
-
npm run design:check -- design-md/examples/agent-console-brief.md
|
|
728
|
-
```
|
|
729
|
-
|
|
730
|
-
Nao use design como etapa obrigatoria para:
|
|
731
|
-
|
|
732
|
-
- CLI.
|
|
733
|
-
- Scripts.
|
|
734
|
-
- Specs.
|
|
735
|
-
- Handoffs.
|
|
736
|
-
- Checks.
|
|
737
|
-
- Refatoracoes sem interface.
|
|
738
|
-
|
|
739
|
-
Dashboard:
|
|
740
|
-
|
|
741
|
-
```bash
|
|
742
|
-
npm run dashboard
|
|
743
|
-
```
|
|
744
|
-
|
|
745
|
-
Use somente para consulta visual ou depuracao de telas. Nao trate como fonte primaria de operacao.
|
|
746
|
-
|
|
747
|
-
## 14. Comandos por Objetivo
|
|
748
|
-
|
|
749
|
-
### Criar nova entrega
|
|
750
|
-
|
|
751
|
-
```bash
|
|
752
|
-
npm run spec:new -- <slug>
|
|
753
|
-
npm run gsd:plan -- <slug> "<objetivo>"
|
|
754
|
-
npm run gsd:handoff -- spec <slug>
|
|
755
|
-
```
|
|
756
|
-
|
|
757
|
-
### Planejar entrega aprovada
|
|
758
|
-
|
|
759
|
-
```bash
|
|
760
|
-
npm run spec:plan -- <slug>
|
|
761
|
-
npm run spec:tasks -- <slug>
|
|
762
|
-
npm run gsd:handoff -- plan <slug>
|
|
763
|
-
```
|
|
764
|
-
|
|
765
|
-
### Implementar
|
|
766
|
-
|
|
767
|
-
```bash
|
|
768
|
-
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
769
|
-
npm run gsd:handoff -- implement <slug>
|
|
770
|
-
```
|
|
771
|
-
|
|
772
|
-
### Revisar
|
|
773
|
-
|
|
774
|
-
```bash
|
|
775
|
-
npm run gsd:handoff -- review <slug>
|
|
776
|
-
npm run gsd:check -- <slug>
|
|
777
|
-
npm run spec:check -- <slug>
|
|
778
|
-
npm test
|
|
779
|
-
npm run project:check
|
|
780
|
-
```
|
|
781
|
-
|
|
782
|
-
### Auditar todas as specs
|
|
783
|
-
|
|
784
|
-
```bash
|
|
785
|
-
npm run spec:check
|
|
786
|
-
```
|
|
787
|
-
|
|
788
|
-
### Ver sprint
|
|
789
|
-
|
|
790
|
-
```bash
|
|
791
|
-
npm run sprint:status
|
|
792
|
-
```
|
|
793
|
-
|
|
794
|
-
### Encerrar sprint
|
|
795
|
-
|
|
796
|
-
```bash
|
|
797
|
-
npm run sprint:complete
|
|
798
|
-
```
|
|
799
|
-
|
|
800
|
-
## 15. Padroes de Qualidade
|
|
801
|
-
|
|
802
|
-
### 14.1 Uma spec boa
|
|
803
|
-
|
|
804
|
-
Uma spec boa tem:
|
|
805
|
-
|
|
806
|
-
- Problema concreto.
|
|
807
|
-
- Persona clara.
|
|
808
|
-
- Criterios de aceite testaveis.
|
|
809
|
-
- Escopo fora explicito.
|
|
810
|
-
- NFRs objetivos.
|
|
811
|
-
- Metrica de sucesso.
|
|
812
|
-
|
|
813
|
-
Uma spec ruim diz:
|
|
814
|
-
|
|
815
|
-
- "Melhorar o sistema."
|
|
816
|
-
- "Deixar mais bonito."
|
|
817
|
-
- "Fazer funcionar."
|
|
818
|
-
- "Otimizar performance" sem numero.
|
|
819
|
-
|
|
820
|
-
### 14.2 Um plan bom
|
|
821
|
-
|
|
822
|
-
Um plan bom tem:
|
|
823
|
-
|
|
824
|
-
- Modulos afetados.
|
|
825
|
-
- Contratos alterados.
|
|
826
|
-
- Riscos.
|
|
827
|
-
- Alternativas rejeitadas.
|
|
828
|
-
- Necessidade ou nao de ADR.
|
|
829
|
-
|
|
830
|
-
### 14.3 Tasks boas
|
|
831
|
-
|
|
832
|
-
Tasks boas tem:
|
|
833
|
-
|
|
834
|
-
- Owner.
|
|
835
|
-
- Paths.
|
|
836
|
-
- Dependencias.
|
|
837
|
-
- Done verificavel.
|
|
838
|
-
- Teste ou check associado.
|
|
839
|
-
|
|
840
|
-
### 14.4 Handoff bom
|
|
841
|
-
|
|
842
|
-
Handoff bom permite que outro agente continue sem perguntar:
|
|
843
|
-
|
|
844
|
-
- O que foi feito?
|
|
845
|
-
- O que falta?
|
|
846
|
-
- Onde esta o contexto?
|
|
847
|
-
- Qual criterio de aceite?
|
|
848
|
-
- Quais restricoes?
|
|
849
|
-
- Para quem devolver?
|
|
850
|
-
|
|
851
|
-
## 16. Erros Comuns
|
|
852
|
-
|
|
853
|
-
### Erro: implementar sem spec
|
|
854
|
-
|
|
855
|
-
Sintoma:
|
|
856
|
-
|
|
857
|
-
```text
|
|
858
|
-
Codigo muda, mas ninguem sabe qual AC ele atende.
|
|
859
|
-
```
|
|
860
|
-
|
|
861
|
-
Correcao:
|
|
862
|
-
|
|
863
|
-
```bash
|
|
864
|
-
npm run spec:new -- <slug>
|
|
865
|
-
```
|
|
866
|
-
|
|
867
|
-
### Erro: plan criado com spec em draft
|
|
868
|
-
|
|
869
|
-
Sintoma:
|
|
870
|
-
|
|
871
|
-
```text
|
|
872
|
-
spec:check falha porque plan existe antes da spec aprovada.
|
|
873
|
-
```
|
|
874
|
-
|
|
875
|
-
Correcao:
|
|
876
|
-
|
|
877
|
-
- Aprovar ou corrigir status da spec.
|
|
878
|
-
- Ou remover plan/tasks se foram criados cedo demais e ainda nao devem existir.
|
|
879
|
-
|
|
880
|
-
### Erro: design bloqueando CLI
|
|
881
|
-
|
|
882
|
-
Sintoma:
|
|
883
|
-
|
|
884
|
-
```text
|
|
885
|
-
Entrega sem UI tentando passar por design:check.
|
|
886
|
-
```
|
|
887
|
-
|
|
888
|
-
Correcao:
|
|
889
|
-
|
|
890
|
-
```bash
|
|
891
|
-
npm run gsd:check -- <slug>
|
|
892
|
-
```
|
|
893
|
-
|
|
894
|
-
Sem brief visual.
|
|
895
|
-
|
|
896
|
-
### Erro: sprint sem criterio de fechamento
|
|
897
|
-
|
|
898
|
-
Sintoma:
|
|
899
|
-
|
|
900
|
-
```text
|
|
901
|
-
Itens ficam eternamente em current-sprint.md.
|
|
902
|
-
```
|
|
903
|
-
|
|
904
|
-
Correcao:
|
|
905
|
-
|
|
906
|
-
```bash
|
|
907
|
-
npm run sprint:complete
|
|
908
|
-
```
|
|
909
|
-
|
|
910
|
-
Pendencias voltam para backlog quando aplicavel.
|
|
911
|
-
|
|
912
|
-
## 17. Exemplo Completo
|
|
913
|
-
|
|
914
|
-
Objetivo: criar uma feature `inventario-ativos`.
|
|
915
|
-
|
|
916
|
-
### 16.1 Criar spec
|
|
917
|
-
|
|
918
|
-
```bash
|
|
919
|
-
npm run spec:new -- inventario-ativos
|
|
920
|
-
```
|
|
921
|
-
|
|
922
|
-
Editar:
|
|
923
|
-
|
|
924
|
-
```text
|
|
925
|
-
specs/inventario-ativos/spec.md
|
|
926
|
-
```
|
|
927
|
-
|
|
928
|
-
Quando aprovada:
|
|
929
|
-
|
|
930
|
-
```bash
|
|
931
|
-
npm run spec:check -- inventario-ativos
|
|
932
|
-
```
|
|
933
|
-
|
|
934
|
-
### 16.2 Criar runbook GSD
|
|
935
|
-
|
|
936
|
-
```bash
|
|
937
|
-
npm run gsd:plan -- inventario-ativos "criar inventario multiempresa e CRUD de ativos"
|
|
938
|
-
```
|
|
939
|
-
|
|
940
|
-
### 16.3 Registrar handoff para Product
|
|
941
|
-
|
|
942
|
-
```bash
|
|
943
|
-
npm run gsd:handoff -- spec inventario-ativos
|
|
944
|
-
```
|
|
945
|
-
|
|
946
|
-
### 16.4 Planejar
|
|
947
|
-
|
|
948
|
-
```bash
|
|
949
|
-
npm run spec:plan -- inventario-ativos
|
|
950
|
-
npm run spec:tasks -- inventario-ativos
|
|
951
|
-
npm run gsd:handoff -- plan inventario-ativos
|
|
952
|
-
```
|
|
953
|
-
|
|
954
|
-
### 16.5 Implementar
|
|
955
|
-
|
|
956
|
-
```bash
|
|
957
|
-
npm run dev -- context:build task inventario-ativos "inventario ativos CRUD empresa"
|
|
958
|
-
npm run gsd:handoff -- implement inventario-ativos
|
|
959
|
-
```
|
|
960
|
-
|
|
961
|
-
Implementar somente o que esta em `tasks.md`.
|
|
962
|
-
|
|
963
|
-
### 16.6 Revisar
|
|
964
|
-
|
|
965
|
-
```bash
|
|
966
|
-
npm run gsd:handoff -- review inventario-ativos
|
|
967
|
-
npm run gsd:check -- inventario-ativos
|
|
968
|
-
npm run spec:check -- inventario-ativos
|
|
969
|
-
npm test
|
|
970
|
-
npm run project:check
|
|
971
|
-
```
|
|
972
|
-
|
|
973
|
-
### 16.7 Fechar sprint
|
|
974
|
-
|
|
975
|
-
```bash
|
|
976
|
-
npm run sprint:status
|
|
977
|
-
npm run sprint:complete
|
|
978
|
-
```
|
|
979
|
-
|
|
980
|
-
## 18. Checklist de Excelencia
|
|
981
|
-
|
|
982
|
-
Antes de dizer "pronto", confira:
|
|
983
|
-
|
|
984
|
-
- [ ] Existe `spec.md`.
|
|
985
|
-
- [ ] Existe `plan.md` quando houve decisao tecnica.
|
|
986
|
-
- [ ] Existe `tasks.md`.
|
|
987
|
-
- [ ] Handoff Hermes foi registrado.
|
|
988
|
-
- [ ] `gsd:check` passou.
|
|
989
|
-
- [ ] `spec:check` passou.
|
|
990
|
-
- [ ] Testes relevantes passaram.
|
|
991
|
-
- [ ] `project:check` passou.
|
|
992
|
-
- [ ] Sprint foi atualizada.
|
|
993
|
-
- [ ] Riscos residuais foram reportados.
|
|
994
|
-
- [ ] Web/design nao foi usado como bloqueio quando a tarefa era CLI-only.
|
|
995
|
-
|
|
996
|
-
## 19. Comando de Bolso
|
|
997
|
-
|
|
998
|
-
Para operar uma entrega comum:
|
|
999
|
-
|
|
1000
|
-
```bash
|
|
1001
|
-
npm run sprint:status
|
|
1002
|
-
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
1003
|
-
npm run gsd:plan -- <slug> "<objetivo>"
|
|
1004
|
-
npm run gsd:handoff -- spec <slug>
|
|
1005
|
-
npm run gsd:handoff -- plan <slug>
|
|
1006
|
-
npm run gsd:handoff -- implement <slug>
|
|
1007
|
-
npm run gsd:handoff -- review <slug>
|
|
1008
|
-
npm run gsd:check -- <slug>
|
|
1009
|
-
npm run spec:check -- <slug>
|
|
1010
|
-
npm test
|
|
1011
|
-
npm run project:check
|
|
1012
|
-
```
|
|
1013
|
-
|
|
1014
|
-
Se isso estiver verde, a operacao esta sob controle.
|
|
1
|
+
# Manual Operacional CLI-First, SDD, GSD e Orquestracao
|
|
2
|
+
|
|
3
|
+
Este manual e o guia principal para operar o framework de agentes com excelencia, sem depender do dashboard web. A web fica como consulta opcional. A operacao diaria, o acompanhamento de sprint, as passagens entre papeis, a validacao e a governanca acontecem por linha de comando.
|
|
4
|
+
|
|
5
|
+
## 1. Visao Geral
|
|
6
|
+
|
|
7
|
+
O framework organiza desenvolvimento com agentes em quatro pilares:
|
|
8
|
+
|
|
9
|
+
1. **Orquestracao**: cada demanda passa pelo papel certo, no momento certo.
|
|
10
|
+
2. **SDD**: toda entrega relevante e descrita antes como `spec -> plan -> tasks`.
|
|
11
|
+
3. **GSD**: cada execucao vira um runbook com gates verificaveis.
|
|
12
|
+
4. **Hermes**: toda passagem de responsabilidade vira handoff registrado com 7 campos obrigatorios.
|
|
13
|
+
|
|
14
|
+
O objetivo nao e criar burocracia. O objetivo e impedir retrabalho, decisao perdida, implementacao sem criterio de aceite e sprint sem visibilidade.
|
|
15
|
+
|
|
16
|
+
## 2. Mentalidade CLI-First
|
|
17
|
+
|
|
18
|
+
Use o terminal como console operacional. O dashboard nao deve ser necessario para responder:
|
|
19
|
+
|
|
20
|
+
- O que esta na sprint?
|
|
21
|
+
- Qual spec esta ativa?
|
|
22
|
+
- Quem recebeu o handoff?
|
|
23
|
+
- O que falta para implementar?
|
|
24
|
+
- A entrega passou nos gates?
|
|
25
|
+
- O projeto esta pronto para release?
|
|
26
|
+
|
|
27
|
+
Comandos centrais:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npm run sprint:status
|
|
31
|
+
npm run gsd:plan -- <slug> "<objetivo>"
|
|
32
|
+
npm run gsd:handoff -- spec <slug>
|
|
33
|
+
npm run gsd:handoff -- plan <slug>
|
|
34
|
+
npm run gsd:handoff -- implement <slug>
|
|
35
|
+
npm run gsd:handoff -- review <slug>
|
|
36
|
+
npm run gsd:check -- <slug>
|
|
37
|
+
npm run project:check
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## 3. Estrutura do Framework
|
|
41
|
+
|
|
42
|
+
Pastas principais:
|
|
43
|
+
|
|
44
|
+
```text
|
|
45
|
+
AGENTS.md Papéis e regras canonicas
|
|
46
|
+
prompts/ Prompts portaveis por papel
|
|
47
|
+
.claude/agents/ Sub-agents Claude Code
|
|
48
|
+
specs/ Pipeline SDD por feature
|
|
49
|
+
memory/40-delivery/ Backlog e sprint atual
|
|
50
|
+
memory/50-orchestration/ Protocolos de orquestracao
|
|
51
|
+
memory/90-decisions/ ADRs e decisoes estruturais
|
|
52
|
+
scripts/ Harness CLI, sprint, specs, checks
|
|
53
|
+
.context/ Runbooks GSD e context packs
|
|
54
|
+
dashboard/ Web opcional/legada
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Arquivos que voce vai abrir com frequencia:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
AGENTS.md
|
|
61
|
+
docs/manual-operacional-cli-sdd-gsd.md
|
|
62
|
+
docs/cli-first-operacao.md
|
|
63
|
+
memory/40-delivery/backlog.md
|
|
64
|
+
memory/40-delivery/current-sprint.md
|
|
65
|
+
memory/50-orchestration/gsd-harness.md
|
|
66
|
+
specs/<slug>/spec.md
|
|
67
|
+
specs/<slug>/plan.md
|
|
68
|
+
specs/<slug>/tasks.md
|
|
69
|
+
.context/gsd-<slug>.md
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
## 4. Os 6 Papeis
|
|
73
|
+
|
|
74
|
+
Cada papel existe em tres lugares:
|
|
75
|
+
|
|
76
|
+
- `.claude/agents/<name>.md`: sub-agent executavel no Claude Code.
|
|
77
|
+
- `prompts/<name>-agent.md`: prompt portavel para Copilot, Gemini, Codex etc.
|
|
78
|
+
- `AGENTS.md`: referencia canonica de responsabilidade.
|
|
79
|
+
|
|
80
|
+
### 4.1 Orchestrator
|
|
81
|
+
|
|
82
|
+
Use quando a demanda atravessa multiplos papeis ou quando voce quer coordenar uma execucao.
|
|
83
|
+
|
|
84
|
+
Responsabilidades:
|
|
85
|
+
|
|
86
|
+
- Decompor a demanda.
|
|
87
|
+
- Escolher o proximo papel.
|
|
88
|
+
- Criar ou acionar runbook GSD.
|
|
89
|
+
- Registrar handoffs Hermes.
|
|
90
|
+
- Consolidar memoria ao fim de sprint.
|
|
91
|
+
|
|
92
|
+
Nao faz:
|
|
93
|
+
|
|
94
|
+
- Implementacao direta.
|
|
95
|
+
- Decisao de produto sozinho.
|
|
96
|
+
- Aprovar release sem Governance.
|
|
97
|
+
|
|
98
|
+
Comandos tipicos:
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
npm run gsd:plan -- <slug> "<objetivo>"
|
|
102
|
+
npm run gsd:handoff -- spec <slug>
|
|
103
|
+
npm run gsd:handoff -- plan <slug>
|
|
104
|
+
npm run gsd:handoff -- implement <slug>
|
|
105
|
+
npm run gsd:handoff -- review <slug>
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### 4.2 Context Engineer
|
|
109
|
+
|
|
110
|
+
Use antes de tarefa pesada, refator multi-arquivo, analise longa ou quando o assunto envolve tokens/cache.
|
|
111
|
+
|
|
112
|
+
Responsabilidades:
|
|
113
|
+
|
|
114
|
+
- Montar contexto inteligente.
|
|
115
|
+
- Gerar `.context/context-*.md`.
|
|
116
|
+
- Medir e reduzir tokens.
|
|
117
|
+
- Compactar memoria quando necessario.
|
|
118
|
+
|
|
119
|
+
Comandos tipicos:
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
npm run dev -- context:build global <projeto>
|
|
123
|
+
npm run dev -- context:build domain <projeto> "<dominio>"
|
|
124
|
+
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
125
|
+
npm run memory:vacuum
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
### 4.3 Product
|
|
129
|
+
|
|
130
|
+
Use quando ainda nao esta claro o que deve ser entregue.
|
|
131
|
+
|
|
132
|
+
Responsabilidades:
|
|
133
|
+
|
|
134
|
+
- Criar `spec.md`.
|
|
135
|
+
- Definir problema, proposta de valor, user stories e escopo.
|
|
136
|
+
- Definir metrica de sucesso em 30 dias.
|
|
137
|
+
- Priorizar backlog via RICE.
|
|
138
|
+
|
|
139
|
+
Comandos tipicos:
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
npm run spec:new -- <slug>
|
|
143
|
+
npm run spec:check -- <slug>
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### 4.4 SDD Architect
|
|
147
|
+
|
|
148
|
+
Use quando a spec esta aprovada e precisa virar plano tecnico.
|
|
149
|
+
|
|
150
|
+
Responsabilidades:
|
|
151
|
+
|
|
152
|
+
- Criar `plan.md`.
|
|
153
|
+
- Criar `tasks.md`.
|
|
154
|
+
- Abrir ADRs quando houver decisao estrutural.
|
|
155
|
+
- Recusar specs vagas.
|
|
156
|
+
|
|
157
|
+
Comandos tipicos:
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
npm run spec:plan -- <slug>
|
|
161
|
+
npm run spec:tasks -- <slug>
|
|
162
|
+
npm run gsd:handoff -- plan <slug>
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### 4.5 Marketing
|
|
166
|
+
|
|
167
|
+
Use antes de release, landing, copy, posicionamento, instrumentacao AARRR ou analise pos-launch.
|
|
168
|
+
|
|
169
|
+
Responsabilidades:
|
|
170
|
+
|
|
171
|
+
- Escrever copy conectada a dor da spec.
|
|
172
|
+
- Propor eventos de funil.
|
|
173
|
+
- Analisar metricas reais.
|
|
174
|
+
|
|
175
|
+
Nao faz:
|
|
176
|
+
|
|
177
|
+
- Inventar numeros.
|
|
178
|
+
- Decidir arquitetura.
|
|
179
|
+
- Mudar escopo tecnico.
|
|
180
|
+
|
|
181
|
+
### 4.6 Governance
|
|
182
|
+
|
|
183
|
+
Use antes de merge, release ou encerramento de sprint.
|
|
184
|
+
|
|
185
|
+
Responsabilidades:
|
|
186
|
+
|
|
187
|
+
- Rodar checks.
|
|
188
|
+
- Auditar handoffs.
|
|
189
|
+
- Validar criterios de aceite.
|
|
190
|
+
- Bloquear entrega se houver risco, falta de spec, falta de teste ou quebra de seguranca.
|
|
191
|
+
|
|
192
|
+
Comandos tipicos:
|
|
193
|
+
|
|
194
|
+
```bash
|
|
195
|
+
npm run gsd:check -- <slug>
|
|
196
|
+
npm run spec:check -- <slug>
|
|
197
|
+
npm test
|
|
198
|
+
npm run project:check
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
## 5. Fluxo SDD
|
|
202
|
+
|
|
203
|
+
SDD significa Spec-Driven Development. O codigo so deve vir depois de clareza.
|
|
204
|
+
|
|
205
|
+
Fluxo:
|
|
206
|
+
|
|
207
|
+
```text
|
|
208
|
+
Product -> spec.md -> por que fazer
|
|
209
|
+
SDD Architect -> plan.md -> como fazer
|
|
210
|
+
SDD Architect -> tasks.md -> passos executaveis
|
|
211
|
+
Worker -> codigo -> implementacao
|
|
212
|
+
Governance -> checks -> validacao
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
### 5.1 Spec
|
|
216
|
+
|
|
217
|
+
Arquivo:
|
|
218
|
+
|
|
219
|
+
```text
|
|
220
|
+
specs/<slug>/spec.md
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
Deve responder:
|
|
224
|
+
|
|
225
|
+
- Qual problema esta sendo resolvido?
|
|
226
|
+
- Quem sente essa dor?
|
|
227
|
+
- O que fica dentro e fora do escopo?
|
|
228
|
+
- Quais criterios de aceite provam que acabou?
|
|
229
|
+
- Quais restricoes existem?
|
|
230
|
+
- Qual metrica de sucesso em 30 dias?
|
|
231
|
+
|
|
232
|
+
Criar spec:
|
|
233
|
+
|
|
234
|
+
```bash
|
|
235
|
+
npm run spec:new -- <slug>
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
Validar spec:
|
|
239
|
+
|
|
240
|
+
```bash
|
|
241
|
+
npm run spec:check -- <slug>
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
### 5.2 Plan
|
|
245
|
+
|
|
246
|
+
Arquivo:
|
|
247
|
+
|
|
248
|
+
```text
|
|
249
|
+
specs/<slug>/plan.md
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
Deve responder:
|
|
253
|
+
|
|
254
|
+
- Qual abordagem tecnica?
|
|
255
|
+
- Quais modulos mudam?
|
|
256
|
+
- Quais contratos/API/CLI/schema mudam?
|
|
257
|
+
- Quais decisoes foram tomadas?
|
|
258
|
+
- Quais alternativas foram rejeitadas?
|
|
259
|
+
- Precisa de ADR?
|
|
260
|
+
|
|
261
|
+
Gerar plan:
|
|
262
|
+
|
|
263
|
+
```bash
|
|
264
|
+
npm run spec:plan -- <slug>
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
Regra: `spec:plan` so deve rodar quando a spec estiver aprovada.
|
|
268
|
+
|
|
269
|
+
### 5.3 Tasks
|
|
270
|
+
|
|
271
|
+
Arquivo:
|
|
272
|
+
|
|
273
|
+
```text
|
|
274
|
+
specs/<slug>/tasks.md
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
Deve conter tarefas executaveis com:
|
|
278
|
+
|
|
279
|
+
- ID da tarefa.
|
|
280
|
+
- Owner.
|
|
281
|
+
- Dependencias.
|
|
282
|
+
- Paths afetados.
|
|
283
|
+
- Criterio de done.
|
|
284
|
+
|
|
285
|
+
Gerar tasks:
|
|
286
|
+
|
|
287
|
+
```bash
|
|
288
|
+
npm run spec:tasks -- <slug>
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
Regra: `spec:tasks` so deve rodar quando o plano estiver aprovado.
|
|
292
|
+
|
|
293
|
+
## 6. Fluxo GSD
|
|
294
|
+
|
|
295
|
+
GSD e o harness de execucao. Ele cria e valida um runbook para a entrega.
|
|
296
|
+
|
|
297
|
+
Criar runbook:
|
|
298
|
+
|
|
299
|
+
```bash
|
|
300
|
+
npm run gsd:plan -- <slug> "<objetivo>"
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
Isso gera:
|
|
304
|
+
|
|
305
|
+
```text
|
|
306
|
+
.context/gsd-<slug>.md
|
|
307
|
+
```
|
|
308
|
+
|
|
309
|
+
Esse arquivo acompanha os gates:
|
|
310
|
+
|
|
311
|
+
1. Briefing.
|
|
312
|
+
2. Estrutura.
|
|
313
|
+
3. Sprints.
|
|
314
|
+
4. Contexto.
|
|
315
|
+
5. Spec.
|
|
316
|
+
6. Design, somente se houver UI.
|
|
317
|
+
7. Plano.
|
|
318
|
+
8. Desenvolvimento.
|
|
319
|
+
9. Validacao.
|
|
320
|
+
10. Governance.
|
|
321
|
+
|
|
322
|
+
Validar:
|
|
323
|
+
|
|
324
|
+
```bash
|
|
325
|
+
npm run gsd:check -- <slug>
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
Se houver impacto visual:
|
|
329
|
+
|
|
330
|
+
```bash
|
|
331
|
+
npm run design:select -- agent-console tecnico
|
|
332
|
+
npm run design:check -- design-md/examples/agent-console-brief.md
|
|
333
|
+
npm run gsd:check -- <slug> design-md/examples/agent-console-brief.md
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
Se nao houver UI, nao passe brief. O fluxo CLI-only nao deve ser bloqueado por design.
|
|
337
|
+
|
|
338
|
+
## 7. Handoffs Hermes
|
|
339
|
+
|
|
340
|
+
Handoff e passagem formal de responsabilidade.
|
|
341
|
+
|
|
342
|
+
Todo handoff precisa dos 7 campos da ADR-0005:
|
|
343
|
+
|
|
344
|
+
| Campo | Significado |
|
|
345
|
+
|---|---|
|
|
346
|
+
| `from` | Quem esta entregando |
|
|
347
|
+
| `to` | Quem recebe |
|
|
348
|
+
| `intent` | Intencao da passagem |
|
|
349
|
+
| `context` | Contexto minimo para continuar |
|
|
350
|
+
| `acceptance` | Como saber que o trabalho foi aceito |
|
|
351
|
+
| `constraints` | Restrições obrigatorias |
|
|
352
|
+
| `return` | Para quem devolver |
|
|
353
|
+
|
|
354
|
+
Comando generico:
|
|
355
|
+
|
|
356
|
+
```bash
|
|
357
|
+
npm run hermes:handoff -- '{"from":"orchestrator","to":"product","intent":"spec","context":"specs/<slug>","acceptance":"spec aprovada com AC testaveis","constraints":"pt-BR; nao implementar codigo","return":"orchestrator"}'
|
|
358
|
+
```
|
|
359
|
+
|
|
360
|
+
Atalhos do GSD:
|
|
361
|
+
|
|
362
|
+
```bash
|
|
363
|
+
npm run gsd:handoff -- spec <slug>
|
|
364
|
+
npm run gsd:handoff -- plan <slug>
|
|
365
|
+
npm run gsd:handoff -- implement <slug>
|
|
366
|
+
npm run gsd:handoff -- review <slug>
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
Ordem recomendada:
|
|
370
|
+
|
|
371
|
+
```text
|
|
372
|
+
Orchestrator -> Product spec
|
|
373
|
+
Product -> SDD Architect plan
|
|
374
|
+
SDD Architect-> Worker implement
|
|
375
|
+
Worker -> Governance review
|
|
376
|
+
Governance -> Orchestrator fechamento
|
|
377
|
+
```
|
|
378
|
+
|
|
379
|
+
## 8. Sprints
|
|
380
|
+
|
|
381
|
+
O acompanhamento de sprint fica em:
|
|
382
|
+
|
|
383
|
+
```text
|
|
384
|
+
memory/40-delivery/current-sprint.md
|
|
385
|
+
```
|
|
386
|
+
|
|
387
|
+
O backlog fica em:
|
|
388
|
+
|
|
389
|
+
```text
|
|
390
|
+
memory/40-delivery/backlog.md
|
|
391
|
+
```
|
|
392
|
+
|
|
393
|
+
### 8.1 Iniciar sprint no framework raiz
|
|
394
|
+
|
|
395
|
+
```bash
|
|
396
|
+
npm run sprint:start
|
|
397
|
+
```
|
|
398
|
+
|
|
399
|
+
O script busca itens de alta prioridade. Se o backlog estiver em tabela RICE, ele seleciona itens `P0` e `P1`.
|
|
400
|
+
|
|
401
|
+
### 8.2 Ver status
|
|
402
|
+
|
|
403
|
+
```bash
|
|
404
|
+
npm run sprint:status
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
### 8.3 Encerrar sprint
|
|
408
|
+
|
|
409
|
+
```bash
|
|
410
|
+
npm run sprint:complete
|
|
411
|
+
```
|
|
412
|
+
|
|
413
|
+
O fechamento cria relatorio em:
|
|
414
|
+
|
|
415
|
+
```text
|
|
416
|
+
memory/60-runs/sprint-close-<timestamp>.md
|
|
417
|
+
```
|
|
418
|
+
|
|
419
|
+
### 8.4 Operar sprint de um projeto no workspace
|
|
420
|
+
|
|
421
|
+
```bash
|
|
422
|
+
npm run sprint:start -- NomeDoProjeto
|
|
423
|
+
npm run sprint:status -- NomeDoProjeto
|
|
424
|
+
npm run sprint:complete -- NomeDoProjeto
|
|
425
|
+
```
|
|
426
|
+
|
|
427
|
+
Os projetos de produto vivem em `~/forja-workspace/projects/<NomeDoProjeto>` (configurável via `FORJA_WORKSPACE` ou `~/.forjarc.json`). Veja ADR-0019.
|
|
428
|
+
|
|
429
|
+
## 9. Rotina Recomendada
|
|
430
|
+
|
|
431
|
+
### 9.1 Inicio do dia
|
|
432
|
+
|
|
433
|
+
```bash
|
|
434
|
+
git status --short
|
|
435
|
+
npm run sprint:status
|
|
436
|
+
npm run spec:check
|
|
437
|
+
```
|
|
438
|
+
|
|
439
|
+
Leia:
|
|
440
|
+
|
|
441
|
+
```bash
|
|
442
|
+
memory/40-delivery/current-sprint.md
|
|
443
|
+
```
|
|
444
|
+
|
|
445
|
+
Escolha uma entrega e confirme se existe:
|
|
446
|
+
|
|
447
|
+
```text
|
|
448
|
+
specs/<slug>/spec.md
|
|
449
|
+
specs/<slug>/plan.md
|
|
450
|
+
specs/<slug>/tasks.md
|
|
451
|
+
```
|
|
452
|
+
|
|
453
|
+
### 9.2 Antes de mexer em codigo
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
457
|
+
npm run gsd:plan -- <slug> "<objetivo>"
|
|
458
|
+
npm run gsd:handoff -- implement <slug>
|
|
459
|
+
```
|
|
460
|
+
|
|
461
|
+
Leia:
|
|
462
|
+
|
|
463
|
+
```text
|
|
464
|
+
.context/gsd-<slug>.md
|
|
465
|
+
specs/<slug>/tasks.md
|
|
466
|
+
```
|
|
467
|
+
|
|
468
|
+
### 9.3 Durante a implementacao
|
|
469
|
+
|
|
470
|
+
Mantenha foco em:
|
|
471
|
+
|
|
472
|
+
- Paths definidos em `tasks.md`.
|
|
473
|
+
- Criterios de aceite da spec.
|
|
474
|
+
- Contratos do plano.
|
|
475
|
+
- Nenhuma refatoracao fora do escopo.
|
|
476
|
+
|
|
477
|
+
Checklist local:
|
|
478
|
+
|
|
479
|
+
```bash
|
|
480
|
+
npm run spec:check -- <slug>
|
|
481
|
+
npm run gsd:check -- <slug>
|
|
482
|
+
```
|
|
483
|
+
|
|
484
|
+
### 9.4 Antes de entregar
|
|
485
|
+
|
|
486
|
+
```bash
|
|
487
|
+
npm run gsd:handoff -- review <slug>
|
|
488
|
+
npm run gsd:check -- <slug>
|
|
489
|
+
npm run spec:check -- <slug>
|
|
490
|
+
npm test
|
|
491
|
+
npm run project:check
|
|
492
|
+
```
|
|
493
|
+
|
|
494
|
+
Se algum comando falhar, nao entregue como pronto. Registre a pendencia no handoff ou em `tasks.md`.
|
|
495
|
+
|
|
496
|
+
### 9.5 Fechamento da sprint
|
|
497
|
+
|
|
498
|
+
```bash
|
|
499
|
+
npm run sprint:status
|
|
500
|
+
npm run sprint:complete
|
|
501
|
+
```
|
|
502
|
+
|
|
503
|
+
Depois consolide memoria:
|
|
504
|
+
|
|
505
|
+
```bash
|
|
506
|
+
npm run memory:vacuum
|
|
507
|
+
npm run sync:universal
|
|
508
|
+
```
|
|
509
|
+
|
|
510
|
+
## 10. Governanca
|
|
511
|
+
|
|
512
|
+
Governance nao e opiniao. Governance e evidencia.
|
|
513
|
+
|
|
514
|
+
Uma entrega so esta pronta quando:
|
|
515
|
+
|
|
516
|
+
- A spec existe e esta coerente.
|
|
517
|
+
- O plano existe quando houve decisao tecnica.
|
|
518
|
+
- As tasks refletem o que foi implementado.
|
|
519
|
+
- O GSD check passa.
|
|
520
|
+
- Testes relevantes passaram.
|
|
521
|
+
- `project:check` passou.
|
|
522
|
+
- Handoffs foram registrados.
|
|
523
|
+
- Riscos residuais foram explicitados.
|
|
524
|
+
|
|
525
|
+
Comandos:
|
|
526
|
+
|
|
527
|
+
```bash
|
|
528
|
+
npm run gsd:check -- <slug>
|
|
529
|
+
npm run spec:check -- <slug>
|
|
530
|
+
npm test
|
|
531
|
+
npm run project:check
|
|
532
|
+
```
|
|
533
|
+
|
|
534
|
+
`project:check` sem argumento valida o framework raiz. Com argumento, valida projeto em `~/forja-workspace/projects/<nome>`.
|
|
535
|
+
|
|
536
|
+
```bash
|
|
537
|
+
npm run project:check
|
|
538
|
+
npm run project:check -- NomeDoProjeto
|
|
539
|
+
```
|
|
540
|
+
|
|
541
|
+
## 11. Contexto e Memoria
|
|
542
|
+
|
|
543
|
+
Use contexto inteligente para reduzir custo mental e tokens.
|
|
544
|
+
|
|
545
|
+
Modos:
|
|
546
|
+
|
|
547
|
+
| Modo | Uso |
|
|
548
|
+
|---|---|
|
|
549
|
+
| `global` | Entender padroes gerais |
|
|
550
|
+
| `domain` | Entender um dominio especifico |
|
|
551
|
+
| `task` | Executar uma entrega |
|
|
552
|
+
|
|
553
|
+
Comandos:
|
|
554
|
+
|
|
555
|
+
```bash
|
|
556
|
+
npm run dev -- context:build global <projeto>
|
|
557
|
+
npm run dev -- context:build domain <projeto> "<dominio>"
|
|
558
|
+
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
559
|
+
```
|
|
560
|
+
|
|
561
|
+
Memoria relevante:
|
|
562
|
+
|
|
563
|
+
```text
|
|
564
|
+
memory/00-global/ Missao e padroes
|
|
565
|
+
memory/10-product/ Produto e personas
|
|
566
|
+
memory/20-architecture/ Arquitetura
|
|
567
|
+
memory/40-delivery/ Backlog e sprint
|
|
568
|
+
memory/50-orchestration Protocolos
|
|
569
|
+
memory/60-runs/ Logs e fechamentos
|
|
570
|
+
memory/90-decisions/ ADRs
|
|
571
|
+
|
|
572
|
+
# Workspace (fora do repo do framework)
|
|
573
|
+
~/forja-workspace/projects/ Projetos de produto
|
|
574
|
+
~/forja-workspace/memory/30-projects/ Projetos rastreados
|
|
575
|
+
~/forja-workspace/memory/sqlite/ Memoria universal
|
|
576
|
+
```
|
|
577
|
+
|
|
578
|
+
Sincronizar memoria universal:
|
|
579
|
+
|
|
580
|
+
```bash
|
|
581
|
+
npm run sync:universal
|
|
582
|
+
```
|
|
583
|
+
|
|
584
|
+
Consultar memoria:
|
|
585
|
+
|
|
586
|
+
```bash
|
|
587
|
+
npm run query:universal -- "<termo>"
|
|
588
|
+
```
|
|
589
|
+
|
|
590
|
+
Compactar:
|
|
591
|
+
|
|
592
|
+
```bash
|
|
593
|
+
npm run memory:vacuum
|
|
594
|
+
```
|
|
595
|
+
|
|
596
|
+
## 12. Potencia de Desenvolvimento e Economia de Tokens
|
|
597
|
+
|
|
598
|
+
Use estes comandos para transformar contexto em artefatos pequenos, medidos e reutilizaveis.
|
|
599
|
+
|
|
600
|
+
### 12.1 Schema auxiliar do banco
|
|
601
|
+
|
|
602
|
+
```bash
|
|
603
|
+
npm run memory:schema
|
|
604
|
+
```
|
|
605
|
+
|
|
606
|
+
Cria tabelas aditivas em `~/forja-workspace/memory/sqlite/universal.db`:
|
|
607
|
+
|
|
608
|
+
| Tabela | Uso |
|
|
609
|
+
|---|---|
|
|
610
|
+
| `spec_summaries` | resumo compacto por spec |
|
|
611
|
+
| `context_runs` | historico de contextos gerados e budget |
|
|
612
|
+
| `asset_catalog` | boilerplates e referencias design-md catalogados |
|
|
613
|
+
|
|
614
|
+
Essas tabelas nao substituem `memory_nodes` nem `handoffs`. Elas melhoram consulta e governanca sem quebrar o schema principal.
|
|
615
|
+
|
|
616
|
+
### 12.2 Sprint pack
|
|
617
|
+
|
|
618
|
+
```bash
|
|
619
|
+
npm run context:sprint
|
|
620
|
+
```
|
|
621
|
+
|
|
622
|
+
Gera:
|
|
623
|
+
|
|
624
|
+
```text
|
|
625
|
+
.context/sprint-pack.md
|
|
626
|
+
```
|
|
627
|
+
|
|
628
|
+
Use como primeiro contexto de qualquer sessao. Ele inclui somente sprint atual, specs ativas, handoffs abertos e ADRs recentes.
|
|
629
|
+
|
|
630
|
+
### 12.3 Agent brief
|
|
631
|
+
|
|
632
|
+
```bash
|
|
633
|
+
npm run agent:brief -- <role> <slug>
|
|
634
|
+
```
|
|
635
|
+
|
|
636
|
+
Exemplo:
|
|
637
|
+
|
|
638
|
+
```bash
|
|
639
|
+
npm run agent:brief -- governance dev-token-assets-db
|
|
640
|
+
```
|
|
641
|
+
|
|
642
|
+
Gera:
|
|
643
|
+
|
|
644
|
+
```text
|
|
645
|
+
.context/agent-brief-<role>-<slug>.md
|
|
646
|
+
```
|
|
647
|
+
|
|
648
|
+
Use antes de chamar um agente especifico. Ele evita carregar `spec.md`, `plan.md` e `tasks.md` completos quando um resumo operacional basta.
|
|
649
|
+
|
|
650
|
+
### 12.4 Token budget
|
|
651
|
+
|
|
652
|
+
```bash
|
|
653
|
+
npm run context:budget -- <slug|arquivo> [limite]
|
|
654
|
+
```
|
|
655
|
+
|
|
656
|
+
Exemplos:
|
|
657
|
+
|
|
658
|
+
```bash
|
|
659
|
+
npm run context:budget -- .context/sprint-pack.md
|
|
660
|
+
npm run context:budget -- .context/asset-catalog.md 12000
|
|
661
|
+
```
|
|
662
|
+
|
|
663
|
+
Padrao: usa `tokenLimits.task` de `.memoryrc.json`, hoje 8000 tokens.
|
|
664
|
+
|
|
665
|
+
Se passar do limite, o comando falha. Isso deve ser tratado como sinal de contexto inchado.
|
|
666
|
+
|
|
667
|
+
### 12.5 Catalogo de boilerplates e design system
|
|
668
|
+
|
|
669
|
+
Gere ou atualize manifests normalizados:
|
|
670
|
+
|
|
671
|
+
```bash
|
|
672
|
+
npm run catalog:manifests
|
|
673
|
+
```
|
|
674
|
+
|
|
675
|
+
Isso cria:
|
|
676
|
+
|
|
677
|
+
```text
|
|
678
|
+
boilerplates/<nome>/boilerplate.manifest.json
|
|
679
|
+
design-md/<nome>/design.manifest.json
|
|
680
|
+
```
|
|
681
|
+
|
|
682
|
+
Depois gere o catalogo:
|
|
683
|
+
|
|
684
|
+
```bash
|
|
685
|
+
npm run catalog:assets
|
|
686
|
+
```
|
|
687
|
+
|
|
688
|
+
Gera:
|
|
689
|
+
|
|
690
|
+
```text
|
|
691
|
+
.context/asset-catalog.md
|
|
692
|
+
```
|
|
693
|
+
|
|
694
|
+
Tambem popula `asset_catalog` no SQLite com:
|
|
695
|
+
|
|
696
|
+
- boilerplates
|
|
697
|
+
- referencias de `design-md`
|
|
698
|
+
- caminho do README
|
|
699
|
+
- resumo curto
|
|
700
|
+
- tags vindas dos manifests
|
|
701
|
+
|
|
702
|
+
Use antes de escolher base tecnica ou referencia visual.
|
|
703
|
+
|
|
704
|
+
### 12.6 Benchmark de tokens
|
|
705
|
+
|
|
706
|
+
```bash
|
|
707
|
+
npm run token:benchmark
|
|
708
|
+
```
|
|
709
|
+
|
|
710
|
+
Use para comparar contexto completo versus modos `global`, `domain` e `task`.
|
|
711
|
+
|
|
712
|
+
## 13. Design e Web
|
|
713
|
+
|
|
714
|
+
Design entra apenas quando existe impacto visual real.
|
|
715
|
+
|
|
716
|
+
Use:
|
|
717
|
+
|
|
718
|
+
```bash
|
|
719
|
+
npm run design:select -- <surface> <tom>
|
|
720
|
+
npm run design:check -- <brief.md>
|
|
721
|
+
```
|
|
722
|
+
|
|
723
|
+
Exemplo:
|
|
724
|
+
|
|
725
|
+
```bash
|
|
726
|
+
npm run design:select -- agent-console tecnico
|
|
727
|
+
npm run design:check -- design-md/examples/agent-console-brief.md
|
|
728
|
+
```
|
|
729
|
+
|
|
730
|
+
Nao use design como etapa obrigatoria para:
|
|
731
|
+
|
|
732
|
+
- CLI.
|
|
733
|
+
- Scripts.
|
|
734
|
+
- Specs.
|
|
735
|
+
- Handoffs.
|
|
736
|
+
- Checks.
|
|
737
|
+
- Refatoracoes sem interface.
|
|
738
|
+
|
|
739
|
+
Dashboard:
|
|
740
|
+
|
|
741
|
+
```bash
|
|
742
|
+
npm run dashboard
|
|
743
|
+
```
|
|
744
|
+
|
|
745
|
+
Use somente para consulta visual ou depuracao de telas. Nao trate como fonte primaria de operacao.
|
|
746
|
+
|
|
747
|
+
## 14. Comandos por Objetivo
|
|
748
|
+
|
|
749
|
+
### Criar nova entrega
|
|
750
|
+
|
|
751
|
+
```bash
|
|
752
|
+
npm run spec:new -- <slug>
|
|
753
|
+
npm run gsd:plan -- <slug> "<objetivo>"
|
|
754
|
+
npm run gsd:handoff -- spec <slug>
|
|
755
|
+
```
|
|
756
|
+
|
|
757
|
+
### Planejar entrega aprovada
|
|
758
|
+
|
|
759
|
+
```bash
|
|
760
|
+
npm run spec:plan -- <slug>
|
|
761
|
+
npm run spec:tasks -- <slug>
|
|
762
|
+
npm run gsd:handoff -- plan <slug>
|
|
763
|
+
```
|
|
764
|
+
|
|
765
|
+
### Implementar
|
|
766
|
+
|
|
767
|
+
```bash
|
|
768
|
+
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
769
|
+
npm run gsd:handoff -- implement <slug>
|
|
770
|
+
```
|
|
771
|
+
|
|
772
|
+
### Revisar
|
|
773
|
+
|
|
774
|
+
```bash
|
|
775
|
+
npm run gsd:handoff -- review <slug>
|
|
776
|
+
npm run gsd:check -- <slug>
|
|
777
|
+
npm run spec:check -- <slug>
|
|
778
|
+
npm test
|
|
779
|
+
npm run project:check
|
|
780
|
+
```
|
|
781
|
+
|
|
782
|
+
### Auditar todas as specs
|
|
783
|
+
|
|
784
|
+
```bash
|
|
785
|
+
npm run spec:check
|
|
786
|
+
```
|
|
787
|
+
|
|
788
|
+
### Ver sprint
|
|
789
|
+
|
|
790
|
+
```bash
|
|
791
|
+
npm run sprint:status
|
|
792
|
+
```
|
|
793
|
+
|
|
794
|
+
### Encerrar sprint
|
|
795
|
+
|
|
796
|
+
```bash
|
|
797
|
+
npm run sprint:complete
|
|
798
|
+
```
|
|
799
|
+
|
|
800
|
+
## 15. Padroes de Qualidade
|
|
801
|
+
|
|
802
|
+
### 14.1 Uma spec boa
|
|
803
|
+
|
|
804
|
+
Uma spec boa tem:
|
|
805
|
+
|
|
806
|
+
- Problema concreto.
|
|
807
|
+
- Persona clara.
|
|
808
|
+
- Criterios de aceite testaveis.
|
|
809
|
+
- Escopo fora explicito.
|
|
810
|
+
- NFRs objetivos.
|
|
811
|
+
- Metrica de sucesso.
|
|
812
|
+
|
|
813
|
+
Uma spec ruim diz:
|
|
814
|
+
|
|
815
|
+
- "Melhorar o sistema."
|
|
816
|
+
- "Deixar mais bonito."
|
|
817
|
+
- "Fazer funcionar."
|
|
818
|
+
- "Otimizar performance" sem numero.
|
|
819
|
+
|
|
820
|
+
### 14.2 Um plan bom
|
|
821
|
+
|
|
822
|
+
Um plan bom tem:
|
|
823
|
+
|
|
824
|
+
- Modulos afetados.
|
|
825
|
+
- Contratos alterados.
|
|
826
|
+
- Riscos.
|
|
827
|
+
- Alternativas rejeitadas.
|
|
828
|
+
- Necessidade ou nao de ADR.
|
|
829
|
+
|
|
830
|
+
### 14.3 Tasks boas
|
|
831
|
+
|
|
832
|
+
Tasks boas tem:
|
|
833
|
+
|
|
834
|
+
- Owner.
|
|
835
|
+
- Paths.
|
|
836
|
+
- Dependencias.
|
|
837
|
+
- Done verificavel.
|
|
838
|
+
- Teste ou check associado.
|
|
839
|
+
|
|
840
|
+
### 14.4 Handoff bom
|
|
841
|
+
|
|
842
|
+
Handoff bom permite que outro agente continue sem perguntar:
|
|
843
|
+
|
|
844
|
+
- O que foi feito?
|
|
845
|
+
- O que falta?
|
|
846
|
+
- Onde esta o contexto?
|
|
847
|
+
- Qual criterio de aceite?
|
|
848
|
+
- Quais restricoes?
|
|
849
|
+
- Para quem devolver?
|
|
850
|
+
|
|
851
|
+
## 16. Erros Comuns
|
|
852
|
+
|
|
853
|
+
### Erro: implementar sem spec
|
|
854
|
+
|
|
855
|
+
Sintoma:
|
|
856
|
+
|
|
857
|
+
```text
|
|
858
|
+
Codigo muda, mas ninguem sabe qual AC ele atende.
|
|
859
|
+
```
|
|
860
|
+
|
|
861
|
+
Correcao:
|
|
862
|
+
|
|
863
|
+
```bash
|
|
864
|
+
npm run spec:new -- <slug>
|
|
865
|
+
```
|
|
866
|
+
|
|
867
|
+
### Erro: plan criado com spec em draft
|
|
868
|
+
|
|
869
|
+
Sintoma:
|
|
870
|
+
|
|
871
|
+
```text
|
|
872
|
+
spec:check falha porque plan existe antes da spec aprovada.
|
|
873
|
+
```
|
|
874
|
+
|
|
875
|
+
Correcao:
|
|
876
|
+
|
|
877
|
+
- Aprovar ou corrigir status da spec.
|
|
878
|
+
- Ou remover plan/tasks se foram criados cedo demais e ainda nao devem existir.
|
|
879
|
+
|
|
880
|
+
### Erro: design bloqueando CLI
|
|
881
|
+
|
|
882
|
+
Sintoma:
|
|
883
|
+
|
|
884
|
+
```text
|
|
885
|
+
Entrega sem UI tentando passar por design:check.
|
|
886
|
+
```
|
|
887
|
+
|
|
888
|
+
Correcao:
|
|
889
|
+
|
|
890
|
+
```bash
|
|
891
|
+
npm run gsd:check -- <slug>
|
|
892
|
+
```
|
|
893
|
+
|
|
894
|
+
Sem brief visual.
|
|
895
|
+
|
|
896
|
+
### Erro: sprint sem criterio de fechamento
|
|
897
|
+
|
|
898
|
+
Sintoma:
|
|
899
|
+
|
|
900
|
+
```text
|
|
901
|
+
Itens ficam eternamente em current-sprint.md.
|
|
902
|
+
```
|
|
903
|
+
|
|
904
|
+
Correcao:
|
|
905
|
+
|
|
906
|
+
```bash
|
|
907
|
+
npm run sprint:complete
|
|
908
|
+
```
|
|
909
|
+
|
|
910
|
+
Pendencias voltam para backlog quando aplicavel.
|
|
911
|
+
|
|
912
|
+
## 17. Exemplo Completo
|
|
913
|
+
|
|
914
|
+
Objetivo: criar uma feature `inventario-ativos`.
|
|
915
|
+
|
|
916
|
+
### 16.1 Criar spec
|
|
917
|
+
|
|
918
|
+
```bash
|
|
919
|
+
npm run spec:new -- inventario-ativos
|
|
920
|
+
```
|
|
921
|
+
|
|
922
|
+
Editar:
|
|
923
|
+
|
|
924
|
+
```text
|
|
925
|
+
specs/inventario-ativos/spec.md
|
|
926
|
+
```
|
|
927
|
+
|
|
928
|
+
Quando aprovada:
|
|
929
|
+
|
|
930
|
+
```bash
|
|
931
|
+
npm run spec:check -- inventario-ativos
|
|
932
|
+
```
|
|
933
|
+
|
|
934
|
+
### 16.2 Criar runbook GSD
|
|
935
|
+
|
|
936
|
+
```bash
|
|
937
|
+
npm run gsd:plan -- inventario-ativos "criar inventario multiempresa e CRUD de ativos"
|
|
938
|
+
```
|
|
939
|
+
|
|
940
|
+
### 16.3 Registrar handoff para Product
|
|
941
|
+
|
|
942
|
+
```bash
|
|
943
|
+
npm run gsd:handoff -- spec inventario-ativos
|
|
944
|
+
```
|
|
945
|
+
|
|
946
|
+
### 16.4 Planejar
|
|
947
|
+
|
|
948
|
+
```bash
|
|
949
|
+
npm run spec:plan -- inventario-ativos
|
|
950
|
+
npm run spec:tasks -- inventario-ativos
|
|
951
|
+
npm run gsd:handoff -- plan inventario-ativos
|
|
952
|
+
```
|
|
953
|
+
|
|
954
|
+
### 16.5 Implementar
|
|
955
|
+
|
|
956
|
+
```bash
|
|
957
|
+
npm run dev -- context:build task inventario-ativos "inventario ativos CRUD empresa"
|
|
958
|
+
npm run gsd:handoff -- implement inventario-ativos
|
|
959
|
+
```
|
|
960
|
+
|
|
961
|
+
Implementar somente o que esta em `tasks.md`.
|
|
962
|
+
|
|
963
|
+
### 16.6 Revisar
|
|
964
|
+
|
|
965
|
+
```bash
|
|
966
|
+
npm run gsd:handoff -- review inventario-ativos
|
|
967
|
+
npm run gsd:check -- inventario-ativos
|
|
968
|
+
npm run spec:check -- inventario-ativos
|
|
969
|
+
npm test
|
|
970
|
+
npm run project:check
|
|
971
|
+
```
|
|
972
|
+
|
|
973
|
+
### 16.7 Fechar sprint
|
|
974
|
+
|
|
975
|
+
```bash
|
|
976
|
+
npm run sprint:status
|
|
977
|
+
npm run sprint:complete
|
|
978
|
+
```
|
|
979
|
+
|
|
980
|
+
## 18. Checklist de Excelencia
|
|
981
|
+
|
|
982
|
+
Antes de dizer "pronto", confira:
|
|
983
|
+
|
|
984
|
+
- [ ] Existe `spec.md`.
|
|
985
|
+
- [ ] Existe `plan.md` quando houve decisao tecnica.
|
|
986
|
+
- [ ] Existe `tasks.md`.
|
|
987
|
+
- [ ] Handoff Hermes foi registrado.
|
|
988
|
+
- [ ] `gsd:check` passou.
|
|
989
|
+
- [ ] `spec:check` passou.
|
|
990
|
+
- [ ] Testes relevantes passaram.
|
|
991
|
+
- [ ] `project:check` passou.
|
|
992
|
+
- [ ] Sprint foi atualizada.
|
|
993
|
+
- [ ] Riscos residuais foram reportados.
|
|
994
|
+
- [ ] Web/design nao foi usado como bloqueio quando a tarefa era CLI-only.
|
|
995
|
+
|
|
996
|
+
## 19. Comando de Bolso
|
|
997
|
+
|
|
998
|
+
Para operar uma entrega comum:
|
|
999
|
+
|
|
1000
|
+
```bash
|
|
1001
|
+
npm run sprint:status
|
|
1002
|
+
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
1003
|
+
npm run gsd:plan -- <slug> "<objetivo>"
|
|
1004
|
+
npm run gsd:handoff -- spec <slug>
|
|
1005
|
+
npm run gsd:handoff -- plan <slug>
|
|
1006
|
+
npm run gsd:handoff -- implement <slug>
|
|
1007
|
+
npm run gsd:handoff -- review <slug>
|
|
1008
|
+
npm run gsd:check -- <slug>
|
|
1009
|
+
npm run spec:check -- <slug>
|
|
1010
|
+
npm test
|
|
1011
|
+
npm run project:check
|
|
1012
|
+
```
|
|
1013
|
+
|
|
1014
|
+
Se isso estiver verde, a operacao esta sob controle.
|