rahman-resources 0.2.1 → 0.4.1

package/lib/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 2,
-  "generatedAt": "2026-05-05T11:50:32.844Z",
+  "generatedAt": "2026-05-06T09:30:28.726Z",
   "repo": "rahmanef63/resource-site",
   "branch": "main",
   "layouts": [
@@ -13,6 +13,7 @@
       "repoPath": "app/preview/personal-brand-os",
       "pullPaths": [
         "app/preview/personal-brand-os",
+        "components/templates/_shared",
         "components/templates/personal-brand",
         "convex/templates/personal-brand-os"
       ],
@@ -48,14 +49,24 @@
         "app/preview/personal-brand-os/admin/settings/site/page.tsx",
         "app/preview/personal-brand-os/admin/settings/team/page.tsx",
         "app/preview/personal-brand-os/admin/settings/ai/page.tsx",
+        "components/templates/_shared/index.ts",
+        "components/templates/_shared/types/common.ts",
+        "components/templates/_shared/utils/index.ts",
+        "components/templates/_shared/hooks/create-template-store.tsx",
+        "components/templates/_shared/ui/section-head.tsx",
+        "components/templates/_shared/ui/site-nav.tsx",
+        "components/templates/_shared/ui/site-footer.tsx",
+        "components/templates/_shared/ui/site-shell.tsx",
+        "components/templates/_shared/ui/admin-sidebar.tsx",
+        "components/templates/_shared/ui/admin-topbar.tsx",
+        "components/templates/_shared/ui/admin-shell.tsx",
+        "components/templates/_shared/ui/stat-card.tsx",
         "components/templates/personal-brand/shared/types.ts",
         "components/templates/personal-brand/shared/store.tsx",
         "components/templates/personal-brand/shared/seed.ts",
         "components/templates/personal-brand/shared/site-config.ts",
-        "components/templates/personal-brand/shared/ui/site-nav.tsx",
-        "components/templates/personal-brand/shared/ui/site-footer.tsx",
+        "components/templates/personal-brand/shared/nav-config.ts",
         "components/templates/personal-brand/shared/ui/chat-fab.tsx",
-        "components/templates/personal-brand/shared/ui/section-head.tsx",
         "components/templates/personal-brand/slices/home/HomePage.tsx",
         "components/templates/personal-brand/slices/home/NewsletterBlock.tsx",
         "components/templates/personal-brand/slices/blog/BlogList.tsx",
@@ -66,8 +77,7 @@
         "components/templates/personal-brand/slices/resources/ResourcesPage.tsx",
         "components/templates/personal-brand/slices/about/AboutPage.tsx",
         "components/templates/personal-brand/slices/contact/ContactPage.tsx",
-        "components/templates/personal-brand/slices/admin/shell/admin-sidebar.tsx",
-        "components/templates/personal-brand/slices/admin/shell/admin-topbar.tsx",
+        "app/preview/personal-brand-os/admin/admin-shell-client.tsx",
         "components/templates/personal-brand/slices/admin/dashboard/DashboardView.tsx",
         "components/templates/personal-brand/slices/admin/posts/PostsList.tsx",
         "components/templates/personal-brand/slices/admin/posts/PostEditor.tsx",
@@ -124,6 +134,94 @@
       ],
       "primaryFile": "app/preview/personal-brand-os/public/page.tsx"
     },
