Custom Categories

// OLD: Model name creates distributional bias
task(agent="gpt-5.2", prompt="...")
// Model "knows" its limitations, may underperform

task(agent="claude-opus-4-6", prompt="...")
// Different self-perception affects behavior

// NEW: Category describes INTENT, not implementation
task(category="ultrabrain", prompt="...")
// Agent thinks: "Think strategically"

task(category="visual-engineering", prompt="...")
// Agent thinks: "Design beautifully"

task(category="quick", prompt="...")
// Agent thinks: "Just get it done fast"

{
  "categories": {
    "korean-writer": {
      "model": "google/gemini-3-flash",
      "temperature": 0.5,
      "description": "Technical writer for Korean documentation",
      "prompt_append": "You are a Korean technical writer. Maintain a friendly and clear tone. Use appropriate honorifics and technical terminology."
    }
  }
}

task(
  category="korean-writer",
  prompt="Write API documentation for the user authentication endpoints"
)

{
  "categories": {
    "database": {
      "model": "openai/gpt-5.2",
      "variant": "high",
      "temperature": 0.1,
      "description": "Database operations and query optimization specialist",
      "prompt_append": "You are a database expert specializing in PostgreSQL. Focus on:
- Query performance and indexing strategies
- Transaction safety and ACID compliance
- Preventing N+1 queries
- Using EXPLAIN ANALYZE before optimizations
- Data migration safety (always test rollback)

NEVER make destructive changes without explicit user approval."
    }
  }
}

task(
  category="database",
  prompt="Optimize the slow user query in UserService. Current query takes 2.5s on 100k records."
)

{
  "categories": {
    "security-audit": {
      "model": "openai/gpt-5.3-codex",
      "variant": "xhigh",
      "temperature": 0.0,
      "description": "Security vulnerability scanner and auditor",
      "prompt_append": "You are a security auditor. Your job is to find vulnerabilities:

Check for:
- SQL injection risks
- XSS vulnerabilities
- CSRF protection
- Authentication/authorization bugs
- Secrets in code
- Insecure dependencies

Output:
- Severity (CRITICAL/HIGH/MEDIUM/LOW)
- Exploitability assessment
- Remediation steps with code examples

Be thorough. False positives are acceptable; false negatives are not.",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

task(
  category="security-audit",
  prompt="Audit the authentication system in src/auth/ for vulnerabilities"
)

{
  "categories": {
    "git": {
      "model": "opencode/gpt-5-nano",
      "temperature": 0.0,
      "description": "All git operations",
      "prompt_append": "Focus on:
- Atomic commits (one logical change per commit)
- Clear, concise commit messages
- Safe operations (never force push to main/master)
- Preserving commit history when possible

Follow the project's commit message style detected from git log."
    }
  }
}

task(
  category="git",
  load_skills=["git-master"],
  prompt="Create atomic commits for these changes"
)

{
  "categories": {
    "test-writer": {
      "model": "anthropic/claude-sonnet-4-6",
      "temperature": 0.3,
      "description": "Unit and integration test specialist",
      "prompt_append": "You are a test-driven development expert.

Test Philosophy:
- Tests should be readable by non-developers
- One assertion per test (focused)
- Test behavior, not implementation
- Use Given/When/Then structure
- Mock external dependencies

Coverage targets:
- Critical paths: 100%
- Business logic: 90%
- Utilities: 80%
- UI components: 70%

Always run tests after writing to verify they pass."
    }
  }
}

task(
  category="test-writer",
  prompt="Write comprehensive tests for the payment processing service"
)

{
  "categories": {
    "code-review": {
      "model": "openai/gpt-5.2",
      "variant": "high",
      "temperature": 0.2,
      "description": "Code review and quality assurance",
      "prompt_append": "You are a senior code reviewer. Review for:

**Architecture:**
- Separation of concerns
- SOLID principles
- Design patterns (appropriate vs over-engineered)

**Code Quality:**
- Readability and maintainability
- Performance implications
- Error handling completeness
- Edge case coverage

**Best Practices:**
- Framework/library conventions
- Security considerations
- Accessibility (for UI code)

**Output Format:**
✅ Approved with minor suggestions
⚠️ Needs changes (list specific issues)
❌ Requires major revision (explain why)

Be constructive. Praise good patterns. Explain the 'why' behind suggestions.",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

task(
  category="code-review",
  prompt="Review the PR changes in src/services/payment/"
)

{
  "categories": {
    "deep-reasoning": {
      "model": "anthropic/claude-opus-4-6",
      "thinking": {
        "type": "enabled",
        "budgetTokens": 32000
      },
      "description": "Extended thinking for complex problems",
      "tools": {
        "websearch_web_search_exa": false
      }
    }
  }
}

{
  "categories": {
    "visual-engineering": {
      "model": "openai/gpt-5.2",
      "temperature": 0.8,
      "prompt_append": "Emphasize accessibility (WCAG 2.1 AA) and performance (Core Web Vitals)."
    },
    
    "quick": {
      "model": "opencode/gpt-5-nano",
      "temperature": 0.0
    }
  }
}

{
  "disabled_categories": ["ultrabrain", "artistry"]
}

task(category="deep", prompt="Fix this")

task(
  category="deep",
  prompt=`
TASK: Fix mobile layout breaking issue in LoginButton component

CONTEXT:
- File: src/components/LoginButton.tsx
- Using Tailwind CSS
- Breakpoint: md (768px)

MUST DO:
- Change flex-direction at md: breakpoint
- Preserve desktop layout exactly
- Test on mobile viewport

MUST NOT DO:
- Modify existing desktop styles
- Change button colors/fonts
- Add new dependencies

EXPECTED:
- Buttons stack vertically on mobile (<768px)
- Buttons remain horizontal on desktop (≥768px)
- All tests pass
`
)

// Fire multiple category tasks in parallel
task(category="deep", prompt="...", run_in_background=true)
task(category="test-writer", prompt="...", run_in_background=true)
task(category="code-review", prompt="...", run_in_background=true)

// Agent sees this in tool description:
Available categories:
- visual-engineering: Frontend, UI/UX, design...
- ultrabrain: Deep logical reasoning...
- deep: Autonomous problem-solving...
- korean-writer: Technical writer for Korean docs... // Your custom category
- ...

{
  "categories": {
    "backend": {
      "model": "openai/gpt-5.3-codex",
      "description": "Backend API development"
    },
    "frontend": {
      "model": "google/gemini-3-pro",
      "description": "Frontend UI development"
    },
    "testing": {
      "model": "anthropic/claude-sonnet-4-6",
      "description": "Test creation and QA"
    }
  }
}

// Parallel execution
task(category="backend", prompt="...", run_in_background=true)
task(category="frontend", prompt="...", run_in_background=true)
task(category="testing", prompt="...", run_in_background=true)

{
  "categories": {
    "premium": {
      "model": "anthropic/claude-opus-4-6",
      "variant": "max",
      "description": "For critical, complex work"
    },
    "standard": {
      "model": "anthropic/claude-sonnet-4-6",
      "description": "For regular development"
    },
    "economy": {
      "model": "opencode/gpt-5-nano",
      "description": "For simple, repetitive tasks"
    }
  }
}

{
  "categories": {
    "korean-docs": {
      "model": "google/gemini-3-flash",
      "prompt_append": "Write in Korean. Use formal register."
    },
    "japanese-docs": {
      "model": "google/gemini-3-flash",
      "prompt_append": "Write in Japanese. Use desu/masu form."
    },
    "english-docs": {
      "model": "kimi-for-coding/k2p5",
      "prompt_append": "Write in English. Technical but accessible."
    }
  }
}