dotfiles

---
name: dotfiles
license: MIT
metadata:
  version: "1.0.0"
description: |
  USE FOR: This dotfiles environment and agent harness: machine setup, Nix
  operations/recovery, missing tools, operating concepts, clipboard,
  Claude/Codex config, hooks, MCP, skills, Postman routing/runbooks,
  tmux/worktrees/panes, prompt/review/resume-handoff contracts, and Agent
  Skills authoring/validation/Waza.
  DO NOT USE FOR: Nix package authoring (programming).
---

# Dotfiles Environment

Owner skill for this machine, this repository, and the agent harness.

## 1. Workflow

1. Inspect the relevant files and `git status`.
2. Open the owner reference below; make the smallest scoped change.
3. Run the nearest check (`nix run '.#check'` for flake changes); report
   verification and remaining risk.

## 2. References

Environment:

- [Machine Setup](references/machine-setup.md) — new-machine bootstrap
- [macSKK and kitty](references/macskk.md) — Ctrl-J newline troubleshooting
- [Nix Operations](references/nix-operations.md) — daily ops, upgrade,
  recovery
- [Tailscale Operations](references/tailscale-operations.md) — start the
  installed daemon and check tailnet connection
- [Missing Tools](references/missing-tools.md) — command not found
  workflow
- [Operating Concepts](references/operating-concepts.md) — repo map and
  module ownership boundaries
- [Clipboard](references/clipboard-strategy.md) — Vim/Neovim/tmux/host

Agent harness (hubs link their siblings):

- [Harness](references/harness-guidance.md) — Claude/Codex config, hooks,
  deny rules, contracts, runbook
- [Workspace](references/workspace-guidance.md) — tmux, worktrees,
  Git lock diagnostics, panes, boot, VDE
- [Prompts](references/prompt-contracts.md) — prompt
  blocks, review contracts, boundaries, resume handoff
- [Resume Handoff](references/resume-handoff.md) — local task handoffs and
  resume prompts
- [Skills Management](references/skills-management.md) — skill authoring,
  Waza, release, publishing

• SKILL.md 2 KB
• evals/eval.yaml 1 KB
• evals/tasks/negative-trigger-1.yaml 1 KB
• evals/tasks/positive-trigger-1.yaml 1 KB
• evals/tasks/positive-trigger-2.yaml 1 KB
• evals/tasks/positive-trigger-3.yaml 1 KB
• references/a2a-postman-integration-boundary.md 11 KB
• references/agent-command-approval-design.md 48 KB
• references/agent-config-philosophy.md 13 KB
• references/agent-hooks-architecture.md 8 KB
• references/ai-human-responsibility-boundaries.md 3 KB
• references/claude-changelog-tracking.md 37 KB
• references/claude-code.md 15 KB
• references/claude-optimization-tracking.md 24 KB
• references/claude-workspace-trust.md 3 KB
• references/clipboard-strategy.md 10 KB
• references/codex-cli.md 11 KB
• references/codex-optimization-tracking.md 31 KB
• references/deny-bash-design.md 11 KB
• references/harness-guidance.md 6 KB
• references/herdr.md 1 KB
• references/machine-setup.md 8 KB
• references/macskk.md 2 KB
• references/missing-tools.md 2 KB
• references/nix-operations.md 9 KB
• references/operating-concepts.md 19 KB
• references/orchestrator-runbook.md 10 KB
• references/prompt-blocks.md 5 KB
• references/prompt-contracts.md 2 KB
• references/repo-ai-operating-contract.md 22 KB
• references/repo-ai-review-boundaries.md 9 KB
• references/resume-handoff.md 1 KB
• references/review-output-contract.md 3 KB
• references/skill-description-index.md 1 KB
• references/skills-management.md 5 KB
• references/tailscale-operations.md 1 KB
• references/waza-publishing.md 5 KB
• references/workspace-boot-failure-modes.md 4 KB
• references/workspace-guidance.md 11 KB
• references/workspace-tmux-pane-operations.md 5 KB
• references/workspace-vde-layout-internals.md 1 KB
• references/workspace-worktree-workflow.md 10 KB
• references/worktree-development-overview.md 6 KB
• references/worktree-development.md 15 KB
• scripts/agent-skill-description-index.sh 3 KB