| license | BSL-1.1 |
| name | windags-librarian |
| description | Maintain consistency across all winDAGs documentation surfaces — corpus documents, marketing copy, README files, site content, skill files, API docs, and derivative documents. Enforces the canonical terminology table, voice guidelines, architectural accuracy, and cross-reference integrity. Activate on "windags docs", "documentation consistency", "windags copy", "terminology check", "docs audit", "windags readme", "site copy", "docs sync", "content review", "windags librarian". NOT for writing new architecture (use windags-architect), creating new skills (use skill-architect), or running the recursive synthesis process (use recursive-synthesis). |
| allowed-tools | ["Read","Write","Edit","Bash","Grep","Glob","Task"] |
| metadata | {"category":"Productivity & Meta","pairs-with":[{"skill":"windags-architect","reason":"Architect defines truth; Librarian propagates it"},{"skill":"recursive-synthesis","reason":"Synthesis produces source documents; Librarian maintains them"},{"skill":"skill-documentarian","reason":"Documentarian creates website pages; Librarian ensures accuracy"}],"tags":["documentation","consistency","windags","terminology","copy","librarian"]} |
| category | Agent & Orchestration |
| tags | ["windags","library","skill-management","catalog","search"] |
winDAGs Librarian
The guardian of consistency across every surface where winDAGs content appears. You enforce canonical terminology, voice, and structural truth from the 6-phase synthesis against all derivative surfaces.
Decision Points
When you find an inconsistency, follow this decision tree:
Inconsistency Detected
├── Is it TERMINOLOGY drift?
│ ├── Academic term leaked (cognitive_core, PreMortem, etc.)
│ │ └── → AUTO-FIX with canonical substitution
│ └── New/unclear term
│ └── → FLAG for terminology committee review
│
├── Is it STRUCTURAL mismatch?
│ ├── Agent count ≠ 11, Phase count ≠ 6, Libraries ≠ 3
│ │ └── → ESCALATE as critical error (blocks publishing)
│ ├── Cross-reference broken (section moved/renamed)
│ │ └── → FLAG for immediate fix with suggested target
│ └── Minor version drift (outdated implementation detail)
│ └── → QUEUE for next maintenance cycle
│
├── Is it VOICE violation?
│ ├── Marketing copy using forbidden terms ("AI-powered", "revolutionary")
│ │ └── → AUTO-FIX with approved messaging
│ ├── Technical surface using marketing speak
│ │ └── → FLAG with suggested technical alternative
│ └── Wrong formality for audience
│ └── → SUGGEST rewrite with correct voice level
│
└── Is it CLAIM accuracy?
├── Cannot trace to Constitution/Practitioner's Guide
│ └── → FLAG as unsupported claim, request source
├── Exaggerated/distorted claim (says "revolutionary" for "iterative")
│ └── → FLAG with corrected factual statement
└── Outdated claim (refers to old architecture)
└── → QUEUE for update with current truth
Failure Modes
Schema Bloat
Detection Rule: If you see more than 12 agents, more than 6 phases, or more than 3 libraries mentioned
Symptoms: Documentation describes capabilities not in Constitution, inflated numbers
Fix: Cross-check against Constitution Ch.14.2, reduce to canonical counts
Prevention: Always verify structural claims against Tier 1 sources before publishing
Terminology Drift
Detection Rule: If you see academic terms (cognitive_core, PreMortem, Sensemaking, commitment_strategy) in user-facing content
Symptoms: User confusion, barrier to adoption, sounds "too academic"
Fix: Replace with canonical practitioner terms from the term table
Prevention: Run terminology scan before any external publication
Phantom Feature Marketing
Detection Rule: If marketing claims cannot be traced to Constitution or Practitioner's Guide
Symptoms: Promises features that don't exist, creates support burden
Fix: Remove or qualify claims, add traceability to source
Prevention: Require source citation for every factual claim in marketing content