forjajs 5.0.1 → 5.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.
Files changed (164) hide show
  1. package/CHANGELOG.md +38 -2
  2. package/README.md +4 -2
  3. package/README.pt-BR.md +4 -1
  4. package/boilerplates/02-saas-starter/README.md +58 -293
  5. package/boilerplates/02-saas-starter/backend/.env.example +13 -0
  6. package/boilerplates/02-saas-starter/backend/.oxlintrc.json +8 -0
  7. package/boilerplates/02-saas-starter/backend/nest-cli.json +6 -0
  8. package/boilerplates/02-saas-starter/backend/package.json +32 -73
  9. package/boilerplates/02-saas-starter/backend/src/app.module.ts +16 -16
  10. package/boilerplates/02-saas-starter/backend/src/billing/adapters/http/billing.controller.ts +55 -0
  11. package/boilerplates/02-saas-starter/backend/src/billing/adapters/persistence/orm-entities.ts +28 -0
  12. package/boilerplates/02-saas-starter/backend/src/billing/adapters/persistence/typeorm-billing.repository.ts +46 -0
  13. package/boilerplates/02-saas-starter/backend/src/billing/application/billing.service.spec.ts +58 -0
  14. package/boilerplates/02-saas-starter/backend/src/billing/application/billing.service.ts +68 -0
  15. package/boilerplates/02-saas-starter/backend/src/billing/billing.module.ts +11 -0
  16. package/boilerplates/02-saas-starter/backend/src/billing/domain/plan.spec.ts +23 -0
  17. package/boilerplates/02-saas-starter/backend/src/billing/domain/plan.ts +36 -0
  18. package/boilerplates/02-saas-starter/backend/src/billing/domain/ports.ts +27 -0
  19. package/boilerplates/02-saas-starter/backend/src/billing/domain/subscription.spec.ts +28 -0
  20. package/boilerplates/02-saas-starter/backend/src/billing/domain/subscription.ts +47 -0
  21. package/boilerplates/02-saas-starter/backend/src/identity/adapters/http/auth.dto.ts +22 -0
  22. package/boilerplates/02-saas-starter/backend/src/identity/adapters/http/identity.controller.ts +59 -0
  23. package/boilerplates/02-saas-starter/backend/src/identity/adapters/persistence/orm-entities.ts +25 -0
  24. package/boilerplates/02-saas-starter/backend/src/identity/adapters/persistence/typeorm-identity.repository.ts +47 -0
  25. package/boilerplates/02-saas-starter/backend/src/identity/application/auth.service.spec.ts +72 -0
  26. package/boilerplates/02-saas-starter/backend/src/identity/application/auth.service.ts +63 -0
  27. package/boilerplates/02-saas-starter/backend/src/identity/domain/model.spec.ts +19 -0
  28. package/boilerplates/02-saas-starter/backend/src/identity/domain/model.ts +42 -0
  29. package/boilerplates/02-saas-starter/backend/src/identity/domain/password.spec.ts +17 -0
  30. package/boilerplates/02-saas-starter/backend/src/identity/domain/password.ts +26 -0
  31. package/boilerplates/02-saas-starter/backend/src/identity/identity.module.ts +12 -0
  32. package/boilerplates/02-saas-starter/backend/src/main.ts +19 -19
  33. package/boilerplates/02-saas-starter/backend/src/platform/auth/jwt-auth.guard.ts +17 -0
  34. package/boilerplates/02-saas-starter/backend/src/platform/auth/principal.ts +22 -0
  35. package/boilerplates/02-saas-starter/backend/src/platform/auth/roles.guard.spec.ts +23 -0
  36. package/boilerplates/02-saas-starter/backend/src/platform/auth/roles.guard.ts +20 -0
  37. package/boilerplates/02-saas-starter/backend/src/platform/auth/token.service.ts +54 -0
  38. package/boilerplates/02-saas-starter/backend/src/platform/config.spec.ts +18 -0
  39. package/boilerplates/02-saas-starter/backend/src/platform/config.ts +33 -0
  40. package/boilerplates/02-saas-starter/backend/src/platform/platform.module.ts +14 -0
  41. package/boilerplates/02-saas-starter/backend/tsconfig.build.json +6 -0
  42. package/boilerplates/02-saas-starter/backend/tsconfig.json +16 -21
  43. package/boilerplates/02-saas-starter/backend/vitest.config.ts +7 -0
  44. package/boilerplates/02-saas-starter/boilerplate.manifest.json +19 -14
  45. package/boilerplates/02-saas-starter/docker-compose.yml +10 -24
  46. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +15 -132
  47. package/boilerplates/02-saas-starter/memory/30-domains/identity/context.md +20 -0
  48. package/boilerplates/README.md +9 -10
  49. package/dist/bin/init-project.js +1 -0
  50. package/dist/lib/core/journey.js +10 -0
  51. package/dist/lib/generators/memory-generator.d.ts +0 -11
  52. package/dist/lib/generators/memory-generator.js +5 -161
  53. package/dist/lib/generators/readme-generator.js +1 -1
  54. package/dist/lib/llm/json-output.d.ts +14 -0
  55. package/dist/lib/llm/json-output.js +77 -0
  56. package/dist/lib/project-wiring.d.ts +8 -0
  57. package/dist/lib/project-wiring.js +74 -2
  58. package/dist/lib/validators/structure-validator.js +0 -1
  59. package/dist/packages/llm/src/index.js +12 -2
  60. package/dist/scripts/llm-fit.js +23 -1
  61. package/docs/llm-fit-loop.md +16 -0
  62. package/memory/90-decisions/0088-templates-validados.md +3 -0
  63. package/memory/90-decisions/0089-skills-do-projeto.md +51 -0
  64. package/memory/90-decisions/0090-adapters-de-agente-somente-leitura.md +47 -0
  65. package/package.json +1 -1
  66. package/specs/skills-do-projeto/plan.md +40 -0
  67. package/specs/skills-do-projeto/spec.md +63 -0
  68. package/specs/skills-do-projeto/tasks.md +27 -0
  69. package/templates/project/AGENTS.md +9 -0
  70. package/templates/project/agents/context-engineer.md +3 -0
  71. package/templates/project/agents/governance.md +3 -0
  72. package/templates/project/agents/marketing.md +3 -0
  73. package/templates/project/agents/orchestrator.md +3 -0
  74. package/templates/project/agents/product.md +3 -0
  75. package/templates/project/agents/sdd-architect.md +3 -0
  76. package/templates/project/skills/README.md +14 -0
  77. package/templates/project/skills/accessibility-review/SKILL.md +89 -0
  78. package/templates/project/skills/api-design/SKILL.md +77 -0
  79. package/templates/project/skills/architecture-decision-record/SKILL.md +92 -0
  80. package/templates/project/skills/backlog-slicing/SKILL.md +82 -0
  81. package/templates/project/skills/bounded-context-mapping/SKILL.md +88 -0
  82. package/templates/project/skills/ci-pipeline-review/SKILL.md +83 -0
  83. package/templates/project/skills/commit-message/SKILL.md +143 -0
  84. package/templates/project/skills/data-migrations/SKILL.md +88 -0
  85. package/templates/project/skills/dependency-upgrade/SKILL.md +75 -0
  86. package/templates/project/skills/docker-compose-review/SKILL.md +85 -0
  87. package/templates/project/skills/domain-modeling/SKILL.md +120 -0
  88. package/templates/project/skills/event-storming/SKILL.md +95 -0
  89. package/templates/project/skills/executive-writing/SKILL.md +99 -0
  90. package/templates/project/skills/frontend-architecture/SKILL.md +97 -0
  91. package/templates/project/skills/incident-postmortem/SKILL.md +93 -0
  92. package/templates/project/skills/lgpd-compliance/SKILL.md +108 -0
  93. package/templates/project/skills/llm-provider-routing/SKILL.md +18 -0
  94. package/templates/project/skills/observability/SKILL.md +93 -0
  95. package/templates/project/skills/product-evaluation/SKILL.md +130 -0
  96. package/templates/project/skills/prompt-spec/SKILL.md +83 -0
  97. package/templates/project/skills/pull-request/SKILL.md +101 -0
  98. package/templates/project/skills/query-performance/SKILL.md +83 -0
  99. package/templates/project/skills/release-checklist/SKILL.md +106 -0
  100. package/templates/project/skills/release-notes/SKILL.md +87 -0
  101. package/templates/project/skills/requirements-elicitation/SKILL.md +127 -0
  102. package/templates/project/skills/requirements-gathering/SKILL.md +134 -0
  103. package/templates/project/skills/technical-spike/SKILL.md +101 -0
  104. package/templates/project/skills/testing/SKILL.md +109 -0
  105. package/templates/project/skills/threat-modeling/SKILL.md +87 -0
  106. package/templates/project/skills/ts-async-patterns/SKILL.md +101 -0
  107. package/templates/project/skills/ts-code-review/SKILL.md +121 -0
  108. package/templates/project/skills/ts-module-layout/SKILL.md +104 -0
  109. package/templates/project/skills/ts-testing/SKILL.md +89 -0
  110. package/templates/project/skills/web-performance/SKILL.md +72 -0
  111. package/boilerplates/02-saas-starter/.env.example +0 -25
  112. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +0 -190
  113. package/boilerplates/02-saas-starter/INFO.md +0 -252
  114. package/boilerplates/02-saas-starter/QUICK_START.md +0 -194
  115. package/boilerplates/02-saas-starter/START-HERE.md +0 -259
  116. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +0 -3
  117. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +0 -6
  118. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +0 -23
  119. package/boilerplates/02-saas-starter/backend/src/config/database.ts +0 -26
  120. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +0 -46
  121. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +0 -25
  122. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +0 -145
  123. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +0 -30
  124. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +0 -24
  125. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +0 -19
  126. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +0 -42
  127. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +0 -13
  128. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +0 -67
  129. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +0 -52
  130. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +0 -36
  131. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +0 -16
  132. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +0 -13
  133. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +0 -34
  134. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +0 -40
  135. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +0 -36
  136. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +0 -13
  137. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +0 -91
  138. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +0 -42
  139. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +0 -14
  140. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +0 -13
  141. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +0 -48
  142. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +0 -227
  143. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +0 -141
  144. package/boilerplates/02-saas-starter/memory/00-global/index.md +0 -133
  145. package/boilerplates/02-saas-starter/memory/00-global/mission.md +0 -45
  146. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +0 -223
  147. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +0 -240
  148. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +0 -239
  149. package/boilerplates/02-saas-starter/memory/10-product/personas.md +0 -195
  150. package/boilerplates/02-saas-starter/memory/10-product/vision.md +0 -63
  151. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +0 -232
  152. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +0 -186
  153. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +0 -85
  154. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +0 -262
  155. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +0 -176
  156. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +0 -100
  157. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +0 -81
  158. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +0 -97
  159. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +0 -57
  160. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +0 -90
  161. package/boilerplates/02-saas-starter/memory/60-runs/index.md +0 -54
  162. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +0 -50
  163. package/boilerplates/02-saas-starter/memory/80-data/schema.md +0 -185
  164. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +0 -75
