trace

TRACE skill

TRACE stands for Test Requirements Against Code & Execution.

This package contains:

• SKILL.md — the agent skill.
• scripts/trace_csv.py — a standard-library helper that initializes and validates TRACE's canonical artifacts.

Install

Copy the trace directory into the skills directory used by your agent runtime, preserving SKILL.md at the skill root:

• Claude Code: ~/.claude/skills/trace/
• Codex, Copilot CLI, Gemini CLI: ~/.agents/skills/trace/

The helper script needs Python 3.9+ (standard library only).

Start a run

From the target repository:

python3 /path/to/trace/scripts/trace_csv.py init --repo .

Then invoke the trace skill with the repository and authoritative spec in context.

Validate at any point

python3 /path/to/trace/scripts/trace_csv.py validate --repo .

Get the next stable row ID

python3 /path/to/trace/scripts/trace_csv.py next-id --repo .

License

MIT — see LICENSE.