Skip to main content

A drop-in markdown cognition layer for AI agents that need to analyze public agenda

Project description

Agenda Intelligence MD

PyPI version License: MIT CI Status GitHub stars

A drop‑in cognition layer for AI agents that stops them from just summarizing news and starts producing decision‑ready analysis.

Bottom line: agents using this protocol move from “monitor developments” to “watch these 3 indicators; if X happens, decision Y becomes urgent.”


🚀 Quick start (OpenClaw)

  1. Install skill (recommended):

    clawhub install agenda-intelligence
    

    Or copy skills/agenda-intelligence/ into your workspace.

  2. Use in a prompt:

    [skill:agenda-intelligence]
    Brief: "EU AI Act amendment adds new high‑risk categories."
    

    The agent will load the protocol, run the CLI, and return a compact brief.

  3. Or use the CLI directly (after pip install agenda-intelligence-md):

    agenda-intelligence validate-brief examples/agenda-brief.json
    agenda-intelligence source-plan technology-ai
    

🎯 What it does

Without Agenda‑Intelligence.md With Agenda‑Intelligence.md
“Companies should monitor developments.” “Watch for regulator guidance, first enforcement action, compliance deadline, and product redesigns. Treat as signal until those indicators appear.”

The protocol forces the agent to answer:

  • Signal classification: noise → weak signal → signal → structural shift → trigger event
  • What changed? (fact)
  • Why it matters? (incentives, leverage)
  • Who is affected?
  • Main uncertainty?
  • Scenarios & watch‑next indicators

Result: shorter output, higher decision value.


🧠 Key features

  • Source Acquisition Layer – tells the agent which source types to check before making claims (sanctions, regulation, elections, conflict, etc.).
  • AnalysisBank – a memory layer that stores reusable reasoning patterns from good/bad outputs.
  • Regional lenses – Central Asia & Caspian, Middle East, EU.
  • Sector lenses – sanctions, export controls.
  • JSON schemas – validate briefs, evidence packs, memory cards.
  • CLI & Python APIagenda-intelligence command, agent-manifest.json for discovery.

📦 Installation

From PyPI (when published)

pip install agenda-intelligence-md

From GitHub Release

pip install https://github.com/vassiliylakhonin/agenda-intelligence-md/releases/download/v0.5.0/agenda_intelligence_md-0.5.0-py3-none-any.whl

Editable install from source

git clone https://github.com/vassiliylakhonin/agenda-intelligence-md
cd agenda-intelligence-md
pip install -e .

🛠 CLI examples

agenda-intelligence --help
agenda-intelligence manifest
agenda-intelligence list-lenses
agenda-intelligence source-types
agenda-intelligence source-plan sanctions
agenda-intelligence validate-brief examples/agenda-brief.json
agenda-intelligence validate-evidence examples/source/evidence-pack.json
agenda-intelligence memory-search "sanctions routing"

📚 Documentation


🏗 Repository structure

agenda-intelligence-md/
├─ src/agenda_intelligence/   # Python package
├─ schemas/                   # JSON schemas
├─ examples/                  # sample briefs, evidence packs
├─ analysis-bank/             # memory cards (failures & successes)
├─ skills/agenda-intelligence/ # OpenClaw skill wrapper
├─ docs/                      # guides & integration notes
└─ tests/                     # pytest suite

🤝 Contributing

Pull requests are welcome! Please:

  1. Open an issue to discuss changes.
  2. Create a feature branch (feat/..., fix/...).
  3. Run pytest and ensure all tests pass.
  4. Update docs if behavior changes.

See docs/quickstart.md for development setup.


📄 License

MIT – free for any use.


🔗 Related projects


Why this exists: Most agent‑written news analysis is a polished recap that doesn’t change any decision. This project gives agents a stricter workflow so their output actually helps someone decide, hedge, or act.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agenda_intelligence_md-0.5.1.tar.gz (36.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agenda_intelligence_md-0.5.1-py3-none-any.whl (43.6 kB view details)

Uploaded Python 3

File details

Details for the file agenda_intelligence_md-0.5.1.tar.gz.

File metadata

  • Download URL: agenda_intelligence_md-0.5.1.tar.gz
  • Upload date:
  • Size: 36.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for agenda_intelligence_md-0.5.1.tar.gz
Algorithm Hash digest
SHA256 52565d57c1368b4f29ea22505f456e3dcd078ce3f0614220ef0ae956a0420a3d
MD5 5648aa98afd5b1818831a51a5922267d
BLAKE2b-256 07bbe1b6c65d979a30689e34d29d7acd2616dc58a1de55b1d7e95a5efcf3ffc8

See more details on using hashes here.

File details

Details for the file agenda_intelligence_md-0.5.1-py3-none-any.whl.

File metadata

File hashes

Hashes for agenda_intelligence_md-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2916a4dd84864b994dd1e2fa57007761af33bdfff2b73bed36e75ff96f059700
MD5 8da20f0e2616118c37611b3aa14f049f
BLAKE2b-256 4252d0b80f00e775a157858eb501e96bc86d52c97d5de06e97b0eafa6ef353f9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page