dotfiles/AGENTS.md

Agent Guidelines

Architecture & Modules

• Each tool/service lives in its own top-level folder (<service>/) with its own Justfile.
• The root Justfile registers every service using mod <service> and runs just <service>::deploy in all.
• Deployment links the entire module folder directly to its target destination (e.g. ln -sfnT {{config_dir}} {{dest}}), rather than linking individual files or subfolders.

Justfile Philosophy

• Keep Justfile recipes declarative, clean, and minimal — never use bash loops, subshells, or complex inline scripts.
• Always define paths at the top using source_directory() and env("HOME").
• Always set the default recipe to list commands:

  @default:
      just --list
  

• Every module Justfile must expose a deploy recipe.

Git & Commit Convention

• Follow Conventional Commits: <type>(<scope>): <short imperative description> (or <type>: <description> for root-level changes).
  • Allowed types: feat, fix, refactor, chore, doc, ops.
  • <scope> is the module name (niri, xxh, agents, etc.).
  • Keep messages lowercase, concise, and without a trailing period (e.g., feat(agents): add initial skills, refactor(xxh): standardize justfile).