Hi-AI

Instructions

Implementation Reference

• src/tools/convention/applyQualityRules.ts:59-119 (handler)

  The main handler function that takes scope and optional language arguments, selects applicable quality rules, constructs a result object, and returns formatted content describing the applied rules.

  export async function applyQualityRules(args: { scope: string; language?: string }): Promise<ToolResult> {
    const { scope, language: contextLanguage = 'general' } = args;
    
    const applicableRules = [];
    
    if (scope === 'naming' || scope === 'all') {
      applicableRules.push({
        category: 'Naming Conventions',
        rules: QUALITY_RULES.NAMING
      });
    }
    
    if (scope === 'structure' || scope === 'all') {
      applicableRules.push({
        category: 'Code Structure',
        rules: QUALITY_RULES.STRUCTURE
      });
    }
    
    if (scope === 'typescript' || scope === 'all') {
      applicableRules.push({
        category: 'TypeScript Guidelines',
        rules: QUALITY_RULES.ANTIPATTERNS.typescript
      });
    }
    
    if (scope === 'react' || scope === 'all') {
      applicableRules.push({
        category: 'React Guidelines',
        rules: QUALITY_RULES.ANTIPATTERNS.react
      });
    }
    
    if (scope === 'accessibility' || scope === 'all') {
      applicableRules.push({
        category: 'Accessibility Guidelines',
        rules: [
          'Use semantic HTML elements',
          'Provide alt text for images',
          'Ensure keyboard navigation',
          'Maintain color contrast ratios',
          'Use ARIA labels when needed'
        ]
      });
    }
    
    const qualityRulesResult = {
      action: 'apply_quality_rules',
      scope,
      language: contextLanguage,
      rules: applicableRules,
      asyncStates: QUALITY_RULES.ASYNC_STATES,
      stateManagement: QUALITY_RULES.STATE_MANAGEMENT,
      status: 'success'
    };
    
    const rulesSummary = applicableRules.map(r => `${r.category}: ${Array.isArray(r.rules) ? r.rules.length + ' rules' : Object.keys(r.rules).length + ' items'}`).join(', ');
    return {
      content: [{ type: 'text', text: `Scope: ${scope}\nLanguage: ${contextLanguage}\nRules Applied: ${rulesSummary}\n\nAsync States: ${QUALITY_RULES.ASYNC_STATES.join(', ')}\n\nState Mgmt:\n${Object.entries(QUALITY_RULES.STATE_MANAGEMENT).map(([k, v]) => `- ${k}: ${v}`).join('\n')}` }]
    };
  }

• src/tools/convention/applyQualityRules.ts:38-57 (schema)

  The ToolDefinition export that specifies the tool's name, description, input schema (with scope required and language optional), and annotations indicating usage hints.

  export const applyQualityRulesDefinition: ToolDefinition = {
    name: 'apply_quality_rules',
    description: '규칙 적용|표준 적용|apply rules|apply standards|follow conventions|적용해 - Apply quality rules',
    inputSchema: {
      type: 'object',
      properties: {
        scope: { type: 'string', description: 'Application scope', enum: ['naming', 'structure', 'typescript', 'react', 'accessibility', 'all'] },
        language: { type: 'string', description: 'Programming language context', enum: ['javascript', 'typescript', 'react', 'vue', 'general'] }
      },
      required: ['scope']
    },
    annotations: {
      title: 'Apply Quality Rules',
      audience: ['user', 'assistant'],
      readOnlyHint: true,
      destructiveHint: false,
      idempotentHint: true,
      openWorldHint: false
    }
  };

• src/index.ts:88-145 (registration)

  The tools array registration where applyQualityRulesDefinition is included among other tool definitions for the ListTools endpoint.

  const tools = [
    // Core Utilities (2)
    getCurrentTimeDefinition,
    previewUiAsciiDefinition,
  
    // Memory Management - Basic (6)
    saveMemoryDefinition,
    recallMemoryDefinition,
    updateMemoryDefinition,
    deleteMemoryDefinition,
    listMemoriesDefinition,
    prioritizeMemoryDefinition,
  
    // Memory Management - Graph (4) - v2.0 NEW
    linkMemoriesDefinition,
    getMemoryGraphDefinition,
    searchMemoriesAdvancedDefinition,
    createMemoryTimelineDefinition,
  
    // Memory Management - Session Context (1) - v2.1 NEW
    getSessionContextDefinition,
  
    // Code Analysis - Semantic (2)
    findSymbolDefinition,
    findReferencesDefinition,
  
    // Code Analysis - Advanced (1) - v2.0 NEW
    analyzeDependencyGraphDefinition,
  
    // Code Quality (6)
    getCodingGuideDefinition,
    applyQualityRulesDefinition,
    validateCodeQualityDefinition,
    analyzeComplexityDefinition,
    checkCouplingCohesionDefinition,
    suggestImprovementsDefinition,
  
    // Thinking & Planning (8)
    createThinkingChainDefinition,
    analyzeProblemDefinition,
    stepByStepAnalysisDefinition,
    formatAsPlanDefinition,
    generatePrdDefinition,
    createUserStoriesDefinition,
    analyzeRequirementsDefinition,
    featureRoadmapDefinition,
  
    // Prompt Engineering (3)
    enhancePromptDefinition,
    analyzePromptDefinition,
    enhancePromptGeminiDefinition,
  
    // Reasoning (1)
    applyReasoningFrameworkDefinition,
  
    // Analytics (1) - v2.0 NEW
    getUsageAnalyticsDefinition
  ];

