@p_tipso/agentive 1.0.0 → 1.0.2

package/src/templates/mobile/expo/rules/expo-router.md

@@ -0,0 +1,16 @@
+# Rule: Expo Router
+
+1. **File-Based Routing Architecture**:
+   - You MUST use Expo Router (`expo-router`) exclusively. Do NOT install or use `@react-navigation/native` directly.
+   - All screens must be placed inside the `app/` directory (or `src/app/` if a `src` folder is used).
+
+2. **Layouts and Navigation**:
+   - Use `_layout.tsx` files to define shared UI (like Stack or Tabs) across multiple screens in a directory.
+   - NEVER use `<NavigationContainer>`. Expo Router handles this automatically.
+
+3. **Links and Dynamic Routes**:
+   - ALWAYS use the `<Link>` component from `expo-router` for navigation between screens, or the `useRouter()` hook for programmatic navigation.
+   - Dynamic routes use square brackets (e.g., `app/user/[id].tsx`). Retrieve parameters using the `useLocalSearchParams()` hook from `expo-router`.
+
+4. **Not-Found Screens**:
+   - Use `+not-found.tsx` to handle 404 routes.

package/src/templates/mobile/expo/skills/create-expo-app.md

@@ -0,0 +1,19 @@
+# Skill: Create Expo App
+
+## Context
+When a user asks to start a new Expo project from scratch, follow these modern initialization standards based on the latest Expo documentation.
+
+## Execution Steps
+1. **Initialize Command**: 
+   - Propose running `npx create-expo-app@latest` in the terminal. This uses the default template which includes Expo Router and modern defaults.
+   - If a specific template is requested, use `npx create-expo-app@latest --template <template-name>`.
+
+2. **Start the Development Server**:
+   - Propose running `npx expo start` to start the Metro bundler.
+   - Explain to the user that they can press `i` to open the iOS simulator, or `a` to open the Android emulator.
+
+3. **Resetting Cache**:
+   - If the user reports weird bundling errors or missing modules, propose running `npx expo start --clear` (or `-c`) to clear the Metro cache.
+
+4. **Dependencies**:
+   - ALWAYS use `npx expo install <package>` instead of `npm install` or `yarn add` when installing native packages. This ensures the version installed is compatible with the current Expo SDK.

package/src/templates/mobile/expo/skills/expo-upgrader.md

@@ -0,0 +1,10 @@
+# Skill: Expo SDK Migration Expert
+
+## Operational Objective
+Safely upgrade the local codebase's native wrappers and library versions to the targeted modern Expo SDK layout without generating cascade system failures.
+
+## Step-by-Step Execution Protocol
+1. **Context Extraction:** Check `package.json` and `.agents/settings.json` to confirm current project dependencies and target thresholds.
+2. **Reference Audit:** Compare existing components against any files found in `.agents/reference/`. Identify breaking changes, deprecated hooks, and required config plugins before making code mutations.
+3. **Strict Live Verification:** Do not guess method arguments. If internet permissions are active, query `site:docs.expo.dev/versions/` appending the target SDK code to verify exact API shifts.
+4. **Isolated Incremental Assembly:** Modify files sequentially. Complete dependency resolution inside configuration files first, verify type parameters, and fix breaking interface adjustments step-by-step.

package/src/templates/mobile/react-native/rules/01-native-primitives.md

@@ -0,0 +1,18 @@
+# Rule: React Native Primitives
+
+1. **NO HTML Elements**:
+   - NEVER use HTML DOM elements like `<div>`, `<span>`, `<button>`, `<p>`, `<a>`, `<ul>`, `<li>`, or `<input>`.
+   - React Native does not use the browser DOM. Using web elements will crash the app instantly.
+
+2. **Core Components**:
+   - ALWAYS use React Native core components imported from `react-native`.
+   - Use `<View>` instead of `<div>`.
+   - Use `<Text>` instead of `<span>` or `<p>`. All strings MUST be wrapped in a `<Text>` component.
+   - Use `<Pressable>` or `<TouchableOpacity>` instead of `<button>`.
+   - Use `<TextInput>` instead of `<input>`.
+   - Use `<Image>` instead of `<img>` (and note that local images require `source={require('./path')}`, while remote require `source={{ uri: '...' }}`).
+   - Use `<ScrollView>` or `<FlatList>` for scrollable areas.
+
+3. **Event Handlers**:
+   - Do NOT use `onClick`. The correct prop for `<Pressable>` is `onPress`.
+   - Do NOT use `onChange` for text inputs. The correct prop for `<TextInput>` is `onChangeText`.

