Skip to content

docs(agents): Herdr guide, gh stack notes, small fixes - #434

Merged
odsod merged 4 commits into
mainfrom
agents-docs-and-settings
Nov 22, 2026
Merged

odsod merged 4 commits into
mainfrom
agents-docs-and-settings

Conversation

@odsod

@odsod odsod commented Nov 22, 2026

Copy link
Copy Markdown
Owner

Four small commits that waited locally. Review them commit by commit.

  • docs(agents): add Herdr essentials and drawing workflow. The global
    AGENTS.md gets a Herdr section: find your own space, open tabs with
    --space, close them, see the window with herdr-app shot, the core rules,
    and how to show images and drawings in a Kitty-graphics tab.
  • feat(claude): auto-compact Fable at 400k like Opus. Adds a
    claude-fable-5-2 auto-compact window of 400000. The default model stays
    opus.
  • docs(agents): record gh stack repo flag and queue rules. gh stack
    takes no -R, so use GH_REPO. Also covers merge-queue behavior for stacks,
    and taking GitHub's rebased copy after the bottom PR lands.
  • fix(mise): install build deps before tools. Sets
    task.run_auto_install = false, so mise bootstrap installs packages
    before any tool that must be built from source.

Checked: every Herdr command in the docs runs as written, gh stack link has
no -R flag, oxfmt --check passes on AGENTS.md, and
mise settings get task.run_auto_install reads false.

Herdr guidance was a short paragraph in Tools that sent agents to the
skills for everything. Give the common cases their own section.

- Herdr: find your own space, open tabs with --space, close them, see the
  window with herdr-app shot, and the core rules.
- Images and drawings: show images in a Kitty-graphics tab, shrink photos,
  draw SVG to scale and check the render before showing it.
- Tools: drop the image line and the Herdr paragraph the section replaces.
Fable 5.2 used the default compact window, unlike Opus 5.5.

- Set autoCompactWindow 400000 for claude-fable-5-2.
- The default model stays opus.
A stacked-PR rollout hit three gaps in the PR lifecycle steps.

- gh stack takes no -R flag: name the repo with GH_REPO.
- gh stack merge only queues after the head's required checks ran, and
  auto-merge is refused for stacked PRs.
- GitHub rebases the next PR after the bottom one lands: compare with
  the remote copy and take it, instead of a local rebase.
`mise run apply` auto-installed tools at config load, before the
`mise bootstrap` task ran. Python 3.14.8 has no precompiled standalone
build, so mise compiled it from source before `patch` and the CPython
headers were installed, and the build stopped at once.

- Set `task.run_auto_install = false`. Bootstrap already installs tools
  after packages, so nothing is lost.
- The CPython build deps in `mise/conf.d/python.toml` then install before
  any tool needs them.
@odsod odsod changed the title docs(agents): Herdr essentials, gh stack notes, Fable compact, mise deps docs(agents): Herdr guide, gh stack notes, small fixes Nov 22, 2026
@odsod
odsod merged commit 12e9840 into main Nov 22, 2026
1 check passed
@odsod
odsod deleted the agents-docs-and-settings branch November 22, 2026 16:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant