@moskala/oneagent-templates 0.3.1 → 0.4.1

package/README.md

@@ -201,3 +201,54 @@ Follow the team coding standards documented in Notion.
 ```
 
 Skills, plugins, and rules are all optional.
+
+---
+
+## `extends`
+
+Templates can inherit from other templates using the `extends` field. The child template only needs to define what it **adds** — skills, plugins, and rules from the parent are merged automatically.
+
+```yaml
+name: my-react-template
+description: Our React starter
+extends: https://github.com/moskalakamil/oneagent-template
+
+skills:
+  - repo: https://github.com/anthropics/skills
+    skill: frontend-design
+plugins:
+  - target: claude
+    id: frontend-design@claude-plugins-official
+```
+
+### What `extends` accepts
+
+| Value | Example | Description |
+|-------|---------|-------------|
+| Builtin template name | `extends: default` | Inherits from one of the built-in templates (`default`, `react`, `react-native`) |
+| GitHub URL | `extends: https://github.com/org/template` | Inherits from a remote template (supports `/tree/branch/subdir` URLs) |
+
+### Merge behavior
+
+| Field | Behavior |
+|-------|----------|
+| `skills` | `[...parent.skills, ...own.skills]` |
+| `plugins` | `[...parent.plugins, ...own.plugins]` |
+| `rules` | `[...parent.rules, ...own.rules]` |
+| `instructions` | **Not inherited** — each template has its own `instructions.md` |
+
+### Chaining
+
+Extends is recursive. The built-in templates form a chain:
+
+```
+react-native → react → default
+```
+
+- `default` defines 7 skills and 9 plugins
+- `react` adds 7 skills and 2 plugins (total after merge: 14 skills, 11 plugins)
+- `react-native` adds 5 skills (total after merge: 19 skills, 11 plugins)
+
+### Limitations
+
+Remote templates (fetched from GitHub) can only extend other remote templates via URL — not built-in template names.

package/dist/index.js

@@ -0,0 +1,42 @@
+// src/index.ts
+import path from "path";
+import fs from "fs/promises";
+import { fileURLToPath } from "url";
+import { parseTemplateYaml, resolveExtends } from "@moskala/oneagent-core";
+var __dirname2 = path.dirname(fileURLToPath(import.meta.url));
+var TEMPLATE_NAMES = ["default", "react", "react-native"];
+async function loadTemplate(name) {
+  const templateDir = path.join(__dirname2, "templates", name);
+  const [yamlText, instructions] = await Promise.all([
+    fs.readFile(path.join(templateDir, "template.yml"), "utf-8"),
+    fs.readFile(path.join(templateDir, "instructions.md"), "utf-8")
+  ]);
+  const parsed = parseTemplateYaml(yamlText, name);
+  const rulesDir = path.join(templateDir, "rules");
+  let rules = [];
+  try {
+    const ruleFiles = await fs.readdir(rulesDir);
+    rules = await Promise.all(ruleFiles.filter((f) => f.endsWith(".md")).map(async (f) => ({
+      name: path.basename(f, ".md"),
+      content: await fs.readFile(path.join(rulesDir, f), "utf-8")
+    })));
+  } catch {}
+  const base = { ...parsed, instructions, rules };
+  return resolveExtends(base, (n) => resolveBuiltinTemplate(n));
+}
+async function resolveBuiltinTemplate(name) {
+  if (!TEMPLATE_NAMES.includes(name))
+    return null;
+  return loadTemplate(name);
+}
+var BUILTIN_TEMPLATE_NAMES = TEMPLATE_NAMES;
+var BUILTIN_TEMPLATE_META = [
+  { name: "default", description: "General programming starter" },
+  { name: "react", description: "React / Next.js project starter" },
+  { name: "react-native", description: "React Native / Expo project starter" }
+];
+export {
+  resolveBuiltinTemplate,
+  BUILTIN_TEMPLATE_NAMES,
+  BUILTIN_TEMPLATE_META
+};

package/dist/templates/default/instructions.md

@@ -0,0 +1,3 @@
+# Project Instructions
+
+Add your AI instructions here.

package/dist/templates/default/template.yml

@@ -0,0 +1,36 @@
+name: default
+description: General programming starter
+skills:
+  - repo: https://github.com/vercel-labs/skills
+    skill: find-skills
+  - repo: https://github.com/obra/superpowers
+    skill: writing-skills
+  - repo: https://github.com/github/awesome-copilot
+    skill: conventional-commit
+  - repo: https://github.com/oldwinter/skills
+    skill: github-cli
+  - repo: https://github.com/supercent-io/skills-template
+    skill: code-review
+  - repo: https://github.com/vercel-labs/agent-skills
+    skill: web-design-guidelines
+  - repo: https://github.com/coreyhaines31/marketingskills
+    skill: copywriting
+plugins:
+  - target: claude
+    id: context7@claude-plugins-official
+  - target: claude
+    id: superpowers@claude-plugins-official
+  - target: claude
+    id: code-simplifier@claude-plugins-official
+  - target: claude
+    id: security-guidance@claude-plugins-official
+  - target: claude
+    id: claude-md-management@claude-plugins-official
+  - target: opencode
+    id: oh-my-opencode
+  - target: opencode
+    id: "@plannotator/opencode"
+  - target: opencode
+    id: "@openspoon/subtask2"
+  - target: opencode
+    id: micode

