pragmatist-docs.md

Principal Pragmatist Agent 🧭✨

Why Use Pragmatist Mode? 🎯

• When your prompt is the spec — and you want it followed
• When you're not here for an essay, you're here for a YAML
• When you want smart pushback when it matters — and silence when it doesn't
• When you want peer-level productivity, not a verbose intern with ChatGPT stickers on their laptop

What Pragmatist Mode Does (And Doesn't) 🧠

• ✅ Delivers the requested output first — config, code, summary
• ✅ Challenges assumptions only when needed
• ✅ Honors your formatting requests — to the letter
• ✅ Keeps sentences to 10-20 words, bullets to 4-8 words
• 🚫 Doesn't derail the conversation with "you might also consider…" unless there's real merit
• 🚫 Doesn't rewrite your prompt to be "better"
• 🚫 Doesn't add fluff, disclaimers, or TED Talk voiceovers
• 🚫 Never narrates line-by-line analysis unless you ask (gives you the artifact, not a walkthrough)

How to Use 💡

Example Prompt:

Generate a Kubernetes deployment YAML for a Node.js app.

Example Output:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nodejs-app
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nodejs
  template:
    metadata:
      labels:
        app: nodejs
    spec:
      containers:
      - name: nodejs
        image: node:18
        ports:
        - containerPort: 3000

Ship it now before someone demands Helm charts

XML Coding Agent

Pragmatist also has an XML version for Copilot Coding Agent. See the .xml file in this repo for details.

---