• src/index.ts:155-212 (registration)

  The toolHandlers object registration mapping 'apply_quality_rules' to the applyQualityRules handler function for dynamic tool dispatch.

  const toolHandlers: Record<string, ToolHandler> = {
    // Time & UI
    'get_current_time': getCurrentTime,
    'preview_ui_ascii': previewUiAscii,
  
    // Memory - Basic
    'save_memory': saveMemory,
    'recall_memory': recallMemory,
    'update_memory': updateMemory,
    'delete_memory': deleteMemory,
    'list_memories': listMemories,
    'prioritize_memory': prioritizeMemory,
  
    // Memory - Graph (v2.0 NEW)
    'link_memories': linkMemories,
    'get_memory_graph': getMemoryGraph,
    'search_memories_advanced': searchMemoriesAdvanced,
    'create_memory_timeline': createMemoryTimeline,
  
    // Memory - Session Context (v2.1 NEW)
    'get_session_context': getSessionContext,
  
    // Code Analysis
    'find_symbol': findSymbol,
    'find_references': findReferences,
    'analyze_dependency_graph': analyzeDependencyGraph,
  
    // Code Quality
    'get_coding_guide': getCodingGuide,
    'apply_quality_rules': applyQualityRules,
    'validate_code_quality': validateCodeQuality,
    'analyze_complexity': analyzeComplexity,
    'check_coupling_cohesion': checkCouplingCohesion,
    'suggest_improvements': suggestImprovements,
  
    // Thinking
    'create_thinking_chain': createThinkingChain,
    'analyze_problem': analyzeProblem,
    'step_by_step_analysis': stepByStepAnalysis,
    'format_as_plan': formatAsPlan,
  
    // Planning
    'generate_prd': generatePrd,
    'create_user_stories': createUserStories,
    'analyze_requirements': analyzeRequirements,
    'feature_roadmap': featureRoadmap,
  
    // Prompt
    'enhance_prompt': enhancePrompt,
    'analyze_prompt': analyzePrompt,
    'enhance_prompt_gemini': enhancePromptGemini,
  
    // Reasoning
    'apply_reasoning_framework': applyReasoningFramework,
  
    // Analytics (v2.0 NEW)
    'get_usage_analytics': getUsageAnalytics
  };

• src/tools/convention/applyQualityRules.ts:5-36 (helper)

  The central QUALITY_RULES constant object defining all naming conventions, structure rules, antipatterns, async states, and state management guidelines used by the handler.

  // Code Quality Standards
  const QUALITY_RULES = {
    NAMING: {
      variables: 'nouns (userList, userData)',
      functions: 'verb+noun (fetchData, updateUser)',
      events: 'handle prefix (handleClick, handleSubmit)',
      booleans: 'is/has/can prefix (isLoading, hasError, canEdit)',
      constants: 'UPPER_SNAKE_CASE (MAX_RETRY_COUNT, API_TIMEOUT)',
      components: 'PascalCase (UserProfile, HeaderSection)',
      hooks: 'use prefix (useUserData, useAuth)'
    },
    STRUCTURE: {
      componentOrder: ['State & Refs', 'Custom Hooks', 'Event Handlers', 'Effects', 'Early returns', 'Main return JSX'],
      functionMaxLines: 20,
      componentMaxLines: 50,
      maxNestingDepth: 3
    },
    ANTIPATTERNS: {
      typescript: ['any type usage', '@ts-ignore usage', 'as any casting'],
      react: ['dangerouslySetInnerHTML', 'props drilling (3+ levels)'],
      javascript: ['var usage', '== instead of ===', 'eval() usage'],
      css: ['!important abuse', 'inline style abuse']
    },
    ASYNC_STATES: ['data', 'isLoading', 'error'],
    STATE_MANAGEMENT: {
      simple: 'useState',
      complex: 'useReducer',
      globalUI: 'Context API',
      globalApp: 'Zustand',
      server: 'TanStack Query'
    }
  };