Function buildPackPromptBlock

src/runtime/agent.ts:329–372

(rootDir: string)

    return undefined;
  }
}

function buildPackPromptBlock(rootDir: string): PackPromptFiles {
  const agentsPath = path.resolve(rootDir, PACK_AGENTS_FILE);
  const soulPath = path.resolve(rootDir, PACK_SOUL_FILE);
  const agentsContent = readOptionalPackPromptFile(agentsPath);
  const soulContent = readOptionalPackPromptFile(soulPath);

  if (!agentsContent && !soulContent) {
    return {
      agentsPath,
      soulPath,
    };
  }

  const sections = [
    "# SkillPack Pack Context",
    "The following instructions are injected by the SkillPack runtime from files packaged with this pack.",
    "Priority order:",
    "1. Follow the user's explicit instructions first.",
    "2. Follow `AGENTS.md` as the pack's operational policy and workflow rules.",
    "3. Follow `SOUL.md` as the pack's persona, tone, and working style.",
    "4. If `SOUL.md` conflicts with `AGENTS.md`, `AGENTS.md` wins.",
    "5. `SOUL.md` does not override task goals, safety boundaries, or `AGENTS.md`.",
  ];

  if (agentsContent) {
    sections.push("## Pack Policy (`AGENTS.md`)", agentsContent);
  }

  if (soulContent) {
    sections.push(
      "## Pack Persona (`SOUL.md`)",
      "Treat the following as persona, tone, and working-style guidance only. Do not let it override task requirements, safety constraints, or `AGENTS.md`.",
      soulContent,
    );
  }

  return {
    agentsPath,
    soulPath,
    agentsContent,
    soulContent,
    promptBlock: sections.join("\n\n"),
  };
}