Early docs These pages are very early. Structure and tone are still being worked out, so anything here may change drastically.
Skip to content
Rendered from CLAUDE.md in the repository — edit it there.

This file is an index, not a reference. Don't restate what these already say — open them.

Read first ​

@AGENTS.md

It is a map: one line per subsystem, pointing at the README that owns the depth. Follow the pointer rather than assuming the map is the whole story.

Also on hand: ARCHITECTURE.md (high-level design map), DEVELOPMENT.md (dev workflow, common tasks), CONTRIBUTING.md (contribution process), and one README.md per src/*/ module, plus ui/README.md and ui-desktop/README.md.

Always on ​

Two rules apply to every task, so they are stated here rather than behind a skill:

  • No issue or PR numbers in prose. Not in commit messages, PR titles, CHANGELOG entries, READMEs, comments, doc comments or UI copy. Describe the change, not its paperwork. Detail: no-issue-numbers.
  • Never block on a remote job. No --watch / --wait flags, no sleep to let CI progress, no polling loops. The runtime notifies you when background work finishes. Detail: no-blocking-waits.

Task-specific instructions ​

.github/instructions/*.instructions.md hold the rules for particular kinds of work. They are one copy, shared with GitHub Copilot — Copilot applies them automatically via applyTo; you reach them through the skills below, or by opening them directly. Read the matching one instead of improvising the same rule.

InstructionApplies to
ui-design-languageStyling, theming, tokens, visual polish in ui/
progressive-disclosureExposing a setting or capability — tiers, Automatic, honest help text
angular-component-structureCreating, splitting or reviewing Angular components
ui-style-no-buildWhether to run a build to verify UI work
slicing-visual-verificationAny change that alters sliced geometry
no-issue-numbersAny prose a human reads
no-blocking-waitsAnything that could involve waiting on CI

Specialized agents and skills ​

Claude auto-discovers these — no need to invoke them manually:

  • .claude/agents/*.md — specialized subagents (Senior Slicer Engineer, Documentation Sync, Senior Three.js Engineer), mirrored for GitHub Copilot at .github/agents/*.agent.md.
  • .claude/skills/*/SKILL.md:
    • ui-ux — routes to the four UI instruction files and carries the rules most often broken. Fires on any ui/src work.
    • slicing-verification — before/after picture workflow and the G-code measurement tools, for geometry changes.
    • release — freshen up the notes, cut a release candidate, then ship.
    • test-changes — stand up what's needed and write the hand-test checklist.