package/src/templates/mobile/react-native/rules/02-native-styling.md

@@ -0,0 +1,29 @@
+# Rule: Native Styling
+
+1. **No Web CSS Attributes**:
+   - Do NOT use web-specific CSS properties like `grid`, `float`, `display: block`, etc.
+   - Do NOT use string styles for dimensions like `width: "100px"`.
+
+2. **Unitless Pixels**:
+   - Layout dimensions and font sizes must use unitless values (e.g., `width: 100`, `fontSize: 16`). These represent logical pixels.
+   - Percentages are allowed as strings (e.g., `width: "100%"`).
+
+3. **Flexbox Architecture**:
+   - In React Native, `flexDirection` defaults to `"column"`. If you want items side-by-side, you MUST explicitly set `flexDirection: "row"`.
+   - `display: "flex"` is the default and only display type for Views.
+   - Use `justifyContent` and `alignItems` heavily for positioning.
+
+4. **StyleSheet**:
+   - ALWAYS use `StyleSheet.create` for defining component styles to ensure performance and avoid inline object recreation on every render.
+   - Example:
+     ```javascript
+     const styles = StyleSheet.create({
+       container: {
+         flex: 1,
+         justifyContent: 'center',
+         alignItems: 'center',
+         backgroundColor: '#fff',
+       }
+     });
+     ```
+   - Only use inline styles for values that change dynamically during render.

package/src/templates/mobile/react-native/rules/03-ios-android-builds.md

@@ -0,0 +1,14 @@
+# Rule: Native iOS & Android Builds
+
+In a bare React Native project, you must manage native dependencies meticulously.
+
+1. **iOS Dependencies (`pod install`)**:
+   - ANY time you install a new NPM package that includes native code (e.g., `react-native-device-info`, `react-native-reanimated`), you MUST remind the user to run `cd ios && pod install` (or `npx pod-install`).
+   - If an iOS build fails with a "module not found" error for a native module, the most likely solution is to run `pod install`.
+
+2. **Android Gradle Sync**:
+   - If a new native module is added, the Android project must be rebuilt.
+   - If weird caching issues occur in Android, propose running `cd android && ./gradlew clean`.
+
+3. **Avoid Manual Native Edits Unless Requested**:
+   - Do not manually edit `ios/Podfile`, `android/app/build.gradle`, `MainApplication.java`, or `AppDelegate.mm` unless the library's official documentation explicitly requires manual linking (which is rare in modern React Native due to autolinking).

package/src/templates/mobile/react-native/skills/native-linking.md

@@ -0,0 +1,27 @@
+# Skill: Native Module Linking & Troubleshooting
+
+## Context
+Use this skill when a user encounters build errors, native module crashes, or needs help installing a library with deep native hooks in a bare React Native app.
+
+## Execution Steps
+
+1. **Verify Autolinking**:
+   - React Native uses Autolinking by default for iOS and Android. 
+   - Check the `package.json` to ensure the library is installed.
+   - For iOS: Propose running `cd ios && pod install`. If the user is on an Apple Silicon Mac and encounters FFI errors, propose `arch -x86_64 pod install`.
+   - For Android: Propose running `cd android && ./gradlew clean`.
+
+2. **Manual Linking (Only if Autolinking Fails)**:
+   - Only propose manual changes to `settings.gradle` and `MainApplication.java` (Android) or `Podfile` (iOS) if the specific library documentation states that it does not support autolinking.
+
+3. **Clearing Caches**:
+   - The React Native packager (Metro) often caches aggressively. If JS changes aren't reflecting or weird module resolution errors occur, propose:
+     `npx react-native start --reset-cache`
+   - For a deeper clean, propose clearing Watchman watches:
+     `watchman watch-del-all`
+     `rm -rf node_modules && npm install`
+     `rm -rf $TMPDIR/metro-*`
+
+4. **Rebuilding**:
+   - Remind the user that after installing a native module, they CANNOT simply rely on fast refresh. They MUST recompile the app:
+     `npx react-native run-ios` OR `npx react-native run-android`

