GitHub - cardeo/swarm-protocol: A design protocol for nonlinear creativity · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
cardeo
swarm-protocol
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>26 Commits<br>26 Commits
canon
canon
patterns
patterns
practice
practice
protocol
protocol
templates
templates
.gitignore
.gitignore
AGENTS.md
AGENTS.md
LICENSE
LICENSE
README.md
README.md
View all files
Repository files navigation
SWARM Protocol
SWARM is a loop-based protocol for nonlinear creativity and signal detection.
It preserves human judgment in environments increasingly shaped by AI systems.
SWARM structures how ideas are spotted, weighed, arranged, refined, and made through repeated loops rather than linear execution.
It is not a productivity system.
Learn more: https://swarmloop.xyz
Why SWARM Exists
Modern systems increasingly optimize outcomes for us.
SWARM exists to preserve the human ability to notice, evaluate, and interpret what matters.
The SWARM Loop
Spot → Weigh → Arrange → Refine → Make
A loop is a single exploratory pass.
Work happens inside the loop.
Understanding emerges across loops.
Loop · Protocol · Signal
Loop — a single exploratory pass.
Protocol — a pattern that emerges across loops.
Signal — what begins to persist across loops.
Loop = movement
Protocol = memory
Signal = meaning
Working With AI
AI may assist inside the loop by surfacing observations, organizing material, or generating artifacts.
AI does not determine meaning.
Progression through the loop requires practitioner input.
How to Use SWARM
SWARM is designed to be used alongside an AI system.
Open this repository in your AI environment of choice:
Codex
Claude
ChatGPT
Cursor
or another AI tool that can work with repository context
Then give the system something real to work on.
Examples:
“Use SWARM on this problem.”
“Help me think through this using SWARM.”
“Use this repository for this task.”
“Explore this idea using SWARM.”
You do not need to choose a practice in advance.
If a relevant practice exists, the system may suggest it as an entry point into the loop. Otherwise, the system should run a standard SWARM loop.
The loop is:
Spot → Weigh → Arrange → Refine → Make
The AI may assist within each phase, but progression between phases requires practitioner input.
SWARM is not designed to produce immediate final answers.
Clarity emerges through repeated loops, not a single prompt.
Human judgment remains active throughout the process.
Repository Structure
canon/ — Stable concepts and ontology.
protocol/ — How SWARM operates.
patterns/ — Recurring behaviors and diagnostic observations.
practice/ — Repeatable loop entry points and applications.
templates/ — Authoring scaffolds for extending the protocol.
Where To Go Next
Read canon/swarm.md, canon/loop.md, canon/protocol.md, and canon/signal.md for the core concepts behind SWARM.
Use practice/README.md when you want a repeatable entry point such as Loop Logging or a System Check.
Use patterns/README.md when you want help recognizing what is happening during exploration.
Important
Do not treat SWARM like a one-shot prompt.
Do not let AI decide meaning.
Do not skip practitioner input between loop phases.
Status
SWARM is evolving.
The canon remains stable.
Patterns and practices expand through use.
Author
SWARM was developed by Matt Lambert.
Links
swarmloop.xyz — SWARM online
Substack — ongoing writing and exploration
cardeo.ca — broader creative and systems work
About
A design protocol for nonlinear creativity
Resources
Readme
License
View license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
star
Watchers
watching
Forks
forks
Report repository
Releases
tags
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
You can’t perform that...