OutlineDriven Automate me
Contract
| Field | Bound contract |
|---|---|
| Trigger | Create or refresh a personal mode skill. |
| Authority | Remote: pushes a branch and opens a reviewable PR; requires explicit human invocation. Previews the target file, skill content, and PR consequence before any write. |
| Side effect | Creates or edits one personal mode skill file in a local working copy on a new branch, commits it, pushes the branch, and opens a reviewable PR. No files beyond that skill file and no remote state beyond that branch and PR are touched; no credentials are read or written. |
| Done | Evidence-backed personal mode skill in a reviewable PR. |
Inputs
- A personal workflow to encode, supplied either as a direct description by the human or as a pointer to recent session or conversation history to mine for a repeated manual task pattern. At least one of these must be present.
- Target skill slug and file path. Optional; derive a slug from the workflow if the human does not supply one, and confirm it before writing.
- Repository and base branch to open the PR against. Must be supplied or determinable from the current working copy; if neither, stop and ask.
Procedure
- Require explicit human invocation. Confirm the human intends to author or refresh a personal mode skill and open a remote PR for it; do not proceed on inferred intent. Done when: the human confirms intent to author a personal skill and open a PR.
- Identify the recurring personal workflow. Use a description supplied by the human. Otherwise, mine recent session or conversation history for a task the human performs manually more than once. Name the repeated pattern and the sessions where it appears as evidence. Done when: the recurring workflow is named with supporting session evidence.
- If no recurring workflow can be supported by the history or description, stop and report that there is no candidate. Do not invent a workflow or fabricate history evidence. Done when: the absence of a candidate is reported or a candidate is confirmed.
- Draft the personal mode skill as a self-contained skill file with a name, trigger predicate, short procedure, and required inputs. The skill must not depend on another skill, module, or external rule file. Done when: the skill file is drafted as self-contained with all required sections.
- Show the human the target file path, full skill content, branch name, and consequence of opening a PR. Wait for explicit approval before any mutation. Done when: the human approves or declines the preview.
- On approval, create a new branch in the local working copy and create or edit the skill file at its target path. Write only that one file. Done when: the skill file is written on a new branch and no other file is touched.
- Commit the change with a message naming the personal workflow encoded. Done when: the commit is created with the workflow-naming message.
- Push the branch and open a reviewable PR whose description states the workflow encoded, the history evidence used, and the skill file path. Done when: the branch is pushed and the PR is opened with the required description.
- Capture the PR URL as the success evidence. Done when: the PR URL is captured.
Failure and recovery
- No recurring workflow found: stop, report no candidate, mutate nothing.
- Human declines the preview: do not write, commit, or push; leave the working copy unchanged.
- Skill file is malformed after drafting: correct frontmatter and sections before pushing; never push a skill that fails its own format.
- Push or PR open fails (authentication, network, protected base, permission): stop, report the exact error, and leave the local branch in place for retry. Do not force-push or rewrite an unrelated branch.
- Partial result rule: if the file is written and committed but the PR cannot be opened, report the local commit as the partial result and the blocking error; the done predicate is not met until a PR URL exists.
Output
A reviewable PR URL, the skill file path, and a one-line summary of the encoded personal workflow backed by the history evidence or description used, classified done only when the PR URL exists, otherwise blocked with the failure class named.