cbbkrd-tech/ln-100-documents-pipeline

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.

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/presentation 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/150 workers sequentially, then runs global cleanup (deduplication, orphan archival, 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-150-presentation-creator (L2 Worker)
├── ln-600-docs-auditor (L2 Worker - optional)
└── ln-610-code-comments-auditor (L2 Worker - optional)

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/ → presentation/) 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)
5. ln-150-presentation-creator - HTML presentation

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

Workflow

The skill follows a 7-phase orchestration workflow: Legacy Migration (optional) → User confirmation → Invoke coordinator + 4 workers sequentially → Global cleanup → Documentation Audit (optional) → Summary. Phase 3 (validation) is intentionally skipped - each component validates its own output.

---

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:

0.1 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/, docs/ with wrong structure
  • README.md sections: ## Architecture, ## Tech Stack, ## Requirements, etc.
  • CONTRIBUTING.md sections: ## Development, ## Code Style, ## Coding Standards
• Build legacy_manifest: list of { path, detected_type, target_doc, confidence }
• If no legacy docs found → skip to Phase 1

0.2 Content Extraction:

• For each detected legacy file:
  • Parse markdown structure (headers, lists, code blocks)
  • Apply type-specific extractor (MANDATORY READ: Load 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[] }
  • Score content quality (0.0-1.0)
• Store in extracted_content object

0.3 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

0.4 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

0.5 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": [...] }
    }
  }
  

• 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

0.6 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:

0. Migration Summary (if Phase 0 ran):

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

1. 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/, docs/reference/manuals/, docs/reference/research/
     • Tasks docs (2 files): docs/tasks/README.md, docs/tasks/kanban_board.md
     • Project docs (up to 7 files): docs/project/requirements.md, architecture.md, tech_stack.md, api_spec.md, database_schema.md, design_guidelines.md, runbook.md
     • Presentation (3 items): docs/presentation/README.md, presentation_final.html, assets/ directory
     • Test docs (2 files): docs/reference/guides/testing-strategy.md, tests/README.md
   • Count existing vs missing files
   • Show user summary:

     📊 Documentation Status:
     ✓ Found: X existing files
     ✗ Missing: Y files
     
     ⚠️ Pipeline will create ONLY missing files.
     ✅ Existing files will be preserved (no overwrites).
     

2. Show user what will be created:

   • Root + Project documentation (CLAUDE.md + docs/README.md + documentation_standards.md + principles.md + docs/project/ via ln-110-project-docs-coordinator)
   • Reference structure (docs/reference/ via ln-120-reference-docs-creator)
   • Task management docs (docs/tasks/ via ln-130-tasks-docs-creator)
   • Test documentation (tests/ via ln-140-test-docs-creator - optional)
   • HTML presentation (docs/presentation/ via ln-150-presentation-creator)
   • Estimated time: 15-20 minutes with interactive dialog

3. Ask: "Proceed with creating missing files? (yes/no)"

4. Ask: "Include test documentation (tests/README.md)? (yes/no)"

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):

2.1 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 → 1 conditional (uses LEGACY_CONTENT.legacy_runbook)
• Output: 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: api_spec.md, database_schema.md, design_guidelines.md, runbook.md)
• Store: Save context_store from ln-110 result (contains TECH_STACK for ln-120)
• Validation: Each L3 worker validates output (SCOPE tags, Maintenance sections)
• Verify: All documents exist before continuing

2.2 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

2.3 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

2.4 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

2.5 Create HTML Presentation:

• Invocation: Skill(skill: "ln-150-presentation-creator") → AUTOMATIC
• Output: docs/presentation/README.md + presentation_final.html + assets/
• Validation: ln-150 validates output in Phase 2/3
• Verify: Presentation files exist before continuing

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

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)
- Invoke ln-150-presentation-creator (pending)
- Run Global Cleanup (Phase 4) (pending)
- Run Documentation Audit (Phase 5 - optional) (pending)

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

---

Phase 4: 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:

4.0 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 5.

