clawjr/README.md

64 lines
2.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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: $215/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