From 766b0d19d50e1b9feca50075d4485c75257300e0 Mon Sep 17 00:00:00 2001
From: fullsend-code
 <278716306+fullsend-ai-coder[bot]@users.noreply.github.com>
Date: Tue, 1 Sep 2026 15:01:24 +0000
Subject: [PATCH 1/2] docs(#6): add FULLSEND.md documenting fullsend usage

Add a markdown file explaining how fullsend is configured in this
repository. The document covers all six enabled roles (triage,
coder, review, fix, retro, prioritize), describes the interaction
workflow from issue creation through merge, and documents the
/fs-fix-stop escape hatch derived from the actual workflow code.

Closes #6
---
 FULLSEND.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 FULLSEND.md

diff --git a/FULLSEND.md b/FULLSEND.md
new file mode 100644
index 0000000..9f018b8
--- /dev/null
+++ b/FULLSEND.md
@@ -0,0 +1,46 @@
+# Using fullsend with this repository
+
+This repository uses [fullsend](https://github.com/fullsend-ai/fullsend)
+for AI-assisted development. Fullsend runs as a set of agent roles that
+respond to GitHub events (issues, pull requests, comments) via the
+`.github/workflows/fullsend.yaml` workflow.
+
+## Configured roles
+
+The `.fullsend/config.yaml` file enables six roles:
+
+| Role | Trigger | What it does |
+|------|---------|--------------|
+| **triage** | Issue opened or labeled | Analyzes the issue, identifies root cause, and proposes a plan |
+| **coder** | `/fs-code` comment on a triaged issue | Implements the fix or feature and opens a pull request |
+| **review** | Pull request opened or updated | Reviews the PR for correctness, style, and completeness |
+| **fix** | Review requests changes | Automatically addresses review feedback on agent PRs |
+| **retro** | Pull request merged | Runs a retrospective to capture lessons learned |
+| **prioritize** | On demand | Assesses and prioritizes open issues |
+
+## How to interact
+
+1. **Open an issue** describing a bug or feature request. The
+   **triage** agent analyzes it and adds a `ready-to-code` label when
+   the issue is actionable.
+2. **Trigger the coder** by commenting `/fs-code` on a triaged issue.
+   The **coder** agent creates a branch, implements the change, and
+   opens a PR.
+3. **Review happens automatically.** The **review** agent examines the
+   PR and posts findings. If changes are requested, the **fix** agent
+   attempts to resolve them.
+4. **Merge the PR** once it passes review. The **retro** agent runs a
+   retrospective after merge.
+
+## Stopping the fix agent
+
+If you want to prevent the fix agent from acting on a PR, comment
+`/fs-fix-stop`. This adds the `fullsend-no-fix` label and disables
+automatic fixes for that PR. Remove the label or comment `/fs-fix`
+to re-engage.
+
+## Configuration
+
+The fullsend configuration lives in `.fullsend/config.yaml`. See the
+[fullsend documentation](https://github.com/fullsend-ai/fullsend) for
+available options.

From 2b1d4899bff83f88b8d9a18f906ddf2cc8d33edf Mon Sep 17 00:00:00 2001
From: fullsend-fix <278716306+fullsend-ai-coder[bot]@users.noreply.github.com>
Date: Tue, 1 Sep 2026 15:20:24 +0000
Subject: [PATCH 2/2] fix: correct triage trigger description in FULLSEND.md

Add missing "edited" event type to the triage role trigger description
to match the actual workflow configuration in fullsend.yaml.

Addresses #7
---
 FULLSEND.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/FULLSEND.md b/FULLSEND.md
index 9f018b8..02eba67 100644
--- a/FULLSEND.md
+++ b/FULLSEND.md
@@ -11,7 +11,7 @@ The `.fullsend/config.yaml` file enables six roles:
 
 | Role | Trigger | What it does |
 |------|---------|--------------|
-| **triage** | Issue opened or labeled | Analyzes the issue, identifies root cause, and proposes a plan |
+| **triage** | Issue opened, edited, or labeled | Analyzes the issue, identifies root cause, and proposes a plan |
 | **coder** | `/fs-code` comment on a triaged issue | Implements the fix or feature and opens a pull request |
 | **review** | Pull request opened or updated | Reviews the PR for correctness, style, and completeness |
 | **fix** | Review requests changes | Automatically addresses review feedback on agent PRs |