librarian

Analyze codebases to detect drift across architecture docs, catalogs, and memory files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ahostbr/dotcodex --skill librarian-ahostbr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: librarian
Source: https://github.com/ahostbr/dotcodex/tree/main/skills/librarian
Command: npx skills add https://github.com/ahostbr/dotcodex --skill librarian-ahostbr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Librarian helps ensure that architecture documentation, skill catalogs, and memory mappings accurately reflect the current codebase by detecting drift and proposing fixes.

Core Features & Use Cases

  • Dispatches four scout agents to audit architecture docs, catalogs, memory files, and dead references in parallel.
  • Synthesizes comprehensive reports and auto-fixes drift between documentation and code state.
  • Provides on-demand workspace health checks and memory consolidation to maintain correctness.

Quick Start

Run the Librarian to survey architecture docs, catalogs, memory entries, and dead references and generate a drift report.

Frequently Asked Questions about librarian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect drift between architecture documentation and my actual codebase?

To detect drift between architecture documentation and your codebase, you can run parallel read-only scouts that audit architecture docs, catalogs, memory files, and dead references against repository state. This generates a consolidated report highlighting inconsistencies and guiding corrective actions.

What is code drift detection and how does it verify documentation accuracy?

Code drift detection is the process of comparing architecture docs and memory mappings against the actual repository state to find inconsistencies. It works by dispatching parallel scouts to verify catalogs and dead references, returning structured findings that expose where documentation no longer matches code.

How do I fix memory mapping inconsistencies and dead references in my repository?

You can fix memory mapping inconsistencies and dead references by analyzing the codebase to identify drift, then applying synthesized reports to auto-fix the discrepancies. This process audits memory files and dead references in parallel to propose targeted corrective actions and consolidate memory.

Can I audit skill catalogs and memory files without modifying my repository?

Yes, you can audit skill catalogs and memory files without modifying your repository because the verification process uses four read-only scouts. These scouts analyze architecture docs and dead references in parallel, ensuring the audit is non-destructive while returning structured findings.

When do I need to run a workspace health check for architecture docs and memory mappings?

You need to run a workspace health check for architecture docs and memory mappings when you suspect documentation drift has occurred. This on-demand check surveys your codebase to verify that catalogs and memory files accurately reflect the current repository state, returning a structured drift report.