Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# thulp — Agent Guidelines

## What This Is

Thulp handles tool discovery, validation, and execution for AI agents. It provides a unified abstraction over local Rust functions, MCP servers, and OpenAPI endpoints. Skills chain tools into reusable workflows.

## For Agents

- Run `cargo test --workspace` — 211 tests must pass
- thulp-core is the foundation — changes there affect everything
- Query DSL uses nom parser — test with `cargo test -p thulp-query`
- SKILL.md parsing is in thulp-skill-files — validate against real skill files
- MCP transport is in thulp-mcp — test with mock servers, not live ones
- Don't add deps between core and other crates — core stays independent
29 changes: 29 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# thulp

Execution context engineering for AI agents. Tool discovery, validation, execution, multi-step skill workflows. 11-crate Rust workspace.

## Build & Test

```bash
cargo build --workspace
cargo test --workspace # 211 tests
cargo clippy --workspace -- -D warnings
```

## Architecture

- `thulp-core` (70 tests) — types, traits, validation, JSON Schema
- `thulp-mcp` (39 tests) — MCP transport client
- `thulp-skills` (54 tests) — workflow engine, skill execution
- `thulp-skill-files` (23 tests) — SKILL.md parsing
- `thulp-query` (19 tests) — DSL parser (nom-based)
- `thulp-cli` (32 tests) — clap CLI
- `thulp-openapi`, `thulp-cdp`, `thulp-session`, `thulp-ares`, `thulp-registry`

## Conventions

- Git author: `bkataru <baalateja.k@gmail.com>`
- thulp-core is independent — zero deps on other thulp crates
- Feature flags: `ares`, `cdp`, `mcp` for optional integrations
- nom parser for query DSL
- async-trait for trait objects
Loading
Loading