| name | dotfiles-agent-workflow |
| description | Use this skill to apply the canonical risk-gated dotfiles workflow when work is broad, autonomous, high-risk, or multi-session; when the user tags AGENT_WORKFLOW.md; or when repeated agent friction needs durable guidance. |
| purpose | Apply the repository's canonical workflow without duplicating it. |
| applies_to | Dotfiles changes that need a worklog, risk gates, or documentation repair. |
| update_when | AGENT_WORKFLOW.md, worklog fields, or hey agent commands change. |
Dotfiles agent workflow
Read AGENT_WORKFLOW.md; it is the source of truth.
Apply
- Route through root and nearest nested
AGENTS.md.
- For qualifying work, copy
.agents/worklogs/TEMPLATE.md and record the outcome, stopping condition, risks, and verification surfaces.
- Before high-risk implementation, run the plan gate. Record an exact blocker; never silently skip it.
- Follow the implementation and documentation sections. For qualifying work, keep the worklog current with decisions and evidence.
- For qualifying work, run the full landing gate in
AGENT_WORKFLOW.md. Otherwise, run focused checks and the landing steps required by root AGENTS.md.