Struct AgentsMdParser 

pub struct AgentsMdParser;

AGENTS.md parser for extracting project-specific instructions.

The parser searches for AGENTS.md files in standard locations and extracts their content along with any file references found in markdown links.

Implementations

impl AgentsMdParser

pub async fn parse(cwd: &Path) -> Result<Option<AgentsMdConfig>, ContextError>

Parse AGENTS.md file from the given directory.

This method searches for AGENTS.md in:

1. Project root directory
2. .kiro subdirectory
3. .claude subdirectory
4. .github subdirectory

Arguments

• cwd - The current working directory (project root)

Returns

Some(AgentsMdConfig) if AGENTS.md is found, None otherwise

Errors

Returns an error if file reading fails

pub fn parse_sync(cwd: &Path) -> Result<Option<AgentsMdConfig>, ContextError>

Parse AGENTS.md file synchronously (blocking).

This is a convenience method for contexts where async is not available.

Arguments

• cwd - The current working directory (project root)

Returns

Some(AgentsMdConfig) if AGENTS.md is found, None otherwise

pub fn get_possible_paths(cwd: &Path) -> Vec<PathBuf>

Get all possible paths where AGENTS.md might be located.

Returns paths in priority order:

1. Root directory AGENTS.md variants
2. Subdirectory AGENTS.md variants (.kiro, .claude, .github)

Arguments

• cwd - The current working directory (project root)

Returns

A vector of possible paths to check

pub fn extract_file_references(text: &str, cwd: &Path) -> Vec<PathBuf>

Extract file references from markdown content.

This method extracts file paths from:

• Markdown links: text
• Code block file references: ```language:path/to/file
• Explicit file mentions: path/to/file

Arguments

• text - The markdown content to parse
• cwd - The current working directory for resolving relative paths

Returns

A vector of resolved file paths

pub async fn inject_to_system_prompt( system_prompt: &str, cwd: &Path, ) -> Result<String, ContextError>

Inject AGENTS.md content into a system prompt.

This method:

1. Searches for AGENTS.md in the project
2. If found, appends its content to the system prompt
3. Returns the modified system prompt

Arguments

• system_prompt - The original system prompt
• cwd - The current working directory (project root)

Returns

The system prompt with AGENTS.md content injected (if found)

Example

let enhanced_prompt = AgentsMdParser::inject_to_system_prompt(
    "You are a helpful assistant.",
    Path::new("/path/to/project")
).await?;

pub fn inject_to_system_prompt_sync( system_prompt: &str, cwd: &Path, ) -> Result<String, ContextError>

Inject AGENTS.md content into a system prompt synchronously.

This is a convenience method for contexts where async is not available.

pub fn exists(cwd: &Path) -> bool

Check if AGENTS.md exists in the given directory.

Arguments

• cwd - The current working directory (project root)

Returns

true if AGENTS.md exists, false otherwise

pub fn find_path(cwd: &Path) -> Option<PathBuf>

Find the first existing AGENTS.md path.

Arguments

• cwd - The current working directory (project root)

Returns

Some(PathBuf) if found, None otherwise