berget 2.2.6 → 2.2.8

package/src/agents/frontend.ts

@@ -0,0 +1,24 @@
+import { Agent } from './types.js';
+
+export const agent: Agent = {
+  config: {
+    description: 'Scandinavian, type-safe UIs with React, Tailwind, and Shadcn',
+    mode: 'primary',
+    name: 'frontend',
+  },
+  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: {
+    description: 'Router/coordinator agent for full-stack development',
+    mode: 'primary',
+    name: 'fullstack',
+  },
+  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,73 @@
+import type { Agent } from './types.js';
+
+import { agent as app } from './app.js';
+import { agent as backend } from './backend.js';
+import { agent as devops } from './devops.js';
+import { agent as frontend } from './frontend.js';
+import { agent as fullstack } from './fullstack.js';
+import { agent as quality } from './quality.js';
+import { agent as security } from './security.js';
+
+const agents: Record<string, Agent> = {
+  app,
+  backend,
+  devops,
+  frontend,
+  fullstack,
+  quality,
+  security,
+};
+
+export { agents };
+
+export function getAgent(name: string): Agent | undefined {
+  return agents[name];
+}
+
+export function getAllAgents(): Agent[] {
+  return Object.values(agents);
+}
+
+export function toAgentTemplate(agent: Agent): {
+  content: string;
+  description: string;
+  name: string;
+} {
+  return {
+    content: agent.systemPrompt,
+    description: agent.config.description,
+    name: agent.config.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 { type Agent, type AgentConfig } from './types.js';

package/src/agents/quality.ts

@@ -0,0 +1,69 @@
+import { Agent } from './types.js';
+
+export const agent: Agent = {
+  config: {
+    description: 'Quality assurance specialist for testing, building, and complete PR management.',
+    mode: 'subagent',
+    name: 'quality',
+    permission: {
+      bash: 'allow',
+      edit: 'allow',
+      webfetch: 'allow',
+    },
+    temperature: 0.1,
+    top_p: 0.9,
+  },
+  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.`,
+};

package/src/agents/security.ts

@@ -0,0 +1,26 @@
+import { Agent } from './types.js';
+
+export const agent: Agent = {
+  config: {
+    description:
+      'Security specialist for pentesting, OWASP compliance, and vulnerability assessments.',
+    mode: 'subagent',
+    name: 'security',
+    permission: {
+      bash: 'allow',
+      edit: 'deny',
+      webfetch: 'allow',
+    },
+    temperature: 0.2,
+    top_p: 0.8,
+  },
+  systemPrompt: `Voice: Scandinavian calm—precise, concise, confident. You are Berget Code Security agent. Expert in application security, penetration testing, and OWASP standards. Core responsibilities: Conduct security assessments and penetration tests, Validate OWASP Top 10 compliance, Review code for security vulnerabilities, Implement security headers and Content Security Policy (CSP), Audit API security, Check for sensitive data exposure, Validate input sanitization and output encoding, Assess dependency security and supply chain risks. Tools and techniques: OWASP ZAP, Burp Suite, security linters, dependency scanners, manual code review. Always provide specific, actionable security recommendations with priority levels.
+
+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`,
+};

package/src/agents/types.ts

@@ -0,0 +1,17 @@
+export interface Agent {
+  config: AgentConfig;
+  systemPrompt: string;
+}
+
+export interface AgentConfig {
+  description: string;
+  mode?: 'primary' | 'subagent';
+  name: string;
+  permission?: {
+    bash?: string;
+    edit?: string;
+    webfetch?: string;
+  };
+  temperature?: number;
+  top_p?: number;
+}