| name | elixir-phoenix-compound-docs |
| description | Search past Phoenix solution docs before starting a new investigation. |
| metadata | {"short-description":"Search Phoenix solution docs"} |
Compound Docs โ Institutional Knowledge Base
Searchable, categorized solution documentation that makes each
debugging session easier than the last.
Directory Structure
.codex/solutions/
โโโ ecto-issues/
โโโ liveview-issues/
โโโ oban-issues/
โโโ otp-issues/
โโโ security-issues/
โโโ testing-issues/
โโโ phoenix-issues/
โโโ deployment-issues/
โโโ performance-issues/
โโโ build-issues/
Iron Laws
- ALWAYS search solutions before investigating โ Check
.codex/solutions/ for existing fixes before debugging
- YAML frontmatter is MANDATORY โ Every solution needs
validated metadata per
references/schema.md
- One problem per file โ Never combine multiple solutions
- Include prevention โ Every solution documents how to
prevent recurrence
Solution File Format
---
module: "Accounts"
date: "2025-12-01"
problem_type: runtime_error
component: ecto_schema
symptoms:
- "Ecto.Association.NotLoaded on user.posts"
root_cause: missing_preload
severity: medium
tags: [preload, association, n-plus-one]
---
# Association NotLoaded on User Posts
## Symptoms
Ecto.Association.NotLoaded raised when accessing user.posts
in UserListLive after filtering.
## Root Cause
Query in Accounts context missing preload for :posts.
## Solution
Added `Repo.preload(:posts)` to `list_users/1`.
## Prevention
Use n1-check skill before shipping list views.
Searching Solutions
Use rg to search .codex/solutions/ by symptom (e.g., NotLoaded), by tag (e.g., tags:.*preload), or by component (e.g., component: ecto).
Integration
elixir-phoenix-compound creates solution docs here
elixir-phoenix-investigate searches here before debugging
elixir-phoenix-plan consults for known risks
learn-from-fix feeds into this system
References
references/schema.md โ YAML frontmatter validation schema
references/resolution-template.md โ Full solution template