Skip to content
Open
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
35 changes: 35 additions & 0 deletions DELEGATION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# Sample DELEGATION.md file

## Principal
- Support operations team
- Human approval required for financial, legal, or physical actions

## Allowed actions
- Read order history
- Draft refund recommendations
- Issue refunds up to $50

## Forbidden actions
- Send customer emails without fresh approval
- Change account ownership
- Export bulk customer data

## Allowed delegatees
- triage-agent
- policy-agent
- refund-tool

## Delegation limits
- Max depth: 2
- Expiry: session-bound
- Scope expansions require reauthorization

## Reauthorization triggers
- Read -> write
- Draft -> send
- New tool or dataset
- Higher-privilege credential

## Audit
- Attach an authorization receipt to every delegated action
- Preserve append-only hop history
22 changes: 22 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,3 +47,25 @@ that explains the project’s goals in a simple way, and featuring some examples
pnpm run dev
```
3. Open your browser and go to http://localhost:3000

## Adjacent Idea: DELEGATION.md

An adjacent idea I have been exploring is **DELEGATION.md**: a plain Markdown
companion to `AGENTS.md` for describing what an agent is allowed to do.

The rough split looks like this:

- `AGENTS.md` tells an agent how to work
- `DELEGATION.md` tells an agent what authority it has

That can be useful once work starts moving across tools, sub-agents, or other
trust boundaries and you want to make allowed actions, forbidden actions,
delegatees, ceilings, and reauthorization rules visible in one place.

There is a sample [`DELEGATION.md`](./DELEGATION.md) file in this fork.

For a runtime provenance/enforcement layer, see **HDP (Human Delegation
Provenance)**:

- Paper: [arXiv:2604.04522](https://arxiv.org/abs/2604.04522)
- Overview: [Helixar Labs - HDP](https://helixar.ai/about/labs/hdp/)