@trackunit/iris-app 1.12.7 → 1.12.10

package/CHANGELOG.md

@@ -1,3 +1,33 @@
+## 1.12.10 (2026-03-06)
+
+### 🩹 Fixes
+
+- address PR review - chrome-devtools MCP, useWidgetConfig consistency ([de581c854a5](https://github.com/Trackunit/manager/commit/de581c854a5))
+- clean up old .cursor/rules and .cursor/commands files during ai-agent-sync ([e7abc4294ab](https://github.com/Trackunit/manager/commit/e7abc4294ab))
+
+### ❤️ Thank You
+
+- Cursor Agent @cursoragent
+- Kasper Laursen @ghost-of-kla-trackunit
+
+## 1.12.9 (2026-03-06)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 1.12.63
+- Updated iris-app-api to 1.14.57
+- Updated react-test-setup to 1.8.55
+- Updated shared-utils to 1.13.55
+
+## 1.12.8 (2026-03-06)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 1.12.62
+- Updated iris-app-api to 1.14.56
+- Updated react-test-setup to 1.8.54
+- Updated shared-utils to 1.13.54
+
 ## 1.12.7 (2026-03-06)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app",
-  "version": "1.12.7",
+  "version": "1.12.10",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "src/index.js",
   "generators": "./generators.json",
@@ -25,8 +25,8 @@
     "nx": "22.4.4",
     "@npmcli/arborist": "^9.1.9",
     "win-ca": "^3.5.1",
-    "@trackunit/shared-utils": "1.13.53",
-    "@trackunit/iris-app-api": "1.14.55",
+    "@trackunit/shared-utils": "1.13.55",
+    "@trackunit/iris-app-api": "1.14.57",
     "tslib": "^2.6.2",
     "@clack/prompts": "^1.0.0",
     "@npm/types": "^1.0.2"

package/src/generators/ai-agent-sync/README.md

@@ -1,6 +1,6 @@
 # AI Agent Sync Generator
 
-Syncs Cursor rules and AI agent configuration files to the latest version. Ensures the SDK is at the latest version before applying updates.
+Syncs agent skills, AGENTS.md, CLAUDE.md, and AI agent configuration files to the latest version. Ensures the SDK is at the latest version before applying updates.
 
 ## Usage
 
@@ -10,7 +10,10 @@ nx g @trackunit/iris-app:ai-agent-sync
 
 ## What it syncs
 
-- `.cursor/skills/` - Cursor AI skills for the IrisX App SDK
+- `.agents/skills/` - AI agent skills for the IrisX App SDK (editor-agnostic)
+- `.cursor/mcp.json` - Cursor-specific MCP configuration
+- `AGENTS.md` - Workspace-level agent instructions (always applied)
+- `CLAUDE.md` - Claude-specific configuration (references AGENTS.md)
 
 ## Flow
 

package/src/generators/ai-agent-sync/generator.d.ts

@@ -1,7 +1,7 @@
 import { Tree } from "@nx/devkit";
 import { AiAgentSyncGeneratorSchema } from "./schema";
 /**
- * Syncs Cursor rules and AI agent configuration files.
+ * Syncs Cursor skills, AGENTS.md, CLAUDE.md, and AI agent configuration files.
  * Requires the SDK to be at the latest version before running.
  */
 export declare function aiAgentSyncGenerator(tree: Tree, options: AiAgentSyncGeneratorSchema): Promise<void>;

package/src/generators/ai-agent-sync/generator.js

@@ -50,7 +50,7 @@ function ensureUpdateScript(tree) {
     });
 }
 /**
- * Syncs Cursor rules and AI agent configuration files.
+ * Syncs Cursor skills, AGENTS.md, CLAUDE.md, and AI agent configuration files.
  * Requires the SDK to be at the latest version before running.
  */
 async function aiAgentSyncGenerator(tree, options) {
@@ -74,9 +74,34 @@ async function aiAgentSyncGenerator(tree, options) {
                 `Then run this generator again.`);
         }
     }
-    // Copy Cursor rules and AI agent configuration
-    const templatePath = path.join(__dirname, "../preset/files/.cursor");
-    (0, devkit_1.generateFiles)(tree, templatePath, ".cursor", {});
+    // Clean up old .cursor/rules and .cursor/commands files that were managed by previous versions
+    const oldManagedFiles = [
+        ".cursor/rules/irisx-app-sdk.mdc",
+        ".cursor/rules/rules-index.mdc",
+        ".cursor/rules/structured-development.mdc",
+        ".cursor/rules/browser-irisx-development.mdc",
+        ".cursor/rules/graphql-timeseries.md",
+        ".cursor/rules/irisx-app-sdk-customfields.md",
+        ".cursor/rules/irisx-app-sdk-graphql.md",
+        ".cursor/rules/react-core-hooks.md",
+        ".cursor/rules/tables-and-sorting.mdc",
+        ".cursor/rules/widget-extensions.md",
+        ".cursor/commands/create-app.md",
+    ];
+    for (const file of oldManagedFiles) {
+        if (tree.exists(file)) {
+            tree.delete(file);
+        }
+    }
+    // Copy Cursor-specific configuration (mcp.json)
+    const cursorTemplatePath = path.join(__dirname, "../preset/files/.cursor");
+    (0, devkit_1.generateFiles)(tree, cursorTemplatePath, ".cursor", {});
+    // Copy agent skills (editor-agnostic)
+    const agentsTemplatePath = path.join(__dirname, "../preset/files/.agents");
+    (0, devkit_1.generateFiles)(tree, agentsTemplatePath, ".agents", {});
+    // Copy AGENTS.md and CLAUDE.md to workspace root
+    const rootTemplatePath = path.join(__dirname, "../preset/root-files");
+    (0, devkit_1.generateFiles)(tree, rootTemplatePath, ".", {});
     await (0, devkit_1.formatFiles)(tree);
 }
 exports.default = aiAgentSyncGenerator;

