Mercurial

annotate AGENT.md @ 243:823f2a8b16c8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[repo] Ignore Vim swap files
author MrJuneJune <me@mrjunejune.com>
date Mon, 03 Aug 2026 15:26:44 -0700
parents a8d6435dc021
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
1 # Agent instructions
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
2
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
3 ## Bazel is the project interface
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
4
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
5 All project execution must happen through Bazel. Use existing `bazel build`,
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
6 `bazel test`, and `bazel run` targets instead of invoking compiled binaries,
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
7 language runtimes, package managers, generated scripts, or multiple services
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
8 manually.
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
9
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
10 When a workflow needs several processes or commands, add a Bazel target that
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
11 owns their startup, runfiles, supervision, shutdown, and exit status. The user
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
12 should need one `bazel run` command.
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
13
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
14 For hg-web development, run the complete local stack with:
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
15
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
16 ```bash
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
17 bazel run //hg-web:dev
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
18 ```
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
19
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
20 Add or update the smallest relevant Bazel target whenever code cannot be built,
a8d6435dc021 [hg-web] Run local stack through Bazel
MrJuneJune <me@mrjunejune.com>
parents:
diff changeset
21 tested, run, bundled, or orchestrated through Bazel.