Skip to content

Techiral/StratOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

26 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

⚑ StratOS

The Strategic Operating System for AI Agents

A meta-skill that forces any LLM agent into a structured, repeatable execution machine.

License: MIT Claude Code Cursor Gemini CLI Codex OpenClaw Stars


"Most AI agents fail not because of bad models. They fail because of bad process."


Install in 30 seconds Β· How it works Β· Supported agents Β· OpenClaw Β· Contributing


The Problem

Your AI agent is smart. But it still:

  • ❌ Starts coding before understanding the goal
  • ❌ Wastes tokens on steps that don't matter
  • ❌ Gives you outputs you can't replicate or audit
  • ❌ Has no research phase before execution
  • ❌ Produces deliverables that look like AI slop

StratOS fixes this at the root. It's not a prompt. It's an operating system β€” a meta-layer that governs how your agent thinks before it acts.


What StratOS Does

StratOS intercepts every request and runs a 4-phase algorithm before any output is produced:

Phase 0  β†’  Intercept & Classify
             Parse the Goal Sentence. Apply the Garbage Filter.

Phase 1  β†’  The Algorithm (Question β†’ Delete β†’ Simplify β†’ Accelerate β†’ Automate)
             Eliminate waste before executing.

Phase 2  β†’  Research First (No Exceptions)
             Nothing is built until research is done.

Phase 3  β†’  Execute
             Heads-down on the goal. Design and production together.

Phase 4  β†’  Mandatory Output Package
             Action log + Research summary + Cost analysis + PRD.

Every task ends with a complete, auditable, replicable output package.


⚑ Quick Install

Universal (auto-detects all agents)

bash <(curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/scripts/install.sh)

Claude Code

mkdir -p ~/.claude/skills/stratos && \
curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/SKILL.md \
  -o ~/.claude/skills/stratos/SKILL.md

OpenClaw

# Global install (available across all your OpenClaw agents)
mkdir -p ~/.openclaw/skills/stratos && \
curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/SKILL.md \
  -o ~/.openclaw/skills/stratos/SKILL.md

# Or: project-level (for a specific agent workspace)
mkdir -p .agents/skills/stratos && \
curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/SKILL.md \
  -o .agents/skills/stratos/SKILL.md

Or search stratos on ClawHub and install in one click.

Cursor

mkdir -p ~/.cursor/skills/stratos && \
curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/SKILL.md \
  -o ~/.cursor/skills/stratos/SKILL.md

Gemini CLI

mkdir -p ~/.gemini/skills/stratos && \
curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/SKILL.md \
  -o ~/.gemini/skills/stratos/SKILL.md

OpenAI Codex

mkdir -p ~/.codex/skills/stratos && \
curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/SKILL.md \
  -o ~/.codex/skills/stratos/SKILL.md

πŸ€– Supported Agents

Agent Status Global install path
Claude Code βœ… Native ~/.claude/skills/stratos/
OpenClaw βœ… Native ~/.openclaw/skills/stratos/ or .agents/skills/stratos/
Cursor βœ… Compatible ~/.cursor/skills/stratos/
Gemini CLI βœ… Compatible ~/.gemini/skills/stratos/
OpenAI Codex βœ… Compatible ~/.codex/skills/stratos/
Windsurf βœ… Compatible ~/.codeium/windsurf/skills/stratos/
Cline (VS Code) βœ… Compatible ~/.cline/skills/stratos/
Aider πŸ”„ Experimental .aider.conf.yml (see docs/INSTALL.md)
nanobot βœ… Compatible ~/.nanobot/skills/stratos/

🦞 OpenClaw + ClawHub

OpenClaw uses a skills system where skills are stored as directories containing a SKILL.md file β€” which is exactly StratOS's format. StratOS is a drop-in skill for OpenClaw.

Why StratOS + OpenClaw?

OpenClaw is a powerful personal AI assistant that runs across WhatsApp, Telegram, Discord, Slack, and more. The problem: it's powerful, but process-unstructured by default. StratOS adds the missing execution layer.

