features agent context workflow

Agent context workflow

Active contributors: Bryan

The agent context workflow combines local repository search, symbol lookup, context packs, neighbors, and impact checks. The shipped Pi skill in skills/lode/SKILL.md tells agents when to reach for those commands during codebase work.

Purpose

This feature is about tool use, not a separate runtime. It gives an agent a repeatable path from vague task to focused source files while keeping repository contents local.

Directory layout

skills/lode/SKILL.md # agent-facing instruction pack
src/lode/cli.py      # commands the skill calls
README.md            # install instructions for the skill

Workflow

graph LR
    Task[User task] --> Search[lode search]
    Search --> Context[lode context]
    Context --> Read[read must_read files]
    Read --> Impact[lode impact]
    Impact --> Edit[make scoped changes]

Loading

Agents can begin with lode search or lode symbol, ask for a context pack with lode context, inspect graph neighbors with lode neighbors, then check blast radius with lode impact before editing.

Key source files

File	Purpose
skills/lode/SKILL.md	Agent instructions for using Lode.
src/lode/cli.py	Command surface used by the skill.
README.md	Skill installation notes.

Entry points for modification

Change agent guidance in skills/lode/SKILL.md. If a command name or JSON field changes, update the skill, README.md, CLI tests, and any daemon API docs if relevant.

Related pages

• Search and context
• Impact analysis
• CLI and daemon