# Memória Operacional - Project Intelligence Layer
## Estado final
- Memória operacional gerada de forma determinística a partir dos artefatos locais existentes.
- O índice de intelligence deve ser reconstruído após alterações nos artefatos canônicos.
## Funcionalidades implementadas
- Idea: Ideia — Project Intelligence Layer (fonte: `docs/project-intelligence-layer/01-idea.md`)
- PRD: PRD — Project Intelligence Layer (fonte: `docs/project-intelligence-layer/02-prd.md`)
- Tech Spec: Tech Spec — Project Intelligence Layer (fonte: `docs/project-intelligence-layer/03-techspec.md`)
- Tasks: Tasks — Project Intelligence Layer (fonte: `docs/project-intelligence-layer/04-tasks.md`)
- Refinement: Refinement — Project Intelligence Layer (fonte: `docs/project-intelligence-layer/05-refinement.md`)
- Execution: Execution — Project Intelligence Layer (fonte: `docs/project-intelligence-layer/06-execution.md`)
- ADR: ADR — Project Intelligence Layer determinística (fonte: `docs/project-intelligence-layer/06-adr.md`)
- Review: Review — Project Intelligence Layer (fonte: `docs/project-intelligence-layer/07-review.md`)
## Arquitetura atual
- os padrões de arquitetura e teste que deveriam ser reaproveitados; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- O núcleo deve funcionar com Markdown, YAML, JSONL, CLI `sdd` e validação local. Busca semântica, embeddings, vector DB, MCP e integrações externas são aceleradores opcionais, não dependências do contrato. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- `/techspec`: ADRs, padrões de arquitetura, contratos, áreas do código e riscos técnicos; (fonte: `docs/project-intelligence-layer/02-prd.md`)
- ADRs ausentes após decisões arquiteturais; (fonte: `docs/project-intelligence-layer/02-prd.md`)
- artifact store local. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- O MVP deve introduzir ou evoluir comandos determinísticos: (fonte: `docs/project-intelligence-layer/02-prd.md`)
- **Escopo amplo demais:** tentar entregar busca semântica, health, promoção de rules e contexto perfeito no primeiro corte. Mitigação: começar com inventário, JSONL e Context Pack determinístico. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- A["Artefatos canônicos em docs/<slug>/"] --> B["Ingestão intelligence learn"] (fonte: `docs/project-intelligence-layer/02-prd.md`)
## Decisões
- O fluxo SDD já gera artefatos em `docs/<slug-da-orquestração>/` 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, pa
...(truncado)
(fonte: `docs/project-intelligence-layer/01-idea.md`)
- as ADRs e decisões espalhadas por ciclos anteriores; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- detectar decisões, padrões, riscos, comandos e sinais de saúde recorrentes; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- 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. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- Decisão humana anterior: direção aprovada em 2026-06-08. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- Reduzir redescoberta de decisões, padrões e riscos já documentados. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- **Lead humano do SDD:** precisa aprovar decisões com evidência e ver se o projeto está ficando mais saudável. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- **Agente executor:** precisa saber decisões, limites, comandos e riscos antes de alterar código. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- `/prd`: decisões de produto, usuários, métricas e critérios já usados; (fonte: `docs/project-intelligence-layer/02-prd.md`)
- `/memory`: decisões finais, pendências, padrões úteis e ponteiros canônicos. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- ADRs ausentes após decisões arquiteturais; (fonte: `docs/project-intelligence-layer/02-prd.md`)
- `docs/_project-intelligence/decision-index.md`; (fonte: `docs/project-intelligence-layer/02-prd.md`)
## Falhas recorrentes
- O fluxo SDD já gera artefatos em `docs/<slug-da-orquestração>/` 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, pa
...(truncado)
(fonte: `docs/project-intelligence-layer/01-idea.md`)
- Conforme o projeto cresce, aumentam também: (fonte: `docs/project-intelligence-layer/01-idea.md`)
- a quantidade de artefatos aprovados; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- as ADRs e decisões espalhadas por ciclos anteriores; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- os padrões de arquitetura e teste que deveriam ser reaproveitados; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- os riscos recorrentes que deveriam ser antecipados; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- a chance de uma nova implementação ignorar contexto já documentado. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- 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-neutra
...(truncado)
(fonte: `docs/project-intelligence-layer/01-idea.md`)
- detectar decisões, padrões, riscos, comandos e sinais de saúde recorrentes; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- 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. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- **Saúde evolutiva:** revelar padrões recorrentes, riscos, conflitos, lacunas de rastreabilidade e oportunidades de promover conhecimento para docs, rules ou skills. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- O núcleo deve funcionar com Markdown, YAML, JSONL, CLI `sdd` e validação local. Busca semântica, embeddings, vector DB, MCP e integrações externas são aceleradores opcionais, não dependências do contrato. (fonte: `docs/project-intelligence-layer/02-prd.md`)
## Comandos confiáveis
- Origem: checkpoint humano aprovado em 2026-06-08 na conversa SDD sobre inteligência evolutiva do projeto. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- O fluxo SDD já gera artefatos em `docs/<slug-da-orquestração>/` 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, pa
...(truncado)
(fonte: `docs/project-intelligence-layer/01-idea.md`)
- 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. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- Toda etapa SDD consegue receber um Context Pack auditável antes de gerar ou executar trabalho. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- Construir uma camada de inteligência evolutiva para o SDD que garanta que toda ideia, planejamento, execução e review considere o contexto máximo disponível do projeto sem transformar memória derivada em fonte de verdade. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- Garantir que cada etapa SDD comece com contexto relevante, rastreável e atualizado. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- O SDD deve conseguir inventariar fontes relevantes do projeto: (fonte: `docs/project-intelligence-layer/02-prd.md`)
- artefatos SDD por etapa; (fonte: `docs/project-intelligence-layer/02-prd.md`)
- O SDD deve armazenar learnings em JSONL derivado, com no mínimo: (fonte: `docs/project-intelligence-layer/02-prd.md`)
- Antes de gerar ou executar uma etapa principal, o SDD deve produzir um Context Pack específico para o stage: (fonte: `docs/project-intelligence-layer/02-prd.md`)
- O SDD deve calcular sinais mínimos de saúde: (fonte: `docs/project-intelligence-layer/02-prd.md`)
- sdd context build --name "<orquestração>" --stage <stage> (fonte: `docs/project-intelligence-layer/02-prd.md`)
## Padrões úteis
- Fonte canônica local: docs/project-intelligence-layer/traceability-map.yaml (fonte: `docs/project-intelligence-layer/01-idea.md`)
- O fluxo SDD já gera artefatos em `docs/<slug-da-orquestração>/` 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, pa
...(truncado)
(fonte: `docs/project-intelligence-layer/01-idea.md`)
- os padrões de arquitetura e teste que deveriam ser reaproveitados; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- preservar `docs/<slug-da-orquestração>/` e `traceability-map.yaml` como fonte canônica; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- gerar Context Packs obrigatórios antes de cada etapa; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- detectar decisões, padrões, riscos, comandos e sinais de saúde recorrentes; (fonte: `docs/project-intelligence-layer/01-idea.md`)
- Toda etapa SDD consegue receber um Context Pack auditável antes de gerar ou executar trabalho. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- O Context Pack aponta quais fontes foram consideradas, incluídas, excluídas ou marcadas como obsoletas. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- 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. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- **Context Pack obrigatório:** montar contexto curto, auditável e específico antes de cada etapa SDD. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- **Saúde evolutiva:** revelar padrões recorrentes, riscos, conflitos, lacunas de rastreabilidade e oportunidades de promover conhecimento para docs, rules ou skills. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- O núcleo deve funcionar com Markdown, YAML, JSONL, CLI `sdd` e validação local. Busca semântica, embeddings, vector DB, MCP e integrações externas são aceleradores opcionais, não dependências do contrato. (fonte: `docs/project-intelligence-layer/02-prd.md`)
## Testes e comandos
- Comandos confiáveis para começar a validação:
- Origem: checkpoint humano aprovado em 2026-06-08 na conversa SDD sobre inteligência evolutiva do projeto. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- O fluxo SDD já gera artefatos em `docs/<slug-da-orquestração>/` 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, pa
...(truncado)
(fonte: `docs/project-intelligence-layer/01-idea.md`)
- 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. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- Toda etapa SDD consegue receber um Context Pack auditável antes de gerar ou executar trabalho. (fonte: `docs/project-intelligence-layer/01-idea.md`)
- Construir uma camada de inteligência evolutiva para o SDD que garanta que toda ideia, planejamento, execução e review considere o contexto máximo disponível do projeto sem transformar memória derivada em fonte de verdade. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- Garantir que cada etapa SDD comece com contexto relevante, rastreável e atualizado. (fonte: `docs/project-intelligence-layer/02-prd.md`)
- O SDD deve conseguir inventariar fontes relevantes do projeto: (fonte: `docs/project-intelligence-layer/02-prd.md`)
- artefatos SDD por etapa; (fonte: `docs/project-intelligence-layer/02-prd.md`)
- O SDD deve armazenar learnings em JSONL derivado, com no mínimo: (fonte: `docs/project-intelligence-layer/02-prd.md`)
- Antes de gerar ou executar uma etapa principal, o SDD deve produzir um Context Pack específico para o stage: (fonte: `docs/project-intelligence-layer/02-prd.md`)
- O SDD deve calcular sinais mínimos de saúde: (fonte: `docs/project-intelligence-layer/02-prd.md`)
- sdd context build --name "<orquestração>" --stage <stage> (fonte: `docs/project-intelligence-layer/02-prd.md`)
## Pendências
- Revisar esta memória em checkpoint humano quando houver decisões de produto ou arquitetura que não aparecem nos artefatos atuais.
## Próximos passos
- Rodar `sdd intelligence learn --all` após qualquer alteração relevante neste diretório de artefatos.
## Contexto para o próximo agente
- Orquestração: `Project Intelligence Layer`
- Slug: `project-intelligence-layer`
- Gerado em: `2026-07-04T19:17:50Z`
## Rastreabilidade
- Origem local: `docs/project-intelligence-layer/traceability-map.yaml`
- Artefatos lidos:
- `docs/project-intelligence-layer/01-idea.md` (idea)
- `docs/project-intelligence-layer/02-prd.md` (prd)
- `docs/project-intelligence-layer/03-techspec.md` (techspec)
- `docs/project-intelligence-layer/04-tasks.md` (tasks)
- `docs/project-intelligence-layer/05-refinement.md` (refinement)
- `docs/project-intelligence-layer/06-execution.md` (execution)
- `docs/project-intelligence-layer/06-adr.md` (adr)
- `docs/project-intelligence-layer/07-review.md` (review)
- Artefatos esperados para fechamento da memória:
- `docs/project-intelligence-layer/06-adr.md`
- `docs/project-intelligence-layer/07-review.md`