squads-cli 0.2.0 → 0.2.2

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,58 @@
+---
+version: "1.0"
+scope: "all-agents"
+authority: "squads-cli"
+---
+
+# 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}}

package/templates/seed/hooks/settings.json.template

@@ -0,0 +1,31 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "squads status",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "squads memory sync --no-push",
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "squads memory sync --push",
+            "timeout": 15
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/seed/idp/catalog/service.yaml.template

@@ -0,0 +1,25 @@
+apiVersion: squads/v1
+kind: Service
+metadata:
+  name: "{{SERVICE_NAME}}"
+  description: "{{BUSINESS_DESCRIPTION}}"
+  owner: "{{OWNER_SQUAD}}"
+  repo: "{{REPO_NAME}}"
+  tags: []
+spec:
+  type: "{{SERVICE_TYPE}}"
+  stack: "{{SERVICE_STACK}}"
+  branches:
+    default: main
+    development: {{BRANCHES_DEVELOPMENT}}
+    workflow: "{{BRANCHES_WORKFLOW}}"
+  ci:
+    template: {{CI_TEMPLATE}}
+    required_checks: []
+    build_command: {{BUILD_COMMAND}}
+    test_command: {{TEST_COMMAND}}
+  deploy: null
+  health: []
+  dependencies:
+    runtime: []
+  scorecard: "{{SERVICE_SCORECARD}}"

package/templates/seed/memory/_squad/goals.md

@@ -0,0 +1,23 @@
+---
+squad: "{{SQUAD_NAME}}"
+updated: "{{CURRENT_DATE}}"
+review_by: "{{REVIEW_DATE}}"
+owner: "{{SQUAD_LEAD}}"
+---
+
+# {{SQUAD_LABEL}} Goals
+
+## Active
+
+(No goals set yet — add your first goal here)
+
+Example format:
+1. **Goal name** — metric: what_to_measure | baseline: unknown | target: X | deadline: YYYY-MM-DD | status: not-started
+
+## Achieved
+
+(none yet)
+
+## Abandoned
+
+(none yet)

package/templates/seed/memory/_squad/priorities.md

@@ -0,0 +1,25 @@
+---
+squad: "{{SQUAD_NAME}}"
+updated: "{{CURRENT_DATE}}"
+review_by: "{{REVIEW_DATE}}"
+owner: "{{SQUAD_LEAD}}"
+---
+
+# {{SQUAD_LABEL}} Priorities
+
+## Focus
+
+1. **Deliver first results** — produce at least one concrete output per cycle
+2. **Learn the context** — read BUSINESS_BRIEF.md and recent squad state before acting
+3. **Collaborate** — coordinate with other squads through memory, not direct calls
+
+## Not Now
+
+- Deep refactoring without a clear need
+- Experimental features not tied to business goals
+
+## Standing Rules
+
+- Always read state.md before starting — don't repeat work
+- Always write state.md after completing — enable the next run
+- Escalate blockers immediately — don't spin in place

package/templates/seed/memory/company/company.md

@@ -0,0 +1,31 @@
+---
+type: "company-context"
+updated: "{{CURRENT_DATE}}"
+owner: "manager"
+---
+
+# Company Context
+
+## Mission
+
+{{BUSINESS_DESCRIPTION}}
+
+## What We Build
+
+(Add product or service details here)
+
+## Who Uses It
+
+(Add target customer details here)
+
+## Product
+
+| Offering | Role |
+|----------|------|
+| (Add your products/services) | |
+
+## Alignment
+
+- Results over promises — ship working things
+- Simple over clever — prefer straightforward solutions
+- Customer zero — use your own product

package/templates/seed/memory/company/directives.md

@@ -0,0 +1,37 @@
+# Strategic Directives
+
+> Updated by: Human operator (you)
+> Read by: All squad leads and agents before every run
+> This file overrides any conflicting guidance in SQUAD.md goals
+
+## Mission
+
+{{BUSINESS_DESCRIPTION}}
+
+## P0: First Value
+
+**All squads work toward delivering visible, useful output from the very first run.**
+
+Research focus: {{BUSINESS_FOCUS}}
+
+### What "useful" means
+- Intelligence produces a brief with sourced facts, not generic summaries
+- Research identifies specific competitors and opportunities, not "the market is growing"
+- Product translates findings into concrete next steps, not vague roadmaps
+- Company evaluates whether outputs actually advanced the business goals
+
+## Decision Framework
+
+1. Does this advance the research focus above?
+2. Is there a simpler approach for 80% of the value?
+3. What's the opportunity cost — what are we NOT doing?
+
+## Constraints
+
+- Learning phase. Explore, experiment, report findings.
+- Don't over-invest in process. Produce output first, optimize later.
+- Every agent output should be something the human operator can act on today.
+
+---
+
+*Update this file as your business goals evolve. Run `squads goal set` for squad-level goals.*

