Dev

Coordinate Zig builds, orchestrated tests, and test artifact consumption.

3.6k|225|Updated Dec 19, 2023
One-click install
npx skills add https://github.com/atopile/atopile --skill dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Dev
Source: https://github.com/atopile/atopile/tree/main/.claude/skills/dev
Command: npx skills add https://github.com/atopile/atopile --skill dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a tightly integrated, LLM-friendly workflow for developing within this repository: it coordinates building Zig bindings, running the orchestrated test suite, and surfacing test artifacts to speed debugging and validation.

Core Features & Use Cases

  • Zig build coordination: ensures Zig bindings are rebuilt when code changes.
  • Orchestrated testing: runs the repo's orchestrated test runner and collects test reports.
  • Artifact consumption: exposes artifacts like test-report.json/html and test-report.llm.json for analysis and LM-assisted debugging.
  • ConfigFlags inventory: discovers and inventories repository-wide ConfigFlags to support feature flags and experimentation.

Quick Start

  • Activate the development environment: source .venv/bin/activate
  • Compile and test: ato dev compile
  • Run tests for LM workflows: ato dev test --llm -k solver
  • View reports and inventory flags: ato dev test --llm --view HEAD --open
  • Re-run with baseline reuse: ato dev test --reuse --baseline HEAD~1
  • List all ConfigFlags: ato dev flags

Frequently Asked Questions about Dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Zig compilation and test runner execution for LLM-assisted debugging?

Automate Zig compilation and test runner execution by invoking the coordinated dev workflow, which rebuilds Zig bindings on code changes and triggers the orchestrated test suite. It automatically surfaces test artifacts like test-report.json and test-report.html for LLM-assisted debugging and structured analysis.

How do I generate structured test reports for LM-assisted debugging in a Zig repository?

Generate structured test reports by running the orchestrated test runner with the LLM workflow flag, which produces test-report.json, test-report.html, and test-report.llm.json artifacts. These structured outputs are explicitly designed for consumption by language models to speed up debugging and validation.

How do I inventory ConfigFlags repository-wide for feature flags and experimentation?

Inventory ConfigFlags repository-wide by running the dedicated flags command within the dev workflow. It automatically discovers and lists all ConfigFlags across the repository, supporting feature flag management and experimentation without manual codebase searches.

Can I reuse a baseline test run to speed up local development validation?

You can reuse a baseline test run to speed up local development validation by passing the reuse flag with a specified baseline commit. This allows the orchestrated test runner to leverage previous test states, avoiding full rebuilds and accelerating the feedback loop during continuous development.

Does the dev workflow apply to both local development and CI environments?

The dev workflow applies to both local development and CI environments, coordinating Zig builds, orchestrated testing, and artifact generation consistently across contexts. It helps quickly validate changes, generate structured reports, and inventory ConfigFlags regardless of the execution environment.

What is the best way to coordinate Zig builds and test artifact consumption in a fast feedback loop?

The best way to coordinate Zig builds and test artifact consumption is using an integrated LLM-driven dev workflow that automates the fast feedback loop. It synchronizes compilation, triggers the orchestrated test runner, and structures artifacts for immediate analysis, ensuring rapid validation of code changes.