terraform-provider-f5xc: Skill for Claude Code

GitHub Issue-First Workflow

All development work follows this strict issue-first workflow. Never start coding without an issue.

Workflow Overview

1. Issue First → Create or identify GitHub issue
2. Branch → Create feature branch linked to issue
3. Implement → Make changes on feature branch
4. Validate → Test thoroughly until 100% working
5. PR → Open pull request referencing issue
6. Merge & Cleanup → Merge, delete branches, close issue

Phase 1: Issue First

Before any code changes, ensure a GitHub issue exists.

Creating a new issue:

gh issue create --title "Brief description" --body "Detailed description of the problem or feature"

Finding existing issues:

gh issue list
gh issue view <number>

Issue requirements:

• Clear title describing the change
• Body explaining the problem/feature and acceptance criteria
• Labels if applicable (bug, enhancement, etc.)

Note the issue number (e.g., #42) for branch naming.

Phase 2: Feature Branch

Create a branch that links to the issue. Branch naming convention: <issue-number>-<short-description>

# Ensure main is up to date
git checkout main
git pull origin main

# Create and switch to feature branch
git checkout -b 42-fix-login-timeout

Push the branch to establish remote tracking:

git push -u origin 42-fix-login-timeout

Phase 3: Implementation

Make changes on the feature branch. Commit frequently with meaningful messages referencing the issue:

git add <files>
git commit -m "Add timeout configuration option (#42)"

Commit message guidelines:

• Reference the issue number in commits
• Use present tense ("Add feature" not "Added feature")
• Keep first line under 72 characters

Phase 4: Validation Loop

This is critical. Do not proceed until the implementation is 100% validated.

Validation checklist:

1. Run existing tests: npm test, pytest, go test, etc.
2. Add new tests covering the change
3. Manual testing of the specific functionality
4. Check for regressions
5. Lint and format code