awesome-agents 0.1.3 → 0.1.5

package/AGENTS.md

@@ -9,10 +9,11 @@ OpenCode.
 
 The canonical source format is repo-neutral:
 
-- `agents/profiles/*.agent.yaml`: preferred YAML profile definitions.
-- `agents/profiles/*.agf.yaml`: Agent Format-style YAML profile definitions.
-- `agents/profiles/*.md`: Markdown profile definitions with YAML frontmatter.
-- `agents/adapters/<harness>/*`: optional harness-specific metadata and notes.
+- `agents/<slug>/agent.yaml`: preferred YAML profile definition.
+- `agents/<slug>/agent.agf.yaml`: Agent Format-style YAML profile definition.
+- `agents/<slug>/agent.md`: Markdown profile definition with YAML frontmatter.
+- `agents/<slug>/scripts/`: agent-owned scripts installed into the agent home.
+- `agents/<slug>/references/`: agent-owned references installed into the agent home.
 
 Never hard-code a particular source repository into runtime behavior, tests, or
 examples. Use neutral fixture/source names unless a test is explicitly about
@@ -53,6 +54,8 @@ source resolution.
 ## Safety
 
 - Never overwrite or delete unmanaged harness files by default.
+- Install agent-owned support files into `~/.agents/homes/<slug>/`, not into
+  harness configuration directories.
 - Keep install behavior deterministic and noninteractive. `--yes` exists for
   parity with `npx skills`, but the CLI should not require prompts to complete.
 - Do not mutate harness configuration beyond writing the selected generated

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 This file is maintained by `npm run changelog` and `npm run release`. Release entries are generated from git commit history.
 
+## 0.1.5 - 2026-07-06
+
+Changes since `v0.1.4`.
+
+- No commits found for this release.
+
+## 0.1.4 - 2026-07-06
+
+Changes since `v0.1.3`.
+
+### Added
+
+- Add justfile for lint/test/release/publish workflows (7fe04ba)
+- Add agent detail page and visual treatment explorations (7d29557)
+- Add Claude Code plugin for browsing and installing agent profiles (5a11e6f)
+- Add awesome-agents.com marketing/directory site (9ce50cd)
+
+### Changed
+
+- Link leaderboard rows to per-agent pages (6f2c471)
+- Default install to every detected harness on PATH (b5af687)
+- Render Codex profile metadata as comments (59395cc)
+- Install agent-owned support files (3ede3ce)
+
 ## 0.1.3 - 2026-07-05
 
 Initial tracked release.
@@ -31,6 +55,8 @@ Initial tracked release.
 - Replace source-specific help and documentation examples with neutral `owner/repo` examples.
 - Parse repo-neutral YAML profile files in addition to Markdown frontmatter files.
 - Replace source-specific test fixtures with neutral profile-source fixtures.
+- Prefer `agents/<slug>/agent.yaml` source directories and install colocated
+  `scripts/` and `references/` into the agent home.
 
 ## 0.1.1 - 2026-07-05
 

package/README.md

@@ -6,7 +6,7 @@ agent profile instead of a skill.
 
 Supported sources are GitHub repos, Git URLs, or local checkouts that use the
 agent-profile source layout. Profiles are read from YAML or Markdown files under
-`agents/profiles/`, adapted for the selected harness, and installed into the
+`agents/<slug>/`, adapted for the selected harness, and installed into the
 right place for Codex, Claude Code, or OpenCode.
 
 ## Install And Run
@@ -43,7 +43,9 @@ Useful install options:
 - `--agent <slug>` to select an agent profile, for example `--agent triage-agent`
 - `--profile <slug>` or `--skill <slug>` as explicit profile aliases; `--skill`
   is command-shape compatibility and does not mean the artifact is a skill
-- `--harness codex|claude-code|opencode|*` to select target harnesses
+- `--harness codex|claude-code|opencode|*` to select target harnesses; without
+  it, the CLI installs to every harness whose CLI it finds on `PATH`
+  (falling back to Codex if none are found)
 - `--all` to install all profiles to all supported harnesses
 - `--dry-run` to preview writes
 - `--project` for project-level install where supported; Codex profiles install globally
