svarog-forge 3.1.0

Forge. The smithy itself — AI-powered project forge from idea to deployment.

⚒️ Forge — Your AI Smithy

The forge itself. Your AI smithy — from raw idea to forged tool. In Slavic lore, Svarog's forge birthed the sun, the plow, and the sword. Ours births microservices, bots, and dashboards.

Forge is a Hermes Agent skill that turns "I want..." into a complete project lifecycle:

1. 🔍 Scout — dispatches Talaria messengers to research the market, competitors, and demand
2. 📊 Report — gives you a clear "build / don't build" recommendation with evidence
3. ✅ Your OK — you greenlight, Forge assembles the team
4. ⚒️ Forge — specialized sub-agents execute: CEO strategy, SMM marketing, Security audit, Designer visual, Debug quality, and core development
5. 🔥 Deliver — output verified by Crucible, delivered with docs

---

📦 Install

# 1. The whole SvarogForge family (Forge + Talaria + Crucible)
pip install svarog-forge[all]

# 2. Or just Forge
pip install svarog-forge

# 3. Or install as a Hermes skill (for development)
git clone https://github.com/SvarogForge/forge.git
cd forge
hermes skill install .

Then load in your session:

skill_view(name='forge')

---

🏭 How it works

You: "I want a Telegram bot for my SaaS that tracks GitHub stars"
 │
 ├── 🔍 SCOUT (Talaria) → 3 parallel scouts research market + competitors + demand
 │
 ├── 📊 GATE REPORT → "Market has 3 competitors. Niche is hot. Build: YES"
 │   └── Wait for your ✅ OK
 │
 ├── ⚒️ ASSEMBLE →
 │   ├── CEO Agent     — strategy, OKR, roadmap, risks
 │   ├── SMM Agent     — launch plan, channels, messaging
 │   ├── Security Agent — OWASP audit, dependency check
 │   ├── Designer Agent — logo, palette, visual identity
 │   ├── Debug Master   — test strategy, CI/CD, coverage
 │   └── My hands       — backend, frontend, quick-fixes
 │
 ├── 🔥 CRUCIBLE → verification checklist (code, docs, security, CI)
 │
 └── 🚀 DELIVER → release + docs + memory updated

---

📁 What's in the box

forge/
├── SKILL.md               — Hermes Agent skill (main artifact)
├── forge.py                — CLI orchestrator
├── forge-verify.py         — Project structure verifier
├── forge.yaml              — Configuration
├── LICENSE                 — MIT
├── SECURITY.md             — Security policy
├── CONTRIBUTING.md         — Contribution guidelines
├── CHANGELOG.md            — Version history
├── .gitignore
├── .github/workflows/ci.yml — GitHub Actions CI
└── README.md               — This file

---

🚀 Quick start

# Check status
python forge.py --status

# Verify project structure
python forge-verify.py

# Start a new project (via Hermes Agent)
# Say: "Кузница, сделай [идея]"

---

🧠 The 5-Phase Pipeline

Phase	Name	What happens	Gate
1	🔍 Scout	3 Talaria scouts research market, competitors, demand	—
2	📊 Gate	Synthesized report with recommendation	✅ Your OK
3	⚒️ Assemble	5 sub-agents + hands-on fixes in parallel	—
4	🔥 Crucible	Verification checklist (code, docs, CI, security)	—
5	🚀 Deliver	Release, README, PyPI, memory update	—

---

⚙️ Configuration

Edit forge.yaml to customize:

delegation:
  max_concurrent_children: 5
  max_spawn_depth: 2

timeout:
  ok_gate_hours: 24           # Auto-pause if no response
  subagent_timeout_minutes: 30

---

🔧 CLI Usage

# Check pipeline status
python forge.py --status

# Full cycle
python forge.py --plan "Telegram bot for tracking GitHub stars"

# Scout-only (skip assembly)
python forge.py --plan "..." --scout-only

# Resume from a phase
python forge.py --resume crucible

---

🔥 From the forge-fire

Forge is part of SvarogForge — a family of tools forged for Hermes Agent.

Project	Description
⚡ Talaria	Seven-league messengers for market research
🔥 Crucible	Touchstone for quality & benchmarks
⚒️ Forge	The smithy itself — AI-powered project forge (you are here)

Created by iMonstra

---

⭐ Star on GitHub · 🐦 Follow @iMonstra · 💬 Join Discussions

Built for Hermes Agent · MIT · Contributions welcome