owledge 0.6.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- owledge-0.6.0/AGENTS.template.md +88 -0
- owledge-0.6.0/CHANGELOG.md +53 -0
- owledge-0.6.0/CLAUDE.template.md +88 -0
- owledge-0.6.0/CONTRIBUTING.md +39 -0
- owledge-0.6.0/DESIGN.md +114 -0
- owledge-0.6.0/LICENSE +21 -0
- owledge-0.6.0/MANIFEST.in +28 -0
- owledge-0.6.0/PKG-INFO +349 -0
- owledge-0.6.0/PRIVACY.md +31 -0
- owledge-0.6.0/PROJECT_CONTEXT.template.md +169 -0
- owledge-0.6.0/README.md +324 -0
- owledge-0.6.0/REPORT_DESIGN_SELECTOR.html +757 -0
- owledge-0.6.0/SECURITY.md +41 -0
- owledge-0.6.0/USER_CONTEXT.template.md +57 -0
- owledge-0.6.0/VERSION +1 -0
- owledge-0.6.0/addons/compliance-light/README.md +25 -0
- owledge-0.6.0/addons/compliance-light/addon.json +52 -0
- owledge-0.6.0/addons/compliance-light/docs/compliance-light.md +41 -0
- owledge-0.6.0/addons/compliance-light/schemas/compliance-record.schema.json +24 -0
- owledge-0.6.0/addons/compliance-light/starter/agent-memory/compliance/profile.md +22 -0
- owledge-0.6.0/addons/compliance-light/templates/ai-system-template.md +21 -0
- owledge-0.6.0/addons/compliance-light/templates/data-subject-request-template.md +18 -0
- owledge-0.6.0/addons/compliance-light/templates/dpia-trigger-template.md +20 -0
- owledge-0.6.0/addons/compliance-light/templates/processing-activity-template.md +20 -0
- owledge-0.6.0/addons/compliance-light/templates/provider-registry-template.md +20 -0
- owledge-0.6.0/addons/compliance-light/templates/security-incident-template.md +19 -0
- owledge-0.6.0/addons/compliance-light/tests/fixtures/invalid-processing-fields/agent-memory/compliance/profile.md +20 -0
- owledge-0.6.0/addons/compliance-light/tests/fixtures/invalid-processing-fields/agent-memory/compliance/registers/processing-activity.md +12 -0
- owledge-0.6.0/addons/compliance-light/tests/fixtures/minimal-pass/agent-memory/compliance/ai-systems/ai-system.md +20 -0
- owledge-0.6.0/addons/compliance-light/tests/fixtures/minimal-pass/agent-memory/compliance/dpia/dpia-trigger.md +20 -0
- owledge-0.6.0/addons/compliance-light/tests/fixtures/minimal-pass/agent-memory/compliance/profile.md +20 -0
- owledge-0.6.0/addons/compliance-light/tests/fixtures/minimal-pass/agent-memory/compliance/registers/processing-activity.md +19 -0
- owledge-0.6.0/addons/compliance-light/tests/fixtures/minimal-pass/agent-memory/compliance/registers/provider.md +19 -0
- owledge-0.6.0/addons/compliance-light/tests/fixtures/missing-provider/agent-memory/compliance/profile.md +21 -0
- owledge-0.6.0/addons/cross-project-hub-kit/README.md +30 -0
- owledge-0.6.0/addons/cross-project-hub-kit/addon.json +30 -0
- owledge-0.6.0/addons/cross-project-hub-kit/templates/cross-project-import-manifest-template.md +26 -0
- owledge-0.6.0/addons/cross-project-hub-kit/tools/build-cross-project-map.py +36 -0
- owledge-0.6.0/addons/decision-trace-kit/README.md +43 -0
- owledge-0.6.0/addons/decision-trace-kit/addon.json +28 -0
- owledge-0.6.0/addons/decision-trace-kit/starter/agent-memory/decision-trace/trace-profile.md +18 -0
- owledge-0.6.0/addons/decision-trace-kit/tools/render-decision-trace.py +339 -0
- owledge-0.6.0/addons/enterprise-context-benchmark-kit/README.md +67 -0
- owledge-0.6.0/addons/enterprise-context-benchmark-kit/addon.json +31 -0
- owledge-0.6.0/addons/enterprise-context-benchmark-kit/starter/agent-memory/enterprise-context-benchmark/profile.md +21 -0
- owledge-0.6.0/addons/enterprise-context-benchmark-kit/tools/run-enterprise-context-benchmark.py +743 -0
- owledge-0.6.0/addons/launch-demo-kit/README.md +23 -0
- owledge-0.6.0/addons/launch-demo-kit/addon.json +41 -0
- owledge-0.6.0/addons/launch-demo-kit/docs/try-owledge-in-5-minutes.md +10 -0
- owledge-0.6.0/addons/launch-demo-kit/starter/agent-memory/evidence/launch-demo-before.md +52 -0
- owledge-0.6.0/addons/launch-demo-kit/starter/agent-memory/handoffs/launch-demo-resume-handoff.md +64 -0
- owledge-0.6.0/addons/launch-demo-kit/starter/agent-memory/launch-demo/profile.md +36 -0
- owledge-0.6.0/addons/launch-demo-kit/starter/agent-memory/reports/launch-demo/project-memory-cockpit.html +33 -0
- owledge-0.6.0/addons/launch-demo-kit/templates/launch-demo-next-agent-prompt.md +7 -0
- owledge-0.6.0/addons/pi-proof-kit/README.md +24 -0
- owledge-0.6.0/addons/pi-proof-kit/addon.json +62 -0
- owledge-0.6.0/addons/pi-proof-kit/docs/pi-proof-loop.md +13 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/01-observe-chat-context-loss.md +36 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/02-observe-handoff-gap.md +36 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/03-observe-runtime-fixture-gap.md +36 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/04-detect-recurring-error.md +36 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/05-detect-parallel.md +36 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/06-redteam-finding.md +35 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/07-promoted-pattern.md +36 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/08-promoted-lesson.md +36 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/09-measure-recurrence-reduction.md +36 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/proof-corpus/10-measure-launch-score.md +36 -0
- owledge-0.6.0/addons/pi-proof-kit/starter/agent-memory/pi-agent/red-team/pi-proof-redteam-scorecard.md +52 -0
- owledge-0.6.0/addons/pilot-benchmark-kit/README.md +39 -0
- owledge-0.6.0/addons/pilot-benchmark-kit/addon.json +35 -0
- owledge-0.6.0/addons/pilot-benchmark-kit/docs/pilot-benchmark-kit.md +59 -0
- owledge-0.6.0/addons/pilot-benchmark-kit/fixtures/benchmark-latest.json +45 -0
- owledge-0.6.0/addons/pilot-benchmark-kit/fixtures/finalization-summary.json +64 -0
- owledge-0.6.0/addons/pilot-benchmark-kit/fixtures/retrieval-eval.json +72 -0
- owledge-0.6.0/addons/pilot-benchmark-kit/tools/render-pilot-benchmark.py +400 -0
- owledge-0.6.0/addons/poweruser-positioning-kit/README.md +40 -0
- owledge-0.6.0/addons/poweruser-positioning-kit/addon.json +22 -0
- owledge-0.6.0/addons/poweruser-positioning-kit/tools/render-poweruser-positioning.py +242 -0
- owledge-0.6.0/addons/project-snapshot-kit/README.md +38 -0
- owledge-0.6.0/addons/project-snapshot-kit/addon.json +55 -0
- owledge-0.6.0/addons/project-snapshot-kit/docs/project-snapshot-kit.md +38 -0
- owledge-0.6.0/addons/project-snapshot-kit/skills/render-memory-report/references/execution-dashboard.md +31 -0
- owledge-0.6.0/addons/project-snapshot-kit/skills/render-memory-report/references/project-site.md +33 -0
- owledge-0.6.0/addons/project-snapshot-kit/starter/agent-memory/project-snapshot/profile.md +24 -0
- owledge-0.6.0/addons/project-snapshot-kit/templates/project-execution-snapshot-template.md +54 -0
- owledge-0.6.0/addons/project-snapshot-kit/templates/project-site-html-template.md +25 -0
- owledge-0.6.0/addons/project-snapshot-kit/templates/project-story-snapshot-template.md +52 -0
- owledge-0.6.0/addons/runtime-conformance-kit/README.md +21 -0
- owledge-0.6.0/addons/runtime-conformance-kit/addon.json +39 -0
- owledge-0.6.0/addons/runtime-conformance-kit/contracts/claude-code.json +20 -0
- owledge-0.6.0/addons/runtime-conformance-kit/contracts/codex.json +20 -0
- owledge-0.6.0/addons/runtime-conformance-kit/contracts/cowork-compatible.json +20 -0
- owledge-0.6.0/addons/runtime-conformance-kit/docs/runtime-conformance.md +22 -0
- owledge-0.6.0/addons/runtime-conformance-kit/fixtures/session-start.json +6 -0
- owledge-0.6.0/addons/runtime-conformance-kit/fixtures/user-prompt.json +6 -0
- owledge-0.6.0/addons/runtime-conformance-kit/tools/run-runtime-conformance.py +41 -0
- owledge-0.6.0/addons/swarm-coordination-kit/README.md +20 -0
- owledge-0.6.0/addons/swarm-coordination-kit/addon.json +29 -0
- owledge-0.6.0/addons/swarm-coordination-kit/templates/agent-lane-handoff-template.md +28 -0
- owledge-0.6.0/addons/swarm-coordination-kit/templates/promotion-proposal-template.md +28 -0
- owledge-0.6.0/addons/swarm-coordination-kit/templates/swarm-orchestration-plan-template.md +31 -0
- owledge-0.6.0/addons/trust-readiness-kit/README.md +22 -0
- owledge-0.6.0/addons/trust-readiness-kit/addon.json +30 -0
- owledge-0.6.0/addons/trust-readiness-kit/docs/data-flow.md +28 -0
- owledge-0.6.0/addons/trust-readiness-kit/docs/security-faq.md +23 -0
- owledge-0.6.0/addons/trust-readiness-kit/docs/team-evaluation-checklist.md +22 -0
- owledge-0.6.0/addons/trust-readiness-kit/docs/threat-model.md +27 -0
- owledge-0.6.0/addons/trust-readiness-kit/docs/trust-readiness.md +31 -0
- owledge-0.6.0/addons/ts-adapter-kit/README.md +36 -0
- owledge-0.6.0/addons/ts-adapter-kit/addon.json +46 -0
- owledge-0.6.0/addons/ts-adapter-kit/bin/owledge-lint.mjs +4 -0
- owledge-0.6.0/addons/ts-adapter-kit/dist/cli.js +465 -0
- owledge-0.6.0/addons/ts-adapter-kit/fixtures/invalid-missing-memory-id.md +15 -0
- owledge-0.6.0/addons/ts-adapter-kit/fixtures/minimal-project/agent-memory/canonical/markdown-contract.md +37 -0
- owledge-0.6.0/addons/ts-adapter-kit/fixtures/minimal-project/agent-memory/compiled/retrieval-adapter.md +39 -0
- owledge-0.6.0/addons/ts-adapter-kit/fixtures/retrieval-fixture.json +19 -0
- owledge-0.6.0/addons/ts-adapter-kit/package.json +20 -0
- owledge-0.6.0/addons/ts-adapter-kit/schemas/core-frontmatter.schema.json +81 -0
- owledge-0.6.0/addons/ts-adapter-kit/src/cli.ts +511 -0
- owledge-0.6.0/addons/ts-adapter-kit/tsconfig.json +15 -0
- owledge-0.6.0/assets/README.md +6 -0
- owledge-0.6.0/assets/launch-demo-cockpit.svg +23 -0
- owledge-0.6.0/assets/social-preview.svg +19 -0
- owledge-0.6.0/benchmarks/README.md +40 -0
- owledge-0.6.0/benchmarks/results/README.md +6 -0
- owledge-0.6.0/benchmarks/results/baseline.json +25 -0
- owledge-0.6.0/benchmarks/run_benchmarks.py +187 -0
- owledge-0.6.0/docs/README.md +80 -0
- owledge-0.6.0/docs/agent-first-run-setup.md +76 -0
- owledge-0.6.0/docs/agent-integration-guide.md +195 -0
- owledge-0.6.0/docs/agentic-memory-architecture.md +119 -0
- owledge-0.6.0/docs/agents-md-integration-block.md +105 -0
- owledge-0.6.0/docs/archive/README.md +5 -0
- owledge-0.6.0/docs/archive/ai-workos-vault-adapter-plan.md +74 -0
- owledge-0.6.0/docs/archive/ai-workos-vault-merge-evaluation.md +48 -0
- owledge-0.6.0/docs/archive/compliance-implementation-plan.md +192 -0
- owledge-0.6.0/docs/archive/compliance-roadmap.md +186 -0
- owledge-0.6.0/docs/archive/dashboard-extension-plan.md +251 -0
- owledge-0.6.0/docs/archive/finalization-report.md +90 -0
- owledge-0.6.0/docs/archive/incremental-index-finalization-sprint.md +39 -0
- owledge-0.6.0/docs/archive/pi-agent-adapter-plan.md +74 -0
- owledge-0.6.0/docs/archive/pi-agent-global-intelligence-plan.md +82 -0
- owledge-0.6.0/docs/archive/pi-agent-red-team-evaluation-plan.md +87 -0
- owledge-0.6.0/docs/archive/publishing.md +123 -0
- owledge-0.6.0/docs/archive/review-workflow-finalization-sprint.md +54 -0
- owledge-0.6.0/docs/command-reference.md +203 -0
- owledge-0.6.0/docs/critique-derived-addons-roadmap.md +218 -0
- owledge-0.6.0/docs/cross-platform-lean-setup.md +64 -0
- owledge-0.6.0/docs/cross-project-hub-kit.md +30 -0
- owledge-0.6.0/docs/decision-trace-kit.md +43 -0
- owledge-0.6.0/docs/distribution.md +77 -0
- owledge-0.6.0/docs/enterprise-context-benchmark-kit.md +67 -0
- owledge-0.6.0/docs/feedback-round-2026-06.md +321 -0
- owledge-0.6.0/docs/global-user-knowledge-layer.md +135 -0
- owledge-0.6.0/docs/harness-plugin-matrix.md +26 -0
- owledge-0.6.0/docs/html-reports.md +65 -0
- owledge-0.6.0/docs/ideation-workflow.md +64 -0
- owledge-0.6.0/docs/incremental-index-workflow.md +92 -0
- owledge-0.6.0/docs/install-plugin.md +171 -0
- owledge-0.6.0/docs/integration-decision-guide.md +70 -0
- owledge-0.6.0/docs/launch-readiness.md +78 -0
- owledge-0.6.0/docs/lightrag-neo4j-qdrant-setup.md +250 -0
- owledge-0.6.0/docs/mvp-plan-example.md +54 -0
- owledge-0.6.0/docs/operational-hardening.md +73 -0
- owledge-0.6.0/docs/owledge-vs-agent-methods.md +35 -0
- owledge-0.6.0/docs/performance-scale-notes.md +78 -0
- owledge-0.6.0/docs/pi-agent-setup.md +148 -0
- owledge-0.6.0/docs/power-user-objections.md +42 -0
- owledge-0.6.0/docs/poweruser-positioning-kit.md +40 -0
- owledge-0.6.0/docs/project-folder-only-quickstart.md +58 -0
- owledge-0.6.0/docs/project-snapshot-kit.md +52 -0
- owledge-0.6.0/docs/quickstart.md +101 -0
- owledge-0.6.0/docs/reusable-review-evaluation-templates.md +99 -0
- owledge-0.6.0/docs/roadmap-ideas-2026-06.md +223 -0
- owledge-0.6.0/docs/superpowers-integration.md +63 -0
- owledge-0.6.0/docs/swarm-coordination-kit.md +20 -0
- owledge-0.6.0/docs/team-long-running-project-guide.md +34 -0
- owledge-0.6.0/docs/try-owledge-in-5-minutes.md +68 -0
- owledge-0.6.0/docs/v0.6.0-implementation-plan.md +378 -0
- owledge-0.6.0/examples/README.md +18 -0
- owledge-0.6.0/examples/demo-vault/Handoff Seed.md +7 -0
- owledge-0.6.0/examples/demo-vault/Product Idea.md +10 -0
- owledge-0.6.0/examples/demo-vault/Research Note.md +12 -0
- owledge-0.6.0/owledge.egg-info/PKG-INFO +349 -0
- owledge-0.6.0/owledge.egg-info/SOURCES.txt +371 -0
- owledge-0.6.0/owledge.egg-info/dependency_links.txt +1 -0
- owledge-0.6.0/owledge.egg-info/entry_points.txt +2 -0
- owledge-0.6.0/owledge.egg-info/top_level.txt +1 -0
- owledge-0.6.0/plugins/agent-memory-cowork/.claude-plugin/plugin.json +27 -0
- owledge-0.6.0/plugins/agent-memory-cowork/.codex-plugin/plugin.json +43 -0
- owledge-0.6.0/plugins/agent-memory-cowork/CHANGELOG.md +8 -0
- owledge-0.6.0/plugins/agent-memory-cowork/LICENSE +21 -0
- owledge-0.6.0/plugins/agent-memory-cowork/README.md +114 -0
- owledge-0.6.0/plugins/agent-memory-cowork/VERSION +1 -0
- owledge-0.6.0/plugins/agent-memory-cowork/agents/memory-curator.md +18 -0
- owledge-0.6.0/plugins/agent-memory-cowork/commands/memory-doctor.md +28 -0
- owledge-0.6.0/plugins/agent-memory-cowork/commands/memory-init.md +30 -0
- owledge-0.6.0/plugins/agent-memory-cowork/commands/memory-report.md +45 -0
- owledge-0.6.0/plugins/agent-memory-cowork/commands/memory-status.md +28 -0
- owledge-0.6.0/plugins/agent-memory-cowork/hooks/hooks.json +86 -0
- owledge-0.6.0/plugins/agent-memory-cowork/hooks/hooks.python.json +86 -0
- owledge-0.6.0/plugins/agent-memory-cowork/scripts/capture-claude-event.py +104 -0
- owledge-0.6.0/plugins/agent-memory-cowork/scripts/close-runtime-session.py +120 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/agent-memory-principles/SKILL.md +50 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/agent-memory-principles/references/agent-rules.md +38 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/agent-memory-principles/references/mapping-contract.md +51 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/agent-memory-principles/references/principles.md +36 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/agent-memory-principles/references/security-rules.md +43 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/agent-memory-runtime-bridge/SKILL.md +59 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/bootstrap-agent-memory/SKILL.md +36 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/SKILL.md +49 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/references/agent-activity-report.md +9 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/references/decision-report.md +9 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/references/execution-dashboard.md +31 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/references/handoff-report.md +9 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/references/project-dashboard.md +9 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/references/project-site.md +33 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/references/rag-readiness-report.md +9 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/references/report-design-systems.md +15 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/render-memory-report/references/website-ui-report.md +9 -0
- owledge-0.6.0/plugins/agent-memory-cowork/skills/review-evaluation-workflow/SKILL.md +78 -0
- owledge-0.6.0/plugins/agent-memory-cowork/tests/fixtures/post-tool-use.json +12 -0
- owledge-0.6.0/plugins/agent-memory-cowork/tests/fixtures/session-start.json +7 -0
- owledge-0.6.0/plugins/agent-memory-cowork/tests/fixtures/stop.json +6 -0
- owledge-0.6.0/plugins/agent-memory-cowork/tests/fixtures/user-prompt.json +7 -0
- owledge-0.6.0/plugins/pi-agent-workspace/.claude-plugin/plugin.json +29 -0
- owledge-0.6.0/plugins/pi-agent-workspace/.codex-plugin/plugin.json +33 -0
- owledge-0.6.0/plugins/pi-agent-workspace/README.md +61 -0
- owledge-0.6.0/plugins/pi-agent-workspace/agents/pi-global-intelligence.md +33 -0
- owledge-0.6.0/plugins/pi-agent-workspace/agents/pi-red-team-evaluator.md +25 -0
- owledge-0.6.0/plugins/pi-agent-workspace/agents/pi-workspace-guardian.md +14 -0
- owledge-0.6.0/plugins/pi-agent-workspace/commands/pi-intelligence-report.md +14 -0
- owledge-0.6.0/plugins/pi-agent-workspace/commands/pi-redteam-evaluate.md +20 -0
- owledge-0.6.0/plugins/pi-agent-workspace/commands/pi-workspace-check.md +18 -0
- owledge-0.6.0/plugins/pi-agent-workspace/skills/personal-pi-agent/SKILL.md +43 -0
- owledge-0.6.0/plugins/pi-agent-workspace/skills/pi-agent-global-intelligence/SKILL.md +37 -0
- owledge-0.6.0/plugins/pi-agent-workspace/skills/pi-agent-red-team-evaluator/SKILL.md +36 -0
- owledge-0.6.0/plugins/pi-agent-workspace/skills/pi-agent-workspace-quality/SKILL.md +20 -0
- owledge-0.6.0/pyproject.toml +100 -0
- owledge-0.6.0/setup.cfg +4 -0
- owledge-0.6.0/skills/agent-memory-principles/SKILL.md +50 -0
- owledge-0.6.0/skills/agent-memory-principles/references/agent-rules.md +38 -0
- owledge-0.6.0/skills/agent-memory-principles/references/mapping-contract.md +51 -0
- owledge-0.6.0/skills/agent-memory-principles/references/principles.md +36 -0
- owledge-0.6.0/skills/agent-memory-principles/references/security-rules.md +43 -0
- owledge-0.6.0/skills/agent-memory-runtime-bridge/SKILL.md +72 -0
- owledge-0.6.0/skills/bootstrap-agent-memory/SKILL.md +36 -0
- owledge-0.6.0/skills/owledge-integration-adapters/SKILL.md +34 -0
- owledge-0.6.0/skills/owledge-planning-layer/SKILL.md +71 -0
- owledge-0.6.0/skills/owledge-planning-layer/references/planning-layer.md +89 -0
- owledge-0.6.0/skills/personal-pi-agent/SKILL.md +43 -0
- owledge-0.6.0/skills/pi-agent-global-intelligence/SKILL.md +76 -0
- owledge-0.6.0/skills/pi-agent-red-team-evaluator/SKILL.md +60 -0
- owledge-0.6.0/skills/pi-agent-workspace-quality/SKILL.md +69 -0
- owledge-0.6.0/skills/render-memory-report/SKILL.md +49 -0
- owledge-0.6.0/skills/render-memory-report/references/agent-activity-report.md +30 -0
- owledge-0.6.0/skills/render-memory-report/references/decision-report.md +31 -0
- owledge-0.6.0/skills/render-memory-report/references/execution-dashboard.md +31 -0
- owledge-0.6.0/skills/render-memory-report/references/handoff-report.md +31 -0
- owledge-0.6.0/skills/render-memory-report/references/project-dashboard.md +31 -0
- owledge-0.6.0/skills/render-memory-report/references/project-site.md +33 -0
- owledge-0.6.0/skills/render-memory-report/references/rag-readiness-report.md +31 -0
- owledge-0.6.0/skills/render-memory-report/references/report-design-systems.md +45 -0
- owledge-0.6.0/skills/render-memory-report/references/website-ui-report.md +44 -0
- owledge-0.6.0/skills/review-evaluation-workflow/SKILL.md +78 -0
- owledge-0.6.0/templates/agent-memory/README.md +145 -0
- owledge-0.6.0/templates/agent-memory/canonical/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/compiled/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/decisions/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/evidence/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/evidence/promotions/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/exports/graphrag/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/exports/lightrag/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/exports/rag/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/handoffs/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/ideas/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/indexes/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/lessons/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/patterns/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/pi-agent/concepts/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/pi-agent/evaluations/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/pi-agent/indexes/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/pi-agent/parallels/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/pi-agent/recurring-errors/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/pi-agent/red-team/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/pi-agent/reports/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/pi-agent/scorecards/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/pi-agent/trends/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/plans/.gitkeep +0 -0
- owledge-0.6.0/templates/agent-memory/schemas/agent.schema.json +22 -0
- owledge-0.6.0/templates/agent-memory/schemas/canonical-memory.schema.json +7 -0
- owledge-0.6.0/templates/agent-memory/schemas/compiled-memory.schema.json +7 -0
- owledge-0.6.0/templates/agent-memory/schemas/context-pack.schema.json +19 -0
- owledge-0.6.0/templates/agent-memory/schemas/edge.schema.json +18 -0
- owledge-0.6.0/templates/agent-memory/schemas/epic.schema.json +16 -0
- owledge-0.6.0/templates/agent-memory/schemas/frontmatter.schema.json +40 -0
- owledge-0.6.0/templates/agent-memory/schemas/gate-report.schema.json +17 -0
- owledge-0.6.0/templates/agent-memory/schemas/global-user-memory.schema.json +24 -0
- owledge-0.6.0/templates/agent-memory/schemas/graphrag-edge.schema.json +14 -0
- owledge-0.6.0/templates/agent-memory/schemas/graphrag-node.schema.json +14 -0
- owledge-0.6.0/templates/agent-memory/schemas/lightrag-export.schema.json +19 -0
- owledge-0.6.0/templates/agent-memory/schemas/pattern-card.schema.json +7 -0
- owledge-0.6.0/templates/agent-memory/schemas/promotion.schema.json +17 -0
- owledge-0.6.0/templates/agent-memory/schemas/qa-spec.schema.json +16 -0
- owledge-0.6.0/templates/agent-memory/schemas/rag-document.schema.json +15 -0
- owledge-0.6.0/templates/agent-memory/schemas/shared-lesson.schema.json +14 -0
- owledge-0.6.0/templates/agent-memory/schemas/task-card.schema.json +22 -0
- owledge-0.6.0/templates/agent-memory/schemas/tenant.schema.json +14 -0
- owledge-0.6.0/templates/agent-memory/schemas/workpackage.schema.json +17 -0
- owledge-0.6.0/templates/agent-memory/sessions/.gitkeep +1 -0
- owledge-0.6.0/templates/agent-memory/templates/adr-template.md +44 -0
- owledge-0.6.0/templates/agent-memory/templates/agent-lane-handoff-template.md +28 -0
- owledge-0.6.0/templates/agent-memory/templates/agent-quality-scorecard-template.md +48 -0
- owledge-0.6.0/templates/agent-memory/templates/agent-session-template.md +64 -0
- owledge-0.6.0/templates/agent-memory/templates/canonical-memory-template.md +45 -0
- owledge-0.6.0/templates/agent-memory/templates/coach-report-template.md +39 -0
- owledge-0.6.0/templates/agent-memory/templates/compiled-memory-template.md +47 -0
- owledge-0.6.0/templates/agent-memory/templates/context-pack-template.md +31 -0
- owledge-0.6.0/templates/agent-memory/templates/cross-project-import-manifest-template.md +26 -0
- owledge-0.6.0/templates/agent-memory/templates/daily-note-template.md +36 -0
- owledge-0.6.0/templates/agent-memory/templates/epic-overview-template.md +39 -0
- owledge-0.6.0/templates/agent-memory/templates/evaluation-framework-template.md +61 -0
- owledge-0.6.0/templates/agent-memory/templates/evaluation-persona-pack-template.md +82 -0
- owledge-0.6.0/templates/agent-memory/templates/evidence-template.md +40 -0
- owledge-0.6.0/templates/agent-memory/templates/expert-lens-evaluation-template.md +115 -0
- owledge-0.6.0/templates/agent-memory/templates/gate-report-template.md +31 -0
- owledge-0.6.0/templates/agent-memory/templates/goal-card-template.md +39 -0
- owledge-0.6.0/templates/agent-memory/templates/handoff-packet-template.md +31 -0
- owledge-0.6.0/templates/agent-memory/templates/handoff-template.md +42 -0
- owledge-0.6.0/templates/agent-memory/templates/idea-card-template.md +70 -0
- owledge-0.6.0/templates/agent-memory/templates/multi-perspective-red-team-review-template.md +143 -0
- owledge-0.6.0/templates/agent-memory/templates/onboarding-profile-template.md +36 -0
- owledge-0.6.0/templates/agent-memory/templates/orchestration-delta-template.md +59 -0
- owledge-0.6.0/templates/agent-memory/templates/pattern-card-template.md +44 -0
- owledge-0.6.0/templates/agent-memory/templates/personal-pattern-template.md +34 -0
- owledge-0.6.0/templates/agent-memory/templates/personal-task-template.md +36 -0
- owledge-0.6.0/templates/agent-memory/templates/pi-central-project-template.md +48 -0
- owledge-0.6.0/templates/agent-memory/templates/pi-intelligence-report-template.md +53 -0
- owledge-0.6.0/templates/agent-memory/templates/pi-parallel-report-template.md +44 -0
- owledge-0.6.0/templates/agent-memory/templates/pi-recurring-error-template.md +45 -0
- owledge-0.6.0/templates/agent-memory/templates/pi-red-team-evaluation-template.md +54 -0
- owledge-0.6.0/templates/agent-memory/templates/preference-card-template.md +39 -0
- owledge-0.6.0/templates/agent-memory/templates/project-execution-snapshot-template.md +54 -0
- owledge-0.6.0/templates/agent-memory/templates/project-index-template.md +39 -0
- owledge-0.6.0/templates/agent-memory/templates/project-site-html-template.md +25 -0
- owledge-0.6.0/templates/agent-memory/templates/project-story-snapshot-template.md +52 -0
- owledge-0.6.0/templates/agent-memory/templates/promotion-proposal-template.md +28 -0
- owledge-0.6.0/templates/agent-memory/templates/qa-gate-template.md +42 -0
- owledge-0.6.0/templates/agent-memory/templates/qa-spec-template.md +27 -0
- owledge-0.6.0/templates/agent-memory/templates/rag-export-manifest-template.json +10 -0
- owledge-0.6.0/templates/agent-memory/templates/research-card-template.md +45 -0
- owledge-0.6.0/templates/agent-memory/templates/review-to-task-plan-template.md +85 -0
- owledge-0.6.0/templates/agent-memory/templates/root-review-template.md +47 -0
- owledge-0.6.0/templates/agent-memory/templates/scenario-simulation-evaluation-template.md +92 -0
- owledge-0.6.0/templates/agent-memory/templates/shared-lesson-template.md +42 -0
- owledge-0.6.0/templates/agent-memory/templates/swarm-orchestration-plan-template.md +31 -0
- owledge-0.6.0/templates/agent-memory/templates/task-card-template.md +43 -0
- owledge-0.6.0/templates/agent-memory/templates/techspec-template.md +31 -0
- owledge-0.6.0/templates/agent-memory/templates/user-context-template.md +38 -0
- owledge-0.6.0/templates/agent-memory/templates/workpackage-template.md +35 -0
- owledge-0.6.0/tools/__init__.py +6 -0
- owledge-0.6.0/tools/agent_memory_cli.py +5747 -0
- owledge-0.6.0/tools/build_kb_module.py +499 -0
- owledge-0.6.0/tools/build_project_folder_kit.py +335 -0
- owledge-0.6.0/tools/cross-project-hub/.gitkeep +0 -0
- owledge-0.6.0/tools/cross-project-hub/build-cross-project-map.py +36 -0
- owledge-0.6.0/tools/decision-trace/.gitkeep +0 -0
- owledge-0.6.0/tools/decision-trace/render-decision-trace.py +339 -0
- owledge-0.6.0/tools/enterprise-context-benchmark/.gitkeep +0 -0
- owledge-0.6.0/tools/enterprise-context-benchmark/run-enterprise-context-benchmark.py +743 -0
- owledge-0.6.0/tools/owledge.py +1961 -0
- owledge-0.6.0/tools/poweruser-positioning/.gitkeep +0 -0
- owledge-0.6.0/tools/poweruser-positioning/render-poweruser-positioning.py +242 -0
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Agent Operating Notes Template"
|
|
3
|
+
date: "YYYY-MM-DD"
|
|
4
|
+
version: "0.1.0"
|
|
5
|
+
status: "template"
|
|
6
|
+
owner: "OWNER"
|
|
7
|
+
tenant_id: "TENANT_ID"
|
|
8
|
+
customer_id: "CUSTOMER_ID"
|
|
9
|
+
project: "PROJECT_NAME"
|
|
10
|
+
project_id: "PROJECT_ID"
|
|
11
|
+
type: "template"
|
|
12
|
+
session_id: "YYYY-MM-DD-short-task-title"
|
|
13
|
+
agent_id: "orchestrator"
|
|
14
|
+
parent_session: ""
|
|
15
|
+
related_files:
|
|
16
|
+
- "PROJECT_CONTEXT.md"
|
|
17
|
+
tags:
|
|
18
|
+
- agents
|
|
19
|
+
- runtime-instructions
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
# Agent Operating Notes
|
|
23
|
+
|
|
24
|
+
This file is intentionally mirrored with the sibling runtime instruction file. Keep `AGENTS.md` and `CLAUDE.md` in sync.
|
|
25
|
+
|
|
26
|
+
## Start Here
|
|
27
|
+
|
|
28
|
+
1. Read `USER_CONTEXT.md` when present for private user preferences, goals, and agent collaboration defaults.
|
|
29
|
+
2. Read `PROJECT_CONTEXT.md` before starting substantial project work.
|
|
30
|
+
3. Check `global-memory/preferences/`, `global-memory/goals/`, and `global-memory/research/` when planning or personal context matters.
|
|
31
|
+
4. Check `agent-memory/README.md` for the multi-agent documentation workflow.
|
|
32
|
+
5. Check active local plans in `agent-plans/` if the task references planning, architecture, or handoff context.
|
|
33
|
+
6. Check `agent-memory/ideas/` and `global-memory/ideas/` before drafting new plans or proposing new projects.
|
|
34
|
+
7. Use `agent-memory/pi-agent/` reports when the task asks about trends, parallels, recurring errors, or central project candidates.
|
|
35
|
+
8. Use `agent-memory/pi-agent/red-team/` scorecards when PI findings or agent outputs need quality challenge.
|
|
36
|
+
9. Use `README.md` and `docs/` for user-facing setup details.
|
|
37
|
+
|
|
38
|
+
## Memory Layers
|
|
39
|
+
|
|
40
|
+
| Layer | Path | Tracked | Purpose |
|
|
41
|
+
| --- | --- | --- | --- |
|
|
42
|
+
| Global user context | `USER_CONTEXT.md` | No by default | Private user profile, preferences, goals, and agent collaboration defaults |
|
|
43
|
+
| Global user memory | `global-memory/` | No by default | Private preferences, goals, daily notes, tasks, ideas, research, patterns, and coach reports |
|
|
44
|
+
| Canonical project router | `PROJECT_CONTEXT.md` | Yes | Current vision, state, architecture, plans, decisions, and next actions |
|
|
45
|
+
| Stable agent memory | `agent-memory/` | Yes | Session summaries, ADRs, templates, and reusable workflow documentation |
|
|
46
|
+
| Idea memory | `agent-memory/ideas/` | Yes | Captured ideas and future project opportunities |
|
|
47
|
+
| PI intelligence | `agent-memory/pi-agent/` | Yes | Candidate reports, parallels, trends, recurring errors, and central project concepts |
|
|
48
|
+
| PI red team | `agent-memory/pi-agent/red-team/` | Yes | Scorecards and challenge reports for PI findings |
|
|
49
|
+
| Local working plans | `agent-plans/` | No | Volatile task plans and scratch planning notes |
|
|
50
|
+
| User-facing docs | `README.md`, `docs/` | Yes | Setup, operations, release, and deployment guides |
|
|
51
|
+
|
|
52
|
+
## Multi-Agent Session Rules
|
|
53
|
+
|
|
54
|
+
- One writer per file.
|
|
55
|
+
- Subagents never edit canonical docs.
|
|
56
|
+
- Orchestrators own deltas.
|
|
57
|
+
- Reviewers own reviews.
|
|
58
|
+
- Stable findings are promoted only after review.
|
|
59
|
+
|
|
60
|
+
## Markdown Memory Rules
|
|
61
|
+
|
|
62
|
+
- Treat Markdown frontmatter and typed edges as the durable source of truth.
|
|
63
|
+
- Use stable `memory_id` values for links, graph edges, and RAG ids.
|
|
64
|
+
- Read `USER_CONTEXT.md`, relevant global preferences/goals/research, `PROJECT_CONTEXT.md`, then `agent-memory/indexes/memory-index.jsonl`, then relevant compiled/canonical docs.
|
|
65
|
+
- Workers write only sessions, evidence, handoffs, and task notes.
|
|
66
|
+
- Ideas are captured in `agent-memory/ideas/` as drafts and checked before new plans.
|
|
67
|
+
- Global ideas, preferences, goals, daily notes, tasks, research and coach reports live under `global-memory/` and remain private by default.
|
|
68
|
+
- Daily notes, personal tasks, and onboarding profiles are deep-dive sources only and are not default RAG input.
|
|
69
|
+
- Research cards must include source URL, source date, retrieval date, version context, valid-until date, and confidence.
|
|
70
|
+
- Coach recommendations must cite source memory IDs and include a next action.
|
|
71
|
+
- PI Agent findings are candidate intelligence in `agent-memory/pi-agent/` and require review before promotion.
|
|
72
|
+
- PI Red Team evaluations score outputs from 1-100 and classify them as `block`, `revise`, `accept`, or `promote-candidate`.
|
|
73
|
+
- Orchestrators and memory curators own promotion into canonical, compiled, patterns, and lessons.
|
|
74
|
+
- Attach evidence and gate reports before requesting promotion.
|
|
75
|
+
- Do not mark work `done` unless the required QA gates pass.
|
|
76
|
+
- Build a task-specific context pack instead of pasting long transcripts.
|
|
77
|
+
- Do not export raw sessions to shared RAG by default.
|
|
78
|
+
- Preserve contradictions through `contradicts` edges instead of overwriting history.
|
|
79
|
+
- Do not read, claim, export, or promote artifacts from another `tenant_id` unless `shared_scope` explicitly allows it.
|
|
80
|
+
|
|
81
|
+
## Optional Runtime Adapters
|
|
82
|
+
|
|
83
|
+
SQLite, HTTP, MCP, or runtime plugins may coordinate work, but they must not become the canonical memory store. Generated indexes and RAG exports can always be rebuilt from Markdown.
|
|
84
|
+
|
|
85
|
+
The optional `plugins/agent-memory-cowork/` adapter can capture Claude/Cowork runtime events into private sessions and draft summaries. Treat those drafts as unreviewed until a memory curator promotes them.
|
|
86
|
+
|
|
87
|
+
The optional `plugins/pi-agent-workspace/` adapter can run workspace checks and PI intelligence reports. Treat generated PI reports as review inputs, not accepted memory.
|
|
88
|
+
The optional Red Team PI Agent challenges PI reports and agent outputs before promotion decisions.
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.6.0 (2026-06-24)
|
|
4
|
+
|
|
5
|
+
- Refactor: split development dogfood from product deliverables (commit `3440e30`).
|
|
6
|
+
Moved product source to `templates/agent-memory/`, moved all dogfood to
|
|
7
|
+
`internal/agent-memory/`, removed root `agent-memory/` entirely.
|
|
8
|
+
- Added 4 integrity gates: `kit-integrity`, `addon-boundary-check`,
|
|
9
|
+
`source-vs-target-audit`, `sdist-clean`.
|
|
10
|
+
- Updated `MANIFEST.in` to include `templates/` and exclude `internal/` (clean
|
|
11
|
+
sdist with zero dogfood paths).
|
|
12
|
+
- Updated `CONTRIBUTING.md` with Dogfooding vs. Product section.
|
|
13
|
+
- Fixed `finalization-gates` invocation to use `--project-root .` (auto-detects
|
|
14
|
+
`internal/agent-memory/` for memory operations) in CI, AGENTS.md, CLAUDE.md,
|
|
15
|
+
and internal/README.md.
|
|
16
|
+
- Mirrored `.gitignore` patterns for `internal/agent-memory/` so generated
|
|
17
|
+
dogfood artifacts (shared-* exports, red-team reports, tmp, indexes) are no
|
|
18
|
+
longer tracked; latest snapshots remain tracked as evidence.
|
|
19
|
+
- Added `docs/feedback-round-2026-06.md` with 17 feedback tickets (FB-001 through
|
|
20
|
+
FB-017, including Round 2 feature ideas FB-013 through FB-017).
|
|
21
|
+
- Added `docs/roadmap-ideas-2026-06.md` with 16 idea cards (IDEA-2026-006-01
|
|
22
|
+
through -16, including Round 2 feature ideas -12 through -16).
|
|
23
|
+
- Added `docs/agents-md-integration-block.md` — SOTA copy-paste block for
|
|
24
|
+
integrating Owledge into existing AGENTS.md/CLAUDE.md.
|
|
25
|
+
- Added `docs/pi-agent-setup.md` — PI Agent setup guide.
|
|
26
|
+
- Added `docs/v0.6.0-implementation-plan.md` — detailed plan for landing the
|
|
27
|
+
12 remaining feedback features in a future release.
|
|
28
|
+
- Updated `ROADMAP.md` with feedback-derived roadmap section.
|
|
29
|
+
|
|
30
|
+
## 0.5.0
|
|
31
|
+
|
|
32
|
+
- Added retention lifecycle fields, read-only retention audit, conflict review, and sensitive-data scan wrappers.
|
|
33
|
+
- Added objective-aware context-pack scoring with `score_breakdown`, `freshness_warnings`, and explicit exclusion reasons.
|
|
34
|
+
- Added retrieval calibration fixtures, query-file support, and minimum score thresholds for release gates.
|
|
35
|
+
- Added minimal project-folder-only generator and quickstart docs.
|
|
36
|
+
- Added runtime adapter smoke tests, finalization gate runner, and red-team QA wrapper.
|
|
37
|
+
- Added Agentic Memory architecture docs mapping working, semantic, procedural, and episodic memory.
|
|
38
|
+
|
|
39
|
+
## 0.4.0
|
|
40
|
+
|
|
41
|
+
- Added global/project memory kit instructions and expanded PI Agent memory folders.
|
|
42
|
+
- Added reusable review workflows, HTML report rendering, and publishing docs.
|
|
43
|
+
- Added incremental indexing and host verification hardening.
|
|
44
|
+
|
|
45
|
+
## 0.3.0
|
|
46
|
+
|
|
47
|
+
- Added Markdown-first Agent Memory core.
|
|
48
|
+
- Added strict frontmatter, stable `memory_id`s, typed edges, templates, and schemas.
|
|
49
|
+
- Added validation, memory index, context pack, RAG, LightRAG, GraphRAG, and retrieval eval tools.
|
|
50
|
+
- Added optional Claude/Cowork and Codex plugin adapter.
|
|
51
|
+
- Added private runtime capture and draft session summaries.
|
|
52
|
+
- Added ignored dogfood projects for multi-agent and Zeus simulations.
|
|
53
|
+
- Added publish preparation, privacy/security docs, and compliance roadmap.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Agent Operating Notes Template"
|
|
3
|
+
date: "YYYY-MM-DD"
|
|
4
|
+
version: "0.1.0"
|
|
5
|
+
status: "template"
|
|
6
|
+
owner: "OWNER"
|
|
7
|
+
tenant_id: "TENANT_ID"
|
|
8
|
+
customer_id: "CUSTOMER_ID"
|
|
9
|
+
project: "PROJECT_NAME"
|
|
10
|
+
project_id: "PROJECT_ID"
|
|
11
|
+
type: "template"
|
|
12
|
+
session_id: "YYYY-MM-DD-short-task-title"
|
|
13
|
+
agent_id: "orchestrator"
|
|
14
|
+
parent_session: ""
|
|
15
|
+
related_files:
|
|
16
|
+
- "PROJECT_CONTEXT.md"
|
|
17
|
+
tags:
|
|
18
|
+
- agents
|
|
19
|
+
- runtime-instructions
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
# Agent Operating Notes
|
|
23
|
+
|
|
24
|
+
This file is intentionally mirrored with the sibling runtime instruction file. Keep `AGENTS.md` and `CLAUDE.md` in sync.
|
|
25
|
+
|
|
26
|
+
## Start Here
|
|
27
|
+
|
|
28
|
+
1. Read `USER_CONTEXT.md` when present for private user preferences, goals, and agent collaboration defaults.
|
|
29
|
+
2. Read `PROJECT_CONTEXT.md` before starting substantial project work.
|
|
30
|
+
3. Check `global-memory/preferences/`, `global-memory/goals/`, and `global-memory/research/` when planning or personal context matters.
|
|
31
|
+
4. Check `agent-memory/README.md` for the multi-agent documentation workflow.
|
|
32
|
+
5. Check active local plans in `agent-plans/` if the task references planning, architecture, or handoff context.
|
|
33
|
+
6. Check `agent-memory/ideas/` and `global-memory/ideas/` before drafting new plans or proposing new projects.
|
|
34
|
+
7. Use `agent-memory/pi-agent/` reports when the task asks about trends, parallels, recurring errors, or central project candidates.
|
|
35
|
+
8. Use `agent-memory/pi-agent/red-team/` scorecards when PI findings or agent outputs need quality challenge.
|
|
36
|
+
9. Use `README.md` and `docs/` for user-facing setup details.
|
|
37
|
+
|
|
38
|
+
## Memory Layers
|
|
39
|
+
|
|
40
|
+
| Layer | Path | Tracked | Purpose |
|
|
41
|
+
| --- | --- | --- | --- |
|
|
42
|
+
| Global user context | `USER_CONTEXT.md` | No by default | Private user profile, preferences, goals, and agent collaboration defaults |
|
|
43
|
+
| Global user memory | `global-memory/` | No by default | Private preferences, goals, daily notes, tasks, ideas, research, patterns, and coach reports |
|
|
44
|
+
| Canonical project router | `PROJECT_CONTEXT.md` | Yes | Current vision, state, architecture, plans, decisions, and next actions |
|
|
45
|
+
| Stable agent memory | `agent-memory/` | Yes | Session summaries, ADRs, templates, and reusable workflow documentation |
|
|
46
|
+
| Idea memory | `agent-memory/ideas/` | Yes | Captured ideas and future project opportunities |
|
|
47
|
+
| PI intelligence | `agent-memory/pi-agent/` | Yes | Candidate reports, parallels, trends, recurring errors, and central project concepts |
|
|
48
|
+
| PI red team | `agent-memory/pi-agent/red-team/` | Yes | Scorecards and challenge reports for PI findings |
|
|
49
|
+
| Local working plans | `agent-plans/` | No | Volatile task plans and scratch planning notes |
|
|
50
|
+
| User-facing docs | `README.md`, `docs/` | Yes | Setup, operations, release, and deployment guides |
|
|
51
|
+
|
|
52
|
+
## Multi-Agent Session Rules
|
|
53
|
+
|
|
54
|
+
- One writer per file.
|
|
55
|
+
- Subagents never edit canonical docs.
|
|
56
|
+
- Orchestrators own deltas.
|
|
57
|
+
- Reviewers own reviews.
|
|
58
|
+
- Stable findings are promoted only after review.
|
|
59
|
+
|
|
60
|
+
## Markdown Memory Rules
|
|
61
|
+
|
|
62
|
+
- Treat Markdown frontmatter and typed edges as the durable source of truth.
|
|
63
|
+
- Use stable `memory_id` values for links, graph edges, and RAG ids.
|
|
64
|
+
- Read `USER_CONTEXT.md`, relevant global preferences/goals/research, `PROJECT_CONTEXT.md`, then `agent-memory/indexes/memory-index.jsonl`, then relevant compiled/canonical docs.
|
|
65
|
+
- Workers write only sessions, evidence, handoffs, and task notes.
|
|
66
|
+
- Ideas are captured in `agent-memory/ideas/` as drafts and checked before new plans.
|
|
67
|
+
- Global ideas, preferences, goals, daily notes, tasks, research and coach reports live under `global-memory/` and remain private by default.
|
|
68
|
+
- Daily notes, personal tasks, and onboarding profiles are deep-dive sources only and are not default RAG input.
|
|
69
|
+
- Research cards must include source URL, source date, retrieval date, version context, valid-until date, and confidence.
|
|
70
|
+
- Coach recommendations must cite source memory IDs and include a next action.
|
|
71
|
+
- PI Agent findings are candidate intelligence in `agent-memory/pi-agent/` and require review before promotion.
|
|
72
|
+
- PI Red Team evaluations score outputs from 1-100 and classify them as `block`, `revise`, `accept`, or `promote-candidate`.
|
|
73
|
+
- Orchestrators and memory curators own promotion into canonical, compiled, patterns, and lessons.
|
|
74
|
+
- Attach evidence and gate reports before requesting promotion.
|
|
75
|
+
- Do not mark work `done` unless the required QA gates pass.
|
|
76
|
+
- Build a task-specific context pack instead of pasting long transcripts.
|
|
77
|
+
- Do not export raw sessions to shared RAG by default.
|
|
78
|
+
- Preserve contradictions through `contradicts` edges instead of overwriting history.
|
|
79
|
+
- Do not read, claim, export, or promote artifacts from another `tenant_id` unless `shared_scope` explicitly allows it.
|
|
80
|
+
|
|
81
|
+
## Optional Runtime Adapters
|
|
82
|
+
|
|
83
|
+
SQLite, HTTP, MCP, or runtime plugins may coordinate work, but they must not become the canonical memory store. Generated indexes and RAG exports can always be rebuilt from Markdown.
|
|
84
|
+
|
|
85
|
+
The optional `plugins/agent-memory-cowork/` adapter can capture Claude/Cowork runtime events into private sessions and draft summaries. Treat those drafts as unreviewed until a memory curator promotes them.
|
|
86
|
+
|
|
87
|
+
The optional `plugins/pi-agent-workspace/` adapter can run workspace checks and PI intelligence reports. Treat generated PI reports as review inputs, not accepted memory.
|
|
88
|
+
The optional Red Team PI Agent challenges PI reports and agent outputs before promotion decisions.
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Contributing
|
|
2
|
+
|
|
3
|
+
## Focus
|
|
4
|
+
|
|
5
|
+
Owledge accepts contributions that improve:
|
|
6
|
+
|
|
7
|
+
- Markdown-first memory workflows
|
|
8
|
+
- project planning and handoff quality
|
|
9
|
+
- safe integration with existing knowledgebases
|
|
10
|
+
- runtime adapters and documentation
|
|
11
|
+
- release gates, benchmarks, and public repo quality
|
|
12
|
+
|
|
13
|
+
## Before Opening A Pull Request
|
|
14
|
+
|
|
15
|
+
Run:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
python tools/owledge.py test public-docs --project-root .
|
|
19
|
+
python tools/owledge.py finalization-gates --project-root internal --include-compliance
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Pull Request Rules
|
|
23
|
+
|
|
24
|
+
- Keep Markdown as the source of truth.
|
|
25
|
+
- Do not add global-setup requirements unless they are optional compatibility paths.
|
|
26
|
+
- Do not rewrite existing KB notes or wiki links by default.
|
|
27
|
+
- Keep public docs concise and GitHub-readable.
|
|
28
|
+
- Add or update tests when behavior, contracts, docs integrity, or packaging changes.
|
|
29
|
+
|
|
30
|
+
## Scope Discipline
|
|
31
|
+
|
|
32
|
+
This repository is a local/project utility layer. Avoid turning it into a hosted platform, enterprise control plane, or mandatory migration framework without an explicit design decision.
|
|
33
|
+
|
|
34
|
+
## Dogfooding vs. Product
|
|
35
|
+
|
|
36
|
+
- `templates/agent-memory/` is the shipped source. Only commit schemas, templates, and `.gitkeep` here.
|
|
37
|
+
- `internal/agent-memory/` is the maintainers' live workspace. Generated artifacts (indexes, exports, decision traces, compiled snapshots) go here.
|
|
38
|
+
- Never commit generated files to `templates/`.
|
|
39
|
+
- Run dogfood gates against `internal/`: `python tools/owledge.py finalization-gates --project-root internal --include-compliance --include-exports`
|
owledge-0.6.0/DESIGN.md
ADDED
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
---
|
|
2
|
+
selected_report_design: "atlas-command"
|
|
3
|
+
design_catalog_version: "0.1.0"
|
|
4
|
+
status: "draft"
|
|
5
|
+
updated_at: "2026-05-12"
|
|
6
|
+
source_of_truth: "DESIGN.md"
|
|
7
|
+
applies_to:
|
|
8
|
+
- decision
|
|
9
|
+
- handoff
|
|
10
|
+
- rag-readiness
|
|
11
|
+
- agent-activity
|
|
12
|
+
- project-dashboard
|
|
13
|
+
- website-ui
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# Report Design System
|
|
17
|
+
|
|
18
|
+
`DESIGN.md` is the central design decision file for all generated Agent Memory HTML reports. Markdown remains the source of truth. HTML files are generated views and must read this file before choosing colors, spacing, density, and report personality.
|
|
19
|
+
|
|
20
|
+
## Selected Design
|
|
21
|
+
|
|
22
|
+
| Field | Value |
|
|
23
|
+
| --- | --- |
|
|
24
|
+
| Selected design id | `atlas-command` |
|
|
25
|
+
| Selected design name | Atlas Command |
|
|
26
|
+
| Intended use | Dense enterprise dashboards, multi-agent status reports, RAG readiness views |
|
|
27
|
+
| Default density | Compact |
|
|
28
|
+
| Default mode | Light |
|
|
29
|
+
|
|
30
|
+
## Persistence Rule
|
|
31
|
+
|
|
32
|
+
When a user chooses a report style in `REPORT_DESIGN_SELECTOR.html`, persist the chosen style by updating `selected_report_design` in this file and keeping the selected row below unchanged. Generated reports should include the selected design id in their metadata.
|
|
33
|
+
|
|
34
|
+
## Branding Model
|
|
35
|
+
|
|
36
|
+
Current v0.2 behavior is intentionally simple: one global `selected_report_design` controls all generated reports in a project.
|
|
37
|
+
|
|
38
|
+
Future multi-brand behavior should add named profiles without breaking the current field:
|
|
39
|
+
|
|
40
|
+
```yaml
|
|
41
|
+
selected_report_design: "atlas-command"
|
|
42
|
+
brand_profiles:
|
|
43
|
+
default: "atlas-command"
|
|
44
|
+
internal: "signal-grid"
|
|
45
|
+
customer_acme: "nordic-clarity"
|
|
46
|
+
executive: "executive-ledger"
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Report generation can then accept a future `brand_profile` option while still falling back to `selected_report_design`.
|
|
50
|
+
|
|
51
|
+
## Design Catalog
|
|
52
|
+
|
|
53
|
+
| ID | Name | Best For | Visual Character | Primary | Background | Risk |
|
|
54
|
+
| --- | --- | --- | --- | --- | --- | --- |
|
|
55
|
+
| `atlas-command` | Atlas Command | Enterprise operations, RAG readiness, multi-agent dashboards | Command-center clarity with restrained blue, graphite, and crisp tables | `#245c88` | `#f6f7f9` | Can feel too operational for client-facing brand reports |
|
|
56
|
+
| `glass-ledger` | Glass Ledger | Governance, audit trails, compliance-adjacent decisions | Translucent panels, precise borders, cool neutrals | `#317873` | `#eef5f3` | Needs careful contrast for dense tables |
|
|
57
|
+
| `signal-grid` | Signal Grid | Metrics, retrieval evals, performance reports | High-signal grids, amber accents, terminal-inspired density | `#b36b00` | `#111418` | Dark mode may be too intense for executive exports |
|
|
58
|
+
| `courtroom-brief` | Courtroom Brief | ADRs, decisions, risk tradeoffs, evidence chains | Formal legal brief styling with serif headings and warm paper | `#7a3b1f` | `#fbf7ef` | Less suitable for technical dashboards |
|
|
59
|
+
| `mission-control` | Mission Control | Agent orchestration, task flow, delegation reports | Dark control-room panels, cyan status accents, strong grouping | `#35b7d8` | `#071117` | Should not be used for printable reports |
|
|
60
|
+
| `blueprint-studio` | Blueprint Studio | Architecture, UI systems, implementation plans | Blueprint grid, technical annotations, crisp cyan lines | `#1178a8` | `#edf7fb` | Can overemphasize technical structure |
|
|
61
|
+
| `executive-ledger` | Executive Ledger | Client status, management updates, board-style summaries | Quiet premium editorial system with navy, ivory, and gold accents | `#9b7a2f` | `#faf8f1` | Lower visual energy for engineering teams |
|
|
62
|
+
| `graph-aurora` | Graph Aurora | GraphRAG, cross-project parallels, semantic maps | Layered graph feel, saturated accent pairs, soft dark canvas | `#78d6a3` | `#10151f` | Needs restraint to avoid decorative noise |
|
|
63
|
+
| `monolith-minimal` | Monolith Minimal | Dense technical review, source-heavy reports | Brutal clarity, monochrome, hard lines, compact cards | `#111111` | `#f3f3f0` | Too severe for customer storytelling |
|
|
64
|
+
| `workshop-canvas` | Workshop Canvas | PM to dev handoffs, planning sessions, collaborative reviews | Whiteboard structure, sticky-note accents, approachable hierarchy | `#d66a28` | `#fffaf2` | Can feel informal for compliance reports |
|
|
65
|
+
| `neon-console` | Neon Console | Runtime logs, agent activity, dev demos | Black console canvas, green/cyan highlights, monospace data blocks | `#39ff88` | `#050806` | Not ideal for long-form reading |
|
|
66
|
+
| `nordic-clarity` | Nordic Clarity | Customer-safe reports, documentation, handoffs | Calm light surfaces, cool grays, precise blue-green accents | `#3f8f95` | `#f7faf9` | May feel too quiet for brand selection |
|
|
67
|
+
| `evidence-vault` | Evidence Vault | Source provenance, QA gates, audit reports | Secure archive look, dark slate, red/orange status semantics | `#d24b35` | `#111820` | Strong security tone can make normal reports feel high-risk |
|
|
68
|
+
| `product-lab` | Product Lab | Website/UI decisions, design tokens, experiments | Modular design-board layout with vivid swatches and sliders | `#e24d7b` | `#fff6f8` | Needs token discipline to stay polished |
|
|
69
|
+
| `zeus-celestial` | Zeus Celestial | Vision decks, strategic narratives, Zeus-style AI agency reports | High-contrast cosmic editorial with electric blue and silver | `#65a9ff` | `#080b13` | Use sparingly for polished storytelling, not raw QA |
|
|
70
|
+
|
|
71
|
+
## Token Contract
|
|
72
|
+
|
|
73
|
+
Each design must resolve to these tokens:
|
|
74
|
+
|
|
75
|
+
| Token | Meaning |
|
|
76
|
+
| --- | --- |
|
|
77
|
+
| `report.background` | Page background |
|
|
78
|
+
| `report.panel` | Card and section surface |
|
|
79
|
+
| `report.foreground` | Primary text |
|
|
80
|
+
| `report.ink` | Legacy alias for primary text |
|
|
81
|
+
| `report.muted` | Secondary text |
|
|
82
|
+
| `report.line` | Borders and dividers |
|
|
83
|
+
| `report.accent` | Primary action and emphasis color |
|
|
84
|
+
| `report.accent_2` | Secondary accent for charts, graph edges, or visual contrast |
|
|
85
|
+
| `report.radius` | Card and control radius |
|
|
86
|
+
| `report.density` | Density in pixels or compact/balanced/spacious alias |
|
|
87
|
+
| `report.border_width` | Standard report border width |
|
|
88
|
+
| `report.border_style` | `solid`, `dashed`, `dotted`, or `double` |
|
|
89
|
+
| `report.font_mode` | System, editorial, mono, or hybrid |
|
|
90
|
+
| `button.primary_bg` | Primary button background |
|
|
91
|
+
| `button.primary_fg` | Primary button text |
|
|
92
|
+
| `button.secondary_bg` | Secondary button background |
|
|
93
|
+
| `button.secondary_fg` | Secondary button text |
|
|
94
|
+
| `button.radius` | Button radius |
|
|
95
|
+
| `button.weight` | Button font weight |
|
|
96
|
+
| `button.case` | Button text transform |
|
|
97
|
+
| `ornament.mode` | Optional visual motif: none, grid, beam, ledger, radial |
|
|
98
|
+
| `shadow.color` | Shadow color source |
|
|
99
|
+
| `shadow.strength` | Shadow depth/intensity |
|
|
100
|
+
|
|
101
|
+
## Merge Note For AI-WorkOS Obsidian Vault
|
|
102
|
+
|
|
103
|
+
The uploaded AI-WorkOS Obsidian Vault should not replace Agent Memory Kit. It is best treated as an upstream concept library and migration source.
|
|
104
|
+
|
|
105
|
+
| Vault Concept | Merge Target | Decision |
|
|
106
|
+
| --- | --- | --- |
|
|
107
|
+
| `00_SYSTEM/MERGE_MAP.md` scoring | `find-parallels` and future merge assessment docs | Merge as a cross-project evaluation rubric |
|
|
108
|
+
| `00_SYSTEM/FRONTMATTER_SCHEMA.md` flat Obsidian fields | `agent-memory/schemas/frontmatter.schema.json` | Map concepts, keep stricter Agent Memory fields |
|
|
109
|
+
| `00_SYSTEM/GRAPH_SCHEMA.md` node/edge vocabulary | `agent-memory/schemas/graphrag-*.schema.json` | Merge vocabulary as aliases, keep typed frontmatter edges |
|
|
110
|
+
| `00_SYSTEM/INGEST_PIPELINE.md` raw to reviewed flow | runtime capture and session compaction docs | Merge as lifecycle documentation |
|
|
111
|
+
| `00_SYSTEM/RAG_INDEXING_POLICY.md` tier model | RAG export policy | Merge as index priority tiers |
|
|
112
|
+
| Obsidian folder taxonomy | Optional enterprise hub adapter | Keep separate, do not force into project-local core |
|
|
113
|
+
|
|
114
|
+
Recommendation: keep the vault as a second-system adapter until a migration tool can map its `type/id/canonical/kb_ready/confidentiality` fields into Agent Memory `memory_id/doc_type/status/review_status/sanitization_status/data_class/edges`.
|
owledge-0.6.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Agent Memory Kit contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
include AGENTS.template.md
|
|
2
|
+
include CHANGELOG.md
|
|
3
|
+
include CLAUDE.template.md
|
|
4
|
+
include CONTRIBUTING.md
|
|
5
|
+
include DESIGN.md
|
|
6
|
+
include LICENSE
|
|
7
|
+
include PRIVACY.md
|
|
8
|
+
include PROJECT_CONTEXT.template.md
|
|
9
|
+
include README.md
|
|
10
|
+
include REPORT_DESIGN_SELECTOR.html
|
|
11
|
+
include SECURITY.md
|
|
12
|
+
include USER_CONTEXT.template.md
|
|
13
|
+
include VERSION
|
|
14
|
+
recursive-include addons *
|
|
15
|
+
recursive-include templates *
|
|
16
|
+
recursive-include assets *
|
|
17
|
+
recursive-include benchmarks *
|
|
18
|
+
recursive-include docs *
|
|
19
|
+
recursive-include examples *
|
|
20
|
+
recursive-include plugins *
|
|
21
|
+
recursive-include skills *
|
|
22
|
+
recursive-include tools *
|
|
23
|
+
recursive-exclude .agent-control *
|
|
24
|
+
recursive-exclude .git *
|
|
25
|
+
recursive-exclude internal *
|
|
26
|
+
recursive-exclude global-memory *
|
|
27
|
+
global-exclude __pycache__
|
|
28
|
+
global-exclude *.py[cod]
|