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,844 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Memory Generator - Gera estrutura completa de memória hierárquica
|
|
3
|
+
* Extraído de create-memory-nest-kit.js para modularização
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import path from 'node:path';
|
|
7
|
+
import { writeFileSafe, ensureDir, maybeGitkeep } from '../utils/file-helpers.js';
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Template de arquivos da estrutura de memória
|
|
11
|
+
* Organizado por categorias para facilitar manutenção
|
|
12
|
+
*/
|
|
13
|
+
const memoryTemplates = {
|
|
14
|
+
// === GLOBAL (00-global) ===
|
|
15
|
+
'memory/README.md': `# Memoria do Projeto
|
|
16
|
+
|
|
17
|
+
Esta estrutura foi desenhada para reduzir perda de contexto em projetos grandes.
|
|
18
|
+
|
|
19
|
+
## Principio
|
|
20
|
+
- Nao depender de um unico contexto gigante.
|
|
21
|
+
- Trabalhar com memoria em camadas + handoff incremental.
|
|
22
|
+
- Registrar decisoes, resumos e execucoes para continuidade.
|
|
23
|
+
`,
|
|
24
|
+
|
|
25
|
+
'memory/00-global/mission.md': `# Missao do Projeto
|
|
26
|
+
|
|
27
|
+
Construir software com clareza arquitetural, seguranca by-default e entrega continua.
|
|
28
|
+
|
|
29
|
+
## Principios
|
|
30
|
+
- Simplicidade primeiro
|
|
31
|
+
- Decisoes explicitas em ADR
|
|
32
|
+
- Qualidade e seguranca desde o inicio
|
|
33
|
+
- Documentacao viva
|
|
34
|
+
`,
|
|
35
|
+
|
|
36
|
+
'memory/00-global/standards.md': `# Padroes Globais
|
|
37
|
+
|
|
38
|
+
## Idioma
|
|
39
|
+
- Toda comunicacao e documentacao em **pt-BR**.
|
|
40
|
+
|
|
41
|
+
## Backend
|
|
42
|
+
- API criada em **NestJS** por padrao.
|
|
43
|
+
- Arquitetura modular por dominio.
|
|
44
|
+
|
|
45
|
+
## Qualidade
|
|
46
|
+
- Cada mudanca deve registrar impacto, risco e rollback.
|
|
47
|
+
- Priorizar padroes reutilizaveis.
|
|
48
|
+
`,
|
|
49
|
+
|
|
50
|
+
'memory/00-global/context-policy.md': `# Politica de Contexto Longo
|
|
51
|
+
|
|
52
|
+
## Objetivo
|
|
53
|
+
Permitir trabalho em larga escala sem depender de janela unica gigantesca.
|
|
54
|
+
|
|
55
|
+
## Regras
|
|
56
|
+
- Usar contexto em camadas: global -> dominio -> tarefa -> diff.
|
|
57
|
+
- Antes de cada tarefa: carregar apenas arquivos necessarios.
|
|
58
|
+
- A cada entrega: gerar resumo curto em memory/70-summaries.
|
|
59
|
+
- Em mudancas grandes: registrar handoff em memory/50-orchestration/handoffs.
|
|
60
|
+
|
|
61
|
+
## 🔄 Protocolo de Recuperacao (Engine Switch)
|
|
62
|
+
Se houver esgotamento de cota ou necessidade de mudar de IA:
|
|
63
|
+
1. Localize o arquivo \`.ia-instructions/models.json\`.
|
|
64
|
+
2. Identifique o proximo motor na \`fallback_chain\`.
|
|
65
|
+
3. Carregue as instrucoes do novo motor.
|
|
66
|
+
4. Forneca o conteúdo de \`.context/context-pack.md\` + o ultimo arquivo em \`memory/50-orchestration/handoffs/\`.
|
|
67
|
+
5. O novo motor assumira o trabalho a partir do ponto exato da ultima entrega.
|
|
68
|
+
|
|
69
|
+
## Nota importante
|
|
70
|
+
Esta estrutura **nao aumenta** limite nativo do modelo.
|
|
71
|
+
Ela reduz perda de memoria por segmentacao, resumo e continuidade operacional.
|
|
72
|
+
`,
|
|
73
|
+
|
|
74
|
+
'memory/00-global/agent-contract.md': `# Contrato de Agentes
|
|
75
|
+
|
|
76
|
+
## Orquestrador
|
|
77
|
+
- Decompõe trabalho em subtarefas independentes.
|
|
78
|
+
- Define dono por escopo de arquivo.
|
|
79
|
+
- Consolida handoffs e conflitos.
|
|
80
|
+
|
|
81
|
+
## Workers
|
|
82
|
+
- Implementam subtarefas com escopo claro.
|
|
83
|
+
- Nao alteram areas de outros agentes sem alinhamento.
|
|
84
|
+
- Entregam: alteracoes, riscos, testes e pendencias.
|
|
85
|
+
|
|
86
|
+
## Reviewer
|
|
87
|
+
- Verifica regressao, seguranca e cobertura de testes.
|
|
88
|
+
- Bloqueia merge se encontrar risco critico.
|
|
89
|
+
`,
|
|
90
|
+
|
|
91
|
+
'memory/00-global/context-index.md': `# Indice de Contexto
|
|
92
|
+
|
|
93
|
+
## Ordem de Leitura
|
|
94
|
+
1. memory/00-global/mission.md
|
|
95
|
+
2. memory/00-global/standards.md
|
|
96
|
+
3. memory/00-global/context-policy.md
|
|
97
|
+
4. memory/10-product/*
|
|
98
|
+
5. memory/20-architecture/*
|
|
99
|
+
6. memory/30-domains/<dominio>/*
|
|
100
|
+
7. memory/40-delivery/current-sprint.md
|
|
101
|
+
8. memory/90-decisions/ADR-*.md
|
|
102
|
+
9. memory/70-summaries/*
|
|
103
|
+
`,
|
|
104
|
+
|
|
105
|
+
// === PRODUCT (10-product) ===
|
|
106
|
+
'memory/10-product/vision.md': `# Visao de Produto
|
|
107
|
+
|
|
108
|
+
Descreva objetivo, publico-alvo, problema e proposta de valor.
|
|
109
|
+
`,
|
|
110
|
+
|
|
111
|
+
'memory/10-product/personas.md': `# Personas
|
|
112
|
+
|
|
113
|
+
Liste personas e dores principais.
|
|
114
|
+
`,
|
|
115
|
+
|
|
116
|
+
'memory/10-product/business-rules.md': `# Regras de Negocio
|
|
117
|
+
|
|
118
|
+
Documente regras imutaveis e validacoes criticas.
|
|
119
|
+
`,
|
|
120
|
+
|
|
121
|
+
'memory/10-product/nfrs.md': `# Requisitos Nao Funcionais
|
|
122
|
+
|
|
123
|
+
- Performance
|
|
124
|
+
- Seguranca
|
|
125
|
+
- Observabilidade
|
|
126
|
+
- Escalabilidade
|
|
127
|
+
`,
|
|
128
|
+
|
|
129
|
+
// === ARCHITECTURE (20-architecture) ===
|
|
130
|
+
'memory/20-architecture/system-overview.md': `# Visao Geral da Arquitetura
|
|
131
|
+
|
|
132
|
+
Descreva contexto, fronteiras e integracoes principais.
|
|
133
|
+
`,
|
|
134
|
+
|
|
135
|
+
'memory/20-architecture/frontend.md': `# Frontend
|
|
136
|
+
|
|
137
|
+
Defina padroes de componentizacao, acessibilidade e performance.
|
|
138
|
+
`,
|
|
139
|
+
|
|
140
|
+
'memory/20-architecture/backend.md': `# Backend
|
|
141
|
+
|
|
142
|
+
## Diretriz principal
|
|
143
|
+
- Backend em **NestJS** por padrao.
|
|
144
|
+
|
|
145
|
+
## Estrutura sugerida
|
|
146
|
+
- Modulos por dominio
|
|
147
|
+
- DTO + validacao
|
|
148
|
+
- Servicos com regras de negocio
|
|
149
|
+
- Repositorios/integradores isolados
|
|
150
|
+
`,
|
|
151
|
+
|
|
152
|
+
'memory/20-architecture/data.md': `# Dados
|
|
153
|
+
|
|
154
|
+
Descreva entidades, relacionamentos e politicas de retencao.
|
|
155
|
+
`,
|
|
156
|
+
|
|
157
|
+
'memory/20-architecture/security.md': `# Seguranca
|
|
158
|
+
|
|
159
|
+
- Principio do menor privilegio
|
|
160
|
+
- Segredos fora do codigo
|
|
161
|
+
- Validacao de entrada em todas as rotas
|
|
162
|
+
- Logs sem dados sensiveis
|
|
163
|
+
`,
|
|
164
|
+
|
|
165
|
+
'memory/20-architecture/observability.md': `# Observabilidade
|
|
166
|
+
|
|
167
|
+
- Logs estruturados
|
|
168
|
+
- Metricas e tracing
|
|
169
|
+
- Alertas por SLO
|
|
170
|
+
`,
|
|
171
|
+
|
|
172
|
+
// === DOMAINS (30-domains) ===
|
|
173
|
+
'memory/30-domains/auth/context.md': `# Contexto de Auth
|
|
174
|
+
|
|
175
|
+
Defina escopo funcional de autenticacao/autorizacao.
|
|
176
|
+
`,
|
|
177
|
+
|
|
178
|
+
'memory/30-domains/auth/rules.md': `# Regras de Auth
|
|
179
|
+
|
|
180
|
+
Liste regras e restricoes de seguranca.
|
|
181
|
+
`,
|
|
182
|
+
|
|
183
|
+
'memory/30-domains/auth/api.md': `# API de Auth
|
|
184
|
+
|
|
185
|
+
Documente endpoints, payloads e erros.
|
|
186
|
+
`,
|
|
187
|
+
|
|
188
|
+
'memory/30-domains/billing/context.md': `# Contexto de Billing
|
|
189
|
+
|
|
190
|
+
Defina cobranca, ciclo e integracoes.
|
|
191
|
+
`,
|
|
192
|
+
|
|
193
|
+
'memory/30-domains/billing/rules.md': `# Regras de Billing
|
|
194
|
+
|
|
195
|
+
Descreva calculos, status e excecoes.
|
|
196
|
+
`,
|
|
197
|
+
|
|
198
|
+
'memory/30-domains/billing/api.md': `# API de Billing
|
|
199
|
+
|
|
200
|
+
Documente endpoints e regras de idempotencia.
|
|
201
|
+
`,
|
|
202
|
+
|
|
203
|
+
// === DELIVERY (40-delivery) ===
|
|
204
|
+
'memory/40-delivery/roadmap.md': `# Roadmap
|
|
205
|
+
|
|
206
|
+
Mapeie entregas por trimestre/sprint.
|
|
207
|
+
`,
|
|
208
|
+
|
|
209
|
+
'memory/40-delivery/current-sprint.md': `# Sprint Atual
|
|
210
|
+
|
|
211
|
+
## Objetivos
|
|
212
|
+
-
|
|
213
|
+
|
|
214
|
+
## Itens
|
|
215
|
+
-
|
|
216
|
+
|
|
217
|
+
## Riscos
|
|
218
|
+
-
|
|
219
|
+
`,
|
|
220
|
+
|
|
221
|
+
'memory/40-delivery/backlog.md': `# Backlog
|
|
222
|
+
|
|
223
|
+
Liste itens priorizados com contexto minimo.
|
|
224
|
+
`,
|
|
225
|
+
|
|
226
|
+
// === ORCHESTRATION (50-orchestration) ===
|
|
227
|
+
'memory/50-orchestration/topology.md': `# Topologia Multiagente
|
|
228
|
+
|
|
229
|
+
## Papeis
|
|
230
|
+
- Orquestrador
|
|
231
|
+
- Worker Backend (NestJS)
|
|
232
|
+
- Worker Frontend
|
|
233
|
+
- Worker DBA
|
|
234
|
+
- Worker Security
|
|
235
|
+
- Reviewer
|
|
236
|
+
|
|
237
|
+
## Fluxo
|
|
238
|
+
1. Orquestrador cria plano e fatia trabalho.
|
|
239
|
+
2. Workers executam em paralelo com escopo isolado.
|
|
240
|
+
3. Handoffs sao registrados.
|
|
241
|
+
4. Reviewer valida e aprova.
|
|
242
|
+
`,
|
|
243
|
+
|
|
244
|
+
'memory/50-orchestration/routing.md': `# Roteamento de Tarefas
|
|
245
|
+
|
|
246
|
+
## Regras de roteamento
|
|
247
|
+
- API e dominio server-side -> backend-nest
|
|
248
|
+
- Schema/migracao/query -> dba
|
|
249
|
+
- Auth, hardening, segredos -> security
|
|
250
|
+
- UX/componentes -> frontend
|
|
251
|
+
|
|
252
|
+
## Critico
|
|
253
|
+
Subtarefas devem ter dono unico por arquivo para evitar conflito.
|
|
254
|
+
`,
|
|
255
|
+
|
|
256
|
+
'memory/50-orchestration/handoff-protocol.md': `# Protocolo de Handoff
|
|
257
|
+
|
|
258
|
+
Cada handoff deve conter:
|
|
259
|
+
- contexto minimo
|
|
260
|
+
- alteracoes realizadas
|
|
261
|
+
- arquivos tocados
|
|
262
|
+
- riscos e pontos abertos
|
|
263
|
+
- proximos passos objetivos
|
|
264
|
+
`,
|
|
265
|
+
|
|
266
|
+
'memory/50-orchestration/parallel-playbook.md': `# Playbook de Paralelizacao
|
|
267
|
+
|
|
268
|
+
## Quando paralelizar
|
|
269
|
+
- Subtarefas independentes por dominio.
|
|
270
|
+
- Escopo de escrita sem sobreposicao.
|
|
271
|
+
|
|
272
|
+
## Quando nao paralelizar
|
|
273
|
+
- Mudanca bloqueante para a proxima etapa.
|
|
274
|
+
- Refactor altamente acoplado no mesmo modulo.
|
|
275
|
+
`,
|
|
276
|
+
|
|
277
|
+
'memory/50-orchestration/handoffs/README.md': `# Handoffs
|
|
278
|
+
|
|
279
|
+
Registre cada transicao em arquivos markdown com timestamp.
|
|
280
|
+
Exemplo: 2026-04-18T12-30_worker-backend_para_reviewer.md
|
|
281
|
+
`,
|
|
282
|
+
|
|
283
|
+
// === RUNS (60-runs) ===
|
|
284
|
+
'memory/60-runs/README.md': `# Runs
|
|
285
|
+
|
|
286
|
+
Log de execucao por ciclo/sprint.
|
|
287
|
+
`,
|
|
288
|
+
|
|
289
|
+
// === SUMMARIES (70-summaries) ===
|
|
290
|
+
'memory/70-summaries/global-summary.md': `# Resumo Global
|
|
291
|
+
|
|
292
|
+
Atualize a cada marco importante com:
|
|
293
|
+
- estado atual
|
|
294
|
+
- decisoes novas
|
|
295
|
+
- riscos ativos
|
|
296
|
+
`,
|
|
297
|
+
|
|
298
|
+
'memory/70-summaries/domain-summary.md': `# Resumo por Dominio
|
|
299
|
+
|
|
300
|
+
Mantenha resumos curtos por dominio para carregamento rapido de contexto.
|
|
301
|
+
`,
|
|
302
|
+
|
|
303
|
+
// === DATA (80-data) ===
|
|
304
|
+
'memory/80-data/memory-db.md': `# Memory DB (SQLite)
|
|
305
|
+
|
|
306
|
+
## Objetivo
|
|
307
|
+
Armazenar indice operacional da documentacao para busca e continuidade de contexto.
|
|
308
|
+
|
|
309
|
+
## Fonte da verdade
|
|
310
|
+
- Arquivos Markdown em memory/, docs/, agents/, skills/, prompts/
|
|
311
|
+
|
|
312
|
+
## Banco
|
|
313
|
+
- SQLite em .memory/sqlite/context.db
|
|
314
|
+
|
|
315
|
+
## Fluxo
|
|
316
|
+
1. Atualizar markdown
|
|
317
|
+
2. Rodar sincronizacao
|
|
318
|
+
3. Consultar contexto por texto ou tipo
|
|
319
|
+
`,
|
|
320
|
+
|
|
321
|
+
// === DECISIONS (90-decisions) ===
|
|
322
|
+
'memory/90-decisions/ADR-0001-template.md': `# ADR-0001: Titulo da Decisao
|
|
323
|
+
|
|
324
|
+
## Contexto
|
|
325
|
+
|
|
326
|
+
## Decisao
|
|
327
|
+
|
|
328
|
+
## Consequencias
|
|
329
|
+
|
|
330
|
+
## Alternativas consideradas
|
|
331
|
+
`,
|
|
332
|
+
};
|
|
333
|
+
|
|
334
|
+
/**
|
|
335
|
+
* Gera estrutura de agentes
|
|
336
|
+
*/
|
|
337
|
+
const agentTemplates = {
|
|
338
|
+
'agents/README.md': `# Agents
|
|
339
|
+
|
|
340
|
+
Agentes especializados para dividir trabalho em paralelo.
|
|
341
|
+
`,
|
|
342
|
+
|
|
343
|
+
'agents/orchestrator.md': `# Agent: Orchestrator
|
|
344
|
+
|
|
345
|
+
## Responsabilidade
|
|
346
|
+
Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
|
|
347
|
+
|
|
348
|
+
## Entrega minima
|
|
349
|
+
- plano objetivo
|
|
350
|
+
- distribuicao por agentes
|
|
351
|
+
- consolidacao de handoffs
|
|
352
|
+
`,
|
|
353
|
+
|
|
354
|
+
'agents/backend-nest.md': `# Agent: Backend NestJS
|
|
355
|
+
|
|
356
|
+
## Escopo
|
|
357
|
+
- modulos, controllers, services, dto, guard, pipe
|
|
358
|
+
- testes unitarios e e2e da API
|
|
359
|
+
|
|
360
|
+
## Padrao
|
|
361
|
+
- NestJS por padrao
|
|
362
|
+
- validacao de entrada obrigatoria
|
|
363
|
+
`,
|
|
364
|
+
|
|
365
|
+
'agents/frontend.md': `# Agent: Frontend
|
|
366
|
+
|
|
367
|
+
## Escopo
|
|
368
|
+
- componentes, acessibilidade, performance, UX
|
|
369
|
+
`,
|
|
370
|
+
|
|
371
|
+
'agents/dba.md': `# Agent: DBA
|
|
372
|
+
|
|
373
|
+
## Escopo
|
|
374
|
+
- modelagem, indices, migracoes, tuning de query
|
|
375
|
+
`,
|
|
376
|
+
|
|
377
|
+
'agents/security.md': `# Agent: Security
|
|
378
|
+
|
|
379
|
+
## Escopo
|
|
380
|
+
- threat modeling, hardening, authz/authn, secrets, auditoria
|
|
381
|
+
`,
|
|
382
|
+
|
|
383
|
+
'agents/reviewer.md': `# Agent: Reviewer
|
|
384
|
+
|
|
385
|
+
## Escopo
|
|
386
|
+
- regressao funcional
|
|
387
|
+
- riscos de seguranca
|
|
388
|
+
- cobertura de testes
|
|
389
|
+
`,
|
|
390
|
+
};
|
|
391
|
+
|
|
392
|
+
/**
|
|
393
|
+
* Gera estrutura de skills
|
|
394
|
+
*/
|
|
395
|
+
const skillTemplates = {
|
|
396
|
+
'skills/triage-task/SKILL.md': `# Skill: Triage de Tarefa
|
|
397
|
+
|
|
398
|
+
## Objetivo
|
|
399
|
+
Classificar demanda em: rapido, medio, complexo.
|
|
400
|
+
|
|
401
|
+
## Saida
|
|
402
|
+
- resumo
|
|
403
|
+
- risco
|
|
404
|
+
- owner sugerido
|
|
405
|
+
- fatias de execucao
|
|
406
|
+
`,
|
|
407
|
+
|
|
408
|
+
'skills/context-compaction/SKILL.md': `# Skill: Compactacao de Contexto
|
|
409
|
+
|
|
410
|
+
## Objetivo
|
|
411
|
+
Gerar resumo operacional sem perder decisoes chave.
|
|
412
|
+
|
|
413
|
+
## Regras
|
|
414
|
+
- manter fatos verificaveis
|
|
415
|
+
- remover redundancia
|
|
416
|
+
- preservar links para fontes internas
|
|
417
|
+
`,
|
|
418
|
+
|
|
419
|
+
'skills/handoff/SKILL.md': `# Skill: Handoff
|
|
420
|
+
|
|
421
|
+
## Template
|
|
422
|
+
- contexto
|
|
423
|
+
- alteracoes
|
|
424
|
+
- riscos
|
|
425
|
+
- pendencias
|
|
426
|
+
- proximo agente
|
|
427
|
+
`,
|
|
428
|
+
|
|
429
|
+
'skills/nest-api/SKILL.md': `# Skill: Nest API
|
|
430
|
+
|
|
431
|
+
## Checklist
|
|
432
|
+
- modulo criado
|
|
433
|
+
- dto com validacao
|
|
434
|
+
- controller + service
|
|
435
|
+
- testes
|
|
436
|
+
`,
|
|
437
|
+
|
|
438
|
+
'skills/self-healing/SKILL.md': `# Skill: Auto-Diagnóstico (Self-Healing)
|
|
439
|
+
|
|
440
|
+
## Objetivo
|
|
441
|
+
Resolver falhas de build, testes ou tipos sem intervenção humana.
|
|
442
|
+
|
|
443
|
+
## Fluxo
|
|
444
|
+
1. Analisar a stack trace completa do erro.
|
|
445
|
+
2. Identificar se é: erro de sintaxe, falta de dependência, erro de tipo ou lógica.
|
|
446
|
+
3. Consultar documentação interna ou padrões do projeto.
|
|
447
|
+
4. Propor correção mínima e rodar validação novamente.
|
|
448
|
+
`,
|
|
449
|
+
|
|
450
|
+
'skills/validate-handoff/SKILL.md': `# Skill: Validação e Review de Segurança (Gatekeeper)
|
|
451
|
+
|
|
452
|
+
## Objetivo
|
|
453
|
+
Atuar como Gatekeeper final para garantir que nenhum código inseguro ou incompleto entre no pipeline.
|
|
454
|
+
|
|
455
|
+
## Protocolo de Review (Obrigatório)
|
|
456
|
+
Antes de aceitar um handoff, o Reviewer deve validar:
|
|
457
|
+
|
|
458
|
+
1. **Compliance de Raciocínio**: O Worker preencheu o bloco \`## Raciocínio Estruturado\`? (Se não, rejeite imediatamente).
|
|
459
|
+
2. **Scan de Segurança**:
|
|
460
|
+
- Há logs sensíveis (PII, tokens) sendo impressos?
|
|
461
|
+
- As validações de input estão no DTO?
|
|
462
|
+
3. **Verificação de Handoff**:
|
|
463
|
+
- Os arquivos listados no handoff condizem com o diff real?
|
|
464
|
+
- Existem pendências (riscos) não documentadas?
|
|
465
|
+
|
|
466
|
+
## Saída do Reviewer
|
|
467
|
+
- [ ] Aprovado (Status: \`done\` no DB)
|
|
468
|
+
- [ ] Rejeitado (Status: \`blocked\` + pendências listadas)
|
|
469
|
+
`,
|
|
470
|
+
|
|
471
|
+
'skills/ui-fidelity/SKILL.md': `# Skill: Fidelidade Visual
|
|
472
|
+
|
|
473
|
+
## Objetivo
|
|
474
|
+
Garantir que a UI segue padrões de elite.
|
|
475
|
+
|
|
476
|
+
## Instrução
|
|
477
|
+
1. Consultar a biblioteca \`design-md/\` para inspiração de marca/padrão.
|
|
478
|
+
2. Comparar o código gerado com os padrões de espaçamento, tipografia e cores da referência.
|
|
479
|
+
3. Ajustar CSS/Componentes para atingir qualidade visual de nível mundial.
|
|
480
|
+
`,
|
|
481
|
+
|
|
482
|
+
'skills/reasoning-protocol/SKILL.md': `# Skill: Raciocínio Estruturado (Chain-of-Thought)
|
|
483
|
+
|
|
484
|
+
## Objetivo
|
|
485
|
+
Reduzir erros de implementação através de análise lógica explícita.
|
|
486
|
+
|
|
487
|
+
## Protocolo Obrigatório
|
|
488
|
+
Antes de qualquer código ou plano de ação, preencha o bloco \`## Raciocínio Estruturado\`:
|
|
489
|
+
|
|
490
|
+
1. **Entendimento**: O que foi pedido e qual o impacto no sistema?
|
|
491
|
+
2. **Restrições**: Quais arquivos NÃO posso tocar? Quais padrões devo seguir?
|
|
492
|
+
3. **Alternativas**: Existe mais de uma forma de fazer? Por que escolhi esta?
|
|
493
|
+
4. **Plano de Ataque**: Passo-a-passo lógico da implementação.
|
|
494
|
+
`,
|
|
495
|
+
|
|
496
|
+
'skills/llm-provider-routing/SKILL.md': `# Skill: Roteamento de LLM Providers
|
|
497
|
+
|
|
498
|
+
## Objetivo
|
|
499
|
+
Selecionar e configurar uma LLM por papel sem amarrar o projeto a um unico fornecedor.
|
|
500
|
+
|
|
501
|
+
## Quando usar
|
|
502
|
+
- O usuario pedir DeepSeek, MiniMax, Mistral, Qwen, Ollama, OpenRouter, Together, Groq, xAI, Cohere, Perplexity ou outro provider.
|
|
503
|
+
- Um papel precisar trocar de modelo por custo, cota, latencia, contexto, privacidade ou qualidade.
|
|
504
|
+
- Uma CLI/API externa precisar entrar no fluxo de handoffs sem alterar o SDD.
|
|
505
|
+
|
|
506
|
+
## Regras
|
|
507
|
+
- Preferir providers locais para tarefas sensiveis quando o modelo disponivel for suficiente.
|
|
508
|
+
- Usar \`manual\` quando o provider nao tiver CLI local confiavel.
|
|
509
|
+
- Registrar \`provider\`, \`model\`, \`command\`, \`taskTypes\` e \`notes\` em \`.memory/agent-llm-routing.json\`.
|
|
510
|
+
- Nao assumir que uma CLI existe: validar o binario ou documentar o comando esperado.
|
|
511
|
+
- Nao colocar API keys em memoria, specs, handoffs ou logs.
|
|
512
|
+
|
|
513
|
+
## Checklist
|
|
514
|
+
1. Identificar papel e tipo de tarefa.
|
|
515
|
+
2. Escolher provider e modelo no dashboard ou via API \`/api/llm-routing/:role\`.
|
|
516
|
+
3. Preencher \`command\` com a CLI real ou wrapper local.
|
|
517
|
+
4. Rodar um teste pequeno antes de delegar sprint inteira.
|
|
518
|
+
5. Registrar handoff Hermes quando a troca impactar entrega.
|
|
519
|
+
`,
|
|
520
|
+
|
|
521
|
+
'skills/MANIFEST.json': `{
|
|
522
|
+
"version": "0.5.0",
|
|
523
|
+
"skills": [
|
|
524
|
+
{ "id": "triage", "path": "skills/triage-task/SKILL.md", "description": "Classificação de tarefas" },
|
|
525
|
+
{ "id": "compaction", "path": "skills/context-compaction/SKILL.md", "description": "Compactação de memória" },
|
|
526
|
+
{ "id": "handoff", "path": "skills/handoff/SKILL.md", "description": "Protocolo de transição" },
|
|
527
|
+
{ "id": "nest-api", "path": "skills/nest-api/SKILL.md", "description": "Geração de endpoints NestJS" },
|
|
528
|
+
{ "id": "self-healing", "path": "skills/self-healing/SKILL.md", "description": "Resolução autônoma de erros" },
|
|
529
|
+
{ "id": "validate-handoff", "path": "skills/validate-handoff/SKILL.md", "description": "Checklist de qualidade de handoff" },
|
|
530
|
+
{ "id": "ui-fidelity", "path": "skills/ui-fidelity/SKILL.md", "description": "Auditoria estética de UI" },
|
|
531
|
+
{ "id": "reasoning", "path": "skills/reasoning-protocol/SKILL.md", "description": "Protocolo de raciocínio lógico" },
|
|
532
|
+
{ "id": "llm-provider-routing", "path": "skills/llm-provider-routing/SKILL.md", "description": "Roteamento multi-LLM por papel" }
|
|
533
|
+
]
|
|
534
|
+
}
|
|
535
|
+
`,
|
|
536
|
+
};
|
|
537
|
+
|
|
538
|
+
/**
|
|
539
|
+
* Gera estrutura de prompts
|
|
540
|
+
*/
|
|
541
|
+
const promptTemplates = {
|
|
542
|
+
'prompts/project-prompt-base.md': `# Prompt Base do Projeto
|
|
543
|
+
|
|
544
|
+
Voce e um agente de engenharia sênior neste repositorio.
|
|
545
|
+
|
|
546
|
+
Prioridade de contexto:
|
|
547
|
+
1. memory/00-global/mission.md
|
|
548
|
+
2. memory/00-global/standards.md
|
|
549
|
+
3. memory/00-global/context-policy.md
|
|
550
|
+
4. memory/10-product/*
|
|
551
|
+
5. memory/20-architecture/*
|
|
552
|
+
6. memory/30-domains/<dominio>/*
|
|
553
|
+
7. memory/40-delivery/current-sprint.md
|
|
554
|
+
8. memory/90-decisions/ADR-*.md
|
|
555
|
+
9. memory/70-summaries/*
|
|
556
|
+
|
|
557
|
+
Regras:
|
|
558
|
+
- comunicacao em pt-BR
|
|
559
|
+
- API em NestJS por padrao
|
|
560
|
+
- nao contradizer ADR sem sinalizar
|
|
561
|
+
- explicitar suposicoes
|
|
562
|
+
- **OBRIGATÓRIO**: Usar a skill \`reasoning\` e preencher o bloco \`## Raciocínio Estruturado\` antes de cada resposta técnica.
|
|
563
|
+
- entregar: raciocínio, entendimento, plano, implementacao, validacao e proximos passos
|
|
564
|
+
`,
|
|
565
|
+
|
|
566
|
+
'prompts/multi-agent-orchestrator.md': `# Prompt Orquestrador Multiagente
|
|
567
|
+
|
|
568
|
+
Atue como orquestrador. Divida o trabalho em subtarefas independentes, com ownership por arquivo.
|
|
569
|
+
|
|
570
|
+
Para cada subtarefa, entregue:
|
|
571
|
+
- objetivo
|
|
572
|
+
- escopo de escrita
|
|
573
|
+
- criterio de pronto
|
|
574
|
+
- risco principal
|
|
575
|
+
- agente dono
|
|
576
|
+
|
|
577
|
+
No final, consolide os handoffs em ordem cronologica.
|
|
578
|
+
`,
|
|
579
|
+
|
|
580
|
+
'prompts/worker-task-template.md': `# Prompt Worker
|
|
581
|
+
|
|
582
|
+
Voce recebeu uma subtarefa.
|
|
583
|
+
|
|
584
|
+
Responda com:
|
|
585
|
+
1. **Raciocínio Estruturado** (Uso obrigatório da skill \`reasoning\`)
|
|
586
|
+
2. Entendimento
|
|
587
|
+
3. Implementacao realizada
|
|
588
|
+
4. Arquivos alterados
|
|
589
|
+
5. Validacao/testes
|
|
590
|
+
6. Riscos e pendencias
|
|
591
|
+
`,
|
|
592
|
+
};
|
|
593
|
+
|
|
594
|
+
/**
|
|
595
|
+
* Gera arquivos de configuração globais
|
|
596
|
+
*/
|
|
597
|
+
const configTemplates = {
|
|
598
|
+
'AGENTS.md': `# AGENTS
|
|
599
|
+
|
|
600
|
+
## Linguagem
|
|
601
|
+
- Sempre responder e documentar em **pt-BR**.
|
|
602
|
+
|
|
603
|
+
## Stack
|
|
604
|
+
- API padrao do projeto: **NestJS**.
|
|
605
|
+
|
|
606
|
+
## Modo multiagente
|
|
607
|
+
- Orquestrador decompõe tarefas
|
|
608
|
+
- Workers executam em paralelo por ownership
|
|
609
|
+
- Reviewer valida riscos
|
|
610
|
+
|
|
611
|
+
## Memoria
|
|
612
|
+
- Seguir hierarchy em /memory
|
|
613
|
+
- Registrar handoff e resumo ao fim de cada entrega relevante
|
|
614
|
+
`,
|
|
615
|
+
|
|
616
|
+
'.memoryrc.json': `{
|
|
617
|
+
"strategy": "hierarchical",
|
|
618
|
+
"maxContextHint": "1M+ por segmentacao e resumo incremental",
|
|
619
|
+
"handoffDir": "memory/50-orchestration/handoffs",
|
|
620
|
+
"summaryDir": "memory/70-summaries",
|
|
621
|
+
"sqlitePath": ".memory/sqlite/context.db",
|
|
622
|
+
"language": "pt-BR",
|
|
623
|
+
"backendDefault": "nestjs"
|
|
624
|
+
}
|
|
625
|
+
`,
|
|
626
|
+
|
|
627
|
+
'.gitignore': `node_modules
|
|
628
|
+
dist
|
|
629
|
+
.env
|
|
630
|
+
.DS_Store
|
|
631
|
+
coverage
|
|
632
|
+
.context
|
|
633
|
+
`,
|
|
634
|
+
};
|
|
635
|
+
|
|
636
|
+
/**
|
|
637
|
+
* Gera scripts utilitários
|
|
638
|
+
*/
|
|
639
|
+
const scriptTemplates = {
|
|
640
|
+
'scripts/build-context-pack.mjs': `import fs from 'node:fs';
|
|
641
|
+
import path from 'node:path';
|
|
642
|
+
import { fileURLToPath } from 'node:url';
|
|
643
|
+
|
|
644
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
645
|
+
const __dirname = path.dirname(__filename);
|
|
646
|
+
const root = path.resolve(__dirname, '..');
|
|
647
|
+
const outputDir = path.join(root, '.context');
|
|
648
|
+
const outFile = path.join(outputDir, 'context-pack.md');
|
|
649
|
+
|
|
650
|
+
const priorityFiles = [
|
|
651
|
+
'memory/00-global/mission.md',
|
|
652
|
+
'memory/00-global/standards.md',
|
|
653
|
+
'memory/00-global/context-policy.md',
|
|
654
|
+
'memory/20-architecture/backend.md',
|
|
655
|
+
'memory/40-delivery/current-sprint.md',
|
|
656
|
+
'memory/70-summaries/global-summary.md'
|
|
657
|
+
];
|
|
658
|
+
|
|
659
|
+
fs.mkdirSync(outputDir, { recursive: true });
|
|
660
|
+
let content = '# Context Pack\\n\\n';
|
|
661
|
+
|
|
662
|
+
for (const rel of priorityFiles) {
|
|
663
|
+
const abs = path.join(root, rel);
|
|
664
|
+
if (!fs.existsSync(abs)) continue;
|
|
665
|
+
const raw = fs.readFileSync(abs, 'utf8').slice(0, 6000);
|
|
666
|
+
content += '## ' + rel + '\\n\\n' + raw + '\\n\\n';
|
|
667
|
+
}
|
|
668
|
+
|
|
669
|
+
fs.writeFileSync(outFile, content, 'utf8');
|
|
670
|
+
console.log('Context pack gerado em: ' + outFile);
|
|
671
|
+
`,
|
|
672
|
+
|
|
673
|
+
'scripts/append-handoff.mjs': `import fs from 'node:fs';
|
|
674
|
+
import path from 'node:path';
|
|
675
|
+
import { fileURLToPath } from 'node:url';
|
|
676
|
+
|
|
677
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
678
|
+
const __dirname = path.dirname(__filename);
|
|
679
|
+
const root = path.resolve(__dirname, '..');
|
|
680
|
+
|
|
681
|
+
const [from = 'agente-a', to = 'agente-b', title = 'handoff'] = process.argv.slice(2);
|
|
682
|
+
const dir = path.join(root, 'memory/50-orchestration/handoffs');
|
|
683
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
684
|
+
|
|
685
|
+
const stamp = new Date().toISOString().replace(/[:]/g, '-');
|
|
686
|
+
const file = path.join(dir, stamp + '_' + from + '_para_' + to + '.md');
|
|
687
|
+
|
|
688
|
+
const template = '# Handoff: ' + from + ' -> ' + to + '\\n\\n'
|
|
689
|
+
+ '## Titulo\\n' + title + '\\n\\n'
|
|
690
|
+
+ '## Contexto\\n-\\n\\n'
|
|
691
|
+
+ '## Alteracoes\\n-\\n\\n'
|
|
692
|
+
+ '## Riscos\\n-\\n\\n'
|
|
693
|
+
+ '## Pendencias\\n-\\n\\n'
|
|
694
|
+
+ '## Proximo passo\\n-\\n';
|
|
695
|
+
|
|
696
|
+
fs.writeFileSync(file, template, 'utf8');
|
|
697
|
+
console.log('Handoff criado: ' + file);
|
|
698
|
+
`,
|
|
699
|
+
|
|
700
|
+
'scripts/lib/skill-loader.mjs': `import fs from 'node:fs';
|
|
701
|
+
import path from 'node:path';
|
|
702
|
+
import { fileURLToPath } from 'node:url';
|
|
703
|
+
|
|
704
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
705
|
+
const __dirname = path.dirname(__filename);
|
|
706
|
+
const root = path.resolve(__dirname, '..', '..');
|
|
707
|
+
|
|
708
|
+
export function loadSkills() {
|
|
709
|
+
const manifestPath = path.join(root, 'skills', 'MANIFEST.json');
|
|
710
|
+
if (!fs.existsSync(manifestPath)) return [];
|
|
711
|
+
const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
|
|
712
|
+
return manifest.skills;
|
|
713
|
+
}
|
|
714
|
+
|
|
715
|
+
export function getSkill(id) {
|
|
716
|
+
const skills = loadSkills();
|
|
717
|
+
return skills.find(s => s.id === id);
|
|
718
|
+
}
|
|
719
|
+
`,
|
|
720
|
+
|
|
721
|
+
'scripts/memory-vacuum.mjs': `import fs from 'node:fs';
|
|
722
|
+
import path from 'node:path';
|
|
723
|
+
import { fileURLToPath } from 'node:url';
|
|
724
|
+
|
|
725
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
726
|
+
const __dirname = path.dirname(__filename);
|
|
727
|
+
const root = path.resolve(__dirname, '..');
|
|
728
|
+
const runsDir = path.join(root, 'memory/60-runs');
|
|
729
|
+
const archiveDir = path.join(runsDir, 'archive');
|
|
730
|
+
|
|
731
|
+
const TTL_DAYS = 30;
|
|
732
|
+
const now = Date.now();
|
|
733
|
+
|
|
734
|
+
if (!fs.existsSync(runsDir)) process.exit(0);
|
|
735
|
+
if (!fs.existsSync(archiveDir)) fs.mkdirSync(archiveDir, { recursive: true });
|
|
736
|
+
|
|
737
|
+
const entries = fs.readdirSync(runsDir, { withFileTypes: true });
|
|
738
|
+
|
|
739
|
+
let archived = 0;
|
|
740
|
+
for (const entry of entries) {
|
|
741
|
+
if (entry.name === 'README.md' || entry.name === 'archive' || entry.name === '.gitkeep') continue;
|
|
742
|
+
|
|
743
|
+
const abs = path.join(runsDir, entry.name);
|
|
744
|
+
const stats = fs.statSync(abs);
|
|
745
|
+
const ageDays = (now - stats.mtimeMs) / (1000 * 60 * 60 * 24);
|
|
746
|
+
|
|
747
|
+
if (ageDays > TTL_DAYS) {
|
|
748
|
+
const dest = path.join(archiveDir, entry.name);
|
|
749
|
+
fs.renameSync(abs, dest);
|
|
750
|
+
archived++;
|
|
751
|
+
}
|
|
752
|
+
}
|
|
753
|
+
|
|
754
|
+
if (archived > 0) {
|
|
755
|
+
console.log('Vacuum: ' + archived + ' runs movidas para archive/');
|
|
756
|
+
}
|
|
757
|
+
`,
|
|
758
|
+
|
|
759
|
+
'scripts/memory-watcher.mjs': `import { watch } from 'node:fs';
|
|
760
|
+
import { exec } from 'node:child_process';
|
|
761
|
+
import path from 'node:path';
|
|
762
|
+
import { fileURLToPath } from 'node:url';
|
|
763
|
+
|
|
764
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
765
|
+
const __dirname = path.dirname(__filename);
|
|
766
|
+
const root = path.resolve(__dirname, '..');
|
|
767
|
+
|
|
768
|
+
const watchDirs = ['memory', 'agents', 'skills', 'prompts', 'docs'];
|
|
769
|
+
let timeout = null;
|
|
770
|
+
|
|
771
|
+
console.log('👀 Memory Watcher iniciado...');
|
|
772
|
+
|
|
773
|
+
watchDirs.forEach(dir => {
|
|
774
|
+
const absDir = path.join(root, dir);
|
|
775
|
+
watch(absDir, { recursive: true }, (eventType, filename) => {
|
|
776
|
+
if (filename && filename.endsWith('.md')) {
|
|
777
|
+
if (timeout) clearTimeout(timeout);
|
|
778
|
+
timeout = setTimeout(() => {
|
|
779
|
+
console.log('🔄 Mudança detectada em: ' + filename + '. Sincronizando SQLite...');
|
|
780
|
+
exec('npm run memory:db:sync', { cwd: path.join(root, 'backend') }, (err, stdout) => {
|
|
781
|
+
if (err) console.error('❌ Erro no sync: ' + err.message);
|
|
782
|
+
else console.log('✅ SQLite sincronizado.');
|
|
783
|
+
});
|
|
784
|
+
}, 1000);
|
|
785
|
+
}
|
|
786
|
+
});
|
|
787
|
+
});
|
|
788
|
+
`,
|
|
789
|
+
};
|
|
790
|
+
|
|
791
|
+
/**
|
|
792
|
+
* Retorna todos os templates combinados
|
|
793
|
+
*/
|
|
794
|
+
export function getAllMemoryTemplates() {
|
|
795
|
+
return {
|
|
796
|
+
...memoryTemplates,
|
|
797
|
+
...agentTemplates,
|
|
798
|
+
...skillTemplates,
|
|
799
|
+
...promptTemplates,
|
|
800
|
+
...configTemplates,
|
|
801
|
+
...scriptTemplates,
|
|
802
|
+
};
|
|
803
|
+
}
|
|
804
|
+
|
|
805
|
+
/**
|
|
806
|
+
* Escreve a estrutura completa de memória
|
|
807
|
+
* @param {string} baseDir - Diretório base para geração
|
|
808
|
+
* @param {Object} options - Opções (force, noGitkeep)
|
|
809
|
+
*/
|
|
810
|
+
export function generateMemoryStructure(baseDir, options = {}) {
|
|
811
|
+
const allTemplates = getAllMemoryTemplates();
|
|
812
|
+
|
|
813
|
+
// Escrever todos os arquivos
|
|
814
|
+
for (const [relativePath, content] of Object.entries(allTemplates)) {
|
|
815
|
+
writeFileSafe(path.join(baseDir, relativePath), content, options);
|
|
816
|
+
}
|
|
817
|
+
|
|
818
|
+
// Criar diretórios vazios
|
|
819
|
+
const emptyDirs = [
|
|
820
|
+
'memory/30-domains/shared',
|
|
821
|
+
'memory/90-decisions/archive',
|
|
822
|
+
'docs',
|
|
823
|
+
'scripts/lib',
|
|
824
|
+
'.memory/sqlite',
|
|
825
|
+
'.context',
|
|
826
|
+
];
|
|
827
|
+
|
|
828
|
+
for (const relDir of emptyDirs) {
|
|
829
|
+
const abs = path.join(baseDir, relDir);
|
|
830
|
+
ensureDir(abs);
|
|
831
|
+
maybeGitkeep(abs, options);
|
|
832
|
+
}
|
|
833
|
+
|
|
834
|
+
return {
|
|
835
|
+
success: true,
|
|
836
|
+
filesWritten: Object.keys(allTemplates).length,
|
|
837
|
+
emptyDirsCreated: emptyDirs.length,
|
|
838
|
+
};
|
|
839
|
+
}
|
|
840
|
+
|
|
841
|
+
export default {
|
|
842
|
+
generateMemoryStructure,
|
|
843
|
+
getAllMemoryTemplates,
|
|
844
|
+
};
|