+    {
+      "slug": "agency-studio-os",
+      "title": "Agency Studio OS",
+      "category": "website-template",
+      "description": "Full-app B2B agency / studio site — public (home, services, work + project detail, about, contact) + admin (dashboard, projects pipeline, clients, services, leads, settings). Inspired by saudivisuals.com + cescadesigns.",
+      "source": "saudivisuals.com + cescadesigns",
+      "repoPath": "app/preview/agency-studio-os",
+      "pullPaths": [
+        "app/preview/agency-studio-os",
+        "components/templates/_shared",
+        "components/templates/agency-studio",
+        "convex/templates/agency-studio-os"
+      ],
+      "files": [
+        "app/preview/agency-studio-os/robots.ts",
+        "app/preview/agency-studio-os/sitemap.ts",
+        "app/preview/agency-studio-os/opengraph-image.tsx",
+        "app/preview/agency-studio-os/public/layout.tsx",
+        "app/preview/agency-studio-os/public/page.tsx",
+        "app/preview/agency-studio-os/public/services/page.tsx",
+        "app/preview/agency-studio-os/public/portfolio/page.tsx",
+        "app/preview/agency-studio-os/public/portfolio/[slug]/page.tsx",
+        "app/preview/agency-studio-os/public/about/page.tsx",
+        "app/preview/agency-studio-os/public/contact/page.tsx",
+        "app/preview/agency-studio-os/admin/layout.tsx",
+        "app/preview/agency-studio-os/admin/page.tsx",
+        "app/preview/agency-studio-os/admin/projects/page.tsx",
+        "app/preview/agency-studio-os/admin/projects/new/page.tsx",
+        "app/preview/agency-studio-os/admin/projects/[id]/page.tsx",
+        "app/preview/agency-studio-os/admin/clients/page.tsx",
+        "app/preview/agency-studio-os/admin/services/page.tsx",
+        "app/preview/agency-studio-os/admin/leads/page.tsx",
+        "app/preview/agency-studio-os/admin/settings/page.tsx",
+        "components/templates/agency-studio/shared/types.ts",
+        "components/templates/agency-studio/shared/store.tsx",
+        "components/templates/agency-studio/shared/seed.ts",
+        "components/templates/agency-studio/shared/site-config.ts",
+        "components/templates/agency-studio/shared/nav-config.ts",
+        "components/templates/agency-studio/slices/home/HomePage.tsx",
+        "components/templates/agency-studio/slices/services/ServicesPage.tsx",
+        "components/templates/agency-studio/slices/portfolio/PortfolioListPage.tsx",
+        "components/templates/agency-studio/slices/portfolio/PortfolioDetailPage.tsx",
+        "components/templates/agency-studio/slices/about/AboutPage.tsx",
+        "components/templates/agency-studio/slices/contact/ContactPage.tsx",
+        "app/preview/agency-studio-os/admin/admin-shell-client.tsx",
+        "components/templates/agency-studio/slices/admin/dashboard/DashboardView.tsx",
+        "components/templates/agency-studio/slices/admin/projects/ProjectsList.tsx",
+        "components/templates/agency-studio/slices/admin/projects/ProjectEditor.tsx",
+        "components/templates/agency-studio/slices/admin/clients/ClientsList.tsx",
+        "components/templates/agency-studio/slices/admin/services/ServicesAdminView.tsx",
+        "components/templates/agency-studio/slices/admin/leads/LeadsView.tsx",
+        "components/templates/agency-studio/slices/admin/settings/SettingsView.tsx",
+        "convex/templates/agency-studio-os/schema.ts",
+        "convex/templates/agency-studio-os/projects.ts",
+        "convex/templates/agency-studio-os/clients.ts",
+        "convex/templates/agency-studio-os/services.ts",
+        "convex/templates/agency-studio-os/leads.ts",
+        "convex/templates/agency-studio-os/README.md"
+      ],
+      "dependencies": [
+        "next@^16",
+        "react@^19",
+        "react-dom@^19",
+        "lucide-react",
+        "@tabler/icons-react",
+        "sonner",
+        "next-themes",
+        "tailwindcss@^4",
+        "convex",
+        "@convex-dev/auth",
+        "@radix-ui/react-avatar",
+        "@radix-ui/react-dialog",
+        "@radix-ui/react-label",
+        "@radix-ui/react-separator",
+        "@radix-ui/react-slot"
+      ],
+      "agentRecipe": "Agency Studio OS = full-app B2B agency template (public + admin). 1) Move app/preview/agency-studio-os/{robots,sitemap,opengraph-image}.* to app root. 2) Copy public into app/(public)/, admin into app/(admin)/. 3) Edit components/templates/agency-studio/shared/site-config.ts — set studioName, brandName, baseUrl, twitter, email. 4) Wire convex/templates/agency-studio-os/* to convex/_generated and add @convex-dev/auth on admin routes. 5) Replace localStorage StoreProvider with Convex queries.",
+      "tags": [
+        "template",
+        "agency",
+        "studio",
+        "portfolio",
+        "b2b",
+        "admin",
+        "saas"
+      ],
+      "primaryFile": "app/preview/agency-studio-os/public/page.tsx"
+    },
     {
       "slug": "landing-hero-carousel",
       "title": "Landing — Hero Carousel",
@@ -286,6 +384,147 @@
         "storefront"
       ],
       "primaryFile": "README.md"
