Automations and AI agents — built to last
Find a file
2026-06-10 12:38:31 +00:00
README.md init: project vision and architecture 2026-06-10 12:38:31 +00:00

Forge

Where agents are built, shaped, and hardened.

Vision

A hybrid automation platform: self-hosted orchestration (cron, bash, Ansible) calling AWS Bedrock for intelligence. No frameworks. No fragile plugin systems. Just scripts, prompts, and reliable execution.

Architecture

┌─────────────────────────────────────┐
│          Trigger Layer              │
│   cron · Ansible · webhook · CLI    │
└──────────────────┬──────────────────┘
                   │
┌──────────────────▼──────────────────┐
│          Agent Runtime              │
│   SOUL.md + workflow prompt + curl  │
│   → AWS Bedrock (Claude Haiku)     │
└──────────────────┬──────────────────┘
                   │
┌──────────────────▼──────────────────┐
│          Output Layer               │
│   Trillium · Obsidian · Telegram   │
│   S3 · logs                         │
└─────────────────────────────────────┘

Each agent is a directory. Each workflow is a bash script + prompt file. Intelligence comes from Bedrock. Control stays with you.

Principles

  1. No dependencies beyond bash, curl, jq, and AWS CLI
  2. Every execution logged (input, output, tokens, cost)
  3. SOUL.md is the single source of personality
  4. Model-agnostic — swap Bedrock for Ollama with one env var
  5. Agents have boundaries — they do what they do and nothing else

Structure

forge/
├── agents/
│   └── scribe/          # Knowledge enhancer, writer, diagrammer
├── automations/
│   ├── cron/            # Scheduled tasks
│   └── ansible/         # Infrastructure playbooks
├── decisions/           # Architecture Decision Records
└── README.md

Cost

Target: $215/month (Claude Haiku via Bedrock) for all agents combined.

Status

  • Project created
  • Scribe SOUL.md finalized
  • Bedrock access configured
  • First workflow (enhance_notes) operational
  • Telegram gateway wired