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
package/AGENTS.md
ADDED
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
# AGENTS — Topologia do framework
|
|
2
|
+
|
|
3
|
+
## Modo operacional
|
|
4
|
+
|
|
5
|
+
Este projeto e **CLI-first**. Use comandos para operar sprints, SDD, GSD, contexto e handoffs. Dashboard/web e recursos visuais sao opcionais e nao devem bloquear operacao, governanca ou entrega quando a tarefa nao tiver impacto visual.
|
|
6
|
+
|
|
7
|
+
Todo comando de processo passa pelo **core** `bin/forja.mjs` (ADR-0020): registry declarativo em `lib/core/registry.mjs`, gates transversais (workspace) e auditoria de cada execucao em `<workspace>/.context/forja-runs.jsonl` — e essa trilha que Governance usa no review. Os scripts npm abaixo sao aliases finos do core; `node bin/forja.mjs` lista tudo por dominio.
|
|
8
|
+
|
|
9
|
+
Os **produtos gerados** vivem no **workspace Forja** (`~/forja-workspace` por padrao, configuravel via `FORJA_WORKSPACE` ou `~/.forjarc.json`). O repositorio atual e apenas o motor/framework. Veja ADR-0019. Toda IA que abre este repo ou um projeto gerado deve entender essa estrutura pelas instrucoes nativas (`CLAUDE.md`, `.github/copilot-instructions.md`, `.gemini-instructions.md`, `.openai-instructions.md` — conteudo canonico identico).
|
|
10
|
+
|
|
11
|
+
Comandos de rotina:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npm run workspace:init
|
|
15
|
+
npm run project:new <nome> -- --ai claude,copilot
|
|
16
|
+
npm run project:list
|
|
17
|
+
npm run project:check <nome>
|
|
18
|
+
|
|
19
|
+
npm run sprint:status
|
|
20
|
+
npm run gsd:plan -- <slug> "<objetivo>"
|
|
21
|
+
npm run gsd:handoff -- spec <slug>
|
|
22
|
+
npm run gsd:handoff -- plan <slug>
|
|
23
|
+
npm run gsd:handoff -- implement <slug>
|
|
24
|
+
npm run gsd:handoff -- review <slug>
|
|
25
|
+
npm run gsd:check -- <slug>
|
|
26
|
+
npm run project:check
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
6 papéis, cada um materializado em três lugares:
|
|
30
|
+
|
|
31
|
+
- **Sub-agent Claude Code** em `.claude/agents/<name>.md` (invocável via Task tool)
|
|
32
|
+
- **Prompt portátil** em `prompts/<name>-agent.md` (para Copilot/Gemini/Codex)
|
|
33
|
+
- **Descrição neste arquivo** (referência canônica de responsabilidades)
|
|
34
|
+
|
|
35
|
+
Handoffs entre eles passam pela tabela `handoffs` em `~/forja-workspace/memory/sqlite/universal.db` (configurável via `FORJA_WORKSPACE`/`~/.forjarc.json`), registrados via Hermes (`npm run hermes:handoff` ou `npm run gsd:handoff`) sobre `scripts/agent-router.mjs` (ADR-0008). Campos obrigatórios em todo handoff: `from, to, intent, context, acceptance, constraints, return` (ADR-0005).
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 1. Orchestrator (Master)
|
|
40
|
+
**Quando**: demanda atravessa múltiplos papéis ou usuário pede para "orquestrar/coordenar".
|
|
41
|
+
**Faz**: decompõe em handoffs, escolhe sub-agents, registra via agent-router, consolida memória ao fim de sprint.
|
|
42
|
+
**Não faz**: implementação direta.
|
|
43
|
+
|
|
44
|
+
## 2. Context Engineer
|
|
45
|
+
**Quando**: antes de tarefa pesada (refator amplo, análise multi-arquivo) ou em perguntas sobre tokens/cache.
|
|
46
|
+
**Faz**: monta `.context/pack.md` no modo certo (`global`|`domain`|`task` — ADR-0003), mede tokens, comprime memória.
|
|
47
|
+
**Não faz**: decisões de produto ou arquitetura.
|
|
48
|
+
|
|
49
|
+
## 3. SDD Architect
|
|
50
|
+
**Quando**: spec aprovada precisando virar plan, ou decisão estrutural pedindo ADR.
|
|
51
|
+
**Faz**: escreve `specs/<feat>/plan.md`, abre ADRs em `memory/90-decisions/`, devolve specs mal-escritas.
|
|
52
|
+
**Não faz**: código de implementação.
|
|
53
|
+
|
|
54
|
+
## 4. Product
|
|
55
|
+
**Quando**: demanda nova sem spec, ambiguidade sobre "o quê", priorização.
|
|
56
|
+
**Faz**: roda `npm run spec:new`, preenche `spec.md`, prioriza `backlog.md` via RICE, define métrica 30d.
|
|
57
|
+
**Não faz**: decisões de "como".
|
|
58
|
+
|
|
59
|
+
## 5. Marketing (Growth)
|
|
60
|
+
**Quando**: positioning antes do release, copy/landing, instrumentação AARRR, análise pós-launch.
|
|
61
|
+
**Faz**: copy referenciando dor da spec, lista de eventos a instrumentar, relatório de funil.
|
|
62
|
+
**Não faz**: invenção de números sem instrumentação.
|
|
63
|
+
|
|
64
|
+
## 6. Governance
|
|
65
|
+
**Quando**: antes de aprovar merge/release.
|
|
66
|
+
**Faz**: roda `project:check`, audita handoffs por completude, valida 12-Factor/LGPD/segurança, bloqueia se algo falta.
|
|
67
|
+
**Não faz**: aprovar "ficou bom" sem referência verificável.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Fluxo SDD padrão
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
usuário → Product (spec.md)
|
|
75
|
+
↓ approved
|
|
76
|
+
SDD Architect (plan.md + ADRs)
|
|
77
|
+
↓ approved
|
|
78
|
+
SDD Architect (tasks.md)
|
|
79
|
+
↓ handoff "implement"
|
|
80
|
+
Worker (código)
|
|
81
|
+
↓ handoff "review"
|
|
82
|
+
Governance (project:check)
|
|
83
|
+
↓ aprovado
|
|
84
|
+
merge → Orchestrator consolida memória
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
Context Engineer pode ser invocado em qualquer ponto. Marketing entra antes (positioning) e depois (métricas).
|
|
88
|
+
|
|
89
|
+
## GSD + Harness
|
|
90
|
+
|
|
91
|
+
GSD e o harness de execucao do fluxo SDD. Ele roda sempre em steps, valida gates e padroniza handoffs Hermes.
|
|
92
|
+
|
|
93
|
+
Ordem operacional:
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
briefing → estrutura → sprints → contexto → impacto (codegraph) → spec → design → plan → desenvolvimento → validação → governança
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Comandos principais:
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
npm run dev -- gsd:plan <slug> "<objetivo>"
|
|
103
|
+
npm run dev -- gsd:handoff spec <slug>
|
|
104
|
+
npm run dev -- gsd:handoff plan <slug>
|
|
105
|
+
npm run dev -- gsd:handoff implement <slug>
|
|
106
|
+
npm run dev -- gsd:handoff review <slug>
|
|
107
|
+
npm run dev -- gsd:check <slug> <brief.md>
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
Antes de planejar/editar, mapeie o impacto com codegraph (ADR-0017) e cheque ferramentas de processo (ADR-0018):
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
npm run code:check # indice codegraph confiavel (worktree + freshness)
|
|
114
|
+
npm run code:impact -- <simbolo> # chamadores + blast radius
|
|
115
|
+
npm run tools:doctor # raio-x: codegraph, gitleaks, ast-grep, lefthook, markdownlint
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
Use `design:select` e `design:check` antes de qualquer implementacao com impacto visual:
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
npm run dev -- design:select agent-console tecnico
|
|
122
|
+
npm run dev -- design:check design-md/examples/agent-console-brief.md
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## Onde olhar
|
|
126
|
+
- `.claude/agents/` — sub-agents Claude Code (system prompts)
|
|
127
|
+
- `prompts/` — prompts portáveis para outras IAs
|
|
128
|
+
- `memory/50-orchestration/` — protocolos detalhados (não-executáveis)
|
|
129
|
+
- `memory/90-decisions/0005-handoff-7-campos.md` e `0008-sub-agents-claude-handoff-sqlite.md`
|
|
130
|
+
- `scripts/agent-harness.mjs` — Hermes/GSD/design harness
|
|
131
|
+
- `scripts/agent-router.mjs` — CLI base de handoff
|
|
132
|
+
- `specs/` — pipeline SDD
|
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
Histórico consolidado das mudanças estruturais do framework. Para decisões arquiteturais com rationale, ver `memory/90-decisions/`.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## [Unreleased] — Workspace separado
|
|
8
|
+
|
|
9
|
+
SPEC-028 (`specs/reestruturacao-forja-v2/`): separação do framework Forja do workspace de produção.
|
|
10
|
+
|
|
11
|
+
- `lib/workspace.mjs` — resolução centralizada do workspace (`FORJA_WORKSPACE` > `~/.forjarc.json` > `~/forja-workspace`).
|
|
12
|
+
- `bin/init-project.js` — projetos de produto obrigatoriamente em `~/forja-workspace/projects/<nome>`.
|
|
13
|
+
- `scripts/sync-universal-memory.js`, `query-universal-memory.js`, `build-smart-context.js`, `memory-schema.mjs` — memória universal (SQLite) movida para o workspace.
|
|
14
|
+
- `scripts/check-standards.js` — `npm run project:check <nome>` resolve projeto no workspace.
|
|
15
|
+
- `scripts/agent-harness.mjs` + `package.json` — comandos `workspace:init`, `project:new`, `project:list`, `workspace:project:check`.
|
|
16
|
+
- Documentação atualizada: `README.md`, `AGENTS.md`, `docs/init-project.md`, `docs/structure.md`.
|
|
17
|
+
- ADR-0019 (`memory/90-decisions/0019-workspace-separado.md`) documenta a decisão.
|
|
18
|
+
- `.gitignore` reforça que projetos de produto não entram no repo do framework.
|
|
19
|
+
|
|
20
|
+
## [Unreleased] — Dashboard local
|
|
21
|
+
|
|
22
|
+
SPEC-002 (`specs/agent-dashboard/`) implementada em 12 tasks (T1-T12).
|
|
23
|
+
|
|
24
|
+
- `dashboard/server/` — Fastify 5 com 7 rotas (specs, handoffs, projects, tokens, commands SSE, briefing, health)
|
|
25
|
+
- `dashboard/web/` — Vite + React + Tailwind + Recharts; 6 telas; bundle 166KB gzip (NFR < 500KB ✓)
|
|
26
|
+
- `dashboard/server/lib/` — allowlist hard-coded, run-command, spec-parser, briefing-parser, token-estimator
|
|
27
|
+
- Scripts: `npm run dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:build`
|
|
28
|
+
- **60 testes verde** (55 dashboard + 5 root)
|
|
29
|
+
- `docs/dashboard.md` cobre uso, allowlist, troubleshooting, segurança
|
|
30
|
+
|
|
31
|
+
## [v1.1] — 2026-05-10 — Refator SDD + Orquestração
|
|
32
|
+
|
|
33
|
+
### Frente 1 — Cleanup + ADRs
|
|
34
|
+
- 13 relatórios históricos movidos para `docs/archive/`
|
|
35
|
+
- 4 guias úteis migrados para `docs/{structure,init-project,examples,publishing}.md`
|
|
36
|
+
- 2 exemplos antigos arquivados em `docs/archive/examples/`
|
|
37
|
+
- Monolito bin (1486 LOC) preservado em `docs/archive/legacy-bin/`
|
|
38
|
+
- `DOC-MAP.md` reescrito (204 → 50 linhas)
|
|
39
|
+
- 6 ADRs criados a partir de decisões dispersas (`memory/90-decisions/0001-0006`)
|
|
40
|
+
|
|
41
|
+
### Frente 2 — Bins e exemplos consolidados
|
|
42
|
+
- `bin/create-memory-nest-kit-v2.js` promovido a oficial (substituiu monolito)
|
|
43
|
+
- `package.json`: bin secundário, novos scripts `spec:*`, `agent:route`, `memory:vacuum`
|
|
44
|
+
- `exemplo-v3` mantido como exemplo canônico
|
|
45
|
+
|
|
46
|
+
### Frente 3 — Pipeline SDD
|
|
47
|
+
- `specs/_templates/{spec,plan,tasks}.md`
|
|
48
|
+
- `scripts/spec-cli.mjs` com `new`/`plan`/`tasks`/`check` (4/4 testes verdes)
|
|
49
|
+
- ADR-0007 estabelece SDD como obrigatório para features não-triviais
|
|
50
|
+
- SPEC-001 (`specs/pipeline-sdd-e-orquestracao/`) é a meta-spec deste refator
|
|
51
|
+
|
|
52
|
+
### Frente 4 — Sub-agents executáveis
|
|
53
|
+
- 6 sub-agents em `.claude/agents/`: orchestrator, context-engineer, sdd-architect, product, marketing, governance
|
|
54
|
+
- 3 prompts portáveis novos em `prompts/`
|
|
55
|
+
- `scripts/agent-router.mjs` persiste handoffs em `universal.db.handoffs` (7 campos validados)
|
|
56
|
+
- ADR-0008 documenta migração handoff markdown → SQLite
|
|
57
|
+
- `AGENTS.md` reescrito
|
|
58
|
+
|
|
59
|
+
### Frente 5 — Hooks token-economy
|
|
60
|
+
- `.claude/settings.json` com hooks `SessionStart` e `UserPromptSubmit`
|
|
61
|
+
- `scripts/hook-session-start.mjs` injeta status de specs + handoffs abertos
|
|
62
|
+
- `scripts/hook-user-prompt.mjs` opt-in (`FRAMEWORK_HOOK_INJECT=1`), cache 30min, cap 4KB
|
|
63
|
+
- `scripts/pre-commit.sh` agora roda `spec:check` + `check-standards`
|
|
64
|
+
- ADR-0009 documenta trade-offs
|
|
65
|
+
- `.memoryrc.json` ganha seção `hooks`; `handoff` aponta para SQLite
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## [v1.0] — 2026-05-02 — 4 Fases Estruturais
|
|
70
|
+
|
|
71
|
+
Detalhes completos em `docs/archive/PROJETO-COMPLETO.md`.
|
|
72
|
+
|
|
73
|
+
### Fase 1 — Arquitetura
|
|
74
|
+
- Monolito `bin/create-memory-nest-kit.js` (1486 LOC) refatorado em 5 módulos em `lib/`
|
|
75
|
+
- Orquestrador final: 125 LOC (redução de 91%)
|
|
76
|
+
- 1.820 LOC reutilizáveis em `lib/generators/`, `lib/validators/`, `lib/utils/`, `lib/context-builder.js`
|
|
77
|
+
- 7/7 testes passando; backward compatible
|
|
78
|
+
|
|
79
|
+
### Fase 2 — Documentação por Persona
|
|
80
|
+
- `docs/personas/{executive,architect,developer,qa}/` — guias estruturados
|
|
81
|
+
- `docs/quick-reference.md`, `docs/glossary.md`, `DOC-MAP.md`
|
|
82
|
+
- Onboarding reduzido em ~83% (medido em tempo de leitura)
|
|
83
|
+
|
|
84
|
+
### Fase 3 — Economia de Tokens
|
|
85
|
+
- `lib/context-builder.js` — API com 3 modos (`global`, `domain`, `task`), FTS5, cache LRU
|
|
86
|
+
- `scripts/compress-memory.mjs` — archive de runs > 30 dias, VACUUM
|
|
87
|
+
- `.memoryrc.json` — configuração centralizada
|
|
88
|
+
- `docs/token-optimization.md`, `scripts/token-benchmark.mjs`
|
|
89
|
+
- Redução estimada: 40-60% em tokens enviados ao modelo
|
|
90
|
+
|
|
91
|
+
### Fase 4 — Dev Workflow
|
|
92
|
+
- `scripts/dev.mjs` — CLI unificada (health/build-context/sprint/check)
|
|
93
|
+
- `scripts/pre-commit.sh` — validação automática
|
|
94
|
+
- `scripts/check-standards.js`, `scripts/generate-dashboard.js`
|
|
95
|
+
- 100% das operações cobertas por scripts npm
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## [v0.x] — 2026-04 — Bootstrap
|
|
100
|
+
|
|
101
|
+
- Estrutura inicial `memory/` hierárquica (00-global a 90-decisions)
|
|
102
|
+
- `bin/create-memory-nest-kit.js` — scaffold inicial monolítico
|
|
103
|
+
- SQLite universal (`.memory/sqlite/universal.db`) com FTS5
|
|
104
|
+
- Scripts `sprint-manager.js`, `sync-universal-memory.js`, `query-universal-memory.js`
|
|
105
|
+
- AGENTS.md com topologia de 6 papéis
|
|
106
|
+
- `exemplo-projeto/`, `exemplo-v2/`, `exemplo-v3/` — outputs de referência
|
package/CONTRIBUTING.md
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Contribuindo com a Forja
|
|
2
|
+
|
|
3
|
+
A Forja usa o próprio processo que ela prega. Contribuições seguem o mesmo pipeline:
|
|
4
|
+
|
|
5
|
+
## Regras do jogo
|
|
6
|
+
|
|
7
|
+
1. **Feature não-trivial começa por spec** — `npm run spec:new -- <slug>` e preencha `specs/<slug>/spec.md` antes de escrever código.
|
|
8
|
+
2. **Decisão estrutural vira ADR** — `memory/90-decisions/NNNN-titulo.md` (template em `_template.md`).
|
|
9
|
+
3. **Comando novo entra no registry** — `lib/core/registry.mjs` (o teste `test/forja-core.test.js` valida a integridade). Nada de script npm apontando direto para um script solto.
|
|
10
|
+
4. **pt-BR** em docs, mensagens e saída de CLI.
|
|
11
|
+
5. **Testes verdes** — `npm test` (Node ≥ 20).
|
|
12
|
+
|
|
13
|
+
## Setup
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npm ci
|
|
17
|
+
npm test
|
|
18
|
+
node bin/forja.mjs # help do core
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## Antes de abrir o PR
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
npm test
|
|
25
|
+
npm run project:check
|
|
26
|
+
npm run spec:check -- <slug-da-sua-feature>
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## O que não entra neste repo
|
|
30
|
+
|
|
31
|
+
- Dados de produto/cliente — vivem no workspace externo (`~/forja-workspace`, ADR-0019).
|
|
32
|
+
- Specs de produto — `specs/` do repo é allowlist (só specs do próprio framework, ver `.gitignore`).
|
package/DOC-MAP.md
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Mapa de Documentação
|
|
2
|
+
|
|
3
|
+
Ponto de entrada por papel. Para histórico de fases ver `CHANGELOG.md`; para decisões com rationale ver `memory/90-decisions/`.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Por papel
|
|
8
|
+
|
|
9
|
+
### Operacao CLI / Orquestracao
|
|
10
|
+
- `docs/processo-projeto.md` — **processo nível 0**: criar vs atualizar projeto com a IA (decisão de entrada)
|
|
11
|
+
- `docs/fluxo.md` — **mapa do ciclo** (CLI-first) com as 3 capacidades integradas (codegraph/harness/ai-engineering)
|
|
12
|
+
- `docs/manual-operacional-cli-sdd-gsd.md` — manual principal para operar CLI-first, SDD, GSD, sprints, handoffs e governanca
|
|
13
|
+
- `docs/cli-first-operacao.md` — guia curto de comandos
|
|
14
|
+
|
|
15
|
+
### Executivo / PM
|
|
16
|
+
- `docs/personas/executive/README.md` — overview, ROI, status
|
|
17
|
+
|
|
18
|
+
### Arquiteto / Tech Lead
|
|
19
|
+
- `docs/personas/architect/README.md`
|
|
20
|
+
- `docs/token-optimization.md` — economia de tokens e cache
|
|
21
|
+
- `docs/structure.md` — hierarquia de diretórios gerados
|
|
22
|
+
- `memory/90-decisions/` — ADRs
|
|
23
|
+
|
|
24
|
+
### Developer
|
|
25
|
+
- `docs/personas/developer/README.md`
|
|
26
|
+
- `docs/quick-reference.md` — atalhos e comandos
|
|
27
|
+
- `docs/examples.md` — snippets prontos
|
|
28
|
+
- `docs/dev-workflow.md`
|
|
29
|
+
- `docs/init-project.md` — como gerar novo projeto
|
|
30
|
+
- `docs/dashboard.md` — painel web local (`npm run dashboard`)
|
|
31
|
+
|
|
32
|
+
### QA
|
|
33
|
+
- `docs/personas/qa/README.md`
|
|
34
|
+
|
|
35
|
+
### Agentes / IA
|
|
36
|
+
- `AGENTS.md` — papéis e topologia
|
|
37
|
+
- `CLAUDE.md` — instruções específicas para Claude Code
|
|
38
|
+
- `.claude/agents/` — sub-agents executáveis (em construção)
|
|
39
|
+
- `memory/50-orchestration/` — protocolos de handoff
|
|
40
|
+
- `docs/capacidades-externas.md` — codegraph (MCP), harness (plugin) e ai-engineering (base de conhecimento) integrados (ADR-0016)
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Por tópico
|
|
45
|
+
|
|
46
|
+
| Tópico | Arquivo |
|
|
47
|
+
|---|---|
|
|
48
|
+
| Manual operacional CLI-first | `docs/manual-operacional-cli-sdd-gsd.md` |
|
|
49
|
+
| Guia curto CLI-first | `docs/cli-first-operacao.md` |
|
|
50
|
+
| Mudanças recentes | `CHANGELOG.md` |
|
|
51
|
+
| Decisões arquiteturais | `memory/90-decisions/` |
|
|
52
|
+
| Glossário | `docs/glossary.md` |
|
|
53
|
+
| Otimização de tokens | `docs/token-optimization.md` |
|
|
54
|
+
| Capacidades externas (codegraph/harness/ai-engineering) | `docs/capacidades-externas.md` |
|
|
55
|
+
| Workflow de dev | `docs/dev-workflow.md` |
|
|
56
|
+
| Publicação npm | `docs/publishing.md` |
|
|
57
|
+
| Estrutura gerada | `docs/structure.md` |
|
|
58
|
+
| Exemplos de código | `docs/examples.md` |
|
|
59
|
+
| Dashboard web | `docs/dashboard.md` |
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Histórico
|
|
64
|
+
|
|
65
|
+
Relatórios de fases anteriores estão em `docs/archive/`. Não edite — referenciar via `CHANGELOG.md` ou ADRs apropriadas.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
<h1 align="center">🔨 Forja</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<strong>Transforme IA de codificação em uma equipe de engenharia com processo e memória:<br>todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.</strong>
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<img src="https://github.com/allanpablo/forja/actions/workflows/ci.yml/badge.svg" alt="CI">
|
|
9
|
+
<img src="https://img.shields.io/badge/operação-CLI--first-3553ff?style=flat-square" alt="CLI-first">
|
|
10
|
+
<img src="https://img.shields.io/badge/agentes-6_papéis-orange?style=flat-square" alt="6 agentes">
|
|
11
|
+
<img src="https://img.shields.io/badge/pipeline-SDD_+_GSD-teal?style=flat-square" alt="SDD+GSD">
|
|
12
|
+
<img src="https://img.shields.io/badge/memória-SQLite_FTS5-green?style=flat-square" alt="Memória">
|
|
13
|
+
<img src="https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 20">
|
|
14
|
+
<img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT">
|
|
15
|
+
<img src="https://img.shields.io/badge/PRs-welcome-8957e5?style=flat-square" alt="PRs welcome">
|
|
16
|
+
</p>
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Por que a Forja existe
|
|
21
|
+
|
|
22
|
+
Agentes de IA são **amnésicos e indisciplinados**: cada sessão recomeça do zero, decisões
|
|
23
|
+
de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao
|
|
24
|
+
mesmo tempo paga esse imposto multiplicado por N.
|
|
25
|
+
|
|
26
|
+
A **Forja** é o estúdio em volta da IA. Ela coordena **6 papéis de agentes** num pipeline
|
|
27
|
+
**Spec-Driven (SDD)** + **Get-Stuff-Done (GSD)**, mantém uma **memória hierárquica**
|
|
28
|
+
indexada em SQLite que sobrevive entre sessões, e amarra tudo num **core CLI único com
|
|
29
|
+
gates e trilha de auditoria** (`forja`, ADR-0020). Multi-IA por design (Claude, Copilot,
|
|
30
|
+
Gemini, Codex) — o dashboard web é apenas uma visão opcional read-only.
|
|
31
|
+
|
|
32
|
+
**Para quem**: o dev solo ou time pequeno que opera múltiplos produtos com IA como
|
|
33
|
+
principal força de trabalho — e precisa da disciplina de um time grande sem ter esse time.
|
|
34
|
+
|
|
35
|
+
## Os 3 pilares
|
|
36
|
+
|
|
37
|
+
| Pilar | O que entrega | Prova |
|
|
38
|
+
|---|---|---|
|
|
39
|
+
| **Memória que sobrevive** | contexto hierárquico, buscável, compartilhado entre sessões e IAs | SQLite FTS5, smart-context (ADR-0003) |
|
|
40
|
+
| **Processo que governa** | nada vira código sem spec; nada estrutural sem ADR; comandos auditados | SDD+GSD, handoffs 7 campos (ADR-0005), core `forja` (ADR-0020) |
|
|
41
|
+
| **Fábrica, não projeto único** | workspace multi-produto, times de agentes por projeto | ADR-0019, harness, codegraph (ADR-0017) |
|
|
42
|
+
|
|
43
|
+
> Este repositório é o **motor (framework)** — não hospeda aplicações em produção.
|
|
44
|
+
> Os produtos do usuário vivem no **workspace Forja** (`~/forja-workspace` por padrão), fora deste repo.
|
|
45
|
+
> Veja ADR-0019 para a rationale.
|
|
46
|
+
|
|
47
|
+
## 60 segundos de Forja
|
|
48
|
+
|
|
49
|
+
```console
|
|
50
|
+
$ forja spec:new pagamentos-pix
|
|
51
|
+
✓ Spec criada: specs/pagamentos-pix/spec.md # nada vira código sem isso
|
|
52
|
+
|
|
53
|
+
$ forja gsd:handoff -- plan pagamentos-pix
|
|
54
|
+
Handoff registrado: product → sdd-architect # 7 campos, auditável (ADR-0005)
|
|
55
|
+
|
|
56
|
+
$ forja code:impact -- processPayment
|
|
57
|
+
Mapa de impacto: processPayment (profundidade 2) # blast radius ANTES de editar
|
|
58
|
+
--- Chamadores diretos ---
|
|
59
|
+
BillingController.charge · RetryWorker.run
|
|
60
|
+
|
|
61
|
+
$ forja gsd:check -- pagamentos-pix
|
|
62
|
+
OK GSD runbook OK Spec directory
|
|
63
|
+
OK SDD spec check OK Codegraph
|
|
64
|
+
Resultado: gates básicos prontos. # governança executável, não checklist
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
E cada comando acima ficou gravado em `.context/forja-runs.jsonl` — quando a governança pergunta "o processo foi seguido?", a resposta é um arquivo, não uma promessa.
|
|
68
|
+
|
|
69
|
+
## Por que não só…?
|
|
70
|
+
|
|
71
|
+
| Alternativa | Onde ela para | O que a Forja acrescenta |
|
|
72
|
+
|---|---|---|
|
|
73
|
+
| **Claude Code / Copilot puros** | brilhantes na sessão, amnésicos entre sessões | memória FTS5 + processo + auditoria em volta da IA |
|
|
74
|
+
| **LangGraph / CrewAI** | infraestrutura para *construir* agentes | a camada de cima: opera o time de agentes no dia a dia |
|
|
75
|
+
| **Templates & spec kits** | param quando a spec está escrita | pipeline completo até a governança, com gates que executam |
|
|
76
|
+
|
|
77
|
+
## Capacidades-chave
|
|
78
|
+
|
|
79
|
+
- **Core CLI único** — todo comando de processo passa por `forja <comando>`: registry declarativo, gates transversais (workspace) e auditoria append-only em `.context/forja-runs.jsonl` (ADR-0020).
|
|
80
|
+
- **Orquestração multiagente** — 6 papéis (orchestrator, context-engineer, sdd-architect, product, marketing, governance) com handoffs rastreados (7 campos, ADR-0005).
|
|
81
|
+
- **Memória hierárquica** — global → domínio → tarefa → resumo, com busca FTS5 e *smart-context* em 3 modos (ADR-0003).
|
|
82
|
+
- **Pipeline SDD + GSD** — `spec → plan → tasks → check`, decisões registradas como ADRs.
|
|
83
|
+
- **Geração de projetos** — `project:new` cria scaffold completo no workspace (memória, agentes, instruções multi-IA, backend NestJS como boilerplate padrão) e registra a ficha do projeto automaticamente.
|
|
84
|
+
- **3 capacidades integradas** (ADR-0016): **codegraph** (análise de código via MCP), **harness** (desenho de times de agentes), **ai-engineering** (base de conhecimento).
|
|
85
|
+
|
|
86
|
+
## ⚡ Quick start
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
# Preparar o workspace de produção (canto fixo dos projetos)
|
|
90
|
+
npm run workspace:init
|
|
91
|
+
|
|
92
|
+
# Criar um projeto novo (gera em ~/forja-workspace/projects/<nome>)
|
|
93
|
+
npm run project:new meu-projeto -- --ai claude,copilot
|
|
94
|
+
|
|
95
|
+
# Entrar no ciclo SDD/GSD da primeira feature
|
|
96
|
+
npm run spec:new -- minha-feature
|
|
97
|
+
npm run spec:plan -- minha-feature
|
|
98
|
+
npm run spec:tasks -- minha-feature
|
|
99
|
+
npm run spec:check -- minha-feature
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Passo a passo de **criar vs atualizar** projeto: [`docs/processo-projeto.md`](docs/processo-projeto.md).
|
|
103
|
+
|
|
104
|
+
## Como funciona — o processo
|
|
105
|
+
|
|
106
|
+
```
|
|
107
|
+
💡 Demanda
|
|
108
|
+
├─ projeto NÃO existe ─► init:project + boilerplate + harness (desenha o time)
|
|
109
|
+
└─ projeto JÁ existe ──► overlay --only-memory + codegraph init (entende o código)
|
|
110
|
+
│
|
|
111
|
+
▼
|
|
112
|
+
CICLO CLI-first (docs/fluxo.md):
|
|
113
|
+
1·Entender → 2·Especificar → 3·Arquitetar → 4·Decompor → 5·Implementar → 6·Governar → ✅
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
| Etapa | Papel | Capacidade |
|
|
117
|
+
|-------|-------|------------|
|
|
118
|
+
| 1 Entender | context-engineer | codegraph · ai-engineering |
|
|
119
|
+
| 2 Especificar | product | — |
|
|
120
|
+
| 3 Arquitetar | sdd-architect | harness · ADR |
|
|
121
|
+
| 4 Decompor | sdd-architect | — |
|
|
122
|
+
| 5 Implementar | orchestrator + worker | codegraph (MCP) |
|
|
123
|
+
| 6 Governar | governance | codegraph (`affected`) |
|
|
124
|
+
|
|
125
|
+
Mapa completo do ciclo: [`docs/fluxo.md`](docs/fluxo.md).
|
|
126
|
+
|
|
127
|
+
## As 3 capacidades integradas
|
|
128
|
+
|
|
129
|
+
| Capacidade | Papel | Como usar |
|
|
130
|
+
|---|---|---|
|
|
131
|
+
| **codegraph** | análise de código (MCP local) | `npm run code:index` · `codegraph explore "<área>"` · ferramentas MCP `codegraph_explore`/`codegraph_node` |
|
|
132
|
+
| **harness** | desenho de times de agentes (plugin) | na sessão Claude Code: _"build a harness for this project"_ → gera `.claude/agents` + `.claude/skills` |
|
|
133
|
+
| **ai-engineering** | base de conhecimento (referência) | `projects/ai-engineering-from-scratch-main/` (ROADMAP, phases, glossary) |
|
|
134
|
+
|
|
135
|
+
Detalhes e reinstalação: [`docs/capacidades-externas.md`](docs/capacidades-externas.md) · [ADR-0016](memory/90-decisions/0016-integracao-capacidades-externas.md).
|
|
136
|
+
|
|
137
|
+
## O core `forja`
|
|
138
|
+
|
|
139
|
+
Todos os comandos de processo passam por um único ponto de entrada (ADR-0020):
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
node bin/forja.mjs # help agrupado por domínio
|
|
143
|
+
node bin/forja.mjs <comando> # ou, com o pacote linkado: forja <comando>
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
O core aplica **gates** antes de executar (ex.: comandos de produto falham cedo sem
|
|
147
|
+
workspace) e grava **auditoria** de cada execução (comando, args, exit code, duração)
|
|
148
|
+
em `<workspace>/.context/forja-runs.jsonl` — a trilha que a governança usa no review.
|
|
149
|
+
Os scripts npm abaixo são aliases finos que roteiam pelo core.
|
|
150
|
+
|
|
151
|
+
## Comandos essenciais
|
|
152
|
+
|
|
153
|
+
```bash
|
|
154
|
+
# Workspace & projetos
|
|
155
|
+
npm run workspace:init # cria ~/forja-workspace
|
|
156
|
+
npm run project:new <nome> -- --ai claude,copilot # cria projeto no workspace
|
|
157
|
+
npm run project:list # lista projetos do workspace
|
|
158
|
+
npm run project:check <nome> # valida padrões no projeto
|
|
159
|
+
|
|
160
|
+
# Pipeline SDD
|
|
161
|
+
npm run spec:new|plan|tasks|check -- <slug>
|
|
162
|
+
|
|
163
|
+
# Sprint & handoffs (GSD)
|
|
164
|
+
npm run sprint:start | sprint:status | sprint:complete
|
|
165
|
+
npm run gsd:handoff -- <intent> <slug> # handoff entre papéis (ADR-0005)
|
|
166
|
+
|
|
167
|
+
# Análise de código (codegraph)
|
|
168
|
+
npm run code:index | code:sync | code:status
|
|
169
|
+
npm run code:query "<termo>"
|
|
170
|
+
|
|
171
|
+
# Memória & contexto (workspace)
|
|
172
|
+
npm run sync:universal # reindexa SQLite FTS5 do workspace
|
|
173
|
+
npm run query:universal "<query>"
|
|
174
|
+
npm run context:smart # smart-context
|
|
175
|
+
|
|
176
|
+
# Qualidade & visão
|
|
177
|
+
npm run project:check # standards do framework
|
|
178
|
+
npm run dashboard # front opcional (http://127.0.0.1:7777)
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
## Separação framework × workspace
|
|
182
|
+
|
|
183
|
+
O Forja é dividido em duas partes:
|
|
184
|
+
|
|
185
|
+
1. **Framework** (este repositório): motor, convenções, scripts e memória do próprio framework.
|
|
186
|
+
2. **Workspace** (`~/forja-workspace` por padrão): "canto fixo" onde vivem os projetos de produto, a memória universal deles e as specs de produto.
|
|
187
|
+
|
|
188
|
+
O caminho do workspace é resolvido por prioridade:
|
|
189
|
+
|
|
190
|
+
1. Variável de ambiente `FORJA_WORKSPACE`
|
|
191
|
+
2. Campo `workspaceRoot` em `~/.forjarc.json`
|
|
192
|
+
3. Padrão: `~/forja-workspace`
|
|
193
|
+
|
|
194
|
+
Veja ADR-0019 para a decisão arquitetural.
|
|
195
|
+
|
|
196
|
+
## Estrutura do repositório (framework)
|
|
197
|
+
|
|
198
|
+
```
|
|
199
|
+
bin/ CLIs (init-project, create-memory-nest-kit)
|
|
200
|
+
lib/ Módulos reutilizáveis (workspace, generators, validators, context-builder)
|
|
201
|
+
scripts/ Automação (sprint-manager, agent-router, sync-universal-memory, …)
|
|
202
|
+
specs/ Pipeline SDD do próprio framework (spec → plan → tasks)
|
|
203
|
+
boilerplates/ Templates de stack (api-rest, saas, ecommerce, microservices, monorepo)
|
|
204
|
+
memory/ Memória do framework (00-global … 90-decisions/ADRs)
|
|
205
|
+
docs/ Documentação por persona e por tópico (ver DOC-MAP.md)
|
|
206
|
+
prompts/ Prompts portáteis dos 6 papéis
|
|
207
|
+
.claude/ Sub-agents e settings do Claude Code
|
|
208
|
+
projects/ LEGADO — não usar; projetos vivem no workspace externo
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
## Estrutura do workspace
|
|
212
|
+
|
|
213
|
+
```
|
|
214
|
+
~/forja-workspace/
|
|
215
|
+
projects/ # produtos gerados
|
|
216
|
+
memory/
|
|
217
|
+
sqlite/universal.db # SQLite FTS5 dos produtos
|
|
218
|
+
30-projects/ # fichas dos projetos
|
|
219
|
+
specs/ # specs de produto
|
|
220
|
+
.context/ # runbooks GSD de produto
|
|
221
|
+
README.md
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
## Documentação
|
|
225
|
+
|
|
226
|
+
- [`DOC-MAP.md`](DOC-MAP.md) — mapa por papel e por tópico (comece aqui)
|
|
227
|
+
- [`docs/processo-projeto.md`](docs/processo-projeto.md) — criar vs atualizar projeto
|
|
228
|
+
- [`docs/fluxo.md`](docs/fluxo.md) — mapa do ciclo CLI-first
|
|
229
|
+
- [`AGENTS.md`](AGENTS.md) — os 6 papéis e a topologia
|
|
230
|
+
- [`memory/90-decisions/`](memory/90-decisions/) — ADRs com rationale
|
|
231
|
+
- [`CHANGELOG.md`](CHANGELOG.md) — histórico
|
|
232
|
+
|
|
233
|
+
## Convenções
|
|
234
|
+
|
|
235
|
+
- **CLI-first** — sprints, SDD, GSD, handoffs e governança por comando; o front nunca é gate.
|
|
236
|
+
- **ADRs** — toda decisão estrutural vira `memory/90-decisions/NNNN-titulo.md`.
|
|
237
|
+
- **Handoffs** — 7 campos obrigatórios (ADR-0005), gravados no SQLite (ADR-0008).
|
|
238
|
+
- **pt-BR** — comunicação e documentação em português.
|
|
239
|
+
|
|
240
|
+
## Roadmap
|
|
241
|
+
|
|
242
|
+
- [ ] **Core fase 2** — CLI `forja` embutida nos projetos gerados (hoje herdam harness + instruções)
|
|
243
|
+
- [ ] **Auditoria no SQLite** — promover `forja-runs.jsonl` a tabela consultável via FTS5
|
|
244
|
+
- [ ] **Boilerplates além de NestJS** — o processo é agnóstico de stack; os templates vão atrás
|
|
245
|
+
- [ ] **Docs em inglês** — pt-BR continua sendo a língua do projeto
|
|
246
|
+
|
|
247
|
+
Sugestões? Abra uma issue — feature não-trivial aqui começa por spec, inclusive as suas.
|
|
248
|
+
|
|
249
|
+
## English summary
|
|
250
|
+
|
|
251
|
+
**Forja** turns coding AI into an engineering team with process and memory: every project starts from a spec, every structural decision becomes an ADR, and nothing is lost between sessions. It orchestrates 6 agent roles through a Spec-Driven + GSD pipeline, keeps hierarchical memory indexed in SQLite FTS5, routes every command through a single audited core CLI (`forja`), and works with Claude, Copilot, Gemini and Codex by design. Documentation is in Brazilian Portuguese — that's part of the project's identity; the CLI and the code are readable regardless.
|
|
252
|
+
|
|
253
|
+
---
|
|
254
|
+
|
|
255
|
+
<p align="center">
|
|
256
|
+
<strong>A Forja te ajudou a domar seus agentes?</strong><br>
|
|
257
|
+
Uma ⭐ é o que faz o projeto chegar a mais devs que estão pagando o imposto da IA amnésica.
|
|
258
|
+
</p>
|
|
259
|
+
|
|
260
|
+
<p align="center"><sub>Forja (npm: <code>forjajs</code>) · MIT License · <a href="CONTRIBUTING.md">Contribuindo</a></sub></p>
|