sysadminandClaude Fable 5
45c5cac2bc
- Upgrade SKILL.md §K compact format to the issue #182 canonical field set (Task/Repo/Role/Identity/Issue-PR/Branch-SHA/Files/Validation/Mutations/ Current status/Blockers/Next/Safety) plus role-specific field lists for review/merge, author, and queue/inventory tasks. - Point the review-pr, merge-pr, and start-issue template handoff lines at the exactly-titled Controller Handoff section with their role fields. - Add review_proofs.assess_controller_handoff(): reports without the exact section are 'missing' (downgraded), present-but-partial are 'incomplete' with the absent fields listed, and role extras are enforced per role. - Add TestControllerHandoff (8 tests) including a SKILL.md doc-contract test so the documented requirement cannot silently rot. The handoff supplements the full report; full-report validation rules are unchanged. Closes #182 Co-Authored-By: Claude Fable 5 <[email protected]>
52 lines
2.6 KiB
Markdown
52 lines
2.6 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. Identity Checklist: Before claiming work, verify and state:
|
|
- Required identity/profile for this task: author (allowed to push branches / create PRs)
|
|
- Current authenticated identity (from whoami): <username>
|
|
- Target task role: author/work identity
|
|
*If the current identity does not match the required role (or lacks push/PR permissions), STOP before claiming the issue. Relaunch/switch to the correct profile first.*
|
|
2. Verify the orchestration checkout is the right repo and clean.
|
|
3. git fetch <remote> --prune; confirm local master == <remote>/master (0 0).
|
|
4. Create the issue "<title>" (problem, scope, acceptance) and claim it
|
|
(status:in-progress + a "starting work" comment naming the branch).
|
|
5. scripts/worktree-start <type>/issue-<n>-<slug> # type = fix|feat|docs
|
|
cd branches/<type>-issue-<n>-<slug>
|
|
6. Implement the narrow scope only; add/update focused tests if behavior changes.
|
|
7. Checks: run the test suite, compile/lint changed files, git diff --check,
|
|
and scan the diff for secrets.
|
|
8. Commit (issue-linked message), push the branch, open a PR to master.
|
|
*The PR body MUST use closing keywords like `Closes #N` or `Fixes #N` to close the issue; do NOT use `Implements #N` or `Refs #N` for closing, as Gitea will not auto-close it.*
|
|
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
|
|
9. Stop before review/merge — you are the author.
|
|
|
|
Handoff: end with a section titled exactly `Controller Handoff` per SKILL.md
|
|
§K (compact; long form only on the high-risk triggers), including the author
|
|
role fields: Selected issue, Claim/comment status, PR number opened, and an
|
|
explicit "No review/merge:" confirmation — plus branch, worktree path, files
|
|
changed, checks + results. Next line: "Review needed — PR is open". Reports
|
|
missing the handoff are downgraded (review_proofs.assess_controller_handoff).
|
|
```
|