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.
- package/CHANGELOG.md +38 -2
- package/README.md +4 -2
- package/README.pt-BR.md +4 -1
- package/boilerplates/02-saas-starter/README.md +58 -293
- package/boilerplates/02-saas-starter/backend/.env.example +13 -0
- package/boilerplates/02-saas-starter/backend/.oxlintrc.json +8 -0
- package/boilerplates/02-saas-starter/backend/nest-cli.json +6 -0
- package/boilerplates/02-saas-starter/backend/package.json +32 -73
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/billing/adapters/http/billing.controller.ts +55 -0
- package/boilerplates/02-saas-starter/backend/src/billing/adapters/persistence/orm-entities.ts +28 -0
- package/boilerplates/02-saas-starter/backend/src/billing/adapters/persistence/typeorm-billing.repository.ts +46 -0
- package/boilerplates/02-saas-starter/backend/src/billing/application/billing.service.spec.ts +58 -0
- package/boilerplates/02-saas-starter/backend/src/billing/application/billing.service.ts +68 -0
- package/boilerplates/02-saas-starter/backend/src/billing/billing.module.ts +11 -0
- package/boilerplates/02-saas-starter/backend/src/billing/domain/plan.spec.ts +23 -0
- package/boilerplates/02-saas-starter/backend/src/billing/domain/plan.ts +36 -0
- package/boilerplates/02-saas-starter/backend/src/billing/domain/ports.ts +27 -0
- package/boilerplates/02-saas-starter/backend/src/billing/domain/subscription.spec.ts +28 -0
- package/boilerplates/02-saas-starter/backend/src/billing/domain/subscription.ts +47 -0
- package/boilerplates/02-saas-starter/backend/src/identity/adapters/http/auth.dto.ts +22 -0
- package/boilerplates/02-saas-starter/backend/src/identity/adapters/http/identity.controller.ts +59 -0
- package/boilerplates/02-saas-starter/backend/src/identity/adapters/persistence/orm-entities.ts +25 -0
- package/boilerplates/02-saas-starter/backend/src/identity/adapters/persistence/typeorm-identity.repository.ts +47 -0
- package/boilerplates/02-saas-starter/backend/src/identity/application/auth.service.spec.ts +72 -0
- package/boilerplates/02-saas-starter/backend/src/identity/application/auth.service.ts +63 -0
- package/boilerplates/02-saas-starter/backend/src/identity/domain/model.spec.ts +19 -0
- package/boilerplates/02-saas-starter/backend/src/identity/domain/model.ts +42 -0
- package/boilerplates/02-saas-starter/backend/src/identity/domain/password.spec.ts +17 -0
- package/boilerplates/02-saas-starter/backend/src/identity/domain/password.ts +26 -0
- package/boilerplates/02-saas-starter/backend/src/identity/identity.module.ts +12 -0
- package/boilerplates/02-saas-starter/backend/src/main.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/platform/auth/jwt-auth.guard.ts +17 -0
- package/boilerplates/02-saas-starter/backend/src/platform/auth/principal.ts +22 -0
- package/boilerplates/02-saas-starter/backend/src/platform/auth/roles.guard.spec.ts +23 -0
- package/boilerplates/02-saas-starter/backend/src/platform/auth/roles.guard.ts +20 -0
- package/boilerplates/02-saas-starter/backend/src/platform/auth/token.service.ts +54 -0
- package/boilerplates/02-saas-starter/backend/src/platform/config.spec.ts +18 -0
- package/boilerplates/02-saas-starter/backend/src/platform/config.ts +33 -0
- package/boilerplates/02-saas-starter/backend/src/platform/platform.module.ts +14 -0
- package/boilerplates/02-saas-starter/backend/tsconfig.build.json +6 -0
- package/boilerplates/02-saas-starter/backend/tsconfig.json +16 -21
- package/boilerplates/02-saas-starter/backend/vitest.config.ts +7 -0
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +19 -14
- package/boilerplates/02-saas-starter/docker-compose.yml +10 -24
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +15 -132
- package/boilerplates/02-saas-starter/memory/30-domains/identity/context.md +20 -0
- package/boilerplates/README.md +9 -10
- package/dist/bin/init-project.js +1 -0
- package/dist/lib/core/journey.js +10 -0
- package/dist/lib/generators/memory-generator.d.ts +0 -11
- package/dist/lib/generators/memory-generator.js +5 -161
- package/dist/lib/generators/readme-generator.js +1 -1
- package/dist/lib/llm/json-output.d.ts +14 -0
- package/dist/lib/llm/json-output.js +77 -0
- package/dist/lib/project-wiring.d.ts +8 -0
- package/dist/lib/project-wiring.js +74 -2
- package/dist/lib/validators/structure-validator.js +0 -1
- package/dist/packages/llm/src/index.js +12 -2
- package/dist/scripts/llm-fit.js +23 -1
- package/docs/llm-fit-loop.md +16 -0
- package/memory/90-decisions/0088-templates-validados.md +3 -0
- package/memory/90-decisions/0089-skills-do-projeto.md +51 -0
- package/memory/90-decisions/0090-adapters-de-agente-somente-leitura.md +47 -0
- package/package.json +1 -1
- package/specs/skills-do-projeto/plan.md +40 -0
- package/specs/skills-do-projeto/spec.md +63 -0
- package/specs/skills-do-projeto/tasks.md +27 -0
- package/templates/project/AGENTS.md +9 -0
- package/templates/project/agents/context-engineer.md +3 -0
- package/templates/project/agents/governance.md +3 -0
- package/templates/project/agents/marketing.md +3 -0
- package/templates/project/agents/orchestrator.md +3 -0
- package/templates/project/agents/product.md +3 -0
- package/templates/project/agents/sdd-architect.md +3 -0
- package/templates/project/skills/README.md +14 -0
- package/templates/project/skills/accessibility-review/SKILL.md +89 -0
- package/templates/project/skills/api-design/SKILL.md +77 -0
- package/templates/project/skills/architecture-decision-record/SKILL.md +92 -0
- package/templates/project/skills/backlog-slicing/SKILL.md +82 -0
- package/templates/project/skills/bounded-context-mapping/SKILL.md +88 -0
- package/templates/project/skills/ci-pipeline-review/SKILL.md +83 -0
- package/templates/project/skills/commit-message/SKILL.md +143 -0
- package/templates/project/skills/data-migrations/SKILL.md +88 -0
- package/templates/project/skills/dependency-upgrade/SKILL.md +75 -0
- package/templates/project/skills/docker-compose-review/SKILL.md +85 -0
- package/templates/project/skills/domain-modeling/SKILL.md +120 -0
- package/templates/project/skills/event-storming/SKILL.md +95 -0
- package/templates/project/skills/executive-writing/SKILL.md +99 -0
- package/templates/project/skills/frontend-architecture/SKILL.md +97 -0
- package/templates/project/skills/incident-postmortem/SKILL.md +93 -0
- package/templates/project/skills/lgpd-compliance/SKILL.md +108 -0
- package/templates/project/skills/llm-provider-routing/SKILL.md +18 -0
- package/templates/project/skills/observability/SKILL.md +93 -0
- package/templates/project/skills/product-evaluation/SKILL.md +130 -0
- package/templates/project/skills/prompt-spec/SKILL.md +83 -0
- package/templates/project/skills/pull-request/SKILL.md +101 -0
- package/templates/project/skills/query-performance/SKILL.md +83 -0
- package/templates/project/skills/release-checklist/SKILL.md +106 -0
- package/templates/project/skills/release-notes/SKILL.md +87 -0
- package/templates/project/skills/requirements-elicitation/SKILL.md +127 -0
- package/templates/project/skills/requirements-gathering/SKILL.md +134 -0
- package/templates/project/skills/technical-spike/SKILL.md +101 -0
- package/templates/project/skills/testing/SKILL.md +109 -0
- package/templates/project/skills/threat-modeling/SKILL.md +87 -0
- package/templates/project/skills/ts-async-patterns/SKILL.md +101 -0
- package/templates/project/skills/ts-code-review/SKILL.md +121 -0
- package/templates/project/skills/ts-module-layout/SKILL.md +104 -0
- package/templates/project/skills/ts-testing/SKILL.md +89 -0
- package/templates/project/skills/web-performance/SKILL.md +72 -0
- package/boilerplates/02-saas-starter/.env.example +0 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +0 -190
- package/boilerplates/02-saas-starter/INFO.md +0 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +0 -194
- package/boilerplates/02-saas-starter/START-HERE.md +0 -259
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +0 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +0 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +0 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +0 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +0 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +0 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +0 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +0 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +0 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +0 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +0 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +0 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +0 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +0 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +0 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +0 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +0 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +0 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +0 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +0 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +0 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +0 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +0 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +0 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +0 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +0 -48
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +0 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +0 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +0 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +0 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +0 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +0 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +0 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +0 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +0 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +0 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +0 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +0 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +0 -262
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +0 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +0 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +0 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +0 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +0 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +0 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +0 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +0 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +0 -185
- 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
|
-
|
|
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}`)) : []);
|
|
@@ -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, '
|
|
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. */
|
package/dist/scripts/llm-fit.js
CHANGED
|
@@ -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
|
-
:
|
|
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
|
}
|
package/docs/llm-fit-loop.md
CHANGED
|
@@ -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
|
@@ -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).
|