Atualização de documentação pós-v0.9.0

Objetivo

Este documento registra a atualização de documentação feita após revisar o estado v0.9.0 do SotuHire e consolidar a próxima direção do projeto.

A atualização teve quatro focos:

1. corrigir a direção do roadmap pós-v0.9.0;
2. transformar o SotuHire em produto multiárea;
3. planejar prompts estruturados e completos;
4. evoluir a análise GitHub/portfólio para um pipeline mais profundo.

Escopo respeitado

Esta atualização não altera a documentação de coleta autenticada.

Também não cria o documento docs/ethics/allowed-vs-not-allowed.md.

O escopo ficou restrito a:

• estratégia de produto;
• prompts;
• IA estruturada;
• matching;
• multiárea;
• GitHub Analyzer;
• roadmap de desenvolvimento.

Novos documentos criados

Produto

• docs/01-product/multi-domain-product-strategy.md

Define a decisão de transformar o SotuHire em copiloto de carreira multiárea, cobrindo TI, cybersecurity, engenharias, saúde, educação, psicologia, arquitetura, design, cursos técnicos, humanas, exatas e outras áreas.

Regras de negócio

• docs/03-business-rules/multi-domain-career-rules.md

Define regras para requisitos, credenciais, formações, ferramentas, equipamentos, normas, portfólio e competências transferíveis.

IA

• docs/04-ai/ai-orchestration-and-confidence.md

Define como Gemini ou outro provider deve ser usado com prompts estruturados, validação Pydantic, confidence, fallback local e revisão humana.

• docs/04-ai/prompt-catalog.md

Define prompts completos para extração de currículo, extração de vaga, matching, ATS, Resume Tailor, GitHub Analyzer e Hidden Job Detection.

Desenvolvimento

• docs/07-development/v0.10.0-ai-structured-extraction.md

Planeja a v0.10.0 com AI Structured Extraction, Prompt Registry, schemas e Domain Intelligence.

• docs/07-development/v0.11.0-github-analyzer-2.md

Planeja GitHub Analyzer 2.0 com GitHub API, árvore completa, sampler, grafo de dependências, prompt estruturado e evidências por arquivo.

• docs/07-development/v0.12.0-match-engine-2.md

Planeja Match Engine 2.0 multiárea, com requisitos classificados, score ponderado, gaps críticos e competências transferíveis.

Documentos atualizados

• docs/01-product/vision.md;
• docs/01-product/roadmap.md;
• docs/03-business-rules/matching-rules.md;
• docs/04-ai/prompting.md;
• docs/04-ai/structured-output-schema.md;
• docs/05-data-sources/github-portfolio-analyzer.md;
• docs/07-development/extension-github-portfolio-analysis.md;
• docs/README.md;
• mkdocs.yml.

Decisões registradas

SotuHire multiárea

O produto não deve ser vendido ou implementado apenas como ferramenta para Dev/TI.

Ele deve funcionar com vagas e currículos de múltiplas áreas, desde que o sistema classifique requisitos por tipo e não dependa apenas de keywords.

IA com contrato

A IA deve receber entrada rica e devolver JSON validado.

O código deve validar, calcular score, aplicar travas e salvar histórico.

Extensão como ponte

A extensão deve capturar contexto e chamar o SotuHire local/site.

A análise pesada deve ficar no backend, onde é possível reaproveitar memória, tracker, currículo, vaga, GitHub e prompts versionados.

GitHub Analyzer 2.0

A análise de GitHub deve evoluir de sinais visíveis e heurística simples para:

• GitHub API;
• árvore completa;
• sampler;
• grafo de dependências;
• contexto de arquivos;
• prompt JSON;
• scores por dimensão;
• evidências por arquivo;
• comparação com vaga e currículo.

Match Engine 2.0

O match deve evoluir para análise por requisitos, domínio, evidência e confiança.

A IA pode classificar e explicar, mas o score final deve ser calculado pelo código.

Próximas ações recomendadas

1. Implementar Prompt Registry.
2. Criar schemas Pydantic para os prompts do catálogo.
3. Adicionar fixtures multiárea.
4. Criar Domain Intelligence inicial.
5. Evoluir GitHub Analyzer para backend.
6. Criar página de Portfólio/GitHub Analyzer no site.
7. Implementar Match Engine 2.0.
8. Atualizar README principal com visão multiárea quando a implementação começar.

Observação sobre documentação

A atualização foi feita adicionando conteúdo e novos documentos, sem reduzir o tamanho dos documentos existentes modificados.