WillTools 2026-09-09 -- clean snapshot of the development repo for review

History-free snapshot of the private development repository at 77a82eb. Code, docs and the public catalogue only: no plant or job knowledge layers, no client, job or producer names (tools/scrub.py clean against the widened term list; a second word-level grep clean). The intro deck is left out because its slide images cannot be checked for job drawings.
2026-09-09 08:35:15 -05:00
commit 25592fa6c2
406 changed files with 223435 additions and 0 deletions
@@ -0,0 +1,32 @@
+# AGENTS.md
+
+**Read [CLAUDE.md](CLAUDE.md) first and treat it as binding.** It is written
+for whichever agent is driving this repo, not for one vendor: the live-Revit
+bridge, the IronPython 2.7 rules, the unit conventions, and the rules that
+exist because breaking them killed Revit. Nothing in it is restated here,
+because two copies of a hard rule drift and the copy that drifts is the one
+that takes the model down.
+
+Then read [docs/handoff.md](docs/handoff.md) for the state of the work: what
+is done, what is knowingly approximate, and what to pick up first.
+
+## Harness notes
+
+Instruction files are loaded by the harness's `agent-instructions` plugin,
+which reads `AGENTS.md` and `CLAUDE.md` in each directory from the project
+root down. Two files with the same content collapse to one; two with
+different content both load. That is why this file is a pointer and not a
+copy — it costs a few lines and leaves CLAUDE.md as the single source.
+
+**The plugin ships disabled in the default `web` profile.** If neither file
+appears in the session's context, enable it in
+`~/.dsh/profiles/web/cordis.patch.yml`:
+
+```yaml
+- id: agent-instructions
+  disabled: false
+```
+
+Check what is actually composed with `dsh --profile web --dump-config`. An
+agent working here without CLAUDE.md loaded will reload pyRevit sooner or
+later, and that ends the Revit session.