
PRIOR ITERATIONS FINDINGS (avoid duplicate flags — these are already covered):

--- iteration-001.md ---
| L-001-001 | P0 | correctness | .opencode/skills/system-spec-kit/shared/embeddings/factory.ts:819 | "const llamaCppAvailability = getLlamaCppAvailability();" | confirmed-residue | Remove `llama-cpp` from the implicit `auto` no-key path; only select it when `EMBEDDINGS_PROVIDER=llama-cpp` is explicit. |
| L-001-002 | P0 | correctness | .opencode/skills/system-spec-kit/shared/embeddings/factory.ts:822 | "name: 'llama-cpp'," | confirmed-residue | Change the no-key default branch to return `hf-local` with `onnx-community/embeddinggemma-300m-ONNX`, `q8`, 768 dims. |
| L-001-003 | P1 | correctness | .codex/config.toml:23 | "_NOTE_3_EMBEDDINGS_PROVIDER = \"Options: auto \| llama-cpp \| hf-local \| voyage \| openai. Default 'auto' resolves to llama-cpp; set EMBEDDINGS_PROVIDER=hf-local to opt out.\"" | confirmed-residue | Update Codex config notes so `auto` resolves to `hf-local` without API keys and `llama-cpp` is explicit opt-in. |
| L-001-004 | P1 | correctness | .claude/mcp.json:19 | "\"_NOTE_3_EMBEDDINGS_PROVIDER\": \"Options: auto \| llama-cpp \| hf-local \| voyage \| openai. Default 'auto' resolves to llama-cpp; set EMBEDDINGS_PROVIDER=hf-local to opt out.\"," | confirmed-residue | Align Claude MCP config note with post-014 provider resolution and remove the opt-out framing. |
| L-001-005 | P1 | correctness | opencode.json:29 | "\"_NOTE_3_EMBEDDINGS_PROVIDER\": \"Options: auto \| llama-cpp \| hf-local \| voyage \| openai. Default 'auto' resolves to llama-cpp; set EMBEDDINGS_PROVIDER=hf-local to opt out.\"," | confirmed-residue | Align OpenCode config note with `auto -> hf-local` for no-key startup. |
| L-001-006 | P1 | correctness | .gemini/settings.json:36 | "\"_NOTE_3_EMBEDDINGS_PROVIDER\": \"Options: auto \| llama-cpp \| hf-local \| voyage \| openai. Default 'auto' resolves to llama-cpp; set EMBEDDINGS_PROVIDER=hf-local to opt out.\"," | confirmed-residue | Align Gemini config note with `auto -> hf-local` and make `llama-cpp` opt-in only. |
| L-001-007 | P1 | traceability | .opencode/skills/system-spec-kit/mcp_server/ENV_REFERENCE.md:445 | "In `EMBEDDINGS_PROVIDER=auto`, the runtime prefers Voyage `voyage-4` (1024 dims) when `VOYAGE_API_KEY` is present, then OpenAI `text-embedding-3-small` (1536 dims) when `OPENAI_API_KEY` is present" | confirmed-residue | Rewrite the embedding default reference around the canonical hf-local default; keep cloud providers as explicit/optional fallback details. |
| L-001-008 | P1 | traceability | .opencode/skills/system-spec-kit/references/memory/embedding_resilience.md:23 | "\| Voyage Provider \| `shared/embeddings/providers/voyage.ts` \| Primary embedding provider \|" | confirmed-residue | Change the architecture table to name `hf-local` as the default provider and Voyage as optional/fallback. |
| L-001-009 | P1 | traceability | .opencode/skills/system-spec-kit/references/memory/embedding_resilience.md:48 | "│ 1. VOYAGE AI (Primary)                                            │" | confirmed-residue | Replace the fallback-order diagram with the post-014 resolver order and remove Voyage-as-primary language. |
| L-001-010 | P1 | traceability | .opencode/skills/mcp-coco-index/INSTALL_GUIDE.md:101 | "\| **Embedding** \| Configurable (default: all-MiniLM-L6-v2 local, recommended: Voyage Code 3) \|" | confirmed-residue | Update CocoIndex install guide to `sentence-transformers` + `google/embeddinggemma-300m`, `bf16`, 768 dims as the default. |
| L-001-011 | P1 | traceability | .opencode/skills/mcp-coco-index/references/settings_reference.md:43 | "\| `embedding.model`    \| string        \| `sentence-transformers/all-MiniLM-L6-v2`   \| Model identifier passed to the provider          \|" | confirmed-residue | Replace MiniLM defaults with `google/embeddinggemma-300m` and 768-dimensional expectations. |
| L-001-012 | P1 | traceability | .opencode/skills/mcp-coco-index/SKILL.md:271 | "\| `voyage/voyage-code-3` (primary) \| Cloud via LiteLLM \| 1024 \| `VOYAGE_API_KEY` required \| Higher quality code search \|" | confirmed-residue | Remove `primary` from Voyage Code 3 and document it only as optional LiteLLM/cloud configuration. |
| L-001-013 | P1 | maintainability | .opencode/skills/mcp-coco-index/assets/config_templates.md:75 | "\"_NOTE_2\": \"Default embedding: all-MiniLM-L6-v2 (local, no API key needed)\"," | confirmed-residue | Refresh config templates so generated client configs do not reintroduce the MiniLM default. |
| L-001-014 | P1 | traceability | .opencode/install_guides/README.md:671 | "export VOYAGE_EMBEDDINGS_MODEL=voyage-3.5  # Default" | confirmed-residue | Replace the stale Voyage default example with canonical hf-local defaults; keep Voyage only as optional explicit provider setup. |
| L-001-015 | P1 | traceability | .opencode/install_guides/README.md:678 | "export HF_EMBEDDINGS_MODEL=nomic-ai/nomic-embed-text-v1.5  # Default" | confirmed-residue | Update HF Local example to `onnx-community/embeddinggemma-300m-ONNX`, `q8`, 768 dims. |

