OuroSSS
Research Pipeline Protocol
The serpent eats its own tail — each project feeds the next
OuroSSS is the research operating protocol for automating the CS paper pipeline from idea to publication — a Telegram bot with 19 commands, multi-agent orchestration via Claude Code teams, CI/CD automation, and a self-improving workflow that documents its own evolution across 7 pipeline stages.
Dashboard
Live metrics. Updated via /page Telegram command.
10
Commits (30d)
5065
Lines of Code
35
Python Files
19
Bot Handlers
9
Services
0
Open Issues
0
Closed Issues
v0.0.1
Version
Token Savings (RTK)
77%
262.9K tokens saved out of 340.8K
850 commands proxied
Avg latency: 380ms
Top:
~$1.05 saved at Opus rates
850 commands proxied
Avg latency: 380ms
Top:
git log -p → 99.9% savings~$1.05 saved at Opus rates
Codebase Composition
Commit Activity (last 7 days)
RTK Top Savers (by tokens)
GitHub Pulse
Live data from GitHub API. Refreshes on every page load.
Commit Heatmap (30 days)
Mon
Sun
Repository Pulse
Loading...
Status & Findings
A living journal. Updated via Telegram /page command.
2026-03-16
Unforked — OuroSSS is now standalone
Deleted fork dependency on razzant/ouroboros, recreated as fresh standalone repo. Clean slate: v0.0.1, zero issues, main branch only.
milestone
2026-03-16
TTHRESH research bootstrapped
Tucker tensor compression rewrite in JAX — differentiable HOSVD with learned factor matrices. Assessment moved from PR to Notion, repo initialized on kurkin-1.
status
2026-03-15
Migrated to uv + pyproject.toml
Full uv dependency management with lockfile, pre-commit hooks, ruff linting. Entry point via `uv run ourosss`. 19 commits in a single day of restructuring.
milestone
2026-03-14
Telegram chat organizer + research commands
New /tg-organize for folder management and bulk archive. /research command for Notion research log DB. Issue routing protocol established.
status
2026-03-11
Async CI for research pipeline
GitHub Actions workflows for async research pipeline stages. Bot disk alerts, command cleanup, Notion status types fixed.
status
2026-03-10
GitHub Pages site launched
Research portfolio live at fr0do.github.io. Auto-updating vitals via /page Telegram command. Apple-minimalist design, zero dependencies.
milestone
2026-03-08
OuroSSS bootstrapped
Initial meta-project: OUROBOROS.md governance protocol, Telegram bot (19 commands), multi-agent orchestration, CI/CD automation.
milestone
Architecture
How the pieces fit together.
Telegram
19 commands
→
Bot Engine
python-telegram-bot
→
Agent Teams
Claude Code
→
Compute
kurkin-1/4
→
Results
ClearML + Notion
| Component | Description |
|---|---|
| Telegram Bot | Remote control panel — training, infra, notes, team management |
| Agent Teams | Native Claude Code multi-agent orchestration with shared task lists |
| GitHub CI | Lint (ruff), release automation, remote health ping |
| RTK Integration | 77% token savings on all CLI operations via Rust Token Killer |
| Issue Journaling | Every feature starts as an issue, with progress comments and auto-close |
Managed Projects
Research coordinated through ourosss.
| Project | Description | Status |
|---|---|---|
| tthresh | Differentiable Tucker compression in JAX | Bootstrap |
| ourosss | This meta-project — pipeline protocol, bot, CI/CD, agent orchestration | Active |
Operational Rules
Ten rules governing the protocol.
1
Loop closes — every artifact must improve the next iteration. Dead-end infra gets deleted.
2
Issues before code — create a GitHub issue before any feature.
fixes #N in every commit.
3
Reproducibility — config + seed + commit hash are mandatory for every run.
4
Atomic commits — self-contained and non-breaking. Half-states don't exist; they're bugs.
5
Plan large, implement small — Opus for architecture, Sonnet subagents for code.
6
Minimalism — one source of truth per fact. Delete over deprecate.
7
Autonomy with trail — agents act freely; every action is logged, every decision is traceable.
8
Minimal overhead — every tool justifies itself by saving more time than it costs.
9
Cross-pollination — insights transfer across projects.
10
Ship or kill — three months without progress means a deadline or a funeral.