From 15943f251c0384087a1eb236d7acad9cc4051a09 Mon Sep 17 00:00:00 2001 From: rob Date: Sun, 5 Apr 2026 21:37:06 -0300 Subject: [PATCH] Add proof-of-concept and before/after sections to philosophy page - Added "Proof of Concept" section showcasing Orchestrated Discussions as a real-world example of the composable system (21 tools, 0 deps) - Added "Before vs After" code comparison showing traditional Python approach vs CmdForge pipes/composition - Visual flow diagram showing how tools chain together in practice Co-Authored-By: Claude Opus 4.5 --- .../web/templates/pages/philosophy.html | 177 ++++++++++++++++++ 1 file changed, 177 insertions(+) diff --git a/src/cmdforge/web/templates/pages/philosophy.html b/src/cmdforge/web/templates/pages/philosophy.html index 55ccbb2..861fefa 100644 --- a/src/cmdforge/web/templates/pages/philosophy.html +++ b/src/cmdforge/web/templates/pages/philosophy.html @@ -443,6 +443,183 @@ flowchart LR + +
+
+

Proof of Concept

+

+ Orchestrated Discussions: A complete multi-agent AI system built entirely from CmdForge tools. +

+ +
+
+ +
+
+
+ + + +
+
+

Orchestrated Discussions

+

21 tools working together

+
+
+ +

+ Multiple AI personas debate topics, vote on outcomes, and synthesize conclusions. + The entire system is built from small, focused CmdForge tools that call each other. +

+ +
+
+
21
+
Composable Tools
+
+
+
0
+
External Dependencies
+
+
+ + + View Collection + + + + +
+ + +
+
+
Example flow: Multi-agent debate
+
+
+ + discussion-start + → topic +
+
+ + persona-respond + × 5 +
+
+ + vote-collect +
+
+ + consensus-check +
+
+ + discussion-summarize + → output +
+
+
+
+
+
+ +

+ This is what "composable capabilities" looks like in practice. +

+
+
+ + +
+
+

Before vs After

+

+ The same task: summarize a document and email the key points. +

+ +
+ +
+
+
+ 1 +
+

Traditional Approach

+
+
+ 
# Step 1: Install dependencies
+pip install openai python-dotenv smtplib
+
+# Step 2: Write the code (40+ lines)
+import os
+import smtplib
+from openai import OpenAI
+from email.mime.text import MIMEText
+
+client = OpenAI(api_key=os.getenv("OPENAI_KEY"))
+
+def summarize(text):
+    response = client.chat.completions.create(
+        model="gpt-4",
+        messages=[{"role": "user",
+            "content": f"Summarize: {text}"}]
+    )
+    return response.choices[0].message.content
+
+def send_email(to, subject, body):
+    msg = MIMEText(body)
+    msg['Subject'] = subject
+    msg['To'] = to
+    # ... 15 more lines of SMTP setup
+
+# Step 3: Handle errors, env vars, etc.
+
+
+ + + + 40+ lines, API keys, dependencies, error handling +
+
+ + +
+
+
+ 2 +
+

CmdForge Approach

+
+
+ 
# Option A: Unix pipes
+cat document.txt | summarize | send-email
+
+# Option B: Compose into a new tool
+name: doc-to-email
+steps:
+  - tool: summarize
+    output_var: summary
+
+  - tool: send-email
+    input_template: "{summary}"
+
+# Now use it:
+cat document.txt | doc-to-email
+
+
+ + + + 6 lines. Reusable. Provider-agnostic. Shareable. +
+
+
+
+
+