From 3275b789beb70397277893b572cfccda1792d455 Mon Sep 17 00:00:00 2001 From: Arun Kumar Thiagarajan Date: Fri, 27 Mar 2026 10:42:15 +0530 Subject: [PATCH] =?UTF-8?q?Add=20AKF=20=E2=80=94=20The=20AI=20Native=20Fil?= =?UTF-8?q?e=20Format=20plugin?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- akf-trust-metadata/.cursor-plugin/plugin.json | 32 +++++++ akf-trust-metadata/LICENSE | 21 +++++ akf-trust-metadata/README.md | 32 +++++++ akf-trust-metadata/skills/akf-stamp/SKILL.md | 85 +++++++++++++++++++ 4 files changed, 170 insertions(+) create mode 100644 akf-trust-metadata/.cursor-plugin/plugin.json create mode 100644 akf-trust-metadata/LICENSE create mode 100644 akf-trust-metadata/README.md create mode 100644 akf-trust-metadata/skills/akf-stamp/SKILL.md diff --git a/akf-trust-metadata/.cursor-plugin/plugin.json b/akf-trust-metadata/.cursor-plugin/plugin.json new file mode 100644 index 0000000..92fe97d --- /dev/null +++ b/akf-trust-metadata/.cursor-plugin/plugin.json @@ -0,0 +1,32 @@ +{ + "name": "akf-trust-metadata", + "displayName": "AKF — The AI Native File Format", + "version": "1.0.0", + "description": "EXIF for AI. Stamps every file agents generate with trust scores, source provenance, and compliance metadata. ~15 tokens of JSON that embed into 20+ formats.", + "author": { + "name": "HMAKT99", + "email": "akf@akf.dev" + }, + "homepage": "https://akf.dev", + "repository": "https://github.com/HMAKT99/AKF", + "license": "MIT", + "keywords": [ + "trust", + "metadata", + "provenance", + "compliance", + "ai-native", + "file-format", + "eu-ai-act", + "exif-for-ai" + ], + "category": "developer-tools", + "tags": [ + "trust", + "provenance", + "compliance", + "ai-safety", + "developer-tools" + ], + "skills": "./skills/" +} diff --git a/akf-trust-metadata/LICENSE b/akf-trust-metadata/LICENSE new file mode 100644 index 0000000..f75244d --- /dev/null +++ b/akf-trust-metadata/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 HMAKT99 + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/akf-trust-metadata/README.md b/akf-trust-metadata/README.md new file mode 100644 index 0000000..c60168a --- /dev/null +++ b/akf-trust-metadata/README.md @@ -0,0 +1,32 @@ +# AKF — The AI Native File Format + +EXIF for AI. Stamps every file your agents generate with trust scores, source provenance, and compliance metadata. + +## What it does + +When Cursor agents create or modify files, AKF stamps them with ~15 tokens of JSON carrying: +- **Trust scores** (0–1) based on source tier +- **Source provenance** — where the information came from +- **Compliance metadata** — EU AI Act, SOX, HIPAA, NIST readiness + +The metadata embeds natively into 20+ formats — DOCX, PDF, images, Markdown, YAML, JSON, Python, TypeScript, Go, Rust, HTML — no sidecars. + +## Quick start + +```bash +pip install akf +akf stamp report.md --agent cursor --evidence "generated from user prompt" +akf inspect report.md +``` + +## Why + +- **47% of developers** distrust AI-generated code (Cognition/Devin, 2026) +- **EU AI Act Article 50** takes effect August 2, 2026 — AI content must carry transparency metadata +- Every file agents generate should carry provenance + +## Links + +- [akf.dev](https://akf.dev) +- [GitHub](https://github.com/HMAKT99/AKF) +- [Demo](https://huggingface.co/spaces/HANAKT19/akf) diff --git a/akf-trust-metadata/skills/akf-stamp/SKILL.md b/akf-trust-metadata/skills/akf-stamp/SKILL.md new file mode 100644 index 0000000..a457607 --- /dev/null +++ b/akf-trust-metadata/skills/akf-stamp/SKILL.md @@ -0,0 +1,85 @@ +--- +name: akf-stamp +description: >- + Stamps files with AKF trust metadata — the AI native file format. + Use after creating or modifying any file to add trust scores, source + provenance, and compliance metadata. Use before modifying existing files + to check current trust context. Use when the user mentions trust, + provenance, compliance, EU AI Act, or metadata. +--- + +# AKF — The AI Native File Format + +Every photo has EXIF. Every song has ID3. AKF is the native metadata format for AI-generated content — ~15 tokens of JSON that embed trust scores, source provenance, and compliance data into 20+ file formats. + +## After creating or modifying files + +Stamp every file you create or modify with trust metadata: + +```bash +akf stamp --agent cursor --evidence "" +``` + +Evidence should describe what you did: +- `"generated from user prompt"` — new file from scratch +- `"refactored existing code"` — modification +- `"tests pass"` — after running tests +- `"docs reviewed"` — documentation +- `"bug fix, verified manually"` — fixes + +## Before modifying existing files + +Always check existing trust metadata first: + +```bash +akf read +akf inspect +``` + +This shows who last modified the file, their evidence, and the trust score. Preserve or update this context. + +## Classification + +Apply security labels based on file location: + +- `--label confidential` for files in `*/finance/*`, `*/secret/*`, `*/internal/*` +- `--label public` for README, docs, examples, open-source files +- Default is `internal` + +## Compliance auditing + +Check if files meet regulatory requirements: + +```bash +akf audit --regulation eu_ai_act # EU AI Act Article 50 +akf audit --regulation hipaa # HIPAA +akf audit --regulation sox # SOX +akf audit --regulation nist_ai # NIST AI RMF +``` + +## Trust scoring + +Trust scores range from 0 to 1, based on source tier: + +| Tier | Score | Examples | +|------|-------|----------| +| T1 | 0.95 | SEC filings, court records, official APIs | +| T2 | 0.85 | Reuters, peer-reviewed journals | +| T3 | 0.70 | News articles, Wikipedia | +| T4 | 0.50 | Blog posts, forums | +| T5 | 0.30 | Unverified AI output | + +Human review promotes AI content from T5 (0.30) to T3+ (0.70+). + +## Install + +```bash +pip install akf +``` + +## Links + +- Website: https://akf.dev +- GitHub: https://github.com/HMAKT99/AKF +- npm: `npm install akf-format` +- Demo: https://huggingface.co/spaces/HANAKT19/akf