package/src/utils/compilers.js

@@ -7,6 +7,7 @@ const path = require('path');
 
 /**
  * Read all .md files from a directory and return their concatenated content.
+ * Skips README.md files since those are directory documentation, not agent rules.
  * @param {string} dir
  * @returns {Promise<string>}
  */
@@ -15,7 +16,7 @@ async function readMarkdownDir(dir) {
   try {
     const entries = await fs.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
-      if (entry.isFile() && entry.name.endsWith('.md')) {
+      if (entry.isFile() && entry.name.endsWith('.md') && entry.name !== 'README.md') {
         const filePath = path.join(dir, entry.name);
         const fileContent = await fs.readFile(filePath, 'utf-8');
         const section = entry.name.replace('.md', '').replace(/-/g, ' ');
@@ -57,12 +58,12 @@ async function copyDir(src, dest) {
 // ─── Cursor ──────────────────────────────────────────────────────────────────
 
 /**
- * Sync .agent/rules/ → .cursor/rules/
- * @param {string} agentDir
+ * Sync .agents/rules/ → .cursor/rules/
+ * @param {string} agentsDir
  * @param {string} cwd
  */
-async function syncToCursor(agentDir, cwd) {
-  const src  = path.join(agentDir, 'rules');
+async function syncToCursor(agentsDir, cwd) {
+  const src  = path.join(agentsDir, 'rules');
   const dest = path.join(cwd, '.cursor', 'rules');
   await copyDir(src, dest);
 }
@@ -70,19 +71,19 @@ async function syncToCursor(agentDir, cwd) {
 // ─── Claude ──────────────────────────────────────────────────────────────────
 
 /**
- * Compile .agent/ into a single CLAUDE.md file.
- * @param {string} agentDir
+ * Compile .agents/ into a single CLAUDE.md file.
+ * @param {string} agentsDir
  * @param {string} cwd
  * @param {string} techStack
  */
-async function syncToClaude(agentDir, cwd, techStack) {
-  const rulesContent  = await readMarkdownDir(path.join(agentDir, 'rules'));
-  const skillsContent = await readMarkdownDir(path.join(agentDir, 'skills'));
+async function syncToClaude(agentsDir, cwd, techStack) {
+  const rulesContent    = await readMarkdownDir(path.join(agentsDir, 'rules'));
+  const commandsContent = await readMarkdownDir(path.join(agentsDir, 'commands'));
 
   const claudeMd = `# CLAUDE.md — AI Agent Instructions
 
 > This file was auto-generated by [agentive](https://github.com/TiPS0/agentive).
-> Edit the source files in \`.agent/\` and re-run \`npx @p_tipso/agentive\` to regenerate.
+> Edit the source files in \`.agents/\` and re-run \`npx @p_tipso/agentive\` to regenerate.
 
 ## Project Context
 
@@ -91,8 +92,8 @@ async function syncToClaude(agentDir, cwd, techStack) {
 # Rules
 ${rulesContent}
 
-# Skills
-${skillsContent}
+# Commands
+${commandsContent}
 `.trim();
 
   await fs.writeFile(path.join(cwd, 'CLAUDE.md'), claudeMd, 'utf-8');
@@ -101,27 +102,27 @@ ${skillsContent}
 // ─── Windsurf ────────────────────────────────────────────────────────────────
 
 /**
- * Compile .agent/rules/ into a single .windsurfrules file.
- * @param {string} agentDir
+ * Compile .agents/rules/ into a single .windsurfrules file.
+ * @param {string} agentsDir
  * @param {string} cwd
  * @param {string} techStack
  */
-async function syncToWindsurf(agentDir, cwd, techStack) {
-  const rulesContent  = await readMarkdownDir(path.join(agentDir, 'rules'));
-  const skillsContent = await readMarkdownDir(path.join(agentDir, 'skills'));
+async function syncToWindsurf(agentsDir, cwd, techStack) {
+  const rulesContent    = await readMarkdownDir(path.join(agentsDir, 'rules'));
+  const commandsContent = await readMarkdownDir(path.join(agentsDir, 'commands'));
 
   const windsurfRules = `# .windsurfrules — AI Agent Instructions
 
 > Auto-generated by [agentive](https://github.com/TiPS0/agentive).
-> Edit \`.agent/\` and re-run \`npx @p_tipso/agentive\` to regenerate.
+> Edit \`.agents/\` and re-run \`npx @p_tipso/agentive\` to regenerate.
 
 **Tech Stack:** ${techStack}
 
 # Rules
 ${rulesContent}
 
-# Skills
-${skillsContent}
+# Commands
+${commandsContent}
 `.trim();
 
   await fs.writeFile(path.join(cwd, '.windsurfrules'), windsurfRules, 'utf-8');

package/src/utils/fileSystem.js

@@ -6,13 +6,13 @@ const path = require('path');
 // ─── Guards ──────────────────────────────────────────────────────────────────
 
 /**
- * Check if a .agent/ directory already exists in the given working directory.
+ * Check if a .agents/ directory already exists in the given working directory.
  * @param {string} cwd
  * @returns {Promise<boolean>}
  */
 async function agentDirectoryExists(cwd) {
   try {
-    await fs.access(path.join(cwd, '.agent'));
+    await fs.access(path.join(cwd, '.agents'));
     return true;
   } catch {
     return false;
@@ -22,57 +22,63 @@ async function agentDirectoryExists(cwd) {
 // ─── Directory Creation ───────────────────────────────────────────────────────
 
 /**
- * Create (or recreate) the .agent/ directory structure inside the user's project.
+ * Create (or recreate) the .agents/ directory structure inside the user's project.
  *
  * Structure:
- *   .agent/
+ *   AGENTS.md               ← project root
+ *   .agents/
  *   ├── settings.json
  *   ├── settings.local.json
- *   ├── rules/
- *   └── skills/
+ *   ├── commands/
+ *   ├── skills/
+ *   └── rules/
  *
  * @param {string} cwd - The user's current working directory
- * @param {boolean} overwrite - Whether to remove an existing .agent/ directory first
- * @returns {Promise<string>} The path to the created .agent/ directory
+ * @param {boolean} overwrite - Whether to remove an existing .agents/ directory first
+ * @returns {Promise<string>} The path to the created .agents/ directory
  */
 async function createAgentDirectory(cwd, overwrite = false) {
-  const agentDir = path.join(cwd, '.agent');
+  const agentsDir = path.join(cwd, '.agents');
 
   if (overwrite) {
-    await fs.rm(agentDir, { recursive: true, force: true });
+    await fs.rm(agentsDir, { recursive: true, force: true });
+    // Also remove old AGENTS.md if overwriting
+    try { await fs.rm(path.join(cwd, 'AGENTS.md'), { force: true }); } catch { /* noop */ }
   }
 
-  await fs.mkdir(agentDir, { recursive: true });
-  await fs.mkdir(path.join(agentDir, 'rules'), { recursive: true });
-  await fs.mkdir(path.join(agentDir, 'skills'), { recursive: true });
+  await fs.mkdir(agentsDir, { recursive: true });
+  await fs.mkdir(path.join(agentsDir, 'commands'), { recursive: true });
+  await fs.mkdir(path.join(agentsDir, 'skills'), { recursive: true });
+  await fs.mkdir(path.join(agentsDir, 'rules'), { recursive: true });
 
-  return agentDir;
+  return agentsDir;
 }
 
 // ─── Settings Files ───────────────────────────────────────────────────────────
 
 /**
- * Write settings.json and settings.local.json inside .agent/.
+ * Write settings.json and settings.local.json inside .agents/.
  *
  * - settings.json        → tracked by git (project-wide config)
  * - settings.local.json  → gitignored (machine-specific overrides)
  *
- * Also appends `.agent/settings.local.json` to the project's .gitignore if one exists.
+ * Also appends `.agents/settings.local.json` to the project's .gitignore if one exists.
+ * Settings no longer include techStack or tools since the wizard was removed.
  *
- * @param {string} agentDir  - Absolute path to .agent/
+ * @param {string} agentsDir - Absolute path to .agents/
  * @param {object} settings  - The wizard answers to persist
  */
-async function writeSettings(agentDir, settings) {
+async function writeSettings(agentsDir, settings) {
   // settings.json — committed to git
   const settingsJson = {
     projectName:      settings.projectName,
-    techStack:        settings.techStack,
-    tools:            settings.tools,
+    projectType:      settings.projectType || 'general',
+    framework:        settings.framework || null,
     agentiveVersion:  settings.agentiveVersion,
     createdAt:        settings.createdAt,
   };
   await fs.writeFile(
-    path.join(agentDir, 'settings.json'),
+    path.join(agentsDir, 'settings.json'),
     JSON.stringify(settingsJson, null, 2) + '\n',
     'utf-8'
   );
@@ -83,17 +89,17 @@ async function writeSettings(agentDir, settings) {
     overrides: {},
   };
   await fs.writeFile(
-    path.join(agentDir, 'settings.local.json'),
+    path.join(agentsDir, 'settings.local.json'),
     JSON.stringify(localSettingsJson, null, 2) + '\n',
     'utf-8'
   );
 
   // Auto-append to .gitignore if it exists in cwd
-  const cwd = path.dirname(agentDir);
+  const cwd = path.dirname(agentsDir);
   const gitignorePath = path.join(cwd, '.gitignore');
   try {
     let gitignore = await fs.readFile(gitignorePath, 'utf-8');
-    const entry = '.agent/settings.local.json';
+    const entry = '.agents/settings.local.json';
     if (!gitignore.includes(entry)) {
       gitignore += `\n# Agentive local settings (machine-specific)\n${entry}\n`;
       await fs.writeFile(gitignorePath, gitignore, 'utf-8');
@@ -106,40 +112,74 @@ async function writeSettings(agentDir, settings) {
 // ─── Template Copying ─────────────────────────────────────────────────────────
 
 /**
- * Copy all template files from src/templates/ into the .agent/ directory.
- * Replaces {{TECH_STACK}} and {{YEAR}} placeholders in template files.
+ * Copy template files from src/templates/ into the user's project.
  *
- * Note: The context/ folder from templates is not copied (not part of .agent/ structure).
+ * - AGENTS.md → project root (cwd)
+ * - commands/, skills/, rules/ → .agents/
+ *
+ * Replaces {{PROJECT_NAME}} and {{YEAR}} placeholders.
  *
  * @param {string} templatesDir - Absolute path to src/templates/
- * @param {string} destDir      - Absolute path to .agent/
- * @param {string} techStack    - The user's tech stack string
+ * @param {string} agentsDir    - Absolute path to .agents/
+ * @param {string} projectName  - The user's project name
+ * @param {string} projectType  - e.g., 'general', 'web', 'mobile'
+ * @param {string} framework    - e.g., 'expo', 'react-native'
  */
-async function copyTemplates(templatesDir, destDir, techStack) {
-  // Only copy rules/ and skills/ — context/ is dropped from .agent/ structure
-  const foldersToInclude = ['rules', 'skills'];
-
-  for (const folder of foldersToInclude) {
-    const srcFolder = path.join(templatesDir, folder);
-    const destFolder = path.join(destDir, folder);
-
-    try {
-      await fs.access(srcFolder); // skip if template folder doesn't exist
-    } catch {
-      continue;
+async function copyTemplates(templatesDir, agentsDir, projectName, projectType = 'general', framework = null) {
+  const cwd = path.dirname(agentsDir);
+
+  // 1. Copy AGENTS.md from base to project root
+  const agentMdSrc = path.join(templatesDir, 'base', 'AGENTS.md');
+  try {
+    let content = await fs.readFile(agentMdSrc, 'utf-8');
+    content = replacePlaceholders(content, projectName);
+    await fs.writeFile(path.join(cwd, 'AGENTS.md'), content, 'utf-8');
+  } catch { /* template may not exist */ }
+
+  const foldersToInclude = ['commands', 'skills', 'rules'];
+
+  // Helper to copy a specific template layer
+  const copyLayer = async (layerPath) => {
+    for (const folder of foldersToInclude) {
+      const srcFolder = path.join(layerPath, folder);
+      const destFolder = path.join(agentsDir, folder);
+      try {
+        await fs.access(srcFolder);
+        await copyDirectoryRecursive(srcFolder, destFolder, projectName);
+      } catch {
+        continue;
+      }
     }
+  };
+
+  // 2. Copy Base Layer
+  await copyLayer(path.join(templatesDir, 'base'));
 
-    await copyDirectoryRecursive(srcFolder, destFolder, techStack);
+  // 3. Copy Framework Layer (if applicable)
+  if (projectType !== 'general' && framework) {
+    await copyLayer(path.join(templatesDir, projectType, framework));
   }
 }
 
+/**
+ * Replace template placeholders with actual values.
+ * @param {string} content
+ * @param {string} projectName
+ * @returns {string}
+ */
+function replacePlaceholders(content, projectName) {
+  return content
+    .replace(/\{\{PROJECT_NAME\}\}/g, projectName || '')
+    .replace(/\{\{YEAR\}\}/g, new Date().getFullYear().toString());
+}
+
 /**
  * Internal: recursively copies files from src to dest, replacing placeholders.
  * @param {string} src
  * @param {string} dest
- * @param {string} techStack
+ * @param {string} projectName
  */
-async function copyDirectoryRecursive(src, dest, techStack) {
+async function copyDirectoryRecursive(src, dest, projectName) {
   const entries = await fs.readdir(src, { withFileTypes: true });
 
   for (const entry of entries) {
@@ -148,12 +188,10 @@ async function copyDirectoryRecursive(src, dest, techStack) {
 
     if (entry.isDirectory()) {
       await fs.mkdir(destPath, { recursive: true });
-      await copyDirectoryRecursive(srcPath, destPath, techStack);
+      await copyDirectoryRecursive(srcPath, destPath, projectName);
     } else {
       let content = await fs.readFile(srcPath, 'utf-8');
-      content = content
-        .replace(/\{\{TECH_STACK\}\}/g, techStack)
-        .replace(/\{\{YEAR\}\}/g, new Date().getFullYear().toString());
+      content = replacePlaceholders(content, projectName);
       await fs.writeFile(destPath, content, 'utf-8');
     }
   }

package/src/templates/context/project_overview.md

@@ -1,62 +0,0 @@
-# Project Overview
-
-> This file provides essential context for AI agents working on this project.
-> Keep it updated as the project evolves.
-
-## About This Project
-
-<!-- Describe what this project does and who it is for -->
-
-**Tech Stack:** {{TECH_STACK}}
-
-## Project Goals
-
-<!-- List the primary goals and success criteria for this project -->
-
-1. 
-2. 
-3. 
-
-## Architecture Overview
-
-<!-- Briefly describe the high-level architecture and major components -->
-
-```
-your-project/
-├── src/           # Application source code
-├── tests/         # Test files
-└── docs/          # Documentation
-```
-
-## Key Conventions
-
-<!-- Document conventions that are unique to this project -->
-
-- **Branch naming**: `feat/`, `fix/`, `chore/` prefixes
-- **Commit messages**: Follow [Conventional Commits](https://www.conventionalcommits.org/)
-- **PR size**: Keep pull requests focused and under 400 lines changed
-
-## Important Files & Directories
-
-| Path | Purpose |
-|------|---------|
-| `src/` | Application source |
-| `.ai/` | Agent rules, skills, and context (source of truth) |
-
-## External Services & APIs
-
-<!-- List any external services, APIs, or integrations this project depends on -->
-
-| Service | Purpose | Docs |
-|---------|---------|------|
-| | | |
-
-## Known Gotchas
-
-<!-- Document non-obvious things that have caused bugs or confusion in the past -->
-
-- 
-
----
-
-*Generated by [agentive](https://github.com/TiPS0/agentive) on {{YEAR}}.*

package/src/templates/rules/architecture.md

@@ -1,42 +0,0 @@
-# Architecture Rules
-
-> These rules govern how AI agents should reason about, write, and modify code
-> in this project. All agents operating in this repository must follow them.
-
-## Tech Stack
-
-This project uses: **{{TECH_STACK}}**
-
-All generated code must be idiomatic for this stack and follow its established patterns.
-
-## Structural Principles
-
-- **Single Responsibility**: Every function, module, or class should do one thing well.
-- **Separation of Concerns**: Keep data fetching, business logic, and presentation in separate layers.
-- **DRY (Don't Repeat Yourself)**: Before adding new code, search for existing utilities or helpers.
-- **YAGNI (You Aren't Gonna Need It)**: Do not add features or abstractions that aren't required right now.
-
-## Code Style
-
-- Prefer **async/await** over raw Promises or callbacks.
-- Always handle errors explicitly — never swallow exceptions silently.
-- Use **descriptive, intent-revealing names** for variables, functions, and files.
-- Write **small, focused functions** (prefer < 30 lines per function).
-- Add **JSDoc or TSDoc comments** to all exported functions.
-
-## File Organisation
-
-- Group related code by **feature**, not by type (avoid giant `utils/` or `helpers/` dumping grounds).
-- Keep files focused — if a file grows past ~200 lines, consider splitting it.
-- Barrel exports (`index.js`) should only re-export, never contain logic.
-
-## Testing
-
-- Every new feature should have a corresponding test.
-- Test **behaviour**, not implementation details.
-- Prefer unit tests for pure functions; integration tests for side-effecting code.
-
-## Dependencies
-
-- Before adding a new dependency, consider if the task can be accomplished with built-ins.
-- Avoid dependencies with no active maintenance or that have known security advisories.

package/src/templates/skills/data-extractor.md

@@ -1,56 +0,0 @@
-# Skill: Data Extractor Agent
-
-> This skill defines how an AI agent should behave when its role is to
-> extract structured data from raw, unstructured, or semi-structured sources.
-
-## Role Description
-
-You are a **Data Extractor Agent**. Your job is to parse raw content (HTML, text,
-JSON, PDF, CSV, etc.) and extract specific, structured data points as defined by
-the schema provided by the orchestrator. You surface data — you do not transform
-or enrich it.
-
-## Responsibilities
-
-- Parse the provided raw content using the most appropriate method for its format.
-- Extract only the fields specified in the schema — do not add extra fields.
-- Return `null` for any field that cannot be found; do not guess or hallucinate values.
-- Normalise whitespace and remove HTML tags from text values.
-- Flag ambiguous or low-confidence extractions to the orchestrator.
-
-## Inputs
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `content` | `string` | The raw content to parse |
-| `format` | `string` | One of: `html`, `text`, `json`, `csv`, `markdown` |
-| `schema` | `object` | JSON Schema defining the fields to extract |
-
-## Outputs
-
-```json
-{
-  "data": {
-    "field_name": "extracted value",
-    "another_field": null
-  },
-  "confidence": 0.95,
-  "warnings": ["Could not find 'phone_number' in source"]
-}
-```
-
-## Constraints
-
-- **Never infer** or fabricate a value that isn't explicitly present in the source.
-- **Always** include a `confidence` score between `0.0` and `1.0`.
-- If `confidence < 0.7`, always include a `warnings` entry explaining the uncertainty.
-- **Do not** make external network requests — work only with the content provided.
-
-## Error Handling
-
-| Error | Response |
-|-------|----------|
-| `Unsupported format` | Return an error; list supported formats |
-| `Schema mismatch` | Return partial data with warnings for missing fields |
-| `Empty content` | Return all fields as `null` with a warning |
-| `Parse error` | Report the specific parse error and return an empty `data` object |