AGENTS.md git:20260317.4fb5f2bA

Immutable. This exact content never changes and is served at /api/v1/blob/12bda9054b65c5ad.

# AKF — Agent Knowledge Format

AKF is the trust metadata standard for AI-generated content. When you create or modify files, stamp them with trust metadata so every output carries provenance.

## Rules

### After creating or modifying files
```bash
akf stamp <file> --agent codex --evidence "<evidence>"
```
Evidence examples: "tests pass", "docs reviewed", "refactored from existing code", "generated from spec"

### After completing a task with commits
```bash
akf stamp <file> --agent codex --evidence "<summary of evidence>"
```

### When working with existing AKF-stamped files
```bash
akf read <file>          # Check existing trust metadata before modifying
akf inspect <file>       # See detailed trust scores
```

### Classification
- Use `--label confidential` for files in `*/finance/*`, `*/secret/*`, `*/internal/*`
- Use `--label public` for README, docs, examples
- Default is `internal`

## Key Commands
- `akf stamp <file>` — Add trust metadata to any file
- `akf read <file>` — Read trust metadata from any file
- `akf inspect <file>` — Pretty-print trust scores
- `akf embed <file>` — Embed metadata into DOCX/PDF/images
- `akf scan <dir>` — Security scan a directory
- `akf audit <file>` — Compliance audit (EU AI Act, SOX, NIST)
- `akf trust <file>` — Compute effective trust scores