+    },
+    {
+      "slug": "saas-marketing-os",
+      "title": "SaaS Marketing OS",
+      "category": "website-template",
+      "status": "stable",
+      "description": "Public-only marketing site for a SaaS product — landing, pricing, features, blog, changelog, about, contact. MDX-driven blog + changelog. No admin (CMS via MDX files in repo).",
+      "source": "synthesized + mdx-blog feature",
+      "repoPath": "app/preview/saas-marketing-os",
+      "pullPaths": [
+        "app/preview/saas-marketing-os",
+        "components/templates/_shared",
+        "components/templates/saas-marketing"
+      ],
+      "files": [
+        "app/preview/saas-marketing-os/public/layout.tsx",
+        "app/preview/saas-marketing-os/public/page.tsx",
+        "app/preview/saas-marketing-os/public/pricing/page.tsx",
+        "app/preview/saas-marketing-os/public/features/page.tsx",
+        "app/preview/saas-marketing-os/public/blog/page.tsx",
+        "app/preview/saas-marketing-os/public/blog/[slug]/page.tsx",
+        "app/preview/saas-marketing-os/public/changelog/page.tsx",
+        "app/preview/saas-marketing-os/public/about/page.tsx",
+        "app/preview/saas-marketing-os/public/contact/page.tsx",
+        "components/templates/saas-marketing/shared/site-config.ts",
+        "components/templates/saas-marketing/shared/nav-config.ts",
+        "components/templates/saas-marketing/shared/types.ts",
+        "components/templates/saas-marketing/shared/store.tsx",
+        "components/templates/saas-marketing/shared/seed.ts",
+        "components/templates/saas-marketing/slices/home/HomePage.tsx",
+        "components/templates/saas-marketing/slices/pricing/PricingPage.tsx",
+        "components/templates/saas-marketing/slices/features/FeaturesPage.tsx",
+        "components/templates/saas-marketing/slices/blog/BlogList.tsx",
+        "components/templates/saas-marketing/slices/blog/BlogDetail.tsx",
+        "components/templates/saas-marketing/slices/changelog/ChangelogPage.tsx",
+        "components/templates/saas-marketing/slices/about/AboutPage.tsx",
+        "components/templates/saas-marketing/slices/contact/ContactPage.tsx"
+      ],
+      "dependencies": [
+        "next@^16",
+        "react@^19",
+        "react-dom@^19",
+        "lucide-react",
+        "sonner",
+        "next-themes",
+        "tailwindcss@^4",
+        "@radix-ui/react-slot"
+      ],
+      "agentRecipe": "SaaS Marketing OS = public-only marketing template. Blog + changelog use MDX (add the mdx-blog feature). Edit components/templates/saas-marketing/shared/site-config.ts to set product name, tagline, pricing tiers, contact email.",
+      "tags": [
+        "template",
+        "saas",
+        "marketing",
+        "mdx",
+        "blog",
+        "changelog"
+      ],
+      "primaryFile": "app/preview/saas-marketing-os/public/page.tsx"
+    },
+    {
+      "slug": "kreator-studio-os",
+      "title": "Kreator Studio OS",
+      "category": "website-template",
+      "status": "coming-soon",
+      "description": "Creator/influencer studio — newsletter-first public site + admin for posts, drops, audience segments. Resend + Midtrans tip jar. Coming soon.",
+      "source": "synthesized",
+      "repoPath": "app/preview/kreator-studio-os",
+      "pullPaths": [],
+      "files": [],
+      "dependencies": [],
+      "agentRecipe": "Coming soon — track at /build for updates.",
+      "tags": [
+        "template",
+        "creator",
+        "newsletter",
+        "coming-soon"
+      ],
+      "primaryFile": "README.md"
+    },
+    {
+      "slug": "konsultan-os",
+      "title": "Konsultan OS",
+      "category": "website-template",
+      "status": "coming-soon",
+      "description": "Consultancy site — services catalog, case studies, booking via Cal.com, Midtrans deposits. Public + lightweight admin. Coming soon.",
+      "source": "synthesized",
+      "repoPath": "app/preview/konsultan-os",
+      "pullPaths": [],
+      "files": [],
+      "dependencies": [],
+      "agentRecipe": "Coming soon — track at /build for updates.",
+      "tags": [
+        "template",
+        "consultant",
+        "booking",
+        "coming-soon"
+      ],
+      "primaryFile": "README.md"
+    },
+    {
+      "slug": "wirausaha-os",
+      "title": "Wirausaha OS",
+      "category": "website-template",
+      "status": "coming-soon",
+      "description": "Indonesian SMB toolkit — public storefront + admin (catalog, orders, Midtrans + QRIS, leads). Bahasa Indonesia first. Coming soon.",
+      "source": "synthesized",
+      "repoPath": "app/preview/wirausaha-os",
+      "pullPaths": [],
+      "files": [],
+      "dependencies": [],
+      "agentRecipe": "Coming soon — track at /build for updates.",
+      "tags": [
+        "template",
+        "smb",
+        "ecommerce",
+        "midtrans",
+        "indonesia",
+        "coming-soon"
+      ],
+      "primaryFile": "README.md"
+    },
+    {
+      "slug": "riset-kit",
+      "title": "Riset Kit",
+      "category": "website-template",
+      "status": "coming-soon",
+      "description": "Research / knowledge-base template — Convex vector search + MDX + threaded comments. Public reading + admin authoring. Coming soon.",
+      "source": "synthesized",
+      "repoPath": "app/preview/riset-kit",
+      "pullPaths": [],
+      "files": [],
+      "dependencies": [],
+      "agentRecipe": "Coming soon — track at /build for updates.",
+      "tags": [
+        "template",
+        "research",
+        "knowledge-base",
+        "vector-search",
+        "coming-soon"
+      ],
+      "primaryFile": "README.md"
     }
   ],
   "recipes": [

package/lib/post-init.mjs

@@ -0,0 +1,102 @@
+// Post-init restructure — runs after `rahman-resources init` finishes copying
+// the bundled starter into the target dir. Steps:
+//
+//   1. Patch components.json with vertical-slice aliases (shared, templates,
+//      slices, features) so future shadcn add commands respect our layout.
+//   2. Write rr.json (project manifest).
+//   3. Patch tsconfig.json paths to mirror the rr.json aliases.
+//
+// Idempotent — safe to re-run. Each step compares before mutating.
+
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+
+import { DEFAULT_RR, writeRr, buildRr } from "./rr.mjs";
+
+const RR_ALIASES_TO_TSCONFIG = {
+  // alias -> tsconfig key target relative-path
+  "@/components/templates/_shared": "components/templates/_shared",
+  "@/components/templates": "components/templates",
+  "@/features": "features",
+};
+
+export function runPostInit(targetDir, opts = {}) {
+  const out = { changed: [], skipped: [] };
+
+  patchComponentsJson(targetDir, out);
+  writeRrJson(targetDir, opts, out);
+  patchTsconfig(targetDir, out);
+
+  return out;
+}
+
+function patchComponentsJson(targetDir, out) {
+  const p = path.join(targetDir, "components.json");
+  if (!existsSync(p)) {
+    out.skipped.push("components.json (not found — run shadcn init first)");
+    return;
+  }
+  const cj = JSON.parse(readFileSync(p, "utf8"));
+  cj.aliases = cj.aliases ?? {};
+  const before = JSON.stringify(cj.aliases);
+  cj.aliases.shared = cj.aliases.shared ?? "@/components/templates/_shared";
+  cj.aliases.templates = cj.aliases.templates ?? "@/components/templates";
+  cj.aliases.slices = cj.aliases.slices ?? "@/components/templates/{template}/slices";
+  cj.aliases.features = cj.aliases.features ?? "@/features";
+  if (JSON.stringify(cj.aliases) !== before) {
+    writeFileSync(p, JSON.stringify(cj, null, 2) + "\n");
+    out.changed.push("components.json (aliases)");
+  } else {
+    out.skipped.push("components.json (already patched)");
+  }
+}
+
+function writeRrJson(targetDir, opts, out) {
+  const p = path.join(targetDir, "rr.json");
+  if (existsSync(p)) {
+    out.skipped.push("rr.json (already exists)");
+    return;
+  }
+  const rr = buildRr({
+    template: opts.template,
+    features: opts.features,
+    skills: opts.skills,
+    templateVersion: opts.templateVersion,
+  });
+  writeRr(rr, targetDir);
+  out.changed.push("rr.json (created)");
+}
+
+function patchTsconfig(targetDir, out) {
+  const p = path.join(targetDir, "tsconfig.json");
+  if (!existsSync(p)) {
+    out.skipped.push("tsconfig.json (not found)");
+    return;
+  }
+  let raw = readFileSync(p, "utf8");
+  let cfg;
+  try { cfg = JSON.parse(raw); } catch {
+    out.skipped.push("tsconfig.json (parse failed — likely has comments; skipped)");
+    return;
+  }
+  cfg.compilerOptions = cfg.compilerOptions ?? {};
+  cfg.compilerOptions.paths = cfg.compilerOptions.paths ?? {};
+  const paths = cfg.compilerOptions.paths;
+  const before = JSON.stringify(paths);
+  paths["@/*"] = paths["@/*"] ?? ["./*"];
+  // Keep tsconfig minimal — @/* covers all aliases. Don't bloat with redundant entries.
+  if (JSON.stringify(paths) !== before) {
+    writeFileSync(p, JSON.stringify(cfg, null, 2) + "\n");
+    out.changed.push("tsconfig.json (paths)");
+  } else {
+    out.skipped.push("tsconfig.json (already configured)");
+  }
+}
+
+// Allow running as a CLI script for re-restructure on existing projects.
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const target = process.argv[2] ?? process.cwd();
+  const result = runPostInit(target);
+  for (const c of result.changed) console.log("  +", c);
+  for (const s of result.skipped) console.log("  -", s);
+}

