Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .ai-team/agents/fenster/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ _Summarized from initial architecture review (2026-02-07). Full entries in `hist
## Recent Updates

📌 Team update (2026-02-13): VS Code runSubagent spawning — platform parity and adaptation strategy (consolidated). runSubagent viable with platform detection and custom .agent.md files. Spawn patterns all map 1:1; model selection is the gap; recommendation: prompt-level platform detection, no abstraction layer. Unblocks #32-35. — decided by Keaton, Strausz, Kujan
📌 Team update (2026-02-13): MCP integration — coordinator awareness and CLI config generation. Added MCP Integration section to squad.agent.md, MCP context block to spawn template, and `.copilot/mcp-config.json` sample generation to `squad init` and `squad upgrade`. Issue #11 resolved. — decided by Fenster
📌 Team update (2026-02-09): No npm publish — GitHub-only distribution. Kobayashi hired as Git & Release Engineer. Release plan (021) filed. Sprint plan 019a amended: item 1.8 cancelled, items 1.11-1.13 added.
📌 Team update (2026-02-08): CI pipeline created — GitHub Actions runs tests on push/PR to main/dev. PRs now have automated quality gate. — decided by Hockney
📌 Team update (2026-02-08): Coordinator now captures user directives to decisions inbox before routing work. Directives persist to decisions.md via Scribe. — decided by Kujan
Expand Down Expand Up @@ -116,3 +117,5 @@ _Summarized from initial architecture review (2026-02-07). Full entries in `hist


📌 Team update (2026-02-13): Projects V2 Phase 1 validation complete — all gh project * commands validated live, no npm dependencies needed. Unblocks WI-3 (board init), WI-4 (label-to-board sync), WI-5 (board query). — decided by Fenster

