Intent Fluid
Transform human intent into autonomous execution with Intent Fluid.
🎬 See Surge In Action
<p align="center"> <video src="https://github.com/user-attachments/assets/0626b8eb-4cdc-4ce5-aec9-3bc9ac3ff1c9" width="100%" controls autoplay muted> Your browser does not support the video tag. <a href="https://github.com/user-attachments/assets/0626b8eb-4cdc-4ce5-aec9-3bc9ac3ff1c9">Download the demo video</a>. </video> </p>One PRD in → complete deliverables out. Watch Surge autonomously iterate through Analyze → Research → Design → Implement → QA until quality converges.
⚡ The Difference
<p align="center"> <img src="assets/images/before-after.png" alt="Without Surge vs With Surge" width="100%"> </p>🌊 Why Surge?
🔄 Autonomous Iteration Engine Director Agent drives Analyze → Research → Design → Implement → QA in a closed loop. Not a one-shot generator — it iterates until quality converges. Auto-detects stagnation, oscillation, and Pareto frontiers to reach highest quality in minimum iterations.
👥 Expert Review Panel Automatically assembles 3-5 domain experts for parallel design review. Each expert evaluates independently — security, performance, maintainability — with veto power. Multi-perspective synthesis eliminates blind spots.
✅ Rigorous Quality Assurance Three-tier acceptance criteria (L1→L2→L3) with progressive escalation. Output integrity validation auto-detects truncation and recovers. Optimization directives are closed-loop tracked — every improvement proposed is verified next round.
📋 PRD-to-Deliverable Pipeline One PRD in, complete deliverables out — code, documents, or strategy reports. Auto-analyzes requirement topology, negotiates acceptance criteria, orchestrates parallel subtasks. From fuzzy intent to structured output, fully autonomous.
🧠 Self-Evolving Process Memory Extracts process experience after every iteration — ambiguities found, reusable components, rejected approaches, missing test cases. Persisted to memory files — gets smarter with every use. Retro phase generates rule update suggestions.
🧠 The Cognitive Pipeline
<p align="center"> <img src="assets/images/cognitive-pipeline.png" alt="Surge Cognitive Pipeline" width="100%"> </p>Intent-Fluid transforms intent into structured reality through an iterative, agentic pipeline. It doesn't generate once and stop — it loops through Analyze → Research → Design → Implement → QA until quality converges on your acceptance criteria. Each iteration extracts process memory, making the next run smarter.
📦 Quick Start
See the full Installation Guide for platform-specific instructions.
git clone https://github.com/carbonshow/intent-fluid.git
| Platform | Integration |
|---|---|
| Claude Code | /plugin marketplace add carbonshow/intent-fluid |
| Cursor | Add https://github.com/carbonshow/intent-fluid as a rule source or MCP server |
| Gemini CLI | gemini extensions install https://github.com/carbonshow/intent-fluid |
🏗 Architecture
<p align="center"> <img src="assets/images/architecture.png" alt="Intent-Fluid Architecture" width="100%"> </p>Available Skills
| Skill | Description |
|---|---|
| surge | Autonomous delivery system — iterative analyze/research/design/implement/QA cycles driven by a Director Agent. Provide a PRD to activate. |
| slidev | Lightweight Markdown-based presentations — intelligently analyzes content, auto-selects layouts (text, diagrams, tables, images), generates Mermaid flowcharts, and applies adaptive density controls to prevent overflow. A faster, code-native alternative to heavy slide tools. |
Creating a New Skill
- Read the Skill Specification
- Copy the Skill Template
- Create your skill under
skills/<your-skill-name>/ - Validate:
bash scripts/validate-skill.sh skills/<your-skill-name>
📄 License
This project is licensed under the MIT License — see the LICENSE file for details.
<p align="center"><em>"Stay in flow. Let the intelligence follow your will."</em></p>