# Ideia — Project Intelligence Layer

## Rastreabilidade
- Orquestração: Project Intelligence Layer
- Slug: project-intelligence-layer
- Origem: checkpoint humano aprovado em 2026-06-08 na conversa SDD sobre inteligência evolutiva do projeto.
- Estado atual: recorded
- Próximo artefato: docs/project-intelligence-layer/02-prd.md
- Fonte canônica local: docs/project-intelligence-layer/traceability-map.yaml

## Problema

O fluxo SDD já gera artefatos em `docs/<slug-da-orquestracao>/` e encerra ciclos com memória, mas cada nova ideia, PRD, Tech Spec, Tasks ou execução ainda depende demais do agente lembrar manualmente quais artefatos históricos, decisões, padrões, riscos e evidências são relevantes.

Conforme o projeto cresce, aumentam também:

- a quantidade de artefatos aprovados;
- as ADRs e decisões espalhadas por ciclos anteriores;
- os padrões de arquitetura e teste que deveriam ser reaproveitados;
- os riscos recorrentes que deveriam ser antecipados;
- a chance de uma nova implementação ignorar contexto já documentado.

Sem uma camada explícita de inteligência do projeto, a memória pode virar um resumo final útil, mas insuficiente para garantir que todo ciclo futuro considere o máximo de contexto possível de forma auditável, reconstruível e provider-neutral.

## Objetivo

Criar uma Project Intelligence Layer para o SDD que transforme artefatos canônicos, rastreabilidade, ADRs, reviews e memórias em contexto operacional recuperável antes de qualquer etapa do fluxo.

Essa camada deve:

- preservar `docs/<slug-da-orquestracao>/` e `traceability-map.yaml` como fonte canônica;
- manter índices e learnings como derivados reconstruíveis;
- gerar Context Packs obrigatórios antes de cada etapa;
- detectar decisões, padrões, riscos, comandos e sinais de saúde recorrentes;
- melhorar progressivamente a assertividade dos agentes;
- preservar portabilidade entre providers, clients e ambientes offline.

## Usuários

- Pessoa product/tech lead conduzindo uma feature no SDD.
- Agente de Idea, PRD, Tech Spec, Tasks, Execution, Review e Memory.
- Agentes revisores especializados que precisam de contexto curto e confiável.
- Mantenedores do `sdd-layer` que precisam acompanhar saúde, coerência e evolução do projeto.
- Projetos instalados que usam Markdown como fallback canônico quando integrações externas ainda não estão completas.

## Critérios de sucesso

- Toda etapa SDD consegue receber um Context Pack auditável antes de gerar ou executar trabalho.
- O Context Pack aponta quais fontes foram consideradas, incluídas, excluídas ou marcadas como obsoletas.
- Learnings derivados sempre carregam `source_artifact`, `source_hash`, tipo, tags, confiança e estado.
- Conflitos entre memória, ADR, Tech Spec e PRD são detectados antes de avançar etapas críticas.
- A solução funciona sem vector DB, MCP, browser, subagents ou provider específico.
- Recursos avançados, como busca semântica, podem ser adicionados como aceleração opcional sem virar fonte de verdade.
- A saúde do projeto melhora com o tempo por meio de riscos recorrentes, decisões pendentes, testes conhecidos e padrões promovidos para docs, rules ou skills.
