# LiFoli Works Agent Experience

LiFoli Works is a local-first Agent Experience OS for turning work systems into
agent-operable workflows.

## Discovery

- `/llms.txt`: short agent-readable index.
- `/llms-full.txt`: fuller product and automation context.
- `/.well-known/agent.json`: LiFoli agent card.
- `/.well-known/agents.json`: runnable agent entrypoints.
- `/.well-known/agent-skills/index.json`: reviewed public skills.
- `/mcp`: runtime MCP export manifest.

## Automation Route

LiFoli chooses the safest proven route from explicit evidence:

```txt
official_mcp -> api_connector -> browser_automation -> printing_press_mcp -> human_fallback
```

For services with official MCP or API support, LiFoli connects through those
interfaces. For UI-only or Korea-local services, LiFoli uses browser automation
or PrintingPress-generated connectors with approval gates.

## Permission Ladder

```txt
read -> draft -> local_execute -> external_write -> payment
```

External writes and payment-like actions require explicit approval. MCP egress
exposes only read-safe reviewed capabilities.

## Audit

Agent, human, and system actions should be recorded separately with evidence
snapshots. AX route decisions are audit events, not hidden heuristics.

## Eval

The seed AX spine eval is runnable:

```sh
pnpm --filter @lifoli/runtime eval:agent-experience-spine
```

It checks route selection, workflow eval seeds, selector/PrintingPress fallback,
and approval-ladder behavior.