Self-hosted agent pack for orchestrating an autonomous agent specialized in veille. Version 2.0.0 — actionable kit with scripts, templates, named prompts and an extended checklist.

Overview

This pack provides an operational autonomous agent for the veille domain. It includes a dedicated OODA loop, versioned prompts, configuration templates and a set of installation, test and execution scripts.

The pack is designed to be self-hosted (BYO-LLM): no API key is included. The LLM adapter detects a local or CLI provider (ollama, claude-code, kimi, codex).

Architecture

┌─────────────────────────────────────────────────────────────────────┐
│                         Signal / External input                     │
└──────────────────────────────────┬──────────────────────────────────┘
                                   ▼
┌─────────────────────────────────────────────────────────────────────┐
│  COLLECTING → FILTERING → ANALYZING → SYNTHESIZING → ALERTING → ARCHIVING  │
│                           OODA State Machine                         │
└──────────────────────────────────┬──────────────────────────────────┘
                                   ▼
┌─────────────────────────────────────────────────────────────────────┐
│  Named prompts  → Deterministic handler →  BYO-LLM Adapter          │
│  scripts/test_prompt.py    scripts/run_agent.py                     │
└──────────────────────────────────┬──────────────────────────────────┘
                                   ▼
┌─────────────────────────────────────────────────────────────────────┐
│  SQLite queue  →  templates/*.yaml  →  Action / Output / Archive    │
└─────────────────────────────────────────────────────────────────────┘

Pack contents

File	Role
`README.md`	This file — overview and quick-start
`SOUL.md`	Mission, values and `veille`-specific OODA states
`PROMPTS.md`	5 named and versioned system prompts
`CHECKLIST.md`	30+ operational steps with commands
`SPEC.md`	Technical spec, configurable parameters, interfaces
`CHANGELOG.md`	v1.0.0 and v2.0.0 history
`agent-veille-v2.json`	Pack manifest with stats and files
`scripts/install.sh`	One-shot installer (venv, deps, systemd service)
`scripts/config.yaml`	Configuration template to fill in
`scripts/test_prompt.py`	Tests a prompt on a local example
`scripts/run_agent.py`	Minimal swarm orchestrator
`templates/*.yaml`	2 domain configuration templates

Quick installation

cd /opt/autonomous-stack/agent-veille-v2
bash scripts/install.sh

The installer checks for Python 3.10+, creates a venv, installs the dependencies, detects a local LLM provider and configures a systemd unit.

Immediate test

# Test the main prompt
python3 scripts/test_prompt.py --prompt feed_collector --input templates/rss_sources.yaml

# Run the agent in dry-run mode
python3 scripts/run_agent.py --config scripts/config.yaml --dry-run

Customization

Copy scripts/config.yaml to config.local.yaml.
Adapt the templates in templates/.
Plug your own signal/task/data sources into run_agent.py.

Costs and limits

This pack favors deterministic logic for critical decisions. The LLM is used for ranking, summarization and report generation. See SPEC.md for the operating cost estimate.

License

Personal use per purchase. Resale prohibited.

Agent Veille Pack v2.0

What's inside