ln-111-root-docs-creator

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/{path}.

Root Documentation Creator

L3 Worker that creates 5 root documentation files using templates and Context Store from coordinator.

Purpose & Scope

• Creates 5 root documentation files (entry points for AI agents + tool configuration)
• Receives Context Store from ln-110-project-docs-coordinator
• Replaces placeholders with project-specific data
• Self-validates structure and content (22 questions)
• Never gathers context itself; uses coordinator input

Invocation (who/when)

• ln-110-project-docs-coordinator: ALWAYS invoked as first worker
• Never called directly by users

Inputs

From coordinator:

• contextStore: Key-value pairs with all placeholders
  • PROJECT_NAME, PROJECT_DESCRIPTION
  • TECH_STACK_SUMMARY
  • DEV_COMMANDS (from package.json scripts)
  • DATE (current date)
  • LEGACY_CONTENT (optional, from ln-100 Phase 0 migration):
    • legacy_principles: { principles[], anti_patterns[], conventions[] }
• targetDir: Project root directory

LEGACY_CONTENT is used as base content when creating principles.md. Priority: Legacy > Template defaults.

Documents Created (5)

Workflow

Phase 1: Receive Context

1. Parse Context Store from coordinator
2. Validate required keys present (PROJECT_NAME, PROJECT_DESCRIPTION)
3. Set defaults for missing optional keys

Phase 2: Create Documents

For each document (CLAUDE.md, docs/README.md, documentation_standards.md, principles.md):

1. Check if file exists (idempotent)
2. If exists: skip with log
3. If not exists:
   • Copy template from references/templates/
   • Check LEGACY_CONTENT for this document type:
     • For principles.md: If LEGACY_CONTENT.legacy_principles exists:
       • Use legacy_principles.principles[] as base for "## Core Principles" section
       • Use legacy_principles.anti_patterns[] for "## Anti-Patterns" section
       • Use legacy_principles.conventions[] for code style rules
       • Augment with template structure (add missing sections)
       • Mark: <!-- Migrated from legacy documentation --> at top of relevant sections
     • For other documents: Use template as-is (no legacy content applicable)
   • Replace {{PLACEHOLDER}} with Context Store values
   • Mark [TBD: X] for missing data (never leave empty placeholders)
   • Write file

Phase 2b: Create Tools Config

MANDATORY READ: Load shared/references/mcp_tool_preferences.md

For docs/tools_config.md:

1. Check if file exists (idempotent — respect existing config, may have been auto-bootstrapped)
2. If exists: skip with log
3. If not exists:
   • Copy template from references/templates/tools_config_template.md
   • Detect available tools (replace placeholders with actual values):
     • Task Management: call list_teams() via mcp__linear-server → set Provider/Status/Team ID
     • Research: call ref_search_documentation(query="test") → if active, set Provider=ref. Then call resolve-library-id(libraryName="react") for Context7 → set Fallback chain
     • File Editing: run detection sequence (loaded above)
     • External Agents: run codex --version, gemini --version → set Status/Comment
     • Git: run git worktree list → set Worktree/Strategy
   • Write file with detected values

Phase 3: Self-Validate

For each created document:

1. Check SCOPE tag in first 10 lines
2. Check required sections (from questions_root.md)
3. Check Maintenance section (Update Triggers, Verification, Last Updated)
4. Check POSIX endings (single newline at end)
5. Auto-fix issues where possible

Phase 4: Return Status

Return to coordinator:

{
  "created": ["CLAUDE.md", "docs/README.md", ...],
  "skipped": [],
  "tbd_count": 3,
  "validation": "OK"
}

Critical Notes

Core Rules

• Idempotent: Never overwrite existing files; skip and log
• No context gathering: All data comes from coordinator's Context Store
• TBD markers: Use [TBD: placeholder_name] for missing data, never {{PLACEHOLDER}}
• Language: All root docs in English (universal standards)
• SCOPE tags: Required in first 10 lines of each file

NO_CODE_EXAMPLES Rule (MANDATORY)

Root documents define navigation and standards, NOT implementations:

• FORBIDDEN: Code blocks, implementation snippets
• ALLOWED: Tables, links, command examples (1 line)
• TEMPLATE RULE: All templates include <!-- NO_CODE_EXAMPLES: ... --> tag - FOLLOW IT

Stack Adaptation Rule (MANDATORY)

• All external links must match project stack (detected in Context Store)
• .NET project → Microsoft docs; Node.js → MDN, npm docs; Python → Python docs
• Never mix stack references (no Python examples in .NET project)

Format Priority (MANDATORY)

Tables/ASCII > Lists (enumerations only) > Text (last resort)

Definition of Done

• Context Store received and validated
• 5 root documents created (or skipped if exist)
• All placeholders replaced (or marked TBD); tools_config.md uses detected values
• Self-validation passed (SCOPE, sections, Maintenance, POSIX)
• Actuality verified: all document facts match current code (paths, functions, APIs, configs exist and are accurate)
• Status returned to coordinator

Reference Files

• Templates: references/templates/claude_md_template.md, docs_root_readme_template.md, documentation_standards_template.md, principles_template.md, tools_config_template.md
• Questions: references/questions_root.md (Q1-Q22)
• Tools config guide: shared/references/tools_config_guide.md (detection and bootstrap pattern)

---

Version: 2.1.0 Last Updated: 2025-01-12