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,172 @@
|
|
|
1
|
+
# 👔 Guia para Executivos
|
|
2
|
+
|
|
3
|
+
Você é executor, quer know ROI, timeline, risco. Vai reto ao ponto.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## ⏱️ Leia em 10 minutos
|
|
8
|
+
|
|
9
|
+
### O que é isso?
|
|
10
|
+
|
|
11
|
+
**create-memory-nest-kit** é uma ferramenta que gera projetos prontos com:
|
|
12
|
+
|
|
13
|
+
- **Memória estruturada** — Documentação organizada para escalar sem perder contexto
|
|
14
|
+
- **Agentes orquestrados** — IAs trabalham em paralelo sem conflito
|
|
15
|
+
- **Backend NestJS** — API moderna, escalável, production-ready
|
|
16
|
+
- **Dashboards operacionais** — Visualize tudo em tempo real
|
|
17
|
+
|
|
18
|
+
### O que ganhamos?
|
|
19
|
+
|
|
20
|
+
| Aspecto | Antes | Depois |
|
|
21
|
+
|--------|-------|--------|
|
|
22
|
+
| **Contexto** | Uma IA = 1 pessoa | Múltiplas IAs = squad |
|
|
23
|
+
| **Qualidade** | Manual | Automática (validação + testes) |
|
|
24
|
+
| **Escala** | Até 100K tokens | 1M+ tokens com segmentação |
|
|
25
|
+
| **Setup** | ~1 semana | ~30 minutos |
|
|
26
|
+
|
|
27
|
+
### Quanto tempo?
|
|
28
|
+
|
|
29
|
+
- **Gerar estrutura:** 2 minutos
|
|
30
|
+
- **Setup backend:** 10 minutos
|
|
31
|
+
- **Começar a desenvolver:** 15 minutos
|
|
32
|
+
- **Total:** ~30 minutos até primeira feature
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 📊 Números que Importam
|
|
37
|
+
|
|
38
|
+
### Produtividade
|
|
39
|
+
|
|
40
|
+
- **Antes:** 1 developer = ~8h/dia de código
|
|
41
|
+
- **Depois:** 1 developer + 3 agents = ~40h/dia equivalente (paralelo)
|
|
42
|
+
- **ROI:** 5x velocidade, ~2 semanas para break-even
|
|
43
|
+
|
|
44
|
+
### Qualidade
|
|
45
|
+
|
|
46
|
+
- Testes automáticos: >80% coverage
|
|
47
|
+
- Validação de entrada obrigatória
|
|
48
|
+
- Revisão automática (revisor-agent)
|
|
49
|
+
- Zero regressões (handoff protocol)
|
|
50
|
+
|
|
51
|
+
### Risco
|
|
52
|
+
|
|
53
|
+
- ✅ Segurança: OWASP Top 10 mitigado
|
|
54
|
+
- ✅ Continuidade: Sem perda de contexto entre sprints
|
|
55
|
+
- ✅ Revert: Rollback automático via ADRs
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## 🚀 Primeiros Passos
|
|
60
|
+
|
|
61
|
+
### 1. Gerar um projeto (2 min)
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npm run workspace:init
|
|
65
|
+
npm run project:new meu-produto
|
|
66
|
+
cd ~/forja-workspace/projects/meu-produto
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### 2. Ver estrutura (1 min)
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
ls -la memory/
|
|
73
|
+
cat AGENTS.md
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### 3. Entender timeline (5 min)
|
|
77
|
+
|
|
78
|
+
Leia `memory/00-global/mission.md` + `memory/40-delivery/roadmap.md`
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 📈 KPIs para Acompanhar
|
|
83
|
+
|
|
84
|
+
### Velocidade
|
|
85
|
+
|
|
86
|
+
- **Sprint 0:** Setup completo (15 min)
|
|
87
|
+
- **Sprint 1:** Primeira feature (3 dias com agents)
|
|
88
|
+
- **Sprint N:** Velocity estabiliza em 2-3x baseline
|
|
89
|
+
|
|
90
|
+
### Qualidade
|
|
91
|
+
|
|
92
|
+
- **Coverage:** Target 80%+ em rotas críticas
|
|
93
|
+
- **Bugs:** Redução de 60% vs manual (validação obrigatória)
|
|
94
|
+
- **Tempo de review:** -70% (revisor-agent automático)
|
|
95
|
+
|
|
96
|
+
### Escala
|
|
97
|
+
|
|
98
|
+
- **Linhas de código:** +3x em mesmo esforço
|
|
99
|
+
- **Agentes paralelos:** 3-6 simultâneos
|
|
100
|
+
- **Memória:** 1M+ tokens sem perda
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## 💰 Investimento
|
|
105
|
+
|
|
106
|
+
### Custo
|
|
107
|
+
- **Primeira semana:** ~10h (setup + onboarding)
|
|
108
|
+
- **Semanal:** ~5h (orchestration + reviews)
|
|
109
|
+
- **Ferramental:** Gratuito (open source)
|
|
110
|
+
|
|
111
|
+
### Retorno
|
|
112
|
+
- **Break-even:** ~2 semanas
|
|
113
|
+
- **Velocity gain:** 2-5x a partir de Sprint 2
|
|
114
|
+
- **Bug reduction:** 60% (automação de validação)
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## ⚠️ Riscos & Mitigação
|
|
119
|
+
|
|
120
|
+
| Risco | Impacto | Mitigação |
|
|
121
|
+
|-------|---------|-----------|
|
|
122
|
+
| Agentes conflitam | Alto | Handoff protocol obrigatório |
|
|
123
|
+
| Contexto se perde | Alto | Memory structure + resumos |
|
|
124
|
+
| Deploy quebrado | Médio | Testes automáticos |
|
|
125
|
+
| Segredos expostos | Crítico | .env fora do git |
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## 📋 Decisões Necessárias
|
|
130
|
+
|
|
131
|
+
### Decisão 1: Que persona você é?
|
|
132
|
+
|
|
133
|
+
- **Executivo** → Este guia ✅
|
|
134
|
+
- **Arquiteto** → [Guia de Arquiteto](../architect/README.md)
|
|
135
|
+
- **Developer** → [Guia de Developer](../developer/README.md)
|
|
136
|
+
|
|
137
|
+
### Decisão 2: Começar quando?
|
|
138
|
+
|
|
139
|
+
- **Já** → Execute os "Primeiros Passos" agora
|
|
140
|
+
- **Próxima sprint** → Ler REFINAMENTO-v1.0 antes
|
|
141
|
+
|
|
142
|
+
### Decisão 3: Qual escala?
|
|
143
|
+
|
|
144
|
+
- **Pequena** (1-3 agents): Este guia é suficiente
|
|
145
|
+
- **Grande** (6+ agents): Ler playbook de paralelização
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## 📞 Próximos Passos
|
|
150
|
+
|
|
151
|
+
1. **Aprove o setup** — "Ok, vamos de 30 min de setup"
|
|
152
|
+
2. **Designe um tech lead** — Ele lê o guia de Arquiteto
|
|
153
|
+
3. **Reserve 1h para kickoff** — Apresentar a estrutura ao squad
|
|
154
|
+
4. **Primeira sprint** — Já com 1-2 features em paralelo
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## 🎯 Checklist de Onboarding (Executivo)
|
|
159
|
+
|
|
160
|
+
- [ ] Li este guia (10 min)
|
|
161
|
+
- [ ] Aprovi o approach (5 min)
|
|
162
|
+
- [ ] Designei tech lead
|
|
163
|
+
- [ ] Marcamos kickoff do squad
|
|
164
|
+
- [ ] Pronto!
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
**Tempo total para decisão:** 15 min
|
|
169
|
+
**Tempo até primeira feature:** 2-3 dias (com agents paralelos)
|
|
170
|
+
**ROI esperado:** 2-3x velocidade
|
|
171
|
+
|
|
172
|
+
📞 Próximo: Designe um **Tech Lead** para ler o [Guia de Arquiteto](../architect/README.md)
|
|
@@ -0,0 +1,350 @@
|
|
|
1
|
+
# 🧪 Guia para QA / Testers
|
|
2
|
+
|
|
3
|
+
Você valida qualidade. Quer critérios, checklists, automação.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## ⏱️ Leia em 10 minutos
|
|
8
|
+
|
|
9
|
+
### O que você precisa saber
|
|
10
|
+
|
|
11
|
+
**create-memory-nest-kit** gera projetos com:
|
|
12
|
+
|
|
13
|
+
- **Testes automáticos** — >80% coverage obrigatório
|
|
14
|
+
- **Validação de entrada** — Sem dados inválidos na API
|
|
15
|
+
- **Revisão automática** — Revisor-agent bloqueia código ruim
|
|
16
|
+
|
|
17
|
+
### Seu papel
|
|
18
|
+
|
|
19
|
+
1. **Validar critérios de aceite** (antes do deploy)
|
|
20
|
+
2. **Testar handoffs** (qualidade entre agentes)
|
|
21
|
+
3. **Verificar checklist de segurança** (OWASP Top 10)
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 🎯 Critérios de Aceite (Obrigatório)
|
|
26
|
+
|
|
27
|
+
### Para TODA feature:
|
|
28
|
+
|
|
29
|
+
- [ ] **Código**
|
|
30
|
+
- ✅ Lint passa (ESLint)
|
|
31
|
+
- ✅ Sem TypeScript errors
|
|
32
|
+
- ✅ >80% coverage em rotas críticas
|
|
33
|
+
- ✅ Sem console.log deixado
|
|
34
|
+
|
|
35
|
+
- [ ] **Testes**
|
|
36
|
+
- ✅ Unit tests passam
|
|
37
|
+
- ✅ E2E tests cobrem happy path + error cases
|
|
38
|
+
- ✅ Sem testes "skip" ou "todo"
|
|
39
|
+
|
|
40
|
+
- [ ] **Segurança**
|
|
41
|
+
- ✅ DTO com validação (obrigatório)
|
|
42
|
+
- ✅ Sem secrets em logs/erro
|
|
43
|
+
- ✅ Sem SQL injection
|
|
44
|
+
- ✅ Rate limiting habilitado
|
|
45
|
+
|
|
46
|
+
- [ ] **Documentação**
|
|
47
|
+
- ✅ Handoff preenchido completamente
|
|
48
|
+
- ✅ ADR criado (se decisão)
|
|
49
|
+
- ✅ memory/30-domains/[dominio]/api.md atualizado
|
|
50
|
+
|
|
51
|
+
- [ ] **Performance**
|
|
52
|
+
- ✅ Endpoint responde <200ms
|
|
53
|
+
- ✅ Sem N+1 queries
|
|
54
|
+
- ✅ Sem memory leaks
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## 📋 Checklist Pre-Commit
|
|
59
|
+
|
|
60
|
+
Execute ANTES de aprovar:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
# 1. Lint + Build
|
|
64
|
+
npm run lint
|
|
65
|
+
npm run build
|
|
66
|
+
|
|
67
|
+
# 2. Testes
|
|
68
|
+
npm test
|
|
69
|
+
npm run test:cov # Verificar coverage > 80%
|
|
70
|
+
|
|
71
|
+
# 3. E2E
|
|
72
|
+
npm run test:e2e
|
|
73
|
+
|
|
74
|
+
# 4. Segurança básica
|
|
75
|
+
grep -r "TODO\|FIXME\|HACK" src/ # Sem deixadas
|
|
76
|
+
grep -r "console\." src/ # Sem logs em prod
|
|
77
|
+
grep -r "password\|secret\|api_key" src/ --exclude="*.env*" # Secretos expostos?
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 🔍 Teste Manual: 5 Passos
|
|
83
|
+
|
|
84
|
+
### 1. Health Check
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
curl http://localhost:3000/api/health
|
|
88
|
+
# Esperado: { "status": "ok" }
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### 2. Seu Endpoint
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
curl -X POST http://localhost:3000/api/seu-endpoint \
|
|
95
|
+
-H "Content-Type: application/json" \
|
|
96
|
+
-d '{"campo":"valor"}'
|
|
97
|
+
# Esperado: 200 OK ou erro específico
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### 3. Validação (enviando lixo)
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
# Teste com email inválido
|
|
104
|
+
curl -X POST http://localhost:3000/api/login \
|
|
105
|
+
-H "Content-Type: application/json" \
|
|
106
|
+
-d '{"email":"nao-e-email","password":"123"}'
|
|
107
|
+
# Esperado: 400 Bad Request (DTO rejection)
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### 4. Autenticação
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
# Sem token
|
|
114
|
+
curl http://localhost:3000/api/protegido
|
|
115
|
+
# Esperado: 401 Unauthorized
|
|
116
|
+
|
|
117
|
+
# Com token válido
|
|
118
|
+
curl -H "Authorization: Bearer TOKEN" http://localhost:3000/api/protegido
|
|
119
|
+
# Esperado: 200 OK (se implementado)
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
### 5. Rate Limiting
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
# Enviar 150 requests em 1 min
|
|
126
|
+
for i in {1..150}; do curl http://localhost:3000/api/health; done
|
|
127
|
+
# Esperado: Após 100, retorna 429 Too Many Requests
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## 🧪 Teste de Handoff
|
|
133
|
+
|
|
134
|
+
Quando agent A passa para agent B:
|
|
135
|
+
|
|
136
|
+
**Validar:**
|
|
137
|
+
- [ ] Contexto está claro (não precisa adivinhar)
|
|
138
|
+
- [ ] Alterações listadas = arquivos reais modificados
|
|
139
|
+
- [ ] Riscos são verdadeiros (não alarmes)
|
|
140
|
+
- [ ] Pendências têm dono (quem faz?)
|
|
141
|
+
- [ ] Próximo passo é executável (não vago)
|
|
142
|
+
|
|
143
|
+
**Exemplo BOM:**
|
|
144
|
+
```markdown
|
|
145
|
+
# Handoff: Backend → Reviewer
|
|
146
|
+
|
|
147
|
+
## Contexto
|
|
148
|
+
Implementei GET /api/users/{id} com JWT validation
|
|
149
|
+
|
|
150
|
+
## Alterações
|
|
151
|
+
- src/features/users/users.controller.ts
|
|
152
|
+
- src/features/users/users.service.ts
|
|
153
|
+
- src/features/users/dto/get-user.dto.ts
|
|
154
|
+
|
|
155
|
+
## Riscos
|
|
156
|
+
- 404 para user não encontrado (testado)
|
|
157
|
+
- JWT secret em .env apenas (seguro)
|
|
158
|
+
|
|
159
|
+
## Pendências
|
|
160
|
+
- Nenhuma
|
|
161
|
+
|
|
162
|
+
## Próximo passo
|
|
163
|
+
Revisor: Validar testes, fazer E2E
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
**Exemplo RUIM:**
|
|
167
|
+
```markdown
|
|
168
|
+
# Handoff: Backend → Reviewer
|
|
169
|
+
|
|
170
|
+
## Contexto
|
|
171
|
+
Implementei coisas
|
|
172
|
+
|
|
173
|
+
## Alterações
|
|
174
|
+
- Vários arquivos
|
|
175
|
+
|
|
176
|
+
## Riscos
|
|
177
|
+
- Talvez segurança?
|
|
178
|
+
|
|
179
|
+
## Pendências
|
|
180
|
+
- Talvez testes?
|
|
181
|
+
|
|
182
|
+
## Próximo passo
|
|
183
|
+
Aprova?
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
188
|
+
## 🔐 Checklist de Segurança (OWASP Top 10)
|
|
189
|
+
|
|
190
|
+
Para CADA endpoint novo:
|
|
191
|
+
|
|
192
|
+
- [ ] **A01:2021 – Broken Access Control**
|
|
193
|
+
- [ ] JWT/Auth obrigatório em rotas protegidas?
|
|
194
|
+
- [ ] Sem hardcoded roles/permissions?
|
|
195
|
+
|
|
196
|
+
- [ ] **A02:2021 – Cryptographic Failures**
|
|
197
|
+
- [ ] Senhas hasheadas? (bcrypt)
|
|
198
|
+
- [ ] Secrets em .env (não em código)?
|
|
199
|
+
- [ ] HTTPS only em prod?
|
|
200
|
+
|
|
201
|
+
- [ ] **A03:2021 – Injection**
|
|
202
|
+
- [ ] DTO com validação bloqueia SQL injection?
|
|
203
|
+
- [ ] Sem concatenação de queries?
|
|
204
|
+
|
|
205
|
+
- [ ] **A04:2021 – Insecure Design**
|
|
206
|
+
- [ ] Rate limiting ativado?
|
|
207
|
+
- [ ] CORS restritivo?
|
|
208
|
+
|
|
209
|
+
- [ ] **A05:2021 – Security Misconfiguration**
|
|
210
|
+
- [ ] Sem console.log de dados sensíveis?
|
|
211
|
+
- [ ] Helmet headers presente?
|
|
212
|
+
|
|
213
|
+
- [ ] **A06:2021 – Vulnerable Components**
|
|
214
|
+
- [ ] npm audit limpo? (npm audit)
|
|
215
|
+
- [ ] Dependências atualizadas?
|
|
216
|
+
|
|
217
|
+
---
|
|
218
|
+
|
|
219
|
+
## 📊 Teste Coverage
|
|
220
|
+
|
|
221
|
+
### Alvo: >80% em código crítico
|
|
222
|
+
|
|
223
|
+
```bash
|
|
224
|
+
npm run test:cov
|
|
225
|
+
# Abre coverage/index.html
|
|
226
|
+
|
|
227
|
+
# Verificar:
|
|
228
|
+
# - Statements > 80%
|
|
229
|
+
# - Branches > 75%
|
|
230
|
+
# - Functions > 80%
|
|
231
|
+
# - Lines > 80%
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
## 🚀 Teste E2E Rápido
|
|
237
|
+
|
|
238
|
+
```typescript
|
|
239
|
+
// test/features.e2e-spec.ts
|
|
240
|
+
describe('Features (e2e)', () => {
|
|
241
|
+
let app: INestApplication;
|
|
242
|
+
|
|
243
|
+
beforeAll(async () => {
|
|
244
|
+
const moduleFixture = await Test.createTestingModule({
|
|
245
|
+
imports: [AppModule]
|
|
246
|
+
}).compile();
|
|
247
|
+
app = moduleFixture.createNestApplication();
|
|
248
|
+
await app.init();
|
|
249
|
+
});
|
|
250
|
+
|
|
251
|
+
it('POST /api/seu-endpoint com dados válidos', () => {
|
|
252
|
+
return request(app.getHttpServer())
|
|
253
|
+
.post('/api/seu-endpoint')
|
|
254
|
+
.send({ campo: 'valor' })
|
|
255
|
+
.expect(201)
|
|
256
|
+
.expect((res) => {
|
|
257
|
+
expect(res.body.id).toBeDefined();
|
|
258
|
+
});
|
|
259
|
+
});
|
|
260
|
+
|
|
261
|
+
it('POST /api/seu-endpoint com dados inválidos', () => {
|
|
262
|
+
return request(app.getHttpServer())
|
|
263
|
+
.post('/api/seu-endpoint')
|
|
264
|
+
.send({ campo: '' }) // Inválido
|
|
265
|
+
.expect(400); // Bad Request
|
|
266
|
+
});
|
|
267
|
+
});
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
Rodar:
|
|
271
|
+
```bash
|
|
272
|
+
npm run test:e2e
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
---
|
|
276
|
+
|
|
277
|
+
## 🎯 Fluxo de Validação
|
|
278
|
+
|
|
279
|
+
```
|
|
280
|
+
1. Developer cria feature
|
|
281
|
+
↓
|
|
282
|
+
2. Cria handoff em memory/50-orchestration/handoffs/
|
|
283
|
+
↓
|
|
284
|
+
3. Você valida handoff (checklist acima)
|
|
285
|
+
↓ Se ruim → Rejeita, Developer corrige
|
|
286
|
+
↓ Se bom → Aprova
|
|
287
|
+
↓
|
|
288
|
+
4. Você roda testes + validação
|
|
289
|
+
npm test && npm run test:cov
|
|
290
|
+
↓ Se falha → Rejeita
|
|
291
|
+
↓ Se passa → Aprova
|
|
292
|
+
↓
|
|
293
|
+
5. Você faz teste manual dos 5 passos
|
|
294
|
+
↓ Se quebra → Rejeita
|
|
295
|
+
↓ Se tudo bem → Aprova
|
|
296
|
+
↓
|
|
297
|
+
6. Deploy! 🚀
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
---
|
|
301
|
+
|
|
302
|
+
## 🐛 Bug Reporting
|
|
303
|
+
|
|
304
|
+
Quando encontrar bug:
|
|
305
|
+
|
|
306
|
+
```markdown
|
|
307
|
+
# Bug: Endpoint X retorna 500
|
|
308
|
+
|
|
309
|
+
## Reprodução
|
|
310
|
+
POST /api/seu-endpoint com payload { "campo": "valor especial" }
|
|
311
|
+
|
|
312
|
+
## Esperado
|
|
313
|
+
200 OK com response válido
|
|
314
|
+
|
|
315
|
+
## Atual
|
|
316
|
+
500 Internal Server Error
|
|
317
|
+
|
|
318
|
+
## Logs
|
|
319
|
+
[Cole stack trace aqui]
|
|
320
|
+
|
|
321
|
+
## Severidade
|
|
322
|
+
🔴 Critical (quebra feature)
|
|
323
|
+
```
|
|
324
|
+
|
|
325
|
+
---
|
|
326
|
+
|
|
327
|
+
## 📋 Checklist de Onboarding (QA)
|
|
328
|
+
|
|
329
|
+
- [ ] Li este guia (10 min)
|
|
330
|
+
- [ ] Rodei o generator (5 min)
|
|
331
|
+
- [ ] Executei os 5 testes manuais (5 min)
|
|
332
|
+
- [ ] Verifiquei coverage (5 min)
|
|
333
|
+
- [ ] Aprovei primeiro handoff ✅
|
|
334
|
+
- [ ] Pronto!
|
|
335
|
+
|
|
336
|
+
---
|
|
337
|
+
|
|
338
|
+
## 📞 Recursos
|
|
339
|
+
|
|
340
|
+
| Recurso | Quando usar |
|
|
341
|
+
|---------|------------|
|
|
342
|
+
| [CHECKLIST-FINAL.md](../../CHECKLIST-FINAL.md) | Critérios globais |
|
|
343
|
+
| [DASHBOARD-PROGRESSO.md](../../DASHBOARD-PROGRESSO.md) | Status do projeto |
|
|
344
|
+
| [REFINAMENTO-v1.0.md](../../REFINAMENTO-v1.0.md) | Segurança (SEC-*) |
|
|
345
|
+
|
|
346
|
+
---
|
|
347
|
+
|
|
348
|
+
**Tempo total:** ~30 min por feature até habituado
|
|
349
|
+
|
|
350
|
+
✅ Você é o guardião da qualidade!
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
# Processo de projeto com a IA — criar ou atualizar
|
|
2
|
+
|
|
3
|
+
Mapa de **nível 0**: como a demanda entra no framework e vira trabalho. Decide entre
|
|
4
|
+
**criar** um projeto novo e **atualizar** um existente; ambos convergem no ciclo
|
|
5
|
+
CLI-first de 6 etapas detalhado em [`docs/fluxo.md`](./fluxo.md).
|
|
6
|
+
|
|
7
|
+
> "Nossa IA" = os 6 papéis (`AGENTS.md`) operando via Claude Code, apoiados pelas 3
|
|
8
|
+
> capacidades do [ADR-0016](../memory/90-decisions/0016-integracao-capacidades-externas.md):
|
|
9
|
+
> **codegraph** (entender código), **harness** (desenhar time), **ai-engineering** (referência).
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Mapa de decisão
|
|
14
|
+
|
|
15
|
+
```mermaid
|
|
16
|
+
flowchart TD
|
|
17
|
+
D(["💡 Demanda"]) --> Q{"Projeto já<br/>existe?"}
|
|
18
|
+
|
|
19
|
+
%% ── Ramo A: NOVO ──
|
|
20
|
+
Q -- "Não" --> A1["A1· Gerar scaffold<br/>npm run init:project <nome> --ai claude,copilot"]
|
|
21
|
+
A1 --> A2["A2· Escolher boilerplate<br/>api-rest · saas · ecommerce · microservices · monorepo"]
|
|
22
|
+
A2 --> A3["A3· (opcional) harness<br/>desenha o time de agentes do domínio"]
|
|
23
|
+
A3 --> C0
|
|
24
|
+
|
|
25
|
+
%% ── Ramo B: EXISTENTE ──
|
|
26
|
+
Q -- "Sim" --> B0{"Já tem<br/>memory/?"}
|
|
27
|
+
B0 -- "Não" --> B1["B1· Overlay de memória<br/>init:project detecta backend → --only-memory"]
|
|
28
|
+
B0 -- "Sim" --> B2["B2· Indexar código<br/>codegraph init (entender o que existe)"]
|
|
29
|
+
B1 --> B2
|
|
30
|
+
B2 --> C0
|
|
31
|
+
|
|
32
|
+
%% ── Convergência: ciclo SDD+GSD ──
|
|
33
|
+
C0(["▶ Entra no ciclo CLI-first"]) --> CICLO
|
|
34
|
+
subgraph CICLO["docs/fluxo.md — 6 etapas"]
|
|
35
|
+
direction LR
|
|
36
|
+
c1["1·Entender"] --> c2["2·Especificar"] --> c3["3·Arquitetar"] --> c4["4·Decompor"] --> c5["5·Implementar"] --> c6["6·Governar"]
|
|
37
|
+
end
|
|
38
|
+
CICLO --> OUT(["✅ Entrega + memória atualizada"])
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### Fallback ASCII
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
💡 Demanda
|
|
45
|
+
│
|
|
46
|
+
├─ projeto NÃO existe ─► A1 init:project <nome> --ai …
|
|
47
|
+
│ A2 escolher boilerplate
|
|
48
|
+
│ A3 (opc.) harness desenha o time ─┐
|
|
49
|
+
│ │
|
|
50
|
+
└─ projeto JÁ existe ──► tem memory/? │
|
|
51
|
+
├─ não ► B1 overlay --only-memory │
|
|
52
|
+
└─ sim ─┘ │
|
|
53
|
+
B2 codegraph init ────────┤
|
|
54
|
+
▼
|
|
55
|
+
▶ CICLO (docs/fluxo.md):
|
|
56
|
+
1·Entender → 2·Especificar → 3·Arquitetar
|
|
57
|
+
→ 4·Decompor → 5·Implementar → 6·Governar ─► ✅
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## Ramo A — Criar projeto novo
|
|
63
|
+
|
|
64
|
+
O gerador (`bin/init-project.js`) roda 8 passos: git-init → estrutura agentes+memória
|
|
65
|
+
→ design-lib → instruções multi-IA → install-backend → init memória SQLite →
|
|
66
|
+
context-pack → next-steps. Cada projeto nasce com `memory/`, `.ia-instructions/`
|
|
67
|
+
(claude/copilot/gemini/codex) e seu próprio banco de memória.
|
|
68
|
+
|
|
69
|
+
Projetos de produto vivem no **workspace Forja** (`~/forja-workspace/projects/<nome>`
|
|
70
|
+
por padrão), fora do repo do framework. Veja ADR-0019.
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
# 1. preparar workspace (uma vez)
|
|
74
|
+
npm run workspace:init
|
|
75
|
+
|
|
76
|
+
# 2. gerar (cria em ~/forja-workspace/projects/<nome>)
|
|
77
|
+
npm run project:new <nome> -- --ai claude,copilot,gemini
|
|
78
|
+
|
|
79
|
+
# 3. (opcional) escolher boilerplate de stack
|
|
80
|
+
ls boilerplates/ # 01-api-rest · 02-saas-starter · 03-ecommerce · 04-microservices · 05-monorepo
|
|
81
|
+
|
|
82
|
+
# 4. (opcional) na sessão Claude Code, desenhar o time de agentes do domínio:
|
|
83
|
+
# "build a harness for this project" → gera .claude/agents + .claude/skills
|
|
84
|
+
|
|
85
|
+
# 5. entrar no ciclo: começa pela spec
|
|
86
|
+
npm run spec:new -- <slug>
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Ramo B — Atualizar projeto existente
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
# B1. projeto sem memória ainda? sobrepõe só a camada de memória/agentes
|
|
95
|
+
# (init:project detecta backend e aplica --only-memory automaticamente)
|
|
96
|
+
npm run init:project <nome> # apontando para o projeto existente
|
|
97
|
+
|
|
98
|
+
# B2. indexar o código atual ANTES de mexer (entender sem ler arquivo a arquivo)
|
|
99
|
+
codegraph init # ou: npm run code:index
|
|
100
|
+
codegraph explore "<área a mudar>"
|
|
101
|
+
|
|
102
|
+
# entra no ciclo pela spec da mudança
|
|
103
|
+
npm run spec:new -- <slug>
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
A diferença essencial do ramo B é a **etapa 1 (Entender) com codegraph**: antes de
|
|
107
|
+
especificar a mudança, mapeie símbolos, callers e impacto no código que já existe.
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Convergência — o ciclo (resumo)
|
|
112
|
+
|
|
113
|
+
Os dois ramos terminam no mesmo ciclo de 6 etapas. Quem dirige cada uma:
|
|
114
|
+
|
|
115
|
+
| # | Etapa | Papel | Capacidade |
|
|
116
|
+
|---|-------|-------|------------|
|
|
117
|
+
| 1 | Entender | context-engineer | codegraph · ai-engineering |
|
|
118
|
+
| 2 | Especificar | product | — |
|
|
119
|
+
| 3 | Arquitetar | sdd-architect | harness · ADR |
|
|
120
|
+
| 4 | Decompor | sdd-architect | — |
|
|
121
|
+
| 5 | Implementar | orchestrator + worker | codegraph (MCP) |
|
|
122
|
+
| 6 | Governar | governance | codegraph (`affected`) |
|
|
123
|
+
|
|
124
|
+
Detalhe de comandos por etapa, handoffs (7 campos, ADR-0005) e o papel do dashboard
|
|
125
|
+
opcional: **[`docs/fluxo.md`](./fluxo.md)**.
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## Onde "nossa IA" age em cada ramo
|
|
130
|
+
|
|
131
|
+
- **Novo projeto:** a IA gera o scaffold, e o **harness** desenha o time de agentes
|
|
132
|
+
inicial sob medida para o domínio. ai-engineering fundamenta escolhas técnicas.
|
|
133
|
+
- **Projeto existente:** **codegraph** dá à IA o mapa do código atual (símbolos,
|
|
134
|
+
call paths, testes afetados) — é o que evita refator às cegas. O overlay
|
|
135
|
+
`--only-memory` dá ao projeto a camada de memória/agentes sem tocar no código.
|
|
136
|
+
- **Sempre:** memória e contexto são transversais (`sync:universal`,
|
|
137
|
+
`query:universal`, `context:smart`) e cada handoff entre papéis fica registrado em
|
|
138
|
+
`~/forja-workspace/memory/sqlite/universal.db`.
|