diff --git a/docs/issues/2025-11-11--gitea-runner-setup-request.md b/docs/issues/2025-11-11--gitea-runner-setup-request.md
new file mode 100644
index 0000000..9e2ee1c
--- /dev/null
+++ b/docs/issues/2025-11-11--gitea-runner-setup-request.md
@@ -0,0 +1,82 @@
+# Gitea Actions Runner Configuration Request
+
+**Type:** feature  
+**Date:** 2025-11-11  
+**Status:** captured
+
+---
+
+## Description
+
+We've just completed **Phase 3: Gitea Actions Workflows Setup** and have implemented two workflows:
+
+1. **KB Lint Workflow** (`.github/workflows/kb-lint.yml`) - Validates KB file naming, frontmatter, and structure
+2. **KB Index Update Workflow** (`.github/workflows/kb-index-update.yml`) - Auto-updates KB index on push to main
+
+## Current Status
+
+The workflows are properly configured and trigger correctly when KB files change. However, workflows are stuck in "Waiting" status because **no Gitea Actions runners are available** to execute them.
+
+**Example**: We created a test KB file (`kb/01_projects/tendril/2025-11-11--test-kb-workflow--note.md`) to test the KB lint workflow. The workflow triggered correctly but has been waiting for over 3 minutes for a runner to become available.
+
+## What We're Trying to Do
+
+1. **Test KB Lint Workflow**: Validate that KB files follow naming conventions and frontmatter requirements
+2. **Test KB Index Update Workflow**: Verify automatic index regeneration when KB files are added/modified
+3. **Validate Phase 3 Implementation**: Confirm that Gitea Actions workflows are working correctly
+
+## Request
+
+Please configure Gitea Actions runners for the `Mycelium/tendril` repository so that workflows can execute.
+
+### Required Runner Configuration
+
+- **Platform**: `ubuntu-latest` (as specified in workflows)
+- **Labels**: Should match `runs-on: ubuntu-latest` in workflow files
+- **Repository**: `Mycelium/tendril`
+- **Permissions**: 
+  - KB Lint workflow needs `contents: read`
+  - KB Index Update workflow needs `contents: write`
+
+### Workflow Details
+
+**KB Lint Workflow** (`.github/workflows/kb-lint.yml`):
+- Triggers on: Push and pull requests when `kb/**/*.md` files change
+- Purpose: Validates KB file naming pattern, frontmatter, and structure
+- Permissions: `contents: read`
+
+**KB Index Update Workflow** (`.github/workflows/kb-index-update.yml`):
+- Triggers on: Push to `main` branch when `kb/**/*.md` files change
+- Purpose: Automatically regenerates `kb/_index.md` when KB files are added/modified
+- Permissions: `contents: write` (needs to commit and push index updates)
+
+## Testing Plan
+
+Once runners are configured, we will:
+
+1. Verify KB lint workflow validates test file correctly
+2. Test with invalid KB file to confirm validation catches errors
+3. Test KB index update workflow on main branch
+4. Clean up test file after validation
+
+## References
+
+- **Gitea Actions Documentation**: https://docs.gitea.com/usage/actions/
+- **Gitea Runner Setup**: https://docs.gitea.com/usage/actions/runner/
+- **Workflow Files**: 
+  - `.github/workflows/kb-lint.yml`
+  - `.github/workflows/kb-index-update.yml`
+- **Project Documentation**: `docs/GITEA/Gitea-Actions-Guide.md`
+
+## Additional Notes
+
+- Workflows use standard GitHub Actions YAML format (Gitea Actions is compatible)
+- All workflows are properly configured and trigger correctly
+- The issue is solely that runners need to be registered/configured
+- Test file will be deleted after workflow validation is complete
+
+---
+
+**Branch**: `docs/contributing-guide-and-workflow`  
+**Related**: Phase 3 implementation, KB system setup
+
diff --git a/docs/issues/README.md b/docs/issues/README.md
new file mode 100644
index 0000000..697631d
--- /dev/null
+++ b/docs/issues/README.md
@@ -0,0 +1,117 @@
+# Issues Capture System
+
+_Quick capture system for potential insights, problems, structural changes, bugs, and features_
+
+---
+
+## Purpose
+
+The `docs/issues/` folder is a lightweight staging area for capturing issues, ideas, and problems as you encounter them. These markdown files can be quickly created and filled out, then later compiled into actual Gitea issues for project boards.
+
+**Key Benefits:**
+- ⚡ **Quick capture** - Minimal fields, fast to fill out
+- 📝 **Markdown-based** - Easy to edit and version control
+- 🔄 **Later compilation** - Can be batch-processed into Gitea issues
+- 📊 **Searchable** - All issues in one place, easy to review
+
+---
+
+## Workflow
+
+### 1. Quick Capture
+When you encounter an issue, insight, bug, or feature idea:
+
+1. Copy `template.md` to create a new issue file
+2. Use filename format: `YYYY-MM-DD--short-description.md`
+3. Fill out the minimal required fields
+4. Save and commit
+
+### 2. Regular Review
+Periodically review issues in this folder:
+- Group related issues
+- Prioritize by impact
+- Identify patterns or themes
+
+### 3. Compilation to Gitea Issues
+When ready to create actual Gitea issues:
+- Review all issues in this folder
+- Create Gitea issues from the markdown files
+- Link back to the original markdown file
+- Optionally archive or move processed issues
+
+---
+
+## File Naming
+
+Use format: `YYYY-MM-DD--short-description.md`
+
+Examples:
+- `2025-11-11--gitea-runner-setup.md`
+- `2025-11-11--add-mentions-field.md`
+- `2025-11-11--kb-routing-improvement.md`
+
+---
+
+## Issue Types
+
+Use the `type` field in the template to categorize:
+
+- **bug** - Something broken or not working correctly
+- **feature** - New functionality or enhancement
+- **insight** - Observation or pattern noticed
+- **structural** - Changes to project structure or architecture
+- **improvement** - Enhancement to existing functionality
+- **question** - Something to investigate or clarify
+
+---
+
+## Template Fields
+
+The template includes minimal required fields:
+
+- **Title** - Brief, descriptive title
+- **Type** - Category (bug, feature, insight, etc.)
+- **Date** - When issue was captured
+- **Description** - What the issue/idea is
+- **Impact** - Why it matters (optional)
+- **Notes** - Additional context (optional)
+
+Keep it simple - you can always add more detail later when creating the Gitea issue.
+
+---
+
+## Best Practices
+
+1. **Capture quickly** - Don't overthink, just get it down
+2. **One issue per file** - Makes compilation easier
+3. **Use descriptive filenames** - Helps with search and review
+4. **Add context** - Include enough detail to remember later
+5. **Review regularly** - Don't let issues pile up indefinitely
+
+---
+
+## Future Automation
+
+Potential enhancements:
+- Script to batch-create Gitea issues from markdown files
+- Gitea Actions workflow to auto-create issues on file creation
+- Integration with project boards
+- Automated categorization and tagging
+
+---
+
+## Platform Notes
+
+**Gitea-Specific:**
+- Repository: https://git.parkingmeter.info/Mycelium/tendril
+- Platform: Gitea (self-hosted)
+- Issues: Gitea issues (compatible with GitHub issues format)
+- See `docs/GITEA/Gitea-Basics.md` for Gitea-specific guidance
+
+---
+
+**Location**: `docs/issues/`  
+**Related**: 
+- `docs/GITEA/Gitea-Basics.md` - Gitea platform basics
+- `docs/GITEA/Gitea-Workflows.md` - Gitea workflows and best practices
+
diff --git a/docs/issues/template.md b/docs/issues/template.md
new file mode 100644
index 0000000..8c9b910
--- /dev/null
+++ b/docs/issues/template.md
@@ -0,0 +1,38 @@
+# {{title}}
+
+**Type:** {{bug|feature|insight|structural|improvement|question}}  
+**Date:** {{YYYY-MM-DD}}  
+**Status:** {{captured|reviewed|compiled}}
+
+---
+
+## Description
+
+{{Brief description of the issue, insight, bug, or feature idea}}
+
+---
+
+## Impact
+
+{{Why this matters or what it affects (optional)}}
+
+---
+
+## Notes
+
+{{Additional context, related issues, or thoughts (optional)}}
+
+---
+
+## Related
+
+- {{Links to related files, issues, or documentation (optional)}}
+
+---
+
+## Gitea Issue
+
+**Repository:** Mycelium/tendril  
+**Issue URL:** {{https://git.parkingmeter.info/Mycelium/tendril/issues/XX}}  
+**Status:** {{open|closed}}
+
diff --git a/kb/02_systems/2025-11-11--issues-capture-system--note.md b/kb/02_systems/2025-11-11--issues-capture-system--note.md
new file mode 100644
index 0000000..4afd085
--- /dev/null
+++ b/kb/02_systems/2025-11-11--issues-capture-system--note.md
@@ -0,0 +1,163 @@
+---
+title: "Issues Capture System Documentation"
+date: "2025-11-11"
+captured_at: "2025-11-11"
+author: ["datawarrior"]
+source: { kind: chat, ref: "issues-folder-setup" }
+source_type: chat
+project: ["tendril"]
+related_projects: ["tendril"]
+topics: ["documentation", "issue-tracking", "workflow", "gitea"]
+tags: ["issues", "capture", "documentation", "gitea", "workflow"]
+type: note
+status: draft
+phase_relevance: []
+routing_hint: "Documentation about issues capture system folder structure"
+proposed_path: "kb/02_systems/"
+routing_confidence: 0.95
+related: []
+summary: "Documentation for the issues capture system in docs/issues/ folder. Provides quick capture workflow for issues, insights, bugs, and features before compiling into Gitea issues."
+key_takeaways: []
+action_candidates: []
+---
+
+# Issues Capture System
+
+## Overview
+
+The `docs/issues/` folder is a lightweight staging area for capturing issues, ideas, and problems as you encounter them. These markdown files can be quickly created and filled out, then later compiled into actual Gitea issues for project boards.
+
+## Purpose
+
+**Quick capture system** for:
+- Potential insights
+- Problems and bugs
+- Structural changes
+- Feature ideas
+- Questions to investigate
+
+## Location
+
+**Folder**: `docs/issues/`
+
+**Files**:
+- `README.md` - System documentation and workflow
+- `template.md` - Template for creating new issue files
+- `YYYY-MM-DD--short-description.md` - Individual issue files
+
+## Workflow
+
+### 1. Quick Capture
+
+When you encounter an issue, insight, bug, or feature idea:
+
+1. Copy `template.md` to create a new issue file
+2. Use filename format: `YYYY-MM-DD--short-description.md`
+3. Fill out the minimal required fields
+4. Save and commit
+
+### 2. Regular Review
+
+Periodically review issues in this folder:
+- Group related issues
+- Prioritize by impact
+- Identify patterns or themes
+
+### 3. Compilation to Gitea Issues
+
+When ready to create actual Gitea issues:
+- Review all issues in this folder
+- Create Gitea issues from the markdown files
+- Link back to the original markdown file
+- Optionally archive or move processed issues
+
+## File Naming Convention
+
+Format: `YYYY-MM-DD--short-description.md`
+
+**Examples**:
+- `2025-11-11--gitea-runner-setup-request.md`
+- `2025-11-11--add-mentions-field.md`
+- `2025-11-11--kb-routing-improvement.md`
+
+## Issue Types
+
+Use the `type` field in the template to categorize:
+
+- **bug** - Something broken or not working correctly
+- **feature** - New functionality or enhancement
+- **insight** - Observation or pattern noticed
+- **structural** - Changes to project structure or architecture
+- **improvement** - Enhancement to existing functionality
+- **question** - Something to investigate or clarify
+
+## Template Fields
+
+The template includes minimal required fields:
+
+- **Title** - Brief, descriptive title
+- **Type** - Category (bug, feature, insight, etc.)
+- **Date** - When issue was captured
+- **Status** - captured|reviewed|compiled
+- **Description** - What the issue/idea is
+- **Impact** - Why it matters (optional)
+- **Notes** - Additional context (optional)
+- **Related** - Links to related files, issues, or documentation (optional)
+- **Gitea Issue** - Link to created Gitea issue (when compiled)
+
+## Best Practices
+
+1. **Capture quickly** - Don't overthink, just get it down
+2. **One issue per file** - Makes compilation easier
+3. **Use descriptive filenames** - Helps with search and review
+4. **Add context** - Include enough detail to remember later
+5. **Review regularly** - Don't let issues pile up indefinitely
+
+## Integration with Gitea
+
+**Platform**: Gitea (self-hosted)  
+**Repository**: https://git.parkingmeter.info/Mycelium/tendril  
+**Issues**: Gitea issues (compatible with GitHub issues format)
+
+When compiling to Gitea issues:
+- Use Gitea issue creation workflow
+- Link back to original markdown file
+- Update issue file with Gitea issue URL
+- Change status to "compiled"
+
+## Related Documentation
+
+- `docs/issues/README.md` - Complete system documentation
+- `docs/issues/template.md` - Issue file template
+- `docs/GITEA/Gitea-Basics.md` - Gitea platform basics
+- `docs/GITEA/Gitea-Workflows.md` - Gitea workflows and best practices
+
+## Future Automation
+
+Potential enhancements:
+- Script to batch-create Gitea issues from markdown files
+- Gitea Actions workflow to auto-create issues on file creation
+- Integration with project boards
+- Automated categorization and tagging
+
+## Key Takeaways
+
+- Lightweight staging area for issue capture
+- Markdown-based for easy editing and version control
+- Quick capture workflow with minimal fields
+- Later compilation into Gitea issues
+- Searchable and organized in one location
+
+## Action Candidates
+
+- Review existing issues in `docs/issues/` folder
+- Create Gitea issues from captured issues
+- Set up automation for issue compilation (if desired)
+- Document issue compilation workflow
+
+---
+
+**Location**: `docs/issues/`  
+**Documentation**: `docs/issues/README.md`  
+**Template**: `docs/issues/template.md`
+
diff --git a/kb/CHANGELOG.md b/kb/CHANGELOG.md
index 3245baa..4129115 100644
--- a/kb/CHANGELOG.md
+++ b/kb/CHANGELOG.md
@@ -2,6 +2,18 @@
 
 All notable changes to KB files and system.
 
+## [2025-11-11] Issues Capture System Documentation
+
+### Added
+- `kb/02_systems/2025-11-11--issues-capture-system--note.md` - Documentation for issues capture system in docs/issues/ folder
+
+### Notes
+- Documents the issues capture system workflow and structure
+- Provides reference for quick issue capture before compiling to Gitea issues
+- Includes integration with Gitea platform and best practices
+
+---
+
 ## [2025-01-27] KB System Setup
 
 ### Added
diff --git a/kb/_index.md b/kb/_index.md
index 41cfeae..f9337a2 100644
--- a/kb/_index.md
+++ b/kb/_index.md
@@ -8,13 +8,71 @@ This index is automatically generated from KB file metadata. It provides searcha
 
 ## File Listing by Category
 
+### 01_projects
+
+- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md) - Test KB Workflow Validation (2025-11-11, note)
+
+### 02_systems
+
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md) - Issues Capture System Documentation (2025-11-11, note)
+
+## Topics Index
+
+### documentation
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
+
+### gitea
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
+
+### issue-tracking
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
+
+### kb-system
+- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
+
+### testing
+- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
+
+### workflow
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
+
+### workflows
+- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
+
+## Tags Index
+
+### capture
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
+
+### documentation
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
+
+### gitea
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
+
+### issues
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
+
+### temporary
+- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
+
+### test
+- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
+
+### validation
+- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
+
+### workflow
+- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
+- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
+
 ---
 
 ## Summary
 
-- **Total KB Files**: 0
-- **Unique Topics**: 0
-- **Unique Tags**: 0
+- **Total KB Files**: 2
+- **Unique Topics**: 7
+- **Unique Tags**: 8
 - **Phases Referenced**: 0
 
-_Index generated on 2025-11-11 11:53:11_
+_Index generated on 2025-11-11 12:30:43_