# Eng Go CLI Developer

> Build reliable Go CLI commands with stable outputs and tests. Use when this capability is needed.

- Skill: `tomevault-io/eng-go-cli-developer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/eng-go-cli-developer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/eng-go-cli-developer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/eng-go-cli-developer

---


# Go CLI Developer

## Repo anchors (autocodex)
- CLI_PATH: `cmd/autocodex/`
- INTERNAL_PATH: `internal/`
- TEST_COMMANDS
  - `go test ./...`
  - `go vet ./...`
  - `gofmt -w $(rg --files -g '*.go')`

## When to use
- Adding or modifying CLI commands or flags.

## Preconditions
- CLI goals and expected workflows are defined.
- If contracts must change, STOP and update contracts first.

## Inputs to confirm
- Command structure and flags
- Expected outputs (human vs JSON)
- Exit code semantics

## Required artifacts
- Deterministic CLI behavior
- Help text or examples for new commands
- Tests for parsing or core flows

## Quick path
- Define flags and output format.
- Keep CLI thin; move logic to packages.
- Add tests.

## Steps
1) Implement CLI parsing.
2) Delegate to internal packages.
3) Ensure stdout is for output, stderr for logs/errors.
4) Add tests for parsing/output.

## Failure modes and responses
- **Unclear UX**: ask for expected CLI workflow.
- **Unstable output**: add JSON output and tests.

## Definition of done
- CLI is deterministic, documented, and tested.

## Example (minimal)
- **Command**: `autocodex plugins --action list`
- **Output**: JSON list of plugins.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/oodaris) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->