/ 
Langertha-Raider-0.504
/ Langertha::Raider::Plugin::NestedMemory

NAME

Langertha::Raider::Plugin::NestedMemory - Internal plugin that appends nested CLAUDE.md files to the results of file tools

VERSION

version 0.504

SYNOPSIS

# Internal to Langertha-Raider -- no API promise.
my $raider = Langertha::Raider->new(
    engine  => $engine,
    plugins => [ '+Langertha::Raider::Plugin::NestedMemory' => {
      context => $app->context,   # Langertha::Raider::Context
    } ],
);

DESCRIPTION

Internal module. Its interface may change without notice.

Claude Code's nested memory (ADR 0019 §2.4): CLAUDE.md files below the project root are not in the system prompt. The first time a tool touches a path in such a subtree, this plugin appends that subtree's CLAUDE.md to the tool's result, as one more text block wrapped in <system-reminder> ... </system-reminder> -- once per file and session ("nested_memory_for" in Langertha::Raider::Context keeps track).

Any tool counts whose arguments carry a path or file_path string: read_file, write_file, edit_file, list_files and every later tool of that shape. A result that is an error (isError) or was cut off by a cancel is left alone and uses up nothing. The same touch brings in skills (k157): the .claude/skills of a subtree and the skills whose paths: match the file, announced in a second block of the same kind ("nested_skills_for" in Langertha::Raider::Context). The application mounts the plugin always; outside the Claude layout only the paths: skills of the other skill roots can fire.

context

The Langertha::Raider::Context (anything with nested_reminders_for). Required.

path_keys

The argument names that carry the path a tool touches: path, file_path.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests at https://github.com/Getty/langertha-raider/issues.

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

https://raudssus.de/