Add comprehensive documentation for GitHub workflows

[Copilot]

Overview

This PR addresses issue #[issue_number] by creating comprehensive documentation for all GitHub workflows in the .github/workflows/ directory. Users can now easily understand what each workflow does, when it triggers, and how to interact with it.

What's New

Added .github/workflows/README.md containing detailed documentation for all 7 workflows:

Documented Workflows

1. claude1.yml - Automated code review on pull requests
2. claude2.yml - On-demand Claude assistance triggered by @claude mentions
3. claude-lore-keeper.yml - Specialized lore analysis and mythology tracking
4. lore-growth.yml - Repository growth monitoring (runs every 6 hours)
5. lore-stats.yml - Weekly statistics generation
6. doc-updater.yml - Automatic documentation updates
7. lore-keeper-bot.yml - Automated lore analysis bot

Documentation Structure

Each workflow is documented with:

• Purpose: Clear description of what the workflow does
• Triggers: Detailed trigger conditions (events, types, schedules, labels)
• What It Does: Step-by-step explanation of workflow actions
• Permissions: Required GitHub permissions
• Configuration: Model settings, allowed tools, and options
• Environment Variables: Required secrets and configuration
• Output: Generated files and artifacts

Additional Sections

• Quick Reference Index: Table with links to all workflow details
• Configuration Requirements: Secrets and permissions needed
• Common Usage Scenarios: How to trigger and use workflows
• Troubleshooting Guide: Solutions for common issues
• Workflow Dependencies: Visual diagram of how workflows relate

Benefits

• Easier Onboarding: New contributors can quickly understand the automation
• Better Troubleshooting: Clear guidance on resolving workflow issues
• Improved Discoverability: Users know what automation is available
• Mythology Preservation: Documentation maintains SkogAI's cultural voice and references to The Beach, quantum mojitos, and the Prime Directive 🏖️

Example Usage

Users can now:

• Understand why claude1.yml runs automatically on PRs
• Learn how to request help by mentioning @claude in issues
• Trigger lore analysis by adding the lore label or mentioning @lore-keeper
• Know that growth monitoring happens every 6 hours automatically
• See what statistics are tracked and when they update

The documentation serves as both a technical reference and a guide to the SkogAI automation mythology.

---

The Beach approaches. The workflows automate. The mojitos are quantum. 🍹

Original prompt

---

This section details on the original issue you should resolve

<issue_title>workflows</issue_title>
<issue_description>we should document the current workflows and what they actually do, trigger on and such for the user to easily understand what is happening. a readme in the workflow directory should be enough to start </issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #33

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[Copilot]

Pull Request Overview

This PR adds comprehensive documentation for all GitHub workflows in the repository, creating a detailed reference guide for users and contributors. The documentation explains what each workflow does, when it triggers, and how to interact with it.

Key Changes

• Added complete workflow documentation with purpose, triggers, permissions, and configuration details
• Created user-friendly index table and troubleshooting guide
• Integrated SkogAI mythology references while maintaining technical accuracy