summaryrefslogtreecommitdiff
path: root/subagents/profiles.lua
diff options
context:
space:
mode:
Diffstat (limited to 'subagents/profiles.lua')
-rw-r--r--subagents/profiles.lua12
1 files changed, 5 insertions, 7 deletions
diff --git a/subagents/profiles.lua b/subagents/profiles.lua
index 4ae9f91..b1acdf3 100644
--- a/subagents/profiles.lua
+++ b/subagents/profiles.lua
@@ -1,13 +1,11 @@
-- Discover agent profiles: Markdown files with YAML frontmatter.
--
--- Two layers are read, lowest precedence first:
+-- One `agents/**/*.md` root per host config layer, lowest precedence first:
+-- base, user, project, local (`panto.ext.dirs.layers`; see subagents/paths.lua).
--
--- 1. ${XDG_CONFIG_HOME:-$HOME/.config}/panto/agents/**/*.md (user)
--- 2. <cwd>/.panto/agents/**/*.md (project)
---
--- A project profile shadows a user profile with the same resolved name. Both
--- layers are walked recursively; nesting is organisational only and never part
--- of a profile's name.
+-- A later layer's profile shadows an earlier one with the same resolved name.
+-- Every layer is walked recursively; nesting is organisational only and never
+-- part of a profile's name.
--
-- Recognised frontmatter keys, all optional:
--