package/src/generators/ai-agent-sync/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app/src/generators/ai-agent-sync/generator.ts"],"names":[],"mappings":"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","sourcesContent":["import { Tree, formatFiles, generateFiles, updateJson } from \"@nx/devkit\";\nimport { detectPackageManager, getPackageManagerCommand } from \"nx/src/devkit-exports\";\nimport * as pacote from \"pacote\";\nimport * as path from \"path\";\nimport * as semver from \"semver\";\nimport { AiAgentSyncGeneratorSchema } from \"./schema\";\n\nconst IRIS_APP_PACKAGE = \"@trackunit/iris-app\";\nconst UPDATE_SCRIPT_NAME = \"update:trackunit\";\nconst UPDATE_SCRIPT_CMD = 'npx npm-check-updates \"/@trackunit/\" -u';\n\ntype PackageJson = {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  scripts?: Record<string, string>;\n};\n\nfunction getStringValue(obj: unknown, key: string): string | undefined {\n  if (typeof obj === \"object\" && obj !== null && key in obj) {\n    const value = (obj as Record<string, unknown>)[key];\n    return typeof value === \"string\" ? value : undefined;\n  }\n  return undefined;\n}\n\n/**\n * Gets the installed version of @trackunit/iris-app from workspace package.json\n */\nfunction getInstalledSdkVersion(tree: Tree): string | undefined {\n  const pkgJson: unknown = JSON.parse(tree.read(\"package.json\", \"utf-8\") ?? \"{}\");\n  if (typeof pkgJson !== \"object\" || pkgJson === null) {\n    return undefined;\n  }\n  const pkg = pkgJson as Record<string, unknown>;\n  return getStringValue(pkg.dependencies, IRIS_APP_PACKAGE) ?? getStringValue(pkg.devDependencies, IRIS_APP_PACKAGE);\n}\n\n/**\n * Fetches the latest version of @trackunit/iris-app from npm\n */\nasync function getLatestSdkVersion(): Promise<string> {\n  const manifest = await pacote.manifest(IRIS_APP_PACKAGE);\n  return manifest.version;\n}\n\n/**\n * Ensures the update:trackunit script exists in package.json\n */\nfunction ensureUpdateScript(tree: Tree): void {\n  updateJson<PackageJson, PackageJson>(tree, \"package.json\", pkgJson => {\n    if (!pkgJson.scripts) {\n      pkgJson.scripts = {};\n    }\n    if (!pkgJson.scripts[UPDATE_SCRIPT_NAME]) {\n      pkgJson.scripts[UPDATE_SCRIPT_NAME] = UPDATE_SCRIPT_CMD;\n    }\n    return pkgJson;\n  });\n}\n\n/**\n * Syncs Cursor rules and AI agent configuration files.\n * Requires the SDK to be at the latest version before running.\n */\nexport async function aiAgentSyncGenerator(tree: Tree, options: AiAgentSyncGeneratorSchema): Promise<void> {\n  // Always ensure the update script exists\n  ensureUpdateScript(tree);\n\n  // Check SDK version unless skipped\n  if (!options.skipVersionCheck) {\n    const installedVersion = getInstalledSdkVersion(tree);\n    const latestVersion = await getLatestSdkVersion();\n\n    if (!installedVersion) {\n      throw new Error(`${IRIS_APP_PACKAGE} not found in package.json. Is this an Iris App SDK workspace?`);\n    }\n\n    const installed = semver.minVersion(installedVersion);\n    if (!installed || semver.lt(installed, latestVersion)) {\n      const pm = detectPackageManager();\n      const pmCmd = getPackageManagerCommand(pm);\n\n      throw new Error(\n        `${IRIS_APP_PACKAGE} is outdated (installed: ${installedVersion}, latest: ${latestVersion}).\\n\\n` +\n          `Run the following commands first:\\n` +\n          `  ${pmCmd.run(UPDATE_SCRIPT_NAME)}\\n` +\n          `  ${pmCmd.install}\\n\\n` +\n          `Then run this generator again.`\n      );\n    }\n  }\n\n  // Copy Cursor rules and AI agent configuration\n  const templatePath = path.join(__dirname, \"../preset/files/.cursor\");\n  generateFiles(tree, templatePath, \".cursor\", {});\n\n  await formatFiles(tree);\n}\n\nexport default aiAgentSyncGenerator;\n\n"]}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app/src/generators/ai-agent-sync/generator.ts"],"names":[],"mappings":"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","sourcesContent":["import { Tree, formatFiles, generateFiles, updateJson } from \"@nx/devkit\";\nimport { detectPackageManager, getPackageManagerCommand } from \"nx/src/devkit-exports\";\nimport * as pacote from \"pacote\";\nimport * as path from \"path\";\nimport * as semver from \"semver\";\nimport { AiAgentSyncGeneratorSchema } from \"./schema\";\n\nconst IRIS_APP_PACKAGE = \"@trackunit/iris-app\";\nconst UPDATE_SCRIPT_NAME = \"update:trackunit\";\nconst UPDATE_SCRIPT_CMD = 'npx npm-check-updates \"/@trackunit/\" -u';\n\ntype PackageJson = {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  scripts?: Record<string, string>;\n};\n\nfunction getStringValue(obj: unknown, key: string): string | undefined {\n  if (typeof obj === \"object\" && obj !== null && key in obj) {\n    const value = (obj as Record<string, unknown>)[key];\n    return typeof value === \"string\" ? value : undefined;\n  }\n  return undefined;\n}\n\n/**\n * Gets the installed version of @trackunit/iris-app from workspace package.json\n */\nfunction getInstalledSdkVersion(tree: Tree): string | undefined {\n  const pkgJson: unknown = JSON.parse(tree.read(\"package.json\", \"utf-8\") ?? \"{}\");\n  if (typeof pkgJson !== \"object\" || pkgJson === null) {\n    return undefined;\n  }\n  const pkg = pkgJson as Record<string, unknown>;\n  return getStringValue(pkg.dependencies, IRIS_APP_PACKAGE) ?? getStringValue(pkg.devDependencies, IRIS_APP_PACKAGE);\n}\n\n/**\n * Fetches the latest version of @trackunit/iris-app from npm\n */\nasync function getLatestSdkVersion(): Promise<string> {\n  const manifest = await pacote.manifest(IRIS_APP_PACKAGE);\n  return manifest.version;\n}\n\n/**\n * Ensures the update:trackunit script exists in package.json\n */\nfunction ensureUpdateScript(tree: Tree): void {\n  updateJson<PackageJson, PackageJson>(tree, \"package.json\", pkgJson => {\n    if (!pkgJson.scripts) {\n      pkgJson.scripts = {};\n    }\n    if (!pkgJson.scripts[UPDATE_SCRIPT_NAME]) {\n      pkgJson.scripts[UPDATE_SCRIPT_NAME] = UPDATE_SCRIPT_CMD;\n    }\n    return pkgJson;\n  });\n}\n\n/**\n * Syncs Cursor skills, AGENTS.md, CLAUDE.md, and AI agent configuration files.\n * Requires the SDK to be at the latest version before running.\n */\nexport async function aiAgentSyncGenerator(tree: Tree, options: AiAgentSyncGeneratorSchema): Promise<void> {\n  // Always ensure the update script exists\n  ensureUpdateScript(tree);\n\n  // Check SDK version unless skipped\n  if (!options.skipVersionCheck) {\n    const installedVersion = getInstalledSdkVersion(tree);\n    const latestVersion = await getLatestSdkVersion();\n\n    if (!installedVersion) {\n      throw new Error(`${IRIS_APP_PACKAGE} not found in package.json. Is this an Iris App SDK workspace?`);\n    }\n\n    const installed = semver.minVersion(installedVersion);\n    if (!installed || semver.lt(installed, latestVersion)) {\n      const pm = detectPackageManager();\n      const pmCmd = getPackageManagerCommand(pm);\n\n      throw new Error(\n        `${IRIS_APP_PACKAGE} is outdated (installed: ${installedVersion}, latest: ${latestVersion}).\\n\\n` +\n          `Run the following commands first:\\n` +\n          `  ${pmCmd.run(UPDATE_SCRIPT_NAME)}\\n` +\n          `  ${pmCmd.install}\\n\\n` +\n          `Then run this generator again.`\n      );\n    }\n  }\n\n  // Clean up old .cursor/rules and .cursor/commands files that were managed by previous versions\n  const oldManagedFiles = [\n    \".cursor/rules/irisx-app-sdk.mdc\",\n    \".cursor/rules/rules-index.mdc\",\n    \".cursor/rules/structured-development.mdc\",\n    \".cursor/rules/browser-irisx-development.mdc\",\n    \".cursor/rules/graphql-timeseries.md\",\n    \".cursor/rules/irisx-app-sdk-customfields.md\",\n    \".cursor/rules/irisx-app-sdk-graphql.md\",\n    \".cursor/rules/react-core-hooks.md\",\n    \".cursor/rules/tables-and-sorting.mdc\",\n    \".cursor/rules/widget-extensions.md\",\n    \".cursor/commands/create-app.md\",\n  ];\n  for (const file of oldManagedFiles) {\n    if (tree.exists(file)) {\n      tree.delete(file);\n    }\n  }\n\n  // Copy Cursor-specific configuration (mcp.json)\n  const cursorTemplatePath = path.join(__dirname, \"../preset/files/.cursor\");\n  generateFiles(tree, cursorTemplatePath, \".cursor\", {});\n\n  // Copy agent skills (editor-agnostic)\n  const agentsTemplatePath = path.join(__dirname, \"../preset/files/.agents\");\n  generateFiles(tree, agentsTemplatePath, \".agents\", {});\n\n  // Copy AGENTS.md and CLAUDE.md to workspace root\n  const rootTemplatePath = path.join(__dirname, \"../preset/root-files\");\n  generateFiles(tree, rootTemplatePath, \".\", {});\n\n  await formatFiles(tree);\n}\n\nexport default aiAgentSyncGenerator;\n"]}

