ai-squad 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +131 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +1013 -0
- package/package.json +49 -0
- package/sections/opencode/agents/identity/adversarial-reviewer.md +98 -0
- package/sections/opencode/agents/identity/architect.md +122 -0
- package/sections/opencode/agents/identity/docs-writer.md +53 -0
- package/sections/opencode/agents/identity/fullstack-dev.md +79 -0
- package/sections/opencode/agents/identity/memory-keeper.md +192 -0
- package/sections/opencode/agents/identity/po.md +102 -0
- package/sections/opencode/agents/identity/qa.md +90 -0
- package/sections/opencode/agents/identity/reviewer.md +84 -0
- package/sections/opencode/agents/identity/teamlead.md +101 -0
- package/sections/opencode/agents/identity/ux-ui.md +87 -0
- package/sections/opencode/agents/standards/generic.md +36 -0
- package/sections/opencode/agents/standards/nextjs.md +29 -0
- package/sections/opencode/agents/standards/python.md +217 -0
- package/sections/opencode/agents/standards/react.md +130 -0
- package/sections/opencode/agents/standards/typescript.md +30 -0
- package/sections/opencode/agents/workflow/context.md +24 -0
- package/sections/opencode/agents/workflow/memory.md +32 -0
- package/sections/opencode/agents/workflow/sessions.md +38 -0
- package/sections/opencode/agents/workflow/tasks.md +40 -0
- package/sections/opencode/config/agents.md +11 -0
- package/sections/opencode/context/nextjs/architecture.md +13 -0
- package/sections/opencode/context/nextjs/conventions.md +20 -0
- package/sections/opencode/context/nextjs/stack.md +14 -0
- package/sections/opencode/context/python/architecture.md +13 -0
- package/sections/opencode/context/python/conventions.md +19 -0
- package/sections/opencode/context/python/stack.md +14 -0
- package/sections/opencode/workflow/context.md +14 -0
- package/sections/opencode/workflow/memory.md +12 -0
- package/sections/opencode/workflow/sessions.md +20 -0
- package/sections/opencode/workflow/state.md +20 -0
- package/sections/opencode/workflow/tasks.md +13 -0
- package/sections/shared/frontmatter/adversarial-reviewer.yaml +7 -0
- package/sections/shared/frontmatter/architect.yaml +7 -0
- package/sections/shared/frontmatter/docs-writer.yaml +7 -0
- package/sections/shared/frontmatter/fullstack-dev.yaml +7 -0
- package/sections/shared/frontmatter/memory-keeper.yaml +7 -0
- package/sections/shared/frontmatter/po.yaml +7 -0
- package/sections/shared/frontmatter/qa.yaml +7 -0
- package/sections/shared/frontmatter/reviewer.yaml +7 -0
- package/sections/shared/frontmatter/teamlead.yaml +8 -0
- package/sections/shared/frontmatter/ux-ui.yaml +7 -0
- package/sections/shared/memory/conventions.md +10 -0
- package/sections/shared/memory/decisions.md +13 -0
- package/sections/shared/memory/patterns.md +12 -0
- package/sections/shared/task-template.md +44 -0
package/README.md
ADDED
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
# AI Squad
|
|
2
|
+
|
|
3
|
+
Interactive CLI to scaffold AI agent infrastructure for new OpenCode projects. Generates agent definitions, workflow files, task management, memory systems, and context documentation in one command.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g ai-squad
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Or run without installing:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npx ai-squad init
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Usage
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
ai-squad init
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Interactive wizard walks you through:
|
|
24
|
+
|
|
25
|
+
1. **Project name** — creates a new directory
|
|
26
|
+
2. **Tech stack** — selects standards and skills (Next.js, React, TypeScript, Tailwind, Python, etc.)
|
|
27
|
+
3. **Squad** — picks your agent team (Solo, Startup, Standard, Enterprise, Frontend, Backend)
|
|
28
|
+
4. **Infrastructure level** — Minimal, Essential, Standard, or Comprehensive
|
|
29
|
+
5. **Skills** — auto-recommends installable agent skills based on tech stack
|
|
30
|
+
6. **Review & Generate** — confirm or dry-run
|
|
31
|
+
|
|
32
|
+
## What It Generates
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
my-project/
|
|
36
|
+
├── AGENTS.md # Agent roster index
|
|
37
|
+
├── opencode.json # OpenCode config with agent permissions
|
|
38
|
+
├── .opencode/
|
|
39
|
+
│ ├── agents/
|
|
40
|
+
│ │ ├── squad-teamlead.md # Team Lead — orchestrates the squad
|
|
41
|
+
│ │ ├── squad-po.md # Product Owner — scopes features into tasks
|
|
42
|
+
│ │ ├── squad-architect.md # System Architect — designs architecture
|
|
43
|
+
│ │ ├── squad-fullstack-dev.md
|
|
44
|
+
│ │ ├── squad-reviewer.md
|
|
45
|
+
│ │ ├── squad-qa.md
|
|
46
|
+
│ │ └── ...
|
|
47
|
+
│ ├── workflow/ # Dynamic workflow instructions
|
|
48
|
+
│ │ ├── state.md
|
|
49
|
+
│ │ ├── tasks.md
|
|
50
|
+
│ │ ├── memory.md
|
|
51
|
+
│ │ └── context.md
|
|
52
|
+
│ └── skills/ # Installed agent skills (optional)
|
|
53
|
+
├── .agent/
|
|
54
|
+
│ ├── tasks/ # Task files with acceptance criteria
|
|
55
|
+
│ │ ├── TASK_TEMPLATE.md
|
|
56
|
+
│ │ └── task-01.md
|
|
57
|
+
│ ├── memory/ # Decision log + conventions + patterns
|
|
58
|
+
│ │ ├── decisions.md
|
|
59
|
+
│ │ └── conventions.md
|
|
60
|
+
│ └── context/ # Technology-specific reference docs
|
|
61
|
+
│ └── project/
|
|
62
|
+
│ ├── stack.md
|
|
63
|
+
│ ├── conventions.md
|
|
64
|
+
│ └── architecture.md
|
|
65
|
+
└── skills-lock.json # Locked skill versions
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Squads
|
|
69
|
+
|
|
70
|
+
| Squad | Agents | Best For |
|
|
71
|
+
|---|---|---|
|
|
72
|
+
| **Solo** | fullstack-dev, reviewer | Quick projects, solo devs |
|
|
73
|
+
| **Startup** | teamlead, po, fullstack-dev, reviewer, qa | Small teams, fast iteration |
|
|
74
|
+
| **Standard** | teamlead, po, architect, fullstack-dev, reviewer, ux-ui, qa, memory-keeper | Production apps |
|
|
75
|
+
| **Enterprise** | teamlead, po, architect, fullstack-dev, reviewer, ux-ui, qa, adversarial-reviewer, docs-writer, memory-keeper | High-stakes, compliance |
|
|
76
|
+
| **Frontend** | fullstack-dev, ux-ui, reviewer | UI-heavy projects |
|
|
77
|
+
| **Backend** | architect, fullstack-dev, reviewer, qa | API/database projects |
|
|
78
|
+
|
|
79
|
+
## Infrastructure Levels
|
|
80
|
+
|
|
81
|
+
| Level | Includes |
|
|
82
|
+
|---|---|
|
|
83
|
+
| **Minimal** | Just the agents — no tasks, memory, or context |
|
|
84
|
+
| **Essential** | + task management + state tracking |
|
|
85
|
+
| **Standard** | + memory system + context docs |
|
|
86
|
+
| **Comprehensive** | + session logs + patterns + full context |
|
|
87
|
+
|
|
88
|
+
## Team Lead Orchestration
|
|
89
|
+
|
|
90
|
+
Squads with a Product Owner (Startup, Standard, Enterprise) auto-include a Team Lead agent. The Team Lead is the only agent that talks to the user — it assesses work type, dispatches agents in the right pipeline, synthesizes results, and never writes code itself.
|
|
91
|
+
|
|
92
|
+
**Pipeline by work type:**
|
|
93
|
+
|
|
94
|
+
| Level | Pipeline |
|
|
95
|
+
|---|---|
|
|
96
|
+
| **TINY** | dev → reviewer → memory-keeper |
|
|
97
|
+
| **SMALL** | po → dev → reviewer ‖ ux-ui ‖ qa → memory-keeper |
|
|
98
|
+
| **MEDIUM** | po → architect → dev → reviewer ‖ ux-ui ‖ qa → memory-keeper |
|
|
99
|
+
| **SECURITY** | Same as MEDIUM + heightened security scrutiny |
|
|
100
|
+
| **MAJOR** | Same as MEDIUM + architect full design + full regression |
|
|
101
|
+
|
|
102
|
+
## Skills
|
|
103
|
+
|
|
104
|
+
The CLI auto-recommends installable skills from [skills.sh](https://skills.sh) based on your tech stack:
|
|
105
|
+
|
|
106
|
+
| Tech Stack | Skills |
|
|
107
|
+
|---|---|
|
|
108
|
+
| Next.js | vercel-labs/agent-skills (react-best-practices, composition-patterns) |
|
|
109
|
+
| React | vercel-labs/agent-skills, shadcn/ui |
|
|
110
|
+
| TypeScript | mattpocock/skills |
|
|
111
|
+
| Tailwind | vercel-labs/agent-skills (web-design-guidelines), shadcn/ui |
|
|
112
|
+
| Convex | get-convex/agent-skills (convex-quickstart, convex-setup-auth, etc.) |
|
|
113
|
+
|
|
114
|
+
Skills are installed via `npx skills add` during generation.
|
|
115
|
+
|
|
116
|
+
## Development
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
git clone https://github.com/pouryafekri/ai-squad
|
|
120
|
+
cd ai-squad
|
|
121
|
+
npm install
|
|
122
|
+
npm run dev # Run with tsx
|
|
123
|
+
npm run build # Build with tsup
|
|
124
|
+
npm test # Run tests (vitest)
|
|
125
|
+
npm run typecheck # TypeScript check
|
|
126
|
+
npm link # Link globally for local testing
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
## License
|
|
130
|
+
|
|
131
|
+
MIT", "filePath": "/Users/pourya/Documents/Projects/Personal/ai-squad/README.md"}
|
package/dist/index.d.ts
ADDED