--- iteration-002.md ---
| L-002-001 | P1 | traceability | README.md:139 | "# Option A: Voyage AI (recommended - best quality)" | confirmed-residue | Update the root quick start to lead with hf-local EmbeddingGemma defaults and move Voyage to optional explicit setup. |
| L-002-002 | P1 | traceability | README.md:517 | "- **Voyage AI** - Set `VOYAGE_API_KEY` env var. Best quality, recommended." | confirmed-residue | Remove Voyage-as-recommended wording from the embedding provider feature list. |
| L-002-003 | P1 | traceability | README.md:828 | "Semantic code search via vector embeddings (Voyage Code 3 and All-MiniLM-L6-v2 models)" | confirmed-residue | Replace the CocoIndex model summary with `google/embeddinggemma-300m` / sentence-transformers / bf16 / 768 dims. |
| L-002-004 | P1 | traceability | .opencode/skills/system-spec-kit/mcp_server/README.md:46 | "The default `auto` cascade is cloud key when configured, then `llama-cpp` when the local GGUF runtime is available, then `hf-local` as the local fallback." | confirmed-residue | Rewrite provider resolution docs so `auto` falls through to hf-local when no API keys are present; document `llama-cpp` as explicit opt-in only. |
| L-002-005 | P1 | traceability | .opencode/skills/system-spec-kit/mcp_server/README.md:52 | "`EMBEDDINGS_PROVIDER=auto` resolves to `llama-cpp` after cloud providers." | confirmed-residue | Remove the auto-to-llama-cpp claim and describe synchronous migration only for explicit `EMBEDDINGS_PROVIDER=llama-cpp`. |
| L-002-006 | P1 | traceability | .opencode/skills/system-spec-kit/README.md:361 | "Compares meaning via embeddings (Voyage AI 1024d)" | confirmed-residue | Update the hybrid-search channel docs to name hf-local EmbeddingGemma q8 768d as the Memory MCP default. |
| L-002-007 | P1 | traceability | .opencode/skills/system-spec-kit/README.md:691 | "Recommended. Best retrieval quality. Requires `VOYAGE_API_KEY`" | confirmed-residue | Remove the recommendation from the provider table and mark Voyage as optional/fallback. |
| L-002-008 | P1 | traceability | .opencode/skills/system-spec-kit/shared/README.md:340 | "`HF_EMBEDDINGS_MODEL` ... `nomic-ai/nomic-embed-text-v1.5`" | confirmed-residue | Replace the stale HF model default with `onnx-community/embeddinggemma-300m-ONNX`, q8, 768 dims. |
| L-002-009 | P1 | traceability | .opencode/skills/system-spec-kit/shared/README.md:345 | "Auto-detection: Voyage if `VOYAGE_API_KEY` exists (recommended)" | confirmed-residue | Align provider precedence with post-014 behavior and remove the Voyage recommendation. |
| L-002-010 | P1 | traceability | .opencode/skills/mcp-coco-index/README.md:76 | "`sentence-transformers/all-MiniLM-L6-v2` (local, no API key)" | confirmed-residue | Change the documented default model to `google/embeddinggemma-300m` with 768-dimensional expectations. |
| L-002-011 | P1 | traceability | .opencode/skills/mcp-coco-index/README.md:77 | "`voyage/voyage-code-3` via LiteLLM (1024-dim, requires `VOYAGE_API_KEY`)" | confirmed-residue | Remove `voyage-code-3` as the primary model and present it only as optional LiteLLM configuration if retained. |
| L-002-012 | P1 | traceability | .opencode/skills/mcp-coco-index/INSTALL_GUIDE.md:437 | "**Primary (recommended):** `voyage/voyage-code-3` via LiteLLM provider -- best code search quality." | confirmed-residue | Rewrite the CocoIndex model section so sentence-transformers + `google/embeddinggemma-300m` is primary/default. |

