refactor(gitea): deep modules — split flat dispatch skill into 6 domain skills + orchestrator + agent (#67)

plugins/gitea/skills/gitea-files/references/examples.md

@@ -0,0 +1,65 @@
+---
+source_keys:
+  - gitea-mcp-repo
+  - gitea-mcp-slim-go
+---
+
+# Canonical call sequences
+
+## Push a file to a new branch, then open a PR
+
+```
+1. get_repository_tree or get_file_contents on the base branch — only needed if the
+   new file is actually replacing an existing one; skip for a brand-new path.
+
+2. create_or_update_file
+     owner, repo
+     path: "docs/example.md"
+     content: "<base64-encoded content>"
+     message: "docs: add example"
+     branch_name: "main"
+     new_branch_name: "feat/add-example"   ← branches off before the commit lands
+     (sha omitted — this is a new file)
+
+3. Hand off to gitea-prs to open a PR from "feat/add-example" into "main".
+```
+
+`new_branch_name` on `create_or_update_file` replaces a separate branch-creation call — the branch is created and the commit lands on it in one step.
+
+## Update a file when you don't already have its SHA
+
+SHA is mandatory for updates. If it wasn't captured earlier in the conversation:
+
+```
+1. get_file_contents
+     owner, repo
+     ref: "main"
+     path: "docs/example.md"
+   → read the top-level `sha` field (not content.sha)
+
+2. create_or_update_file
+     owner, repo
+     path: "docs/example.md"
+     content: "<new base64-encoded content>"
+     message: "docs: update example"
+     branch_name: "main"
+     sha: "<sha from step 1>"
+```
+
+Do not guess or omit the SHA — the write either fails (409 on create-path fallback) or is rejected outright.
+
+## Delete a file
+
+Same SHA-first pattern, no fallback path:
+
+```
+1. get_file_contents  owner, repo, ref: "main", path: "docs/old-example.md"
+   → read the top-level `sha` field
+
+2. delete_file
+     owner, repo
+     path: "docs/old-example.md"
+     message: "docs: remove old example"
+     branch_name: "main"
+     sha: "<sha from step 1>"
+```

plugins/gitea/skills/gitea-files/references/sources.md

@@ -0,0 +1,46 @@
+# Sources
+
+## gitea-mcp-repo
+
+**Description:** Official gitea-mcp repository (v1.3.0); operation/*.go source files documenting all 55 MCP tools, their parameters, and CLI flags.
+
+**Source:** https://gitea.com/gitea/gitea-mcp
+
+- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md
+
+**Contributing files:**
+- SKILL.md (Gotchas, Reading, Writing — tool parameters and SHA/concurrency behavior, cross-checked live against the deployed MCP tool schemas via ToolSearch)
+- references/examples.md (canonical call sequences)
+
+## gitea-mcp-slim-go
+
+**Description:** Slim response shape structs from gitea-mcp source; defines exactly which fields the MCP server returns for files (top-level `sha`, no nested `content.sha`) and directory/tree entries.
+
+**Source:** https://gitea.com/gitea/gitea-mcp/raw/branch/main/operation/repo/slim.go
+
+- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md
+
+**Contributing files:**
+- SKILL.md (Gotchas — top-level `sha` field location, `get_dir_contents`/`get_repository_tree` not being usable SHA sources for a file write)
+- references/examples.md (SHA-first update/delete sequences)
+
+## context7-websites-gitea
+
+**Description:** Official Gitea docs mirror on Context7 (docs.gitea.com content) — confirms direct-commit file editing through the web UI is a first-class, expected workflow rather than an API-only escape hatch.
+
+**Source:** context7:/websites/gitea
+
+- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md
+
+**Contributing files:**
+- SKILL.md (Gotchas — "Direct commits to a branch are a first-class action, not a workaround")
+
+## context7-gitea-tea-cli
+
+**Description:** Official `tea` CLI (reference Gitea client) docs on Context7 — practitioner command patterns for issues, PRs, and releases, including semver tag/release conventions, draft/prerelease flags, and release-notes-from-file conventions. Consulted alongside `context7-websites-gitea` while researching `workflow-conventions.md` (both sources contribute to that research doc, backing `gitea-workflow`); its file-command patterns did not end up informing any gitea-files content.
+
+**Source:** context7:/git_gitea_com/gitea_tea
+
+- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md
+
+**Contributing files:** (none)