Skip to content

retflo/retflo

Repository files navigation

retflo™

License: RCCL v1.0 59 nodes 260 connections 7 domains retflo.org

The complete protocol for political reasoning.
Every structural objection to cooperative governance, mapped and answered.
Argue less. Build more.

retflo visualizer retflo in Claude Code
Left: the protocol visualized as an interactive graph. Right: retflo loaded as a skill in Claude Code.

Why this exists

The same objections to cooperative governance have been recycled for centuries. "Human nature is selfish." "It can't scale." "Be realistic." The arguments don't change because they don't need to — repetition is the mechanism.

These aren't hard questions. They have structural answers. But those answers have never been organized in a way that connects them — where each response anticipates the next objection and routes to it.

retflo is that structure. A closed dialectical graph that maps the entire objection space, with every path answered and every connection typed. Not a chatbot. Not an app. A protocol — like TCP/IP is a protocol for data, retflo is a protocol for political reasoning.

Try it

Install

npx skills add retflo/retflo -g

Auto-detects your agent. Target a specific one with -a:

npx skills add retflo/retflo -g -a claude-code
npx skills add retflo/retflo -g -a cursor
npx skills add retflo/retflo -g -a gemini-cli

40+ agents supported. Run npx skills add retflo/retflo --list to see all.

For manual installation and other methods, see the install docs.

This repo contains the nodes, routing table, and engagement rules — everything an LLM needs to navigate the framework. Also available through the website, the API, and the visualizer.

How it works

AGENTS.md is the entry point. It contains the routing table that maps common objections to nodes, plus the engagement rules and delivery calibration.

Each node has:

  • Position — the substantive case
  • Objection handling — a Move / Response / Concession table
  • Typed connections — links to follow-up nodes across domains

Nodes capture argument patterns, not instances. "China has a navy" and "Russia has nukes" route to the same node: external military threat.

The chain in action

flowchart LR
    A["'People are selfish'"] --> B["phil/nature"]
    B --> C["Mutual aid is a<br>dominant survival strategy"]
    C --> D["Selfishness under capitalism is<br>incentive-shaped behavior,<br>not nature revealed"]
    D --> E["soc/cultural-reproduction"]
    D --> F["phil/failure-modes"]
    D --> G["auth/federation-vs-state"]
Loading

Objection in, structural response out, next move available. The graph is closed — follow any objection far enough and it routes back to territory the framework already covers.

Domains

Domain Covers
Authority State, governance, federation, enforcement, democracy, defense
Economics Property, labor, markets, cooperatives, inequality, trade, commons
History Revolutions, Mondragon, kibbutzim, Rojava, colonialism
Philosophy Human nature, coercion, freedom, transition, direct action
Rhetoric Framing, fallacies, burden of proof, debate tactics
Social Structural oppression, propaganda, nationalism, education
Technology Platform ownership, algorithmic governance

59 arguments. 260 connections. 7 domains.

Structure

retflo/
├── AGENTS.md            ← framework entry point
├── SKILL.md             ← skill ecosystem compatibility
├── STYLE-GUIDE.md       ← delivery calibration
└── nodes/
    ├── auth/            ← Authority & Governance
    ├── econ/            ← Economics & Ownership
    ├── hist/            ← Historical Cases
    ├── phil/            ← Philosophy
    ├── rhet/            ← Rhetoric & Tactics
    ├── soc/             ← Social Issues
    └── tech/            ← Technology

License

Retflo Cooperative Commons License (RCCL) v1.0 — free for individuals, worker cooperatives, and democratic organizations. Commercial licensing available for investor-owned entities.


retflo.org · Visualizer · Docs · API · FAQ · Contact

© 2026 retflo™ contributors. Licensed under RCCL v1.0.

Donate