sysadmin
f09791e049
- 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>
43 lines
1.7 KiB
Markdown
43 lines
1.7 KiB
Markdown
# Template: start a new issue
|
|
|
|
Copy, fill the `<...>` fields, and paste as the task prompt.
|
|
|
|
```text
|
|
Task: implement <issue title / one-line goal>.
|
|
|
|
Rules (llm-project-workflow):
|
|
- No repo changes without a tracking issue. If none exists, create one first;
|
|
if it can't be created, stop.
|
|
- Work only in an isolated branch worktree under branches/. The main checkout
|
|
is orchestration/status only.
|
|
- Do not self-review or self-merge.
|
|
|
|
Steps:
|
|
1. Verify the orchestration checkout is the right repo and clean.
|
|
2. git fetch <remote> --prune; confirm local master == <remote>/master (0 0).
|
|
3. Create the issue "<title>" (problem, scope, acceptance) and claim it
|
|
(status:in-progress + a "starting work" comment naming the branch).
|
|
4. scripts/worktree-start <type>/issue-<n>-<slug> # type = fix|feat|docs
|
|
cd branches/<type>-issue-<n>-<slug>
|
|
5. Implement the narrow scope only; add/update focused tests if behavior changes.
|
|
6. Checks: run the test suite, compile/lint changed files, git diff --check,
|
|
and scan the diff for secrets.
|
|
7. Commit (issue-linked message), push the branch, open a PR to master.
|
|
Include an "LLM Handoff Metadata" block in the PR body (attribution only;
|
|
never an eligibility input — docs/llm-agent-sha.md):
|
|
|
|
LLM Handoff Metadata:
|
|
- LLM-Agent-SHA: llm-<12 lowercase hex, e.g. llm-8f3a9c2d6b41>
|
|
- LLM-Role: implementer
|
|
- Authenticated-Gitea-User: <whoami result>
|
|
- MCP-Profile: <profile name>
|
|
- Branch: <branch>
|
|
- Worktree: <worktree path>
|
|
- Self-review allowed: no
|
|
8. Stop before review/merge — you are the author.
|
|
|
|
Handoff: issue #, branch, worktree path, files changed, checks + results, PR URL —
|
|
formatted as the Controller Handoff Summary (SKILL.md §K); end with
|
|
"Review needed — PR is open".
|
|
```
|