package/lib/rr-schema.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://rahmanef63.github.io/resource-site/rr.schema.json",
+  "title": "rr.json — Rahman Resources project manifest",
+  "description": "Project-local manifest written by `rahman-resources init` and patched by `add` / `add-skill` / `upgrade`. Mirrors what shadcn's components.json does for shadcn, but for the vertical-slice kitab flow (templates + features + Claude skills).",
+  "type": "object",
+  "required": ["version", "framework", "aliases", "layout"],
+  "additionalProperties": true,
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": { "type": "integer", "minimum": 1 },
+    "framework": { "type": "string", "enum": ["next-16", "next-15", "vite", "remix"] },
+    "style": { "type": "string", "default": "shadcn-new-york" },
+    "rsc": { "type": "boolean", "default": true },
+    "tailwind": {
+      "type": "object",
+      "properties": {
+        "config": { "type": "string" },
+        "css": { "type": "string" }
+      }
+    },
+    "aliases": {
+      "type": "object",
+      "required": ["components", "ui", "shared", "templates", "lib"],
+      "properties": {
+        "components": { "type": "string" },
+        "ui": { "type": "string" },
+        "shared": { "type": "string", "description": "Cross-template _shared scaffolding (site-shell, admin-shell, store factory)." },
+        "templates": { "type": "string", "description": "Per-template folders root (e.g. components/templates)." },
+        "slices": { "type": "string", "description": "Optional slice-root pattern, may use {template} placeholder." },
+        "features": { "type": "string" },
+        "convex": { "type": "string" },
+        "lib": { "type": "string" },
+        "hooks": { "type": "string" }
+      }
+    },
+    "layout": {
+      "type": "object",
+      "required": ["kind"],
+      "properties": {
+        "kind": { "type": "string", "enum": ["vertical-slice", "feature-folders"] },
+        "publicRoute": { "type": "string" },
+        "adminRoute": { "type": "string" },
+        "sliceRoot": { "type": "string" }
+      }
+    },
+    "template": {
+      "type": "object",
+      "required": ["slug", "version"],
+      "properties": {
+        "slug": { "type": "string" },
+        "version": { "type": "string" }
+      }
+    },
+    "features": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug"],
+        "properties": {
+          "slug": { "type": "string" },
+          "version": { "type": "string" },
+          "addedAt": { "type": "string", "format": "date" }
+        }
+      }
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug", "source"],
+        "properties": {
+          "slug": { "type": "string" },
+          "source": { "type": "string", "enum": ["anthropics", "rahman", "custom"] },
+          "version": { "type": "string", "default": "main" },
+          "addedAt": { "type": "string", "format": "date" }
+        }
+      }
+    },
+    "auth": {
+      "type": "object",
+      "properties": {
+        "provider": { "type": "string", "enum": ["convex-auth", "clerk", "next-auth", "none"] }
+      }
+    },
+    "convex": {
+      "type": "object",
+      "properties": {
+        "self_hosted": { "type": "boolean" },
+        "deploymentUrl": { "type": "string" }
+      }
+    }
+  }
+}