--- iteration-003.md ---
| L-003-001 | P1 | maintainability | .opencode/skills/mcp-coco-index/assets/config_templates.md:140 | `"_NOTE_2": "Default embedding: all-MiniLM-L6-v2 (local, no API key needed)",` | confirmed-residue | Update the Claude MCP config template to advertise `google/embeddinggemma-300m`, bf16, 768 dims as the CocoIndex default. |
| L-003-002 | P1 | maintainability | .opencode/skills/mcp-coco-index/assets/config_templates.md:160 | `_NOTE_2 = "Default embedding: all-MiniLM-L6-v2 (local, no API key needed)"` | confirmed-residue | Update the Codex config template note to the post-014 EmbeddingGemma default. |
| L-003-003 | P1 | maintainability | .opencode/skills/mcp-coco-index/INSTALL_GUIDE.md:354 | `"_NOTE_2_EMBEDDING": "Default: all-MiniLM-L6-v2 (local, no API key needed)",` | confirmed-residue | Refresh the OpenCode install-guide config sample so copied configs do not reintroduce MiniLM. |
| L-003-004 | P1 | maintainability | .opencode/skills/mcp-coco-index/INSTALL_GUIDE.md:409 | `"_NOTE_2_EMBEDDING": "Default: all-MiniLM-L6-v2 (local, no API key needed)",` | confirmed-residue | Refresh the Claude install-guide config sample to the canonical CocoIndex EmbeddingGemma default. |
| L-003-005 | P1 | maintainability | .opencode/skills/mcp-coco-index/INSTALL_GUIDE.md:429 | `_NOTE_2 = "Default embedding: all-MiniLM-L6-v2 (local, no API key needed)"` | confirmed-residue | Refresh the Codex install-guide config sample to the canonical CocoIndex EmbeddingGemma default. |
| L-003-006 | P2 | maintainability | .opencode/skills/mcp-coco-index/manual_testing_playbook/manual_testing_playbook.md:301 | `embedding.model matches a documented model such as the default local sentence-transformers/all-MiniLM-L6-v2 or a LiteLLM model like voyage/voyage-code-3` | confirmed-residue | Regenerate CFG-001 playbook text so manual verification checks for `google/embeddinggemma-300m` instead of accepting stale defaults. |
| L-003-007 | P2 | maintainability | .opencode/skills/mcp-coco-index/manual_testing_playbook/03--configuration/001-default-model-verification.md:42 | `embedding.model matches a documented model such as sentence-transformers/all-MiniLM-L6-v2 or voyage/voyage-code-3` | confirmed-residue | Regenerate the per-scenario CFG-001 file with the post-014 default model and dimensions. |
| L-003-008 | P2 | maintainability | .opencode/skills/mcp-coco-index/feature_catalog/03--indexing-pipeline/04-embedding-provider-selection.md:23 | `Default user settings choose sentence-transformers/all-MiniLM-L6-v2.` | confirmed-residue | Regenerate the feature-catalog current-reality section to name `sentence-transformers` + `google/embeddinggemma-300m`. |
| L-003-009 | P2 | maintainability | .opencode/skills/mcp-coco-index/tests/test_settings.py:50 | `assert "all-MiniLM-L6-v2" in s.embedding.model` | confirmed-residue | Update the default settings test to assert `google/embeddinggemma-300m`. |
| L-003-010 | P2 | maintainability | .opencode/skills/mcp-coco-index/tests/test_config.py:49 | `assert "all-MiniLM-L6-v2" in config.embedding_model` | confirmed-residue | Update the env-derived config test to assert the canonical EmbeddingGemma model. |
| L-003-011 | P2 | maintainability | .opencode/skills/system-spec-kit/mcp_server/tests/fixtures/sample-memories.json:77 | `"content": "Vector embeddings use 384 dimensions for semantic search",` | confirmed-residue | Update fixture content to 768 dimensions or make it model-neutral so tests do not preserve MiniLM assumptions. |
| L-003-012 | P2 | maintainability | .opencode/skills/system-spec-kit/mcp_server/tests/fixtures/similarity-test-cases.json:139 | `"embeddingModel": "all-MiniLM-L6-v2",` | confirmed-residue | Update similarity fixture metadata to EmbeddingGemma and 768 dimensions, or remove model-specific metadata if not required. |
