Documentation Outline Extension

Documentation Outline Extension

Extension implementing outline protocol for documentation domain.

Provides domain-specific knowledge for deliverable creation in documentation tasks. Implements the outline extension protocol with defined sections that phase-3-outline calls explicitly.

Domain Detection

This domain is relevant when:

1. doc/ or docs/ directory exists
2. Request mentions "AsciiDoc", "ADR", "interface specification", "documentation"
3. Files have .adoc extension
4. Request mentions updating README or technical documentation

---

Assessment Protocol

Called by: phase-3-outline Step 3 Purpose: Determine which workflow applies (simple vs complex)

Workflow Selection Criteria

Conditional Standards

None - documentation domain has no additional standards to layer.

---

Simple Workflow

Called by: phase-3-outline Step 4 (when assessment = simple) Purpose: Create deliverables for isolated documentation changes

Domain-Specific Patterns

Grouping Strategy:

Change Type Mappings:

Standard File Paths:

• ADRs: doc/​adr/​ADR-NNN-{title}.adoc
• Interfaces: doc/​interfaces/​IF-NNN-{title}.adoc
• Architecture: doc/​architecture/​{topic}.adoc
• General: doc/​{topic}/
• README: README.md or README.adoc

Verification Commands:

• AsciiDoc validation: Check for proper formatting and structure
• Link verification: Validate all internal cross-references
• ADRs: Check ADR numbering sequence and status consistency
• Interfaces: Check interface numbering and completeness

---

Complex Workflow

Called by: phase-3-outline Step 4 (when assessment = complex) Purpose: Create deliverables for cross-document changes

Domain-Specific Patterns

Grouping Strategy:

Change Type Mappings:

Batch Analysis:

• Process related documents together (e.g., ADR and its superseded docs)
• Check cross-references when modifying any document
• Validate heading hierarchy in modified documents

---

Discovery Patterns

Called by: Both workflows during file enumeration Purpose: Provide domain-specific Glob/​Grep patterns

Grep Patterns

Glob Patterns

Comprehensive Discovery

For cross-cutting documentation changes:

# Find all AsciiDoc files
find doc/ -name "*.adoc" -type f

# Check ADR sequence
ls -1 doc/​adr/​ADR-*.adoc 2>/​dev/​null | sort

# Check interface specs
ls -1 doc/​interfaces/​IF-*.adoc 2>/​dev/​null | sort