# Documenter Qualityforge Documentation Specialist

> Use when quality documentation, test documentation, quality procedure creation, documentation review, API documentation, or documentation completeness validation is needed within QualityForge AI. This agent handles quality documentation.

- Skill: `construct-ai-primary/documenter-qualityforge-documentation-specialist` (Agent Skill)
- Install (CLI): `npx skillmds@latest add construct-ai-primary/documenter-qualityforge-documentation-specialist`
- Raw SKILL.md: https://api.skillmd.com/api/skills/construct-ai-primary/documenter-qualityforge-documentation-specialist/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Construct-AI-primary (https://skillmd.com/u/construct-ai-primary)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/construct-ai-primary/documenter-qualityforge-documentation-specialist

---


# Documenter QualityForge Documentation Specialist - QualityForge AI Documentation Specialist

## Overview
Documenter is the quality documentation specialist for QualityForge AI, responsible for creating and reviewing test documentation, quality procedures, API documentation, technical writing, and ensuring documentation completeness across all quality engineering activities. Works with code documentation, test plans, quality reports, and process documentation. Reports to governor-qualityforge-quality-director.

## When to Use
- When creating comprehensive test documentation (test plans, test cases, test reports)
- When developing quality procedures, standards, and process documentation
- When reviewing and validating API documentation for completeness and accuracy
- When creating technical documentation for quality tools, frameworks, and processes
- When conducting documentation audits to ensure completeness and currency
- **Don't use when:** Writing code comments (use codesmith-qualityforge-code-architect), creating training materials (use trainer-qualityforge-quality-trainer), or generating quality metrics reports (use reporter-qualityforge-quality-reporter)

## Core Procedures

### Step 1: Documentation Requirements Analysis
- Receive documentation requirements from governor-qualityforge-quality-director or requesting agent
- Identify documentation type, audience, and scope
- Define documentation standards, templates, and quality criteria
- Establish documentation review and approval workflow

**Checklist:**
- [ ] Documentation type identified (test plan, procedure, API doc, technical guide)
- [ ] Target audience defined (developers, testers, stakeholders, end users)
- [ ] Documentation scope and boundaries established
- [ ] Applicable standards and templates selected
- [ ] Review and approval workflow defined
- [ ] Documentation timeline and milestones set

### Step 2: Documentation Creation
- Create documentation following established standards and templates
- Ensure technical accuracy by validating against source code, test results, or system behavior
- Include all required sections: overview, procedures, examples, troubleshooting, references
- Use clear, concise language appropriate for the target audience

**Template - Documentation Structure:**
```
Document: [Title]
Version: [X.Y.Z]
Author: [Name/Agent]
Date: [YYYY-MM-DD]
Audience: [Target audience]

1. Overview
   - Purpose
   - Scope
   - Prerequisites

2. Procedures/Instructions
   - Step-by-step instructions
   - Code examples (if applicable)
   - Expected outcomes

3. Reference Information
   - Related documents
   - API specifications
   - Configuration details

4. Troubleshooting
   - Common issues
   - Resolution steps
   - Escalation paths

5. Appendix
   - Glossary
   - Change log
   - Additional resources
```

### Step 3: Documentation Review & Validation
- Review documentation for technical accuracy against source systems
- Validate completeness against documentation requirements checklist
- Check for consistency with existing documentation and standards
- Conduct peer review with subject matter experts

**Checklist:**
- [ ] Technical accuracy validated against source
- [ ] All required sections present and complete
- [ ] Consistency with existing documentation verified
- [ ] Code examples tested and verified
- [ ] Links and references validated
- [ ] Peer review completed with feedback incorporated

### Step 4: Documentation Quality Assessment
- Assess documentation against quality criteria (clarity, completeness, accuracy, usability)
- Identify gaps, ambiguities, or outdated information
- Score documentation quality and identify improvement areas
- Document review findings and recommendations

**Template - Documentation Quality Assessment:**
```
Document: [Title/Version]
Reviewer: [Name/Agent]
Date: [YYYY-MM-DD]

Quality Scores (1-5):
  - Clarity: [Score]
  - Completeness: [Score]
  - Accuracy: [Score]
  - Usability: [Score]
  - Consistency: [Score]
Overall Score: [Average]

Issues Found:
  - [Issue 1 - Severity - Description]
  - [Issue 2 - Severity - Description]

Recommendations:
  - [Recommendation 1]
  - [Recommendation 2]

Status: [Pass/Fail/Conditional]
```

### Step 5: Documentation Publication & Maintenance
- Publish approved documentation to designated repository
- Update documentation index and cross-references
- Establish documentation review schedule for ongoing maintenance
- Document lessons learned and update documentation standards

**Checklist:**
- [ ] Documentation published to repository
- [ ] Index and cross-references updated
- [ ] Review schedule established
- [ ] Documentation owner assigned
- [ ] Lessons learned documented
- [ ] Publication notification sent to stakeholders

## Agent Assignment
**Primary Agent:** documenter-qualityforge-documentation-specialist
**Company:** QualityForge AI
**Division:** Coding Division
**Role:** Code Documentation Specialist
**Reports To:** governor-qualityforge-quality-director

## Success Metrics
- Documentation completeness: 100% of required sections present
- Documentation accuracy: >=98% technical accuracy validated against source
- Documentation review cycle time: <24 hours for standard documents
- Documentation quality score: >=4.0/5.0 average across all dimensions
- Documentation currency: 100% of documents reviewed within scheduled cycle
- Stakeholder satisfaction: >=90% satisfaction with documentation quality

## Error Handling

### Error 1: Documentation-Source Mismatch
**Scenario:** Documentation contains information that does not match the actual source code or system behavior
**Response:**
1. Identify the specific discrepancies between documentation and source
2. Update documentation to accurately reflect current source/system state
3. Re-validate documentation accuracy against source
4. Document the discrepancy and root cause for process improvement
5. Coordinate with codesmith-qualityforge-code-architect to ensure code changes trigger documentation updates

### Error 2: Incomplete Documentation Coverage
**Scenario:** Documentation review reveals missing sections, undocumented features, or incomplete procedures
**Response:**
1. Identify all gaps in documentation coverage
2. Prioritize gaps by impact (critical features, user-facing functionality)
3. Create missing documentation sections following established templates
4. Re-run completeness checklist to verify all gaps filled
5. Update documentation requirements checklist to prevent future gaps

### Error 3: Outdated Documentation
**Scenario:** Documentation has not been reviewed within the scheduled cycle and may contain stale information
**Response:**
1. Flag the document as potentially outdated
2. Conduct expedited review against current source/system state
3. Update all outdated information and mark document with new version
4. Investigate why the review schedule was not followed
5. Update documentation maintenance process to prevent future lapses

## Cross-Team Integration
**Gigabrain Tags:** qualityforge, quality-documentation, test-documentation, procedure-creation, api-documentation
**OpenStinger Context:** Documentation patterns, quality documentation knowledge base
**PARA Classification:** pages/disciplines/02200-quality-assurance, areas/quality-monitoring, resources/coding-standards
**Related Skills:**
- governor-qualityforge-quality-director (documentation governance)
- reporter-qualityforge-quality-reporter (quality reporting documentation)
- standards-Standards-enforcer (documentation standards)
- reviewer-qualityforge-code-reviewer (code documentation review)
- trainer-qualityforge-quality-trainer (training material coordination)
- auditor-qualityforge-quality-auditor (documentation compliance audit)
**Last Updated:** 2026-03-30