diff --git a/tasks/pkgs/air.yml b/tasks/pkgs/air.yml
index d0d5377..ccce64f 100644
--- a/tasks/pkgs/air.yml
+++ b/tasks/pkgs/air.yml
@@ -3,8 +3,7 @@
 ## Package: air
 ## Description: application auto reload for go
 ## Version: latest
-## Methods:
-##   - source (go install)
+## Methods: source
 ## Helpers: go_install
 ---
 - name: Set air default facts # {{{
diff --git a/tasks/pkgs/alacritty.yml b/tasks/pkgs/alacritty.yml
index e7de935..f0c86d9 100644
--- a/tasks/pkgs/alacritty.yml
+++ b/tasks/pkgs/alacritty.yml
@@ -3,11 +3,8 @@
 ## Package: alacritty
 ## Description: GPU accelerated terminal emulator written in rust
 ## Version: v0.16.1
-## Methods:
-##   - system
-##   - source (cargo build)
-## Helpers:
-##   - cargo_build
+## Methods: [source, system]
+## Helpers: cargo_build
 ---
 - name: Set alacritty default facts # {{{
   ansible.builtin.set_fact:
diff --git a/tasks/pkgs/ansible.yml b/tasks/pkgs/ansible.yml
index 8319ae7..1f3a426 100644
--- a/tasks/pkgs/ansible.yml
+++ b/tasks/pkgs/ansible.yml
@@ -3,15 +3,15 @@
 ## Package: ansible
 ## Description: simple infrastructure as code tool
 ## Version: latest
-## Methods:
-##   - system
-##   - source (pipx)
+## Methods: [system, source]
+## Helpers: pipx
 ---
 - name: Set ansible default facts # {{{
   ansible.builtin.set_fact:
     ansible:
       install_methods:
         - system
+        - source
       pkgname:
         RedHat: ansible
         Debian: ansible
diff --git a/tasks/pkgs/ansible_ls.yml b/tasks/pkgs/ansible_ls.yml
index 30cec88..277556e 100644
--- a/tasks/pkgs/ansible_ls.yml
+++ b/tasks/pkgs/ansible_ls.yml
@@ -3,9 +3,7 @@
 ## Package: ansible_ls
 ## Description: language server for ansible yaml
 ## Version: latest
-## Methods:
-##   - source (npm)
-##   - system
+## Methods: [source, system]
 ## Helpers: npm
 ---
 - name: Set ansible_ls default facts # {{{
diff --git a/tasks/pkgs/bashls.yml b/tasks/pkgs/bashls.yml
index e8ea92a..b08fa21 100644
--- a/tasks/pkgs/bashls.yml
+++ b/tasks/pkgs/bashls.yml
@@ -3,8 +3,7 @@
 ## Package: bashls
 ## Description: language server for bash (sh compatible)
 ## Version: latest
-## Methods:
-##   - source (npm)
+## Methods: source
 ## Helpers: npm
 ---
 - name: Set bashls default facts # {{{
diff --git a/tasks/pkgs/bat.yml b/tasks/pkgs/bat.yml
index 397cf6d..fef6532 100644
--- a/tasks/pkgs/bat.yml
+++ b/tasks/pkgs/bat.yml
@@ -3,8 +3,8 @@
 ## Package: bat
 ## Description: cat replacement with style
 ## Version: latest
-## Methods:
-##   - source
+## Methods: source
+## Helpers: cargo
 ---
 - name: Start bat configuration
   when:
diff --git a/tasks/pkgs/btop.yml b/tasks/pkgs/btop.yml
index 0c65712..8f668e4 100644
--- a/tasks/pkgs/btop.yml
+++ b/tasks/pkgs/btop.yml
@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: btop
+## Description: TUI system monitor that looks
+## Version: system
+## Methods: system
+## Helpers: -
 ---
 - name: Set default btop options
   ansible.builtin.set_fact:
diff --git a/tasks/pkgs/buf.yml b/tasks/pkgs/buf.yml
index dfbdc9a..7283d7a 100644
--- a/tasks/pkgs/buf.yml
+++ b/tasks/pkgs/buf.yml
@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: buf
+## Description: A CLI tool for working with protocols buffers
+## Version: latest
+## Methods: source
+## Helpers: go_install
 ---
 - name: Set default buf values
   ansible.builtin.set_fact:
