🇺🇸English

Paths: File paths (shared/, references/, ../ln-*) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root. If shared/ is missing, fetch files via WebFetch from https://raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path}.

Type: L1 Top Orchestrator Category: 1XX Documentation Pipeline

Documentation Pipeline (Orchestrator)

This skill orchestrates the creation of a complete documentation system by invoking L2 coordinator + 4 L2 workers. The coordinator (ln-110) delegates to 5 L3 workers for project docs; other L2 workers handle reference/tasks/test domains. Each component validates its own output.

Purpose

Top-level orchestrator that creates a complete project documentation system in one invocation. Chains ln-110 coordinator + ln-120/130/140 workers sequentially, then runs global cleanup (deduplication, orphan reporting, cross-link validation).

Architecture

ln-100-documents-pipeline (L1 Top Orchestrator - this skill)
├── ln-110-project-docs-coordinator (L2 Coordinator)
│   ├── ln-111-root-docs-creator (L3 Worker) → 4 docs
│   ├── ln-112-project-core-creator (L3 Worker) → 3 docs
│   ├── ln-113-backend-docs-creator (L3 Worker) → 2 conditional
│   ├── ln-114-frontend-docs-creator (L3 Worker) → 1 conditional
│   └── ln-115-devops-docs-creator (L3 Worker) → 1 conditional
├── ln-120-reference-docs-creator (L2 Worker)
├── ln-130-tasks-docs-creator (L2 Worker)
├── ln-140-test-docs-creator (L2 Worker - optional)
└── ln-610-docs-auditor (L2 Coordinator - optional, delegates to ln-611/612/613/614)

When to Use This Skill

This skill should be used when:

• Start a new IT project and need complete documentation system at once
• Use automated workflow instead of manually invoking multiple workers
• Create entire documentation structure (CLAUDE.md → docs/) in one go
• Prefer orchestrated CREATE path over manual skill chaining
• Need automatic global cleanup (deduplication, orphaned files, consolidation)

Alternative : If you prefer granular control, invoke workers manually:

1. ln-110-project-docs-coordinator - Root + Project docs (coordinates 5 L3 workers)
2. ln-120-reference-docs-creator - reference/ structure
3. ln-130-tasks-docs-creator - tasks/README.md + kanban
4. ln-140-test-docs-creator - tests/README.md (optional)

Note : Each worker now validates its own output in Phase 2/3. Orchestrator handles global operations only.

Workflow

The skill follows a 6-phase orchestration workflow: Legacy Migration (optional) → User confirmation → Invoke coordinator + 4 workers sequentially → Global cleanup → Documentation Audit (optional) → Summary.

---

Phase 0: Legacy Migration (OPTIONAL)

Objective : Detect existing documentation in non-standard formats, extract valuable content, and prepare for migration.

Trigger : Always runs at pipeline start. User can skip if no legacy docs or wants to keep existing structure.

Process :

0a. Legacy Detection :

• Scan project for non-standard documentation using patterns from references/legacy_detection_patterns.md:
  • Root .md files : ARCHITECTURE.md, REQUIREMENTS.md, STACK.md, API.md, DATABASE.md, DEPLOYMENT.md
  • Legacy folders : documentation/, doc/, wiki/, with wrong structure

0b. Content Extraction :

• For each detected legacy file:
  • Parse markdown structure (headers, lists, code blocks)
  • Apply type-specific extractor (MANDATORY READ: Load references/legacy_detection_patterns.md):
    • architecture_extractor → { layers[], components[], diagrams[] }
    • requirements_extractor → { functional[], non_functional[] }
    • tech_stack_extractor → { frontend, backend, database, versions }
    • principles_extractor → { principles[], anti_patterns[] }
    • api_spec_extractor → { endpoints[], authentication }
    • database_schema_extractor → { tables[], relationships[] }
    • runbook_extractor → { prerequisites[], install_steps[], env_vars[] }

0c. User Confirmation :

