switchbot-mcp: Instructions file for Codex

AGENTS.md

This file defines repository-level operating rules for AI agents working in this project.

Communication

• Use English for chat interactions, repository files, and documentation by default.

General Rules

• Use Conventional Commits for commit messages in English (no non-ASCII characters). If uncertain, inspect recent commit history first.
• If a user writes #{number}, treat it as a GitHub Issue number and use gh when issue operations are needed.
• For GitHub Actions, always use the latest major version of actions/*.
• In Codex, refer to ai-rules/ (symlink to ~/.config/ai/rules) when rule context is needed.

Skills Policy

• Store Codex skills directly under ./skills/ (one-level depth).
• Store user-created skills directly under ./skills/ (one-level depth).
• Store Claude skills directly under ./skills/ (one-level depth).
• Treat each SKILL.md as a living document: update when new findings, deprecations, or version changes are confirmed.
• When updating a skill, edit the chezmoi-managed source in this repository, not deployed copies like ~/.agents/skills/** or ~/.config/ai/skills/**.
• After changing chezmoi-managed files, run chezmoi apply to synchronize actual files.
• For skill maintenance work, following $chezmoi-ops is recommended.

Git / Workflow Rules

• Keep workflows as git-light as possible while preserving safe repository inspection.
• Read-only Git commands such as git status, git diff, git log, branch inspection, and git fetch are allowed and should be used to establish repository state before mutations.
• Do not create commits, push branches, open pull requests, or merge changes for review-, diagnosis-, or explanation-only tasks.
• For implementation and delivery tasks, create commits on a dedicated feature branch when needed. Pushes, pull requests, and merges require explicit user authorization or an explicitly requested delivery workflow; never push directly to the default or another protected branch.
• Exception: if chezmoi-managed source files are changed, the chezmoi workflow may require automatic git add/commit/push when necessary unless the user explicitly opts out; this exception never authorizes a direct push to the default or another protected branch.
• Prefer chezmoi apply / chezmoi update over direct git operations for synchronization.