hermes-agent/website/docs/developer-guide
Teknium 12724e6295
feat: progressive subdirectory hint discovery (#5291)
As the agent navigates into subdirectories via tool calls (read_file,
terminal, search_files, etc.), automatically discover and load project
context files (AGENTS.md, CLAUDE.md, .cursorrules) from those directories.

Previously, context files were only loaded from the CWD at session start.
If the agent moved into backend/, frontend/, or any subdirectory with its
own AGENTS.md, those instructions were never seen.

Now, SubdirectoryHintTracker watches tool call arguments for file paths
and shell commands, resolves directories, and loads hint files on first
access. Discovered hints are appended to the tool result so the model
gets relevant context at the moment it starts working in a new area —
without modifying the system prompt (preserving prompt caching).

Features:
- Extracts paths from tool args (path, workdir) and shell commands
- Loads AGENTS.md, CLAUDE.md, .cursorrules (first match per directory)
- Deduplicates — each directory loaded at most once per session
- Ignores paths outside the working directory
- Truncates large hint files at 8K chars
- Works on both sequential and concurrent tool execution paths

Inspired by Block/goose SubdirectoryHintTracker.
2026-04-05 12:33:47 -07:00
..
_category_.json feat: add documentation website (Docusaurus) 2026-03-05 05:24:55 -08:00
acp-internals.md docs: add ACP and internal systems implementation guides 2026-03-14 00:29:48 -07:00
adding-providers.md docs: update adding-providers guide for unified setup flow 2026-03-31 01:29:43 -07:00
adding-tools.md feat: add documentation website (Docusaurus) 2026-03-05 05:24:55 -08:00
agent-loop.md docs: fix stale and incorrect documentation across 18 files 2026-03-24 07:53:07 -07:00
architecture.md feat(memory): pluggable memory provider interface with profile isolation, review fixes, and honcho CLI restoration (#4623) 2026-04-02 15:33:51 -07:00
context-compression-and-caching.md feat(website): add skills browse and search page to docs (#4500) 2026-04-02 10:47:38 -07:00
contributing.md feat: add profiles — run multiple isolated Hermes instances (#3681) 2026-03-29 10:41:20 -07:00
creating-skills.md docs: document credential file passthrough and env var forwarding for remote backends (#3677) 2026-03-29 00:16:34 -07:00
cron-internals.md feat: add multi-skill cron editing and docs 2026-03-14 19:18:10 -07:00
environments.md docs: stabilize website diagrams 2026-03-14 22:49:57 -07:00
extending-the-cli.md docs: replace ASCII diagrams with Mermaid/lists, add linting note 2026-03-21 17:58:30 -07:00
gateway-internals.md feat(memory): pluggable memory provider interface with profile isolation, review fixes, and honcho CLI restoration (#4623) 2026-04-02 15:33:51 -07:00
memory-provider-plugin.md feat(memory): pluggable memory provider interface with profile isolation, review fixes, and honcho CLI restoration (#4623) 2026-04-02 15:33:51 -07:00
prompt-assembly.md feat: progressive subdirectory hint discovery (#5291) 2026-04-05 12:33:47 -07:00
provider-runtime.md docs: update all docs for /model command overhaul and custom provider support 2026-03-24 07:19:26 -07:00
session-storage.md docs: deep quality pass — expand 10 thin pages, fix specific issues (#4134) 2026-03-30 20:30:11 -07:00
tools-runtime.md docs: deep quality pass — expand 10 thin pages, fix specific issues (#4134) 2026-03-30 20:30:11 -07:00
trajectory-format.md docs: deep quality pass — expand 10 thin pages, fix specific issues (#4134) 2026-03-30 20:30:11 -07:00