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,40 @@
|
|
|
1
|
+
# ADR-0017: Codegraph como gate de primeira classe no harness GSD
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-06-27
|
|
5
|
+
- **Autor(es)**: framework-team
|
|
6
|
+
- **Tags**: orchestration, sdd, gsd, codegraph, code-intelligence
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
O codegraph (grafo de conhecimento SQLite de símbolos/edges, exposto via MCP) já estava instalado e configurado em `.mcp.json`, com scripts `code:index/sync/status/query`. Mas era uma integração **pendurada**: nenhum dos 10 gates do runbook GSD o mencionava, nenhum papel o usava, e o índice apontava para o worktree pai (`2-Projeto-Agents`) em vez de `projects/forja`, retornando símbolos da árvore errada sem erro visível.
|
|
10
|
+
|
|
11
|
+
Resultado prático: o Worker recebia "implemente `tasks.md`" sem nunca consultar o blast radius de um símbolo antes de editar. O `plan.md` listava "módulos afetados" por inspeção manual em vez de pelos chamadores reais. Governança não tinha como saber se o índice era confiável.
|
|
12
|
+
|
|
13
|
+
## Decisão
|
|
14
|
+
Tornar o codegraph um **passo verificável do fluxo GSD**, com degradação graciosa:
|
|
15
|
+
|
|
16
|
+
1. **Comando `code:impact <símbolo>`** em `agent-harness.mjs`: retorna chamadores + arquivos afetados consultando o codegraph. É a ferramenta que o Architect/Worker roda antes de planejar/editar.
|
|
17
|
+
2. **Comando `code:check`**: valida que o índice existe, pertence a este worktree e não está defasado (heurística por mtime + warning de worktree do próprio `codegraph status`).
|
|
18
|
+
3. **Novo gate no runbook GSD**: "Mapa de impacto (codegraph)" entre Contexto e Plano.
|
|
19
|
+
4. **`gsd:check` ganha o gate de freshness**: não-bloqueante se o binário codegraph não existe; bloqueante se o índice pertence a outro worktree.
|
|
20
|
+
|
|
21
|
+
Princípio: nenhum comando novo quebra o fluxo quando codegraph está ausente — avisa e segue. Code intelligence é alavanca, não obstáculo.
|
|
22
|
+
|
|
23
|
+
## Alternativas consideradas
|
|
24
|
+
- **Manter codegraph só como MCP, sem gate** — rejeitada porque uma ferramenta sem gate nem papel que a invoque é ignorada na prática (era o estado atual).
|
|
25
|
+
- **Construir índice de código próprio** — rejeitada: reinventa o codegraph, que já entrega grafo com WAL e watcher.
|
|
26
|
+
- **Bloquear sempre que o índice estiver "defasado"** — rejeitada: gera falso bloqueio; usamos heurística leve (mtime + worktree) em vez de hash por arquivo.
|
|
27
|
+
|
|
28
|
+
## Consequências
|
|
29
|
+
**Positivas**:
|
|
30
|
+
- Architect/Worker editam com blast radius à vista, em menos tokens que reler arquivos
|
|
31
|
+
- Governança ganha sinal objetivo de confiabilidade do índice
|
|
32
|
+
- O grafo deixa de ser decoração e entra no runbook
|
|
33
|
+
|
|
34
|
+
**Negativas / Trade-offs**:
|
|
35
|
+
- Acoplamento leve à CLI do codegraph (mitigado: só `init/status/sync` + MCP, parsing tolerante)
|
|
36
|
+
- Mais um gate no runbook (mitigado: não-bloqueante quando a ferramenta falta)
|
|
37
|
+
|
|
38
|
+
## Rastreamento
|
|
39
|
+
- Implementação: `scripts/agent-harness.mjs`, `package.json`, `specs/harness-codegraph/`
|
|
40
|
+
- ADRs relacionadas: ADR-0003 (smart-context), ADR-0005 (handoff 7 campos), ADR-0018 (ferramentas de processo)
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# ADR-0018: Ferramentas de processo opcionais com detecção via tools:doctor
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-06-27
|
|
5
|
+
- **Autor(es)**: framework-team
|
|
6
|
+
- **Tags**: tooling, governance, dx, security
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
O harness pede `project:check`, `spec:check` e testes — mas todos manuais. Há ganhos práticos de processo parados por falta de mecânica:
|
|
10
|
+
- **Pré-commit** que rode os checks antes do commit (hoje dependem de disciplina humana).
|
|
11
|
+
- **Varredura de segredos** no gate de Governança (o projeto teve fase de hardening de segurança, mas não há scanner).
|
|
12
|
+
- **Busca/codemod estrutural** (codegraph dá relações; falta reescrita por padrão de AST).
|
|
13
|
+
- **Lint de docs**, dado que a documentação é central e enorme.
|
|
14
|
+
|
|
15
|
+
O risco é o oposto: exigir um zoológico de dependências que trava ambientes que não as têm.
|
|
16
|
+
|
|
17
|
+
## Decisão
|
|
18
|
+
Adotar ferramentas de processo como **camada opcional, detectada, nunca imposta**:
|
|
19
|
+
|
|
20
|
+
| Ferramenta | Papel no processo | Como entra |
|
|
21
|
+
|---|---|---|
|
|
22
|
+
| **codegraph** | code intelligence (relações, blast radius) | gate GSD (ADR-0017) |
|
|
23
|
+
| **gitleaks** | varredura de segredos no review | gate opcional de Governance |
|
|
24
|
+
| **ast-grep (`sg`)** | busca/codemod estrutural por AST | ferramenta do Worker para refactor |
|
|
25
|
+
| **lefthook** | pré-commit rodando `project:check`/`spec:check` | hook git opcional |
|
|
26
|
+
| **markdownlint-cli2** | lint da documentação | check opcional |
|
|
27
|
+
|
|
28
|
+
Mecânica: `scripts/tools-doctor.mjs` (`npm run tools:doctor`) detecta cada binário e reporta instalado/ausente + comando de instalação. Governança decide quais gates ativar conforme disponibilidade. Nenhum check novo é bloqueante por padrão quando a ferramenta falta.
|
|
29
|
+
|
|
30
|
+
## Alternativas consideradas
|
|
31
|
+
- **Tornar gitleaks/lefthook dependências obrigatórias** — rejeitada: quebra ambientes mínimos e CI alheios.
|
|
32
|
+
- **Não documentar nada e deixar cada projeto escolher** — rejeitada: perde a padronização que o objetivo pede ("próximos projetos usam esta estrutura").
|
|
33
|
+
- **Embutir as ferramentas como devDependencies npm** — rejeitada para binários nativos (codegraph, gitleaks, ast-grep) que não vivem bem no npm; ficam como detecção + instrução.
|
|
34
|
+
|
|
35
|
+
## Consequências
|
|
36
|
+
**Positivas**:
|
|
37
|
+
- Caminho claro de evolução do processo sem travar quem não tem as ferramentas
|
|
38
|
+
- Governança ganha checklist objetivo do que pode exigir
|
|
39
|
+
- `tools:doctor` vira o "raio-x" de prontidão do ambiente
|
|
40
|
+
|
|
41
|
+
**Negativas / Trade-offs**:
|
|
42
|
+
- Detecção sem imposição significa que o gate pode ser pulado num ambiente sem a ferramenta (aceito: documentado como degradação graciosa)
|
|
43
|
+
|
|
44
|
+
## Rastreamento
|
|
45
|
+
- Implementação: `scripts/tools-doctor.mjs`, `package.json`, `.lefthook.yml` (opcional)
|
|
46
|
+
- ADRs relacionadas: ADR-0017 (codegraph), ADR-0009 (hooks/token economy)
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# ADR-0019: Workspace separado para projetos de produto
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-01
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: workspace, memory, orchestration, cli-first
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
O Forja nasceu como framework e, ao mesmo tempo, gerador de projetos. Os projetos gerados foram colocados em `projects/` dentro do mesmo repositório, gitignored. Com o tempo, isso gerou atrito:
|
|
10
|
+
|
|
11
|
+
- O worktree do framework ficava poluído com dados de produto (códigos, specs, memória).
|
|
12
|
+
- A memória universal (`memory/30-projects/`, `.memory/sqlite/universal.db`) convivia com a memória do framework, dificultando versionar um sem o outro.
|
|
13
|
+
- `init-project.js` tinha lógica ambígua: se o nome não contivesse `/`, colocava em `projects/<nome>`; caso contrário, usava o path fornecido.
|
|
14
|
+
- Não havia um "canto fixo" óbvio para novos projetos, aumentando a chance de perda ou commit acidental.
|
|
15
|
+
|
|
16
|
+
## Decisão
|
|
17
|
+
Separar o **framework Forja** do **workspace de produção**.
|
|
18
|
+
|
|
19
|
+
- O workspace padrão fica em `~/forja-workspace`.
|
|
20
|
+
- Todo projeto novo é criado obrigatoriamente em `~/forja-workspace/projects/<nome>`.
|
|
21
|
+
- A memória universal dos produtos fica em `~/forja-workspace/memory/` (incluindo `sqlite/universal.db` e `30-projects/`).
|
|
22
|
+
- O workspace é configurável via variável de ambiente `FORJA_WORKSPACE` ou arquivo `~/.forjarc.json`; o default é `~/forja-workspace`.
|
|
23
|
+
- A resolução de caminhos é centralizada em `lib/workspace.mjs`.
|
|
24
|
+
|
|
25
|
+
## Alternativas consideradas
|
|
26
|
+
- **Manter `projects/` dentro do repo do framework**: rejeitada porque mantém a poluição do worktree e dificulta versionar/backupear produtos separadamente.
|
|
27
|
+
- **Usar submódulos Git para cada projeto**: rejeitada porque adiciona complexidade de versionamento sem ganho operacional claro.
|
|
28
|
+
- **Workspace como subpasta irmã (`../forja-workspace`)**: rejeitada porque depende da localização do clone do framework; `~/forja-workspace` é previsível em qualquer máquina.
|
|
29
|
+
|
|
30
|
+
## Consequências
|
|
31
|
+
**Positivas**:
|
|
32
|
+
- Repo do framework fica limpo e versionável sem dados de produto.
|
|
33
|
+
- Projetos têm um "canto fixo" previsível.
|
|
34
|
+
- Backup e remoção de produtos ficam independentes do framework.
|
|
35
|
+
- É possível reinstalar ou mover o framework sem tocar nos produtos.
|
|
36
|
+
|
|
37
|
+
**Negativas / Trade-offs**:
|
|
38
|
+
- Usuários precisam saber que o workspace existe fora do repo (documentação e comandos devem deixar isso explícito).
|
|
39
|
+
- Projetos antigos em `projects/` do repo não são migrados automaticamente; migração é manual.
|
|
40
|
+
- Ferramentas que assumiam paths relativos ao repo do framework precisam ser atualizadas.
|
|
41
|
+
|
|
42
|
+
## Rastreamento
|
|
43
|
+
- Implementação: `lib/workspace.mjs`, `bin/init-project.js`, `scripts/*`, `package.json`, `README.md`, `AGENTS.md`, `docs/structure.md`, `docs/init-project.md`.
|
|
44
|
+
- Spec: `specs/reestruturacao-forja-v2/`
|
|
45
|
+
- ADRs relacionadas: ADR-0001, ADR-0003, ADR-0005, ADR-0008, ADR-0017, ADR-0018.
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# ADR-0020: CLI única `forja` como core executivo dos comandos
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-06
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: cli, orchestration, governance, workspace
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
Os comandos do Forja cresceram em três camadas paralelas sem núcleo comum: `scripts/agent-harness.mjs` (workspace/GSD/code), `scripts/dev.mjs` (context/memória, duplicando parte do harness) e ~40 scripts npm apontando direto para scripts soltos — com a chave `project:check` duplicada no `package.json`. Não havia trilha de auditoria unificada, gates eram aplicados de forma desigual e a resolução do workspace (ADR-0019) dependia de cada script lembrar de usá-la. Projetos criados por `project:new` não eram registrados em ficha alguma.
|
|
10
|
+
|
|
11
|
+
O posicionamento do produto ("processo que governa" como pilar) exige que o processo passe, de fato, por um ponto governável.
|
|
12
|
+
|
|
13
|
+
## Decisão
|
|
14
|
+
Criar o **core executivo** do Forja:
|
|
15
|
+
|
|
16
|
+
- `bin/forja.mjs` — dispatcher único; todo comando de processo roda como `forja <comando>`.
|
|
17
|
+
- `lib/core/registry.mjs` — registry declarativo: domínio, descrição, alvo (script ou binário) e gates por comando.
|
|
18
|
+
- **Gates transversais** aplicados pelo core antes do alvo: `workspace` (comandos de produto falham cedo sem workspace, com instrução de correção).
|
|
19
|
+
- **Auditoria append-only**: cada execução gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback `.context/` do repo), com ts, cmd, args, exitCode, durationMs. Falha de auditoria nunca bloqueia o comando.
|
|
20
|
+
- Scripts npm viram aliases finos para `node bin/forja.mjs <cmd>`; `forja` é publicado em `"bin"`.
|
|
21
|
+
- `project:new` passa a registrar ficha automática em `<workspace>/memory/30-projects/<nome>.md`.
|
|
22
|
+
- `agent-harness.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. permanecem como implementação roteada; `dev.mjs` vira alias legado.
|
|
23
|
+
|
|
24
|
+
## Alternativas consideradas
|
|
25
|
+
- **Promover `agent-harness.mjs` a core**: rejeitada porque mistura implementação de gates GSD com roteamento; o registry declarativo separa "o que existe" de "como executa".
|
|
26
|
+
- **Promover `dev.mjs` a core**: rejeitada porque seu registry embute handlers (não é declarativo) e já nasceu duplicando o harness.
|
|
27
|
+
- **Registrar auditoria direto no SQLite universal**: adiada; JSONL em `.context/` é append-only, sem dependência e legível por humanos. Promoção a tabela pode vir depois via `sync:universal`.
|
|
28
|
+
- **Manter scripts npm diretos**: rejeitada porque perpetua a ausência de gates/auditoria — o problema que motivou a decisão.
|
|
29
|
+
|
|
30
|
+
## Consequências
|
|
31
|
+
**Positivas**:
|
|
32
|
+
- Um único ponto de entrada auditável; help agrupado por domínio.
|
|
33
|
+
- Gates de processo aplicados uniformemente (workspace hoje; extensível para spec/governance).
|
|
34
|
+
- Todo projeto nasce registrado no workspace.
|
|
35
|
+
- npm scripts ficam finos e sem duplicatas.
|
|
36
|
+
|
|
37
|
+
**Negativas / Trade-offs**:
|
|
38
|
+
- Um spawn adicional por comando (npm → forja → script), ~dezenas de ms.
|
|
39
|
+
- Registry precisa acompanhar novos scripts (mitigado por teste de integridade).
|
|
40
|
+
- `dev.mjs` convive como caminho legado até ser absorvido.
|
|
41
|
+
|
|
42
|
+
## Rastreamento
|
|
43
|
+
- Implementação: `bin/forja.mjs`, `lib/core/registry.mjs`, `package.json`, `scripts/agent-harness.mjs`, `test/forja-core.test.js`
|
|
44
|
+
- Issues/PRs: SPEC-025 (`specs/forja-core/spec.md`)
|
|
45
|
+
- ADRs relacionadas: ADR-0005, ADR-0017, ADR-0019
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# ADR-XXXX: <título curto>
|
|
2
|
+
|
|
3
|
+
- **Status**: proposed | accepted | superseded by ADR-YYYY | deprecated
|
|
4
|
+
- **Data**: YYYY-MM-DD
|
|
5
|
+
- **Autor(es)**: <nome>
|
|
6
|
+
- **Tags**: <ex: security, memory, sdd, orchestration>
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
<O que motivou esta decisão? Qual o problema? Quais restrições existem?>
|
|
10
|
+
|
|
11
|
+
## Decisão
|
|
12
|
+
<O que foi decidido, no imperativo. Direto ao ponto.>
|
|
13
|
+
|
|
14
|
+
## Alternativas consideradas
|
|
15
|
+
- **Opção A**: <descrição> — rejeitada porque <razão>
|
|
16
|
+
- **Opção B**: <descrição> — rejeitada porque <razão>
|
|
17
|
+
|
|
18
|
+
## Consequências
|
|
19
|
+
**Positivas**:
|
|
20
|
+
- ...
|
|
21
|
+
|
|
22
|
+
**Negativas / Trade-offs**:
|
|
23
|
+
- ...
|
|
24
|
+
|
|
25
|
+
## Rastreamento
|
|
26
|
+
- Implementação: `<paths>`
|
|
27
|
+
- Issues/PRs: `<refs>`
|
|
28
|
+
- ADRs relacionadas: `<refs>`
|
package/package.json
ADDED
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "forjajs",
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "Forja — framework CLI-first de orquestração multiagente, memória hierárquica e geração de projetos com IA",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "index.js",
|
|
7
|
+
"bin": {
|
|
8
|
+
"forja": "bin/forja.mjs",
|
|
9
|
+
"init-project": "bin/init-project.js",
|
|
10
|
+
"create-memory-nest-kit": "bin/create-memory-nest-kit.js"
|
|
11
|
+
},
|
|
12
|
+
"files": [
|
|
13
|
+
"bin/",
|
|
14
|
+
"lib/",
|
|
15
|
+
"scripts/",
|
|
16
|
+
"prompts/",
|
|
17
|
+
"boilerplates/",
|
|
18
|
+
"design-md/",
|
|
19
|
+
"memory/",
|
|
20
|
+
"docs/",
|
|
21
|
+
"specs/",
|
|
22
|
+
".claude/agents/",
|
|
23
|
+
".claude/settings.json",
|
|
24
|
+
".gemini-instructions.md",
|
|
25
|
+
".openai-instructions.md",
|
|
26
|
+
".github/copilot-instructions.md",
|
|
27
|
+
".memoryrc.json",
|
|
28
|
+
"AGENTS.md",
|
|
29
|
+
"DOC-MAP.md",
|
|
30
|
+
"CHANGELOG.md",
|
|
31
|
+
"CONTRIBUTING.md"
|
|
32
|
+
],
|
|
33
|
+
"scripts": {
|
|
34
|
+
"forja": "node bin/forja.mjs",
|
|
35
|
+
"sync:universal": "node bin/forja.mjs sync:universal",
|
|
36
|
+
"query:universal": "node bin/forja.mjs query:universal",
|
|
37
|
+
"dev": "node scripts/dev.mjs",
|
|
38
|
+
"init:project": "node bin/forja.mjs init:project",
|
|
39
|
+
"sprint:start": "node bin/forja.mjs sprint:start",
|
|
40
|
+
"sprint:status": "node bin/forja.mjs sprint:status",
|
|
41
|
+
"sprint:complete": "node bin/forja.mjs sprint:complete",
|
|
42
|
+
"context:smart": "node bin/forja.mjs context:smart",
|
|
43
|
+
"memory:compress": "node bin/forja.mjs memory:compress",
|
|
44
|
+
"memory:vacuum": "node bin/forja.mjs memory:vacuum",
|
|
45
|
+
"memory:schema": "node bin/forja.mjs memory:schema",
|
|
46
|
+
"memory:extract": "node bin/forja.mjs memory:extract",
|
|
47
|
+
"project:check": "node bin/forja.mjs project:check",
|
|
48
|
+
"project:dashboard": "node bin/forja.mjs project:dashboard",
|
|
49
|
+
"context:budget": "node bin/forja.mjs context:budget",
|
|
50
|
+
"context:sprint": "node bin/forja.mjs context:sprint",
|
|
51
|
+
"agent:brief": "node bin/forja.mjs agent:brief",
|
|
52
|
+
"catalog:assets": "node bin/forja.mjs catalog:assets",
|
|
53
|
+
"catalog:manifests": "node bin/forja.mjs catalog:manifests",
|
|
54
|
+
"token:benchmark": "node bin/forja.mjs token:benchmark",
|
|
55
|
+
"spec:new": "node bin/forja.mjs spec:new",
|
|
56
|
+
"spec:plan": "node bin/forja.mjs spec:plan",
|
|
57
|
+
"spec:tasks": "node bin/forja.mjs spec:tasks",
|
|
58
|
+
"spec:check": "node bin/forja.mjs spec:check",
|
|
59
|
+
"agent:route": "node bin/forja.mjs agent:route",
|
|
60
|
+
"workspace:init": "node bin/forja.mjs workspace:init",
|
|
61
|
+
"project:new": "node bin/forja.mjs project:new",
|
|
62
|
+
"project:list": "node bin/forja.mjs project:list",
|
|
63
|
+
"workspace:project:check": "node bin/forja.mjs workspace:project:check",
|
|
64
|
+
"hermes:handoff": "node bin/forja.mjs hermes:handoff",
|
|
65
|
+
"gsd:plan": "node bin/forja.mjs gsd:plan",
|
|
66
|
+
"gsd:handoff": "node bin/forja.mjs gsd:handoff",
|
|
67
|
+
"gsd:check": "node bin/forja.mjs gsd:check",
|
|
68
|
+
"design:check": "node bin/forja.mjs design:check",
|
|
69
|
+
"design:select": "node bin/forja.mjs design:select",
|
|
70
|
+
"ops:plan": "node bin/forja.mjs gsd:plan",
|
|
71
|
+
"ops:handoff": "node bin/forja.mjs gsd:handoff",
|
|
72
|
+
"ops:check": "node bin/forja.mjs gsd:check",
|
|
73
|
+
"ops:sprint": "node bin/forja.mjs sprint:status",
|
|
74
|
+
"dashboard": "cd dashboard && npm start",
|
|
75
|
+
"dashboard:dev": "cd dashboard && npm run dev",
|
|
76
|
+
"dashboard:install": "cd dashboard && npm install && cd web && npm install",
|
|
77
|
+
"dashboard:web:dev": "cd dashboard/web && npm run dev",
|
|
78
|
+
"dashboard:web:build": "cd dashboard/web && npm run build",
|
|
79
|
+
"code:index": "node bin/forja.mjs code:index",
|
|
80
|
+
"code:sync": "node bin/forja.mjs code:sync",
|
|
81
|
+
"code:status": "node bin/forja.mjs code:status",
|
|
82
|
+
"code:query": "node bin/forja.mjs code:query",
|
|
83
|
+
"code:check": "node bin/forja.mjs code:check",
|
|
84
|
+
"code:impact": "node bin/forja.mjs code:impact",
|
|
85
|
+
"tools:doctor": "node bin/forja.mjs tools:doctor",
|
|
86
|
+
"test": "node --test test/*.test.js"
|
|
87
|
+
},
|
|
88
|
+
"keywords": [
|
|
89
|
+
"agents",
|
|
90
|
+
"orchestration",
|
|
91
|
+
"memory",
|
|
92
|
+
"sqlite",
|
|
93
|
+
"sdd"
|
|
94
|
+
],
|
|
95
|
+
"engines": {
|
|
96
|
+
"node": ">=20"
|
|
97
|
+
},
|
|
98
|
+
"repository": {
|
|
99
|
+
"type": "git",
|
|
100
|
+
"url": "git+https://github.com/allanpablo/forja.git"
|
|
101
|
+
},
|
|
102
|
+
"author": "Allan Pablo",
|
|
103
|
+
"license": "MIT",
|
|
104
|
+
"devDependencies": {
|
|
105
|
+
"better-sqlite3": "^12.11.1"
|
|
106
|
+
}
|
|
107
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Prompt: Context Engineer
|
|
2
|
+
|
|
3
|
+
Você entrega o menor pacote de contexto suficiente para a tarefa.
|
|
4
|
+
|
|
5
|
+
## Suas Atividades
|
|
6
|
+
1. Escolher modo (`global` | `domain` | `task`) conforme demanda (ADR-0003).
|
|
7
|
+
2. Rodar `npm run context:smart -- --mode <modo> --query "<query>"`.
|
|
8
|
+
3. Estimar tokens via `scripts/token-benchmark.mjs`.
|
|
9
|
+
4. Acionar `npm run memory:vacuum` quando o DB ultrapassar 50MB ou 30 dias sem compactar.
|
|
10
|
+
5. Manter `memory/70-summaries/` atualizado.
|
|
11
|
+
|
|
12
|
+
## Regras
|
|
13
|
+
- Nunca devolva > 8.000 tokens sem justificativa.
|
|
14
|
+
- Cite os paths incluídos no pacote (transparência).
|
|
15
|
+
- Prefira `task` mode com query específica a `domain` genérico.
|
|
16
|
+
- Comunique-se em **pt-BR**.
|
|
17
|
+
|
|
18
|
+
## Equivalência Claude Code
|
|
19
|
+
`.claude/agents/context-engineer.md`
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Prompt: Agente de Governança (Compliance & Standards)
|
|
2
|
+
|
|
3
|
+
Você é o guardião dos padrões do framework. Sua missão é garantir a integridade, segurança e qualidade do ecossistema.
|
|
4
|
+
|
|
5
|
+
## Suas Atividades
|
|
6
|
+
1. **Auditoria de Padrões**: Execute `npm run project:check` e barre deploys ou tarefas que não sigam os padrões.
|
|
7
|
+
2. **Code intelligence (ADR-0017)**: Rode `npm run code:check`. Índice codegraph de outro worktree ou ausente torna a auditoria de código não-confiável → bloqueie.
|
|
8
|
+
3. **Ferramentas de processo (ADR-0018)**: Rode `npm run tools:doctor`. Se `gitleaks` estiver disponível, varra segredos antes de aprovar.
|
|
9
|
+
4. **Revisão de ADRs**: Garanta que todas as decisões arquiteturais estejam documentadas e sejam coerentes.
|
|
10
|
+
5. **Segurança e LGPD**: Avalie riscos de privacidade e segurança em novas features.
|
|
11
|
+
|
|
12
|
+
## Regras
|
|
13
|
+
- Seja rigoroso com a documentação.
|
|
14
|
+
- Não aceite handoffs incompletos.
|
|
15
|
+
- Comunique-se em **pt-BR**.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Prompt: Agente de Marketing (Growth Hacker)
|
|
2
|
+
|
|
3
|
+
Você é o Growth Hacker do projeto. Sua missão é garantir que o produto tenha tração, retenção e visibilidade.
|
|
4
|
+
|
|
5
|
+
## Suas Atividades
|
|
6
|
+
1. **Estratégia AARRR**: Defina táticas para Aquisição, Ativação, Retenção, Receita e Recomendação.
|
|
7
|
+
2. **SEO & Copy**: Otimize a documentação pública e gere textos persuasivos para o produto.
|
|
8
|
+
3. **Análise de Funil**: Identifique onde os usuários estão "dropando" e sugira melhorias.
|
|
9
|
+
|
|
10
|
+
## Regras
|
|
11
|
+
- Foque em métricas verificáveis.
|
|
12
|
+
- Use gatilhos mentais éticos no copy.
|
|
13
|
+
- Comunique-se em **pt-BR**.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Prompt: Orquestrador Global
|
|
2
|
+
|
|
3
|
+
Você é o Master do framework. Visão multi-projeto, guardião da metodologia SDD.
|
|
4
|
+
|
|
5
|
+
## Suas Atividades
|
|
6
|
+
1. **Decompor** demandas que cruzam múltiplos papéis em sequência de handoffs.
|
|
7
|
+
2. **Rotear** cada handoff via `node scripts/agent-router.mjs append` (com 7 campos da ADR-0005).
|
|
8
|
+
3. **Consolidar memória** ao fim de cada sprint: `npm run sync:universal` e `npm run memory:vacuum`.
|
|
9
|
+
4. **Detectar redundância** entre projetos analisando `~/forja-workspace/memory/sqlite/universal.db` (ou caminho configurado por `FORJA_WORKSPACE`/`~/.forjarc.json`).
|
|
10
|
+
|
|
11
|
+
## Regras
|
|
12
|
+
- Nunca implemente código diretamente — delegue para Worker via handoff.
|
|
13
|
+
- Toda decomposição respeita SDD: spec → plan → tasks → impl → review.
|
|
14
|
+
- Se um único papel cobre a demanda, recomende invocar esse sub-agent diretamente em vez de orquestrar.
|
|
15
|
+
- Comunique-se em **pt-BR**.
|
|
16
|
+
|
|
17
|
+
## Equivalência Claude Code
|
|
18
|
+
`.claude/agents/orchestrator.md`
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Prompt: Agente de Produto (Product Manager)
|
|
2
|
+
|
|
3
|
+
Você é o PM do projeto. Sua missão é garantir que o que está sendo construído resolve um problema real e gera valor.
|
|
4
|
+
|
|
5
|
+
## Suas Atividades
|
|
6
|
+
1. **Análise de Requisitos**: Leia a `vision.md` e decomponha em histórias de usuário e regras de negócio.
|
|
7
|
+
2. **Priorização**: Organize o `backlog.md` usando o framework RICE (Reach, Impact, Confidence, Effort).
|
|
8
|
+
3. **Validação de Valor**: Para cada feature, defina uma métrica de sucesso (KPI).
|
|
9
|
+
|
|
10
|
+
## Regras
|
|
11
|
+
- Nunca sugira uma feature sem explicar o "Porquê".
|
|
12
|
+
- Mantenha o `memory/10-product/` sempre atualizado.
|
|
13
|
+
- Comunique-se em **pt-BR**.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Prompt: SDD Architect
|
|
2
|
+
|
|
3
|
+
Você transforma o "porquê" da spec em "como" do plan. Não escreve código.
|
|
4
|
+
|
|
5
|
+
## Suas Atividades
|
|
6
|
+
1. Ler `specs/<feature>/spec.md` em status `approved`.
|
|
7
|
+
2. Mapear impacto com codegraph antes de planejar (ADR-0017): `npm run code:check` e `npm run code:impact -- <símbolo>` para chamadores/blast radius. Consultar o grafo, não reler arquivos.
|
|
8
|
+
3. Escrever `specs/<feature>/plan.md` com: abordagem, módulos afetados (fundamentados no blast radius), contratos, decisões, kill criteria.
|
|
9
|
+
3. Abrir ADRs em `memory/90-decisions/` para decisões estruturais irreversíveis.
|
|
10
|
+
4. Mudar plan para `review` e sinalizar Orchestrator.
|
|
11
|
+
|
|
12
|
+
## Regras
|
|
13
|
+
- Plan nunca contém código pronto — só contratos.
|
|
14
|
+
- Se a spec está mal escrita, devolva ao Product Agent.
|
|
15
|
+
- Toda decisão precisa de alternativa rejeitada com razão.
|
|
16
|
+
- Reutilize ADRs existentes antes de criar nova.
|
|
17
|
+
- Comunique-se em **pt-BR**.
|
|
18
|
+
|
|
19
|
+
## Equivalência Claude Code
|
|
20
|
+
`.claude/agents/sdd-architect.md`
|