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,168 @@
|
|
|
1
|
+
# Tasks: agent-dashboard
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Criado em**: 2026-05-11
|
|
6
|
+
|
|
7
|
+
Decomposição em 12 tasks. Estimativas: P=≤2h, M=2-6h, G=6h+. Ordem reflete execução padrão; T2-T9 podem rodar em paralelo após T1.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## T1 — Bootstrap do projeto `dashboard/`
|
|
12
|
+
- **Owner**: Worker
|
|
13
|
+
- **Estimativa**: P
|
|
14
|
+
- **Depende de**: —
|
|
15
|
+
- **Paths**: `dashboard/package.json`, `dashboard/server/index.mjs`, `dashboard/.gitignore`, `package.json` (root)
|
|
16
|
+
- **Done quando**:
|
|
17
|
+
- [ ] `dashboard/package.json` com fastify, @fastify/static, @fastify/cors, better-sqlite3
|
|
18
|
+
- [ ] `dashboard/server/index.mjs` sobe Fastify em 127.0.0.1:7777 com `GET /api/health` → `{ok:true}`
|
|
19
|
+
- [ ] Root `package.json` ganha script `"dashboard": "cd dashboard && npm start"`
|
|
20
|
+
- [ ] `.gitignore` ignora `dashboard/node_modules`, `dashboard/web/dist`
|
|
21
|
+
- [ ] `npm run dashboard` sobe sem erro
|
|
22
|
+
|
|
23
|
+
## T2 — Allowlist + util de spawn seguro
|
|
24
|
+
- **Owner**: Worker
|
|
25
|
+
- **Estimativa**: P
|
|
26
|
+
- **Depende de**: T1
|
|
27
|
+
- **Paths**: `dashboard/server/lib/allowlist.mjs`, `dashboard/server/lib/run-command.mjs`
|
|
28
|
+
- **Done quando**:
|
|
29
|
+
- [ ] `allowlist.mjs` exporta `COMMAND_ALLOWLIST` exato como no plan §4
|
|
30
|
+
- [ ] `run-command.mjs` valida nome, faz `spawn` sem `shell: true`
|
|
31
|
+
- [ ] Teste: comando fora da allowlist → throw `CommandNotAllowed`
|
|
32
|
+
- [ ] Teste: comando válido devolve stream readable de stdout
|
|
33
|
+
|
|
34
|
+
## T3 — Rota Specs (read-only)
|
|
35
|
+
- **Owner**: Worker
|
|
36
|
+
- **Estimativa**: P
|
|
37
|
+
- **Depende de**: T1
|
|
38
|
+
- **Paths**: `dashboard/server/routes/specs.mjs`
|
|
39
|
+
- **Done quando**:
|
|
40
|
+
- [ ] `GET /api/specs` lê `specs/*/spec.md`, retorna array conforme contrato §4
|
|
41
|
+
- [ ] `GET /api/specs/:slug` devolve conteúdo cru de spec/plan/tasks
|
|
42
|
+
- [ ] Teste de integração com fixture: 2 specs fake → 2 itens
|
|
43
|
+
|
|
44
|
+
## T4 — Rota Handoffs com transição
|
|
45
|
+
- **Owner**: Worker
|
|
46
|
+
- **Estimativa**: M
|
|
47
|
+
- **Depende de**: T1
|
|
48
|
+
- **Paths**: `dashboard/server/routes/handoffs.mjs`
|
|
49
|
+
- **Done quando**:
|
|
50
|
+
- [ ] `GET /api/handoffs?status=&to=` consulta `universal.db.handoffs`
|
|
51
|
+
- [ ] `POST /api/handoffs/:id/transition` valida `to ∈ {in_progress,done,cancelled}` e shell-out para `agent-router.mjs`
|
|
52
|
+
- [ ] Teste: transição inválida → 400; válida → 200 + status atualizado
|
|
53
|
+
|
|
54
|
+
## T5 — Rota Projects
|
|
55
|
+
- **Owner**: Worker
|
|
56
|
+
- **Estimativa**: P
|
|
57
|
+
- **Depende de**: T1
|
|
58
|
+
- **Paths**: `dashboard/server/routes/projects.mjs`
|
|
59
|
+
- **Done quando**:
|
|
60
|
+
- [ ] `GET /api/projects` lê `projects/*`, cruza com SQLite por slug
|
|
61
|
+
- [ ] `last_commit` via `git -C` (null se não-git)
|
|
62
|
+
- [ ] `memory_bytes` = `du -sb` de `projects/<name>/memory/`
|
|
63
|
+
|
|
64
|
+
## T6 — Rota Tokens (estimador)
|
|
65
|
+
- **Owner**: Worker
|
|
66
|
+
- **Estimativa**: M
|
|
67
|
+
- **Depende de**: T1
|
|
68
|
+
- **Paths**: `dashboard/server/routes/tokens.mjs`, `dashboard/server/lib/token-estimator.mjs`
|
|
69
|
+
- **Done quando**:
|
|
70
|
+
- [ ] `token-estimator.mjs` calcula chars/4 sobre `.context/*` e `memory/60-runs/*.json` agregado por dia
|
|
71
|
+
- [ ] `GET /api/tokens?project=&days=30` devolve série temporal
|
|
72
|
+
- [ ] Resposta < 500ms p95 com 10 projetos (kill criterion §8)
|
|
73
|
+
- [ ] Cada datapoint rotulado como "estimativa"
|
|
74
|
+
|
|
75
|
+
## T7 — Rota Commands com SSE
|
|
76
|
+
- **Owner**: Worker
|
|
77
|
+
- **Estimativa**: M
|
|
78
|
+
- **Depende de**: T2
|
|
79
|
+
- **Paths**: `dashboard/server/routes/commands.mjs`
|
|
80
|
+
- **Done quando**:
|
|
81
|
+
- [ ] `POST /api/commands/:name` valida allowlist, abre SSE
|
|
82
|
+
- [ ] Eventos `stdout`, `stderr`, `exit` (com código)
|
|
83
|
+
- [ ] Fora da allowlist → 403 `{error:"command not allowlisted"}`
|
|
84
|
+
- [ ] E2E: dispara `spec:check` e recebe ≥1 evento `stdout` + `exit:0`
|
|
85
|
+
|
|
86
|
+
## T8 — Rota Briefing → spec
|
|
87
|
+
- **Owner**: Worker
|
|
88
|
+
- **Estimativa**: M
|
|
89
|
+
- **Depende de**: T2
|
|
90
|
+
- **Paths**: `dashboard/server/routes/briefing.mjs`, `dashboard/server/lib/briefing-parser.mjs`
|
|
91
|
+
- **Done quando**:
|
|
92
|
+
- [ ] Parser: split parágrafos, detecta keywords (`problema`, `queremos`, `para que <persona>`, `como <persona>`), preenche seções 1-3
|
|
93
|
+
- [ ] `POST /api/briefing` valida `slug` kebab-case, cria via `spec-cli.mjs new`, sobrescreve seções 1-3
|
|
94
|
+
- [ ] Status fica em `draft` (nunca `approved` automático)
|
|
95
|
+
- [ ] Teste com 3 briefings de exemplo: cada um produz spec parseável
|
|
96
|
+
|
|
97
|
+
## T9 — Frontend bootstrap (Vite + Tailwind + shadcn)
|
|
98
|
+
- **Owner**: Worker
|
|
99
|
+
- **Estimativa**: M
|
|
100
|
+
- **Depende de**: T1
|
|
101
|
+
- **Paths**: `dashboard/web/`
|
|
102
|
+
- **Done quando**:
|
|
103
|
+
- [ ] `dashboard/web/` com Vite + React + Tailwind
|
|
104
|
+
- [ ] shadcn instalado, 3-4 componentes copiados (button, card, badge, dialog)
|
|
105
|
+
- [ ] Layout base: sidebar com 6 links (Briefing, Specs, Handoffs, Tokens, Comandos, Projetos)
|
|
106
|
+
- [ ] `vite build` < 500KB gzipped (NFR)
|
|
107
|
+
- [ ] `npm run dashboard` serve `dist/` via @fastify/static
|
|
108
|
+
|
|
109
|
+
## T10 — Telas Specs + Handoffs + Projetos
|
|
110
|
+
- **Owner**: Worker
|
|
111
|
+
- **Estimativa**: G
|
|
112
|
+
- **Depende de**: T3, T4, T5, T9
|
|
113
|
+
- **Paths**: `dashboard/web/src/pages/{Specs,Handoffs,Projects}.tsx`
|
|
114
|
+
- **Done quando**:
|
|
115
|
+
- [ ] Specs: tabela com status colorido + drawer com spec/plan/tasks markdown renderizado
|
|
116
|
+
- [ ] Handoffs: 3 colunas kanban com botão de transição
|
|
117
|
+
- [ ] Projetos: cards com badges (specs, handoffs, último commit, memória)
|
|
118
|
+
- [ ] Polling 30s em cada tela
|
|
119
|
+
|
|
120
|
+
## T11 — Telas Tokens + Comandos + Briefing
|
|
121
|
+
- **Owner**: Worker
|
|
122
|
+
- **Estimativa**: G
|
|
123
|
+
- **Depende de**: T6, T7, T8, T9
|
|
124
|
+
- **Paths**: `dashboard/web/src/pages/{Tokens,Commands,Briefing}.tsx`
|
|
125
|
+
- **Done quando**:
|
|
126
|
+
- [ ] Tokens: gráfico de linha (Recharts) 30d com toggle de projeto
|
|
127
|
+
- [ ] Comandos: 5 botões, painel lateral com stdout/stderr ao vivo via EventSource
|
|
128
|
+
- [ ] Briefing: textarea ≥10 linhas + select de projeto + botão "Gerar spec" → redireciona para `/specs/<slug>`
|
|
129
|
+
|
|
130
|
+
## T12 — Documentação + handoff de governance
|
|
131
|
+
- **Owner**: Worker → Governance
|
|
132
|
+
- **Estimativa**: P
|
|
133
|
+
- **Depende de**: T10, T11
|
|
134
|
+
- **Paths**: `docs/dashboard.md`, `DOC-MAP.md`, `CHANGELOG.md`
|
|
135
|
+
- **Done quando**:
|
|
136
|
+
- [ ] `docs/dashboard.md` cobre: como subir, porta, allowlist, troubleshooting
|
|
137
|
+
- [ ] `DOC-MAP.md` ganha entrada para o dashboard
|
|
138
|
+
- [ ] `CHANGELOG.md` ganha entrada `[Unreleased]`
|
|
139
|
+
- [ ] Handoff `worker → governance` aberto via `agent-router append`
|
|
140
|
+
- [ ] `npm test` e `npm run spec:check` ambos verdes
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## Caminho crítico
|
|
145
|
+
|
|
146
|
+
```
|
|
147
|
+
T1 ─┬─ T2 ─┬─ T7 ─┐
|
|
148
|
+
├─ T3 ─┤ │
|
|
149
|
+
├─ T4 ─┤ ├─ T10 ─┐
|
|
150
|
+
├─ T5 ─┤ │ ├─ T12
|
|
151
|
+
├─ T6 ─┤ ├─ T11 ─┘
|
|
152
|
+
├─ T9 ─┘ │
|
|
153
|
+
└─ T2 → T8 ───┘
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
T1 destrava todas. T10 espera rotas read-only + frontend base. T11 espera rotas mutáveis + frontend base. T12 fecha com Governance.
|
|
157
|
+
|
|
158
|
+
## Handoffs sugeridos
|
|
159
|
+
|
|
160
|
+
Quando T1 concluir:
|
|
161
|
+
```bash
|
|
162
|
+
node scripts/agent-router.mjs append '{"from":"sdd-architect","to":"worker","intent":"implement","context":"specs/agent-dashboard/plan.md §2-§5; tasks.md T2-T9 destravadas","acceptance":"rotas /api/* respondem com schema do plan §4; testes verdes","constraints":"allowlist hard-coded; bind 127.0.0.1; sem shell:true","return":"PR + handoff para governance","spec_slug":"agent-dashboard"}'
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
Antes do merge (após T11):
|
|
166
|
+
```bash
|
|
167
|
+
node scripts/agent-router.mjs append '{"from":"worker","to":"governance","intent":"review","context":"PR agent-dashboard; rotas + 5 telas + allowlist","acceptance":"project:check verde, spec:check verde, auditoria de RCE na rota /api/commands","constraints":"bloquear merge se allowlist contornável","return":"veredicto APROVADO ou findings","spec_slug":"agent-dashboard"}'
|
|
168
|
+
```
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Plan: cli-first-operacao
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-06-02
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem tecnica
|
|
8
|
+
Manter o dashboard existente como opcional e mover a operacao principal para comandos. Corrigir o gerenciador de sprint para funcionar no repositorio raiz, aceitar backlog RICE e expor encerramento de sprint no `package.json`. Ajustar GSD para nao exigir design em fluxo sem UI.
|
|
9
|
+
|
|
10
|
+
## 2. Modulos afetados
|
|
11
|
+
| Caminho | Mudanca | Risco |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `scripts/sprint-manager.js` | default para raiz e suporte a tabela RICE | M |
|
|
14
|
+
| `scripts/agent-harness.mjs` | `gsd:check` aceita CLI-only sem brief visual | B |
|
|
15
|
+
| `scripts/dev.mjs` | saida textual mais limpa | B |
|
|
16
|
+
| `scripts/check-standards.js` | `project:check` valida root sem argumento | B |
|
|
17
|
+
| `package.json` | novos aliases de operacao | B |
|
|
18
|
+
| `README.md`, `AGENTS.md`, `docs/*` | documentar CLI-first | B |
|
|
19
|
+
|
|
20
|
+
## 3. Fluxo
|
|
21
|
+
```
|
|
22
|
+
sprint:start/status
|
|
23
|
+
-> context:build
|
|
24
|
+
-> gsd:plan
|
|
25
|
+
-> gsd:handoff spec/plan/implement/review
|
|
26
|
+
-> gsd:check
|
|
27
|
+
-> project:check
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 4. Contratos
|
|
31
|
+
- `npm run sprint:start [projeto]`
|
|
32
|
+
- `npm run sprint:status [projeto]`
|
|
33
|
+
- `npm run sprint:complete [projeto]`
|
|
34
|
+
- `npm run gsd:check -- <slug> [brief.md]`
|
|
35
|
+
|
|
36
|
+
Sem `brief.md`, o check considera design como nao aplicavel.
|
|
37
|
+
|
|
38
|
+
## 5. Decisoes
|
|
39
|
+
**D1**: Nao remover o dashboard agora. Ele fica legado/opcional para evitar quebra de scripts e preservar historico.
|
|
40
|
+
|
|
41
|
+
**D2**: Backlog RICE nao e modificado ao iniciar sprint. A sprint recebe uma selecao operacional dos P0/P1.
|
|
42
|
+
|
|
43
|
+
## 6. Dependencias
|
|
44
|
+
- Sem novos pacotes.
|
|
45
|
+
- Sem migracao de banco.
|
|
46
|
+
|
|
47
|
+
## 7. Rollout
|
|
48
|
+
- Documentacao atualizada no README, AGENTS e guia CLI-first.
|
|
49
|
+
- Testes de CLI executados localmente.
|
|
50
|
+
|
|
51
|
+
## 8. Sinais de fracasso
|
|
52
|
+
- Operador ainda precisar abrir web para acompanhar sprint.
|
|
53
|
+
- `gsd:check` bloquear tarefa CLI-only por ausencia de brief visual.
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Spec: cli-first-operacao
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-CLI-FIRST-001
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: orchestrator
|
|
6
|
+
- **Criado em**: 2026-06-02
|
|
7
|
+
- **Sprint alvo**: refinamento-cli-2026-06
|
|
8
|
+
- **ADRs relacionadas**: ADR-0005, ADR-0007, ADR-0008
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O projeto tinha forte presenca de dashboard/web e referencias visuais na entrada operacional. Isso poluia a operacao diaria e desviava o uso do objetivo principal: orquestracao, SDD, GSD, sprints e handoffs por comandos.
|
|
12
|
+
|
|
13
|
+
## 2. Proposta de valor
|
|
14
|
+
Operar o framework pelo terminal com sprints, contexto, specs, handoffs, checks e governanca em uma trilha curta e repetivel.
|
|
15
|
+
|
|
16
|
+
## 3. User stories
|
|
17
|
+
- **Como** operador do framework, **quero** acompanhar sprints pelo CLI, **para que** eu nao dependa da web para saber o proximo passo.
|
|
18
|
+
- **Como** Orchestrator, **quero** registrar handoffs GSD pelo CLI, **para que** SDD e governanca tenham rastreabilidade.
|
|
19
|
+
- **Como** Governance, **quero** validar entregas CLI-only sem brief visual, **para que** design nao bloqueie trabalho sem UI.
|
|
20
|
+
|
|
21
|
+
## 4. Criterios de aceite
|
|
22
|
+
- [x] AC-1: `npm run sprint:start/status/complete` funciona no repositorio raiz sem argumento de projeto.
|
|
23
|
+
- [x] AC-2: backlog em tabela RICE gera sprint com itens P0/P1.
|
|
24
|
+
- [x] AC-3: `gsd:check` nao exige brief visual quando a entrega e CLI-only.
|
|
25
|
+
- [x] AC-4: README, AGENTS e docs apontam CLI-first como caminho operacional principal.
|
|
26
|
+
- [x] AC-5: dashboard/web permanece opcional/legado, nao gate operacional.
|
|
27
|
+
- [x] AC-6: `npm run project:check` valida o framework raiz quando chamado sem projeto.
|
|
28
|
+
|
|
29
|
+
## 5. Escopo
|
|
30
|
+
**Dentro**:
|
|
31
|
+
- Scripts de sprint e GSD.
|
|
32
|
+
- Check de governanca do projeto raiz.
|
|
33
|
+
- Documentacao de operacao CLI-first.
|
|
34
|
+
- Reducao de ruido visual no CLI principal.
|
|
35
|
+
|
|
36
|
+
**Fora**:
|
|
37
|
+
- Remover fisicamente o dashboard.
|
|
38
|
+
- Reescrever frontend.
|
|
39
|
+
- Alterar SQLite ou schema de handoffs.
|
|
40
|
+
|
|
41
|
+
## 6. NFRs / restricoes
|
|
42
|
+
- Compatibilidade: manter comandos existentes.
|
|
43
|
+
- Operabilidade: saida de terminal simples, sem depender de browser.
|
|
44
|
+
- Governanca: preservar ADR-0005 e fluxo SDD.
|
|
45
|
+
|
|
46
|
+
## 7. Riscos e mitigacao
|
|
47
|
+
| Risco | Probabilidade | Impacto | Mitigacao |
|
|
48
|
+
|---|---|---|---|
|
|
49
|
+
| Usuarios ainda abrirem dashboard por habito | M | B | README e AGENTS priorizam CLI-first |
|
|
50
|
+
| Sprint duplicar itens de backlog RICE | B | B | Tabela RICE nao e removida; sprint vira selecao operacional |
|
|
51
|
+
|
|
52
|
+
## 8. Metricas de sucesso
|
|
53
|
+
Em 30 dias, 90% das execucoes de sprint e handoff devem ser feitas por CLI, com `gsd:check` e `project:check` usados antes de entrega.
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Tasks: cli-first-operacao
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-06-02
|
|
7
|
+
|
|
8
|
+
## T1 - Corrigir sprint CLI
|
|
9
|
+
- **Owner**: Worker
|
|
10
|
+
- **Estimativa**: P
|
|
11
|
+
- **Depende de**: -
|
|
12
|
+
- **Paths**: `scripts/sprint-manager.js`, `package.json`
|
|
13
|
+
- **Done quando**:
|
|
14
|
+
- [x] sprint funciona no repositorio raiz sem projeto
|
|
15
|
+
- [x] backlog RICE P0/P1 gera itens de sprint
|
|
16
|
+
- [x] `sprint:complete` esta exposto no npm
|
|
17
|
+
|
|
18
|
+
## T2 - Ajustar GSD CLI-only
|
|
19
|
+
- **Owner**: Worker
|
|
20
|
+
- **Estimativa**: P
|
|
21
|
+
- **Depende de**: T1
|
|
22
|
+
- **Paths**: `scripts/agent-harness.mjs`
|
|
23
|
+
- **Done quando**:
|
|
24
|
+
- [x] `gsd:check <slug>` nao falha por ausencia de brief visual
|
|
25
|
+
|
|
26
|
+
## T3 - Reduzir ruido do CLI
|
|
27
|
+
- **Owner**: Worker
|
|
28
|
+
- **Estimativa**: P
|
|
29
|
+
- **Depende de**: -
|
|
30
|
+
- **Paths**: `scripts/dev.mjs`
|
|
31
|
+
- **Done quando**:
|
|
32
|
+
- [x] help e checks usam texto simples
|
|
33
|
+
|
|
34
|
+
## T4 - Documentar operacao
|
|
35
|
+
- **Owner**: Orchestrator
|
|
36
|
+
- **Estimativa**: P
|
|
37
|
+
- **Depende de**: T1, T2
|
|
38
|
+
- **Paths**: `README.md`, `AGENTS.md`, `docs/cli-first-operacao.md`, `docs/quick-reference.md`, `memory/50-orchestration/gsd-harness.md`
|
|
39
|
+
- **Done quando**:
|
|
40
|
+
- [x] CLI-first e caminho principal documentado
|
|
41
|
+
- [x] dashboard descrito como opcional/legado
|
|
42
|
+
|
|
43
|
+
## T5 - Corrigir gate de governanca raiz
|
|
44
|
+
- **Owner**: Governance
|
|
45
|
+
- **Estimativa**: P
|
|
46
|
+
- **Depende de**: T4
|
|
47
|
+
- **Paths**: `scripts/check-standards.js`
|
|
48
|
+
- **Done quando**:
|
|
49
|
+
- [x] `npm run project:check` valida o framework raiz sem exigir nome de projeto
|
|
50
|
+
- [x] saida usa texto simples
|
|
51
|
+
|
|
52
|
+
## Handoffs entre agentes
|
|
53
|
+
Fluxo aplicavel: Product -> SDD Architect -> Worker -> Governance via `npm run gsd:handoff -- <fase> cli-first-operacao`.
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Plan: dev-token-assets-db
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-06-02
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem tecnica
|
|
8
|
+
Adicionar comandos CLI pequenos e aditivos. `context-ops.mjs` gera artefatos compactos e mede token budget. `memory-schema.mjs` cria tabelas auxiliares no SQLite sem alterar contratos existentes. O catalogo de boilerplates/design e derivado dos arquivos atuais, evitando manutencao manual inicial.
|
|
9
|
+
|
|
10
|
+
## 2. Modulos afetados
|
|
11
|
+
| Caminho | Mudanca | Risco |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `scripts/context-ops.mjs` | novo CLI para budget, sprint pack, brief e catalogo | M |
|
|
14
|
+
| `scripts/memory-schema.mjs` | novo schema auxiliar SQLite | M |
|
|
15
|
+
| `package.json` | expor scripts operacionais | B |
|
|
16
|
+
| `docs/manual-operacional-cli-sdd-gsd.md` | orientar nova rotina | B |
|
|
17
|
+
| `.context/` | novos artefatos gerados | B |
|
|
18
|
+
|
|
19
|
+
## 3. Fluxo
|
|
20
|
+
```text
|
|
21
|
+
context:sprint
|
|
22
|
+
-> le sprint, specs, handoffs, ADRs
|
|
23
|
+
-> gera .context/sprint-pack.md
|
|
24
|
+
-> registra context_run no SQLite
|
|
25
|
+
|
|
26
|
+
agent:brief <role> <slug>
|
|
27
|
+
-> le spec/plan/tasks/runbook/handoffs
|
|
28
|
+
-> gera .context/agent-brief-<role>-<slug>.md
|
|
29
|
+
|
|
30
|
+
context:budget <slug|arquivo>
|
|
31
|
+
-> estima tokens
|
|
32
|
+
-> compara com limite
|
|
33
|
+
-> falha se exceder
|
|
34
|
+
|
|
35
|
+
catalog:assets
|
|
36
|
+
-> varre boilerplates/design-md
|
|
37
|
+
-> gera .context/asset-catalog.md
|
|
38
|
+
-> popula asset_catalog
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## 4. Contratos
|
|
42
|
+
```bash
|
|
43
|
+
npm run memory:schema
|
|
44
|
+
npm run context:budget -- <slug|arquivo> [limite]
|
|
45
|
+
npm run context:sprint
|
|
46
|
+
npm run agent:brief -- <role> <slug>
|
|
47
|
+
npm run catalog:assets
|
|
48
|
+
npm run token:benchmark
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 5. Decisoes
|
|
52
|
+
**D1**: Usar SQLite relacional auxiliar em vez de embeddings nesta fase. Motivo: menor complexidade e sem dependencia externa.
|
|
53
|
+
|
|
54
|
+
**D2**: Catalogo gerado, nao escrito manualmente. Motivo: reduz drift.
|
|
55
|
+
|
|
56
|
+
**D3**: Budget por estimativa simples `chars / 4`. Motivo: suficiente para gate operacional e sem dependencia de tokenizer.
|
|
57
|
+
|
|
58
|
+
## 6. Dependencias
|
|
59
|
+
- `better-sqlite3`, ja existente.
|
|
60
|
+
- Sem rede e sem pacotes novos.
|
|
61
|
+
|
|
62
|
+
## 7. Rollout
|
|
63
|
+
- Criar schema auxiliar.
|
|
64
|
+
- Gerar sprint pack e asset catalog.
|
|
65
|
+
- Rodar budget nos novos artefatos.
|
|
66
|
+
- Atualizar manual.
|
|
67
|
+
|
|
68
|
+
## 8. Sinais de fracasso
|
|
69
|
+
- Context pack ultrapassar 8k tokens sem motivo.
|
|
70
|
+
- Agent brief repetir spec inteira.
|
|
71
|
+
- Catalogo exigir manutencao manual constante.
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Spec: dev-token-assets-db
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-DEV-TOKEN-ASSETS-001
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: orchestrator
|
|
6
|
+
- **Criado em**: 2026-06-02
|
|
7
|
+
- **Sprint alvo**: refinamento-cli-2026-06
|
|
8
|
+
- **ADRs relacionadas**: ADR-0003, ADR-0005, ADR-0007, ADR-0008, ADR-0009
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O framework ja possui SDD, GSD, memoria SQLite, boilerplates e design-md, mas ainda consome contexto demais porque nao ha gate de budget por tarefa, resumo compacto por sprint, brief de agente ou catalogo operacional dos assets. Boilerplates e design system tambem existem como arquivos soltos, sem indice consultavel no banco.
|
|
12
|
+
|
|
13
|
+
## 2. Proposta de valor
|
|
14
|
+
Transformar contexto, boilerplates, referencias de design e metadados de specs em ativos operacionais compactos, consultaveis por CLI e armazenaveis no SQLite, reduzindo tokens e aumentando velocidade de desenvolvimento.
|
|
15
|
+
|
|
16
|
+
## 3. User stories
|
|
17
|
+
- **Como** Orchestrator, **quero** gerar um sprint pack compacto, **para que** qualquer agente comece com contexto minimo suficiente.
|
|
18
|
+
- **Como** Worker, **quero** receber um agent brief por papel e feature, **para que** eu nao precise carregar spec/plan/tasks inteiros sempre.
|
|
19
|
+
- **Como** Governance, **quero** bloquear contextos acima do budget, **para que** a operacao nao desperdice tokens.
|
|
20
|
+
- **Como** Architect, **quero** catalogar boilerplates e referencias de design, **para que** a escolha de base tecnica/visual seja rastreavel.
|
|
21
|
+
- **Como** operador do framework, **quero** metadados no SQLite, **para que** memoria, specs e assets sejam consultaveis sem varrer o repositorio inteiro.
|
|
22
|
+
|
|
23
|
+
## 4. Criterios de aceite
|
|
24
|
+
- [x] AC-1: `npm run context:budget -- <slug|arquivo>` estima tokens e falha acima do limite.
|
|
25
|
+
- [x] AC-2: `npm run context:sprint` gera `.context/sprint-pack.md`.
|
|
26
|
+
- [x] AC-3: `npm run agent:brief -- <role> <slug>` gera brief compacto por papel.
|
|
27
|
+
- [x] AC-4: `npm run catalog:assets` gera catalogo de boilerplates/design-md.
|
|
28
|
+
- [x] AC-5: `npm run memory:schema` cria tabelas auxiliares para summaries, context runs e asset catalog.
|
|
29
|
+
- [x] AC-6: boilerplates tem manifests padronizados com stack, casos de uso, comandos e gates.
|
|
30
|
+
- [x] AC-7: design-md tem tokens/padroes normalizados por superficie.
|
|
31
|
+
- [x] AC-8: `sync:universal` popula tabelas auxiliares automaticamente.
|
|
32
|
+
|
|
33
|
+
## 5. Escopo
|
|
34
|
+
**Dentro**:
|
|
35
|
+
- CLI para budget, sprint pack, agent brief e catalogo.
|
|
36
|
+
- Schema auxiliar SQLite para armazenamento melhor.
|
|
37
|
+
- Documentacao operacional da estrategia.
|
|
38
|
+
|
|
39
|
+
**Fora**:
|
|
40
|
+
- Reescrever todos os boilerplates nesta primeira tranche.
|
|
41
|
+
- Migrar dashboard web.
|
|
42
|
+
- Implementar embeddings vetoriais.
|
|
43
|
+
|
|
44
|
+
## 6. NFRs / restricoes
|
|
45
|
+
- Compatibilidade: manter scripts existentes.
|
|
46
|
+
- Token economy: contextos operacionais devem ficar abaixo de 8k tokens por padrao.
|
|
47
|
+
- Banco: tabelas novas devem ser aditivas, sem quebrar `memory_nodes` ou `handoffs`.
|
|
48
|
+
- Operacao: tudo deve rodar por CLI.
|
|
49
|
+
|
|
50
|
+
## 7. Riscos e mitigacao
|
|
51
|
+
| Risco | Probabilidade | Impacto | Mitigacao |
|
|
52
|
+
|---|---|---|---|
|
|
53
|
+
| Catalogo virar mais uma fonte duplicada | M | M | Gerar via CLI a partir dos arquivos reais |
|
|
54
|
+
| Budget bloquear contexto necessario | M | B | Permitir limite customizado por argumento |
|
|
55
|
+
| Schema auxiliar ficar desssincronizado | M | M | Planejar AC-8 para integrar ao sync |
|
|
56
|
+
|
|
57
|
+
## 8. Metricas de sucesso
|
|
58
|
+
Em 30 dias, reduzir em pelo menos 40% o tamanho medio do contexto inicial por tarefa e manter `context:budget` verde em entregas novas.
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Tasks: dev-token-assets-db
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-06-02
|
|
7
|
+
|
|
8
|
+
## T1 - Schema auxiliar de memoria
|
|
9
|
+
- **Owner**: Worker
|
|
10
|
+
- **Estimativa**: P
|
|
11
|
+
- **Depende de**: -
|
|
12
|
+
- **Paths**: `scripts/memory-schema.mjs`
|
|
13
|
+
- **Done quando**:
|
|
14
|
+
- [x] cria `spec_summaries`
|
|
15
|
+
- [x] cria `context_runs`
|
|
16
|
+
- [x] cria `asset_catalog`
|
|
17
|
+
|
|
18
|
+
## T2 - Operacoes de contexto/token
|
|
19
|
+
- **Owner**: Worker
|
|
20
|
+
- **Estimativa**: M
|
|
21
|
+
- **Depende de**: T1
|
|
22
|
+
- **Paths**: `scripts/context-ops.mjs`, `package.json`
|
|
23
|
+
- **Done quando**:
|
|
24
|
+
- [x] `context:budget` mede tokens
|
|
25
|
+
- [x] `context:sprint` gera sprint pack
|
|
26
|
+
- [x] `agent:brief` gera brief por papel/slug
|
|
27
|
+
- [x] `catalog:assets` cataloga boilerplates/design-md
|
|
28
|
+
- [x] `token:benchmark` esta exposto
|
|
29
|
+
|
|
30
|
+
## T3 - Melhorar boilerplates
|
|
31
|
+
- **Owner**: SDD Architect
|
|
32
|
+
- **Estimativa**: M
|
|
33
|
+
- **Depende de**: T2
|
|
34
|
+
- **Paths**: `boilerplates/**`
|
|
35
|
+
- **Done quando**:
|
|
36
|
+
- [x] cada boilerplate tem manifesto padrao
|
|
37
|
+
- [x] cada manifesto descreve stack, comandos, gates, tokens e casos de uso
|
|
38
|
+
|
|
39
|
+
## T4 - Melhorar design system
|
|
40
|
+
- **Owner**: SDD Architect
|
|
41
|
+
- **Estimativa**: M
|
|
42
|
+
- **Depende de**: T2
|
|
43
|
+
- **Paths**: `design-md/**`
|
|
44
|
+
- **Done quando**:
|
|
45
|
+
- [x] referencias tem metadados normalizados por superficie
|
|
46
|
+
- [x] tokens visuais recomendados ficam consultaveis pelo catalogo
|
|
47
|
+
|
|
48
|
+
## T5 - Integrar sync do banco
|
|
49
|
+
- **Owner**: Worker
|
|
50
|
+
- **Estimativa**: M
|
|
51
|
+
- **Depende de**: T1, T2
|
|
52
|
+
- **Paths**: `scripts/sync-universal-memory.js`
|
|
53
|
+
- **Done quando**:
|
|
54
|
+
- [x] sync popula tabelas auxiliares sem comando separado
|
|
55
|
+
- [x] schema continua aditivo e compativel
|
|
56
|
+
|
|
57
|
+
## Handoffs entre agentes
|
|
58
|
+
Use `npm run gsd:handoff -- implement dev-token-assets-db` para primeira tranche e `npm run gsd:handoff -- review dev-token-assets-db` antes de governanca.
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Spec: forja-core
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-025
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: framework-team
|
|
6
|
+
- **Criado em**: 2026-07-06
|
|
7
|
+
- **Sprint alvo**: core-2026-07
|
|
8
|
+
- **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
|
|
12
|
+
|
|
13
|
+
1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
|
|
14
|
+
2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
|
|
15
|
+
3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
|
|
16
|
+
|
|
17
|
+
Consequências mensuráveis:
|
|
18
|
+
- Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
|
|
19
|
+
- Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
|
|
20
|
+
- O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
|
|
21
|
+
- Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
|
|
22
|
+
|
|
23
|
+
## 2. Proposta de valor
|
|
24
|
+
Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
|
|
25
|
+
|
|
26
|
+
## 3. User stories
|
|
27
|
+
- **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
|
|
28
|
+
- **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
|
|
29
|
+
- **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
|
|
30
|
+
- **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
|
|
31
|
+
|
|
32
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
33
|
+
- [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
|
|
34
|
+
- [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
|
|
35
|
+
- [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
|
|
36
|
+
- [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
|
|
37
|
+
- [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
|
|
38
|
+
- [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
|
|
39
|
+
- [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
|
|
40
|
+
|
|
41
|
+
## 5. Escopo
|
|
42
|
+
**Dentro**:
|
|
43
|
+
- `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
|
|
44
|
+
- `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
|
|
45
|
+
- `scripts/agent-harness.mjs`: ficha automática no `project:new`
|
|
46
|
+
- `test/forja-core.test.js`
|
|
47
|
+
- README/DOC-MAP: documentar o core como ponto de entrada
|
|
48
|
+
|
|
49
|
+
**Fora** (explícito, evita scope creep):
|
|
50
|
+
- Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
|
|
51
|
+
- Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
|
|
52
|
+
- Dashboard (`dashboard:*`) — front opcional, fora do processo
|
|
53
|
+
- Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
|
|
54
|
+
|
|
55
|
+
## 6. NFRs / restrições
|
|
56
|
+
- Zero dependências novas (Node stdlib apenas).
|
|
57
|
+
- Overhead do roteamento imperceptível (< 100ms além do script alvo).
|
|
58
|
+
- Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
|
|
59
|
+
- Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
|
|
60
|
+
- pt-BR em toda saída de CLI.
|
|
61
|
+
|
|
62
|
+
## 7. Riscos e mitigação
|
|
63
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
+
|---|---|---|---|
|
|
65
|
+
| Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
|
|
66
|
+
| Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
|
|
67
|
+
| Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
|
|
68
|
+
| JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
|
|
69
|
+
|
|
70
|
+
## 8. Métricas de sucesso
|
|
71
|
+
30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Spec: harness-codegraph
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-024
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: framework-team
|
|
6
|
+
- **Criado em**: 2026-06-27
|
|
7
|
+
- **Sprint alvo**: harness-2026-06
|
|
8
|
+
- **ADRs relacionadas**: ADR-0017 (codegraph no harness GSD), ADR-0018 (ferramentas de processo)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O harness GSD/Hermes está sólido (10 gates, handoffs de 7 campos), mas três furos impedem que ele seja a base confiável dos próximos projetos:
|
|
12
|
+
|
|
13
|
+
1. **Codegraph é uma integração pendurada.** Está instalado (`~/.local/bin/codegraph`), com MCP em `.mcp.json` e scripts `code:*`, mas **nenhum gate do GSD e nenhum papel o usa**. O Worker recebe "implemente `tasks.md`" sem nunca consultar o blast radius de um símbolo antes de editar.
|
|
14
|
+
2. **O índice codegraph apontava para o worktree errado** (`2-Projeto-Agents` pai em vez de `projects/forja`), retornando símbolos da árvore errada — silenciosamente.
|
|
15
|
+
3. **O gerador (`bin/init-project.js` + `lib/generators/`) não emite nada disso.** Projetos novos não herdam `.mcp.json`, scripts `code:*`, o `agent-harness.mjs` nem os gates GSD. A estrutura morre no framework-raiz.
|
|
16
|
+
|
|
17
|
+
Mede-se hoje a dor pela ausência: zero consultas codegraph nos handoffs registrados, zero gates de código, e `codegraph status` emitindo warning de worktree.
|
|
18
|
+
|
|
19
|
+
## 2. Proposta de valor
|
|
20
|
+
O codegraph vira **passo verificável do fluxo GSD** (mapa de impacto antes de implementar, freshness no gate de governança), e todo projeto gerado herda o harness completo — codegraph, `code:*`, GSD e ferramentas de processo — sem configuração manual.
|
|
21
|
+
|
|
22
|
+
## 3. User stories
|
|
23
|
+
- **Como** SDD Architect, **quero** rodar `code:impact <símbolo>` para ver chamadores e blast radius, **para que** o `plan.md` liste módulos afetados com evidência, não chute
|
|
24
|
+
- **Como** Worker, **quero** que o runbook GSD me obrigue a mapear impacto antes de editar, **para que** eu não quebre chamadores fora do escopo
|
|
25
|
+
- **Como** Governance, **quero** que `gsd:check` falhe se o índice codegraph estiver no worktree errado ou defasado, **para que** consultas de código sejam confiáveis no review
|
|
26
|
+
- **Como** usuário gerando projeto novo, **quero** que `init-project` já entregue `.mcp.json` + `code:*` + GSD, **para que** o novo projeto nasça com o harness completo
|
|
27
|
+
- **Como** Governance, **quero** um `tools:doctor` que detecta ferramentas de processo (codegraph, gitleaks, ast-grep, lefthook), **para que** eu saiba o que está disponível antes de exigir um gate
|
|
28
|
+
|
|
29
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
30
|
+
- [x] AC-1: `npm run code:check` valida que o índice codegraph existe, pertence a este worktree e não está defasado; exit≠0 caso contrário
|
|
31
|
+
- [x] AC-2: `npm run code:impact <símbolo>` retorna chamadores + arquivos afetados (via codegraph), com fallback claro se o binário não existir
|
|
32
|
+
- [x] AC-3: o runbook gerado por `gsd:plan` inclui um gate "Mapa de impacto (codegraph)" entre Contexto e Plano
|
|
33
|
+
- [x] AC-4: `gsd:check` inclui um gate de freshness/worktree do codegraph (não-bloqueante se codegraph ausente, bloqueante se índice for de outro worktree)
|
|
34
|
+
- [x] AC-5: `init-project` emite no projeto gerado: `.mcp.json` (codegraph), scripts `code:*` e `gsd:*` no `package.json`, e `scripts/agent-harness.mjs`
|
|
35
|
+
- [x] AC-6: `npm run tools:doctor` lista status (instalado/ausente) de codegraph, gitleaks, ast-grep, lefthook, markdownlint
|
|
36
|
+
- [x] AC-7: sub-agents `sdd-architect` e `governance` (+ prompts) instruem uso de codegraph; docs (`AGENTS.md`, `agent-harnesses.md`, `gsd-harness.md`, manual) atualizadas
|
|
37
|
+
- [x] AC-8: `npm test` cobre `code:check`/`code:impact`/`tools:doctor` com degradação graciosa quando binários ausentes
|
|
38
|
+
|
|
39
|
+
## 5. Escopo
|
|
40
|
+
**Dentro**:
|
|
41
|
+
- `scripts/agent-harness.mjs`: comandos `code:impact`, `code:check`
|
|
42
|
+
- `scripts/tools-doctor.mjs`: doctor de ferramentas de processo
|
|
43
|
+
- `package.json`: scripts `code:impact`, `code:check`, `tools:doctor`
|
|
44
|
+
- Template do runbook GSD + lógica do `gsd:check`
|
|
45
|
+
- `bin/init-project.js` / `lib/generators/`: emissão do harness no projeto gerado
|
|
46
|
+
- `.claude/agents/` + `prompts/` (sdd-architect, governance)
|
|
47
|
+
- Docs: `AGENTS.md`, `docs/agent-harnesses.md`, `memory/50-orchestration/gsd-harness.md`, manual
|
|
48
|
+
- ADR-0017 e ADR-0018
|
|
49
|
+
|
|
50
|
+
**Fora** (explícito, evita scope creep):
|
|
51
|
+
- Reescrever o codegraph ou criar índice próprio (usamos o binário externo)
|
|
52
|
+
- Instalar automaticamente gitleaks/ast-grep/lefthook (apenas detectar + documentar)
|
|
53
|
+
- Tornar design:check obrigatório em fluxo CLI-only (mantém ADR vigente)
|
|
54
|
+
- Mexer em `projects/` (apps reais, off-limits)
|
|
55
|
+
|
|
56
|
+
## 6. NFRs / restrições
|
|
57
|
+
- Degradação graciosa: nenhum comando novo pode quebrar o fluxo quando codegraph/ferramentas externas não estão instaladas — deve avisar e seguir
|
|
58
|
+
- Determinístico: `code:check`/`tools:doctor` não dependem de rede
|
|
59
|
+
- Compatibilidade: não quebra `init-project.js` para quem não usa codegraph; `.mcp.json` é aditivo
|
|
60
|
+
- pt-BR em toda saída de CLI
|
|
61
|
+
|
|
62
|
+
## 7. Riscos e mitigação
|
|
63
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
+
|---|---|---|---|
|
|
65
|
+
| codegraph ausente no ambiente do usuário | M | M | `code:*` degrada com aviso; gate não-bloqueante quando binário falta |
|
|
66
|
+
| Falso bloqueio por índice "defasado" | M | A | Heurística por mtime + warning de worktree do próprio codegraph, nunca por hash de cada arquivo |
|
|
67
|
+
| Gerador inchar projetos que não querem codegraph | B | M | `.mcp.json` e gates são aditivos e documentados como opcionais |
|
|
68
|
+
| Acoplar harness a versão específica do codegraph CLI | M | M | Usar só `init/status/sync` + MCP; parsear saída de forma tolerante |
|
|
69
|
+
|
|
70
|
+
## 8. Métricas de sucesso
|
|
71
|
+
30 dias após o release: (a) 100% dos projetos novos gerados saem com `.mcp.json` + `code:*` + GSD; (b) `gsd:check` passando inclui o gate codegraph; (c) pelo menos os papéis Architect/Worker referenciam `code:impact` nos handoffs de implementação registrados no SQLite.
|