aix: Instructions file for Claude Code

Agent Instructions for aix

aix is a unified Go CLI for managing AI coding assistant configurations across platforms (Claude Code, OpenCode, Codex, Gemini CLI). See docs/adr/001-unified-agent-cli.md for full architecture.

Development Commands

Build

go build ./cmd/aix                      # Build CLI binary
go build ./...                          # Build all packages

Test

go test ./...                           # All tests
go test ./internal/skill/...            # Single package
go test -run TestSkillParser ./...      # Single test by name
go test -v -run TestSkillParser/valid ./...  # Subtest by name
go test -race ./...                     # With race detection
go test -cover ./...                    # With coverage
go test -coverprofile=coverage.out ./... && go tool cover -html=coverage.out

Lint & Format

go fmt ./...                            # Format code
goimports -w .                          # Organize imports
go vet ./...                            # Static analysis
golangci-lint run                       # Full linting suite

Code Style

Imports

Group imports in this order, separated by blank lines:

import (
    // Standard library
    "context"
    "fmt"
    "strings"

    // External dependencies
    "github.com/spf13/cobra"
    "gopkg.in/yaml.v3"

    // Internal packages
    "github.com/thoreinstein/aix/internal/config"
    "github.com/thoreinstein/aix/internal/platform"
)

Naming Conventions

Element	Convention	Example
Packages	lowercase, single word	platform, skill, mcp
Interfaces	noun or -er suffix	Platform, Validator, Parser
Constructors	New prefix	NewValidator(strict bool)
Errors	Err prefix	ErrMissingName, ErrInvalidToolSyntax
Test files	_test.go suffix	validator_test.go
Test functions	Test prefix	TestValidator_Validate