ghuntleyghuntley/loom/mila/AGENTS.md

loom / mila

AGENTS.md1.6k starsChanged todayMITView on GitHub

Mila consists of native platform shells over the shared Rust workspace. Read ADR-0220, ADR-0235, CONTRACTS before changing it. - Use the pinned devenv shell and run the relevant Rust, native and platform checks before committing. - Keep external data behind typed validation and preserve generation/session authority fencing at every FFI boundary. - User-facing strings come from the shared localization catalogs; use the localization skill when adding or changing them. - Property-based tests use Hegel for stateful and boundary behavior. Prefer…

We split this AGENTS.md into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Use the pinned devenv shell and run the relevant Rust, native and platform checks before committing.
line 21
Distinctive:
Keep external data behind typed validation and preserve generation/session authority fencing at every FFI boundary.
line 23

≈ “Common” is an estimate: at least 1 in 5 of the 36,368 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

AGENTS.md

Mila guidance

Mila consists of native platform shells over the shared Rust workspace. Read ADR-0220, ADR-0235, CONTRACTS before changing it.

Layout

Path	Responsibility
`rust/`	Typed protocol, transport, session, policy and FFI libraries.
`native/apple`	SwiftUI iOS/macOS client and Rust FFI adapter.
`native/android`	Kotlin/Compose Android client and JNI adapter.
`native/linux`	GTK4/libadwaita Linux client and Rust session adapter.
`windows-dotnet`	WinUI/.NET 10 Windows client and Rust interop.
`localization`	Shared typed locale policy and deterministic catalogs.

Working rules

Use the pinned devenv shell and run the relevant Rust, native and platform checks before committing.
Keep external data behind typed validation and preserve generation/session authority fencing at every FFI boundary.
User-facing strings come from the shared localization catalogs; use the localization skill when adding or changing them.
Property-based tests use Hegel for stateful and boundary behavior. Prefer native integration evidence over unit tests for platform claims.
Wire formats shared with Elixir use fixtures under protocol/test/fixtures; change both sides and the fixture together.
Native builds that require a platform SDK run in the corresponding CI job.

Download now (ZIP)

Jan 17, 2026Cross-Session Thread Loading & Replay (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Active System Verification Loops (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Meta-Loop Orchestration: Agents Spawning Sub-Loops (exploratory/major from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Structured Audit Threads for Agent Decision Trails (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Server-Side LLM Proxy for Credential Isolation (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions

8 more on GitHub

Jan 17, 2026Secret Wrapper Type for Auto-Redacting (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Error Classification with Transient/Quota/Permanent (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Thread Persistence with UUID7 & Offline-First Sync (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Post-Tool Hook State for Auto-Commit (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Snippet-Based File Editing (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Proactive OAuth Token Refresh (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Multi-Account LLM Pool with Failover & Cooling (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions
Jan 17, 2026Explicit State Machine for Agent Orchestration (from Huntley Loom research) — daydemir/milhouse-go-legacy0 reactions

On Hacker News · 1

Jan 16, 2026If your name is not Geoffrey Huntley then do not use loom2 points · 1 comment

Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 28,693 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository31 other files it gives its agents.
- AGENTS.mdAGENTS.md
- antithesis/AGENTS.mdAGENTS.md
- lilly/AGENTS.mdAGENTS.md
- marshall/AGENTS.mdAGENTS.md
- protocol/AGENTS.mdAGENTS.md
- susan/AGENTS.mdAGENTS.md
- adr-maintenanceSkill
- antithesis-agent-browserSkill
- antithesis-debugSkill
- antithesis-documentationSkill
- antithesis-feature-workloadSkill
- antithesis-launchSkill
- antithesis-mutation-testingSkill
- antithesis-query-logsSkill
- antithesis-researchSkill
- antithesis-review-inputsSkill
- antithesis-setup-k8sSkill
- antithesis-setupSkill
- antithesis-skills-feedbackSkill
- antithesis-triageSkill
- antithesis-workloadSkill
- architecture-reviewSkill
- buck2Skill
- code-contractsSkill
- covenantSkill
- hegel-elixir-testsSkill
- localizationSkill
- monospace-webSkill
- nix-buildsSkill
- security-auditSkill
- test:triageSkill

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free