- SKILL.md: new §K Controller Handoff Summary (required every task type)
with the exact format and a worked blocked-handoff example; issue-first
rule extended (discussion/RFC issues, unclear-tracker-home stop rule, no
new repo/tracker without owner approval); merge workflow now names
identity+author verification, profile gates, independent validation, and
pinned head SHA / expected changed-file merges; tagging rules extended
(no tag ops unless instructed, tag only the verified final master merge
commit, always report tag target).
- llm-workflow-runbooks.md: Controller Handoff Summary section pointing at
SKILL §K, incl. discussion/RFC rule (e.g. #100 stays a discussion issue).
- templates/start-issue.md + review-pr.md: handoff lines now reference the
required summary format and the exact-gate reporting rule.
Docs only; no code behavior changed. No tags touched; #100 not modified.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Extract the project's operating rules into a reusable, project-agnostic skill
so any repo can adopt the same safe LLM workflow.
- skills/llm-project-workflow/SKILL.md: issue-first; isolated branch worktrees
(main checkout = orchestration only); distinct author/reviewer identities and
profile safety (secrets by reference only; stop if authenticated user == PR
author); branch naming; start/review/merge/cleanup workflows; fail-closed
cases; recovery patterns; and an "Adapting to a project" table for the
forge-specific names.
- templates/: copy/paste prompts for start-issue, review-pr, merge-pr,
recover-bad-state, worktree-cleanup.
- Link the skill from README.md and docs/llm-workflow-runbooks.md (the runbook
is framed as the Gitea-specific application of the portable skill).
Docs-only; no code, no secrets, safe placeholder examples only. No change to
MCP runtime, Gitea API, credential storage, or worktree helpers.
Checks: full suite 287 passed / 0 failures; git diff --check clean; secret scan
of skills/ clean.
Closes#46. Refs #38, #39.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
sysadmin