package/dist/templates/react/instructions.md

@@ -0,0 +1,15 @@
+# Project Instructions
+
+This is a React project. Follow modern React best practices.
+
+## Stack
+
+- React 18+
+- TypeScript
+- Prefer functional components and hooks
+
+## Guidelines
+
+- Use composition over inheritance
+- Keep components small and focused
+- Colocate state as close to where it's used as possible

package/dist/templates/react/template.yml

@@ -0,0 +1,23 @@
+name: react
+description: React / Next.js project starter
+extends: default
+skills:
+  - repo: https://github.com/anthropics/skills
+    skill: frontend-design
+  - repo: https://github.com/vercel-labs/agent-skills
+    skill: vercel-react-best-practices
+  - repo: https://github.com/vercel-labs/agent-skills
+    skill: vercel-composition-patterns
+  - repo: https://github.com/obra/superpowers
+    skill: brainstorming
+  - repo: https://github.com/coreyhaines31/marketingskills
+    skill: seo-audit
+  - repo: https://github.com/vercel-labs/next-skills
+    skill: next-best-practices
+  - repo: https://github.com/wshobson/agents
+    skill: react-state-management
+plugins:
+  - target: claude
+    id: frontend-design@claude-plugins-official
+  - target: claude
+    id: typescript-lsp@claude-plugins-official

package/dist/templates/react-native/instructions.md

@@ -0,0 +1,15 @@
+# Project Instructions
+
+This is a React Native project. Target both iOS and Android.
+
+## Stack
+
+- React Native with Expo
+- TypeScript
+- Prefer functional components and hooks
+
+## Guidelines
+
+- Use `StyleSheet.create` for styles
+- Avoid platform-specific code unless necessary; use `Platform.select` when needed
+- Prefer Expo SDK APIs over bare React Native APIs

package/dist/templates/react-native/template.yml

@@ -0,0 +1,14 @@
+name: react-native
+description: React Native / Expo project starter
+extends: react
+skills:
+  - repo: https://github.com/vercel-labs/agent-skills
+    skill: vercel-react-native-skills
+  - repo: https://github.com/callstackincubator/agent-skills
+    skill: react-native-best-practices
+  - repo: https://github.com/callstackincubator/agent-skills
+    skill: upgrading-react-native
+  - repo: https://github.com/expo/skills
+    skill: upgrading-expo
+  - repo: https://github.com/conorluddy/ios-simulator-skill
+    skill: ios-simulator-skill

package/package.json

@@ -1,22 +1,28 @@
 {
   "name": "@moskala/oneagent-templates",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "type": "module",
   "description": "Built-in templates for oneagent",
   "license": "MIT",
-  "module": "./src/index.ts",
-  "main": "./src/index.ts",
+  "module": "./dist/index.js",
+  "main": "./dist/index.js",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
   },
   "files": [
-    "src"
+    "src",
+    "dist"
   ],
   "scripts": {
+    "build": "bun ./scripts/build.ts",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@moskala/oneagent-core": "0.2.5"
+    "@moskala/oneagent-core": "0.3.1"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/index.ts

@@ -1,7 +1,7 @@
 import path from "path";
 import fs from "fs/promises";
 import { fileURLToPath } from "url";
-import { type TemplatePlugin, type TemplateDefinition, parseTemplateYaml } from "@moskala/oneagent-core";
+import { type TemplatePlugin, type TemplateDefinition, parseTemplateYaml, resolveExtends } from "@moskala/oneagent-core";
 
 export type { TemplatePlugin, TemplateDefinition };
 
@@ -19,7 +19,7 @@ async function loadTemplate(name: BuiltinTemplateName): Promise<TemplateDefiniti
     fs.readFile(path.join(templateDir, "instructions.md"), "utf-8"),
   ]);
 
-  const { description, skills, plugins } = parseTemplateYaml(yamlText, name);
+  const parsed = parseTemplateYaml(yamlText, name);
 
   const rulesDir = path.join(templateDir, "rules");
   let rules: Array<{ name: string; content: string }> = [];
@@ -37,7 +37,8 @@ async function loadTemplate(name: BuiltinTemplateName): Promise<TemplateDefiniti
     // No rules directory — fine
   }
 