package/templates/seed/memory/company/manager/state.md

@@ -0,0 +1,16 @@
+# Manager State
+
+## Last Run
+Never — awaiting first execution.
+
+## Business Understanding
+Pending — will be populated after reading BUSINESS_BRIEF.md.
+
+## Active Squads
+- company (5 agents)
+- research (4 agents)
+
+## Priorities
+1. Read and understand business context
+2. Run initial research
+3. Establish operational rhythm

package/templates/seed/memory/engineering/issue-solver/state.md

@@ -0,0 +1,12 @@
+# Issue Solver State
+
+## Last Run
+Never — awaiting first execution.
+
+## Issues Solved
+None yet.
+
+## Priorities
+1. Check for open GitHub issues
+2. Pick highest-priority solvable issue
+3. Create a PR with the fix

package/templates/seed/memory/intelligence/intel-lead/state.md

@@ -0,0 +1,9 @@
+# Intel Lead - State
+
+> Updated: never
+
+## Last Brief
+No briefs produced yet. First run pending.
+
+## Coverage
+No topics covered yet.

package/templates/seed/memory/marketing/content-drafter/state.md

@@ -0,0 +1,12 @@
+# Content Drafter State
+
+## Last Run
+Never — awaiting first execution.
+
+## Drafts Created
+None yet.
+
+## Priorities
+1. Read business brief for context
+2. Draft first piece of content
+3. Establish content rhythm

package/templates/seed/memory/operations/ops-lead/state.md

@@ -0,0 +1,12 @@
+# Ops Lead State
+
+## Last Run
+Never — awaiting first execution.
+
+## Squads Observed
+None yet.
+
+## Priorities
+1. Read all squad states
+2. Identify what needs founder attention
+3. Establish daily briefing rhythm

package/templates/seed/memory/product/lead/state.md

@@ -0,0 +1,14 @@
+# Product Lead State
+
+Last update: {{CURRENT_DATE}}
+
+## Active Roadmap
+- [ ] Initialize product strategy from BUSINESS_BRIEF.md
+- [ ] Define initial feature set and priorities
+- [ ] Establish feedback synthesis loop
+
+## Current Focus
+Initial project setup and alignment with business objectives.
+
+## Insights & Learnings
+- No insights yet. Run the product squad to start capturing memory.

package/templates/seed/memory/research/lead/state.md

@@ -0,0 +1,14 @@
+# Research Lead State
+
+Last update: {{CURRENT_DATE}}
+
+## Active Research Topics
+- [ ] Initial market landscape from BUSINESS_BRIEF.md
+- [ ] Key competitor identification
+- [ ] Strategic growth opportunities
+
+## Current Focus
+Initial project setup and market alignment.
+
+## Findings Summary
+- No findings yet. Run the research squad to start capturing memory.

package/templates/seed/skills/gh/SKILL.md

@@ -0,0 +1,57 @@
+# gh — GitHub CLI Operations
+
+You have access to `gh` (GitHub CLI) for repository and project management.
+
+## Issues
+
+```bash
+gh issue list                              # List open issues
+gh issue list --label "bug"                # Filter by label
+gh issue view <number>                     # View issue details
+gh issue create --title "..." --body "..." # Create issue
+gh issue close <number>                    # Close issue
+gh issue comment <number> --body "..."     # Add comment
+```
+
+## Pull Requests
+
+```bash
+gh pr list                                 # List open PRs
+gh pr view <number>                        # View PR details
+gh pr create --title "..." --body "..."    # Create PR
+gh pr merge <number>                       # Merge PR
+gh pr review <number> --approve            # Approve PR
+gh pr checks <number>                      # View CI status
+gh pr diff <number>                        # View PR diff
+```
+
+## Repository
+
+```bash
+gh repo view                               # View repo info
+gh repo clone <owner/repo>                 # Clone repo
+gh api repos/<owner>/<repo>                # Raw API access
+```
+
+## Workflow Runs
+
+```bash
+gh run list                                # List recent runs
+gh run view <id>                           # View run details
+gh run watch <id>                          # Watch run in progress
+```
+
+## Search
+
+```bash
+gh search repos "<query>"                  # Search repos
+gh search issues "<query>"                 # Search issues
+gh search prs "<query>"                    # Search PRs
+```
+
+## Best Practices
+
+- **Check before creating**: Search existing issues/PRs before creating duplicates
+- **Use labels**: Filter and organize with labels
+- **Link issues**: Reference issues in PR descriptions with `Fixes #N`
+- **Review CI**: Always check `gh pr checks` before merging