- **MCP integration shipped (#11).** Added MCP Integration section to squad.agent.md (after Client Compatibility, before Eager Execution): detection via tool prefix scanning, routing rules (coordinator direct vs spawn with context), graceful degradation (CLI fallback → inform user → continue without), config file locations, Trello sample config. References the existing MCP skill at `.ai-team/skills/mcp-tool-discovery/SKILL.md` instead of duplicating it. Updated spawn template with optional MCP TOOLS AVAILABLE block. Added MCP config generation to `squad init` (creates `.copilot/mcp-config.json` sample with `EXAMPLE-trello` prefix pattern). Added 0.4.0 upgrade migration so existing installs get the sample config on `squad upgrade`. Both init and migration are idempotent (skip if file exists).
2 changes: 2 additions & 0 deletions .ai-team/agents/keaton/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,8 @@ _Summarized from initial architecture review and proposal-first design (2026-02-
## Recent Updates

📌 Team update (2026-02-13): VS Code runSubagent spawning — platform parity and adaptation strategy (consolidated). runSubagent viable with platform detection and custom .agent.md files. Spawn patterns all map 1:1; model selection is the gap; recommendation: prompt-level platform detection, no abstraction layer. Unblocks #32-35. — decided by Keaton, Strausz, Kujan
📌 Team update (2026-02-13): Context window optimization — spawn template dedup and Init Mode compression. Applied surgical optimizations to squad.agent.md (Issue #37): removed two redundant spawn templates, compressed Init Mode from 84 to 48 lines. Saved ~4,270 tokens per coordinator message. — decided by Keaton
📌 Team update (2026-02-13): Plugin Marketplace Integration. When adding new team members, coordinator checks configured plugin marketplaces for relevant templates and skills. State in `.ai-team/plugins/marketplaces.json`. CLI: `squad plugin marketplace add|remove|list|browse`. Issue #29 resolved. — decided by Keaton
📌 Team update (2026-02-08): Proposal 023 — coordinator extracts all actionable items from messages, new backlog.md as third memory channel (intent), SQL rejected as primary store, proactive backlog surfacing as Phase 3 — decided by Verbal
📌 Team update (2026-02-08): .ai-team/ must NEVER be tracked in git on main. Three-layer protection: .gitignore, package.json files allowlist, .npmignore. — decided by Verbal
📌 Team update (2026-02-08): Incoming queue architecture finalized — SQL hot layer + filesystem durable store, team backlog as third memory channel, agent cloning ready. — decided by Verbal
Expand Down
54 changes: 54 additions & 0 deletions .ai-team/decisions.md
Original file line number Diff line number Diff line change
Expand Up @@ -1651,3 +1651,57 @@ Created `docs/scenarios/client-compatibility.md` as the single source of truth f
**What:** Agent role emoji should be prepended to the `description` field in CLI `task` tool spawns. E.g., `"🔧 Fenster: refactoring auth module"` instead of `"Fenster: refactoring auth module"`. The roster already maps emoji to roles (🏗️ Lead, 🔧 Core Dev, ⚛️ Frontend, 🧪 Tester, 📝 DevRel, ✏️ Prompt Engineer, 📋 Scribe, 🔄 Ralph). Carry them into spawn descriptions.
**Why:** User request — captured for team memory. Extends the VS Code emoji directive to CLI. Both platforms should show agent identity with role emoji.



### 2026-02-15: MCP integration — coordinator awareness and CLI config generation
**By:** Fenster
**What:** Added MCP Integration section to squad.agent.md, MCP context block to spawn template, and `.copilot/mcp-config.json` sample generation to `squad init` and `squad upgrade`.
**Why:** Issue #11 — enable Squad to use MCP services (Trello, Aspire, etc.). Squad doesn't own MCP server lifecycle; it teaches agents awareness and provides a sample config with the `EXAMPLE-` prefix pattern so users know where to configure. The upgrade migration ensures existing installs get the sample config.


### 2026-02-13: Context window optimization — spawn template dedup and Init Mode compression

**By:** Keaton

**What:** Applied two surgical optimizations to squad.agent.md (Issue #37): (1) Removed two redundant spawn templates (Background and Sync), replaced with single generic template plus mode selection notes. Saved ~3,600 tokens. (2) Compressed Init Mode from 84 lines to ~48 lines by replacing file tree example with one-liner reference, condensing post-setup input sources to bulleted list, tightening casting state init. Saved ~670 tokens. Total savings: ~4,270 tokens per coordinator message.

**Why:** squad.agent.md is loaded on every coordinator spawn (every user message). Init Mode occupies context space on all messages but is only used once per repo lifetime (when .ai-team/team.md doesn't exist). The three spawn templates were 95% identical — same sections (charter, history, decisions, OUTPUT HYGIENE, RESPONSE ORDER, skill extraction), differing only in mode parameter and example agent names (Ripley, Dallas, {Name}). This redundancy consumed context window space without adding value — developers only need one reference template with mode selection guidance, not three full examples. Init Mode's file tree example (lines 55-75) duplicated .ai-team-templates/ content. Post-setup input sources (lines 97-111) repeated the same "If yes, follow..." pattern 4 times. Both optimizations preserve all behavior and all required sections while eliminating prose redundancy.


### 2026-02-15: Plugin Marketplace Integration

**Date:** 2026-02-15
**Decided by:** Keaton (Lead)
**Issue:** #29 — New team members should leverage configured plugin marketplace
**Status:** Implemented

## What

When adding new team members, the coordinator now checks configured plugin marketplaces for relevant templates and skills. This enables community-driven agent customization — e.g., prompting for "Azure cloud development" can discover and install an `azure-cloud-development` plugin automatically.

## Architecture

- **State:** `.ai-team/plugins/marketplaces.json` — JSON file listing registered marketplace sources (GitHub repos)
- **CLI:** `squad plugin marketplace add|remove|list|browse` — four subcommands for marketplace management
- **Coordinator flow:** Adding Team Members section updated with marketplace check step between name allocation and charter generation
- **Discovery:** `browse` command reads a marketplace repo's directory listing via `gh api` to find available plugins
- **Installation:** Plugin content copied into `.ai-team/skills/{plugin-name}/SKILL.md` or merged into agent charter

## Graceful Degradation

- No marketplaces configured → skip silently
- Marketplace unreachable → warn and continue
- No matching plugins → inform and proceed

## Trade-offs

- **Simple discovery model:** Directory listing, not a manifest. Low barrier for marketplace authors but less metadata. Good enough for v0.4.0; can add `manifest.json` later.
- **gh CLI dependency for browse:** Requires GitHub CLI installed and authenticated. Acceptable since Squad already depends on `gh` for other features.
- **No auto-install:** Always asks the user before installing. Respects user agency.

## Files Changed

- `.github/agents/squad.agent.md` — Added Plugin Marketplace section, updated Adding Team Members flow, added to Source of Truth table
- `index.js` — Added `plugin marketplace` subcommands, `plugins/` directory creation, v0.4.0 migration


7 changes: 0 additions & 7 deletions .ai-team/decisions/inbox/keaton-context-optimization.md

This file was deleted.

39 changes: 39 additions & 0 deletions .ai-team/log/2026-02-13-readme-context-budget-update.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Session: 2026-02-13 — README Context Budget Update

**Requested by:** Brady

## What Happened

1. **README Updated**
- McManus added v0.4.0 "What's New" section documenting Project Boards (Issue #6), Async Notifications, VS Code compatibility, and progress signals
- Added new "Status" line: "Stable — v0.2.0 shipped" replacing "Experimental"
- Cross-referenced new docs/scenarios/client-compatibility.md for multi-platform support matrix

2. **Context Window Budget Table Revised**
- Coordinator: ~28.8K tokens (realistic, measured)
- decisions.md: ~80K tokens (measured after deduplication)
- Agent charter pool: ~8-12K tokens per agent (measured)
- Spawn templates: ~2-3K tokens each (measured)
- Total budget utilization: Agents 41-46% of available context
- Identified compression opportunities: Spawn template reuse, skill-based auxiliary features

3. **Emoji Directives Captured**
- **Directive 1:** VS Code agent picker should show role emoji in agent name (e.g., "🔧 Fenster")
- **Directive 2:** CLI task spawns should prepend role emoji to description field
- Roster mappings: 🏗️ Lead, 🔧 Core Dev, ⚛️ Frontend, 🧪 Tester, 📝 DevRel, ✏️ Prompt Engineer, 📋 Scribe, 🔄 Ralph

4. **Issue #10 Addressed**
- Keaton posted comprehensive go/no-go assessment for Issue #6 (Project Boards)
- Feature approved for v0.4.0 with three-phase implementation (17-26 squad-hours)
- Architectural soundness confirmed; zero dependencies constraint validated

## Participants

- Brady (product direction)
- McManus (documentation updates)
- Keaton (decision coordination)
- Coordinator (session orchestration)

## Status

✅ Session complete. All artifacts ready for merge.
37 changes: 37 additions & 0 deletions .ai-team/log/2026-02-13-v040-merge-cleanup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Session: 2026-02-13 v0.4.0 Sprint Merge Cleanup

**Requested by:** Brady (bradygaster)
**Date:** 2026-02-13

## Summary

v0.4.0 sprint results collected and merged into main branch. All 9 issues resolved, 3 PRs merged, 1 PR closed as duplicate.

## Details

### Merges

- **PR #38** (McManus) — Documentation updates
- **PR #39** (Hockney) — Test coverage expansion
- **PR #40** (Keaton) — Coordinator architecture + CLI implementation

### Closed

- **PR #41** (Fenster) — MCP work closed as duplicate of Keaton's delivery in PR #40

### Issues Closed

- **#11** (MCP integration) — resolved by PR #40
- **#27** (Notifications) — resolved by PR #39
- **#29** (Plugin marketplace) — resolved by documentation in PR #38

### Agents Active

- McManus — documentation delivery
- Keaton — architecture & code (coordinator + CLI)
- Hockney — testing & validation
- Fenster — MCP (redundant work, superseded by Keaton)

## Outcomes

All v0.4.0 sprint objectives met. Main branch is up to date with sprint deliverables.
3 changes: 3 additions & 0 deletions .ai-team/plugins/marketplaces.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"marketplaces": []
}
11 changes: 0 additions & 11 deletions team-docs/README.md

This file was deleted.

Loading