squads-cli 0.2.0 → 0.2.1

package/dist/update-D7CGIZ3M.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/update-STU276HR.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import {
+  performUpdate,
+  refreshVersionCache
+} from "./chunk-J6QF4ZQX.js";
+import {
+  RESET,
+  colors,
+  gradient,
+  icons,
+  writeLine
+} from "./chunk-M5FXNY6Y.js";
+import "./chunk-7OCVIDC7.js";
+
+// src/commands/update.ts
+import { createInterface } from "readline";
+async function confirm(message) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(`  ${message} [y/N]: `, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+    });
+  });
+}
+async function updateCommand(options = {}) {
+  writeLine();
+  writeLine(`  ${gradient("squads")} ${colors.dim}update${RESET}`);
+  writeLine();
+  if (options.check) {
+    writeLine(`  ${colors.dim}Checking for updates...${RESET}`);
+    const info2 = refreshVersionCache();
+    writeLine();
+    if (info2.updateAvailable) {
+      writeLine(`  ${colors.cyan}\u2B06${RESET} Update available: ${colors.dim}${info2.currentVersion}${RESET} \u2192 ${colors.green}${info2.latestVersion}${RESET}`);
+      writeLine();
+      writeLine(`  ${colors.dim}Run \`squads update\` to install${RESET}`);
+    } else {
+      writeLine(`  ${colors.green}${icons.success}${RESET} Already on latest version ${colors.cyan}${info2.currentVersion}${RESET}`);
+    }
+    writeLine();
+    return;
+  }
+  writeLine(`  ${colors.dim}Checking npm registry...${RESET}`);
+  const info = refreshVersionCache();
+  if (!info.updateAvailable) {
+    writeLine();
+    writeLine(`  ${colors.green}${icons.success}${RESET} Already on latest version ${colors.cyan}${info.currentVersion}${RESET}`);
+    writeLine();
+    return;
+  }
+  writeLine();
+  writeLine(`  ${colors.cyan}\u2B06${RESET} Update available: ${colors.dim}${info.currentVersion}${RESET} \u2192 ${colors.green}${info.latestVersion}${RESET}`);
+  writeLine();
+  const shouldUpdate = options.yes || await confirm("Update now?");
+  if (!shouldUpdate) {
+    writeLine();
+    writeLine(`  ${colors.dim}Update skipped${RESET}`);
+    writeLine();
+    return;
+  }
+  writeLine();
+  writeLine(`  ${colors.dim}Installing update...${RESET}`);
+  writeLine();
+  const result = performUpdate();
+  writeLine();
+  if (result.success) {
+    writeLine(`  ${colors.green}${icons.success}${RESET} Updated to ${colors.green}${info.latestVersion}${RESET}`);
+    writeLine(`  ${colors.dim}Restart your terminal to use the new version${RESET}`);
+  } else {
+    writeLine(`  ${colors.red}${icons.error}${RESET} Update failed: ${result.error}`);
+    writeLine(`  ${colors.dim}Try manually: npm update -g squads-cli${RESET}`);
+    process.exitCode = 1;
+  }
+  writeLine();
+}
+export {
+  updateCommand
+};
+//# sourceMappingURL=update-STU276HR.js.map

package/dist/update-STU276HR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/update.ts"],"sourcesContent":["/**\n * squads update - Check and install updates\n */\n\nimport { createInterface } from 'readline';\nimport {\n  refreshVersionCache,\n  performUpdate,\n} from '../lib/update.js';\nimport {\n  colors,\n  RESET,\n  gradient,\n  icons,\n  writeLine,\n} from '../lib/terminal.js';\n\ninterface UpdateOptions {\n  yes?: boolean;\n  check?: boolean;\n}\n\n/**\n * Prompt user for yes/no confirmation\n */\nasync function confirm(message: string): Promise<boolean> {\n  const rl = createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    rl.question(`  ${message} [y/N]: `, (answer) => {\n      rl.close();\n      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');\n    });\n  });\n}\n\nexport async function updateCommand(options: UpdateOptions = {}): Promise<void> {\n  writeLine();\n  writeLine(`  ${gradient('squads')} ${colors.dim}update${RESET}`);\n  writeLine();\n\n  // Check-only mode\n  if (options.check) {\n    writeLine(`  ${colors.dim}Checking for updates...${RESET}`);\n    const info = refreshVersionCache();\n    writeLine();\n\n    if (info.updateAvailable) {\n      writeLine(`  ${colors.cyan}⬆${RESET} Update available: ${colors.dim}${info.currentVersion}${RESET} → ${colors.green}${info.latestVersion}${RESET}`);\n      writeLine();\n      writeLine(`  ${colors.dim}Run \\`squads update\\` to install${RESET}`);\n    } else {\n      writeLine(`  ${colors.green}${icons.success}${RESET} Already on latest version ${colors.cyan}${info.currentVersion}${RESET}`);\n    }\n    writeLine();\n    return;\n  }\n\n  // Check for updates\n  writeLine(`  ${colors.dim}Checking npm registry...${RESET}`);\n  const info = refreshVersionCache();\n\n  if (!info.updateAvailable) {\n    writeLine();\n    writeLine(`  ${colors.green}${icons.success}${RESET} Already on latest version ${colors.cyan}${info.currentVersion}${RESET}`);\n    writeLine();\n    return;\n  }\n\n  writeLine();\n  writeLine(`  ${colors.cyan}⬆${RESET} Update available: ${colors.dim}${info.currentVersion}${RESET} → ${colors.green}${info.latestVersion}${RESET}`);\n  writeLine();\n\n  // Auto-confirm with --yes flag, otherwise prompt\n  const shouldUpdate = options.yes || (await confirm('Update now?'));\n\n  if (!shouldUpdate) {\n    writeLine();\n    writeLine(`  ${colors.dim}Update skipped${RESET}`);\n    writeLine();\n    return;\n  }\n\n  writeLine();\n  writeLine(`  ${colors.dim}Installing update...${RESET}`);\n  writeLine();\n\n  const result = performUpdate();\n\n  writeLine();\n  if (result.success) {\n    writeLine(`  ${colors.green}${icons.success}${RESET} Updated to ${colors.green}${info.latestVersion}${RESET}`);\n    writeLine(`  ${colors.dim}Restart your terminal to use the new version${RESET}`);\n  } else {\n    writeLine(`  ${colors.red}${icons.error}${RESET} Update failed: ${result.error}`);\n    writeLine(`  ${colors.dim}Try manually: npm update -g squads-cli${RESET}`);\n    process.exitCode = 1;\n  }\n  writeLine();\n}\n"],"mappings":";;;;;;;;;;;;;;;AAIA,SAAS,uBAAuB;AAqBhC,eAAe,QAAQ,SAAmC;AACxD,QAAM,KAAK,gBAAgB;AAAA,IACzB,OAAO,QAAQ;AAAA,IACf,QAAQ,QAAQ;AAAA,EAClB,CAAC;AAED,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,OAAG,SAAS,KAAK,OAAO,YAAY,CAAC,WAAW;AAC9C,SAAG,MAAM;AACT,cAAQ,OAAO,YAAY,MAAM,OAAO,OAAO,YAAY,MAAM,KAAK;AAAA,IACxE,CAAC;AAAA,EACH,CAAC;AACH;AAEA,eAAsB,cAAc,UAAyB,CAAC,GAAkB;AAC9E,YAAU;AACV,YAAU,KAAK,SAAS,QAAQ,CAAC,IAAI,OAAO,GAAG,SAAS,KAAK,EAAE;AAC/D,YAAU;AAGV,MAAI,QAAQ,OAAO;AACjB,cAAU,KAAK,OAAO,GAAG,0BAA0B,KAAK,EAAE;AAC1D,UAAMA,QAAO,oBAAoB;AACjC,cAAU;AAEV,QAAIA,MAAK,iBAAiB;AACxB,gBAAU,KAAK,OAAO,IAAI,SAAI,KAAK,sBAAsB,OAAO,GAAG,GAAGA,MAAK,cAAc,GAAG,KAAK,WAAM,OAAO,KAAK,GAAGA,MAAK,aAAa,GAAG,KAAK,EAAE;AAClJ,gBAAU;AACV,gBAAU,KAAK,OAAO,GAAG,mCAAmC,KAAK,EAAE;AAAA,IACrE,OAAO;AACL,gBAAU,KAAK,OAAO,KAAK,GAAG,MAAM,OAAO,GAAG,KAAK,8BAA8B,OAAO,IAAI,GAAGA,MAAK,cAAc,GAAG,KAAK,EAAE;AAAA,IAC9H;AACA,cAAU;AACV;AAAA,EACF;AAGA,YAAU,KAAK,OAAO,GAAG,2BAA2B,KAAK,EAAE;AAC3D,QAAM,OAAO,oBAAoB;AAEjC,MAAI,CAAC,KAAK,iBAAiB;AACzB,cAAU;AACV,cAAU,KAAK,OAAO,KAAK,GAAG,MAAM,OAAO,GAAG,KAAK,8BAA8B,OAAO,IAAI,GAAG,KAAK,cAAc,GAAG,KAAK,EAAE;AAC5H,cAAU;AACV;AAAA,EACF;AAEA,YAAU;AACV,YAAU,KAAK,OAAO,IAAI,SAAI,KAAK,sBAAsB,OAAO,GAAG,GAAG,KAAK,cAAc,GAAG,KAAK,WAAM,OAAO,KAAK,GAAG,KAAK,aAAa,GAAG,KAAK,EAAE;AAClJ,YAAU;AAGV,QAAM,eAAe,QAAQ,OAAQ,MAAM,QAAQ,aAAa;AAEhE,MAAI,CAAC,cAAc;AACjB,cAAU;AACV,cAAU,KAAK,OAAO,GAAG,iBAAiB,KAAK,EAAE;AACjD,cAAU;AACV;AAAA,EACF;AAEA,YAAU;AACV,YAAU,KAAK,OAAO,GAAG,uBAAuB,KAAK,EAAE;AACvD,YAAU;AAEV,QAAM,SAAS,cAAc;AAE7B,YAAU;AACV,MAAI,OAAO,SAAS;AAClB,cAAU,KAAK,OAAO,KAAK,GAAG,MAAM,OAAO,GAAG,KAAK,eAAe,OAAO,KAAK,GAAG,KAAK,aAAa,GAAG,KAAK,EAAE;AAC7G,cAAU,KAAK,OAAO,GAAG,+CAA+C,KAAK,EAAE;AAAA,EACjF,OAAO;AACL,cAAU,KAAK,OAAO,GAAG,GAAG,MAAM,KAAK,GAAG,KAAK,mBAAmB,OAAO,KAAK,EAAE;AAChF,cAAU,KAAK,OAAO,GAAG,yCAAyC,KAAK,EAAE;AACzE,YAAQ,WAAW;AAAA,EACrB;AACA,YAAU;AACZ;","names":["info"]}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "squads-cli",
-  "version": "0.2.0",
-  "description": "A CLI for humans and agents",
+  "version": "0.2.1",
+  "description": "Your AI workforce. Every user gets an AI manager that runs their team — finance, marketing, engineering, operations — for the cost of API calls.",
   "type": "module",
   "bin": {
-    "squads": "./dist/cli.js"
+    "squads": "dist/cli.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,10 +15,11 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "templates"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && cp -r templates dist/",
     "dev": "tsup --watch",
     "start": "node dist/cli.js",
     "lint": "eslint src",
@@ -29,13 +30,26 @@
     "prepublishOnly": "npm run build"
   },
   "keywords": [
-    "ai",
-    "agents",
+    "ai-workforce",
+    "workforce",
+    "autonomous-agents",
+    "agent-framework",
+    "ai-automation",
+    "crewai-alternative",
+    "autogen-alternative",
+    "langgraph-alternative",
+    "multi-agent",
+    "orchestration",
+    "ai-agents",
+    "persistent-memory",
     "squads",
     "cli",
-    "automation",
     "claude",
-    "llm"
+    "claude-code",
+    "anthropic",
+    "mcp",
+    "agent-sdk",
+    "business-automation"
   ],
   "author": "Agents Squads <hello@agents-squads.com>",
   "license": "MIT",
@@ -55,21 +69,25 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@supabase/supabase-js": "^2.89.0",
+    "@anthropic-ai/sdk": "^0.71.2",
     "chalk": "^5.3.0",
+    "chrono-node": "^2.9.0",
     "commander": "^12.1.0",
     "dotenv": "^17.2.3",
+    "gray-matter": "^4.0.3",
     "inquirer": "^9.2.12",
+    "minimatch": "^10.2.1",
     "open": "^11.0.0",
-    "ora": "^8.0.1",
-    "pg": "^8.16.3"
+    "ora": "^8.0.1"
   },
   "devDependencies": {
+    "@changesets/changelog-github": "^0.6.0",
+    "@changesets/cli": "^2.30.0",
     "@eslint/js": "^9.39.2",
     "@types/node": "^20.19.27",
-    "@types/pg": "^8.16.0",
     "@typescript-eslint/eslint-plugin": "^8.51.0",
     "@typescript-eslint/parser": "^8.51.0",
+    "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",
     "tsup": "^8.0.1",
     "typescript": "^5.3.0",

package/templates/core/AGENTS.md.template

@@ -0,0 +1,51 @@
+# Agent Instructions
+
+Guidance for AI coding agents working on this project.
+
+## This Project Uses Squads
+
+AI agents are organized into squads — domain-aligned teams defined in `.agents/squads/`.
+
+```
+.agents/
+├── config/
+│   └── SYSTEM.md            # Rules every agent follows
+├── squads/
+│   └── <squad>/
+│       ├── SQUAD.md          # Squad identity, goals, output format
+│       └── <agent>.md        # Agent definition
+└── memory/
+    └── <squad>/<agent>/      # Persistent state
+```
+
+## Before Starting Work
+
+```bash
+squads status                     # See all squads, milestones, open PRs
+squads status <squad>             # Squad detail
+squads memory read <squad>        # What the squad already knows
+```
+
+## During Work
+
+- Check for existing PRs and issues before creating new ones
+- Prefer editing existing files over creating new ones
+- Keep changes focused — one task per commit/PR
+- Use `--json` on any squads command for machine-readable output
+
+## After Work
+
+- Persist learnings: `squads memory write <squad> "insight"`
+- Update state in `.agents/memory/<squad>/<agent>/state.md`
+- Create GitHub issues for follow-up work
+
+## Commands
+
+```bash
+squads run <squad/agent>          # Run an agent
+squads status                     # Overview
+squads memory read <squad>        # Recall squad knowledge
+squads memory write <squad> "x"   # Persist a learning
+squads env show <squad> --json    # Execution context
+squads goal list                  # View squad goals
+```

package/templates/core/BUSINESS_BRIEF.md.template

@@ -0,0 +1,29 @@
+# Business Brief
+
+## #1 Priority
+
+**[Define your top priority here]**
+
+## Runway
+
+**Pressure**: LOW | MEDIUM | HIGH
+
+## Current Focus
+
+1. **[Focus area 1]** - Description
+2. **[Focus area 2]** - Description
+3. **[Focus area 3]** - Description
+
+## Blockers
+
+- None currently (or list blockers)
+
+## Decision Framework
+
+1. Does this drive the #1 priority?
+2. Is there a simpler approach?
+3. What's the opportunity cost?
+
+---
+
+*This file is read by `squads context` to provide business alignment.*

package/templates/core/CLAUDE.md.template

@@ -0,0 +1,48 @@
+# Claude-Specific Instructions
+
+Extends AGENTS.md with Claude Code specific features.
+
+## New Project Setup
+
+If this project needs squads setup, run:
+```bash
+squads init    # Plant the seed: create manager, CLI skill, and squads
+```
+
+## Skill Available
+
+Use `/squads-workflow` for detailed workflow guidance.
+
+## Session Hooks
+
+Claude Code hooks are configured in `.claude/settings.json`:
+- **SessionStart**: Runs `squads status` automatically
+- **Stop**: Syncs memory and prompts for learnings
+
+## Creating Agents
+
+Agents live in `.agents/squads/<squad-name>/<agent-name>.md`:
+
+```markdown
+# Agent Name
+
+## Purpose
+One sentence: what this agent does.
+
+## Model
+simple  # or: worker, leader
+
+## Instructions
+1. Specific step
+2. Another step
+3. Output location
+
+## Output
+What it produces and where it goes.
+```
+
+## Commit Signature
+
+```
+Co-Authored-By: Claude <model> <noreply@anthropic.com>
+```

package/templates/core/provider.yaml.template

@@ -0,0 +1,5 @@
+# Squads Provider Configuration
+# Selected during: squads init
+# Change with: squads init --provider <name>
+
+provider: {{PROVIDER}}

package/templates/first-squad/SQUAD.md.template

@@ -0,0 +1,23 @@
+# {{SQUAD_NAME}}
+
+{{SQUAD_DESCRIPTION}}
+
+## Goals
+
+- [ ] {{GOAL}}
+
+## Agents
+
+| Agent | Purpose |
+|-------|---------|
+| lead | Orchestrates the squad and coordinates work |
+
+## Pipeline
+
+`lead` (orchestrates all work)
+
+## Usage
+
+```bash
+squads run {{SQUAD_ID}} --execute
+```

package/templates/first-squad/lead.md.template

@@ -0,0 +1,44 @@
+# Lead Agent
+
+## Purpose
+Orchestrate the {{SQUAD_NAME}} squad to achieve its goals.
+
+## Model
+leader
+
+## Tools
+- Read
+- Write
+- Edit
+- Bash
+- WebSearch
+- WebFetch
+- Task
+
+## Instructions
+
+You are the lead agent for the {{SQUAD_NAME}} squad.
+
+**Goal**: {{GOAL}}
+
+### Approach
+
+1. **Understand the goal** - Break down what needs to be accomplished
+2. **Plan the work** - Create a clear execution plan
+3. **Execute** - Work through the plan step by step
+4. **Verify** - Confirm the goal is achieved
+5. **Document** - Update memory with learnings
+
+### Guidelines
+
+- Use the Task tool to spawn sub-agents for complex, parallelizable work
+- Check existing memory before researching: `squads memory query "<topic>"`
+- Create GitHub issues for follow-up work
+- Update `.agents/memory/{{SQUAD_ID}}/lead/state.md` with progress
+
+## Output
+Progress updates and work artifacts as appropriate.
+
+## Labels
+- lead
+- orchestration

package/templates/memory/getting-started/state.md.template

@@ -0,0 +1,19 @@
+# Getting Started with Squads
+
+## What You've Set Up
+
+- **Your first squad** ready to run (`squads run {{SQUAD_ID}}`)
+- **Memory system** for persistent context
+- **Hooks** that sync status and memory automatically
+
+## Next Steps
+
+1. Run your squad: `squads run {{SQUAD_ID}} --execute`
+2. Check the dashboard: `squads dash`
+3. Create more squads in `.agents/squads/`
+
+## Tips
+
+- Check memory before researching: `squads memory query "<topic>"`
+- Use `squads context` for business alignment on complex tasks
+- Agents are reusable - if you do something twice, make it an agent

package/templates/seed/BUSINESS_BRIEF.md.template

@@ -0,0 +1,27 @@
+# Business Brief — {{BUSINESS_NAME}}
+
+{{PLACEHOLDER_SENTINEL}}## About
+
+{{BUSINESS_DESCRIPTION}}
+
+## Research Focus
+
+{{BUSINESS_FOCUS}}
+
+{{COMPETITORS_SECTION}}## Priority
+
+**#1**: Deliver value in the research focus above.
+
+## Pressure
+
+LOW — Learning phase. Explore, experiment, report findings.
+
+## Decision Framework
+
+1. Does this advance our focus area?
+2. Is there a simpler approach for 80% of the value?
+3. What's the opportunity cost?
+
+---
+
+*Read by all agents before every run. Edit this file to change what your workforce focuses on.*

package/templates/seed/CLAUDE.md.template

@@ -0,0 +1,119 @@
+# AI Workforce Operating Manual
+
+This project uses [Agents Squads](https://agents-squads.com) to run an AI workforce.
+
+## Structure
+
+```
+.agents/
+├── BUSINESS_BRIEF.md           # What this workforce focuses on
+├── config/
+│   ├── SYSTEM.md               # Rules every agent follows (Layer 0)
+│   └── provider.yaml           # LLM provider config
+├── squads/
+│   ├── intelligence/           # Strategic synthesis squad
+│   │   ├── SQUAD.md            # Mission, goals, agents
+│   │   ├── intel-lead.md       # Know / Don't Know / Playbook briefs
+│   │   ├── intel-eval.md       # Quality evaluation
+│   │   └── intel-critic.md     # Assumption challenges
+│   ├── research/               # Deep research squad
+│   │   ├── SQUAD.md
+│   │   ├── lead.md             # Research agenda
+│   │   ├── analyst.md          # Sourced findings
+│   │   └── synthesizer.md      # Synthesis reports
+│   ├── product/                # Product roadmap squad
+│   │   ├── SQUAD.md
+│   │   ├── lead.md             # Roadmap decisions
+│   │   ├── scanner.md          # Signal monitoring
+│   │   └── worker.md           # Specs and PRDs
+│   └── company/                # Orchestration + feedback
+│       ├── SQUAD.md
+│       ├── manager.md          # Coordinates all squads
+│       ├── company-eval.md     # Evaluates outputs
+│       └── company-critic.md   # Process improvement
+├── memory/
+│   ├── company/
+│   │   ├── manager/state.md
+│   │   └── directives.md       # Strategic overlay (Layer 3)
+│   ├── research/lead/state.md
+│   ├── intelligence/intel-lead/state.md
+│   └── product/lead/state.md
+└── skills/
+    └── squads-cli/SKILL.md     # CLI operations manual
+```
+
+## Context Cascade
+
+Every agent execution loads context in this order (higher layers always load, lower layers drop when token budget runs out):
+
+| Layer | File | Purpose |
+|-------|------|---------|
+| 0 | `config/SYSTEM.md` | Immutable rules — git, memory, escalation |
+| 1 | `squads/{squad}/SQUAD.md` | Mission, goals, output format |
+| 2 | `memory/{squad}/priorities.md` | Current operational focus |
+| 3 | `memory/company/directives.md` | Company-wide strategic overlay |
+| 4 | `memory/{squad}/active-work.md` | Open PRs/issues — prevent duplication |
+| 5 | `memory/{squad}/{agent}/state.md` | What the agent already knows |
+| 6 | `memory/{squad}/feedback.md` | Last cycle evaluation |
+| 7 | `memory/daily-briefing.md` | Cross-squad context |
+
+## Updating Business Goals
+
+When the human operator wants to change what the workforce focuses on, help them update these files in order:
+
+### 1. Business Brief (what we do)
+Edit `.agents/BUSINESS_BRIEF.md` — this is the root context every agent reads.
+```
+What does the business do? Who are the customers? What market?
+What should agents research first? Who are the competitors?
+```
+
+### 2. Directives (what matters now)
+Edit `.agents/memory/company/directives.md` — this overrides squad goals.
+```
+What is the P0 priority? What metric are we optimizing?
+What constraints apply? What should agents NOT do?
+```
+
+### 3. Squad Goals (what each team does)
+Edit `## Goals` in each `squads/{squad}/SQUAD.md`:
+```bash
+# Or use the CLI:
+squads goal set intelligence "Monitor competitor X's pricing weekly"
+squads goal set research "Deep dive on Y market segment"
+squads goal set product "Write spec for Z feature"
+```
+
+### 4. Priorities (what to do this week)
+Create or edit `.agents/memory/{squad}/priorities.md`:
+```
+- Fix issue #123 (blocking users)
+- Research competitor's new feature launch
+- Update roadmap based on last cycle's feedback
+```
+
+**Rule**: Goals are aspirational (stable). Priorities are operational (updated frequently). Directives are strategic (updated less frequently).
+
+## For Humans
+
+Common commands:
+- `squads status` — What's happening now
+- `squads dash` — Full dashboard
+- `squads run research/lead` — Run a specific agent
+- `squads run research --parallel` — Run the full squad
+- `squads memory read <squad>` — What has the squad learned
+- `squads goal list` — Business objectives
+
+## For Agents
+
+- Read `BUSINESS_BRIEF.md` and `directives.md` before starting work
+- Read your state from `memory/{squad}/{agent}/state.md`
+- Update state after every run
+- Use the `squads-cli` skill for CLI operations
+- Git is the coordination layer — commit everything
+
+## Commit Signature
+
+```
+Co-Authored-By: Claude <noreply@anthropic.com>
+```

package/templates/seed/README.md.template

@@ -0,0 +1,42 @@
+# {{BUSINESS_NAME}}
+
+{{BUSINESS_DESCRIPTION}}
+
+## AI Workforce
+
+This project uses [Agents Squads](https://agents-squads.com) — an AI workforce that runs autonomously.
+
+### Squads
+
+| Squad | Purpose |
+|-------|---------|
+| intelligence/ | Monitors trends and competitive signals |
+| research/ | Researches your market, competitors, and opportunities |
+| product/ | Roadmap, specs, user feedback synthesis |
+| company/ | Manages goals, events, and strategy |
+
+### Key Commands
+
+```bash
+# Run a single agent
+squads run research/lead
+
+# See all squads and recent activity
+squads dash
+
+# Check system status
+squads status
+```
+
+## Setup
+
+```bash
+npm install -g squads-cli
+squads init
+```
+
+Edit `.agents/BUSINESS_BRIEF.md` to customize agent context.
+
+---
+
+*Powered by [Agents Squads](https://agents-squads.com)*

package/templates/seed/config/SYSTEM.md

@@ -0,0 +1,52 @@
+# System Protocol
+
+Immutable rules for all agent executions. Every agent reads this before starting work.
+
+## Before You Start
+
+Read `.agents/BUSINESS_BRIEF.md`. If it contains "PLACEHOLDER" in the first lines, STOP and tell the user:
+"Edit .agents/BUSINESS_BRIEF.md with your business details before running agents."
+Do not produce generic output from placeholder context.
+
+## Git Workflow
+
+Commit all changes. Git is the coordination layer — if it's not committed, it didn't happen.
+
+```bash
+git add -A
+git commit -m "{type}({scope}): {description}
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+git push origin main
+```
+
+### Commit types
+`feat`, `fix`, `docs`, `chore`, `memory`, `refactor`, `test`
+
+## Memory Protocol
+
+- **Read before acting.** Always check `.agents/memory/{squad}/{agent}/state.md` before starting work.
+- **Write after acting.** Update state.md with what you did, what you learned, and what's next.
+- **Don't repeat work.** If state.md says something was already done, build on it — don't redo it.
+
+## Output Rules
+
+- Every claim needs a source (URL, document, or data point)
+- "Interesting" is not enough — outputs must be actionable
+- If nothing changed since last run, say so explicitly and stop
+- Quality over quantity — 3 actionable insights beat 20 generic observations
+
+## Escalation
+
+Escalate to the human operator when:
+- Spend exceeds $50 in a single session
+- Scope is unclear or contradicts business goals
+- A destructive action is needed (deleting data, overwriting work)
+- You're unsure whether to proceed
+
+## Coordination
+
+- Agents communicate through memory files, not direct messages
+- Squad leads coordinate their agents via state.md and memory writes
+- The company manager coordinates across squads
+- Check `squads status --json` for org-wide awareness

package/templates/seed/config/provider.yaml

@@ -0,0 +1,4 @@
+# Squads Provider Configuration
+# Selected during: squads init
+
+provider: {{PROVIDER}}