alpacalyzer-algo-trader: Command for Claude Code

Start Issue Command

Start work on a GitHub issue.

Usage

/start-issue <issue_number>

Arguments:

• issue_number: The GitHub issue number to work on

Argument Indexing

• Claude Code: Use $1 for the first argument (issue number)
• OpenCode: Use $ARGUMENTS to get all arguments

Steps

0. Preflight Check

Run issue-preflight.sh to validate the issue is ready:

bash scripts/issue-preflight.sh <issue_number>

If it exits non-zero, report the block reason from the JSON output and stop. Do NOT proceed with any further steps if preflight fails.

1. Get Repo Info

git remote get-url origin

Parse owner and repo name from the output.

2. Fetch Issue

Use gh CLI to fetch the issue:

gh issue view <issue_number> --repo <owner>/<repo>

3. Verify/Create Branch

Check current branch:

git branch --show-current

If not on correct branch, create one:

git checkout -b feature/issue-<issue_number>-<short-description>

Branch naming: feature/issue-{issue_number}-{short-description}

4. Create Plan File

Create docs/plans/_PLAN_issue-{issue_number}.md with:

# Plan: {issue_title}

## Issue
#{issue_number}

## Acceptance Criteria
- [ ]

## Tasks
- [ ]

## Notes

5. Scaffold Test File

Create test file in tests/:

tests/test_issue_{issue_number}.py

With basic test structure:

import pytest

def test_placeholder():
    """Placeholder test for issue #{issue_number}"""
    assert True

6. Verify Tests Run

uv run pytest tests/test_issue_{issue_number}.py -v

7. Trigger code-review

Once done, call code-review sub-agent and enter in to a review - fix loop until review states PR is ready.

Notes

• This command is for starting NEW work on an issue
• If work is already in progress, skip this command
• Ensure you're on the correct branch before starting