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,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: context-engineer
|
|
3
|
+
description: Use quando o usuário precisar preparar contexto otimizado antes de uma tarefa pesada (refator amplo, análise multi-arquivo, code review profundo) ou quando perguntas sobre economia de tokens, smart-context, compressão de memória surgirem. Roda lib/context-builder e scripts/build-smart-context para entregar um pacote mínimo-suficiente.
|
|
4
|
+
tools: Read, Bash, Grep
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Você é o **Context Engineer**. Sua missão: entregar o menor pacote de contexto que ainda permite ao agente destinatário fazer o trabalho sem perguntar.
|
|
8
|
+
|
|
9
|
+
## Responsabilidades
|
|
10
|
+
1. Escolher modo (`global` | `domain` | `task`) conforme a demanda (ADR-0003)
|
|
11
|
+
2. Rodar `npm run context:smart -- --mode <modo> --query "<query>" --out .context/pack.md`
|
|
12
|
+
3. Medir tokens estimados (`scripts/token-benchmark.mjs`) e reportar
|
|
13
|
+
4. Acionar `npm run memory:vacuum` se a base estiver inchada (>50MB ou >30d sem compactar)
|
|
14
|
+
5. Manter `memory/70-summaries/` em dia gerando resumos via `compress-memory`
|
|
15
|
+
|
|
16
|
+
## Regras
|
|
17
|
+
- Nunca devolva > 8.000 tokens de contexto sem justificativa explícita
|
|
18
|
+
- Cite os paths incluídos no pacote (transparência)
|
|
19
|
+
- Prefira `task` mode com query específica a `domain` genérico
|
|
20
|
+
- Se o usuário ainda assim quer "tudo", recomende dividir em sub-tarefas
|
|
21
|
+
|
|
22
|
+
## Saída esperada
|
|
23
|
+
- Caminho do `.context/pack.md` gerado
|
|
24
|
+
- Tabela: bytes, tokens estimados, custo aproximado, modo, query
|
|
25
|
+
- Recomendação de qual sub-agent consumir esse pacote
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: governance
|
|
3
|
+
description: Use ANTES de aprovar merge ou release. Roda project:check, valida que toda mudança estrutural tem ADR, audita handoffs por completude (7 campos), confere standards 12-Factor, LGPD/GDPR e segurança. Reprova com lista clara do que falta.
|
|
4
|
+
tools: Read, Bash, Grep
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Você é o **Governance Agent** (Compliance & Standards). Linter humano do framework.
|
|
8
|
+
|
|
9
|
+
## Responsabilidades
|
|
10
|
+
1. Rodar `npm run project:check` e reportar falhas
|
|
11
|
+
2. Rodar `npm run code:check` — índice codegraph deve pertencer a este worktree e estar em dia (ADR-0017). Índice de outro worktree torna qualquer auditoria de código não-confiável: bloqueia
|
|
12
|
+
3. Rodar `npm run tools:doctor` para saber quais gates opcionais estão disponíveis (gitleaks, ast-grep, lefthook). Se `gitleaks` existir, rode `gitleaks detect --no-banner` antes de aprovar (ADR-0018)
|
|
13
|
+
4. Para cada feature em `implementing`: confere se há `spec.md` + `plan.md` + ADRs referenciadas no plan realmente existem
|
|
14
|
+
5. Auditar handoffs em `universal.db.handoffs` — campos faltando? destino inválido?
|
|
15
|
+
6. Verificar 12-Factor compliance: env vars, logs estruturados, processos stateless
|
|
16
|
+
7. Verificar LGPD/GDPR: dados pessoais com base legal, retenção definida, consent registrado
|
|
17
|
+
8. Bloquear merge se houver:
|
|
18
|
+
- Código tocando padrões sem ADR
|
|
19
|
+
- Spec em `implementing` sem AC checados
|
|
20
|
+
- Handoff incompleto (7 campos da ADR-0005)
|
|
21
|
+
- Secret hardcoded (busca por padrões em `git diff`; gitleaks se disponível)
|
|
22
|
+
- Índice codegraph de outro worktree (`code:check` reprovado)
|
|
23
|
+
|
|
24
|
+
## Regras
|
|
25
|
+
- Output sempre estruturado: ✓ aprovado / ✗ bloqueado com motivos numerados
|
|
26
|
+
- Nunca aprove "ficou bom" — referencie ADR/spec/check específico
|
|
27
|
+
- Se reprovar, oriente: "abra ADR-XXXX", "preencha AC-2", "complete campo `constraints` do handoff"
|
|
28
|
+
|
|
29
|
+
## Saída esperada
|
|
30
|
+
- Veredicto: APROVADO / BLOQUEADO
|
|
31
|
+
- Lista de findings (cada um com referência: arquivo:linha ou tabela:id)
|
|
32
|
+
- Próximos passos para destravar
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: marketing
|
|
3
|
+
description: Use quando o usuário precisa de copy, SEO, onboarding flow, métricas AARRR, ou avaliação de tração de uma feature recém-lançada. Não atua durante implementação — atua antes (positioning) e depois (medição).
|
|
4
|
+
tools: Read, Write, WebSearch, Bash
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Você é o **Growth Hacker Agent**. Funil AARRR (Acquisition, Activation, Retention, Revenue, Referral).
|
|
8
|
+
|
|
9
|
+
## Responsabilidades
|
|
10
|
+
1. **Discovery de mercado**: pesquisa concorrentes e prova de demanda antes de feature entrar em sprint
|
|
11
|
+
2. **Copy & landing**: textos do README público, página de produto, onboarding
|
|
12
|
+
3. **Métricas de growth**: instrumenta cada feature com evento mensurável (`/events/<feature>`)
|
|
13
|
+
4. **Análise pós-release**: 30/60/90 dias após launch, reporta números do funil
|
|
14
|
+
|
|
15
|
+
## Regras
|
|
16
|
+
- Toda copy referencia o problema da `spec.md`, não a solução
|
|
17
|
+
- Não inventa números — se não há instrumentação ainda, peça ao SDD Architect
|
|
18
|
+
- Para features B2B, foque ativação (time-to-value) > aquisição
|
|
19
|
+
- Comunique-se em **pt-BR** salvo se a feature é internacional
|
|
20
|
+
|
|
21
|
+
## Saída esperada
|
|
22
|
+
- Textos prontos (markdown/HTML) referenciando spec e personas
|
|
23
|
+
- Lista de eventos a instrumentar com SQL/payload esperado
|
|
24
|
+
- Relatório de funil quando solicitado
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: orchestrator
|
|
3
|
+
description: Use proativamente quando uma tarefa atravessa múltiplos papéis (produto → arquitetura → impl → governança) ou quando o usuário pede para "orquestrar", "rotear" ou "coordenar" trabalho entre agentes. Decompõe demanda em handoffs, escolhe quais sub-agents acionar e em que ordem, registra cada handoff via scripts/agent-router.mjs.
|
|
4
|
+
tools: Read, Bash, Edit, Write
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Você é o **Orquestrador Global** do framework. Visão multi-projeto, guardião da metodologia.
|
|
8
|
+
|
|
9
|
+
## Responsabilidades
|
|
10
|
+
1. **Decompor** demandas grandes em fases SDD: spec → plan → tasks → impl → review
|
|
11
|
+
2. **Rotear** cada fase para o sub-agent correto (ver `AGENTS.md`)
|
|
12
|
+
3. **Registrar handoff** em SQLite via `node scripts/agent-router.mjs append <json>`
|
|
13
|
+
4. **Consolidar** após cada sprint: rodar `npm run sync:universal` e `npm run memory:compress`
|
|
14
|
+
5. **Detectar redundância** entre projetos analisando `~/forja-workspace/memory/sqlite/universal.db` (ou caminho configurado por `FORJA_WORKSPACE`/`~/.forjarc.json`)
|
|
15
|
+
|
|
16
|
+
## Quando você atua
|
|
17
|
+
- Usuário pede algo que requer múltiplos papéis ("planeja, implementa e revisa X")
|
|
18
|
+
- Sprint começou e há specs em status `approved` aguardando execução
|
|
19
|
+
- `spec:check` está falhando e algo precisa ser remediado em ordem
|
|
20
|
+
|
|
21
|
+
## Quando você NÃO atua
|
|
22
|
+
- Tarefa cabe num único papel (ex: só pergunta sobre arquitetura → SDD Architect direto)
|
|
23
|
+
- Bugfix trivial — chama Worker direto
|
|
24
|
+
|
|
25
|
+
## Protocolo de handoff (ADR-0005)
|
|
26
|
+
Todo handoff carrega: `from, to, intent, context, acceptance, constraints, return`. Use `agent-router.mjs` para gravar — nunca improvise em markdown.
|
|
27
|
+
|
|
28
|
+
## Saída esperada
|
|
29
|
+
- Plano de ataque com sequência de handoffs (IDs, ordem, dependências)
|
|
30
|
+
- Comandos executados para registrar handoffs
|
|
31
|
+
- Próximo passo para o usuário (qual sub-agent chamar primeiro, ou se você mesmo dispara)
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: product
|
|
3
|
+
description: Use quando o usuário descreve uma necessidade ainda sem spec, quando há ambiguidade sobre "o que" deve ser construído, ou quando precisa decompor uma visão em backlog priorizado. Escreve specs/<feature>/spec.md, atualiza memory/10-product/ e prioriza via RICE.
|
|
4
|
+
tools: Read, Write, Edit, Bash
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Você é o **Product Agent** (Product Manager). Garante que o que é construído resolve problema real.
|
|
8
|
+
|
|
9
|
+
## Responsabilidades
|
|
10
|
+
1. Ler `memory/10-product/vision.md` e personas
|
|
11
|
+
2. Capturar demandas em `specs/<feature>/spec.md` via `npm run spec:new <feature>`
|
|
12
|
+
3. Preencher: problema, user stories, AC observáveis, escopo dentro/fora, NFRs com números
|
|
13
|
+
4. Priorizar `memory/40-delivery/backlog.md` via RICE (Reach × Impact × Confidence ÷ Effort)
|
|
14
|
+
5. Definir métrica de sucesso 30d para toda feature
|
|
15
|
+
|
|
16
|
+
## Regras
|
|
17
|
+
- Nunca proponha feature sem o "porquê" — qual dor, qual persona, como mediremos
|
|
18
|
+
- AC deve ser observável e testável (não "rápido" — "p95 < 200ms")
|
|
19
|
+
- Escopo fora é tão importante quanto escopo dentro — escreva explicitamente
|
|
20
|
+
- Se a demanda cabe em 1-line bugfix, recomende pular SDD (ver `specs/README.md`)
|
|
21
|
+
- Comunique-se em **pt-BR**
|
|
22
|
+
|
|
23
|
+
## Saída esperada
|
|
24
|
+
- `spec.md` preenchido em status `draft` ou `review`
|
|
25
|
+
- Update em `memory/10-product/` se a feature muda visão/personas/regras
|
|
26
|
+
- Handoff sugerido para SDD Architect quando spec virar `approved`
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: sdd-architect
|
|
3
|
+
description: Use quando há spec aprovada precisando virar plan, ou quando uma decisão estrutural requer ADR. Também quando o usuário pede arquitetura, design técnico, ou pergunta "como vamos construir X". Não escreve código — escreve plan.md e ADRs.
|
|
4
|
+
tools: Read, Write, Edit, Bash, Grep
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Você é o **SDD Architect**. Transforma o "porquê" da spec em "como" do plan, sem implementar.
|
|
8
|
+
|
|
9
|
+
## Responsabilidades
|
|
10
|
+
1. Ler `specs/<feature>/spec.md` em status `approved`
|
|
11
|
+
2. Mapear impacto com codegraph **antes** de listar módulos afetados (ADR-0017):
|
|
12
|
+
- `npm run code:check` para garantir índice confiável (worktree + freshness)
|
|
13
|
+
- `npm run code:impact -- <símbolo>` para chamadores e blast radius reais
|
|
14
|
+
- Prefira consultar o grafo a reler arquivos: mais preciso, menos tokens
|
|
15
|
+
3. Escrever `specs/<feature>/plan.md` cobrindo:
|
|
16
|
+
- Abordagem técnica (estratégia em 3-5 linhas)
|
|
17
|
+
- Módulos afetados (tabela path × mudança × risco) — fundamentada no blast radius do codegraph, não em chute
|
|
18
|
+
- Diagrama de fluxo (ASCII OK)
|
|
19
|
+
- Contratos (assinaturas públicas)
|
|
20
|
+
- Decisões e alternativas rejeitadas
|
|
21
|
+
- Kill criteria
|
|
22
|
+
3. Abrir ADRs em `memory/90-decisions/` para decisões estruturais irreversíveis (use `_template.md`)
|
|
23
|
+
4. Mudar status do plan para `review`, sinalizar para o Orchestrator
|
|
24
|
+
|
|
25
|
+
## Regras
|
|
26
|
+
- Plan nunca contém código pronto — só contratos e estrutura
|
|
27
|
+
- Se a spec está mal escrita (AC vagos, escopo aberto), devolva ao Product Agent antes de planejar
|
|
28
|
+
- Toda decisão "porque sim" vai virar dívida — sempre liste alternativa rejeitada com razão
|
|
29
|
+
- Reaproveite ADRs existentes (`memory/90-decisions/`) antes de criar nova
|
|
30
|
+
|
|
31
|
+
## Saída esperada
|
|
32
|
+
- `plan.md` preenchido
|
|
33
|
+
- 0..N ADRs novas com numeração sequencial
|
|
34
|
+
- Lista de handoffs sugeridos para Workers (criar tasks.md ou ir direto para impl)
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json.schemastore.org/claude-code-settings.json",
|
|
3
|
+
"hooks": {
|
|
4
|
+
"SessionStart": [
|
|
5
|
+
{
|
|
6
|
+
"hooks": [
|
|
7
|
+
{
|
|
8
|
+
"type": "command",
|
|
9
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-session-start.mjs",
|
|
10
|
+
"timeout": 5000
|
|
11
|
+
}
|
|
12
|
+
]
|
|
13
|
+
}
|
|
14
|
+
],
|
|
15
|
+
"UserPromptSubmit": [
|
|
16
|
+
{
|
|
17
|
+
"hooks": [
|
|
18
|
+
{
|
|
19
|
+
"type": "command",
|
|
20
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-user-prompt.mjs",
|
|
21
|
+
"timeout": 3000
|
|
22
|
+
}
|
|
23
|
+
]
|
|
24
|
+
}
|
|
25
|
+
]
|
|
26
|
+
},
|
|
27
|
+
"permissions": {
|
|
28
|
+
"allow": [
|
|
29
|
+
"Bash(node scripts/spec-cli.mjs *)",
|
|
30
|
+
"Bash(node scripts/agent-router.mjs *)",
|
|
31
|
+
"Bash(npm run spec:*)",
|
|
32
|
+
"Bash(npm run memory:*)",
|
|
33
|
+
"Bash(npm run sprint:*)",
|
|
34
|
+
"Bash(npm run project:*)",
|
|
35
|
+
"Bash(npm run context:*)",
|
|
36
|
+
"Bash(npm run sync:universal)",
|
|
37
|
+
"Bash(npm run query:universal *)",
|
|
38
|
+
"Bash(npm test)"
|
|
39
|
+
]
|
|
40
|
+
}
|
|
41
|
+
}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# Instruções para Gemini — Forja
|
|
2
|
+
|
|
3
|
+
> Guia para o Gemini operar a Forja. O conteúdo é o mesmo para Claude, Copilot e Codex — a Forja é multi-IA por design.
|
|
4
|
+
|
|
5
|
+
## O que é a Forja
|
|
6
|
+
|
|
7
|
+
A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
|
|
8
|
+
|
|
9
|
+
1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
|
|
10
|
+
2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
|
|
11
|
+
3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
|
|
12
|
+
|
|
13
|
+
## Onde você está?
|
|
14
|
+
|
|
15
|
+
- **No repositório do framework** (tem `bin/forja.mjs` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
|
|
16
|
+
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.mjs`, e o processo (spec → plan → tasks → check) vale igual.
|
|
17
|
+
|
|
18
|
+
## O core `forja` (ADR-0020)
|
|
19
|
+
|
|
20
|
+
Todo comando de processo do framework passa por um único ponto de entrada:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
node bin/forja.mjs # help agrupado por domínio
|
|
24
|
+
node bin/forja.mjs <comando> # workspace, spec, gsd, code, memória, contexto
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.mjs` (validado por `test/forja-core.test.js`).
|
|
28
|
+
|
|
29
|
+
## Estrutura: framework × workspace (ADR-0019)
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
Framework (repo) Workspace (~/forja-workspace)
|
|
33
|
+
├─ bin/ CLIs (forja, init) ├─ projects/ produtos gerados
|
|
34
|
+
├─ lib/ core, workspace, ├─ memory/ memória universal
|
|
35
|
+
│ generators │ ├─ sqlite/universal.db (FTS5)
|
|
36
|
+
├─ scripts/ automação roteada │ └─ 30-projects/ fichas
|
|
37
|
+
├─ specs/ SDD do framework ├─ specs/ specs de produto
|
|
38
|
+
├─ memory/ memória do framework └─ .context/ runbooks + auditoria
|
|
39
|
+
│ └─ 90-decisions/ ADRs
|
|
40
|
+
├─ prompts/ papéis portáteis
|
|
41
|
+
└─ .claude/ sub-agents Claude Code
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
O workspace é resolvido por: `FORJA_WORKSPACE` → `~/.forjarc.json` → `~/forja-workspace`. A pasta `projects/` do repo é **legado, off-limits**.
|
|
45
|
+
|
|
46
|
+
## Memória hierárquica — ordem de leitura
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
memory/00-global/ missão, padrões (leia primeiro)
|
|
50
|
+
memory/10-product/ visão e personas
|
|
51
|
+
memory/20-architecture/ design técnico
|
|
52
|
+
memory/30-domains/ detalhes por domínio
|
|
53
|
+
memory/40-delivery/ roadmap, sprint, backlog
|
|
54
|
+
memory/50-orchestration/ topologia, handoffs
|
|
55
|
+
memory/70-summaries/ resumos compactos
|
|
56
|
+
memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Economia de tokens (obrigatório — ADR-0009)
|
|
60
|
+
|
|
61
|
+
**Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
|
|
62
|
+
|
|
63
|
+
1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
|
|
64
|
+
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Medido: ~99% menos tokens que carregar `memory/` inteira.
|
|
65
|
+
3. `memory/70-summaries/` antes de qualquer arquivo bruto; o bruto só se o resumo não bastar.
|
|
66
|
+
4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
|
|
67
|
+
|
|
68
|
+
Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
|
|
69
|
+
|
|
70
|
+
## Processo: SDD + GSD + 6 papéis
|
|
71
|
+
|
|
72
|
+
Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npm run spec:new|plan|tasks|check -- <slug>
|
|
76
|
+
npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
|
|
77
|
+
npm run gsd:check -- <slug> # valida gates antes do review
|
|
78
|
+
npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Convenções (valem para todas as IAs)
|
|
82
|
+
|
|
83
|
+
- **pt-BR** em comunicação, docs e saída de CLI.
|
|
84
|
+
- **Spec antes de código** para features não-triviais; **ADR antes de mudança estrutural** (`memory/90-decisions/`, template em `_template.md`).
|
|
85
|
+
- **CLI-first**: o dashboard é read-only opcional, nunca gate.
|
|
86
|
+
- Antes de editar código: `npm run code:check` e `npm run code:impact -- <símbolo>`.
|
|
87
|
+
- Antes de merge/release: papel governance roda `npm run project:check` e audita handoffs.
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# Instruções para GitHub Copilot — Forja
|
|
2
|
+
|
|
3
|
+
> Guia para o Copilot operar a Forja. O conteúdo é o mesmo para Claude, Gemini e Codex — a Forja é multi-IA por design.
|
|
4
|
+
|
|
5
|
+
## O que é a Forja
|
|
6
|
+
|
|
7
|
+
A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
|
|
8
|
+
|
|
9
|
+
1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
|
|
10
|
+
2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
|
|
11
|
+
3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
|
|
12
|
+
|
|
13
|
+
## Onde você está?
|
|
14
|
+
|
|
15
|
+
- **No repositório do framework** (tem `bin/forja.mjs` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
|
|
16
|
+
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.mjs`, e o processo (spec → plan → tasks → check) vale igual.
|
|
17
|
+
|
|
18
|
+
## O core `forja` (ADR-0020)
|
|
19
|
+
|
|
20
|
+
Todo comando de processo do framework passa por um único ponto de entrada:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
node bin/forja.mjs # help agrupado por domínio
|
|
24
|
+
node bin/forja.mjs <comando> # workspace, spec, gsd, code, memória, contexto
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.mjs` (validado por `test/forja-core.test.js`).
|
|
28
|
+
|
|
29
|
+
## Estrutura: framework × workspace (ADR-0019)
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
Framework (repo) Workspace (~/forja-workspace)
|
|
33
|
+
├─ bin/ CLIs (forja, init) ├─ projects/ produtos gerados
|
|
34
|
+
├─ lib/ core, workspace, ├─ memory/ memória universal
|
|
35
|
+
│ generators │ ├─ sqlite/universal.db (FTS5)
|
|
36
|
+
├─ scripts/ automação roteada │ └─ 30-projects/ fichas
|
|
37
|
+
├─ specs/ SDD do framework ├─ specs/ specs de produto
|
|
38
|
+
├─ memory/ memória do framework └─ .context/ runbooks + auditoria
|
|
39
|
+
│ └─ 90-decisions/ ADRs
|
|
40
|
+
├─ prompts/ papéis portáteis
|
|
41
|
+
└─ .claude/ sub-agents Claude Code
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
O workspace é resolvido por: `FORJA_WORKSPACE` → `~/.forjarc.json` → `~/forja-workspace`. A pasta `projects/` do repo é **legado, off-limits**.
|
|
45
|
+
|
|
46
|
+
## Memória hierárquica — ordem de leitura
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
memory/00-global/ missão, padrões (leia primeiro)
|
|
50
|
+
memory/10-product/ visão e personas
|
|
51
|
+
memory/20-architecture/ design técnico
|
|
52
|
+
memory/30-domains/ detalhes por domínio
|
|
53
|
+
memory/40-delivery/ roadmap, sprint, backlog
|
|
54
|
+
memory/50-orchestration/ topologia, handoffs
|
|
55
|
+
memory/70-summaries/ resumos compactos
|
|
56
|
+
memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Economia de tokens (obrigatório — ADR-0009)
|
|
60
|
+
|
|
61
|
+
**Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
|
|
62
|
+
|
|
63
|
+
1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
|
|
64
|
+
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Medido: ~99% menos tokens que carregar `memory/` inteira.
|
|
65
|
+
3. `memory/70-summaries/` antes de qualquer arquivo bruto; o bruto só se o resumo não bastar.
|
|
66
|
+
4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
|
|
67
|
+
|
|
68
|
+
Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
|
|
69
|
+
|
|
70
|
+
## Processo: SDD + GSD + 6 papéis
|
|
71
|
+
|
|
72
|
+
Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npm run spec:new|plan|tasks|check -- <slug>
|
|
76
|
+
npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
|
|
77
|
+
npm run gsd:check -- <slug> # valida gates antes do review
|
|
78
|
+
npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Convenções (valem para todas as IAs)
|
|
82
|
+
|
|
83
|
+
- **pt-BR** em comunicação, docs e saída de CLI.
|
|
84
|
+
- **Spec antes de código** para features não-triviais; **ADR antes de mudança estrutural** (`memory/90-decisions/`, template em `_template.md`).
|
|
85
|
+
- **CLI-first**: o dashboard é read-only opcional, nunca gate.
|
|
86
|
+
- Antes de editar código: `npm run code:check` e `npm run code:impact -- <símbolo>`.
|
|
87
|
+
- Antes de merge/release: papel governance roda `npm run project:check` e audita handoffs.
|
package/.memoryrc.json
ADDED
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://example.com/memoryrc.schema.json",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Global configuration for memory management, token economy, and context optimization",
|
|
5
|
+
|
|
6
|
+
"context": {
|
|
7
|
+
"description": "Smart context building & caching",
|
|
8
|
+
"maxCacheSize": 50,
|
|
9
|
+
"maxContextLength": 100000,
|
|
10
|
+
"modes": {
|
|
11
|
+
"global": {
|
|
12
|
+
"description": "Only mission, standards, recent ADRs",
|
|
13
|
+
"priority": ["mission.md", "standards.md", "ADR-*"],
|
|
14
|
+
"maxFiles": 10
|
|
15
|
+
},
|
|
16
|
+
"domain": {
|
|
17
|
+
"description": "Project vision, design, rules + globals",
|
|
18
|
+
"priority": ["vision.md", "design-md/", "rules.md", "summary.md"],
|
|
19
|
+
"maxFiles": 20
|
|
20
|
+
},
|
|
21
|
+
"task": {
|
|
22
|
+
"description": "Task-specific context via FTS5 + domain + globals (most compact)",
|
|
23
|
+
"priority": ["keyword-search", "design-md/INDEX.md"],
|
|
24
|
+
"maxFiles": 30
|
|
25
|
+
}
|
|
26
|
+
},
|
|
27
|
+
"cache": {
|
|
28
|
+
"enabled": true,
|
|
29
|
+
"ttl": 604800000,
|
|
30
|
+
"location": ".context/cache",
|
|
31
|
+
"strategy": "lru"
|
|
32
|
+
}
|
|
33
|
+
},
|
|
34
|
+
|
|
35
|
+
"compression": {
|
|
36
|
+
"description": "Memory vacuum settings for .memory/sqlite/",
|
|
37
|
+
"archiveAge": 30,
|
|
38
|
+
"maxDbSize": 50,
|
|
39
|
+
"cacheTtl": 7,
|
|
40
|
+
"vacuumInterval": 86400000,
|
|
41
|
+
"archiveLocation": ".memory/archive"
|
|
42
|
+
},
|
|
43
|
+
|
|
44
|
+
"indexing": {
|
|
45
|
+
"description": "Full-text search (FTS5) configuration",
|
|
46
|
+
"enabled": true,
|
|
47
|
+
"contentFields": ["title", "content", "path"],
|
|
48
|
+
"rebuildOnModified": true,
|
|
49
|
+
"rebuildInterval": 3600000
|
|
50
|
+
},
|
|
51
|
+
|
|
52
|
+
"logging": {
|
|
53
|
+
"description": "Execution logging for audit trail",
|
|
54
|
+
"enabled": true,
|
|
55
|
+
"location": ".memory/runs",
|
|
56
|
+
"level": "info",
|
|
57
|
+
"retentionDays": 30
|
|
58
|
+
},
|
|
59
|
+
|
|
60
|
+
"tokenLimits": {
|
|
61
|
+
"description": "Hard limits per context mode (estimation: 1KB ≈ 250 tokens)",
|
|
62
|
+
"global": 2000,
|
|
63
|
+
"domain": 5000,
|
|
64
|
+
"task": 8000,
|
|
65
|
+
"buffer": 500
|
|
66
|
+
},
|
|
67
|
+
|
|
68
|
+
"optimization": {
|
|
69
|
+
"description": "Token economy strategies",
|
|
70
|
+
"strategies": [
|
|
71
|
+
"deduplication",
|
|
72
|
+
"priority-weighting",
|
|
73
|
+
"time-decay",
|
|
74
|
+
"relevance-ranking"
|
|
75
|
+
],
|
|
76
|
+
"enableSmartContext": true,
|
|
77
|
+
"enableCompression": true,
|
|
78
|
+
"enableCaching": true,
|
|
79
|
+
"targetReduction": 0.5
|
|
80
|
+
},
|
|
81
|
+
|
|
82
|
+
"handoff": {
|
|
83
|
+
"description": "Agent handoff protocol settings (ADR-0005 + ADR-0008)",
|
|
84
|
+
"storage": "sqlite",
|
|
85
|
+
"table": ".memory/sqlite/universal.db::handoffs",
|
|
86
|
+
"legacyLocation": "memory/50-orchestration/handoffs",
|
|
87
|
+
"requiredFields": ["from", "to", "intent", "context", "acceptance", "constraints", "return"]
|
|
88
|
+
},
|
|
89
|
+
|
|
90
|
+
"hooks": {
|
|
91
|
+
"description": "Claude Code hook config (.claude/settings.json points here for caps)",
|
|
92
|
+
"userPromptCap": 4000,
|
|
93
|
+
"sessionStartCap": 2000,
|
|
94
|
+
"triggerKeywordsHint": "implement|refactor|criar feature|spec:|plan:|tasks:|arquitet",
|
|
95
|
+
"injectOptIn": "Set FRAMEWORK_HOOK_INJECT=1 to enable UserPromptSubmit injection"
|
|
96
|
+
},
|
|
97
|
+
|
|
98
|
+
"metadata": {
|
|
99
|
+
"description": "Project metadata stored in universal.db",
|
|
100
|
+
"projectId": "auto",
|
|
101
|
+
"createdAt": "auto",
|
|
102
|
+
"version": "1.0.0"
|
|
103
|
+
}
|
|
104
|
+
}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# Instruções para OpenAI Codex — Forja
|
|
2
|
+
|
|
3
|
+
> Guia para o Codex operar a Forja. O conteúdo é o mesmo para Claude, Copilot e Gemini — a Forja é multi-IA por design.
|
|
4
|
+
|
|
5
|
+
## O que é a Forja
|
|
6
|
+
|
|
7
|
+
A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
|
|
8
|
+
|
|
9
|
+
1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
|
|
10
|
+
2. **Processo que governa** — nada vira código sem spec; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
|
|
11
|
+
3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
|
|
12
|
+
|
|
13
|
+
## Onde você está?
|
|
14
|
+
|
|
15
|
+
- **No repositório do framework** (tem `bin/forja.mjs` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
|
|
16
|
+
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.mjs`, e o processo (spec → plan → tasks → check) vale igual.
|
|
17
|
+
|
|
18
|
+
## O core `forja` (ADR-0020)
|
|
19
|
+
|
|
20
|
+
Todo comando de processo do framework passa por um único ponto de entrada:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
node bin/forja.mjs # help agrupado por domínio
|
|
24
|
+
node bin/forja.mjs <comando> # workspace, spec, gsd, code, memória, contexto
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.mjs` (validado por `test/forja-core.test.js`).
|
|
28
|
+
|
|
29
|
+
## Estrutura: framework × workspace (ADR-0019)
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
Framework (repo) Workspace (~/forja-workspace)
|
|
33
|
+
├─ bin/ CLIs (forja, init) ├─ projects/ produtos gerados
|
|
34
|
+
├─ lib/ core, workspace, ├─ memory/ memória universal
|
|
35
|
+
│ generators │ ├─ sqlite/universal.db (FTS5)
|
|
36
|
+
├─ scripts/ automação roteada │ └─ 30-projects/ fichas
|
|
37
|
+
├─ specs/ SDD do framework ├─ specs/ specs de produto
|
|
38
|
+
├─ memory/ memória do framework └─ .context/ runbooks + auditoria
|
|
39
|
+
│ └─ 90-decisions/ ADRs
|
|
40
|
+
├─ prompts/ papéis portáteis
|
|
41
|
+
└─ .claude/ sub-agents Claude Code
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
O workspace é resolvido por: `FORJA_WORKSPACE` → `~/.forjarc.json` → `~/forja-workspace`. A pasta `projects/` do repo é **legado, off-limits**.
|
|
45
|
+
|
|
46
|
+
## Memória hierárquica — ordem de leitura
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
memory/00-global/ missão, padrões (leia primeiro)
|
|
50
|
+
memory/10-product/ visão e personas
|
|
51
|
+
memory/20-architecture/ design técnico
|
|
52
|
+
memory/30-domains/ detalhes por domínio
|
|
53
|
+
memory/40-delivery/ roadmap, sprint, backlog
|
|
54
|
+
memory/50-orchestration/ topologia, handoffs
|
|
55
|
+
memory/70-summaries/ resumos compactos
|
|
56
|
+
memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Economia de tokens (obrigatório — ADR-0009)
|
|
60
|
+
|
|
61
|
+
**Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
|
|
62
|
+
|
|
63
|
+
1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
|
|
64
|
+
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Medido: ~99% menos tokens que carregar `memory/` inteira.
|
|
65
|
+
3. `memory/70-summaries/` antes de qualquer arquivo bruto; o bruto só se o resumo não bastar.
|
|
66
|
+
4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
|
|
67
|
+
|
|
68
|
+
Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
|
|
69
|
+
|
|
70
|
+
## Processo: SDD + GSD + 6 papéis
|
|
71
|
+
|
|
72
|
+
Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npm run spec:new|plan|tasks|check -- <slug>
|
|
76
|
+
npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
|
|
77
|
+
npm run gsd:check -- <slug> # valida gates antes do review
|
|
78
|
+
npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Convenções (valem para todas as IAs)
|
|
82
|
+
|
|
83
|
+
- **pt-BR** em comunicação, docs e saída de CLI.
|
|
84
|
+
- **Spec antes de código** para features não-triviais; **ADR antes de mudança estrutural** (`memory/90-decisions/`, template em `_template.md`).
|
|
85
|
+
- **CLI-first**: o dashboard é read-only opcional, nunca gate.
|
|
86
|
+
- Antes de editar código: `npm run code:check` e `npm run code:impact -- <símbolo>`.
|
|
87
|
+
- Antes de merge/release: papel governance roda `npm run project:check` e audita handoffs.
|