{"id":51879382,"url":"https://github.com/mcamner/mqobsidian","last_synced_at":"2026-07-25T10:03:46.799Z","repository":{"id":365219792,"uuid":"1271104383","full_name":"MCamner/mqobsidian","owner":"MCamner","description":"Architecture memory layer for MQ-stack truth exports, repo reviews, decisions, learning records, and operational knowledge.","archived":false,"fork":false,"pushed_at":"2026-07-21T00:08:18.000Z","size":411,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-21T02:12:05.434Z","etag":null,"topics":["ai-workflow","architecture-decision-records","architecture-memory","developer-tools","knowledge-management","local-first","mq-stack","obsidian","repo-intelligence"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MCamner.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-16T10:39:30.000Z","updated_at":"2026-07-21T00:08:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"9c2b165d-d176-4032-a142-f9dc802d3423","html_url":"https://github.com/MCamner/mqobsidian","commit_stats":null,"previous_names":["mcamner/mqobsidian"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/MCamner/mqobsidian","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCamner%2Fmqobsidian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCamner%2Fmqobsidian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCamner%2Fmqobsidian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCamner%2Fmqobsidian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MCamner","download_url":"https://codeload.github.com/MCamner/mqobsidian/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCamner%2Fmqobsidian/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35875619,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-25T02:00:06.922Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-workflow","architecture-decision-records","architecture-memory","developer-tools","knowledge-management","local-first","mq-stack","obsidian","repo-intelligence"],"created_at":"2026-07-25T10:03:46.224Z","updated_at":"2026-07-25T10:03:46.772Z","avatar_url":"https://github.com/MCamner.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mqobsidian\n\n[![Public Safe Check](https://github.com/MCamner/mqobsidian/actions/workflows/public-safe-check.yml/badge.svg)](https://github.com/MCamner/mqobsidian/actions/workflows/public-safe-check.yml)\n[![Version](https://img.shields.io/badge/version-0.2.2-blue)](CHANGELOG.md)\n\nDurable memory layer for the MQ stack.\n\n`mqobsidian` stores reviewed, reusable, agent-readable knowledge. It is optimized\nto reduce token usage through better read order, smaller context surfaces, and\nclearer truth boundaries.\n\nIt is **not**:\n\n- the execution runtime\n- the orchestration engine\n- the source of live code truth\n- the place to dump raw logs by default\n\n## What this repo is for\n\nUse `mqobsidian` to:\n\n- store durable memory from verified work\n- keep compact context surfaces for agents\n- reduce repeated broad scans of repo docs\n- separate memory from live runtime truth\n- define schemas, templates, and context rules for the stack\n\nUse source repos and tools for current code behavior, current tests, current CLI\nbehavior, live review execution, and contracts in motion.\n\n## Read order\n\nWhen the task touches MQ memory, context, or prior stack work, read the smallest\nuseful surface first and stop once the task is grounded:\n\n1. `.mq/context/task-pack.md`\n2. `memory/learn/agent/mqobsidian.md`\n3. `systems/mqobsidian/hot.md`\n4. `systems/mqobsidian/index.md`\n5. relevant context cards or docs only when the pack is insufficient\n\nThe full reading and truth-boundary rules live in\n[docs/CONTEXT_CONTRACT.md](docs/CONTEXT_CONTRACT.md).\n\n## Truth boundary\n\n`mqobsidian` stores durable memory. It does not replace live truth from\n`mq-agent`, `mq-mcp`, `mq-hal`, `repo-signal`, `mq-ums`, or `mq-image-analyze`.\nIf the task depends on current runtime state, file behavior, tests, or review\nexecution, verify in the source repo or tool.\n\n## Quick Start\n\n```bash\npython3 scripts/generate-context-pack.py \\\n  --task \"fix mq-mcp brain writer paths\" \\\n  --repo mq-mcp \\\n  --target codex \\\n  --out .mq/context/task-pack.md\npython3 scripts/check-token-budget.py\npython3 scripts/measure-context-effect.py\npython3 scripts/generate-agents-md.py --all --output-dir examples/generated-agent-entrypoints\npython3 scripts/generate-claude-md.py --all --output-dir examples/generated-agent-entrypoints\npython3 scripts/generate-repo-context-export.py --all --clean\n```\n\n## Context Compression\n\nThe token-reduction path is:\n\n```text\ntask -\u003e memory query -\u003e context-pack.v1 -\u003e Codex / Claude Code\n```\n\nCurrent measured effect:\n\n```text\ncontext pack + cards: 222 lines\nbroad first-read baseline: 4797 lines\nreduction: 95.4%\n```\n\nSee [docs/context-effect.md](docs/context-effect.md).\n\n## Public-Safe Rules\n\nSafe to publish: architecture notes, ADRs and decisions, schemas and templates,\nsanitized reviews, examples, and truth exports.\n\nDo not publish: secrets, tokens, or API keys; customer names or internal\nhostnames; IP addresses or raw enterprise logs; machine-specific private paths;\nunsanitized review output.\n\n## Key docs\n\n- [docs/CONTEXT_CONTRACT.md](docs/CONTEXT_CONTRACT.md) — how agents should read and use mqobsidian\n- [docs/TOKEN_BUDGET.md](docs/TOKEN_BUDGET.md) — size limits for agent-readable context surfaces\n- [docs/CONTEXT_CARDS.md](docs/CONTEXT_CARDS.md) — small reusable context-card model\n- [docs/context-export-contract.md](docs/context-export-contract.md) — `.mq/context` export ownership and budget source\n- [docs/memory-model.md](docs/memory-model.md) — durable memory layers and ownership\n- [docs/truth-export.md](docs/truth-export.md) — export and truth-boundary rules\n- [docs/roadmap-token-reduction.md](docs/roadmap-token-reduction.md) — longer roadmap\n- [schemas/context-pack.v1.json](schemas/context-pack.v1.json) — task-pack schema\n- [templates/context-pack.md](templates/context-pack.md) — task-pack template\n\n## Validation\n\n```bash\npython3 scripts/validate-export.py\npython3 scripts/check-sensitive-content.py\npython3 scripts/check-token-budget.py\npython3 scripts/measure-context-effect.py\n```\n\n## Design rule\n\nThe value of `mqobsidian` is not more memory. The value is better selection.\nAgents should read the smallest useful surface first.\n\n## License\n\nApache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcamner%2Fmqobsidian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcamner%2Fmqobsidian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcamner%2Fmqobsidian/lists"}