forjajs 1.1.0
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 -0
- package/.claude/agents/governance.md +32 -0
- package/.claude/agents/marketing.md +24 -0
- package/.claude/agents/orchestrator.md +31 -0
- package/.claude/agents/product.md +26 -0
- package/.claude/agents/sdd-architect.md +34 -0
- package/.claude/settings.json +41 -0
- package/.gemini-instructions.md +87 -0
- package/.github/copilot-instructions.md +87 -0
- package/.memoryrc.json +104 -0
- package/.openai-instructions.md +87 -0
- package/AGENTS.md +132 -0
- package/CHANGELOG.md +106 -0
- package/CONTRIBUTING.md +32 -0
- package/DOC-MAP.md +65 -0
- package/LICENSE +21 -0
- package/README.md +260 -0
- package/bin/create-memory-nest-kit.js +125 -0
- package/bin/forja.mjs +143 -0
- package/bin/init-project.js +612 -0
- package/boilerplates/01-api-rest/README.md +336 -0
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -0
- package/boilerplates/02-saas-starter/.env.example +25 -0
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -0
- package/boilerplates/02-saas-starter/INFO.md +252 -0
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -0
- package/boilerplates/02-saas-starter/README.md +305 -0
- package/boilerplates/02-saas-starter/START-HERE.md +259 -0
- package/boilerplates/02-saas-starter/backend/package.json +87 -0
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -0
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -0
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -0
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -0
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -0
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -0
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -0
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -0
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -0
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -0
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -0
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -0
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -0
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -0
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -0
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -0
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -0
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -0
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -0
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -0
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -0
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -0
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -0
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -0
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -0
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -0
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -0
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -0
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -0
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -0
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -0
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -0
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -0
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -0
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -0
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -0
- package/boilerplates/03-ecommerce-starter/README.md +465 -0
- package/boilerplates/03-ecommerce-starter/agents/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -0
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -0
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -0
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -0
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -0
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -0
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -0
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -0
- package/boilerplates/03-ecommerce-starter/backend/src/common/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -0
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -0
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -0
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -0
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -0
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -0
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -0
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -0
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -0
- package/boilerplates/03-ecommerce-starter/memory/40-delivery/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/50-orchestration/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/60-runs/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/70-summaries/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/80-data/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -0
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -0
- package/boilerplates/03-ecommerce-starter/prompts/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/skills/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/.env.example +43 -0
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -0
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -0
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -0
- package/boilerplates/04-microservices-starter/INDEX.md +377 -0
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -0
- package/boilerplates/04-microservices-starter/README.md +466 -0
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/notification/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/user/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/auth/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/user/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/auth/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/notification/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/types/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -0
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -0
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -0
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -0
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -0
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -0
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -0
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -0
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -0
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -0
- package/boilerplates/04-microservices-starter/memory/40-delivery/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -0
- package/boilerplates/04-microservices-starter/memory/60-runs/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/70-summaries/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/80-data/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/90-decisions/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/package.json +21 -0
- package/boilerplates/05-monorepo-starter/.env.example +1 -0
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -0
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -0
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -0
- package/boilerplates/05-monorepo-starter/README.md +318 -0
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -0
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -0
- package/boilerplates/05-monorepo-starter/memory/40-delivery/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/50-orchestration/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/60-runs/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/70-summaries/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/80-data/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/90-decisions/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/package.json +30 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -0
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -0
- package/boilerplates/05-monorepo-starter/turbo.json +35 -0
- package/boilerplates/README.md +407 -0
- package/design-md/BRIEF-TEMPLATE.md +47 -0
- package/design-md/INDEX.md +35 -0
- package/design-md/MATRIX.md +24 -0
- package/design-md/PLAYBOOK.md +35 -0
- package/design-md/examples/agent-console-brief.md +48 -0
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -0
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -0
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -0
- package/docs/agent-harnesses.md +122 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -0
- package/docs/archive/FASE2-SUMMARY.md +263 -0
- package/docs/archive/FASE3-PROGRESS.md +355 -0
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -0
- package/docs/archive/INDICE-MASTER.md +282 -0
- package/docs/archive/PROJETO-COMPLETO.md +363 -0
- package/docs/archive/README-REFINAMENTO.md +293 -0
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -0
- package/docs/archive/REFINAMENTO-v1.0.md +565 -0
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -0
- package/docs/archive/START-HERE.md +319 -0
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -0
- package/docs/archive/examples/v1/AGENTS.md +10 -0
- package/docs/archive/examples/v1/README.md +36 -0
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -0
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -0
- package/docs/archive/examples/v1/backend/package.json +42 -0
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -0
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -0
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -0
- package/docs/archive/examples/v1/backend/src/main.ts +10 -0
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -0
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -0
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -0
- package/docs/archive/examples/v1/docs/.gitkeep +0 -0
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -0
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -0
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -0
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -0
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -0
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -0
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -0
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -0
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -0
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -0
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -0
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -0
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -0
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/shared/.gitkeep +0 -0
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -0
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -0
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -0
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -0
- package/docs/archive/examples/v1/memory/90-decisions/archive/.gitkeep +0 -0
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -0
- package/docs/archive/examples/v1/scripts/.gitkeep +0 -0
- package/docs/archive/examples/v2/.memoryrc.json +8 -0
- package/docs/archive/examples/v2/AGENTS.md +16 -0
- package/docs/archive/examples/v2/README.md +35 -0
- package/docs/archive/examples/v2/agents/README.md +3 -0
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -0
- package/docs/archive/examples/v2/agents/dba.md +4 -0
- package/docs/archive/examples/v2/agents/frontend.md +4 -0
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -0
- package/docs/archive/examples/v2/agents/reviewer.md +6 -0
- package/docs/archive/examples/v2/agents/security.md +4 -0
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -0
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -0
- package/docs/archive/examples/v2/backend/package.json +42 -0
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -0
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -0
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -0
- package/docs/archive/examples/v2/backend/src/main.ts +10 -0
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -0
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -0
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -0
- package/docs/archive/examples/v2/docs/.gitkeep +0 -0
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -0
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -0
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -0
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -0
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -0
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -0
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -0
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -0
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -0
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -0
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -0
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -0
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -0
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -0
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/shared/.gitkeep +0 -0
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -0
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -0
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -0
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -0
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -0
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -0
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -0
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -0
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -0
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -0
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -0
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -0
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -0
- package/docs/archive/examples/v2/memory/90-decisions/archive/.gitkeep +0 -0
- package/docs/archive/examples/v2/memory/README.md +8 -0
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -0
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -0
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -0
- package/docs/archive/examples/v2/scripts/.gitkeep +0 -0
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -0
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -0
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -0
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -0
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -0
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -0
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -0
- package/docs/capacidades-externas.md +70 -0
- package/docs/cli-first-operacao.md +74 -0
- package/docs/dashboard.md +102 -0
- package/docs/dev-workflow.md +421 -0
- package/docs/examples.md +546 -0
- package/docs/fluxo.md +103 -0
- package/docs/glossary.md +453 -0
- package/docs/init-project.md +457 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -0
- package/docs/personas/architect/README.md +333 -0
- package/docs/personas/developer/README.md +371 -0
- package/docs/personas/executive/README.md +172 -0
- package/docs/personas/qa/README.md +350 -0
- package/docs/processo-projeto.md +138 -0
- package/docs/publishing.md +377 -0
- package/docs/quick-reference.md +409 -0
- package/docs/structure.md +360 -0
- package/docs/token-optimization.md +494 -0
- package/lib/context-builder.js +257 -0
- package/lib/core/registry.mjs +284 -0
- package/lib/generators/memory-generator.js +844 -0
- package/lib/generators/nest-generator.js +496 -0
- package/lib/generators/readme-generator.js +213 -0
- package/lib/templates/harness/code-intel.mjs +119 -0
- package/lib/templates/harness/mcp.json +10 -0
- package/lib/utils/file-helpers.js +40 -0
- package/lib/validators/structure-validator.js +253 -0
- package/lib/workspace.mjs +213 -0
- package/memory/00-global/mission.md +15 -0
- package/memory/00-global/shared-knowledge.md +8 -0
- package/memory/00-global/standards.md +47 -0
- package/memory/10-product/personas.md +21 -0
- package/memory/10-product/vision.md +27 -0
- package/memory/30-projects/README.md +15 -0
- package/memory/40-delivery/backlog.md +15 -0
- package/memory/40-delivery/current-sprint.md +21 -0
- package/memory/50-orchestration/gsd-harness.md +55 -0
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -0
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -0
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -0
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -0
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -0
- package/memory/90-decisions/0006-docs-por-persona.md +23 -0
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -0
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -0
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -0
- package/memory/90-decisions/0010-banco-postgres.md +30 -0
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -0
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -0
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -0
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -0
- package/memory/90-decisions/0019-workspace-separado.md +45 -0
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -0
- package/memory/90-decisions/_template.md +28 -0
- package/package.json +107 -0
- package/prompts/context-engineer-agent.md +19 -0
- package/prompts/governance-agent.md +15 -0
- package/prompts/marketing-agent.md +13 -0
- package/prompts/orchestrator-agent.md +18 -0
- package/prompts/product-agent.md +13 -0
- package/prompts/sdd-architect-agent.md +20 -0
- package/scripts/agent-harness.mjs +578 -0
- package/scripts/agent-router.mjs +189 -0
- package/scripts/build-smart-context.js +87 -0
- package/scripts/check-standards.js +98 -0
- package/scripts/compress-memory.mjs +198 -0
- package/scripts/compress-project-memory.js +58 -0
- package/scripts/context-ops.mjs +463 -0
- package/scripts/dev.mjs +349 -0
- package/scripts/extract-global-knowledge.js +52 -0
- package/scripts/generate-dashboard.js +59 -0
- package/scripts/hook-session-start.mjs +70 -0
- package/scripts/hook-user-prompt.mjs +185 -0
- package/scripts/memory-schema.mjs +68 -0
- package/scripts/pre-commit.sh +102 -0
- package/scripts/query-universal-memory.js +50 -0
- package/scripts/spec-cli.mjs +193 -0
- package/scripts/sprint-manager.js +200 -0
- package/scripts/sync-universal-memory.js +278 -0
- package/scripts/token-benchmark.mjs +203 -0
- package/scripts/tools-doctor.mjs +77 -0
- package/specs/README.md +70 -0
- package/specs/_templates/plan.md +43 -0
- package/specs/_templates/spec.md +43 -0
- package/specs/_templates/tasks.md +32 -0
- package/specs/agent-dashboard/plan.md +165 -0
- package/specs/agent-dashboard/spec.md +89 -0
- package/specs/agent-dashboard/tasks.md +168 -0
- package/specs/cli-first-operacao/plan.md +53 -0
- package/specs/cli-first-operacao/spec.md +53 -0
- package/specs/cli-first-operacao/tasks.md +53 -0
- package/specs/dev-token-assets-db/plan.md +71 -0
- package/specs/dev-token-assets-db/spec.md +58 -0
- package/specs/dev-token-assets-db/tasks.md +58 -0
- package/specs/forja-core/spec.md +71 -0
- package/specs/harness-codegraph/spec.md +71 -0
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -0
- package/specs/reestruturacao-forja-v2/plan.md +95 -0
- package/specs/reestruturacao-forja-v2/spec.md +70 -0
- package/specs/reestruturacao-forja-v2/tasks.md +113 -0
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Biblioteca de Design (design-md)
|
|
2
|
+
|
|
3
|
+
Camada operacional de design do fluxo GSD: garante que toda feature com impacto
|
|
4
|
+
visual passe por **referência escolhida → brief preenchido → gate validado**,
|
|
5
|
+
em vez de "faz uma UI aí".
|
|
6
|
+
|
|
7
|
+
## Como funciona
|
|
8
|
+
|
|
9
|
+
1. **Escolha a referência** por superfície: [MATRIX.md](./MATRIX.md) mapeia
|
|
10
|
+
superfícies (agent console, dashboard, docs, landing…) para nomes de
|
|
11
|
+
referência (`linear.app`, `stripe`, `vercel`…). Os nomes são **vocabulário
|
|
12
|
+
compartilhado** entre agentes — apontam para produtos publicamente
|
|
13
|
+
conhecidos, não para cópias locais.
|
|
14
|
+
2. **Preencha o brief**: [BRIEF-TEMPLATE.md](./BRIEF-TEMPLATE.md) é obrigatório
|
|
15
|
+
para features com impacto visual (9 campos, incluindo estados e critérios
|
|
16
|
+
de aceite visual).
|
|
17
|
+
3. **Valide antes do handoff**: `forja design:check <brief.md>` reprova brief
|
|
18
|
+
incompleto; `gsd:check` puxa esse gate quando há brief.
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm run design:select -- agent-console tecnico # sugere referências pela MATRIX
|
|
22
|
+
npm run design:check -- <caminho-do-brief.md> # gate de completude
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Regras de uso por agentes e checklist de handoff visual: [PLAYBOOK.md](./PLAYBOOK.md).
|
|
26
|
+
Exemplo de brief preenchido: [examples/agent-console-brief.md](./examples/agent-console-brief.md).
|
|
27
|
+
|
|
28
|
+
## Cache local de referências (opcional)
|
|
29
|
+
|
|
30
|
+
Detalhes de cada sistema de design (tokens, componentes, padrões) podem ser
|
|
31
|
+
mantidos como cache local em `design-md/<nome>/README.md` + `design.manifest.json`.
|
|
32
|
+
O harness degrada graciosamente sem eles: `design:select` indica "sem cache
|
|
33
|
+
local" e o agente usa o conhecimento público da referência.
|
|
34
|
+
|
|
35
|
+
> Nunca copie identidade visual proprietária — referência é direção, não clone.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Matriz de Referencias design-md
|
|
2
|
+
|
|
3
|
+
Use esta matriz para escolher referencias por tipo de superficie. Ela nao substitui o julgamento do designer/agente; ela reduz escolhas aleatorias.
|
|
4
|
+
|
|
5
|
+
| Superficie | Primarias recomendadas | Secundarias uteis | Evitar |
|
|
6
|
+
|---|---|---|---|
|
|
7
|
+
| Agent console / ops | linear.app, cursor, raycast | sentry, posthog, claude | visual de landing ou excesso decorativo |
|
|
8
|
+
| Dashboard executivo | stripe, linear.app, posthog | airbnb, sentry, supabase | cards gigantes sem densidade informacional |
|
|
9
|
+
| Docs / developer portal | mintlify, stripe, vercel | resend, supabase, hashicorp | layouts promocionais que escondem exemplos |
|
|
10
|
+
| SaaS operacional / CRM | linear.app, intercom, airtable | clay, notion, zapier | paleta de uma cor so e baixa densidade |
|
|
11
|
+
| Landing de produto tecnico | vercel, stripe, resend | cursor, x.ai, cohere | hero abstrato sem produto real |
|
|
12
|
+
| Ferramenta colaborativa | figma, miro, notion | cal, airtable, intercom | navegacao escondida ou comandos ambiguos |
|
|
13
|
+
| IA / agent workflow | claude, cursor, x.ai | mistral.ai, together.ai, cohere | magia visual sem rastreabilidade de execucao |
|
|
14
|
+
| Fintech / trust | wise, revolut, coinbase | stripe, kraken | linguagem visual agressiva sem confianca |
|
|
15
|
+
| Premium / marca forte | apple, bmw, ferrari | tesla, lamborghini, spacex | copiar identidade visual proprietaria |
|
|
16
|
+
| Observabilidade / incidentes | sentry, posthog, datadog-style local se existir | linear.app, stripe | esconder erros em UI decorativa |
|
|
17
|
+
|
|
18
|
+
## Heuristica rapida
|
|
19
|
+
|
|
20
|
+
- Se a tela sera usada muitas vezes por dia, escolha referencias de produtividade: `linear.app`, `raycast`, `cursor`.
|
|
21
|
+
- Se a tela precisa ensinar ou vender uma API, escolha docs/devtools: `mintlify`, `stripe`, `vercel`.
|
|
22
|
+
- Se a tela precisa passar confianca, escolha sistemas com clareza financeira/operacional: `wise`, `stripe`, `sentry`.
|
|
23
|
+
- Se a tela e para agentes, sempre inclua rastreabilidade: fila, status, logs, handoffs e criterio de aceite visivel.
|
|
24
|
+
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Design Playbook para Agentes
|
|
2
|
+
|
|
3
|
+
Este playbook transforma `design-md/` em entrada operacional para Product, Frontend, SDD Architect e Governance. A pasta de marcas continua sendo biblioteca de referencia; este arquivo define como escolher, aplicar e auditar uma direcao visual sem depender de memoria solta.
|
|
4
|
+
|
|
5
|
+
## Quando usar
|
|
6
|
+
|
|
7
|
+
- Antes de criar uma tela nova, componente critico, dashboard ou landing.
|
|
8
|
+
- Durante `spec.md`, quando a experiencia visual influencia conversao, confianca ou produtividade.
|
|
9
|
+
- Antes de merge/release, quando Governance precisa auditar fidelidade visual.
|
|
10
|
+
|
|
11
|
+
## Fluxo minimo
|
|
12
|
+
|
|
13
|
+
1. Defina a superficie: `dashboard`, `docs`, `landing`, `tool`, `mobile`, `checkout`, `agent-console`.
|
|
14
|
+
2. Escolha 1 referencia primaria e ate 2 secundarias em `MATRIX.md`.
|
|
15
|
+
3. Preencha `BRIEF-TEMPLATE.md` para o contexto da feature.
|
|
16
|
+
4. Anexe o brief ao handoff de implementacao.
|
|
17
|
+
5. Governance valida com `npm run design:check -- <brief.md>`.
|
|
18
|
+
|
|
19
|
+
## Regras para agentes
|
|
20
|
+
|
|
21
|
+
- Nunca copie marca, logo, texto proprietario ou identidade visual completa.
|
|
22
|
+
- Use referencias como principios: densidade, ritmo, hierarquia, tom, navegacao, estados e padroes de interacao.
|
|
23
|
+
- Para SaaS, CRM, ops e dashboards: priorize legibilidade, densidade organizada e estados claros.
|
|
24
|
+
- Para landing: a primeira dobra deve comunicar objeto/oferta real, nao apenas estilo abstrato.
|
|
25
|
+
- Para ferramentas de agente: prefira affordances explicitas, logs verificaveis, controles previsiveis e feedback de estado.
|
|
26
|
+
|
|
27
|
+
## Checklist de handoff visual
|
|
28
|
+
|
|
29
|
+
- Superficie e persona estao definidos.
|
|
30
|
+
- Referencia primaria tem justificativa clara.
|
|
31
|
+
- Tokens visuais foram definidos: cor, tipografia, raio, espacamento, densidade.
|
|
32
|
+
- Componentes esperados foram listados.
|
|
33
|
+
- Estados obrigatorios foram listados: vazio, carregando, erro, sucesso, permissao negada quando aplicavel.
|
|
34
|
+
- Criterios de aceite visual sao verificaveis por screenshot ou revisao objetiva.
|
|
35
|
+
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# Design Brief
|
|
2
|
+
|
|
3
|
+
- **Feature/superficie**: agent console operacional
|
|
4
|
+
- **Persona principal**: desenvolvedor ou coordenador que acompanha handoffs, contexto e status de agentes durante uma sprint.
|
|
5
|
+
- **Objetivo da UI**: reduzir ambiguidade operacional mostrando fila, dono, aceite, status e proximo comando verificavel.
|
|
6
|
+
- **Referencia primaria**: linear.app, pela densidade organizada, hierarquia clara e foco em produtividade diaria.
|
|
7
|
+
- **Referencias secundarias**: cursor para contexto de IA; sentry para tratamento de estados e incidentes.
|
|
8
|
+
- **Densidade**: alta
|
|
9
|
+
- **Tom visual**: tecnico
|
|
10
|
+
|
|
11
|
+
## Principios aplicados
|
|
12
|
+
|
|
13
|
+
- Navegacao lateral previsivel com conteudo principal orientado a tarefas.
|
|
14
|
+
- Estados de trabalho sempre visiveis: aberto, em andamento, bloqueado, concluido.
|
|
15
|
+
- Cada item acionavel mostra dono, criterio de aceite e proximo passo.
|
|
16
|
+
|
|
17
|
+
## Tokens visuais
|
|
18
|
+
|
|
19
|
+
- **Cores**: neutros claros para fundo, texto de alto contraste, acentos funcionais para status.
|
|
20
|
+
- **Tipografia**: escala compacta, labels menores, headings restritos ao contexto da tela.
|
|
21
|
+
- **Espacamento**: grid de 8px, alta densidade sem sobreposicao.
|
|
22
|
+
- **Raios/bordas/sombras**: raio ate 8px, bordas sutis, sombras apenas para overlays.
|
|
23
|
+
- **Iconografia**: lucide ou equivalente, sempre com tooltip para acoes ambiguas.
|
|
24
|
+
|
|
25
|
+
## Componentes esperados
|
|
26
|
+
|
|
27
|
+
- Lista de handoffs com status e filtros.
|
|
28
|
+
- Painel de detalhe com os 7 campos do ADR-0005.
|
|
29
|
+
- Log de eventos e comandos sugeridos.
|
|
30
|
+
- Indicadores de saude de contexto, design e spec.
|
|
31
|
+
|
|
32
|
+
## Estados obrigatorios
|
|
33
|
+
|
|
34
|
+
- [x] Carregando
|
|
35
|
+
- [x] Vazio
|
|
36
|
+
- [x] Erro
|
|
37
|
+
- [x] Sucesso
|
|
38
|
+
- [x] Permissao/sem acesso, se aplicavel
|
|
39
|
+
- [x] Responsivo mobile, se aplicavel
|
|
40
|
+
|
|
41
|
+
## Criterios de aceite visual
|
|
42
|
+
|
|
43
|
+
- [x] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
|
|
44
|
+
- [x] Texto nao quebra nem sobrepoe em mobile e desktop.
|
|
45
|
+
- [x] A hierarquia deixa clara a proxima acao do usuario.
|
|
46
|
+
- [x] Estados obrigatorios existem e sao coerentes.
|
|
47
|
+
- [x] A UI pode ser validada por screenshot ou checklist objetivo.
|
|
48
|
+
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Guia Executivo de Onboarding (1 página)
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
Garantir que o projeto seja iniciado, executado e levado para produção sem perda de contexto, com governança de decisão e risco.
|
|
5
|
+
|
|
6
|
+
## Resultado Esperado
|
|
7
|
+
- Time alinhado em objetivos e escopo.
|
|
8
|
+
- Execução com steps claros, donos e critérios de pronto.
|
|
9
|
+
- Decisão Go/No-Go baseada em evidências.
|
|
10
|
+
- Continuidade operacional via documentação + handoff + resumos.
|
|
11
|
+
|
|
12
|
+
## Como Iniciar (rápido)
|
|
13
|
+
1. Criar projeto com scaffold:
|
|
14
|
+
```bash
|
|
15
|
+
npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
16
|
+
```
|
|
17
|
+
2. Subir backend e memória operacional:
|
|
18
|
+
```bash
|
|
19
|
+
cd nome-do-projeto/backend
|
|
20
|
+
npm install
|
|
21
|
+
npm run memory:db:init
|
|
22
|
+
npm run memory:db:sync
|
|
23
|
+
npm run start:dev
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Governança Mínima
|
|
27
|
+
- **Fonte da verdade**: markdown versionado (`memory/`, `docs/`).
|
|
28
|
+
- **Índice operacional**: SQLite para busca rápida de contexto.
|
|
29
|
+
- **Decisões arquiteturais**: ADR obrigatório para mudanças estruturais.
|
|
30
|
+
- **Troca entre responsáveis**: handoff obrigatório.
|
|
31
|
+
|
|
32
|
+
## Modelo de Execução
|
|
33
|
+
- Orquestrador decompõe o plano em steps menores.
|
|
34
|
+
- Workers executam por ownership de arquivo.
|
|
35
|
+
- Reviewer valida regressão, segurança e qualidade.
|
|
36
|
+
- Resumos globais/dominio são atualizados ao final de cada ciclo.
|
|
37
|
+
|
|
38
|
+
## Indicadores de Controle
|
|
39
|
+
- % steps com DoD completo
|
|
40
|
+
- # riscos críticos abertos
|
|
41
|
+
- cobertura de testes críticos
|
|
42
|
+
- incidentes pós-deploy
|
|
43
|
+
- tempo médio de handoff
|
|
44
|
+
|
|
45
|
+
## Gate de Produção (Go/No-Go)
|
|
46
|
+
### GO apenas se:
|
|
47
|
+
- build/testes/lint críticos verdes
|
|
48
|
+
- segurança validada (segredos, auth, validação de entrada)
|
|
49
|
+
- rollback definido e testado
|
|
50
|
+
- critérios de aceite aprovados
|
|
51
|
+
|
|
52
|
+
### NO-GO se:
|
|
53
|
+
- risco crítico sem mitigação
|
|
54
|
+
- falha de segurança/integridade
|
|
55
|
+
- ausência de rollback executável
|
|
56
|
+
|
|
57
|
+
## Responsabilidade da Liderança
|
|
58
|
+
- Cobrar clareza do plano e dos riscos antes da execução.
|
|
59
|
+
- Bloquear deploy sem checklist completo.
|
|
60
|
+
- Garantir atualização de documentação como parte da entrega.
|
|
61
|
+
|
|
62
|
+
## Mensagem-chave
|
|
63
|
+
O projeto não depende de “memória da conversa”; depende de disciplina de documentação operacional e decisão rastreável.
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
# Guia Operacional por Papel
|
|
2
|
+
|
|
3
|
+
Este guia define responsabilidades objetivas por papel para execução previsível e validação segura até produção.
|
|
4
|
+
|
|
5
|
+
## 1) DEV
|
|
6
|
+
|
|
7
|
+
### Missão
|
|
8
|
+
Implementar com qualidade, manter contexto atualizado e reduzir retrabalho.
|
|
9
|
+
|
|
10
|
+
### Checklist Diário
|
|
11
|
+
- Ler contexto mínimo (`memory/00-global`, `20-architecture`, `current-sprint`).
|
|
12
|
+
- Executar tarefa com dono de escopo claro.
|
|
13
|
+
- Rodar testes mínimos da mudança.
|
|
14
|
+
- Atualizar documentação impactada.
|
|
15
|
+
- Atualizar resumo/handoff quando necessário.
|
|
16
|
+
- Rodar sync da memória operacional:
|
|
17
|
+
```bash
|
|
18
|
+
cd backend
|
|
19
|
+
npm run memory:db:sync
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
### Critério de Pronto (DEV)
|
|
23
|
+
- Código implementado
|
|
24
|
+
- Teste mínimo ok
|
|
25
|
+
- Sem quebra conhecida
|
|
26
|
+
- Documentação atualizada
|
|
27
|
+
- Risco registrado
|
|
28
|
+
|
|
29
|
+
## 2) QA
|
|
30
|
+
|
|
31
|
+
### Missão
|
|
32
|
+
Garantir que comportamento, qualidade e critérios de aceite estejam validados.
|
|
33
|
+
|
|
34
|
+
### Checklist QA
|
|
35
|
+
- Validar critérios de aceite do step.
|
|
36
|
+
- Rodar cenários críticos (feliz + erro).
|
|
37
|
+
- Verificar regressão funcional.
|
|
38
|
+
- Validar contrato de API (status, payload, erro).
|
|
39
|
+
- Registrar evidências objetivas.
|
|
40
|
+
|
|
41
|
+
### Saída QA
|
|
42
|
+
- `Aprovado` / `Aprovado com ressalvas` / `Reprovado`
|
|
43
|
+
- Bugs com severidade e impacto
|
|
44
|
+
- Recomendação para gate de produção
|
|
45
|
+
|
|
46
|
+
## 3) SRE
|
|
47
|
+
|
|
48
|
+
### Missão
|
|
49
|
+
Assegurar estabilidade operacional, observabilidade e rollback.
|
|
50
|
+
|
|
51
|
+
### Checklist SRE
|
|
52
|
+
- Healthcheck funcional.
|
|
53
|
+
- Logs e métricas essenciais disponíveis.
|
|
54
|
+
- Alertas mínimos ativos.
|
|
55
|
+
- Rollback documentado e testável.
|
|
56
|
+
- Dependências externas validadas.
|
|
57
|
+
|
|
58
|
+
### Gate SRE
|
|
59
|
+
Sem rollback executável e sem observabilidade mínima: **NO-GO**.
|
|
60
|
+
|
|
61
|
+
## 4) TECH LEAD
|
|
62
|
+
|
|
63
|
+
### Missão
|
|
64
|
+
Orquestrar plano, reduzir risco sistêmico e garantir decisão técnica coerente.
|
|
65
|
+
|
|
66
|
+
### Checklist Tech Lead
|
|
67
|
+
- Quebrar demanda em steps testáveis.
|
|
68
|
+
- Validar dependências e ordem de execução.
|
|
69
|
+
- Garantir ownership sem sobreposição de escrita.
|
|
70
|
+
- Exigir ADR em decisão estrutural.
|
|
71
|
+
- Consolidar riscos antes de produção.
|
|
72
|
+
|
|
73
|
+
### Entregável Tech Lead
|
|
74
|
+
- Plano final da sprint
|
|
75
|
+
- Matriz de risco
|
|
76
|
+
- Recomendação Go/No-Go
|
|
77
|
+
|
|
78
|
+
## 5) Fluxo Integrado (papéis)
|
|
79
|
+
|
|
80
|
+
1. Tech Lead/Orchestrator define steps e donos.
|
|
81
|
+
2. Dev implementa + testa + documenta.
|
|
82
|
+
3. QA valida critérios e regressão.
|
|
83
|
+
4. SRE valida operação e rollback.
|
|
84
|
+
5. Tech Lead consolida e decide com stakeholders.
|
|
85
|
+
|
|
86
|
+
## 6) Questionamento Obrigatório por Step
|
|
87
|
+
|
|
88
|
+
Antes de executar, todos devem responder:
|
|
89
|
+
- Está claro o objetivo e o critério de sucesso?
|
|
90
|
+
- Dependências e bloqueios estão explícitos?
|
|
91
|
+
- Risco e impacto foram mapeados?
|
|
92
|
+
- Existe forma de validar e de reverter?
|
|
93
|
+
|
|
94
|
+
Se qualquer item for “não”: refinar step antes da execução.
|
|
95
|
+
|
|
96
|
+
## 7) Comandos Úteis
|
|
97
|
+
|
|
98
|
+
### Setup
|
|
99
|
+
```bash
|
|
100
|
+
cd backend
|
|
101
|
+
npm install
|
|
102
|
+
npm run memory:db:init
|
|
103
|
+
npm run memory:db:sync
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
### Consulta de contexto
|
|
107
|
+
```bash
|
|
108
|
+
npm run memory:db:query -- "search" "auth" 10
|
|
109
|
+
npm run memory:db:query -- handoffs 10
|
|
110
|
+
npm run memory:db:query -- adrs 20
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### Registrar handoff
|
|
114
|
+
```bash
|
|
115
|
+
cd ..
|
|
116
|
+
node scripts/append-handoff.mjs orchestrator backend-nest "implementar modulo auth"
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
## 8) Gate Final de Produção
|
|
120
|
+
|
|
121
|
+
### GO quando:
|
|
122
|
+
- DEV, QA e SRE aprovaram seus checklists
|
|
123
|
+
- riscos críticos mitigados
|
|
124
|
+
- rollback pronto
|
|
125
|
+
|
|
126
|
+
### NO-GO quando:
|
|
127
|
+
- risco crítico aberto
|
|
128
|
+
- falha de segurança
|
|
129
|
+
- ausência de evidência de validação
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## 9) Princípio de operação
|
|
134
|
+
|
|
135
|
+
Qualidade, documentação e continuidade de contexto são parte da entrega técnica.
|
|
136
|
+
Não são atividades opcionais.
|
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
# Guia de Onboarding do Projeto
|
|
2
|
+
|
|
3
|
+
Este documento ensina como iniciar, estruturar, executar e validar um projeto usando o scaffold `create-memory-nest-kit`.
|
|
4
|
+
|
|
5
|
+
## 1) Objetivo do Guia
|
|
6
|
+
|
|
7
|
+
Ao final deste guia, a pessoa responsável deve conseguir:
|
|
8
|
+
- criar um projeto com `npx`
|
|
9
|
+
- entender a estrutura de memória/documentação
|
|
10
|
+
- gerar e revisar os steps de execução
|
|
11
|
+
- questionar o plano antes de executar
|
|
12
|
+
- validar com checklist técnico e de produção
|
|
13
|
+
- realizar go-live com segurança
|
|
14
|
+
|
|
15
|
+
## 2) Pré-requisitos
|
|
16
|
+
|
|
17
|
+
- Node.js 18+
|
|
18
|
+
- npm 9+
|
|
19
|
+
- Git instalado
|
|
20
|
+
- Conta GitHub (se for publicar remoto)
|
|
21
|
+
- (Opcional) Conta npm (se for publicar pacote)
|
|
22
|
+
|
|
23
|
+
Validação rápida:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
node -v
|
|
27
|
+
npm -v
|
|
28
|
+
git --version
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## 3) Criar Projeto com npx
|
|
32
|
+
|
|
33
|
+
### Opção A: via GitHub
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Opção B: via npm
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npx create-memory-nest-kit@latest nome-do-projeto
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Opção C: local (desenvolvimento)
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
node ./bin/create-memory-nest-kit.js nome-do-projeto
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Entrar no projeto:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
cd nome-do-projeto
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## 4) Estrutura Gerada (resumo)
|
|
58
|
+
|
|
59
|
+
- `memory/`: base de contexto e continuidade
|
|
60
|
+
- `agents/`: responsabilidades por tipo de agente
|
|
61
|
+
- `skills/`: playbooks operacionais reutilizáveis
|
|
62
|
+
- `prompts/`: templates de orquestração e execução
|
|
63
|
+
- `scripts/`: utilitários de contexto e handoff
|
|
64
|
+
- `backend/`: API NestJS base
|
|
65
|
+
- `.memory/sqlite/`: índice SQLite operacional
|
|
66
|
+
|
|
67
|
+
## 5) Primeiro Setup
|
|
68
|
+
|
|
69
|
+
### 5.1 Backend
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
cd backend
|
|
73
|
+
npm install
|
|
74
|
+
npm run start:dev
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Checagem esperada:
|
|
78
|
+
- API sobe sem erro
|
|
79
|
+
- rota de saúde responde (`/api/health`)
|
|
80
|
+
|
|
81
|
+
### 5.2 Memória operacional (SQLite)
|
|
82
|
+
|
|
83
|
+
Ainda dentro de `backend/`:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
npm run memory:db:init
|
|
87
|
+
npm run memory:db:sync
|
|
88
|
+
npm run memory:db:query -- "search" "contexto" 10
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
O que isso faz:
|
|
92
|
+
- `init`: cria schema do banco de memória
|
|
93
|
+
- `sync`: indexa os markdowns (memory/docs/agents/skills/prompts)
|
|
94
|
+
- `query`: consulta rápida de contexto
|
|
95
|
+
|
|
96
|
+
## 6) Como Gerar os Steps do Projeto
|
|
97
|
+
|
|
98
|
+
Use este fluxo para definir plano e execução:
|
|
99
|
+
|
|
100
|
+
1. Ler contexto mínimo:
|
|
101
|
+
- `memory/00-global/*`
|
|
102
|
+
- `memory/10-product/*`
|
|
103
|
+
- `memory/20-architecture/*`
|
|
104
|
+
- `memory/40-delivery/current-sprint.md`
|
|
105
|
+
|
|
106
|
+
2. Criar plano inicial em `memory/40-delivery/current-sprint.md` com:
|
|
107
|
+
- objetivo
|
|
108
|
+
- steps técnicos
|
|
109
|
+
- riscos
|
|
110
|
+
- dono por step
|
|
111
|
+
|
|
112
|
+
3. Quebrar em subtarefas (se necessário) no padrão multiagente:
|
|
113
|
+
- Orchestrator define escopo
|
|
114
|
+
- Worker por domínio executa
|
|
115
|
+
- Reviewer valida
|
|
116
|
+
|
|
117
|
+
4. Registrar handoffs:
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
node scripts/append-handoff.mjs orchestrator backend-nest "implementar modulo auth"
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
5. Atualizar resumo operacional:
|
|
124
|
+
- `memory/70-summaries/global-summary.md`
|
|
125
|
+
- `memory/70-summaries/domain-summary.md`
|
|
126
|
+
|
|
127
|
+
## 7) Questionando os Steps (obrigatório)
|
|
128
|
+
|
|
129
|
+
Antes de executar qualquer step, responder:
|
|
130
|
+
|
|
131
|
+
### 7.1 Clareza
|
|
132
|
+
- O step está claro e testável?
|
|
133
|
+
- O resultado esperado está explícito?
|
|
134
|
+
|
|
135
|
+
### 7.2 Dependências
|
|
136
|
+
- Esse step depende de outro?
|
|
137
|
+
- Há bloqueio externo (infra, credencial, API de terceiro)?
|
|
138
|
+
|
|
139
|
+
### 7.3 Risco
|
|
140
|
+
- Qual risco funcional?
|
|
141
|
+
- Qual risco de segurança?
|
|
142
|
+
- Qual risco de regressão?
|
|
143
|
+
|
|
144
|
+
### 7.4 Observabilidade
|
|
145
|
+
- Como saber se deu certo?
|
|
146
|
+
- Que métrica/log/teste confirma o sucesso?
|
|
147
|
+
|
|
148
|
+
### 7.5 Rollback
|
|
149
|
+
- Se falhar, como desfazer com segurança?
|
|
150
|
+
|
|
151
|
+
Se qualquer resposta estiver fraca, o step volta para refinamento antes de execução.
|
|
152
|
+
|
|
153
|
+
## 8) Critério de Pronto por Step (Definition of Done)
|
|
154
|
+
|
|
155
|
+
Um step só é concluído quando:
|
|
156
|
+
- código implementado
|
|
157
|
+
- teste mínimo executado
|
|
158
|
+
- risco registrado
|
|
159
|
+
- documentação atualizada
|
|
160
|
+
- resumo/handoff atualizado (se houve troca de agente)
|
|
161
|
+
|
|
162
|
+
## 9) Validação Pré-Produção
|
|
163
|
+
|
|
164
|
+
Checklist mínimo:
|
|
165
|
+
|
|
166
|
+
### 9.1 Técnica
|
|
167
|
+
- build ok
|
|
168
|
+
- testes críticos ok
|
|
169
|
+
- lint/qualidade ok
|
|
170
|
+
- migrations validadas (se houver)
|
|
171
|
+
|
|
172
|
+
### 9.2 Segurança
|
|
173
|
+
- sem segredo hardcoded
|
|
174
|
+
- validação de entrada ativa
|
|
175
|
+
- autorização revisada
|
|
176
|
+
- logs sem dados sensíveis
|
|
177
|
+
|
|
178
|
+
### 9.3 Operação
|
|
179
|
+
- healthcheck ok
|
|
180
|
+
- monitoramento/alertas definidos
|
|
181
|
+
- rollback pronto e testado
|
|
182
|
+
|
|
183
|
+
### 9.4 Produto
|
|
184
|
+
- critérios de aceite atendidos
|
|
185
|
+
- fluxos críticos validados com negócio
|
|
186
|
+
|
|
187
|
+
## 10) Go/No-Go para Produção
|
|
188
|
+
|
|
189
|
+
Regra prática:
|
|
190
|
+
- **GO**: todos checklists verdes + riscos aceitáveis + rollback pronto
|
|
191
|
+
- **NO-GO**: qualquer falha crítica em segurança, integridade de dados ou indisponibilidade sem plano de retorno
|
|
192
|
+
|
|
193
|
+
Template de decisão:
|
|
194
|
+
|
|
195
|
+
```text
|
|
196
|
+
Decisão: GO | NO-GO
|
|
197
|
+
Data:
|
|
198
|
+
Responsável:
|
|
199
|
+
Motivos:
|
|
200
|
+
Riscos remanescentes:
|
|
201
|
+
Plano de rollback:
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
## 11) Pós-Deploy (produção)
|
|
205
|
+
|
|
206
|
+
Após subir:
|
|
207
|
+
- monitorar logs e métricas por janela definida
|
|
208
|
+
- validar rotas críticas
|
|
209
|
+
- registrar resultado em `memory/60-runs/` e resumo em `memory/70-summaries/global-summary.md`
|
|
210
|
+
|
|
211
|
+
Template pós-deploy:
|
|
212
|
+
|
|
213
|
+
```text
|
|
214
|
+
Deploy realizado em:
|
|
215
|
+
Versão:
|
|
216
|
+
Status inicial:
|
|
217
|
+
Incidentes:
|
|
218
|
+
Ações corretivas:
|
|
219
|
+
Próximos passos:
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
## 12) Fluxo Recomendado de Trabalho Diário
|
|
223
|
+
|
|
224
|
+
1. Sincronizar memória:
|
|
225
|
+
```bash
|
|
226
|
+
cd backend
|
|
227
|
+
npm run memory:db:sync
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
2. Buscar contexto da tarefa:
|
|
231
|
+
```bash
|
|
232
|
+
npm run memory:db:query -- "search" "tema da tarefa" 10
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
3. Executar step
|
|
236
|
+
4. Atualizar docs + resumo
|
|
237
|
+
5. Registrar handoff (se houver troca de responsável)
|
|
238
|
+
|
|
239
|
+
## 13) Erros Comuns e Como Evitar
|
|
240
|
+
|
|
241
|
+
- Erro: executar sem refinar step.
|
|
242
|
+
- Evitar: aplicar seção 7 (questionamento obrigatório).
|
|
243
|
+
|
|
244
|
+
- Erro: esquecer atualização de memória.
|
|
245
|
+
- Evitar: sempre rodar `memory:db:sync` após mudanças relevantes.
|
|
246
|
+
|
|
247
|
+
- Erro: deploy sem rollback claro.
|
|
248
|
+
- Evitar: incluir rollback como item obrigatório no DoD.
|
|
249
|
+
|
|
250
|
+
- Erro: contexto disperso em chat apenas.
|
|
251
|
+
- Evitar: registrar decisão em `memory/90-decisions` e resumo em `memory/70-summaries`.
|
|
252
|
+
|
|
253
|
+
## 14) Comandos Rápidos (cola)
|
|
254
|
+
|
|
255
|
+
```bash
|
|
256
|
+
# criar projeto
|
|
257
|
+
npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
258
|
+
|
|
259
|
+
# setup inicial
|
|
260
|
+
cd nome-do-projeto/backend
|
|
261
|
+
npm install
|
|
262
|
+
npm run memory:db:init
|
|
263
|
+
npm run memory:db:sync
|
|
264
|
+
npm run start:dev
|
|
265
|
+
|
|
266
|
+
# consultar contexto
|
|
267
|
+
npm run memory:db:query -- "search" "auth" 10
|
|
268
|
+
|
|
269
|
+
# registrar handoff (na raiz do projeto)
|
|
270
|
+
cd ..
|
|
271
|
+
node scripts/append-handoff.mjs orchestrator backend-nest "step de auth"
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
---
|
|
275
|
+
|
|
276
|
+
## 15) Ponto Mais Importante
|
|
277
|
+
|
|
278
|
+
Este projeto foi desenhado para **não perder contexto operacional**.
|
|
279
|
+
A disciplina de documentação + handoff + resumo é parte da entrega, não “extra”.
|