Repository navigation
Rebuild the onboarding handbook - #4
Merged
Merged
Conversation
Pure renames, so Git keeps each file's history before the rewrite: code_of_conduct.md, safety.md and best_practices.md become lab-rules/code-of-conduct.md, lab-rules/safety.md and lab-rules/best-practices.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Turn the lab's rules into an onboarding handbook for new members, written for people and for coding agents: - README with a first-week checklist and a "Start here" grid - lab-rules: code of conduct written out for every heading (draft until the director approves), safety rules rewritten around Kent State emergency and EHS routes (robots in motion, batteries, resin, lasers), best practices kept and extended - research: standards (integrity, IRB and CITI, authorship, data, AI-use disclosure under current ACM and IEEE policy), writing papers (venue table), publishing checklist - templates/latex: IEEE conference and ACM sigconf skeletons with the lab's affiliation block, compiled with tectonic - tech-stack: the stack by layer plus pages for Isaac Sim, MuJoCo, Gazebo, Autodesk Fusion and Inventor, Unity, Docker, Claude Code, Codex, LeRobot and ROS 2 - hardware: specs, first steps, software, safety and troubleshooting for the Unitree Go2 Pro, Booster K1, OpenManipulator-X, SO-101, Jetson AGX Thor, Raspberry Pi 5, ROSMASTER X3 and Formlabs Form 3 - AGENTS.md (repo map, sources, open items), CLAUDE.md, docs CI - relicense from GPL-3.0 to MIT, as the lab lead requested Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Sep 30, 2026
Set Inventor as the CAD default, private-by-default repositories, the lab's author order and the one-week final-draft deadline. Add the minors rule for school events and the Go2, the firmware hold, the changed factory passwords, the X3's Jetson Nano and the Form 3 resin plan. Switch the lab's long-form name to "Laboratory" and Room 236 as the location. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Name the lab manager (Marcus Arnett; secondary Irvin Cardenas) and the lab safety contact (Marcus Arnett; backup Lucky Sah), with a Who to ask table in the README. Mark the code of conduct approved. Record Vaultwarden as the lab's password manager and the SSH-key rule. Add the director's approval and the permission-slip forms to the minors rules. Keep AI coding agents to public or non-sensitive work and point Claude plan requests to the director. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The director (Nov. 5, 2026): conduct concerns go to him first; the Booster K1 follows the Go2's age rule; the lab provides no OpenAI accounts, so point students to OpenAI's $100 Codex credits for university students. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
How to ask Teo (mentions, /ask, the help desk), what it can do (files, reminders, events) and won't do, research-channel mode, limits and privacy, checked against Teo-Discord-Bot main. Link the lab Discord from the first-week checklist and the tech stack table. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Replace the placeholder with the slip's PDF in atr-lab-design-skill. The link resolves once ATR-Lab/atr-lab-design-skill#7 merges. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Rebuilds the lab-rules repository as the onboarding handbook for new members. It covers:
Written for people and for coding agents.
What's in it
README.md: a first-week checklist (accounts, trainings, reading, setup, mentor) and a "Start here" grid.lab-rules/:research/:templates/latex/: IEEE conference and ACM sigconf skeletons with the lab's affiliation block. Both compile with tectonic, in every review and camera-ready variant.tech-stack/: the stack by layer, with one page each for Isaac Sim and Isaac Lab, MuJoCo, Gazebo, Autodesk Fusion and Inventor, Unity, Docker, Claude Code, Codex, LeRobot and ROS 2.hardware/: specs, first steps, software, safety and troubleshooting for:AGENTS.md: the repo map, sources of truth and open items.CLAUDE.mdimports it.For the reviewer
License change. Moving from GPL-3.0 to MIT changes the license of text written by Irvin Steve Cardenas and Nate Kanyok, so please confirm it's OK. Confirmed by the director, Nov. 5, 2026.
AI coding tools. Kent State's AI Hub (kent.edu/ai) says tools outside its approved list, naming Claude and ChatGPT, "may be used for personal/non-sensitive work only, do not input university data." The Claude Code and Codex pages limit agents to public or non-sensitive code until the director confirms with security@kent.edu which lab work they may touch. Decided by the director (Nov. 2026); now in the docs.
Docker Desktop licensing. Docker's subscription terms exclude U.S. public education institutions from the free tier. Decide whether the lab needs a paid plan for macOS and Windows; Docker Engine on Linux is unaffected. Nov. 4, 2026: the lab is testing Podman and Apptainer first.
Go2 and minors. Unitree's disclaimer says the Go2 is "not suitable for people under the age of 18". The page asks for approval before any demo with K-12 visitors. Decided by the director (Nov. 2026); now in the docs.
Factory passwords. Booster and Yahboom publish their robots' factory SSH, VNC and hotspot passwords. Confirm the lab has changed them. Decided by the director (Nov. 2026); now in the docs.
Code of conduct approval, and a CAD default (Fusion or Inventor). Decided by the director (Nov. 2026); now in the docs.
Lab-specific details to fill:
They are listed under "Open items" in
AGENTS.mdand inhardware/README.md#open-items.How it was checked
brand_check.py: 0 errors. The warnings are intentional placeholders, and the[ATR]email tag..lycheeignore; they were read in a browser.After merge
Upload
.github/assets/social-preview.pngunder Settings → Social preview.Related PRs: .github · about · dev-guidelines · all-things-ros2
🤖 Generated with Claude Code