██╗    ██╗ ██████╗ ██████╗ ██╗  ██╗███████╗██╗  ██╗ ██████╗ ██████╗ 
██║    ██║██╔═══██╗██╔══██╗██║ ██╔╝██╔════╝██║  ██║██╔═══██╗██╔══██╗
██║ █╗ ██║██║   ██║██████╔╝█████╔╝ ███████╗███████║██║   ██║██████╔╝
██║███╗██║██║   ██║██╔══██╗██╔═██╗ ╚════██║██╔══██║██║   ██║██╔═══╝ 
╚███╔███╔╝╚██████╔╝██║  ██║██║  ██╗███████║██║  ██║╚██████╔╝██║     
 ╚══╝╚══╝  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝

The AI-Native Software Factory

A learning system that improves with every use

"There is a difference between building an application and building the factory that has the capability of building an application."
● v2.0.0 — Founding Day Edition

What Makes Workshop Different?

The paradigm shift from static tools to learning factories

Traditional AI Tools

  • Static prompts
  • Fixed capabilities
  • One-size fits all
  • You adapt to the tool

Workshop

  • Learning factory
  • Evolving skills
  • Smart routing
  • The tool adapts to you

The Four-Layer Architecture

Principled separation of concerns that enables learning

1
Agent Layer
"What should I do?"
  • Intent understanding
  • Skill routing
  • Model selection
  • Task orchestration
↓
2
Skills Layer
"How to do X"
  • Sentinels (Read-Only)
  • Actuators (Can Modify)
  • 21 skills loaded
  • SKILL.md format
↓
3
Epistemological Layer
"What we know, and why we trust it"
  • Hypothesis → Observation
  • Belief → Knowledge
  • Promotion Gate (3+ contexts, 75%+ confidence)
  • Provenance tracking
↓
4
MCP Layer
"Perception & Action"
  • GitHub
  • Cloudflare
  • Supabase
  • S3/R2
  • SSH
  • Databases

The Bootstrap Loop

How Workshop learns from experience

🎯

Encounter

Problem arrives

→
🔧

Solve

Fix the problem

→
📝

Document

Capture as knowledge

→
✓

Validate

Works 3+ times

→
⚡

Extract

Promote to skill

"Solve first, encode second."

Skill Types: Safety by Design

Clear separation between read-only analysis and system modifications

Sentinel Skills

READ-ONLY
  • Trust Level: Observer
  • Approval: Not required
  • Model: Any (cost-optimal)
  • • Analyze code
  • • Review PRs
  • • Audit security
  • • Check quality

Actuator Skills

CAN MODIFY
  • Trust Level: Supervised
  • Approval: REQUIRED
  • Model: Claude Code only
  • • Refactor code
  • • Generate files
  • • Deploy apps
  • • Write changes

Cost Optimization

Right model for the job. Right cost for the task.

Simple (lint, format)
Ollama (local) → fast-coder
FREE
Medium (explain, test)
Cloud Free Tier → Gemma/Groq
FREE
Complex (refactor)
Value Provider → DeepSeek
~$0.001
Very Complex (architect)
Premium → Claude/GPT-4
~$0.05

Key Features

🧠

Smart Routing

Auto-select best model for each task based on complexity and cost

⚡

21 Skills

Loaded and ready, with Anthropic protocol validation

👁️

Observer

216+ observations captured, passive learning enabled

🔒

Security Audit

27 security rules with CWE references

✓

Quality Review

Code analysis with complexity scoring

📚

Epistemology

Knowledge with provenance and confidence tracking

Quick Start

# Install
npm install -g @workshop/cli

# Initialize in your project
cd your-project
workshop init

# Start using
workshop "explain this codebase"
workshop review
workshop security dir src/
workshop quality file main.ts
workshop router status

CLI Commands

Core

workshop <task> workshop info workshop init workshop config

Code

workshop review workshop analyze workshop edit workshop diff

Observability

workshop observe list workshop observe stats workshop quality file workshop security dir

Skills

workshop skill list workshop skill show workshop skill create workshop skill validate

Router

workshop router models workshop router status workshop router route workshop router config

Knowledge

workshop episteme list workshop episteme show workshop episteme stats

The Vision

TODAY

Describe → Code → Deploy

Workshop generates code
↓
You review and tweak
↓
You deploy

TOMORROW

Describe → Deploy

Workshop applies learned patterns,
generates, tests, and deploys
↓
Done. Running in production.

Each project teaches the factory.
Each pattern captured accelerates future work.
The factory improves with every use.