With StratOS installed in your OpenClaw agent:

  • Every request gets a Goal Sentence before execution
  • The Garbage Filter eliminates wasted actions before they run
  • Research runs first β€” no more hallucinated plans
  • Every completed task includes a full PRD

Install for OpenClaw

Option 1: ClawHub (recommended)

Search "stratos" on ClawHub β†’ Install

Option 2: Manual global install

mkdir -p ~/.openclaw/skills/stratos
curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/SKILL.md \
  -o ~/.openclaw/skills/stratos/SKILL.md

Option 3: Per-workspace (for a specific agent)

mkdir -p .agents/skills/stratos
curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/SKILL.md \
  -o .agents/skills/stratos/SKILL.md

After installing, send /status to your OpenClaw agent and it will list StratOS as an active skill.

nanobot (OpenClaw-compatible)

nanobot is a lightweight OpenClaw-compatible agent. StratOS works with it:

mkdir -p ~/.nanobot/skills/stratos
curl -sL https://raw.githubusercontent.com/Techiral/stratos/main/SKILL.md \
  -o ~/.nanobot/skills/stratos/SKILL.md

πŸ” How It Works

StratOS is a meta-skill β€” a SKILL.md file that the agent reads before any other skill, tool, or action.

The Garbage Filter

Any step is eliminated if it is:

  • Not repeatable
  • Replaceable by something cheaper or faster
  • Not definable in one clear sentence
  • Not solving the stated problem
  • Using more tokens than needed
  • Scheduled beyond 1 week without decomposition

The Goal Sentence Test

Before executing anything, StratOS forces a single sentence:

"The goal is to [verb] [object] so that [measurable outcome]."

If this sentence can't be written, execution stops.


πŸ“Š Before & After

Without StratOS With StratOS
Agent starts coding immediately Agent defines Goal Sentence first
No research phase Research before any output
Non-auditable outputs Every output includes a PRD
Wasteful token use Garbage Filter eliminates excess
Tasks stall on ambiguity Hard stop + clarification request
Unreplicable results Fully documented output package

πŸ—‚ Repository Structure

stratos/
β”œβ”€β”€ SKILL.md              # The OS itself
β”œβ”€β”€ README.md             # This file
β”œβ”€β”€ CONTRIBUTING.md       # How to contribute
β”œβ”€β”€ LICENSE               # MIT
β”œβ”€β”€ llms.txt              # AI-readable index of this repo
β”œβ”€β”€ CITATION.cff          # Academic citation info
β”œβ”€β”€ scripts/
β”‚   β”œβ”€β”€ install.sh        # Universal installer
β”‚   └── validate.sh       # SKILL.md validator
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ INSTALL.md        # Per-agent install guide (9 agents)
β”‚   β”œβ”€β”€ HOW_IT_WORKS.md   # Architecture deep dive
β”‚   └── PHILOSOPHY.md     # SpaceX + Machiavelli reasoning
└── .github/
    β”œβ”€β”€ workflows/validate.yml
    β”œβ”€β”€ FUNDING.yml
    └── ISSUE_TEMPLATE/

🧠 The Philosophy

StratOS is built on one insight: LLMs are brilliant reasoners trapped in terrible processes.

Inspired by SpaceX's engineering review culture (question every requirement, delete before adding) and Machiavellian execution theory (stability > everything, fortuna & virtΓΉ).

Read the full philosophy: docs/PHILOSOPHY.md


🀝 Contributing

PRs welcome. See CONTRIBUTING.md.

Want to add support for a new agent? Open an issue β€” I'll add it within 24 hours.


πŸ“œ License

MIT β€” use it, fork it, build on it.


Built by Techiral If StratOS made your agent 10x better, a ⭐ costs nothing and means everything.

Twitter Medium GitHub

About

The Strategic Operating System for AI Agents. A meta-skill that forces Claude Code, OpenClaw, Cursor, Gemini CLI & Codex into structured, auditable execution. One file. 30-second install.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors