By atopile

Reference for the .ato declarative DSL: type system, connection semantics, constraint model, and standard library.

atopile/atopile

How the atopile compiler builds and links TypeGraphs from .ato (ANTLR front-end → AST → TypeGraph → Linker → DeferredExecutor), plus the key invariants and test entrypoints.

atopile/atopile

Instructions for electronics-specific logic and build processes: netlists, PCBs, build steps, and exporters.

atopile/atopile

How FabLL (faebryk.core.node) maps Python node/trait declarations into the TypeGraph + instance graph, including field/trait invariants and instantiation patterns.

atopile/atopile

How Faebryk's TypeGraph works (GraphView + Zig edges), how to traverse/resolve references, and how FabLL types/traits map onto edge types.

atopile/atopile

How the Zig-backed instance graph works (GraphView/NodeReference/EdgeReference), the real Python API surface, and the invariants around allocation, attributes, and cleanup.

atopile/atopile

How the Faebryk component library is structured, how F.py is generated, and the conventions/invariants for adding new library modules.

atopile/atopile

How the Zig↔Python binding layer works (pyzig), including build-on-import, wrapper generation patterns, ownership rules, and where to add new exported APIs.

atopile/atopile

How the Zig S-expression engine and typed KiCad models work, how they are exposed to Python (pyzigsexp), and the invariants around parsing, formatting, and freeing.

atopile/atopile

How the Faebryk parameter solver works (Sets/Literals, Parameters, Expressions), the core invariants enforced during mutation, and practical workflows for debugging and extending the solver.

atopile/atopile

Core runtime behavior for the atopile sidebar agent: identity, persistence model, execution rules, and tool recipes.

atopile/atopile

Generate short live progress summaries for the atopile agent from recent tool events, preambles, checklist changes, and build state.

atopile/atopile

LLM-focused code review process for this repo: what to check, how to ground feedback in invariants/tests, and how to verify changes efficiently (including test-report.json).

atopile/atopile

LLM-focused workflow for working in this repo: compile Zig, run the orchestrated test runner, consume test-report.json/html artifacts, and discover/debug ConfigFlags.

atopile/atopile

Frontend standards for atopile extension webviews: architecture, contracts, design system, and testing workflow.

atopile/atopile

How the atopile Language Server works (pygls), how it builds per-document graphs for completion/hover/defs, and the invariants for keeping it fast and crash-proof.

atopile/atopile

Spec-driven planning for complex design tasks: when to plan, how to write specs as .ato files, and how to verify against requirements.

atopile/atopile

Authoritative ato authoring and review skill: language reference, stdlib, design patterns, and end-to-end board design workflow.

atopile/atopile

How to write and maintain .claude/skills//SKILL.md files: source-of-truth-first process, verification steps, and conventions.

atopile/atopile