diff --git a/tasks/pkgs/bufls.yml b/tasks/pkgs/bufls.yml
index b008b48..010cfce 100644
--- a/tasks/pkgs/bufls.yml
+++ b/tasks/pkgs/bufls.yml
@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: bufls
+## Description: a language server for protocol buffers
+## Version: latest
+## Methods: source
+## Helpers: go_install
 ---
 - name: Set default bufls options
   ansible.builtin.set_fact:
diff --git a/tasks/pkgs/cargo.yml b/tasks/pkgs/cargo.yml
index 28f0de5..705f193 100644
--- a/tasks/pkgs/cargo.yml
+++ b/tasks/pkgs/cargo.yml
@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: cargo
+## Description: the Rust package manager
+## Version: system
+## Methods: system
+## Helpers: -
 ---
 - name: Set default cargo values
   ansible.builtin.set_fact:
diff --git a/tasks/pkgs/cbfmt.yml b/tasks/pkgs/cbfmt.yml
index 8c1114b..d125acd 100644
--- a/tasks/pkgs/cbfmt.yml
+++ b/tasks/pkgs/cbfmt.yml
@@ -1,7 +1,10 @@
 # vim: set filetype=yaml.ansible :
 #
 ## Package: cbfmt
-## Description
+## Description: code block formatter
+## Version: system
+## Methods: system
+## Helpers: -
 ---
 - name: Set default cbfmt values
   ansible.builtin.set_fact:
diff --git a/tasks/pkgs/cheat.yml b/tasks/pkgs/cheat.yml
index a2c2c26..ca972dc 100644
--- a/tasks/pkgs/cheat.yml
+++ b/tasks/pkgs/cheat.yml
@@ -1,9 +1,10 @@
 # vim: set filetype=yaml.ansible :
 #
 ## Package: cheet
+## Description: create and view interactive cheat sheets
 ## Version: latest
 ## Methods: source
-## Helpers: go
+## Helpers: go_install
 ---
 - name: Set cheat default facts # {{{
   ansible.builtin.set_fact:
diff --git a/tasks/pkgs/checkmake.yml b/tasks/pkgs/checkmake.yml
index c854820..6624c48 100644
--- a/tasks/pkgs/checkmake.yml
+++ b/tasks/pkgs/checkmake.yml
@@ -4,7 +4,7 @@
 ## Description: linter for makefiles
 ## Version: latest
 ## Methods: source
-## Helpers: go
+## Helpers: go_install
 ---
 - name: Set checkmake default facts
   ansible.builtin.set_fact:
diff --git a/tasks/pkgs/choose.yml b/tasks/pkgs/choose.yml
index 324d76f..33b266b 100644
--- a/tasks/pkgs/choose.yml
+++ b/tasks/pkgs/choose.yml
@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: choose
+## Description:
+## Version: latest
+## Methods: source
+## Helpers: cargo
 ---
 - name: Add choose
   block:
diff --git a/tasks/pkgs/clangd.yml b/tasks/pkgs/clangd.yml
index 62abf8e..ebd9822 100644
--- a/tasks/pkgs/clangd.yml
+++ b/tasks/pkgs/clangd.yml
@@ -1,9 +1,38 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: clangd
+## Description: a c/c++ language server for the clang llvm compiler
+## Version: system
+## Methods: system
+## Helpers: -
 ---
-- name: Load clangd config
-  ansible.builtin.include_tasks:
-    file: config/clangd.yml
-
-- name: Append clangd to pkg_sys
+- name: Set clangd default facts
   ansible.builtin.set_fact:
-    pkg_sys: "{{ pkg_sys + clangd.pkgs }}"
+    clangd:
+      install_methods:
+        - system
+      pkgname:
+        RedHat: clang-devel
+        Debian: clang-12
+        Darwin: llvm
+        Alpine: clang19
+
+- name: Configure clangd
+  when:
+    - "'clangd' not in __configured"
+  block:
+    - name: Set clangd install method
+      when:
+        - clangd_install_method is undefined
+      ansible.builtin.set_fact:
+        clangd_install_method: "{{ install_method if install_method in clangd.install_methods else clangd.install_methods[0] }}"
+
+    - name: Queue clangd system install
+      when:
+        - clangd_install_methods == 'system'
+      ansible.builtin.set_fact:
+        pkg_sys: "{{ pkg_sys + clangd[os_family] }}"
+
+    - name: Finalise clangd configuration
+      ansible.builtin.set_fact:
+        __configured: "{{ __configured | combine( { 'clangd': clangd_install_method } ) }}"