Reference
Actions Overview

Actions Reference

Complete reference for all HMS actions.

Overview

Actions define what a step does. Each action maps to specific tools in different IDEs.

Available Actions

analyze_code

Analyze existing code for patterns, issues, or information.

Use cases:

  • Bug investigation
  • Code review
  • Architecture analysis
  • Security audit

Parameters:

ParameterTypeDescription
filesstring[]Files to analyze
focusstringWhat to look for

Example:

{
  "id": "find_bugs",
  "name": "Find bugs in authentication",
  "action": "analyze_code",
  "parameters": {
    "files": ["src/auth/**/*.ts"],
    "focus": "security vulnerabilities, edge cases"
  }
}

IDE Mappings:

IDETools Used
ClaudeRead, Grep, Glob
Cursor@file reference
Codexanalyze_code() function

edit_file

Edit a single file.

Use cases:

  • Bug fixes
  • Small refactors
  • Configuration changes

Parameters:

ParameterTypeDescription
filesstring[]File(s) to edit (first used)
focusstringWhat changes to make

Example:

{
  "id": "fix_bug",
  "name": "Fix authentication bug",
  "action": "edit_file",
  "parameters": {
    "files": ["src/auth/login.ts"],
    "focus": "fix password validation"
  }
}

IDE Mappings:

IDETools Used
ClaudeEdit
CursorInline diff
Codexedit_file() function

edit_files

Edit multiple files together.

Use cases:

  • Refactoring across files
  • Feature implementation
  • Bulk updates

Parameters:

ParameterTypeDescription
filesstring[]Files to edit
focusstringWhat changes to make

Example:

{
  "id": "refactor_api",
  "name": "Refactor API layer",
  "action": "edit_files",
  "parameters": {
    "files": [
      "src/api/users.ts",
      "src/api/auth.ts",
      "src/api/types.ts"
    ],
    "focus": "use consistent error handling"
  }
}

IDE Mappings:

IDETools Used
ClaudeEdit + Task (sub-agent)
CursorComposer multi-file
Codexedit_files() function

generate_code

Generate new code from scratch.

Use cases:

  • New features
  • New files
  • Boilerplate generation

Parameters:

ParameterTypeDescription
filesstring[]Target file paths
focusstringWhat to generate

Example:

{
  "id": "create_api",
  "name": "Create user API",
  "action": "generate_code",
  "parameters": {
    "files": ["src/api/users.ts"],
    "focus": "CRUD endpoints for user management"
  }
}

IDE Mappings:

IDETools Used
ClaudeWrite
CursorNew file generation
Codexgenerate_code() function

generate_tests

Generate test files for existing code.

Use cases:

  • Unit tests
  • Integration tests
  • Test coverage improvement

Parameters:

ParameterTypeDescription
filesstring[]Files to test
test_frameworkstringTesting framework
coverage_targetnumberTarget coverage %

Example:

{
  "id": "write_tests",
  "name": "Write unit tests",
  "action": "generate_tests",
  "parameters": {
    "files": ["src/auth/login.ts"],
    "test_framework": "Jest",
    "coverage_target": 80
  }
}

IDE Mappings:

IDETools Used
ClaudeWrite + Bash
CursorTest file generation
Codexgenerate_tests() function

execute_command

Run a shell command.

Use cases:

  • Running tests
  • Build processes
  • Linting
  • Deployment scripts

Parameters:

ParameterTypeDescription
commandstringShell command to run

Example:

{
  "id": "run_tests",
  "name": "Run test suite",
  "action": "execute_command",
  "parameters": {
    "command": "npm test -- --coverage"
  }
}

IDE Mappings:

IDETools Used
ClaudeBash
CursorTerminal
Codexexecute_command() function
⚠️

Commands run in the IDE's environment. Ensure they're safe and don't require user input.


search_references

Search for code references, usages, or patterns.

Use cases:

  • Finding usages
  • Impact analysis
  • Code discovery

Parameters:

ParameterTypeDescription
focusstringWhat to search for
filesstring[]Scope of search

Example:

{
  "id": "find_usages",
  "name": "Find all usages of deprecated API",
  "action": "search_references",
  "parameters": {
    "focus": "deprecatedFunction",
    "files": ["src/**/*.ts"]
  }
}

IDE Mappings:

IDETools Used
ClaudeGrep, Glob
Cursor@codebase search
Codexsearch_references() function

design_architecture

Create architectural designs and documentation.

Use cases:

  • System design
  • API design
  • Documentation
  • Planning

Parameters:

ParameterTypeDescription
focusstringWhat to design
filesstring[]Output files

Example:

{
  "id": "design_system",
  "name": "Design authentication system",
  "action": "design_architecture",
  "parameters": {
    "focus": "OAuth2 flow with JWT tokens",
    "files": ["docs/auth-design.md"]
  }
}

IDE Mappings:

IDETools Used
ClaudeRead + Write
CursorDocumentation generation
Codexdesign_architecture() function

review_and_commit

Review changes and commit to version control.

Use cases:

  • Final review
  • Commit changes
  • PR preparation

Parameters:

ParameterTypeDescription
focusstringReview focus

Example:

{
  "id": "commit_changes",
  "name": "Review and commit",
  "action": "review_and_commit",
  "parameters": {
    "focus": "ensure no debug code, proper commit message"
  }
}

IDE Mappings:

IDETools Used
ClaudeBash (git)
CursorGit integration
Codexreview_and_commit() function

Action Selection Guide

What do you need to do?

├── Read/understand code → analyze_code

├── Modify code
│   ├── Single file → edit_file
│   └── Multiple files → edit_files

├── Create new code
│   ├── Application code → generate_code
│   └── Test code → generate_tests

├── Run something → execute_command

├── Find code → search_references

├── Plan/document → design_architecture

└── Finalize → review_and_commit

Combining Actions

Actions are most powerful when combined in workflows:

{
  "steps": [
    { "id": "analyze", "action": "analyze_code" },
    { "id": "design", "action": "design_architecture", "depends_on": ["analyze"] },
    { "id": "implement", "action": "edit_files", "depends_on": ["design"] },
    { "id": "test", "action": "generate_tests", "depends_on": ["implement"] },
    { "id": "verify", "action": "execute_command", "depends_on": ["test"] },
    { "id": "commit", "action": "review_and_commit", "depends_on": ["verify"] }
  ]
}

Related