@@ -89,19 +91,20 @@ An agent-profile source should look like:
 
 ```text
 agents/
-  profiles/
-    triage-agent.agent.yaml
-    ops-agent.agf.yaml
-    legacy-agent.md
-  adapters/
-    codex/
-      optional-agent.md
+  triage-agent/
+    agent.yaml
+  ops-agent/
+    agent.agf.yaml
+    scripts/
+      heartbeat.sh
+    references/
+      runbook.md
 ```
 
 YAML profile files are preferred. The loader also accepts Markdown files with
 YAML frontmatter for compatibility with tools that use `.agent.md`-style
-profiles. Adapters are optional and can provide harness-specific metadata, but a
-profile should stand on its own without requiring an adapter.
+profiles. Agent-owned `scripts/` and `references/` are installed into
+`~/.agents/homes/<slug>/scripts` and `~/.agents/homes/<slug>/references`.
 
 ## Examples
 

package/docs/cli.md

@@ -25,7 +25,7 @@ Supported source values:
 - GitHub URL: `https://github.com/owner/repo`
 
 For GitHub sources, the CLI clones a shallow temporary copy and reads
-`agents/profiles`.
+`agents/<slug>/agent.yaml` style definitions.
 
 There is no default source. `add`, `install`, and `use` require the caller to
 provide a source explicitly.

package/docs/product/command-model.md

@@ -38,8 +38,12 @@ Accepted implementation decision:
 - Codex is an exception because `codex --profile <name>` loads
   `$CODEX_HOME/<name>.config.toml`. Codex profile installs should use that
   user-level config-layer target.
-- Codex is the default harness when no `--harness` or legacy harness-valued
-  `--agent` is provided.
+- When no `--harness` or legacy harness-valued `--agent` is provided, the CLI
+  installs to every supported harness whose CLI is detected on `PATH` (checks
+  for `codex`, `claude`, `opencode`). If none are detected, it falls back to
+  Codex only.
+- `--harness <harness>` (or a harness-valued `--agent`) narrows the install to
+  that single harness, overriding detection.
 - The CLI is noninteractive in the initial scaffold.
 - `--yes` is accepted for command-shape parity, but prompts are not currently required.
 

package/docs/product/harness-targets.md

@@ -29,11 +29,12 @@ file from `CODEX_HOME`.
 
 The generated TOML includes:
 
-- `name`
-- `description`
 - optional model settings
 - `developer_instructions`
 
+Profile name and summary are emitted as comments, not TOML keys, because Codex
+rejects unknown configuration fields under strict config parsing.
+
 ## Claude Code
 
 Generated Claude Code subagents install to:

package/docs/product/product-scope.md

@@ -8,7 +8,7 @@ These notes capture what `awesome-agents` is and why it exists.
 - It should be installable with `npx`.
 - Its command structure should mirror `npx skills`, but for agent profiles.
 - It should install profiles from any explicit source repository that follows
-  the `agents/profiles` source layout.
+  the `agents/<slug>/agent.yaml` source layout.
 - Initial harness targets are Codex, Claude Code, and OpenCode.
 - The package should be published after the scaffold works.
 
@@ -40,3 +40,8 @@ Product correction:
   the artifact shape and target harnesses.
 - Examples and tests should use neutral source names unless they are testing
   source resolution itself.
+- Source repositories should use one agent definition format per agent directory:
+  `agents/<slug>/agent.yaml` plus colocated support material.
+- `awesome-agents` installs that local support material into
+  `~/.agents/homes/<slug>/` and transcribes the agent definition to the target
+  harness.

package/docs/product/profile-source-format.md

@@ -8,25 +8,23 @@ The source format is intentionally repo-neutral:
 
 ```text
 agents/
-  profiles/
-    <profile>.agent.yaml
-    <profile>.agf.yaml
-    <profile>.md
-  adapters/
-    <harness>/
-      <profile>.md
+  <profile>/
+    agent.yaml
+    scripts/
+    references/
 ```
 
 Canonical profiles live at:
 
 ```text
-agents/profiles/*.{agent.yaml,agent.yml,agf.yaml,agf.yml,yaml,yml,agent.md,md}
+agents/<profile>/{agent.yaml,agent.yml,agent.agf.yaml,agent.agf.yml,agent.md}
 ```
 
-Optional harness adapters live at:
+Optional agent-owned support material lives at:
 
 ```text
-agents/adapters/<harness>/*
+agents/<profile>/scripts/*
+agents/<profile>/references/*
 ```
 
 ## Profile Files