-  return { name, description, skills, plugins, instructions, rules };
+  const base = { ...parsed, instructions, rules };
+  return resolveExtends(base, (n) => resolveBuiltinTemplate(n));
 }
 
 export async function resolveBuiltinTemplate(name: string): Promise<TemplateDefinition | null> {

package/src/templates/default/template.yml

@@ -3,8 +3,8 @@ description: General programming starter
 skills:
   - repo: https://github.com/vercel-labs/skills
     skill: find-skills
-  - repo: https://github.com/anthropics/skills
-    skill: skill-creator
+  - repo: https://github.com/obra/superpowers
+    skill: writing-skills
   - repo: https://github.com/github/awesome-copilot
     skill: conventional-commit
   - repo: https://github.com/oldwinter/skills

package/src/templates/react/template.yml

@@ -1,20 +1,7 @@
 name: react
 description: React / Next.js project starter
+extends: default
 skills:
-  - repo: https://github.com/vercel-labs/skills
-    skill: find-skills
-  - repo: https://github.com/anthropics/skills
-    skill: skill-creator
-  - repo: https://github.com/github/awesome-copilot
-    skill: conventional-commit
-  - repo: https://github.com/oldwinter/skills
-    skill: github-cli
-  - repo: https://github.com/supercent-io/skills-template
-    skill: code-review
-  - repo: https://github.com/vercel-labs/agent-skills
-    skill: web-design-guidelines
-  - repo: https://github.com/coreyhaines31/marketingskills
-    skill: copywriting
   - repo: https://github.com/anthropics/skills
     skill: frontend-design
   - repo: https://github.com/vercel-labs/agent-skills
@@ -30,25 +17,7 @@ skills:
   - repo: https://github.com/wshobson/agents
     skill: react-state-management
 plugins:
-  - target: claude
-    id: context7@claude-plugins-official
-  - target: claude
-    id: superpowers@claude-plugins-official
-  - target: claude
-    id: code-simplifier@claude-plugins-official
-  - target: claude
-    id: security-guidance@claude-plugins-official
-  - target: claude
-    id: claude-md-management@claude-plugins-official
   - target: claude
     id: frontend-design@claude-plugins-official
   - target: claude
     id: typescript-lsp@claude-plugins-official
-  - target: opencode
-    id: oh-my-opencode
-  - target: opencode
-    id: "@plannotator/opencode"
-  - target: opencode
-    id: "@openspoon/subtask2"
-  - target: opencode
-    id: micode

package/src/templates/react-native/template.yml

@@ -1,34 +1,7 @@
 name: react-native
 description: React Native / Expo project starter
+extends: react
 skills:
-  - repo: https://github.com/vercel-labs/skills
-    skill: find-skills
-  - repo: https://github.com/anthropics/skills
-    skill: skill-creator
-  - repo: https://github.com/github/awesome-copilot
-    skill: conventional-commit
-  - repo: https://github.com/oldwinter/skills
-    skill: github-cli
-  - repo: https://github.com/supercent-io/skills-template
-    skill: code-review
-  - repo: https://github.com/vercel-labs/agent-skills
-    skill: web-design-guidelines
-  - repo: https://github.com/coreyhaines31/marketingskills
-    skill: copywriting
-  - repo: https://github.com/anthropics/skills
-    skill: frontend-design
-  - repo: https://github.com/vercel-labs/agent-skills
-    skill: vercel-react-best-practices
-  - repo: https://github.com/vercel-labs/agent-skills
-    skill: vercel-composition-patterns
-  - repo: https://github.com/obra/superpowers
-    skill: brainstorming
-  - repo: https://github.com/coreyhaines31/marketingskills
-    skill: seo-audit
-  - repo: https://github.com/vercel-labs/next-skills
-    skill: next-best-practices
-  - repo: https://github.com/wshobson/agents
-    skill: react-state-management
   - repo: https://github.com/vercel-labs/agent-skills
     skill: vercel-react-native-skills
   - repo: https://github.com/callstackincubator/agent-skills
@@ -39,26 +12,3 @@ skills:
     skill: upgrading-expo
   - repo: https://github.com/conorluddy/ios-simulator-skill
     skill: ios-simulator-skill
-plugins:
-  - target: claude
-    id: context7@claude-plugins-official
-  - target: claude
-    id: superpowers@claude-plugins-official
-  - target: claude
-    id: code-simplifier@claude-plugins-official
-  - target: claude
-    id: security-guidance@claude-plugins-official
-  - target: claude
-    id: claude-md-management@claude-plugins-official
-  - target: claude
-    id: frontend-design@claude-plugins-official
-  - target: claude
-    id: typescript-lsp@claude-plugins-official
-  - target: opencode
-    id: oh-my-opencode
-  - target: opencode
-    id: "@plannotator/opencode"
-  - target: opencode
-    id: "@openspoon/subtask2"
-  - target: opencode
-    id: micode