• Display detected legacy files:

  📂 Legacy Documentation Detected:
  
  | File | Type | Confidence | Target |
  |------|------|------------|--------|
  | README.md (## Architecture) | architecture | HIGH | docs/project/architecture.md |
  | docs/ARCHITECTURE.md | architecture | HIGH | docs/project/architecture.md |
  | CONTRIBUTING.md (## Development) | principles | MEDIUM | docs/principles.md |
  
  🔄 Migration Options:
  1. MIGRATE (recommended): Extract → Inject → Archive → Delete
  2. ARCHIVE ONLY: Backup without extraction
  3. SKIP: Leave legacy as-is (may cause duplication)
  
  Choose option (1/2/3): _
  

• If user selects "1" (MIGRATE):

  • Optional: "Review extracted content before injection? (yes/no)"
  • Confirm: "Proceed with migration and archive legacy files?"

• If user selects "2" (ARCHIVE ONLY):

  • Confirm: "Archive legacy files to .archive/? Content will NOT be extracted."

• If user selects "3" (SKIP):

  • Warn: "Legacy files will remain. This may cause duplication issues."
  • Proceed to Phase 1

0d. Backup and Archive :

• Create .archive/legacy-{timestamp}/ directory

• Structure:

  .archive/
  └── legacy-YYYY-MM-DD-HHMMSS/
      ├── README_migration.md        # Rollback instructions
      ├── original/                  # Exact copies of legacy files
      │   ├── README.md
      │   ├── ARCHITECTURE.md
      │   └── documentation/
      └── extracted/                 # Extracted content (for reference)
          ├── architecture_content.md
          └── principles_content.md
  

• Copy all legacy files to original/

• Save extracted content to extracted/

• Generate README_migration.md with rollback instructions

0e. Content Injection :

• Build migration_context from extracted content:

  {
    "LEGACY_CONTENT": {
      "legacy_architecture": { "sections": [...], "diagrams": [...] },
      "legacy_requirements": { "functional": [...] },
      "legacy_principles": { "principles": [...] },
      "legacy_tech_stack": { "frontend": "...", "backend": "..." },
      "legacy_api": { "endpoints": [...] },
      "legacy_database": { "tables": [...] },
      "legacy_runbook": { "install_steps": [...] },
      "legacy_infrastructure": { "servers": [...], "domains": [...], "ports": {} }
    }
  }
  

• Merge into Context Store for ln-110:

  • contextStore.LEGACY_CONTENT = migration_context
  • Workers use LEGACY_CONTENT as base content (priority over template defaults)

• Priority order: Legacy content > Auto-discovery > Template defaults

0f. Cleanup (Legacy Files) :

• For root-level files (README.md, CONTRIBUTING.md):
  • Do NOT delete
  • Remove migrated sections using Edit tool
  • Add links to new locations:
    • ## Architecture → See [Architecture](docs/project/architecture.md)
    • ## Tech Stack → See [Tech Stack](docs/project/tech_stack.md)
• For standalone legacy files (ARCHITECTURE.md, documentation/):
  • Delete files (already backed up)
  • Log: "Deleted: ARCHITECTURE.md (migrated to docs/project/architecture.md)"
• Clean empty legacy directories

Output : migration_summary { migrated_count, archived_count, skipped_count, legacy_content }

Phase 1: User Confirmation

Objective : Check existing files, explain workflow, and get user approval.

Process :

1. Migration Summary (if Phase 0 ran):

   • Show: "✓ Migrated {N} legacy documents"
   • Show: "✓ Archived to .archive/legacy-{date}/"
   • Show: "✓ LEGACY_CONTENT prepared for workers"

2. Pre-flight Check (scan existing documentation):

   • Use Glob tool to check all potential files:

     • Root docs (4 files): CLAUDE.md, docs/README.md, docs/documentation_standards.md, docs/principles.md
     • Reference structure (5 items): docs/reference/README.md, docs/reference/adrs/, docs/reference/guides/, ,

Output : File scan summary + user approval + test docs preference

---

Phase 2: Invoke Coordinator + Workers Sequentially

Objective : Create complete documentation system by invoking L2 coordinator + 4 L2 workers in order.

Process (AUTOMATIC invocations with Skill tool):

2a. Create Root + Project Documentation :

• Invocation : Skill(skill: "ln-110-project-docs-coordinator") → AUTOMATIC
• Input : Pass LEGACY_CONTENT from Phase 0 (if migration was performed)
• Behavior : Coordinator gathers context ONCE, then delegates to 5 L3 workers:
  • ln-111-root-docs-creator → 4 root docs (uses LEGACY_CONTENT.legacy_principles if available)
  • ln-112-project-core-creator → 3 core docs (uses LEGACY_CONTENT.legacy_architecture, legacy_requirements, legacy_tech_stack)
  • ln-113-backend-docs-creator → 2 conditional (uses LEGACY_CONTENT.legacy_api, legacy_database)
  • ln-114-frontend-docs-creator → 1 conditional (if hasFrontend)
  • ln-115-devops-docs-creator → 2 docs: 1 always + 1 conditional (uses LEGACY_CONTENT.legacy_runbook, legacy_infrastructure)
• Output : Root docs (CLAUDE.md + docs/README.md + docs/documentation_standards.md + docs/principles.md) + Project docs (, , , + conditional: , , , )

2b. Create Reference Structure + Smart Documents :

• Invocation : Skill(skill: "ln-120-reference-docs-creator") → AUTOMATIC
• Input : Pass context_store from ln-110 (TECH_STACK enables smart document creation)
• Output : docs/reference/README.md + adrs/, guides/, manuals/, research/ directories + justified ADRs/Guides/Manuals
• Smart Creation : Creates documents only for nontrivial technology choices (see ln-120 justification rules)
• Validation : ln-120 validates output in Phase 2/3
• Verify : Reference hub exists before continuing

2c. Create Task Management Docs :

• Invocation : Skill(skill: "ln-130-tasks-docs-creator") → AUTOMATIC
• Output : docs/tasks/README.md + optionally kanban_board.md (if user provides Linear config)
• Validation : ln-130 validates output in Phase 2/3
• Verify : Tasks README exists before continuing

2d. Create Test Documentation (Optional) :

• Condition : If user approved test docs in Phase 1
• Invocation : Skill(skill: "ln-140-test-docs-creator") → AUTOMATIC
• Output : tests/README.md (test documentation with Story-Level Test Task Pattern)
• Validation : ln-140 validates output in Phase 2/3
• Skip : If "no" → can run ln-140-test-docs-creator later manually

2f. Extract Skills from Documentation (Optional) :

• Condition : User approved skill extraction in Phase 1, or invoked manually later
• Invocation : Skill(skill: "ln-160-docs-skill-extractor") → AUTOMATIC
• Input : All docs created by ln-110—ln-140
• Output : .claude/commands/*.md files extracted from procedural documentation sections
• Skip : If not approved → can run ln-160-docs-skill-extractor later manually

Output : Complete documentation system with coordinator + 4 workers completed and validated

Worker Invocation (MANDATORY)

TodoWrite format (mandatory): Add ALL invocations to todos before starting:

- Invoke ln-110-project-docs-coordinator (pending)
- Invoke ln-120-reference-docs-creator (pending)
- Invoke ln-130-tasks-docs-creator (pending)
- Invoke ln-140-test-docs-creator (pending)
- Run Global Cleanup (Phase 3) (pending)
- Run Documentation Audit (Phase 4 - optional) (pending)

Mark each as in_progress when starting, completed when worker returns success.

---

Phase 3: Global Cleanup and Consolidation

Objective : Remove duplicates, orphaned files, consolidate knowledge across ALL documentation.

Trigger : Only after ALL workers complete Phase 2/3 validation.

Process :

3a. Documentation Quality Check

Quick quality check per created document:

| Check | PASS | FAIL

---|---|---|---
1 | Completeness | All template sections filled (no TODOs remaining) | Empty sections or placeholder text
2 | Accuracy | Tech stack matches actual project files | References non-existent frameworks
3 | Actuality | Dates and versions match current state | Outdated references

Gate: All FAIL items → fix inline before continuing cleanup. Report quality summary in Phase 4.

3b. Scan for duplicate content

1. Read all .md files in docs/

   • Use Glob tool: pattern: "docs/**/*.md"
   • Store list of all documentation files

2. Identify duplicate sections:

   • For each file:
     • Read file content
     • Extract section headers (##, ###)
     • Extract section content (text between headers)
   • Compare sections across files:

     • If 2+ sections have:

       • Same heading (case-insensitive)

       • 80% content similarity (simple word overlap check)

     • Mark as duplicate

3. Determine canonical version:

   • Rules for canonical location:
     • "Development Principles" → principles.md (always canonical)
     • "Testing Strategy" → testing-strategy.md (always canonical)
     • "Linear Configuration" → tasks/kanban_board.md (always canonical)
     • For other duplicates: Keep in FIRST file encountered (alphabetical order)

4. Remove duplicates:

3c. Report unexpected files (advisory)

1. List all .md files in docs/

   • Use Glob tool: pattern: "docs/**/*.md"

2. Check against expected structure (files created by workers + user-created reference docs)

3. Report findings (DO NOT move/delete/archive):

   • List unexpected files with advisory message
   • User decides what to do with them
   • Log: "{count} unexpected files found (not in expected structure) — listed for user review"

3d. Consolidate knowledge

1. Identify scattered information:

   • Known patterns:
     • Linear config scattered: kanban_board.md + tasks/README.md
     • Development principles scattered: principles.md + architecture.md + CLAUDE.md
     • Testing info scattered: testing-strategy.md + tests/README.md + architecture.md

2. For each scattered concept:

   • Determine Single Source of Truth (SSoT):
     • Linear config → kanban_board.md
     • Development principles → principles.md
     • Testing strategy → testing-strategy.md

3. Update non-SSoT files:

   • Use Edit tool to replace duplicate content with link:

     See [Linear Configuration](../tasks/kanban_board.md#linear-configuration) for team ID and settings.
     

   • Track consolidation count

4. Log results:

   • "✓ Consolidated {count} scattered concepts"
   • List: "{concept} consolidated to {SSoT_file}"

3e. Cross-link validation

1. Scan all .md files for internal links:

   • For each file:
     • Read content
     • Extract all markdown links: [text](path)
     • Filter internal links (relative paths, not http://)

2. Verify link targets exist:

   • For each link:
     • Resolve relative path
     • Check if target file exists (Glob tool)
     • If missing: Mark as broken

3. Fix broken links:

   • For each broken link:
     • If target was archived: Update link to archive path
     • If target never existed: Remove link (convert to plain text)
   • Track fix count

4. Add missing critical links:

   • CLAUDE.md → docs/README.md:
     • Read CLAUDE.md
     • Check for link to docs/README.md
     • If missing: Add in "Documentation Hub" section
   • docs/README.md → section READMEs:
     • Check for links to project/, reference/, tasks/, tests/ READMEs

3f. Final report

✅ Global Cleanup Complete:

Structure:
- Removed {N} duplicate sections (canonical: principles.md)
- Found {N} unexpected files (listed for user review)
- Consolidated {N} scattered concepts

Links:
- Fixed {N} broken links
- Added {N} missing critical links:
  - list of added links

Output : All documentation cleaned up, duplicates removed, unexpected files reported, knowledge consolidated, cross-links validated

---

Phase 4: Documentation Audit (OPTIONAL)

Objective : Audit documentation and code comments quality.

Trigger : Only if user requests audit OR pipeline invoked with audit flags.

Process :

4a. Ask User :

Documentation Audit Options:
1. AUDIT DOCS: Run ln-610-docs-auditor (structure + semantic + comments)
2. SKIP: Continue to summary

Choose option (1/2): _

4b. Run Selected Auditor :

• If AUDIT DOCS selected:
  • Invocation : Skill(skill: "ln-610-docs-auditor") → AUTOMATIC
  • Output : Compliance Score X/10 per category (Structure, Semantic, Comments) + Findings

4c. Show Audit Summary :

📊 Audit Results:
- Documentation Quality: X/10 overall
  - Hierarchy & Links: X/10
  - Single Source of Truth: X/10
  - ...
- Code Comments Quality: X/10 overall
  - WHY not WHAT: X/10
  - Density (15-20%): X/10
  - ...

See full reports above for detailed findings.

Output : Audit reports with compliance scores and findings

---

Phase 5: Summary and Next Steps

Objective : Provide complete overview of created system.

Process :

1. List all created files with sizes:

   • CLAUDE.md (project entry point)
   • docs/README.md (root documentation hub)
   • docs/documentation_standards.md (60 universal requirements)
   • docs/principles.md (11 development principles)
   • docs/project/requirements.md, architecture.md, tech_stack.md + conditional documents (3-7 total)
   • docs/reference/README.md (reference hub with empty adrs/, guides/, manuals/, research/ directories)
   • docs/tasks/README.md + optionally

Output : Summary message with file list and recommendations

---

Complete Output Structure

project_root/
├── CLAUDE.md                         # ← Project entry point (link to docs/)
├── docs/
│   ├── README.md                     # ← Root documentation hub (general standards)
│   ├── documentation_standards.md    # ← 60 universal requirements (Claude Code + industry standards)
│   ├── principles.md                 # ← 11 development principles (Standards First, YAGNI, KISS, DRY, etc.)
│   ├── project/
│   │   ├── requirements.md           # ← Functional Requirements (NO NFR per project policy)
│   │   ├── architecture.md           # ← arc42-based architecture with C4 Model
│   │   ├── tech_stack.md             # ← Technology versions, Docker config
│   │   ├── api_spec.md               # ← API endpoints (conditional)
│   │   ├── database_schema.md        # ← Database schema (conditional)
│   │   ├── design_guidelines.md      # ← UI/UX system (conditional)
│   │   ├── infrastructure.md          # ← Infrastructure inventory (always)
│   │   └── runbook.md                # ← Operations guide (conditional)
│   ├── reference/
│   │   ├── README.md                 # ← Reference documentation hub (registries)
│   │   ├── adrs/                     # ← Empty, ready for ADRs
│   │   ├── guides/                   # ← Empty, ready for guides
│   │   ├── manuals/                  # ← Empty, ready for manuals
│   │   └── research/                 # ← Empty, ready for research
│   ├── tasks/
│   │   ├── README.md                 # ← Task management system rules
│   │   └── kanban_board.md           # ← Linear integration (optional)
└── tests/
    └── README.md                     # ← Test documentation (optional)

---

Integration with Project Workflow

Recommended workflow for new projects:

1. ln-100-documents-pipeline (this skill) - Create complete documentation system
2. ln-210-epic-coordinator - Decompose scope into Epics (Linear Projects)
3. ln-220-story-coordinator - Create User Stories for each Epic (automatic decomposition + replan)
4. ln-300-task-coordinator - Break down Stories into implementation tasks (automatic decomposition + replan)
5. ln-310-multi-agent-validator - Verify Stories before development
6. ln-400-story-executor - Orchestrate Story implementation
7. Story quality gate - Review completed Stories

---

Trade-offs

Trade-offs:

• ⚠️ Less granular control (can't skip coordinator phases)
• ⚠️ Longer execution time (15-20 minutes)
• ⚠️ Global cleanup runs even if only one file was created

When to use manual approach instead:

• Need one specific ADR/guide/manual → use shared/templates/ + shared/references/documentation_creation.md

---

Documentation Standards

All documents created by this pipeline MUST follow these rules:

These standards are enforced by L3 workers (ln-111-115) and audited by ln-610-docs-auditor.

---

Error Handling

If any invoked skill fails:

1. Notify user which skill failed
2. Show error message from failed skill
3. Recommend manual invocation for debugging
4. List already completed steps (partial progress)

---

Technical Implementation Notes

Skill Invocation:

• Uses Skill tool with command parameter
• Waits for each skill to complete before proceeding
• Verifies output files exist before moving to next phase

File Verification:

• Uses Glob tool to check docs/project/ structure
• Lists file sizes for user confirmation
• Warns if expected files missing

Global Cleanup:

• Uses Glob tool to find all .md files
• Uses Read tool to analyze content
• Uses Edit tool to remove duplicates and add links
• Reports unexpected files (advisory, no auto-archive)

Standards Compliance:

• All output follows same standards as underlying skills
• ISO/IEC/IEEE 29148:2018 (Requirements)
• ISO/IEC/IEEE 42010:2022 (Architecture)
• arc42 + C4 Model + Michael Nygard's ADR Format

---

Critical Rules

• Idempotent: Creates only missing files; existing files are preserved without overwrite
• Sequential invocation: Workers must be invoked in order (ln-110 -> ln-120 -> ln-130 -> ln-140); each verified before next
• Global cleanup mandatory: Phase 3 (deduplication, orphan reporting, SSoT consolidation, cross-link validation) runs after all workers complete
• User confirmation required: Pre-flight check and explicit approval before any file creation
• NO_CODE Rule: All generated documents use tables/ASCII/links; no code blocks >5 lines

Phase 6: Meta-Analysis

MANDATORY READ: Load shared/references/meta_analysis_protocol.md

Skill type: planning-coordinator. Run after all phases complete. Output to chat using the planning-coordinator format.

Reference Files

• Legacy detection patterns: references/legacy_detection_patterns.md
• Worker skills: ln-110-project-docs-coordinator, ln-120-reference-docs-creator, ln-130-tasks-docs-creator, ln-140-test-docs-creator
• Audit skill (optional): ln-610-docs-auditor (coordinates ln-611/612/613/614)

Definition of Done

Before completing work, verify ALL checkpoints:

✅ Legacy Migration (Phase 0 - if applicable):

• Legacy detection patterns applied (Glob + Grep)
• Legacy manifest built: { path, type, confidence, target }
• User selected migration option (MIGRATE / ARCHIVE / SKIP)
• If MIGRATE: Content extracted using type-specific extractors
• Backup created: .archive/legacy-{timestamp}/original/
• Extracted content saved: .archive/legacy-{timestamp}/extracted/
• README_migration.md generated with rollback instructions
• LEGACY_CONTENT prepared for Context Store
• Legacy files cleaned up (sections removed from README.md, standalone files deleted)

✅ User Confirmation (Phase 1):

• Migration summary shown (if Phase 0 ran)
• Workflow explained to user (coordinator + 4 workers: ln-110 → ln-120 → ln-130 → ln-140)
• User approved: "Proceed with complete documentation system creation? (yes/no)"
• Test docs preference captured: "Include test documentation? (yes/no)"

✅ Coordinator + Workers Invoked Sequentially (Phase 2):

• ln-110-project-docs-coordinator invoked → Output verified: Root docs (CLAUDE.md + docs/README.md + docs/documentation_standards.md + docs/principles.md) + Project docs (docs/project/requirements.md, architecture.md, tech_stack.md + conditional 3-7 files)
• ln-120-reference-docs-creator invoked → Output verified: docs/reference/README.md + directories (adrs/, guides/, manuals/, research/) + justified ADRs/Guides/Manuals based on TECH_STACK
• ln-130-tasks-docs-creator invoked → Output verified: docs/tasks/README.md + optionally kanban_board.md

✅ File Verification Complete:

• All expected files exist (Glob tool used to verify structure)
• File sizes listed for user confirmation
• Warning displayed if expected files missing

✅ Global Cleanup Complete (Phase 3):

• 3b: Duplicate sections identified and removed (>80% similarity)
• 3b: Links added to canonical locations (principles.md, testing-strategy.md, kanban_board.md)
• 3c: Unexpected files reported (advisory, no auto-archive)
• 3d: Scattered concepts consolidated to Single Source of Truth (SSoT)
• 3e: Internal links validated (broken links fixed, critical links added)
• 3f: Final report generated (counts, lists, actions)

✅ Documentation Audit (Phase 4 - if selected):

• User selected audit option (AUDIT DOCS / AUDIT COMMENTS / BOTH / SKIP)
• If AUDIT DOCS: ln-610-docs-auditor invoked, compliance score displayed
• Audit summary shown with scores per category

✅ Summary Displayed (Phase 5):

• All created files listed with sizes
• Documentation system features highlighted (SCOPE tags, Maintenance sections, README hubs, DAG structure, deduplicated content, validated links)
• Next steps recommended (ln-210-epic-coordinator)

✅ Error Handling (if applicable):

• If any worker failed: User notified which worker failed, error message shown, manual invocation recommended, partial progress listed

Output: Complete documentation system (CLAUDE.md + docs/ with README.md, documentation_standards.md, principles.md + optionally tests/) with global cleanup (no duplicates, orphaned files reported, consolidated knowledge, validated cross-links)

---

Version: 8.1.0 Last Updated: 2025-01-12

Weekly Installs

153

Repository

levnikolaevich/…e-skills

GitHub Stars

245

First Seen

Feb 2, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykWarn

Installed on

cursor139

codex139

gemini-cli138

opencode138

claude-code137

github-copilot136