@@ -42,8 +40,9 @@ of emerging YAML agent-definition shapes:
 
 The CLI should preserve canonical profile content and generate harness-specific install files. A profile is reusable product content, not local machine setup.
 
-Adapters are optional. A profile should be useful without a harness adapter; an
-adapter is only an override for harness-specific metadata or instructions.
+Agent-owned scripts and references should be installed into
+`~/.agents/homes/<profile>/scripts` and
+`~/.agents/homes/<profile>/references`.
 
 Profile source files are intentionally under `agents/`, not `skills/`, because
 the source format models agent profiles separately from loadable skills.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "awesome-agents",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Install reusable agent profiles into Codex, Claude Code, and OpenCode.",
   "type": "module",
   "bin": {

package/src/constants.js

@@ -1,5 +1,5 @@
 export const PACKAGE_NAME = "awesome-agents";
-export const PACKAGE_VERSION = "0.1.3";
+export const PACKAGE_VERSION = "0.1.5";
 export const DEFAULT_AGENT = "codex";
 export const SUPPORTED_AGENTS = ["codex", "claude-code", "opencode"];
 export const REGISTRY_DIRNAME = ".awesome-agents";
@@ -16,3 +16,10 @@ export const AGENT_ALIASES = new Map([
   ["opencode", "opencode"],
   ["open-code", "opencode"]
 ]);
+
+// The CLI binary used to detect whether a harness is available on PATH.
+export const HARNESS_COMMANDS = new Map([
+  ["codex", "codex"],
+  ["claude-code", "claude"],
+  ["opencode", "opencode"]
+]);

package/src/help.js

@@ -173,7 +173,7 @@ export function formatMissingSourceError(commandName = "add") {
   ].join("\n");
 }
 
-const sourceHint = `${ui.profile("agents/profiles/*.{agent.yaml,agf.yaml,md}")} plus optional ${ui.profile("agents/adapters/<harness>/*")}`;
+const sourceHint = `${ui.profile("agents/<slug>/agent.yaml")} plus optional ${ui.profile("agents/<slug>/{scripts,references}")}`;
 const harnesses = SUPPORTED_AGENTS.join("|");
 const exampleSource = "owner/repo";
 const exampleProfile = "triage-agent";
