First-Mate CLI

What it does

First-Mate is a command-line tool that parses Go code into an in-memory code graph and provides structural queries and spec lookups. It helps engineers locate spec-to-code mappings, generate call graphs, find dead code, run analyses (lint, vet, race heuristics), and surface test/benchmark-related metrics.

When to use it

Use First-Mate in spec-driven Go projects that include SPECS.md, NOTES.md, TESTS.md or BENCHMARKS.md files. Typical scenarios: tracing which code implements a spec, generating call graphs for complex functions, finding untested or low-coverage functions, and running combined static analyses before large refactors.

What's included

• Scripts: none embedded in the SKILL (CLI expected to be in the repo)
• References: none listed
• Instructions: parse the code graph once per session (first-mate parse_tree), then run tools like call_graph, query_nodes, find_deadcode, run_analysis, run_tests and run_bench. The SKILL.md includes command examples for spec lookup (read_docs, find_spec), structural queries, and analysis workflows.

Compatible agents

Likely used by developer-focused agents and automation that can run CLI tooling: Copilot/Codex-style runners, local automation agents, and CI-based automation that can invoke binaries and parse outputs.