From 566073c6d2a3988bd1909ff93a999b5a7b5c9e32 Mon Sep 17 00:00:00 2001
From: fullsend-code
 <278716306+fullsend-ai-coder[bot]@users.noreply.github.com>
Date: Sun, 12 Jul 2026 11:50:24 +0000
Subject: [PATCH 1/2] docs(#371): document agent/skill content migration to
 fullsend-ai/agents

Add "Agent definitions and skills" section to AGENTS.md noting that
agent definitions, skills, harness configs, and related content
have moved to fullsend-ai/agents. The copies under
internal/scaffold/fullsend-repo/ are stale and will be removed.

Add deprecation README.md files to the three affected scaffold
directories (agents/, skills/, harness/) so contributors see
the migration notice before editing.

Closes #371
---
 AGENTS.md                                         | 10 ++++++++++
 internal/scaffold/fullsend-repo/agents/README.md  |  4 ++++
 internal/scaffold/fullsend-repo/harness/README.md |  4 ++++
 internal/scaffold/fullsend-repo/skills/README.md  |  4 ++++
 4 files changed, 22 insertions(+)
 create mode 100644 internal/scaffold/fullsend-repo/agents/README.md
 create mode 100644 internal/scaffold/fullsend-repo/harness/README.md
 create mode 100644 internal/scaffold/fullsend-repo/skills/README.md

diff --git a/AGENTS.md b/AGENTS.md
index 5620b735fd..b197282a3c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -46,6 +46,16 @@ The e2e tests require GitHub credentials. There are three ways to provide them:
 
 If only `E2E_GITHUB_USERNAME` and a password source are available, `make e2e-test` will automatically generate a session file before running tests. See `make help` for all available targets.
 
+## Agent definitions and skills
+
+Agent definitions, skills, harness configs, and related content have moved to
+[`fullsend-ai/agents`](https://github.com/fullsend-ai/agents). The copies under
+`internal/scaffold/fullsend-repo/` are stale and will be removed. Do not modify
+files under `internal/scaffold/fullsend-repo/agents/`,
+`internal/scaffold/fullsend-repo/skills/`, or
+`internal/scaffold/fullsend-repo/harness/` — make changes in
+`fullsend-ai/agents` instead.
+
 ## Forge abstraction
 
 All git forge operations (GitHub API calls, PR comments, issue creation, workflow dispatch, etc.) **must** go through the `forge.Client` interface defined in `internal/forge/forge.go`. This is a fundamental architectural rule — the codebase supports multiple forges (GitHub, GitLab, Forgejo) and direct coupling to any single forge breaks the abstraction.
diff --git a/internal/scaffold/fullsend-repo/agents/README.md b/internal/scaffold/fullsend-repo/agents/README.md
new file mode 100644
index 0000000000..dd1c87b2de
--- /dev/null
+++ b/internal/scaffold/fullsend-repo/agents/README.md
@@ -0,0 +1,4 @@
+# Deprecated
+
+This content has moved to [`fullsend-ai/agents`](https://github.com/fullsend-ai/agents).
+Do not modify files here — they are stale copies and will be removed.
diff --git a/internal/scaffold/fullsend-repo/harness/README.md b/internal/scaffold/fullsend-repo/harness/README.md
new file mode 100644
index 0000000000..dd1c87b2de
--- /dev/null
+++ b/internal/scaffold/fullsend-repo/harness/README.md
@@ -0,0 +1,4 @@
+# Deprecated
+
+This content has moved to [`fullsend-ai/agents`](https://github.com/fullsend-ai/agents).
+Do not modify files here — they are stale copies and will be removed.
diff --git a/internal/scaffold/fullsend-repo/skills/README.md b/internal/scaffold/fullsend-repo/skills/README.md
new file mode 100644
index 0000000000..dd1c87b2de
--- /dev/null
+++ b/internal/scaffold/fullsend-repo/skills/README.md
@@ -0,0 +1,4 @@
+# Deprecated
+
+This content has moved to [`fullsend-ai/agents`](https://github.com/fullsend-ai/agents).
+Do not modify files here — they are stale copies and will be removed.

From 8bcd31d1e7403ce8f14f505fbacd20982ac057a7 Mon Sep 17 00:00:00 2001
From: fullsend-fix <278716306+fullsend-ai-coder[bot]@users.noreply.github.com>
Date: Sun, 12 Jul 2026 13:54:22 +0000
Subject: [PATCH 2/2] fix(#371): clarify harness README is still actively used

The harness scaffold files are still embedded by baseurl.go, unlike
agents/ and skills/ which are genuinely stale. Update the deprecation
notice to say "being migrated" and note the Go code dependency.

Addresses review feedback on #420
---
 internal/scaffold/fullsend-repo/harness/README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/internal/scaffold/fullsend-repo/harness/README.md b/internal/scaffold/fullsend-repo/harness/README.md
index dd1c87b2de..8f4923abaf 100644
--- a/internal/scaffold/fullsend-repo/harness/README.md
+++ b/internal/scaffold/fullsend-repo/harness/README.md
@@ -1,4 +1,6 @@
 # Deprecated
 
-This content has moved to [`fullsend-ai/agents`](https://github.com/fullsend-ai/agents).
-Do not modify files here — they are stale copies and will be removed.
+This content is being migrated to [`fullsend-ai/agents`](https://github.com/fullsend-ai/agents).
+These files are still embedded by Go code (`internal/scaffold/baseurl.go`), so
+changes here remain necessary until the Go references are updated. Once migrated,
+these copies will be removed.