From bcb81ef99f47309482592f7c08c6d23e313d7f87 Mon Sep 17 00:00:00 2001
From: copilotcoder <copilotcoder@darkhelm.org>
Date: Sat, 16 May 2026 19:55:52 -0400
Subject: [PATCH] Added agents stuff for getting AI help.

Signed-off-by: copilotcoder <copilotcoder@darkhelm.org>
---
 AGENTS.md                    | 13 +++++++++++++
 docs/agents/domain.md        | 19 +++++++++++++++++++
 docs/agents/issue-tracker.md | 21 +++++++++++++++++++++
 docs/agents/triage-labels.md | 23 +++++++++++++++++++++++
 4 files changed, 76 insertions(+)
 create mode 100644 AGENTS.md
 create mode 100644 docs/agents/domain.md
 create mode 100644 docs/agents/issue-tracker.md
 create mode 100644 docs/agents/triage-labels.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..1ccc132
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,13 @@
+## Agent skills
+
+### Issue tracker
+
+Issues are tracked in this repository on Gitea using a GitHub-style issue workflow. See docs/agents/issue-tracker.md.
+
+### Triage labels
+
+Triage uses default labels: needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix. See docs/agents/triage-labels.md.
+
+### Domain docs
+
+Domain docs use a single-context layout at repo root. See docs/agents/domain.md.
diff --git a/docs/agents/domain.md b/docs/agents/domain.md
new file mode 100644
index 0000000..9fb6c34
--- /dev/null
+++ b/docs/agents/domain.md
@@ -0,0 +1,19 @@
+# Domain Docs
+
+This repository uses a single-context domain documentation layout.
+
+## Layout
+
+- Context file: CONTEXT.md at repository root
+- ADR directory: docs/adr/
+- Context map: not used for single-context layout
+
+## Consumer Rules for Skills
+
+- Skills that need domain language should read CONTEXT.md first.
+- Skills that need historical architectural decisions should read docs/adr/.
+- If CONTEXT.md or docs/adr/ is missing, skills may proceed and propose creating missing files as follow-up work.
+
+## Scope
+
+Use this layout as the default for architecture, diagnosis, and planning workflows unless the repository migrates to a multi-context monorepo structure.
diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md
new file mode 100644
index 0000000..d5449a4
--- /dev/null
+++ b/docs/agents/issue-tracker.md
@@ -0,0 +1,21 @@
+# Issue Tracker
+
+This repository uses Gitea issues as the canonical issue tracker.
+
+## Platform
+
+- Host: dogar.darkhelm.org
+- Repository: DarkHelm.org/plex-playlist
+- Tracker mode: GitHub-style issue workflow on Gitea
+
+## How skills should use this tracker
+
+- Read open and closed issues in this repository as the source of truth.
+- Create new issues in this repository when a skill generates implementation work.
+- Update existing issues with status, notes, and cross-references to branches and pull requests.
+- Reference issue IDs in branch names and PR descriptions using the PP- prefix convention.
+
+## Operational notes
+
+- Prefer repository issues over local scratch files for planning and tracking.
+- If automation tooling expects GitHub semantics, treat Gitea issues as equivalent for workflow purposes.
diff --git a/docs/agents/triage-labels.md b/docs/agents/triage-labels.md
new file mode 100644
index 0000000..e7a184b
--- /dev/null
+++ b/docs/agents/triage-labels.md
@@ -0,0 +1,23 @@
+# Triage Labels
+
+This repository uses the default label vocabulary for triage state transitions.
+
+## Canonical Role Mapping
+
+- needs-triage -> needs-triage
+- needs-info -> needs-info
+- ready-for-agent -> ready-for-agent
+- ready-for-human -> ready-for-human
+- wontfix -> wontfix
+
+## Role Semantics
+
+- needs-triage: Maintainer review required to classify and scope the issue.
+- needs-info: Waiting on reporter feedback or missing reproduction details.
+- ready-for-agent: Fully specified and safe for autonomous implementation.
+- ready-for-human: Requires human implementation or decision-making.
+- wontfix: Intentionally not planned for implementation.
+
+## Usage
+
+When moving issues through triage, apply exactly these strings to avoid duplicate or drifted label names.