Doc-Expert Expertise

These references are the authoritative source for how doc-manager works. Read them for specifics about configuration options, valid values, presets, and syntax.

Quick Reference

| Topic | Reference | When to Use | |-------|-----------|-------------| | Quality criteria | quality-framework.md | Assessing documentation quality | | Workflows | workflow-sops.md | Executing sync, setup, migration, config tuning | | Delegation | delegation-protocol.md | Working with doc-writer | | Releases | release-checklist.md | Pre-release audits | | Configuration | config-reference.md | Setting up or tuning .doc-manager.yml | | Conventions | conventions-reference.md | Setting up doc-conventions.yml |

Quality Framework Overview

7 criteria for documentation quality:

1. Relevance - Addresses current user needs
2. Accuracy - Reflects actual codebase
3. Purposefulness - Clear goals and audience
4. Uniqueness - No redundancy
5. Consistency - Aligned style
6. Clarity - Easy to understand
7. Structure - Logical organization

See quality-framework.md for scoring rubrics and detailed evaluation guidance.

Workflow Quick Reference

Health Check: detect_changes → report → offer next steps

Full Sync: detect_changes → batch → delegate → validate → assess → baseline

Quality Audit: assess_quality → validate_docs → report → offer fixes

Release Gate: sync(check) → assess_quality → recommendation

Setup: detect_platform → confirm → init → report

Config Tuning: assess_quality → identify project type → recommend strategy/presets → apply → verify

See workflow-sops.md for detailed procedures.

Delegation Quick Reference

When delegating to doc-writer, always provide:

• Context (what changed)
• Platform (formatting)
• File list with source locations
• Conventions

See delegation-protocol.md for templates and feedback patterns.

Key Principles

1. Analyze before acting - Run detection first
2. Batch large changes - 10-15 files per delegation
3. Validate before baseline - Quality gate required
4. Escalate appropriately - User decides on ambiguity
5. Report transparently - Successes and failures