package/src/generators/preset/files/.agents/skills/browser-testing/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: browser-testing
+description: Use when testing IrisX Apps in browser, extension not appearing, dev mode toggle issues, or verifying code changes in Trackunit Manager.
+---
+
+# Browser Testing for IrisX Apps
+
+## Overview
+
+IrisX Apps run inside Trackunit Manager, not on localhost. Test at `https://new.manager.trackunit.com/goto/iris-app-dev` with "Use Local Apps" enabled.
+
+## Chrome DevTools MCP Required
+
+**IrisX Apps render inside iFrames.** Standard browser automation tools cannot interact with iFrame content. You **MUST** use Chrome DevTools MCP for browser testing.
+
+### Check Chrome DevTools MCP Availability
+
+Before browser testing, verify the MCP is available:
+
+1. Check if `chrome-devtools` MCP server is enabled in Cursor settings
+2. Try listing pages: use the `list_pages` tool from `user-chrome-devtools` server
+3. If tools are not available, the MCP needs to be configured
+
+### Setup Chrome DevTools MCP
+
+If Chrome DevTools MCP is not available:
+
+1. **Install the MCP server** - Guide the user to install `chrome-devtools-mcp`
+2. **Configure in Cursor** - Add the server to `.cursor/mcp.json`:
+   ```json
+   {
+     "mcpServers": {
+       "chrome-devtools": {
+         "command": "npx",
+         "args": ["-y", "chrome-devtools-mcp@latest"]
+       }
+     }
+   }
+   ```
+3. **Restart Cursor** to load the new MCP server
+4. **Launch Chrome with debugging** - Chrome must be started with remote debugging enabled (the MCP handles this)
+
+### Why Chrome DevTools?
+
+| Standard Browser Tools | Chrome DevTools MCP |
+|------------------------|---------------------|
+| Cannot access iFrame content | Full iFrame support via CDP |
+| Limited to top-level DOM | Access nested contexts |
+| Screenshots miss iFrame content | Captures complete page |
+| Cannot interact with extensions | Full extension interaction |
+
+## When to Use
+
+- Testing extension after code changes
+- Extension not appearing or showing blank
+- Enabling local development mode
+- Debugging GraphQL/API errors in browser
+- Verifying UI renders correctly
+
+**Not for:** Unit tests, linting, or type checking (use NX commands).
+
+## Quick Reference
+
+### Setup Steps
+
+1. Navigate to `https://new.manager.trackunit.com/goto/iris-app-dev`
+2. Wait for user login (2-4 minutes)
+3. Enable "Use Local Apps" toggle (main content area, not sidebar)
+4. Navigate to extension based on type
+
+### Navigate to Extension
+
+Based on extension type:
+
+| Extension Type | Navigation |
+|----------------|------------|
+| `FLEET_EXTENSION` | Main menu → App name |
+| `ASSET_HOME_EXTENSION` | Assets → Open any asset → Extension tab |
+| `SITE_HOME_EXTENSION` | Sites → Open any site → Extension tab |
+| `WIDGET_EXTENSION` | Dashboard → Add Widget → Find widget |
+
+## Testing After Code Changes
+
+### Reload Strategy
+
+After making code changes:
+
+**1. Check Lints First (Zero Tolerance):**
+```
+- Run read_lints on modified files
+- Fix ALL errors before testing in browser
+- Do not proceed with any TypeScript or linter errors
+```
+
+**2. Reload Browser:**
+
+The dev server hot-reloads, but sometimes a full page refresh is needed:
+
+| Option | When to Use | How |
+|--------|-------------|-----|
+| Wait for Hot Reload | First attempt | Wait 2-3 seconds |
+| Soft Refresh | Changes don't appear | `Command+R` (Mac) or `Ctrl+R` (Windows) |
+| Hard Refresh | Soft refresh fails | `Command+Shift+R` (Mac) or `Ctrl+Shift+R` (Windows) |
+
+**3. Manifest Changes Require Re-Serve:**
+
+If you modified `iris-app-manifest.ts` (scopes, CSP headers, metadata):
+- Browser reload is NOT enough
+- Stop the dev server (`Ctrl+C`)
+- Re-run: `npx nx run [app-name]:serve`
+- Wait for server to restart
+- Then reload browser
+
+### Verification Checklist
+
+After each reload:
+
+1. Take browser snapshot
+2. Look for extension content
+3. Check if blank/empty → may need hard refresh
+4. Verify expected UI elements are present
+5. Check console for errors
+6. Check network requests for GraphQL/API issues
+
+## Troubleshooting
+
+### Extension Shows Blank After Changes
+
+1. Try hard refresh (`Command+Shift+R`)
+2. Check browser console for errors
+3. Check if dev server is still running
+4. Verify file saved correctly
+5. Check for TypeScript compilation errors
+6. Navigate away and back to extension
+
+### "Use Local Apps" Toggle Not Found
+
+1. Verify user is logged in
+2. Navigate directly to `https://new.manager.trackunit.com/goto/iris-app-dev`
+3. Wait for page to fully load (redirects to Developer Settings)
+4. Take snapshot to see what's visible
+5. Toggle is in the main content area, not the sidebar
+
+### Extension Not Appearing
+
+1. Verify dev server is running
+2. Check manifest has correct extension type
+3. If changed `iris-app-manifest.ts` → re-serve the app
+4. Hard refresh browser
+5. Disable and re-enable "Use Local Apps"
+6. Check browser console for loading errors
+
+### GraphQL/API Errors
+
+1. Use browser network tab to find GraphQL requests
+2. Inspect response body for "errors" array (GraphQL returns 200 even with errors)
+3. Common fixes:
+   - Missing scopes → Add to `iris-app-manifest.ts` scopes array
+   - CSP violations → Add domain to `cspHeader` in manifest
+   - Auth issues → Deploy app to enable new scopes
+
+## Workflow Checklist
+
+### After Every Code Change:
+
+1. ✅ Check lints (zero tolerance)
+2. ✅ Fix all errors
+3. ✅ Wait 2-3 seconds for hot reload
+4. ✅ Refresh browser if needed
+5. ✅ Take snapshot
+6. ✅ Verify changes visible
+7. ✅ Check console for errors
+8. ✅ Check network tab if using APIs
+
+### Before Moving to Next Feature:
+
+1. ✅ Current feature fully working in browser
+2. ✅ Zero linter/TypeScript errors
+3. ✅ Zero browser console errors
+4. ✅ All network requests successful
+5. ✅ Screenshot of working feature
+
+## Common Mistakes
+
+| Mistake | Fix |
+|---------|-----|
+| Using default browser automation | Extensions render in iFrames; use Chrome DevTools MCP |
+| Testing on localhost | Use `https://new.manager.trackunit.com/goto/iris-app-dev` |
+| Skipping lint check before browser | Always run `read_lints` first |
+| Not enabling "Use Local Apps" | Toggle is in main content area, not sidebar |
+| Changed manifest without re-serve | Stop dev server and restart |
+| Moving to next feature before verifying | Confirm current feature works in browser first |
+| Chrome DevTools MCP not configured | Help user install and configure the MCP server |

