Claude Skill

compound-docs

Searchable Elixir/Phoenix/Ecto solution documentation system with YAML

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download oliver-kriska-claude-elixir-phoenix-targets_amp_skills_compound-docs-9767a82.zip · 3 KB

Install

skills CLI npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/targets/amp/skills/compound-docs
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install oliver-kriska-claude-elixir-phoenix@llmmart
Git git clone https://github.com/oliver-kriska/claude-elixir-phoenix.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole oliver-kriska/claude-elixir-phoenix collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Compound Docs — Institutional Knowledge Base

Searchable, categorized solution documentation that makes each debugging session easier than the last.

Directory Structure

.claude/solutions/
├── ecto-issues/
├── liveview-issues/
├── oban-issues/
├── otp-issues/
├── security-issues/
├── testing-issues/
├── phoenix-issues/
├── deployment-issues/
├── performance-issues/
└── build-issues/

Iron Laws

  1. ALWAYS search solutions before investigating — Check .claude/solutions/ for existing fixes before debugging
  2. YAML frontmatter is MANDATORY — Every solution needs validated metadata per references/schema.md
  3. One problem per file — Never combine multiple solutions
  4. 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 Grep to search .claude/solutions/ by symptom (e.g., NotLoaded), by tag (e.g., tags:.*preload), or by component (e.g., component: ecto).

Integration

  • phx-compound creates solution docs here
  • phx-investigate searches here before debugging
  • phx-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
Files (claude-elixir-phoenix)
  • references
    • resolution-template.md 2.8 KB
      Loading…
    • schema.md 2.8 KB
      Loading…
  • SKILL.md 2.2 KB
    ---
    name: compound-docs
    description: Searchable Elixir/Phoenix/Ecto solution documentation system with YAML
      frontmatter. Builds institutional knowledge from solved problems. Use when consulting
      past solutions before investigating new issues.
    ---
    
    # Compound Docs — Institutional Knowledge Base
    
    Searchable, categorized solution documentation that makes each
    debugging session easier than the last.
    
    ## Directory Structure
    
    ```
    .claude/solutions/
    ├── ecto-issues/
    ├── liveview-issues/
    ├── oban-issues/
    ├── otp-issues/
    ├── security-issues/
    ├── testing-issues/
    ├── phoenix-issues/
    ├── deployment-issues/
    ├── performance-issues/
    └── build-issues/
    ```
    
    ## Iron Laws
    
    1. **ALWAYS search solutions before investigating** — Check
       `.claude/solutions/` for existing fixes before debugging
    2. **YAML frontmatter is MANDATORY** — Every solution needs
       validated metadata per `references/schema.md`
    3. **One problem per file** — Never combine multiple solutions
    4. **Include prevention** — Every solution documents how to
       prevent recurrence
    
    ## Solution File Format
    
    ```markdown
    ---
    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 Grep to search `.claude/solutions/` by symptom (e.g., `NotLoaded`), by tag (e.g., `tags:.*preload`), or by component (e.g., `component: ecto`).
    
    ## Integration
    
    - `phx-compound` creates solution docs here
    - `phx-investigate` searches here before debugging
    - `phx-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
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.