@@ -288,8 +288,8 @@ const commandHelp = {
       {
         title: "Install Flow:",
         rows: [
-          "1. Read canonical profiles from agents/profiles/*.{agent.yaml,agf.yaml,md}.",
-          "2. Merge optional harness notes from agents/adapters/<harness>/*.",
+          "1. Read canonical definitions from agents/<slug>/agent.yaml or compatible variants.",
+          "2. Install agent-owned scripts and references into ~/.agents/homes/<slug>/.",
           "3. Render Codex, Claude Code, or OpenCode files and record them in the registry."
         ]
       },
@@ -315,7 +315,7 @@ const commandHelp = {
       {
         title: "Choose Targets:",
         rows: [
-          { term: ui.option("(default)"), description: "Codex, installed globally as a config profile" },
+          { term: ui.option("(default)"), description: "Every harness detected on PATH (codex, claude, opencode); falls back to Codex if none are found" },
           { term: ui.option("--harness opencode"), description: "Render for one harness" },
           { term: ui.option("--harness codex claude-code"), description: "Render for multiple harnesses" },
           { term: ui.option("--harness *"), description: "Render for every supported harness" },

package/src/installer.js

@@ -1,9 +1,10 @@
 import { existsSync } from "node:fs";
 import fs from "node:fs/promises";
+import os from "node:os";
 import path from "node:path";
-import { AGENT_ALIASES, DEFAULT_AGENT, SUPPORTED_AGENTS } from "./constants.js";
+import { AGENT_ALIASES, HARNESS_COMMANDS, SUPPORTED_AGENTS } from "./constants.js";
 import { contentHash, isGeneratedContent, normalizeAgentList, renderForAgent, resolveTargetPath } from "./renderers.js";
-import { loadCatalog, materializeSource, splitSourceSpec } from "./source.js";
+import { expandHome, loadCatalog, materializeSource, splitSourceSpec } from "./source.js";
 import { readRegistry, registryPath, removeInstall, upsertInstall, writeRegistry } from "./registry.js";
 
 export async function listAvailable(sourceInput, options = {}) {
@@ -23,7 +24,7 @@ export async function installFromSource(sourceSpec, options = {}) {
   const { selectors, harnessInput } = resolveInstallSelection(split, options);
   const harnesses = normalizeAgentList(harnessInput, {
     all: options.all,
-    defaultAgent: DEFAULT_AGENT
+    defaultAgent: detectAvailableHarnesses()
   });
   const scope = resolveScope(options, harnesses);
 
@@ -37,6 +38,7 @@ export async function installFromSource(sourceSpec, options = {}) {
     const installedAt = new Date().toISOString();
 
     for (const profile of profiles) {
+      const supportTargets = await installProfileSupport(profile, options);
       for (const harness of harnesses) {
         const content = renderForAgent(profile, harness, { source: materialized.source });
         const target = resolveTargetPath(profile, harness, { ...options, scope });
@@ -53,6 +55,7 @@ export async function installFromSource(sourceSpec, options = {}) {
           target,
           installedAt,
           contentSha256: contentHash(content),
+          supportTargets,
           dryRun: Boolean(options.dryRun)
         };
 
@@ -89,7 +92,7 @@ export async function useFromSource(sourceSpec, options = {}) {
   }
 
   const harness = normalizeAgentList(harnessInput, {
-    defaultAgent: DEFAULT_AGENT
+    defaultAgent: detectAvailableHarnesses()
   })[0];
   const materialized = await materializeSource(split.source, options);
   try {
@@ -215,7 +218,7 @@ export async function updateInstalled(profileArgs = [], options = {}) {
 export async function initProfile(name, options = {}) {
   const slug = slugify(name || "new-agent-profile");
   const root = options.cwd ?? process.cwd();
-  const profilePath = path.join(root, "agents", "profiles", `${slug}.agent.yaml`);
+  const profilePath = path.join(root, "agents", slug, "agent.yaml");
 
   if (!options.force) {
     if (existsSync(profilePath)) {
@@ -237,6 +240,45 @@ export async function initProfile(name, options = {}) {
   };
 }
 
+async function installProfileSupport(profile, options = {}) {
+  if (!profile.supportDirs?.length) {
+    return [];
+  }
+
+  const home = path.resolve(expandHome(options.home ?? os.homedir()));
+  const agentHome = path.join(home, ".agents", "homes", profile.slug);
+  const targets = [];
+
+  for (const supportDir of profile.supportDirs) {
+    const files = await listFilesRecursive(supportDir.sourcePath);
+    for (const source of files) {
+      const relative = path.relative(supportDir.sourcePath, source);
+      const target = path.join(agentHome, supportDir.kind, relative);
+      targets.push(target);
+      if (!options.dryRun) {
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await fs.copyFile(source, target);
+      }
+    }
+  }
+
+  return targets;
+}
+
+async function listFilesRecursive(root) {
+  const entries = await fs.readdir(root, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const entryPath = path.join(root, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...await listFilesRecursive(entryPath));
+    } else if (entry.isFile()) {
+      files.push(entryPath);
+    }
+  }
+  return files.sort();
+}
+
 function buildRunInstructions(operations, env = process.env) {
   const instructions = [];
   const seen = new Set();
@@ -302,6 +344,10 @@ function runInstructionForOperation(operation, env) {
   return undefined;
 }
 
+function detectAvailableHarnesses(env = process.env) {
+  return SUPPORTED_AGENTS.filter((harness) => commandExists(HARNESS_COMMANDS.get(harness), env));
+}
+
 function commandExists(command, env) {
   const pathValue = env.PATH ?? "";
   if (!pathValue) {

package/src/renderers.js

@@ -1,7 +1,7 @@
 import crypto from "node:crypto";
 import os from "node:os";
 import path from "node:path";
-import { AGENT_ALIASES, GENERATED_MARKER, SUPPORTED_AGENTS } from "./constants.js";
+import { AGENT_ALIASES, DEFAULT_AGENT, GENERATED_MARKER, SUPPORTED_AGENTS } from "./constants.js";
 import { stringifyFrontmatter } from "./frontmatter.js";
 import { expandHome } from "./source.js";
 
@@ -20,7 +20,8 @@ export function normalizeAgentList(input, options = {}) {
 
   const rawAgents = flattenValues(input);
   if (rawAgents.length === 0) {
-    return [options.defaultAgent ?? "codex"];
+    const fallback = arrayify(options.defaultAgent);
+    return fallback.length > 0 ? fallback : [DEFAULT_AGENT];
   }
 
   if (rawAgents.includes("*")) {
@@ -105,9 +106,9 @@ function renderCodex(profile, context) {
     `# ${GENERATED_MARKER}.`,
     `# Source: ${context.source}`,
     `# Profile: ${profile.slug}`,
-    "",
-    `name = ${tomlString(profile.slug)}`,
-    `description = ${tomlString(profile.summary || profile.name)}`
+    `# Display name: ${tomlComment(profile.name)}`,
+    `# Summary: ${tomlComment(profile.summary || profile.name)}`,
+    ""
   ];
 
   if (model && model !== "inherit") {
@@ -223,6 +224,10 @@ function tomlString(value) {
   return JSON.stringify(String(value));
 }
 
+function tomlComment(value) {
+  return String(value).replace(/\s+/g, " ").trim();
+}
+
 function tomlMultiline(value) {
   const text = String(value).trimEnd();
   if (!text.includes("'''")) {

package/src/source.js

@@ -18,6 +18,26 @@ const PROFILE_SUFFIXES = [
   ".agent.md",
   ".md"
 ];
+const AGENT_DEFINITION_NAMES = [
+  "agent.agent.yaml",
+  "agent.agent.yml",
+  "agent.agf.yaml",
+  "agent.agf.yml",
+  "agent.yaml",
+  "agent.yml",
+  "agent.agent.md",
+  "agent.md",
+  "profile.agent.yaml",
+  "profile.agent.yml",
+  "profile.agf.yaml",
+  "profile.agf.yml",
+  "profile.yaml",
+  "profile.yml",
+  "profile.agent.md",
+  "profile.md"
+];
+const RESERVED_AGENT_DIRS = new Set(["profiles", "adapters"]);
+const SUPPORT_DIRS = ["references", "scripts"];
 
 export function splitSourceSpec(spec) {
   if (!spec) {
@@ -117,28 +137,30 @@ export async function materializeSource(sourceInput, options = {}) {
 }
 
 async function assertAgentProfileLayout(sourcePath) {
-  const profilesDir = path.join(sourcePath, "agents", "profiles");
-  if (!existsSync(profilesDir)) {
-    throw new Error(`No agents/profiles directory found in ${sourcePath}`);
+  const entries = await discoverProfileEntries(sourcePath);
+  if (entries.length === 0) {
+    throw new Error(`No agent profiles found in ${sourcePath}. Expected agents/<slug>/agent.yaml.`);
   }
 }
 
 export async function loadCatalog(sourcePath) {
-  const profilesDir = path.join(sourcePath, "agents", "profiles");
-  const adapterRoot = path.join(sourcePath, "agents", "adapters");
-  const files = await fs.readdir(profilesDir, { withFileTypes: true });
+  const entries = await discoverProfileEntries(sourcePath);
   const profiles = [];
+  const seen = new Set();
 
-  for (const file of files) {
-    if (!file.isFile() || !isProfileFile(file.name)) {
+  for (const entry of entries) {
+    const profile = await loadProfileFile(entry.filePath, sourcePath, {
+      slugHint: entry.slugHint,
+      agentRoot: entry.agentRoot
+    });
+    if (seen.has(profile.slug)) {
       continue;
     }
-
-    const filePath = path.join(profilesDir, file.name);
-    const profile = await loadProfileFile(filePath, sourcePath);
+    seen.add(profile.slug);
     profiles.push({
       ...profile,
-      adapters: await loadAdapters(adapterRoot, profile.slug, sourcePath)
+      adapters: await loadProfileAdapters(entry, profile.slug, sourcePath),
+      supportDirs: await loadSupportDirs(entry.agentRoot)
     });
   }
 
@@ -146,8 +168,104 @@ export async function loadCatalog(sourcePath) {
   return { sourcePath, profiles };
 }
 
+async function discoverProfileEntries(sourcePath) {
+  return [
+    ...await discoverAgentDirectoryProfiles(sourcePath),
+    ...await discoverLegacyProfileDirectory(sourcePath)
+  ];
+}
+
+async function discoverAgentDirectoryProfiles(sourcePath) {
+  const agentsRoot = path.join(sourcePath, "agents");
+  if (!existsSync(agentsRoot)) {
+    return [];
+  }
+
+  const entries = [];
+  const files = await fs.readdir(agentsRoot, { withFileTypes: true });
+  for (const file of files) {
+    if (!file.isDirectory() || RESERVED_AGENT_DIRS.has(file.name)) {
+      continue;
+    }
+    const agentRoot = path.join(agentsRoot, file.name);
+    const filePath = await findAgentDefinitionFile(agentRoot, file.name);
+    if (!filePath) {
+      continue;
+    }
+    entries.push({
+      layout: "agent-directory",
+      filePath,
+      slugHint: file.name,
+      agentRoot,
+      adapterRoot: path.join(agentRoot, "adapters")
+    });
+  }
+  return entries;
+}
+
+async function discoverLegacyProfileDirectory(sourcePath) {
+  const profilesDir = path.join(sourcePath, "agents", "profiles");
+  if (!existsSync(profilesDir)) {
+    return [];
+  }
+
+  const entries = [];
+  const files = await fs.readdir(profilesDir, { withFileTypes: true });
+  for (const file of files) {
+    if (!file.isFile() || !isProfileFile(file.name)) {
+      continue;
+    }
+    entries.push({
+      layout: "legacy-profiles-directory",
+      filePath: path.join(profilesDir, file.name),
+      slugHint: profileSlugFromFilename(file.name),
+      adapterRoot: path.join(sourcePath, "agents", "adapters")
+    });
+  }
+  return entries;
+}
+
+async function findAgentDefinitionFile(agentRoot, slug) {
+  for (const name of AGENT_DEFINITION_NAMES) {
+    const candidate = path.join(agentRoot, name);
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  for (const suffix of PROFILE_SUFFIXES) {
+    const candidate = path.join(agentRoot, `${slug}${suffix}`);
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return undefined;
+}
+
+async function loadProfileAdapters(entry, slug, sourcePath) {
+  const adapters = {};
+  Object.assign(adapters, await loadAdapters(entry.adapterRoot, slug, sourcePath));
+  if (entry.layout === "agent-directory") {
+    Object.assign(adapters, await loadAdapters(path.join(sourcePath, "agents", "adapters"), slug, sourcePath));
+  }
+  return adapters;
+}
+
+async function loadSupportDirs(agentRoot) {
+  if (!agentRoot) {
+    return [];
+  }
+  const dirs = [];
+  for (const kind of SUPPORT_DIRS) {
+    const sourcePath = path.join(agentRoot, kind);
+    if (existsSync(sourcePath)) {
+      dirs.push({ kind, sourcePath });
+    }
+  }
+  return dirs;
+}
+
 async function loadAdapters(adapterRoot, slug, sourcePath) {
-  if (!existsSync(adapterRoot)) {
+  if (!adapterRoot || !existsSync(adapterRoot)) {
     return {};
   }
 
@@ -178,10 +296,10 @@ async function loadAdapters(adapterRoot, slug, sourcePath) {
   return adapters;
 }
 
-async function loadProfileFile(filePath, sourcePath) {
+async function loadProfileFile(filePath, sourcePath, options = {}) {
   const raw = await fs.readFile(filePath, "utf8");
   const parsed = await loadDefinitionFile(filePath, raw);
-  const fallbackSlug = profileSlugFromFilename(path.basename(filePath));
+  const fallbackSlug = options.slugHint ?? profileSlugFromFilename(path.basename(filePath));
   const slug = parsed.attributes.slug ?? parsed.attributes.id ?? fallbackSlug;
   const name = parsed.attributes.name ?? titleize(slug);
   const summary = parsed.attributes.summary ?? parsed.attributes.description ?? "";
@@ -200,7 +318,9 @@ async function loadProfileFile(filePath, sourcePath) {
     raw,
     filePath,
     relativePath: path.relative(sourcePath, filePath),
-    format: parsed.format
+    format: parsed.format,
+    agentRoot: options.agentRoot,
+    layout: options.agentRoot ? "agent-directory" : "legacy-profiles-directory"
   };
 }