package/lib/rr.mjs

@@ -0,0 +1,134 @@
+// Read / write / validate rr.json — the project-local Rahman Resources manifest.
+//
+// Schema lives at lib/rr-schema.json (JSON Schema draft-07). Validation is
+// hand-rolled (shape-only) to avoid pulling in ajv as a runtime dep — the CLI
+// stays small. Full schema validation is available via `npx ajv` if desired.
+
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+
+const RR_FILENAME = "rr.json";
+const SCHEMA_URL = "https://rahmanef63.github.io/resource-site/rr.schema.json";
+
+export const DEFAULT_RR = {
+  $schema: SCHEMA_URL,
+  version: 1,
+  framework: "next-16",
+  style: "shadcn-new-york",
+  rsc: true,
+  tailwind: { config: "tailwind.config.ts", css: "app/globals.css" },
+  aliases: {
+    components: "@/components",
+    ui: "@/components/ui",
+    shared: "@/components/templates/_shared",
+    templates: "@/components/templates",
+    slices: "@/components/templates/{template}/slices",
+    features: "@/features",
+    convex: "@/convex",
+    lib: "@/lib",
+    hooks: "@/hooks",
+  },
+  layout: {
+    kind: "vertical-slice",
+    publicRoute: "app/(public)",
+    adminRoute: "app/(admin)",
+    sliceRoot: "components/templates",
+  },
+  template: null,
+  features: [],
+  skills: [],
+  auth: { provider: "convex-auth" },
+  convex: { self_hosted: true },
+};
+
+export function rrPath(targetDir = process.cwd()) {
+  return path.join(targetDir, RR_FILENAME);
+}
+
+export function rrExists(targetDir = process.cwd()) {
+  return existsSync(rrPath(targetDir));
+}
+
+export function readRr(targetDir = process.cwd()) {
+  const p = rrPath(targetDir);
+  if (!existsSync(p)) throw new Error(`No rr.json at ${p}. Run 'rahman-resources init' first.`);
+  try {
+    return JSON.parse(readFileSync(p, "utf8"));
+  } catch (err) {
+    throw new Error(`Failed to parse ${p}: ${err.message}`);
+  }
+}
+
+export function writeRr(rr, targetDir = process.cwd()) {
+  const p = rrPath(targetDir);
+  writeFileSync(p, JSON.stringify(rr, null, 2) + "\n");
+  return p;
+}
+
+export function buildRr(opts = {}) {
+  const rr = JSON.parse(JSON.stringify(DEFAULT_RR));
+  if (opts.template) {
+    rr.template = { slug: opts.template, version: opts.templateVersion ?? "main" };
+  }
+  if (opts.features?.length) {
+    const stamp = today();
+    rr.features = opts.features.map((slug) => ({ slug, version: opts.templateVersion ?? "main", addedAt: stamp }));
+  }
+  if (opts.skills?.length) {
+    const stamp = today();
+    rr.skills = opts.skills.map((s) => {
+      if (typeof s === "string") return { slug: s, source: "anthropics", version: "main", addedAt: stamp };
+      return { source: "anthropics", version: "main", addedAt: stamp, ...s };
+    });
+  }
+  return rr;
+}
+
+export function addFeature(rr, slug, version = "main") {
+  rr.features = rr.features ?? [];
+  if (rr.features.find((f) => f.slug === slug)) return rr;
+  rr.features.push({ slug, version, addedAt: today() });
+  return rr;
+}
+
+export function addSkill(rr, slug, source = "anthropics", version = "main") {
+  rr.skills = rr.skills ?? [];
+  if (rr.skills.find((s) => s.slug === slug && s.source === source)) return rr;
+  rr.skills.push({ slug, source, version, addedAt: today() });
+  return rr;
+}
+
+export function removeFeature(rr, slug) {
+  rr.features = (rr.features ?? []).filter((f) => f.slug !== slug);
+  return rr;
+}
+
+export function removeSkill(rr, slug) {
+  rr.skills = (rr.skills ?? []).filter((s) => s.slug !== slug);
+  return rr;
+}
+
+// Shape-only validation — returns string[] of issues (empty = ok).
+export function validateRr(rr) {
+  const issues = [];
+  if (!rr || typeof rr !== "object") return ["rr.json is not an object"];
+  if (typeof rr.version !== "number") issues.push("version must be a number");
+  if (!rr.framework) issues.push("framework is required");
+  if (!rr.aliases || typeof rr.aliases !== "object") issues.push("aliases is required");
+  else {
+    for (const k of ["components", "ui", "shared", "templates", "lib"]) {
+      if (typeof rr.aliases[k] !== "string") issues.push(`aliases.${k} must be a string`);
+    }
+  }
+  if (!rr.layout || typeof rr.layout !== "object") issues.push("layout is required");
+  else if (!["vertical-slice", "feature-folders"].includes(rr.layout.kind)) {
+    issues.push(`layout.kind must be vertical-slice|feature-folders (got ${rr.layout.kind})`);
+  }
+  if (rr.features && !Array.isArray(rr.features)) issues.push("features must be an array");
+  if (rr.skills && !Array.isArray(rr.skills)) issues.push("skills must be an array");
+  return issues;
+}
+
+function today() {
+  return new Date().toISOString().slice(0, 10);
+}