package/src/generators/preset/files/.agents/skills/create-app/SKILL.md

@@ -0,0 +1,191 @@
+---
+name: create-app
+description: Use when building a new IrisX App from scratch, user asks to create an app, or starting a new extension project.
+---
+
+# Create IrisX App
+
+## Overview
+
+Create IrisX Apps using browser-driven iterative development. Real data first (GraphQL API), verify each feature in browser before proceeding.
+
+## When to Use
+
+- User asks to create a new IrisX App
+- Starting a new extension project
+- Building a complete app from requirements
+
+**Not for:** Modifying existing extensions (use domain-specific skills).
+
+## Core Principles
+
+| Principle | Implementation |
+|-----------|----------------|
+| Real Data First | Use GraphQL API, never mock unless requested |
+| Browser Testing | Verify each change at `manager.trackunit.com/goto/iris-app-dev` |
+| Chrome DevTools MCP | Required for iFrame-based extension testing |
+| One Feature at a Time | Complete and verify before moving on |
+| Zero Tolerance for Errors | Fix all lint/TypeScript errors immediately |
+
+## Chrome DevTools MCP Requirement
+
+**IrisX Apps render inside iFrames.** Standard browser automation cannot interact with iFrame content.
+
+Before starting browser testing:
+1. Verify Chrome DevTools MCP is available (check for `user-chrome-devtools` server)
+2. If not available, see `browser-testing` skill for setup instructions
+3. Use Chrome DevTools tools (`take_screenshot`, `click`, `evaluate_script`, etc.) for all browser interactions
+
+## Development Workflow
+
+### Phase 1: Planning
+
+**1. Analyze Requirements**
+
+If not already described, ask: "What functionality do you want to build?"
+
+**2. Create Implementation Plan**
+
+Structure the plan as:
+
+- **Phase 1: Project Setup**
+  - Create app with `@trackunit/iris-app:create`
+  - Create extensions with `@trackunit/iris-app:extend`
+  - Start dev server in background
+
+- **Phase 2: Browser Verification (CRITICAL GATE)**
+  - Verify Chrome DevTools MCP is available (required for iFrame testing)
+  - Open browser to `https://new.manager.trackunit.com/goto/iris-app-dev`
+  - Wait for user login (2-4 minutes)
+  - Enable "Use Local Apps" toggle
+  - Navigate to extension location
+  - Use Chrome DevTools `take_screenshot` to verify extension renders
+  - **STOP - Must confirm extension working before Phase 3**
+
+- **Phase 3: Feature Implementation (One at a Time)**
+  - For each feature:
+    - Prerequisites (GraphQL setup/scopes needed)
+    - Implementation
+    - Validation: Check lints, browser test
+    - Browser test: What to verify
+
+- **Phase 4: Final Verification**
+  - Zero linter/TypeScript errors
+  - End-to-end browser testing
+  - Documentation completion
+
+**3. Present Plan to User**
+
+Confirm before proceeding.
+
+### Phase 2: Project Setup
+
+**4. Create App and Extensions**
+
+```bash
+npx nx generate @trackunit/iris-app:create [app-name]
+npx nx g @trackunit/iris-app:extend --name=[extension-name] --app=[app-name] --directory=[feature] --type=[EXTENSION_TYPE]
+```
+
+**5. Start Development Server**
+
+```bash
+npx nx run [app-name]:serve
+```
+
+**6. Open Browser and Verify**
+
+**CRITICAL: Do this BEFORE any GraphQL setup or UI implementation**
+
+1. Navigate to `https://new.manager.trackunit.com/goto/iris-app-dev`
+2. Wait for user login
+3. Enable "Use Local Apps" toggle
+4. Navigate to extension based on type
+5. Take snapshot to verify extension loads
+6. Check console for errors
+
+**STOP HERE: Do not proceed until extension is confirmed working**
+
+### Phase 3: Iterative Feature Development
+
+**7. Create Documentation**
+
+Create `/docs/[app-name].md` with the plan and architecture.
+
+**8. For Each Feature (ONE AT A TIME)**
+
+**a) Setup prerequisites for this feature ONLY:**
+```bash
+# If feature needs GraphQL:
+npm install @trackunit/react-graphql-tools
+npx nx generate @trackunit/react-graphql-tools:add-graphql --project=[project-name]
+```
+
+**b) Implement the feature:**
+- Write code changes for ONE feature only
+- Keep changes small and focused
+
+**c) Check for lint and TypeScript errors:**
+- Run `read_lints` on modified files
+- Fix ALL errors immediately
+- Zero tolerance: Do not proceed with any errors
+
+**d) Reload browser to test:**
+- Check browser console and network tab for errors
+- Verify the feature renders correctly
+- Take screenshot if visual changes
+
+**e) Debug if needed:**
+- Read console errors
+- Check network requests
+- Adjust code and repeat
+- **DO NOT** move forward until feature works
+
+**f) Update documentation:**
+- Mark feature as completed
+
+**g) Move to next feature:**
+- Only proceed when current feature is verified working
+
+### Phase 4: Completion
+
+**9. Final Verification**
+
+- Run `read_lints` on all modified files
+- Test all features end-to-end in browser
+- Verify data loads correctly
+
+**10. Summary**
+
+Inform the user:
+- All features implemented and verified
+- No linter or TypeScript errors remaining
+- Documentation complete
+- **Important**: User must deploy via Trackunit marketplace (never auto-submit)
+
+## Critical Rules
+
+### Feature Implementation
+- **One feature at a time** - even for similar components
+- **Prerequisites on-demand** - setup GraphQL/scopes only when needed
+- **Zero tolerance for errors** - fix all lint/TypeScript errors immediately
+- **Test completely** - verify working in browser before moving on
+
+### Validation Checklist (After Every Code Change)
+1. Run `read_lints` on modified files
+2. Fix ALL linter and TypeScript errors
+3. Reload browser
+4. Check browser console and network tab
+5. Verify UI renders correctly
+6. Fix any issues before proceeding
+
+## Common Mistakes
+
+| Mistake | Fix |
+|---------|-----|
+| Using default browser automation | Use Chrome DevTools MCP (iFrames require it) |
+| Starting implementation before browser verification | Complete Phase 2 (browser gate) first |
+| Implementing multiple features at once | One feature, fully verified, then next |
+| Using mock data without asking | Always use real GraphQL API |
+| Skipping lint check | Zero tolerance - run `read_lints` after every change |
+| Auto-submitting to marketplace | Never auto-submit; instruct user to do so |