moai-docs-unified

name	moai-docs-unified
version	4.0.0
created	2025-11-12T00:00:00.000Z
updated	2025-11-12T00:00:00.000Z
status	stable
tier	specialization
description	Enhanced docs unified with AI-powered features. Enhanced with Context7 MCP for up-to-date documentation.
allowed-tools	Read, Glob, Grep, WebSearch, WebFetch, mcp__context7__resolve-library-id, mcp__context7__get-library-docs
primary-agent	doc-syncer
secondary-agents	["alfred"]
keywords	["docs","unified","cd","ci","test"]
tags	["documentation"]
orchestration	null
can_resume	true
typical_chain_position	terminal
depends_on	[]

moai-docs-unified

Docs Unified

Primary Agent: doc-syncer
Secondary Agents: alfred
Version: 4.0.0
Keywords: docs, unified, cd, ci, test

---

📖 Progressive Disclosure

Level 1: Quick Reference (Core Concepts)

📚 Content

Section 1: Unified Framework Overview

The moai-docs-unified skill provides a complete documentation management ecosystem integrating 5 specialized validation scripts:

Core Components:

• Phase 1: Markdown Linting (syntax, structure, links)
• Phase 2: Mermaid Diagram Validation (syntax, rendering, type checking)
• Phase 2.5: Mermaid Detail Extraction (code preview, rendering guide)
• Phase 3: Korean Typography Validation (UTF-8, full-width chars, spacing)
• Phase 4: Comprehensive Report Generation (aggregation, prioritization, recommendations)

Key Benefits:

• Catch documentation errors before publication
• Ensure consistency across 4 languages (ko, en, ja, zh)
• Validate diagram syntax and rendering capability
• Maintain Korean language best practices
• Generate actionable quality reports

Section 2: Script Specifications

Script 1: lint_korean_docs.py

Purpose: Comprehensive markdown validation for Korean documentation

Location: .claude/skills/moai-docs-unified/scripts/lint_korean_docs.py

Key Validations:

• Header structure (H1 uniqueness, level hierarchy)
• Code blocks (language declaration, matching delimiters)
• Links (relative paths, file existence, https protocol)
• Lists (marker consistency, indentation)
• Tables (column count, alignment)
• Korean-specific (full-width chars, encoding)

Execution:

# From project root
uv run .claude/skills/moai-docs-unified/scripts/lint_korean_docs.py

# With custom paths
uv run .claude/skills/moai-docs-unified/scripts/lint_korean_docs.py \
  --path docs/src/ko \
  --output .moai/reports/lint_report_ko.txt