{
  "markdown": "# ID — portable context for AI tools\n\nKeep your working preferences in reviewed files. Reuse them across projects and AI tools, and inspect what changed before sharing.\n\n[![CI](https://github.com/markoblogo/ID/actions/workflows/ci.yml/badge.svg)](https://github.com/markoblogo/ID/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/id-protocol)](https://pypi.org/project/id-protocol/)\n[![MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nID gives you a small owner profile, a derived `soul.md`, portable JSON exports,\nprivacy rules, and a semantic diff. You choose which files an AI tool receives.\n\n## Start with one profile\n\nRequires Python 3.11+ and [uv](https://docs.astral.sh/uv/getting-started/installation/).\nRun in a private working directory:\n\n```sh\nuv tool install id-protocol\nidctl init --owner-id demo\n```\n\nEdit `profiles/demo/profile.minimal.md`: language, level of detail, working rules,\nand what a good result means to you. The starter is **provisional** until you review it.\nUse an owner ID such as `demo` or `my-work-profile`; a real name is unnecessary.\n\n```sh\nidctl validate --owner-id demo\nidctl refresh-soul --owner-id demo\nidctl export-interop --owner-id demo\nidctl export-compact --owner-id demo\nidctl validate-compact --owner-id demo\n```\n\nThese commands work from an installed package, outside this repository. No Makefile,\nAPI key, central registry, or paid service is required.\nValidation checks structure and freshness; it cannot decide whether the profile reflects you.\n\n## What you get\n\n| File | Purpose |\n| --- | --- |\n| `profile.minimal.md` | Owner-edited starting point |\n| `privacy-policy.v1.json` | Rules for filtered exports |\n| `handshake.md` | Instructions for confirming context |\n| `soul.md` | Short derived bootstrap; refresh after source edits |\n| `context.compact.json` | Portable, policy-filtered context |\n\nAdd `profile.core.md` and `profile.extended.md` when you need more detail.\nIf core exists, it takes precedence over minimal for interop exports.\nThe extended profile is optional. Init refuses to overwrite existing starter files.\n\n## Review before sharing\n\n```sh\nidctl diff --owner-id demo --since 7d\n```\n\nDiff uses Git history; commit reviewed source changes if you want version comparisons.\n`interop.v1.json` and `soul.md` are local derived context, **not privacy-filtered sharing bundles**.\nReview your policy and the resulting compact export before giving it to another tool.\nLegacy list policies (`always_share`, `local_only`, `task_class_scoped`) are\nconverted in memory during validation and export; your source file stays unchanged.\nUnlisted fields remain local-only. Scoped entries map field paths to task-class lists.\nMixed formats, conflicting rules, invalid types, and owner mismatches still block export.\nMissing policies also block compact/MCP export. The explicit\n`--allow-unfiltered` option permits a missing policy for a reviewed legacy workflow;\nit does not bypass an invalid policy.\n\nGenerating or exporting a file does not upload it. Source profiles remain under your control.\n\n## Use with agentsgen and SET\n\n| Product | Owns | Tested release |\n| --- | --- | --- |\n| ID | Human preferences and operating constraints | 0.5.1 |\n| [agentsgen](https://github.com/markoblogo/AGENTS.md_generator) | Repository commands and instructions | 0.5.0 |\n| [SET](https://github.com/markoblogo/SET) | Workflow presets and planning exports | 0.3.1 |\n| [abvx-agent-skills](https://github.com/markoblogo/abvx-agent-skills) | Optional reusable agent workflows | 0.14.0, optional pairing |\n\nAll remain separate products. ID does not install the others automatically.\nThe first three versions are exercised together in release CI; skills are an optional\nworkflow reference and are not part of the executable compatibility test.\n\nFor a repository that already has ID profiles:\n\n```sh\nidctl install-set-hook --path .\n```\n\nThis creates a small repo-local adapter for SET. It requires `idctl` on PATH,\npreserves an existing custom hook, and resolves bootstrap files inside the selected\nowner directory. [Complete SET setup](integrations/set/README.md).\n\n## Evidence and compatibility\n\n[Three reproducible demos](docs/RELEASE_DEMOS.md) verify installed onboarding,\nprivacy-policy omissions, and the agentsgen/SET handoff with synthetic profiles.\nThey measure CLI behavior and runtime, not AI task quality.\n\nAI-client loading depends on each client's configuration. ID exports files for\nmanual attachment or an adapter; it does not automatically synchronize ChatGPT,\nClaude, Cursor, or other clients. `export-mcp` creates resource JSON for an adapter;\nthis package does not run an MCP stdio or HTTP server.\n\nHistorical benchmark runs are available as a [dated snapshot](docs/benchmark-snapshot.md).\nThey are a small sample, not a general performance guarantee.\n\n## Explore or contribute\n\n- [Core protocol](spec/) and [full documentation](docs/README.md).\n- [Profile layers](docs/SOUL.md), [sharing](docs/SHARE.md), and [semantic diffs](docs/IDENTITY_DIFF.md).\n- [Integration boundaries](docs/INTEGRATIONS.md) and [release notes](docs/RELEASES.md).\n- [Contributing](CONTRIBUTING.md): include a synthetic reproduction, package version, and expected/actual output.\n\nFor source development: install `.[dev]`, then run `make validate` and `make coverage`.\nKeep real private profiles outside this public repository.\n",
  "bytes": 5381,
  "sha": "056961b0b5d8c1d21f32859e56c5c3d99880042237c0d8e9f931ac5719dae3d6",
  "repo_slug": "markoblogo/id",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_markoblogo_id_330b3417/readme"
}