@@ -31,6 +31,34 @@ export const INSTRUCTION_FILE = {
31
31
  };
32
32
  const CODEX_MCP = '# Forja — servidor MCP (forja project:wire)\n[mcp_servers.forja]\ncommand = "forja"\nargs = ["mcp:start"]\n';
33
33
  const GITIGNORE = ['memory/sqlite/', '.context/'];
34
+ /**
35
+ * Skills do projeto (SPEC-051): pastas com SKILL.md em templates/project/skills/, instaladas onde cada
36
+ * IA as procura sozinha. Codex e o padrão comum entre ferramentas leem `.agents/skills/`.
37
+ */
38
+ export const SKILL_TARGETS = {
39
+ claude: path.join('.claude', 'skills'),
40
+ codex: path.join('.agents', 'skills'),
41
+ };
42
+ export function templateSkills() {
43
+ const dir = asset('templates', 'project', 'skills');
44
+ try {
45
+ return fs.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
46
+ }
47
+ catch {
48
+ return [];
49
+ }
50
+ }
51
+ /** Valida o frontmatter de um SKILL.md: devolve o problema ou null. */
52
+ export function skillProblem(name, text) {
53
+ if (text == null)
54
+ return 'ausente';
55
+ const m = text.match(/^---\nname: ([^\n]+)\ndescription: ([^\n]+)\n/);
56
+ if (!m)
57
+ return 'frontmatter sem name/description';
58
+ if (m[1].trim() !== name)
59
+ return `name "${m[1].trim()}" ≠ pasta`;
60
+ return null;
61
+ }
34
62
  export const ROLES = ['orchestrator', 'product', 'sdd-architect', 'context-engineer', 'governance', 'marketing'];
35
63
  /** Hooks do Claude Code. Guardados por `command -v`: sem `forja` no PATH, a sessão abre sem erro. */
