Skip to content

AGENTS.md

Latest commit

 

History

History
36 lines (29 loc) · 1.29 KB

AGENTS.md

File metadata and controls

36 lines (29 loc) · 1.29 KB

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

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

akf stamp <file> --agent codex --evidence "<summary of evidence>"

When working with existing AKF-stamped files

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