berget 2.2.6 → 2.2.7

package/dist/tests/utils/opencode-validator.test.js

@@ -3,21 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const vitest_1 = require("vitest");
 const opencode_validator_1 = require("../../src/utils/opencode-validator");
 const fs_1 = require("fs");
-(0, vitest_1.describe)('OpenCode Validator', () => {
-    (0, vitest_1.it)('should validate a correct OpenCode configuration', () => {
+(0, vitest_1.describe)("OpenCode Validator", () => {
+    (0, vitest_1.it)("should validate a correct OpenCode configuration", () => {
         const validConfig = {
-            $schema: 'https://opencode.ai/config.json',
-            username: 'test-user',
-            model: 'gpt-4',
+            $schema: "https://opencode.ai/config.json",
+            username: "test-user",
+            model: "gpt-4",
             agent: {
                 test: {
-                    model: 'gpt-4',
+                    model: "gpt-4",
                     temperature: 0.7,
-                    prompt: 'Test agent',
+                    prompt: "Test agent",
                     permission: {
-                        edit: 'allow',
-                        bash: 'allow',
-                        webfetch: 'allow',
+                        edit: "allow",
+                        bash: "allow",
+                        webfetch: "allow",
                     },
                 },
             },
@@ -26,19 +26,19 @@ const fs_1 = require("fs");
         (0, vitest_1.expect)(result.valid).toBe(true);
         (0, vitest_1.expect)(result.errors).toBeUndefined();
     });
-    (0, vitest_1.it)('should reject invalid configuration', () => {
+    (0, vitest_1.it)("should reject invalid configuration", () => {
         const invalidConfig = {
             username: 123, // Should be string
-            model: 'gpt-4',
+            model: "gpt-4",
             agent: {
                 test: {
-                    model: 'gpt-4',
-                    temperature: 'high', // Should be number
-                    prompt: 'Test agent',
+                    model: "gpt-4",
+                    temperature: "high", // Should be number
+                    prompt: "Test agent",
                     permission: {
-                        edit: 'invalid', // Should be enum value
-                        bash: 'allow',
-                        webfetch: 'allow',
+                        edit: "invalid", // Should be enum value
+                        bash: "allow",
+                        webfetch: "allow",
                     },
                 },
             },
@@ -48,10 +48,10 @@ const fs_1 = require("fs");
         (0, vitest_1.expect)(result.errors).toBeDefined();
         (0, vitest_1.expect)(result.errors.length).toBeGreaterThan(0);
     });
-    (0, vitest_1.it)('should fix common configuration issues', () => {
+    (0, vitest_1.it)("should fix common configuration issues", () => {
         const configWithIssues = {
-            username: 'test-user',
-            model: 'gpt-4',
+            username: "test-user",
+            model: "gpt-4",
             tools: {
                 compact: { threshold: 80000 }, // Should be boolean
             },
@@ -59,8 +59,8 @@ const fs_1 = require("fs");
             provider: {
                 berget: {
                     models: {
-                        'test-model': {
-                            name: 'Test Model',
+                        "test-model": {
+                            name: "Test Model",
                             maxTokens: 4000, // Should be moved to limit.context
                             contextWindow: 8000, // Should be moved to limit.context
                         },
@@ -70,24 +70,24 @@ const fs_1 = require("fs");
         };
         const fixed = (0, opencode_validator_1.fixOpenCodeConfig)(configWithIssues);
         // tools.compact should be boolean
-        (0, vitest_1.expect)(typeof fixed.tools.compact).toBe('boolean');
+        (0, vitest_1.expect)(typeof fixed.tools.compact).toBe("boolean");
         // maxTokens should be removed
         (0, vitest_1.expect)(fixed.maxTokens).toBeUndefined();
         // maxTokens and contextWindow should be moved to limit.context
-        (0, vitest_1.expect)(fixed.provider.berget.models['test-model'].limit).toBeDefined();
-        (0, vitest_1.expect)(fixed.provider.berget.models['test-model'].limit.context).toBe(8000);
-        (0, vitest_1.expect)(fixed.provider.berget.models['test-model'].maxTokens).toBeUndefined();
-        (0, vitest_1.expect)(fixed.provider.berget.models['test-model'].contextWindow).toBeUndefined();
+        (0, vitest_1.expect)(fixed.provider.berget.models["test-model"].limit).toBeDefined();
+        (0, vitest_1.expect)(fixed.provider.berget.models["test-model"].limit.context).toBe(8000);
+        (0, vitest_1.expect)(fixed.provider.berget.models["test-model"].maxTokens).toBeUndefined();
+        (0, vitest_1.expect)(fixed.provider.berget.models["test-model"].contextWindow).toBeUndefined();
     });
-    (0, vitest_1.it)('should validate the current opencode.json file', () => {
+    (0, vitest_1.it)("should validate the current opencode.json file", () => {
         var _a;
         let currentConfig;
         try {
-            currentConfig = JSON.parse((0, fs_1.readFileSync)('opencode.json', 'utf8'));
+            currentConfig = JSON.parse((0, fs_1.readFileSync)("opencode.json", "utf8"));
         }
         catch (error) {
             // Skip when opencode.json is not present (e.g. in CI or clean checkouts)
-            console.log('Skipping: opencode.json not found:', error);
+            console.log("Skipping: opencode.json not found:", error);
             return;
         }
         // Apply fixes to handle common issues
@@ -97,8 +97,8 @@ const fs_1 = require("fs");
         // The fixed config should be valid according to the JSON Schema
         (0, vitest_1.expect)(result.valid).toBe(true);
         if (!result.valid) {
-            console.log('Fixed opencode.json validation errors:');
-            (_a = result.errors) === null || _a === void 0 ? void 0 : _a.forEach((err) => console.log(`  - ${err}`));
+            console.log("Fixed opencode.json validation errors:");
+            (_a = result.errors) === null || _a === void 0 ? void 0 : _a.forEach(err => console.log(`  - ${err}`));
         }
     });
 });

package/dist/vitest.config.js

@@ -4,6 +4,6 @@ const config_1 = require("vitest/config");
 exports.default = (0, config_1.defineConfig)({
     test: {
         globals: true,
-        environment: 'node',
+        environment: "node",
     },
 });

package/eslint.config.mjs

@@ -0,0 +1,47 @@
+import typescriptEslint from "@typescript-eslint/eslint-plugin";
+import typescriptParser from "@typescript-eslint/parser";
+import prettier from "eslint-plugin-prettier";
+
+export default [
+  {
+    ignores: [
+      "node_modules/**",
+      "dist/**",
+      "build/**",
+      "*.lock",
+      ".husky/**",
+      "coverage/**",
+      ".nyc_output/**",
+      "test-results/**",
+      "playwright-report/**",
+      ".pi/**",
+    ],
+  },
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    languageOptions: {
+      parser: typescriptParser,
+      parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "commonjs",
+        project: "./tsconfig.json",
+        tsconfigRootDir: process.cwd(),
+      },
+      globals: {
+        node: "readonly",
+        es2022: "readonly",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": typescriptEslint,
+      prettier: prettier,
+    },
+    rules: {
+      ...prettier.configs.recommended.rules,
+      "@typescript-eslint/no-unused-vars": ["warn", { argsIgnorePattern: "^_" }],
+      "@typescript-eslint/no-explicit-any": "warn",
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-floating-promises": "off",
+    },
+  },
+];

package/index.ts

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 
-import { program, Option } from 'commander'
-import { registerCommands } from './src/commands'
-import { checkBergetConfig } from './src/utils/config-checker'
-import chalk from 'chalk'
-import { version } from './package.json'
-process.env.DOTENV_CONFIG_OVERRIDE = 'true'
-import 'dotenv/config'
+import { program, Option } from "commander";
+import { registerCommands } from "./src/commands";
+import { checkBergetConfig } from "./src/utils/config-checker";
+import chalk from "chalk";
+import { version } from "./package.json";
+process.env.DOTENV_CONFIG_OVERRIDE = "true";
+import "dotenv/config";
 
 // Set version and description
 program
-  .name('berget')
+  .name("berget")
   .description(
     `______                     _      ___  _____ 
 | ___ \\                   | |    / _ \\|_   _|
@@ -22,70 +22,64 @@ program
                 |___/   AI on European terms
 Version: ${version}`
   )
-  .version(version, '-v, --version')
-  .addOption(new Option('--local').default(false).hideHelp())
-  .addOption(new Option('--stage').default(false).hideHelp())
-  .option('--debug', 'Enable debug output', false)
+  .version(version, "-v, --version")
+  .addOption(new Option("--local").default(false).hideHelp())
+  .addOption(new Option("--stage").default(false).hideHelp())
+  .option("--debug", "Enable debug output", false);
 
 // Register all commands
-registerCommands(program)
+registerCommands(program);
 
 // Check for .bergetconfig if not running a command
 if (process.argv.length <= 2) {
-  checkBergetConfig()
+  checkBergetConfig();
 
   // Show the full help (including logo and commands)
-  program.outputHelp()
-  process.exit(0)
+  program.outputHelp();
+  process.exit(0);
 }
 
 // Add helpful suggestions for common command mistakes
 const commonMistakes: Record<string, string> = {
-  login: 'auth login',
-  logout: 'auth logout',
-  whoami: 'auth whoami',
-  'list-models': 'models list',
-  'list-keys': 'api-keys list',
-  'create-key': 'api-keys create',
-  'list-clusters': 'clusters list',
-  usage: 'billing usage',
-  init: 'code init',
-}
+  login: "auth login",
+  logout: "auth logout",
+  whoami: "auth whoami",
+  "list-models": "models list",
+  "list-keys": "api-keys list",
+  "create-key": "api-keys create",
+  "list-clusters": "clusters list",
+  usage: "billing usage",
+  init: "code init",
+};
 
 // Add error handler for unknown commands
-program.on('command:*', (operands) => {
-  const unknownCommand = operands[0] as string
-  console.error(chalk.red(`Error: unknown command '${unknownCommand}'`))
+program.on("command:*", operands => {
+  const unknownCommand = operands[0] as string;
+  console.error(chalk.red(`Error: unknown command '${unknownCommand}'`));
 
   // Check if this is a known mistake and suggest the correct command
   if (unknownCommand in commonMistakes) {
     console.log(
-      chalk.yellow(
-        `Did you mean? ${chalk.bold(
-          `berget ${commonMistakes[unknownCommand]}`
-        )}`
-      )
-    )
+      chalk.yellow(`Did you mean? ${chalk.bold(`berget ${commonMistakes[unknownCommand]}`)}`)
+    );
   } else {
     // Try to find similar commands
-    const availableCommands = program.commands.map((cmd) => cmd.name())
+    const availableCommands = program.commands.map(cmd => cmd.name());
     const similarCommands = availableCommands.filter(
-      (cmd) => cmd.includes(unknownCommand) || unknownCommand.includes(cmd)
-    )
+      cmd => cmd.includes(unknownCommand) || unknownCommand.includes(cmd)
+    );
 
     if (similarCommands.length > 0) {
-      console.log(chalk.yellow('Similar commands:'))
-      similarCommands.forEach((cmd) => {
-        console.log(chalk.yellow(`  ${chalk.bold(`berget ${cmd}`)}`))
-      })
+      console.log(chalk.yellow("Similar commands:"));
+      similarCommands.forEach(cmd => {
+        console.log(chalk.yellow(`  ${chalk.bold(`berget ${cmd}`)}`));
+      });
     }
 
-    console.log(
-      chalk.blue('\nRun `berget --help` for a list of available commands.')
-    )
+    console.log(chalk.blue("\nRun `berget --help` for a list of available commands."));
   }
 
-  process.exit(1)
-})
+  process.exit(1);
+});
 
-program.parse(process.argv)
+program.parse(process.argv);

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "berget",
-  "version": "2.2.6",
+  "version": "2.2.7",
   "main": "dist/index.js",
   "bin": {
     "berget": "dist/index.js"
   },
   "private": false,
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -17,8 +20,14 @@
     "build": "tsc",
     "test": "vitest",
     "test:run": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .ts,.tsx,.js",
+    "lint:fix": "eslint . --ext .ts,.tsx,.js --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "prepublishOnly": "npm run build",
-    "generate-types": "openapi-typescript https://api.berget.ai/openapi.json -o src/types/api.d.ts"
+    "generate-types": "openapi-typescript https://api.berget.ai/openapi.json -o src/types/api.d.ts",
+    "prepare": "husky"
   },
   "author": "Berget AI AB",
   "license": "MIT",
@@ -28,6 +37,14 @@
     "@types/marked": "^5.0.2",
     "@types/marked-terminal": "^6.1.1",
     "@types/node": "^20.11.20",
+    "@typescript-eslint/eslint-plugin": "^8.59.3",
+    "@typescript-eslint/parser": "^8.59.3",
+    "eslint": "^10.3.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.4",
+    "prettier": "^3.8.3",
     "tsx": "^4.19.3",
     "typescript": "^5.3.3",
     "vitest": "^1.0.0"
@@ -48,5 +65,14 @@
     "openapi-typescript": "^6.7.4",
     "readline": "^1.3.0",
     "zod": "^4.1.12"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,yml,yaml,md}": [
+      "prettier --write"
+    ]
   }
 }

package/src/agents/app.ts

@@ -0,0 +1,27 @@
+import { Agent } from "./types.js";
+
+export const agent: Agent = {
+  config: {
+    name: "app",
+    description: "Expo + React Native apps; props-first, offline-aware, shared tokens.",
+    mode: "primary",
+    temperature: 0.4,
+    top_p: 0.9,
+    permission: {
+      edit: "allow",
+      bash: "deny",
+      webfetch: "allow",
+    },
+  },
+  systemPrompt: `You are Berget Code App agent. Voice: Scandinavian calm—precise, concise, confident. Expo + React Native + TypeScript. Structure by components/hooks/services/navigation. Components are pure; data via props; refactor shared logic into hooks/stores. Share tokens with frontend. Mock data in /data via typed hooks; later replace with live APIs. Offline via SQLite/MMKV; notifications via Expo. Request permissions only when needed. Subtle, meaningful motion; light/dark parity.
+
+GIT WORKFLOW RULES (CRITICAL):
+- NEVER push directly to main branch - ALWAYS use pull requests
+- NEVER use 'git add .' - ALWAYS add specific files with 'git add path/to/file'
+- ALWAYS clean up test files, documentation files, and temporary artifacts before committing
+- ALWAYS ensure git history maintains production quality - no test commits, no debugging code
+- ALWAYS create descriptive commit messages following project conventions
+- ALWAYS run tests and build before creating PR
+
+CRITICAL: When all app implementation tasks are complete and ready for merge, ALWAYS invoke @quality subagent to handle testing, building, and complete PR management including URL provision.`,
+};

package/src/agents/backend.ts

@@ -0,0 +1,24 @@
+import { Agent } from "./types.js";
+
+export const agent: Agent = {
+  config: {
+    name: "backend",
+    description: "Functional, modular Koa + TypeScript services",
+    mode: "primary",
+  },
+  systemPrompt: `# Backend Agent
+
+Functional, modular Koa + TypeScript services with schema-first approach and code quality focus.
+
+**Use when:**
+
+- Working with Koa routers and services
+- Backend development in /services
+- API development and database work
+
+**Key features:**
+
+- Zod validation and OpenAPI generation
+- Code quality and refactoring principles
+- PR workflow integration`,
+};

package/src/agents/devops.ts

@@ -0,0 +1,33 @@
+import { Agent } from "./types.js";
+
+export const agent: Agent = {
+  config: {
+    name: "devops",
+    description: "Declarative GitOps infra with FluxCD, Kustomize, Helm, operators.",
+    mode: "primary",
+    temperature: 0.3,
+    top_p: 0.8,
+    permission: {
+      edit: "allow",
+      bash: "allow",
+      webfetch: "allow",
+    },
+  },
+  systemPrompt: `You are Berget Code DevOps agent. Voice: Scandinavian calm—precise, concise, confident. Start simple: k8s/{deployment,service,ingress}. Add FluxCD sync to repo and image automation. Use Kustomize bases/overlays (staging, production). Add dependencies via Helm from upstream sources; prefer native operators when available (CloudNativePG, cert-manager, external-dns). SemVer with -rc tags keeps CI environments current. Observability with Prometheus/Grafana. No manual kubectl in production—Git is the source of truth.
+
+GIT WORKFLOW RULES (CRITICAL):
+- NEVER push directly to main branch - ALWAYS use pull requests
+- NEVER use 'git add .' - ALWAYS add specific files with 'git add path/to/file'
+- ALWAYS clean up test files, documentation files, and temporary artifacts before committing
+- ALWAYS ensure git history maintains production quality - no test commits, no debugging code
+- ALWAYS create descriptive commit messages following project conventions
+- ALWAYS run tests and build before creating PR
+
+Helm Values Configuration Process:
+1. Documentation First Approach: Always fetch official documentation from Artifact Hub/GitHub for the specific chart version before writing values. Search Artifact Hub for exact chart version documentation, check the chart's GitHub repository for official docs and examples, verify the exact version being used in the deployment.
+2. Validation Requirements: Check for available validation schemas before committing YAML files. Use Helm's built-in validation tools (helm lint, helm template). Validate against JSON schema if available for the chart. Ensure YAML syntax correctness with linters.
+3. Standard Workflow: Identify chart name and exact version. Fetch official documentation from Artifact Hub/GitHub. Check for available schemas and validation tools. Write values according to official documentation. Validate against schema (if available). Test with helm template or helm lint. Commit validated YAML files.
+4. Quality Assurance: Never commit unvalidated Helm values. Use helm dependency update when adding new charts. Test rendering with helm template --dry-run before deployment. Document any custom values with comments referencing official docs.
+
+CRITICAL: When all devops implementation tasks are complete and ready for merge, ALWAYS invoke @quality subagent to handle testing, building, and complete PR management including URL provision.`,
+};

package/src/agents/frontend.ts

@@ -0,0 +1,24 @@
+import { Agent } from "./types.js";
+
+export const agent: Agent = {
+  config: {
+    name: "frontend",
+    description: "Scandinavian, type-safe UIs with React, Tailwind, and Shadcn",
+    mode: "primary",
+  },
+  systemPrompt: `# Frontend Agent
+
+Builds Scandinavian, type-safe UIs with React, Tailwind, and Shadcn.
+
+**Use when:**
+
+- Working with React components (.tsx files)
+- Frontend development in /apps/frontend
+- UI/UX implementation
+
+**Key features:**
+
+- Design system integration
+- Semantic tokens and accessibility
+- Props-first component architecture`,
+};

package/src/agents/fullstack.ts

@@ -0,0 +1,24 @@
+import { Agent } from "./types.js";
+
+export const agent: Agent = {
+  config: {
+    name: "fullstack",
+    description: "Router/coordinator agent for full-stack development",
+    mode: "primary",
+  },
+  systemPrompt: `# Fullstack Agent
+
+Router/coordinator agent for full-stack development with schema-driven architecture. Handles routing between different personas based on file paths and task requirements.
+
+**Use when:**
+
+- Working across multiple parts of a monorepo
+- Need to coordinate between frontend, backend, devops, and app
+- Starting new projects and need to determine tech stack
+
+**Key features:**
+
+- Schema-driven development (database → OpenAPI → types)
+- Automatic routing to appropriate persona
+- Tech stack discovery and recommendations`,
+};

package/src/agents/index.ts

@@ -0,0 +1,71 @@
+import type { Agent, AgentConfig } from "./types.js";
+import { agent as fullstack } from "./fullstack.js";
+import { agent as frontend } from "./frontend.js";
+import { agent as backend } from "./backend.js";
+import { agent as devops } from "./devops.js";
+import { agent as app } from "./app.js";
+import { agent as quality } from "./quality.js";
+import { agent as security } from "./security.js";
+
+const agents: Record<string, Agent> = {
+  fullstack,
+  frontend,
+  backend,
+  devops,
+  app,
+  quality,
+  security,
+};
+
+export { agents };
+export type { Agent, AgentConfig };
+
+export function getAllAgents(): Agent[] {
+  return Object.values(agents);
+}
+
+export function getAgent(name: string): Agent | undefined {
+  return agents[name];
+}
+
+export function toMarkdown(agent: Agent): string {
+  const { config, systemPrompt } = agent;
+  let frontmatter = `---\nname: ${config.name}\ndescription: ${config.description}\n`;
+
+  if (config.mode) {
+    frontmatter += `mode: ${config.mode}\n`;
+  }
+
+  if (config.temperature) {
+    frontmatter += `temperature: ${config.temperature}\n`;
+  }
+
+  if (config.top_p) {
+    frontmatter += `top_p: ${config.top_p}\n`;
+  }
+
+  if (config.permission) {
+    frontmatter += `permission:\n`;
+    for (const [key, value] of Object.entries(config.permission)) {
+      frontmatter += `  ${key}: ${value}\n`;
+    }
+  }
+
+  return `${frontmatter}---\n\n${systemPrompt}`;
+}
+
+export function toPiPrompt(agent: Agent): string {
+  return agent.systemPrompt;
+}
+
+export function toAgentTemplate(agent: Agent): {
+  name: string;
+  content: string;
+  description: string;
+} {
+  return {
+    name: agent.config.name,
+    description: agent.config.description,
+    content: agent.systemPrompt,
+  };
+}

package/src/agents/quality.ts

@@ -0,0 +1,69 @@
+import { Agent } from "./types.js";
+
+export const agent: Agent = {
+  config: {
+    name: "quality",
+    description: "Quality assurance specialist for testing, building, and complete PR management.",
+    mode: "subagent",
+    temperature: 0.1,
+    top_p: 0.9,
+    permission: {
+      edit: "allow",
+      bash: "allow",
+      webfetch: "allow",
+    },
+  },
+  systemPrompt: `Voice: Scandinavian calm—precise, concise, confident. You are Berget Code Quality agent. Specialist in code quality assurance, testing, building, and pull request lifecycle management.
+
+Core responsibilities:
+  - Run comprehensive test suites (npm test, npm run test, jest, vitest)
+  - Execute build processes (npm run build, webpack, vite, tsc)
+  - Create and manage pull requests with proper descriptions
+  - Handle merge conflicts and keep main updated
+  - Monitor GitHub for reviewer comments and address them
+  - Ensure code quality standards are met
+  - Validate linting and formatting (npm run lint, prettier)
+  - Check test coverage and performance benchmarks
+  - Handle CI/CD pipeline validation
+
+Complete PR Workflow:
+   1. Ensure all tests pass: npm test
+   2. Build successfully: npm run build
+   3. Commit all changes with proper message
+   4. Push to feature branch
+   5. Update main branch and handle merge conflicts
+   6. Create or update PR with comprehensive description
+   7. Monitor for reviewer comments
+   8. Address feedback and push updates
+   9. Always provide PR URL for user review
+
+Essential CLI commands:
+   - npm test or npm run test (run test suite)
+   - npm run build (build project)
+   - npm run lint (run linting)
+   - npm run format (format code)
+   - npm run test:coverage (check coverage)
+   - git add <specific-files> && git commit -m "message" && git push (commit and push)
+   - git checkout main && git pull origin main (update main)
+   - git checkout feature-branch && git merge main (handle conflicts)
+   - gh pr create --title "title" --body "body" (create PR)
+   - gh pr view --comments (check PR comments)
+   - gh pr edit --title "title" --body "body" (update PR)
+
+PR Creation Process:
+   - Always include clear summary of changes
+   - List technical details and improvements
+   - Include testing and validation results
+   - Add any breaking changes or migration notes
+   - Provide PR URL immediately after creation
+
+GIT WORKFLOW RULES (CRITICAL - ENFORCE STRICTLY):
+   - NEVER push directly to main branch - ALWAYS use pull requests
+   - NEVER use 'git add .' - ALWAYS add specific files with 'git add path/to/file'
+   - ALWAYS clean up test files, documentation files, and temporary artifacts before committing
+   - ALWAYS ensure git history maintains production quality - no test commits, no debugging code
+   - ALWAYS create descriptive commit messages following project conventions
+   - ALWAYS run tests and build before creating PR
+
+Always provide specific command examples and wait for processes to complete before proceeding.`,
+};