From 6436d1e0b83ada91e1b0cf0b5e9045a65a45363b Mon Sep 17 00:00:00 2001
From: "M.V. Hutz" <git@maximhutz.me>
Date: Mon, 12 Jan 2026 20:40:25 -0500
Subject: [PATCH] feat: add issue templates for Gitea

Added three issue templates to improve issue tracking:
- Feature request template for new features and enhancements.
- Bug report template for reporting bugs and unexpected behavior.
- General issue template for issues that don't fit other categories.

Templates follow Gitea best practices with proper frontmatter metadata.
Each template includes clear sections with inline comments to guide users.

Updated CLAUDE.md with issue management and workflow documentation.

Closes #21

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 .gitea/ISSUE_TEMPLATE/bug.md     | 58 ++++++++++++++++++++++++++++++++
 .gitea/ISSUE_TEMPLATE/feature.md | 44 ++++++++++++++++++++++++
 .gitea/ISSUE_TEMPLATE/general.md | 37 ++++++++++++++++++++
 CLAUDE.md                        | 25 ++++++++++++++
 4 files changed, 164 insertions(+)
 create mode 100644 .gitea/ISSUE_TEMPLATE/bug.md
 create mode 100644 .gitea/ISSUE_TEMPLATE/feature.md
 create mode 100644 .gitea/ISSUE_TEMPLATE/general.md

diff --git a/.gitea/ISSUE_TEMPLATE/bug.md b/.gitea/ISSUE_TEMPLATE/bug.md
new file mode 100644
index 0000000..2a143f4
--- /dev/null
+++ b/.gitea/ISSUE_TEMPLATE/bug.md
@@ -0,0 +1,58 @@
+---
+name: "Bug Report"
+about: "Report a bug or unexpected behavior in the lambda interpreter."
+title: "fix: "
+ref: "main"
+assignees: []
+labels:
+  - bug
+---
+
+## Context
+
+<!--
+Describe what you were trying to do when you encountered the bug.
+Explain what you expected to happen.
+-->
+
+## Current Behavior
+
+<!--
+Describe what actually happened.
+Be specific about the incorrect behavior or error.
+-->
+
+## Steps to Reproduce
+
+<!--
+Provide step-by-step instructions to reproduce the issue.
+Include any relevant code, commands, or input.
+-->
+
+1.
+2.
+3.
+
+## Expected Behavior
+
+<!--
+Describe what should happen instead.
+-->
+
+## Environment
+
+<!--
+Provide relevant information about your environment.
+-->
+
+- Lambda version:
+- Go version:
+- Operating system:
+
+## Additional Context
+
+<!--
+Add any other context about the problem.
+Include error messages, logs, or screenshots if applicable.
+If none exist, omit this section.
+-->
diff --git a/.gitea/ISSUE_TEMPLATE/feature.md b/.gitea/ISSUE_TEMPLATE/feature.md
new file mode 100644
index 0000000..cedccb8
--- /dev/null
+++ b/.gitea/ISSUE_TEMPLATE/feature.md
@@ -0,0 +1,44 @@
+---
+name: "Feature Request"
+about: "Suggest a new feature or enhancement for the lambda interpreter."
+title: "feat: "
+ref: "main"
+assignees: []
+labels:
+  - enhancement
+---
+
+## Context
+
+<!--
+Describe the problem or limitation you're encountering.
+Explain why this feature would be valuable.
+-->
+
+## Proposed Solution
+
+<!--
+Describe your proposed solution or enhancement.
+Be specific about what you want to see implemented.
+-->
+
+## Alternatives Considered
+
+<!--
+List any alternative solutions or approaches you've considered.
+If none exist, omit this section.
+-->
+
+## Acceptance Criteria
+
+<!--
+List clear, testable criteria that define when this feature is complete.
+Use bullet points starting with •
+-->
+
+## Additional Context
+
+<!--
+Add any other context, screenshots, or examples about the feature request.
+If none exist, omit this section.
+-->
diff --git a/.gitea/ISSUE_TEMPLATE/general.md b/.gitea/ISSUE_TEMPLATE/general.md
new file mode 100644
index 0000000..228bcf3
--- /dev/null
+++ b/.gitea/ISSUE_TEMPLATE/general.md
@@ -0,0 +1,37 @@
+---
+name: "General Issue"
+about: "Create an issue that doesn't fit other templates."
+title: ""
+ref: "main"
+assignees: []
+labels: []
+---
+
+## Context
+
+<!--
+Describe the background and context for this issue.
+Explain why this issue exists.
+-->
+
+## Description
+
+<!--
+Provide a detailed description of what needs to be done.
+Be clear and specific about the requirements.
+-->
+
+## Acceptance Criteria
+
+<!--
+List clear, testable criteria that define when this issue is complete.
+Use bullet points starting with •
+If none exist, omit this section.
+-->
+
+## Additional Context
+
+<!--
+Add any other relevant information, links, or references.
+If none exist, omit this section.
+-->
diff --git a/CLAUDE.md b/CLAUDE.md
index 2c543c0..10074b1 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -37,6 +37,31 @@ Use format: `<type>/<description>` with kebab-case.
 
 DO NOT advertise Claude.
 
+## Issue Management
+
+Use the `tea` CLI (Gitea command-line tool) for issue operations.
+
+**Common commands**:
+
+- `tea issues list` - List all issues.
+- `tea issues <number>` - View details of a specific issue.
+- `tea issues create --title "<title>" --body "<description>"` - Create a new issue.
+- `tea issues close <number>` - Close an issue.
+
+**Reading issues**: Use `tea issues <number>` to read the full details of an issue before starting work.
+
+## Issue Workflow
+
+When working on an issue:
+
+1. Read the issue using `tea issues <number>` to understand requirements.
+2. Create a feature branch following the branch naming convention.
+3. Make commits following the conventional commit format.
+4. Submit a pull request when ready.
+
+**Important**: Never commit directly to `main`.
+All work must be done in a feature branch and submitted via pull request.
+
 ## Pull Request Management
 
 Use the `tea` CLI (Gitea command-line tool) for PR operations instead of `gh`.
-- 
2.49.1