[immakermatty]

Status: ready for review

Why

Root decision 0211, addendum of 2026-10-24 (HumanAndMachines/Lazurio#623). Matěj asked that when an agent needs the person to do something, such as enter a verification code, it asks with the question tool, so the request pops up as a notification in T3 Code. A request written only into a message gets missed: that day a sign-in code expired.

What changes

• questionTool (src/folder/render.ts) gains one passage in both locales: ask the same way when the user has to do something (enter a verification code, sign in, confirm or check something). The question says exactly what to do, with the link, the code and until when it is valid, and its options say how it went ("Hotovo", "Nejde to"). A question pops up as a notification in T3 Code and in Codex Desktop; text in a message does not.
• The rule reaches every Folder's AGENTS.md and Buddy's .hermes.md, both of which use questionTool.
• Template revision base-instructions-74 (Folder: the agent's work is a pull request, GitHub is the authority for source code, and every agent gets Git, fork and safety rules (base-instructions-72, DEV-6617) #621 took 72 and Modules: the Bun an App pins is its runtime, resolved for every path that runs its code (F62, #618) #626 took 73):
  • the pinned digest and the two assertions in tests/folder-tools.test.ts are updated;
  • the snapshots change only in the revision line and the rule line, checked: no other changed line;
  • the eight golden snapshots of tests/try-overlay-preset.test.ts change only in their AGENTS.md digest (Pablo's review).
• F14 addendum of 2026-10-24 in docs/decisions.md.
• tests/folder-manual.test.ts checks the new sentences in both locales.

What does not change

• Everything else in the rule: the options, ask only when needed, no tool means text, no user in the session means hand the question over.
• The handoff's Publication question.

Rollout

The change reaches Environments with the next Platform release and their normal Folder refresh, together with #613 and #614 (base-instructions-70 and 71).

Verification

• bun test tests/folder: 372 pass, 0 fail.
• bun run lint, bun run typecheck, bun run check:public and git diff --check: clean.
• CI runs the full suite.

Plan: DEV-6676. Claude Code thread 8508a2b1-a641-4479-a132-0b188866ce6a.

Rebase of 2026-10-24 ~18:45Z: rebased onto main baa6eda1 (#621). Both commits are kept. The revision is now base-instructions-73 with its new digest; the decision record keeps #621's addendum and adds this one after it. The Folder and try snapshots differ from main only in the revision and the question rule's sentence, and in the golden Environments' AGENTS.md digests. Local checks: lint, typecheck and 177 tests in nine Folder/try/public files pass. Pablo's approval was for abb1bbe8, so the new head needs a new verdict.

Second rebase, 2026-10-24 ~22:25Z: onto main b5c6521c (#626, which took base-instructions-73). The revision is now base-instructions-74 with its new digest. Both commits are kept: the rule with the Folder snapshots, then the golden Environments' AGENTS.md digests. Against main, the snapshots differ only in the revision line, the question rule's sentence and those digests. Local checks: lint, typecheck, check:public and 206 tests in ten Folder/try/public files pass. Pablo approved ebefbff2, so the new head df10b216 needs a new verdict.

🤖 Generated with Claude Code

[agentrozjedemeai]

@immakermatty — Exact-head review of 3e77483. The new question rule matches root 0211 addendum in HumanAndMachines/Lazurio#623, uses Czech singular address, and preserves the rest of the rule. Buddy's generated .hermes.md is 16,665 characters (cs) / 18,209 (en), below 20,000. The two edited snapshot files change only revision/rule lines.

Blocking: the generated AGENTS.md change also invalidates eight golden snapshots in tests/snapshots/try-overlay-preset.test.ts.snap, but this file was not updated. CI tests (2/2) fails, and I reproduced it locally with bun test --max-concurrency 1 tests/try-overlay-preset.test.ts: 14 pass / 8 fail; tests/try-overlay-preset.test.ts:99 and :121 compare stale AGENTS.md SHA-256 values. The rest of each mismatch is unchanged. Please update only the eight expected AGENTS.md digests after verifying their generated text, rerun the targeted test and full CI on a new head, then request a fresh exact-head review. Folder suite (372 pass), lint, typecheck, check:public and diff --check pass on this head; they do not cover this failing golden test. No merge or deployment performed.

[agentrozjedemeai]

@immakermatty Approved on exact head abb1bbe834505583d5b91264c324c58c63c4c4f6. The follow-up changes only the 16 Czech/English AGENTS.md digest entries across the eight golden Environment snapshots; no other snapshot key changed. The generated question-rule text is covered in both locales. In a fresh detached checkout I ran bun test tests/try-overlay-preset.test.ts (22 pass, 8 snapshots), bun test tests/folder (372 pass, 42 snapshots) and git diff --check (clean). Current-head CI static checks and both test shards are green; zero unresolved threads. No merge, push or release.

[immakermatty]

Heads-up on the revision collision: #621 merged at 18:09Z (squash baa6eda) and claimed base-instructions-72. That is why this pull request is now in conflict. To land it:

1. rebase on main;
2. move to base-instructions-73;
3. re-pin the template digest and refresh the folder snapshots.

#621 also changed the generated texts around Publication (no Lazurio "Draft"), the access identity line and the new Git and GitHub section of manual/working-here.md. Expect snapshot conflicts there, not only in the revision pin.

[agentrozjedemeai]

Approved at exact head ebefbff2fd70133126d82718c3c75b6906d3b1f6 against main baa6eda175a8bb5f30aa3dfabee8d2ef54031dd0. Re-reviewed both retained commits after the rebase: revision 73 and its rendered digest pin, the two tools assertions, and both ordered F14 addenda (#621 is preserved). Compared the generated snapshots against main: manual changes are revision-only; render changes are revision plus the new Czech/English question sentence; the overlay changes only the 16 AGENTS.md golden digests. Local Bun 1.4.4 validation: lint, typecheck, 177 targeted tests (107 + 70), all passing; CI static and test jobs are green. No unresolved review threads. This review does not cover the separately stacked PR #623.

[agentrozjedemeai]

@immakermatty — Exact-head review of df10b21 against b5c6521: approved for content. Both commits are retained. The only functional change from the previously reviewed head is the template revision 73 → 74 and its pinned digest/assertions; the F14 addendum from #626 remains untouched. I compared the three golden snapshot files to main after normalizing only the revision line, the new cs/en question sentence and AGENTS.md digests: no residual differences, including no changes to #626 output. In an isolated checkout, lint, typecheck, check:public and all 206 focused tests passed (52 snapshots); git diff --check is clean.

CI is NOT green on this head: tests (2/2) failed on two unrelated public-vault browser tests (Chrome did not start / timeout), so the ubuntu aggregate check failed. This approval is not a merge-ready claim. Please rerun/resolve the failing CI job; do not merge until all required checks are green on this exact head. No merge, push or release performed.