# ClawJr

Where agents are built, shaped, and hardened. (Formerly **Forge** — renamed 2026-06-23, successor to the retired Claw/OpenClaw.)

## 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: $2–15/month (Claude Haiku via Bedrock) for all agents combined.

## Status

- [x] Project created
- [ ] Scribe SOUL.md finalized
- [ ] Bedrock access configured
- [ ] First workflow (enhance_notes) operational
- [ ] Telegram gateway wired