@ionivetech/mugiwara 0.3.0 → 0.4.0

package/src/targets/claude.ts

@@ -27,6 +27,10 @@ export const target: Target = {
     if (data.tools) fm.tools = data.tools;
     return { relPath: `${data.name}.md`, text: stringifyFrontmatter(fm, body) };
   },
+  refsDir({ scope, projectDir, home }, skillName: string) {
+    const root = scope === 'global' ? join(home, '.claude') : join(projectDir, '.claude');
+    return join(root, 'skills', skillName, 'references');
+  },
   postInstall({ scope, projectDir, home, dryRun }) {
     // Wire the SessionStart hook (inline doctrine) into the installed .claude dir.
     const root = scope === 'global' ? join(home, '.claude') : join(projectDir, '.claude');

package/src/targets/copilot.ts

@@ -1,6 +1,7 @@
 // src/targets/copilot.ts
 import { join } from 'node:path';
 import { stringifyFrontmatter, type FrontmatterData } from '../frontmatter.ts';
+import type { Scope } from '../manifest.ts';
 import type { Target } from '../installer.ts';
 
 export const target: Target = {
@@ -23,4 +24,7 @@ export const target: Target = {
       text: stringifyFrontmatter({ name: data.name, description: data.description }, body),
     };
   },
+  refsDir(_opts: { scope: Scope; projectDir: string; home: string }, skillName: string) {
+    return join(_opts.projectDir, '.mugiwara', 'refs', skillName);
+  },
 };

package/src/targets/generic.ts

@@ -1,6 +1,7 @@
 // src/targets/generic.ts
 import { existsSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
+import type { Scope } from '../manifest.ts';
 import type { Target } from '../installer.ts';
 
 export function makeGeneric(opts: {
@@ -9,23 +10,54 @@ export function makeGeneric(opts: {
   rulesDir: string;
   bootstrapFile: string | null;
   bootstrapPointer: string | null;
+  tier?: 2 | 3;
 }): Target {
-  const { id, label, rulesDir, bootstrapFile, bootstrapPointer } = opts;
+  const { id, label, rulesDir, bootstrapFile, bootstrapPointer, tier = bootstrapPointer ? 2 : 3 } = opts;
+  const stubOnly = tier === 3;
   return {
     id,
     label,
     native: false,
+    tier,
     paths({ scope, projectDir }: { scope: 'global' | 'project'; projectDir: string; home: string }) {
       if (scope === 'global') throw new Error(`${label} supports project scope only`);
       const dir = join(projectDir, rulesDir);
       return { skillsDir: dir, agentsDir: dir };
     },
     transformSkill(data, body) {
+      if (stubOnly) {
+        // Stub: routing + pointer only. Full body lands in .mugiwara/refs/
+        // (outside the rules glob) so glob-loading harnesses stop eating ~40k
+        // tokens at session start. The agent reads the full file on demand.
+        return {
+          relPath: `${data.name}.md`,
+          text: `# ${data.name}\n\n> ${data.description}\n\n## Skip when\n\nFull skill: \`${data.name}\` — read \`.mugiwara/refs/${data.name}.md\` when the crew invokes this role.`,
+        };
+      }
+      return { relPath: `${data.name}.md`, text: `# ${data.name}\n\n> ${data.description}\n\n${body}` };
+    },
+    transformSkillFull(data, body) {
+      if (!stubOnly) return null;
       return { relPath: `${data.name}.md`, text: `# ${data.name}\n\n> ${data.description}\n\n${body}` };
     },
     transformAgent(data, body) {
+      if (stubOnly) {
+        return {
+          relPath: `agent-${data.name}.md`,
+          text: `# Agent: ${data.name}\n\n> ${data.description}\n\nSkills: ${data.skills ?? ''}. Read \`.mugiwara/refs/${data.name}.md\` when embodying this role.`,
+        };
+      }
       return { relPath: `agent-${data.name}.md`, text: `# Agent: ${data.name}\n\n> ${data.description}\n\nSkills used: ${data.skills ?? ''}\n\n${body}` };
     },
+    transformAgentFull(data, body) {
+      if (!stubOnly) return null;
+      return { relPath: `${data.name}.md`, text: `# Agent: ${data.name}\n\n> ${data.description}\n\nSkills used: ${data.skills ?? ''}\n\n${body}` };
+    },
+    refsDir({ projectDir }: { scope: Scope; projectDir: string; home: string }) {
+      // Keep reference detail outside the rules dir so the harness never
+      // glob-loads it; the skill names the path and the agent reads on demand.
+      return join(projectDir, '.mugiwara', 'refs');
+    },
     postInstall({ projectDir, dryRun }) {
       if (!bootstrapFile) return { written: [], notes: [] };
       const notes: string[] = [];

package/src/targets/kilo.ts

@@ -7,4 +7,5 @@ export const target = makeGeneric({
   rulesDir: '.kilo/rules',
   bootstrapFile: 'kilo.jsonc',
   bootstrapPointer: '{\n  "instructions": [\n    ".kilo/rules/*.md"\n  ]\n}',
+  tier: 3,
 });

package/src/targets/opencode.ts

@@ -22,4 +22,8 @@ export const target: Target = {
     if (data.tools) fm.tools = data.tools;
     return { relPath: `${data.name}.md`, text: stringifyFrontmatter(fm, body) };
   },
+  refsDir({ scope, projectDir, home }, skillName: string) {
+    const root = scope === 'global' ? join(home, '.config', 'opencode') : join(projectDir, '.opencode');
+    return join(root, 'skills', skillName, 'references');
+  },
 };