[TheAngryByrd]

Summary

This PR adds a Lode for AI agents, adds decision records, and corrects docs that disagree with the code.

+AGENTS.md                      # Lode Coding prompt, pinned to fjzeit/lode@7a21c1c
+adr/                           # 12 ADRs mined from merged PRs and commits
+CLAUDE.md                      # @AGENTS.md
 .gitignore
-docs/
+/docs/                         # the old rule also ignored lode/docs/
+lode/tmp/
+lode/                          # builders, build, tests, docs, benchmarks, plans
 README.md                      # build targets, env vars, and release flow from build/build.fs
 build/Changelog.fs             # TrimEnd('/') on the repository URL
 CHANGELOG.md                   # 39 links with IcedTasks//compare fixed
 docsSrc/Explanations/
   Choosing-a-builder.md        # backgroundCancellableTask and! column: No
   Understanding-and-bang.md
 src/IcedTasks/                 # XML docs: remove "A cancellation check is performed" where no check occurs
   TaskBuilderBase.fs
   ColdTask.fs
   CancellableTaskBuilderBase.fs

The ADRs in adr/ record 12 decisions, from the function type aliases (0001) to one namespace per builder file (0012). Each ADR quotes its PR, issue, review, or commit. When no source stated a reason, the maintainer confirmed the reason, and the ADR says so. The ADRs are in adr/, not docs/adr/, because docs/ is the generated fsdocs output and each docs build deletes it.

Doc corrections:

• README.md lists the real FAKE targets and chains. CONFIGURATION defaults to Debug, and the Publish target uses Release. The release flow is Release on master, a tag push, and then publish.yml with NuGet trusted publishing.
• backgroundCancellableTask has no MergeSources. An and! gives error FS3343, so the docs no longer say that it supports and!.
• The XML docs of Return, Bind, For, and BindNoCancellation said that they check for cancellation. Those members do not check. The two Bind overloads that check keep the remark.

Evidence

• Before: mkLinkReference with https://github.com/TheAngryByrd/IcedTasks/ made https://github.com/TheAngryByrd/IcedTasks//compare/....
  After: It makes https://github.com/TheAngryByrd/IcedTasks/compare/.... The URL with no trailing slash gives the same result.
• backgroundCancellableTask { let! a = ... and! b = ... } fails with error FS3343.
• dotnet build src/IcedTasks -c Release gives 0 warnings. dotnet fantomas src build --check is clean. dotnet build build/build.fsproj passes.

Merge Danger

Door: two-way

Blast Radius: docs

The only code changes are XML doc comments and URL building in build/Changelog.fs. The next Release target run uses the new Changelog.fs code.

These defects exist on master. This PR does not fix them:

1. backgroundCancellableTask does not support and!.
2. Expect.throwsTAsync has an inverted type check. It fails when the exception is the expected type or a base type, and passes for other types.
3. RevertChangelog reads changelogBackupFilename in build/build.fs, and no code sets that value.
4. The FSharpAnalyzers target reads packages/analyzers, and no step creates that directory.

🤖 Generated with Claude Code