• Read the existing

  llms.txt

  file to understand current structure
• Review the official specification at https://llmstxt.org/ to ensure continued compliance
• Identify areas that may need updates based on repository changes

• Examine the current repository structure using appropriate tools
• Compare current structure with what's documented in existing

  llms.txt

• Identify new directories, files, or documentation that should be included
• Note any removed or relocated files that need to be updated

• Identify new README files and their locations
• Find new documentation files (

  .md

  files in

  /docs/

  ,

  /spec/

  , etc.)
• Locate new specification files and their purposes
• Discover new configuration files and their relevance
• Find new example files and code samples
• Identify any changes to existing documentation structure

• Changes needed to maintain accuracy
• New files to be added to the llms.txt
• Outdated references to be removed or updated
• Organizational improvements to maintain clarity

llms.txt

1. H1 Header: Single line with repository/project name (required)
2. Blockquote Summary: Brief description in blockquote format (optional but recommended)
3. Additional Details: Zero or more markdown sections without headings for context
4. File List Sections: Zero or more H2 sections containing markdown lists of links

• Project Name: Clear, descriptive title as H1
• Summary: Concise blockquote explaining the repository's purpose
• Key Files: Essential files organized by category (H2 sections)

• Documentation: Core documentation files
• Specifications: Technical specifications and requirements
• Examples: Sample code and usage examples
• Configuration: Setup and configuration files
• Optional: Secondary files (special meaning - can be skipped for shorter context)

• Use concise, clear, unambiguous language
• Avoid jargon without explanation
• Write for both human and LLM readers
• Be specific and informative in descriptions

• Explain the repository's purpose and scope
• Provide essential technical documentation
• Show usage examples and patterns
• Define interfaces and specifications
• Contain configuration and setup instructions

• Are purely implementation details
• Contain redundant information
• Are build artifacts or generated content
• Are not relevant to understanding the project

1. Read the existing

   llms.txt

   file thoroughly
2. Examine the current repository structure completely
3. Compare existing file references with actual repository content
4. Identify outdated, missing, or incorrect references
5. Note any structural issues with the current file

1. Determine if the primary purpose statement needs updates
2. Review and update the summary blockquote if needed
3. Plan additions for new files and directories
4. Plan removals for outdated or moved content
5. Reorganize sections if needed for better clarity

1. Update the existing

   llms.txt

   file in the repository root
2. Maintain compliance with the exact format specification
3. Add new file references with appropriate descriptions
4. Remove or update outdated references
5. Ensure all links are valid relative paths

1. Verify continued compliance with https://llmstxt.org/ specification
2. Check that all links are valid and accessible
3. Ensure the file still serves as an effective LLM navigation tool
4. Confirm the file remains both human and machine readable

• ✅ H1 header with project name
• ✅ Blockquote summary (if included)
• ✅ H2 sections for file lists
• ✅ Proper markdown link format
• ✅ No broken or invalid links
• ✅ Consistent formatting throughout

• ✅ Clear, unambiguous language
• ✅ Comprehensive coverage of essential files
• ✅ Logical organization of content
• ✅ Appropriate file descriptions
• ✅ Serves as effective LLM navigation tool

• ✅ Follows https://llmstxt.org/ format exactly
• ✅ Uses required markdown structure
• ✅ Implements optional sections appropriately
• ✅ File located at repository root (

  /llms.txt

  )

1. Identify the appropriate section for new files
2. Create clear, descriptive names for links
3. Write concise but informative descriptions
4. Maintain alphabetical or logical ordering within sections
5. Consider if new sections are needed for new content types

1. Verify files are actually removed or relocated
2. Check if relocated files should be updated rather than removed
3. Remove entire sections if they become empty
4. Update cross-references if needed

1. Maintain logical flow from general to specific
2. Keep essential documentation in primary sections
3. Move secondary content to "Optional" section if appropriate
4. Ensure new organization improves LLM navigation

llms.txt

undefined

[Concise description of the repository's purpose and scope]

• Main README: Primary project documentation and getting started guide
• Contributing Guide: Guidelines for contributing to the project
• Code of Conduct: Community guidelines and expectations

• Technical Specification: Detailed technical requirements and constraints
• API Specification: Interface definitions and data contracts

• Basic Example: Simple usage demonstration
• Advanced Example: Complex implementation patterns

• Setup Guide: Installation and configuration instructions
• Deployment Guide: Production deployment guidelines

• Architecture Documentation: Detailed system architecture
• Design Decisions: Historical design decision records

undefined

llms.txt

1. Accurately reflect the current repository structure and content
2. Maintain compliance with the llms.txt specification
3. Provide clear navigation to essential documentation
4. Remove outdated or incorrect references
5. Include new important files and documentation
6. Maintain logical organization for easy LLM consumption
7. Use clear, unambiguous language throughout
8. Continue to serve both human and machine readers effectively