36
64
  export const HOOKS = {
@@ -204,6 +232,21 @@ export function wireProject(dir, opts = {}) {
204
232
  else if (mcp.mcpServers.codegraph && !hasBinary('codegraph'))
205
233
  delete mcp.mcpServers.codegraph;
206
234
  writeJson(dir, '.mcp.json', mcp, changes);
235
+ // Skills: uma cópia por IA conectada que as lê nativamente. Skill editada pelo usuário (sem a marca)
236
+ // não é sobrescrita.
237
+ for (const [agent, target] of Object.entries(SKILL_TARGETS)) {
238
+ if (!ai.includes(agent))
239
+ continue;
240
+ for (const name of templateSkills()) {
241
+ const rel = path.join(target, name, 'SKILL.md');
242
+ const current = readOrNull(path.join(dir, rel));
243
+ if (current != null && !current.includes(AGENT_MARK)) {
244
+ changes.push({ file: rel, action: 'unchanged' });
245
+ continue;
246
+ }
247
+ write(dir, rel, `${template(path.join('skills', name, 'SKILL.md'))}\n\n${AGENT_MARK}\n`, changes);
248
+ }
249
+ }
207
250
  // O mesmo servidor nas outras IAs, cada uma na config de projeto que ela lê sozinha.
208
251
  if (ai.includes('codex')) {
209
252
  const rel = path.join('.codex', 'config.toml');
@@ -360,10 +403,38 @@ export function checkProjectWiring(dir, { commands, ai }) {
360
403
  const others = wiredAi.filter((a) => a !== 'claude');
361
404
  if (others.length)
362
405
  add('mcp-ias', mcpGaps.length ? 'fail' : 'ok', mcpGaps.length ? `servidor forja ausente em: ${mcpGaps.join(', ')}` : `servidor forja também em: ${others.join(', ')}`);
406
+ // Skills: presentes, com frontmatter válido, e citando só skills que existem.
407
+ const expectedSkills = templateSkills();
408
+ const skillTexts = [];
409
+ for (const [agent, target] of Object.entries(SKILL_TARGETS)) {
410
+ if (!wiredAi.includes(agent))
411
+ continue;
412
+ const problems = [];
413
+ const installed = new Set();
414
+ for (const name of expectedSkills) {
415
+ const rel = path.join(target, name, 'SKILL.md');
416
+ const text = readOrNull(path.join(dir, rel));
417
+ const p = skillProblem(name, text);
418
+ if (p)
419
+ problems.push(`${name}: ${p}`);
420
+ else {
421
+ installed.add(name);
422
+ skillTexts.push(rel);
423
+ }
424
+ }
425
+ for (const rel of skillTexts.filter((r) => r.startsWith(target))) {
426
+ const text = readOrNull(path.join(dir, rel)) ?? '';
427
+ for (const ref of text.matchAll(/`([a-z]+(?:-[a-z]+)+)`/g)) {
428
+ if (expectedSkills.includes(ref[1]) && !installed.has(ref[1]))
429
+ problems.push(`${path.basename(path.dirname(rel))} cita ${ref[1]}, ausente`);
430
+ }
431
+ }
432
+ add(`skills-${agent}`, problems.length ? 'fail' : 'ok', problems.length ? `${target}: ${problems.slice(0, 4).join('; ')}${problems.length > 4 ? ` (+${problems.length - 4})` : ''}` : `${installed.size} skills em ${target}`);
433
+ }
363
434
  // Todo comando citado ao usuário/IA precisa existir — é o que impede instrução que não funciona.
364
435
  const cited = new Map();
365
436
  const texts = ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md', path.join('.github', 'copilot-instructions.md'),
366
- ...ROLES.map((r) => path.join('.claude', 'agents', `${r}.md`))];
437
+ ...ROLES.map((r) => path.join('.claude', 'agents', `${r}.md`)), ...skillTexts];
367
438
  for (const rel of texts) {
368
439
  const t = readOrNull(path.join(dir, rel));
369
440
  if (t)
@@ -378,7 +449,8 @@ export function checkProjectWiring(dir, { commands, ai }) {
378
449
  cited.set(c, '.claude/settings.json');
379
450
  }
380
451
  catch { /* já reportado acima */ }
381
- const unknown = [...cited].filter(([c]) => !(c in commands)).map(([c, f]) => `${c} (${f})`);
452
+ // `help` é embutido no core (não está no registry).
453
+ const unknown = [...cited].filter(([c]) => !(c in commands) && c !== 'help').map(([c, f]) => `${c} (${f})`);
382
454
  add('commands', unknown.length ? 'fail' : 'ok', unknown.length ? `comandos inexistentes citados: ${unknown.join(', ')}` : `${cited.size} comandos citados, todos no registry`);
383
455
  const broken = ['.', 'backend'].flatMap((sub) => fs.existsSync(path.join(dir, sub, 'package.json'))
384
456
  ? brokenNodeScripts(path.join(dir, sub)).map((b) => (sub === '.' ? b : `${sub}/${b}`)) : []);
@@ -31,7 +31,6 @@ const CRITICAL_DIRS = [
31
31
  'memory/60-runs',
32
32
  'memory/70-summaries',
33
33
  'agents',
34
- 'skills',
35
34
  'prompts',
36
35
  '.memory/sqlite',
37
36
  ];
@@ -7,6 +7,9 @@ export const DEFAULT_LLM_PROFILES = {
7
7
  claude: { provider: 'claude', model: 'default', command: 'claude', roles: ['sdd-architect', 'product'], taskTypes: ['architecture', 'specification', 'analysis'], privacy: 'external', enabled: true },
8
8
  gemini: { provider: 'gemini-cli', model: 'default', command: 'gemini', roles: ['context-engineer', 'marketing'], taskTypes: ['research', 'context', 'writing'], privacy: 'external', enabled: true },
9
9
  ollama: { provider: 'ollama', model: 'llama3.3', command: 'ollama', roles: [], taskTypes: ['offline', 'sensitive'], privacy: 'local', enabled: false },
10
+ copilot: { provider: 'copilot', model: 'default', command: 'copilot', roles: ['worker'], taskTypes: ['implementation', 'review'], privacy: 'external', enabled: false },
11
+ cursor: { provider: 'cursor-agent', model: 'default', command: 'cursor-agent', roles: ['worker', 'sdd-architect'], taskTypes: ['implementation', 'analysis', 'review'], privacy: 'external', enabled: false },
12
+ opencode: { provider: 'opencode', model: 'default', command: 'opencode', roles: ['worker'], taskTypes: ['implementation', 'analysis'], privacy: 'external', enabled: false },
10
13
  },
11
14
  };
12
15
  export class LlmProfileError extends Error {
@@ -52,12 +55,19 @@ export function buildLlmExecution(profile, prompt, options = {}) {
52
55
  args: [...base, ...(profile.model === 'default' ? [] : ['--model', profile.model]), '-p', prompt,
53
56
  '--output-format', 'json', ...(options.resume ? ['--resume', options.resume] : [])],
54
57
  };
58
+ // Todos os adapters de agente rodam em modo somente leitura/planejamento: o llm:run é supervisionado
59
+ // e quem aplica mudanças é o fluxo do Forja, não o provedor (ADR-0090).
55
60
  if (profile.provider === 'gemini-cli')
56
- return { executable: profile.command, args: [...base, ...(profile.model === 'default' ? [] : ['-m', profile.model]), '-p', prompt] };
61
+ return { executable: profile.command, args: [...base, ...(profile.model === 'default' ? [] : ['-m', profile.model]), '--approval-mode', 'plan', '-o', 'json', '-p', prompt] };
57
62
  if (profile.provider === 'ollama')
58
63
  return { executable: profile.command, args: [...base, 'run', profile.model, prompt] };
64
+ // GitHub Copilot CLI (`copilot`): sem --allow-*, ferramentas que pedem aprovação ficam negadas no modo -p.
59
65
  if (profile.provider === 'copilot')
60
- return { executable: profile.command, args: [...base, 'copilot', 'suggest', '-t', 'shell', prompt] };
66
+ return { executable: profile.command, args: [...base, ...(profile.model === 'default' ? [] : ['--model', profile.model]), '-s', '-p', prompt] };
67
+ if (profile.provider === 'cursor-agent')
68
+ return { executable: profile.command, args: [...base, '-p', '--mode', 'plan', '--output-format', 'json', ...(profile.model === 'default' ? [] : ['--model', profile.model]), prompt] };
69
+ if (profile.provider === 'opencode')
70
+ return { executable: profile.command, args: ['run', ...base, '--agent', 'plan', ...(profile.model === 'default' ? [] : ['-m', profile.model]), prompt] };
61
71
  return { executable: profile.command, args: [...base, prompt] };
62
72
  }
63
73
  /** Grace period after SIGTERM before a timed-out LLM subprocess (and anything it spawned) gets SIGKILLed. */
@@ -14,6 +14,7 @@ import { buildContextPrompt, buildEngineerBlock } from '../lib/llm/context.js';
14
14
  import { normalizeCodexResult } from '../lib/llm/codex-output.js';
15
15
  import { normalizeClaudeResult } from '../lib/llm/claude-output.js';
16
16
  import { LlmSessionStore, RESUME_PROVIDERS, validSessionId } from '../lib/llm/session.js';
17
+ import { normalizeGeminiResult, normalizeCursorResult } from '../lib/llm/json-output.js';
17
18
  import { prepareValidation, validateLlmResponse } from '../lib/llm/validation.js';
18
19
  const profilePath = () => path.join(getWorkspaceContextDir(), 'llm-profiles.json');
19
20
  function usage() {
@@ -90,6 +91,23 @@ function doctor(name) {
90
91
  compatible = helpOk && ['--output-format', '--print'].every((flag) => help.stdout.includes(flag));
91
92
  features = { resume: helpOk && help.stdout.includes('--resume'), outputSchema: false };
92
93
  }
94
+ // Compatibilidade dos adapters de agente: a CLI precisa oferecer o modo somente leitura que o
95
+ // adapter usa. Ausente, o adapter rodaria com permissões que o Forja não pediu.
96
+ const HELP_FLAGS = {
97
+ 'gemini-cli': ['--approval-mode', '--output-format'],
98
+ 'cursor-agent': ['--print', '--mode', '--output-format'],
99
+ copilot: ['--prompt', '--silent'],
100
+ };
101
+ if (available && compatible === null && HELP_FLAGS[value.provider]) {
102
+ const help = spawnSync(value.command, ['--help'], { encoding: 'utf8', timeout: 10_000, shell: false });
103
+ compatible = !help.error && help.status === 0 && HELP_FLAGS[value.provider].every((flag) => help.stdout.includes(flag));
104
+ features = { resume: false, outputSchema: false };
105
+ }
106
+ else if (available && compatible === null && value.provider === 'opencode') {
107
+ const help = spawnSync(value.command, ['run', '--help'], { encoding: 'utf8', timeout: 10_000, shell: false });
108
+ compatible = !help.error && help.status === 0 && help.stdout.includes('--agent');
109
+ features = { resume: false, outputSchema: false };
110
+ }
93
111
  return { name: profileName, provider: value.provider, model: value.model, enabled: value.enabled, executable: value.command, available, compatible,
94
112
  features, modelAccess: 'not-probed', detail: errorCode ?? (probe.status === 0 ? String(probe.stdout).trim().split('\n')[0] : String(probe.stderr).trim().split('\n')[0]), pricing };
95
113
  });
@@ -154,7 +172,11 @@ async function run() {
154
172
  ? normalizeCodexResult(raw)
155
173
  : selected.provider === 'claude'
156
174
  ? normalizeClaudeResult(raw)
157
- : raw;
175
+ : selected.provider === 'gemini-cli'
176
+ ? normalizeGeminiResult(raw)
177
+ : selected.provider === 'cursor-agent'
178
+ ? normalizeCursorResult(raw)
179
+ : raw;
158
180
  if (result.sessionId !== undefined && (!validSessionId(result.sessionId) || (resume !== undefined && result.sessionId !== resume))) {
159
181
  result = { ...result, exitCode: result.exitCode || 1, errorCode: 'SESSION_MISMATCH', sessionId: undefined };
160
182
  }
@@ -152,6 +152,22 @@ forja llm:run --profile claude --resume SESSION_ID --prompt "Continue a análise
152
152
  - **Custo**: o `total_cost_usd` do provedor **não** substitui a estimativa local de
153
153
  `model-pricing.json` — a evidência de custo continua vindo do preço declarado no Forja.
154
154
 
155
+ ## Outros agentes: Gemini, Copilot CLI, Cursor e opencode (ADR-0090)
156
+
157
+ Rodam sempre em modo somente leitura/planejamento: quem aplica mudanças é o fluxo do Forja.
158
+
159
+ | Perfil | Comando | Modo | Uso de tokens |
160
+ |---|---|---|---|
161
+ | `gemini-cli` | `gemini -p … --approval-mode plan -o json` | plano | sim (`stats.models`) |
162
+ | `copilot` | `copilot -s -p …` (GitHub Copilot CLI, sem `--allow-*`) | ferramentas com aprovação negadas | não |
163
+ | `cursor` | `cursor-agent -p … --mode plan --output-format json` | plano | sim |
164
+ | `opencode` | `opencode run --agent plan …` | agente `plan` | não |
165
+
166
+ `copilot`, `cursor` e `opencode` vêm desligados em `llm:profiles:init`; habilite no perfil do
167
+ workspace. `forja llm:doctor` confere se a CLI instalada oferece as flags de somente leitura; sem
168
+ elas, o perfil fica incompatível em vez de rodar com permissões que o Forja não pediu. Retomada
169
+ (`--resume`) continua só em Codex e Claude.
170
+
155
171
  ## Métricas e recomendação por custo/latência (SPEC-049)
156
172
 
157
173
  `llm:eval` acrescenta às métricas do relatório:
@@ -51,5 +51,8 @@ compilação, então nada disso aparecia.
51
51
  ## Consequências
52
52
 
53
53
  - `clean-arch` é o primeiro template. Promover outro exige migrá-lo e incluí-lo na matriz do CI.
54
+ - 5.1: `saas-starter` (02) promovido depois de reescrito do zero (o backend antigo não compilava e
55
+ tinha segredo JWT padrão e valor de cobrança vindo do cliente). Mesma regra de dependência do
56
+ `clean-arch`, contexts `identity` e `billing`, testes de isolamento entre tenants.
54
57
  - Projetos gerados antes da v5 continuam em CommonJS + Jest. O `project:upgrade` é aditivo e não
55
58
  migra o backend existente.
@@ -0,0 +1,51 @@
1
+ # ADR-0089: Skills do projeto carregáveis pelas IAs, vindas do skill ledger
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-10-21
5
+ - **Autor(es)**: Allan Pablo / Claude
6
+ - **Tags**: generation, llm, skills, sdd
7
+
8
+ ## Contexto
9
+
10
+ Todo projeto gerado recebia 9 "skills" de 5 a 10 linhas em `skills/` na raiz, sem frontmatter. O
11
+ Claude Code lê `.claude/skills/<nome>/SKILL.md`, o Codex lê `.agents/skills/`, e ambos exigem `name` e
12
+ `description` no frontmatter. Assim, nenhuma IA carregava essas skills, e os papéis do Forja não tinham
13
+ método escrito para seguir. Existia, fora do Forja, um catálogo pessoal de 29 skills completas (o
14
+ "skill ledger", convertido para TypeScript e traduzido para pt-BR) que cobre exatamente esses papéis.
15
+
16
+ ## Decisão
17
+
18
+ 1. **As 29 skills do ledger e a `llm-provider-routing` passam a ser as skills do projeto**, versionadas
19
+ em `templates/project/skills/` (cópia do ledger no commit `0097ed7`). O `name` fica em inglês, porque
20
+ é identificador, e o texto fica em pt-BR.
21
+ 2. **Integração com o Forja em seção própria.** As skills que produzem artefatos ganham uma seção
22
+ "No Forja" (ADR em `memory/90-decisions/`, requisitos em `specs/<slug>/spec.md`, prompt-spec como
23
+ handoff ADR-0005, postmortem com `forja incident:record`, release com `### O que melhorou`). O resto
24
+ da skill continua portável, e atualizar a partir do ledger é reaplicar só essa seção.
25
+ 3. **Instalação onde cada IA procura:** `.claude/skills/` (Claude) e `.agents/skills/` (Codex), pelo
26
+ `project:wire`, com a marca `forja:managed`. Uma skill editada pelo usuário (sem a marca) não é
27
+ sobrescrita. O `project:wire --check` valida frontmatter, referências entre skills e os comandos
28
+ `forja` que elas citam.
29
+ 4. **Todas as skills são instaladas, inclusive as `ts-*`.** O que restringe o uso é a descrição, que a
30
+ IA consulta para decidir quando carregar a skill.
31
+ 5. As 9 skills de esboço e o `scripts/lib/skill-loader.mjs` deixam de ser gerados.
32
+
33
+ ## Alternativas consideradas
34
+
35
+ - **Instalar as `ts-*` só em projetos TypeScript.** Rejeitada: `testing`, `prompt-spec` e
36
+ `requirements-gathering` citam `ts-testing`/`ts-code-review` pelo nome, e omiti-las deixaria
37
+ referências quebradas.
38
+ - **Ler as skills do repositório do ledger em tempo de geração.** Rejeitada: o gerador passaria a depender
39
+ de um caminho externo e de rede; a cópia versionada é testada no CI e viaja no pacote.
40
+ - **Reescrever as skills do zero dentro do Forja.** Rejeitada: o ledger já é completo e revisado; a
41
+ seção "No Forja" é o que falta.
42
+ - **Instalar também em `.gemini/skills/`.** Adiada: a descoberta por pasta do Gemini CLI não foi
43
+ verificada nesta máquina. Hoje, o caminho é `gemini skills link <pasta>`.
44
+
45
+ ## Consequências
46
+
47
+ - Projeto novo: de 0 para 30 skills carregáveis por IA conectada. Projetos existentes recebem as skills
48
+ com `forja project:upgrade --apply`.
49
+ - A cópia pode divergir do ledger. Atualizar é um PR que copia as skills e reaplica as seções "No Forja".
50
+ - Skill nova que cite um comando `forja` inexistente reprova no `project:wire --check` e no teste
51
+ `test/project-skills.test.js`.
@@ -0,0 +1,47 @@
1
+ # ADR-0090: Adapters de agente em modo somente leitura (Gemini, Copilot CLI, Cursor, opencode)
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-10-21
5
+ - **Autor(es)**: Allan Pablo / Claude
6
+ - **Tags**: llm, adapters, security
7
+
8
+ ## Contexto
9
+
10
+ O `llm:run` só tinha adapters completos para Codex e Claude (ADR-0081, ADR-0085). O adapter
11
+ `gemini-cli` chamava `gemini -p` em texto: sem uso de tokens e com as permissões padrão da CLI. O
12
+ `copilot` chamava `gh copilot suggest -t shell`, um sugeridor de comandos de shell, não um agente. Hoje
13
+ existem CLIs de agente com modo não interativo e somente leitura: Gemini CLI (`--approval-mode plan`,
14
+ `-o json`), GitHub Copilot CLI (`copilot -p`), Cursor Agent (`--print --mode plan --output-format json`)
15
+ e opencode (`run --agent plan`). Os formatos JSON do Gemini e do Cursor foram conferidos no código das
16
+ próprias CLIs instaladas (Gemini 0.64.0, Cursor Agent 2026.10.19).
17
+
18
+ ## Decisão
19
+
20
+ 1. **Todo adapter de agente roda em modo somente leitura/planejamento.** O `llm:run` é supervisionado
21
+ e quem aplica mudanças é o fluxo do Forja, não o provedor. Isso já valia para o Codex (`--sandbox
22
+ read-only`) e agora vale para Gemini (`--approval-mode plan`), Cursor (`--mode plan`), opencode
23
+ (`--agent plan`) e Copilot CLI (`-p` sem `--allow-*`, que nega as ferramentas que pedem aprovação).
24
+ 2. **Saída normalizada** para Gemini (`response`, `session_id`, tokens somados de
25
+ `stats.models[*].tokens`) e Cursor (o mesmo envelope do Claude, com `usage` em camelCase ou
26
+ snake_case). Uso ausente fica indefinido, e o custo fica `null`; nunca se inventa zero.
27
+ 3. **`llm:doctor` verifica a compatibilidade** de cada adapter conferindo que a CLI oferece as flags de
28
+ somente leitura que ele usa. Sem elas, o perfil é incompatível em vez de rodar com permissões que o
29
+ Forja não pediu.
30
+ 4. Os perfis padrão ganham `copilot`, `cursor` e `opencode`, **desligados** até o usuário habilitar.
31
+ 5. Retomada de sessão continua só em Codex e Claude: o `--resume` do Gemini aceita "latest" ou um índice,
32
+ não um ID explícito, e o Forja exige ID explícito (ADR-0081).
33
+
34
+ ## Alternativas consideradas
35
+
36
+ - **Rodar os agentes com as permissões padrão de cada CLI.** Rejeitada: o comportamento mudaria de
37
+ provedor para provedor e algumas CLIs editam arquivos sem perguntar no modo não interativo.
38
+ - **Manter o `gh copilot suggest`.** Rejeitada: ele não responde a tarefas, só sugere comandos de shell.
39
+ - **Retomada no Gemini com `--resume latest`.** Rejeitada: "a última sessão" é ambígua com execuções
40
+ concorrentes e quebra a garantia de sessão explícita.
41
+
42
+ ## Consequências
43
+
44
+ - `forja llm:run --profile gemini|copilot|cursor|opencode` funciona em modo de análise. Para editar
45
+ código, o caminho continua sendo o fluxo supervisionado (spec → tasks → handoff).
46
+ - O perfil `copilot` muda de semântica (de `gh copilot` para o Copilot CLI). Perfis antigos com
47
+ `command: "gh"` falham no `llm:doctor` e precisam de `command: "copilot"`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "forjajs",
3
- "version": "5.0.1",
3
+ "version": "5.1.0",
4
4
  "description": "ForjaJS é uma plataforma local-first para memória, contexto, governança e execução supervisionada de agentes de desenvolvimento",
5
5
  "type": "module",
6
6
  "main": "index.js",
@@ -0,0 +1,40 @@
1
+ # Plan: skills-do-projeto
2
+
3
+ - **Spec**: [spec.md](spec.md) (SPEC-051)
4
+ - **Status**: approved
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-10-21
7
+
8
+ ## 1. Abordagem técnica
9
+ As skills vivem em `templates/project/skills/<nome>/SKILL.md` (cópia versionada do ledger em pt-BR, commit
10
+ `0097ed7`, com seções "No Forja"). O `wireProject` as instala em `.claude/skills/` (Claude) e
11
+ `.agents/skills/` (Codex) com a marca `forja:managed`; o `checkProjectWiring` valida frontmatter,
12
+ referências entre skills e os comandos `forja` que elas citam. O gerador deixa de emitir `skills/`.
13
+
14
+ ## 2. Módulos afetados
15
+ - `templates/project/skills/` (novo), `templates/project/agents/*.md`, `templates/project/AGENTS.md`
16
+ - `lib/project-wiring.ts` (instalação + checks `skills-claude`/`skills-codex`)
17
+ - `lib/generators/memory-generator.ts`, `lib/validators/structure-validator.ts`, `lib/generators/readme-generator.ts`
18
+ - `lib/core/journey.ts`, `test/project-skills.test.js`
19
+
20
+ ## 3. Diagrama de fluxo
21
+ `project:new` / `project:upgrade` / `project:wire` → `wireProject` → `.claude/skills/*`, `.agents/skills/*` → `project:wire --check`.
22
+
23
+ ## 4. Contratos (API/CLI/Schema)
24
+ Sem comando novo. `project:wire --check --json` ganha os checks `skills-claude` e `skills-codex`.
25
+
26
+ ## 5. Decisões e alternativas
27
+ - Instalar todas as skills, inclusive `ts-*`, em vez de filtrar por linguagem: filtrar deixaria referências quebradas (ADR-0089).
28
+ - Cópia versionada em vez de dependência do repositório do ledger em tempo de geração.
29
+
30
+ ## 6. Dependências
31
+ Nenhuma dependência de pacote nova.
32
+
33
+ ## 7. Rollout
34
+ Projetos novos recebem na geração; existentes via `forja project:upgrade --apply`.
35
+
36
+ ## 8. Sinais de fracasso (kill criteria)
37
+ IAs não carregam as skills nos diretórios escolhidos; ou skills disparam em contexto errado com frequência.
38
+
39
+ ## Evidências e estado real
40
+ - `npm test` 556/556; jornada com o passo `skills` (30 + 30).
@@ -0,0 +1,63 @@
1
+ # Spec: skills-do-projeto
2
+
3
+ - **ID**: SPEC-051
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-10-21
7
+ - **Sprint alvo**: 5.1
8
+ - **ADRs relacionadas**: [ADR-0086](../../memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md) (projeto conectado), ADR-0089 (esta feature)
9
+
10
+ ## 1. Problema
11
+ Todo projeto gerado recebe 9 "skills" de 5 a 10 linhas em `skills/` na raiz, sem frontmatter.
12
+ Nenhuma IA as carrega: o Claude Code lê `.claude/skills/<nome>/SKILL.md`, o Codex lê
13
+ `.agents/skills/`, e ambos exigem `name`/`description` no frontmatter. Na prática o Forja não
14
+ entrega skills; os papéis (product, sdd-architect, governance…) não têm um método escrito para
15
+ seguir. Medição hoje: 0 skills carregáveis por projeto.
16
+
17
+ ## 2. Proposta de valor
18
+ Todo projeto passa a ter as 29 skills do ledger (pt-BR), carregáveis pelas IAs, ligadas aos papéis
19
+ e aos artefatos do Forja (specs, ADRs, handoffs, incidentes), e verificadas pelo `project:wire --check`.
20
+
21
+ ## 3. User stories
22
+ - **Como** dev usando Claude Code ou Codex num projeto Forja, **quero** que a IA encontre sozinha a
23
+ skill certa (requisitos, modelagem, ADR, code review…), **para que** o método seja seguido sem eu colar prompts.
24
+ - **Como** sdd-architect, **quero** que `architecture-decision-record` grave no formato do Forja
25
+ (`memory/90-decisions/`, `forja adr:list`), **para que** a skill e o processo não divirjam.
26
+ - **Como** dono de um projeto em Python, **quero** que as skills de TypeScript só sejam usadas em
27
+ código TS/JS, **para que** a IA não aplique idiomas da linguagem errada.
28
+
29
+ ## 4. Critérios de aceite (Definition of Done)
30
+ - [ ] AC-1: `project:new` instala as skills em `.claude/skills/<nome>/SKILL.md` (Claude) e em `.agents/skills/<nome>/SKILL.md` (Codex), com frontmatter válido e `name` igual à pasta.
31
+ - [ ] AC-2: todas as skills são instaladas, inclusive as `ts-*`: outras skills as citam pelo nome (`testing` → `ts-testing`), e omiti-las deixaria referências quebradas. O que restringe o uso é a descrição ("TypeScript ou JavaScript"), que é o que a IA usa para decidir quando carregar a skill.
32
+ - [ ] AC-3: as skills que produzem artefatos do Forja trazem uma seção "No Forja" com o destino e o comando (ADR → `memory/90-decisions/`; requisitos/backlog → `specs/<slug>/`; prompt-spec → handoff ADR-0005; postmortem → `forja incident:record`; release-notes → `### O que melhorou`).
33
+ - [ ] AC-4: `project:wire --check` tem um check `skills` que falha com skill ausente, frontmatter inválido ou referência a skill inexistente; `wire` é idempotente e não sobrescreve skill editada pelo usuário (sem a marca `forja:managed`).
34
+ - [ ] AC-5: as 9 skills de esboço deixam de ser geradas; `llm-provider-routing` vira skill com frontmatter.
35
+ - [ ] AC-6: cada sub-agent de `.claude/agents/` lista as skills do seu papel.
36
+ - [ ] AC-7: a jornada (`lib/core/journey.ts`) verifica as skills instaladas no pacote instalado; `project:upgrade` as traz para projetos existentes.
37
+
38
+ ## 5. Escopo
39
+ **Dentro**:
40
+ - 29 skills do ledger + `llm-provider-routing`, com seções "No Forja".
41
+ - Instalação/verificação no `project:wire`; remoção das skills de esboço do gerador.
42
+
43
+ **Fora** (explícito, evita scope creep):
44
+ - Sincronização automática com o repositório do ledger (cópia versionada no Forja; atualizar é um PR).
45
+ - Diretório de skills do Gemini CLI (descoberta por pasta não verificada; uso via `gemini skills link`).
46
+ - Skills para o próprio repositório do framework.
47
+
48
+ ## 6. NFRs / restrições
49
+ - Compatibilidade: projetos existentes recebem as skills só via `project:upgrade --apply`; nada é sobrescrito sem a marca.
50
+ - Idioma: pt-BR; `name` em inglês (identificador).
51
+
52
+ ## 7. Riscos e mitigação
53
+ | Risco | Probabilidade | Impacto | Mitigação |
54
+ |---|---|---|---|
55
+ | Skill ensina comando do Forja que não existe | M | A | check `commands` do wire já cobre todo `forja <cmd>` citado; skills entram nos textos verificados |
56
+ | Divergência entre a cópia do Forja e o ledger | A | M | cópia versionada; seção "No Forja" separada facilita reaplicar |
57
+ | Skills demais poluem o contexto | B | M | as IAs carregam só nome+descrição até a skill ser usada |
58
+
59
+ ## 8. Métricas de sucesso
60
+ Projeto novo: 0 → 30 skills carregáveis. `project:wire --check` verde.
61
+
62
+ ## Evidências e estado real
63
+ - AC-1..AC-7: ver tasks.md e os testes `test/project-skills.test.js` e `test/journey.test.js`.
@@ -0,0 +1,27 @@
1
+ # Tasks: skills-do-projeto
2
+
3
+ - **Plan**: [plan.md](plan.md)
4
+ - **Status**: done
5
+
6
+ ## T1 — Skills versionadas com seções "No Forja" (AC-3, AC-5)
7
+ - [x] 29 skills do ledger + `llm-provider-routing` em `templates/project/skills/`; 15 com "No Forja".
8
+ - Evidência: `test/project-skills.test.js`.
9
+
10
+ ## T2 — Instalação e verificação no project:wire (AC-1, AC-2, AC-4)
11
+ - [x] `.claude/skills/` e `.agents/skills/`; marca `forja:managed`; checks `skills-claude`/`skills-codex`.
12
+ - Evidência: teste manual de idempotência e de skill editada preservada; `project:wire --check`.
13
+
14
+ ## T3 — Gerador sem as skills de esboço (AC-5)
15
+ - [x] Removidas as 9 skills e o `skill-loader.mjs`; validador não exige `skills/`.
16
+
17
+ ## T4 — Sub-agents e AGENTS.md (AC-6)
18
+ - [x] Seção "Skills" por papel; teste garante que as citadas existem.
19
+
20
+ ## T5 — Jornada e upgrade (AC-7)
21
+ - [x] Passo `skills` na jornada; `project:upgrade` instala via `wireProject`.
22
+
23
+ ## Handoffs entre agentes
24
+ Nenhum.
25
+
26
+ ## Evidências e estado real
27
+ - `npm test` 556/556.
@@ -62,6 +62,15 @@ specs/<slug>/ spec → plan → tasks
62
62
  agents/, prompts/ papéis e prompts do projeto
63
63
  ```
64
64
 
65
+ ## Skills
66
+
67
+ O projeto traz 34 skills (`.claude/skills/` para o Claude Code, `.agents/skills/` para o Codex), uma por
68
+ tarefa: avaliar produto, levantar requisitos, fatiar backlog, modelar domínio, registrar ADR, desenhar
69
+ API e migrações, front-end, acessibilidade, desempenho web, testar, revisar código, atualizar dependências, modelar ameaças, LGPD, observabilidade, release e git. As que
70
+ geram artefatos têm uma seção "No Forja" dizendo onde gravar (`specs/`, `memory/`, ADRs, handoffs).
71
+ Encadeamento típico: `product-evaluation` → `requirements-gathering` → `backlog-slicing` →
72
+ `domain-modeling` → `testing` → `ts-code-review` → `release-checklist`.
73
+
65
74
  ## Papéis e handoffs
66
75
 
67
76
  Orchestrator, product, sdd-architect, context-engineer, governance e marketing. No Claude Code
@@ -11,5 +11,8 @@ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência
11
11
  ## Procedimento
12
12
  Identifique a pergunta. `forja sync:universal` se a memória mudou; depois `forja context:smart --mode task --task "<termo>"` (ou `--mode domain` para uma área). O pack sai em `.context/smart-context.md`. Para medir, `forja context:budget`. Não remova nem compacte memória por tamanho ou idade.
13
13
 
14
+ ## Skills
15
+ Use as skills do projeto (`.claude/skills/`) que cabem na tarefa: `requirements-elicitation`, `domain-modeling`, `query-performance`, `observability`, `web-performance`. Quando a skill tiver uma seção "No Forja", siga-a para gravar o resultado no lugar certo.
16
+
14
17
  ## Entrega esperada
15
18
  Fontes com caminhos, resumo factual, lacunas e por que esse contexto foi escolhido.
@@ -11,5 +11,8 @@ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência
11
11
  ## Procedimento
12
12
  Leia o diff e os critérios de aceite. Rode `forja project:check`, `forja spec:check`, `forja tools:doctor` e `forja project:wire --check`, além dos testes do projeto. Ferramenta opcional ausente é limitação, não falha. Confira se cada mudança estrutural tem ADR e se dados pessoais seguem a política do projeto.
13
13
 
14
+ ## Skills
15
+ Use as skills do projeto (`.claude/skills/`) que cabem na tarefa: `ts-code-review`, `testing`, `ts-testing`, `threat-modeling`, `lgpd-compliance`, `ci-pipeline-review`, `docker-compose-review`, `release-checklist`, `incident-postmortem`, `accessibility-review`, `web-performance`, `dependency-upgrade`. Quando a skill tiver uma seção "No Forja", siga-a para gravar o resultado no lugar certo.
16
+
14
17
  ## Entrega esperada
15
18
  Parecer aprovado, reprovado ou inconclusivo, com evidência por critério, bloqueios concretos e limitações. Execução bem-sucedida de LLM não prova qualidade.
@@ -11,5 +11,8 @@ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência
11
11
  ## Procedimento
12
12
  Leia a dor descrita na spec e o que já foi entregue. Separe o que existe do que é roadmap. Use métricas só com fonte, período e método; hipótese é apresentada como hipótese. Publique apenas dentro da autorização vigente.
13
13
 
14
+ ## Skills
15
+ Use as skills do projeto (`.claude/skills/`) que cabem na tarefa: `product-evaluation`, `executive-writing`, `release-notes`. Quando a skill tiver uma seção "No Forja", siga-a para gravar o resultado no lugar certo.
16
+
14
17
  ## Entrega esperada
15
18
  Texto pronto para revisão, público e objetivo, fonte de cada alegação e proposta de medição sem resultados inventados.
@@ -11,5 +11,8 @@ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência
11
11
  ## Procedimento
12
12
  Comece por `forja status` e `forja next`. Para uma entrega com várias etapas, abra uma corrida com `forja orchestrate "<objetivo>" --slug <slug>` e avance com `forja orchestrate:advance`, que só abre a próxima etapa quando o gate da atual passa. Registre cada delegação com `forja hermes:handoff '<json>'` contendo os 7 campos (`from`, `to`, `intent`, `context`, `acceptance`, `constraints`, `return`). Não apague nem compacte memória como rotina.
13
13
 
14
+ ## Skills
15
+ Use as skills do projeto (`.claude/skills/`) que cabem na tarefa: `prompt-spec`, `backlog-slicing`, `commit-message`, `pull-request`, `executive-writing`. Quando a skill tiver uma seção "No Forja", siga-a para gravar o resultado no lugar certo.
16
+
14
17
  ## Entrega esperada
15
18
  Plano de execução, handoffs com os sete campos, evidências recebidas e pendências. Alegação de um agente não é validação: confirme pelo gate.
@@ -11,5 +11,8 @@ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência
11
11
  ## Procedimento
12
12
  Leia `memory/10-product/` via `forja query:universal`. Para feature nova, `forja spec:new <slug>` e preencha problema, público, comportamento esperado, exclusões e critérios de aceite observáveis. Ao terminar a revisão, `forja spec:set-status <slug> spec approved`. Na priorização (RICE), separe dado medido, estimativa e hipótese; não invente KPIs.
13
13
 
14
+ ## Skills
15
+ Use as skills do projeto (`.claude/skills/`) que cabem na tarefa: `product-evaluation`, `requirements-elicitation`, `requirements-gathering`, `backlog-slicing`, `lgpd-compliance`. Quando a skill tiver uma seção "No Forja", siga-a para gravar o resultado no lugar certo.
16
+
14
17
  ## Entrega esperada
15
18
  Spec preenchida, critérios de aceite numerados, suposições e dúvidas que de fato bloqueiam a implementação.
@@ -11,5 +11,8 @@ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência
11
11
  ## Procedimento
12
12
  Leia a spec e `memory/20-architecture/`. Antes de propor mudança em código existente, `forja code:impact <símbolo>` (sem codegraph, busque chamadores com `rg`). Gere `forja spec:plan <slug>` e `forja spec:tasks <slug>`; descreva contratos, falhas, compatibilidade, testes e rollout. Decisão estrutural durável vira ADR em `memory/90-decisions/` a partir de `_template.md`.
13
13
 
14
+ ## Skills
15
+ Use as skills do projeto (`.claude/skills/`) que cabem na tarefa: `event-storming`, `bounded-context-mapping`, `domain-modeling`, `architecture-decision-record`, `technical-spike`, `api-design`, `data-migrations`, `ts-module-layout`, `ts-async-patterns`, `frontend-architecture`. Quando a skill tiver uma seção "No Forja", siga-a para gravar o resultado no lugar certo.
16
+
14
17
  ## Entrega esperada
15
18
  Plan e tasks ligados aos critérios de aceite, arquivos afetados, decisões justificadas e como validar. Não marque aceite ainda não verificado.
@@ -0,0 +1,14 @@
1
+ # Skills do projeto
2
+
3
+ Instaladas pelo `forja project:wire` em `.claude/skills/` (Claude Code) e `.agents/skills/` (Codex).
4
+ Cada pasta tem um `SKILL.md` com frontmatter (`name`, `description`); o `name` é igual ao nome da pasta.
5
+
6
+ ## Origem
7
+
8
+ As skills de produto, requisitos, design, qualidade, TypeScript, segurança, operações, entrega, IA,
9
+ compliance, comunicação e git vêm do skill ledger de Allan Pablo (`allus-co/my-skill-ledger`),
10
+ traduzidas para pt-BR, com a trilha de Go convertida para TypeScript e publicadas no Forja sob a licença
11
+ MIT com autorização do autor. As seções "No Forja" são a integração com o processo do Forja.
12
+ `llm-provider-routing` é do próprio Forja.
13
+
14
+ Para atualizar a partir do ledger: copie as skills e reaplique as seções "No Forja" (ADR-0089).