4.1 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:

   • For each duplicate section:
     • Use Edit tool to delete from non-canonical files
     • Use Edit tool to add link to canonical location:

       See [Development Principles](../principles.md#development-principles) for details.
       

   • Track count of removed duplicates

5. Log results:

   • "✓ Removed {count} duplicate sections"
   • List: "{section_name} removed from {file} (canonical: {canonical_file})"

4.2 Scan for orphaned files

1. List all .md files in docs/

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

2. Check against expected structure:

   • Expected files (created by workers):
     • docs/CLAUDE.md
     • docs/README.md
     • docs/documentation_standards.md
     • docs/principles.md
     • docs/project/requirements.md
     • docs/project/architecture.md
     • docs/project/tech_stack.md
     • docs/project/api_spec.md (conditional)
     • docs/project/database_schema.md (conditional)
     • docs/project/design_guidelines.md (conditional)
     • docs/project/runbook.md (conditional)
     • docs/reference/README.md
     • docs/reference/adrs/*.md (user-created)
     • docs/reference/guides/*.md (user-created)
     • docs/reference/manuals/*.md (user-created)
     • docs/tasks/README.md
     • docs/tasks/kanban_board.md
     • docs/testing-strategy.md
     • tests/README.md
   • Any file NOT in this list = orphaned

3. Move orphaned files to archive:

   • Create .archive/YYYY-MM-DD/ directory (current date)
   • For each orphaned file:
     • Use Bash tool: mv {file_path} .archive/YYYY-MM-DD/
     • Log: "Archived {file_name} (not in expected structure)"
   • Track count

4. Log results:

   • "✓ Archived {count} orphaned files to .archive/{date}/"
   • List archived files

4.3 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}"

4.4 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
     • If missing: Add
   • Track added links count

5. Log results:

   • "✓ Fixed {count} broken links"
   • "✓ Added {count} missing critical links"
   • List changes

4.5 Final report

✅ Global Cleanup Complete:

Structure:
- Removed {N} duplicate sections (canonical: principles.md)
- Archived {N} orphaned files to .archive/YYYY-MM-DD/
  - list of archived files
- 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, orphaned files archived, knowledge consolidated, cross-links validated

---

Phase 5: Documentation Audit (OPTIONAL)

Objective: Audit documentation and code comments quality.

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

Process:

5.1 Ask User:

📊 Documentation Audit Options:
1. AUDIT DOCS: Run ln-600-docs-auditor (6 categories)
2. AUDIT COMMENTS: Run ln-610-code-comments-auditor (6 categories)
3. BOTH: Run both auditors
4. SKIP: Continue to summary

Choose option (1/2/3/4): _

5.2 Run Selected Auditors:

• If AUDIT DOCS selected:
  • Invocation: Skill(skill: "ln-600-docs-auditor") → AUTOMATIC
  • Output: Compliance Score X/10 per category + Findings
• If AUDIT COMMENTS selected:
  • Invocation: Skill(skill: "ln-610-code-comments-auditor") → AUTOMATIC
  • Output: Compliance Score X/10 per category + Findings

5.3 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 6: 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 kanban_board.md
   • docs/presentation/README.md + presentation_final.html
   • tests/README.md (if created)

2. Show documentation system features:

   • ✅ SCOPE tags (document boundaries defined)
   • ✅ Maintenance sections (update triggers + verification)
   • ✅ README hub (central navigation)
   • ✅ DAG structure (Directed Acyclic Graph navigation)
   • ✅ Living documentation ready
   • ✅ Deduplicated content (canonical sources only)
   • ✅ Validated cross-links (no broken links)

3. Recommend next steps:

   • "Review generated documentation (CLAUDE.md → docs/)"
   • "Open docs/presentation/presentation_final.html in browser"
   • "Run ln-210-epic-coordinator to decompose scope into Epics"
   • "Share documentation with technical stakeholders"

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)
│   │   └── 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)
│   └── presentation/
│       ├── README.md                 # ← Navigation hub for presentation
│       ├── presentation_final.html   # ← Final standalone HTML (~130-180 KB)
│       └── assets/                   # ← Modular HTML structure
└── 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-story-validator - Verify Stories before development
6. ln-400-story-executor - Orchestrate Story implementation
7. Story quality gate - Review completed Stories

---

Advantages of Orchestrator Approach

Benefits:

• ✅ Single command creates complete system
• ✅ No need to remember skill sequence
• ✅ Automated skill chaining
• ✅ Consistent output every time
• ✅ Time-saving (one invocation vs 2-3 manual invocations)
• ✅ Idempotent: Safe to run multiple times - preserves existing files, creates only missing ones
• ✅ Pre-flight check: Shows file scan summary before execution
• ✅ Global cleanup: Automatic deduplication, orphaned files archival, knowledge consolidation
• ✅ Validated cross-links: No broken links in documentation

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 only HTML rebuild → use ln-150-presentation-creator
• Need one specific ADR/guide/manual → use ln-002-best-practices-researcher

---

Documentation Standards

All documents created by this pipeline MUST follow these rules:

| Rule | Description | Enforcement | |------|-------------|-------------| | NO_CODE Rule | Documents describe contracts, not implementations | No code blocks >5 lines; use tables/ASCII/links | | Stack Adaptation | Links must match project TECH_STACK | .NET → Microsoft docs, JS → MDN | | Format Priority | Tables/ASCII > Lists (enumerations only) > Text | Tables for params, config, alternatives |

These standards are enforced by L3 workers (ln-111-115) and audited by ln-600-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
• Uses Bash tool to archive orphaned files

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 -> ln-150); each verified before next
• Global cleanup mandatory: Phase 4 (deduplication, orphan archival, 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

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, ln-150-presentation-creator
• Audit skills (optional): ln-600-docs-auditor, ln-610-code-comments-auditor

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 → ln-150)
• [ ] 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
• [ ] ln-140-test-docs-creator invoked (if enabled) → Output verified: tests/README.md
• [ ] ln-150-presentation-creator invoked → Output verified: docs/presentation/README.md + presentation_final.html + assets/
• [ ] Each component validated its own output (SCOPE tags, Maintenance sections, POSIX compliance)

✅ 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 4):

• [ ] 4.1: Duplicate sections identified and removed (>80% similarity)
• [ ] 4.1: Links added to canonical locations (principles.md, testing-strategy.md, kanban_board.md)
• [ ] 4.2: Orphaned files archived to .archive/YYYY-MM-DD/
• [ ] 4.3: Scattered concepts consolidated to Single Source of Truth (SSoT)
• [ ] 4.4: Internal links validated (broken links fixed, critical links added)
• [ ] 4.5: Final report generated (counts, lists, actions)

✅ Documentation Audit (Phase 5 - if selected):

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

✅ Summary Displayed (Phase 6):

• [ ] 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 + presentation/ + optionally tests/) with global cleanup (no duplicates, no orphaned files, consolidated knowledge, validated cross-links)

---

Version: 8.1.0 Last Updated: 2025-01-12