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.
Files changed (49) hide show
  1. package/README.md +131 -0
  2. package/dist/index.d.ts +2 -0
  3. package/dist/index.js +1013 -0
  4. package/package.json +49 -0
  5. package/sections/opencode/agents/identity/adversarial-reviewer.md +98 -0
  6. package/sections/opencode/agents/identity/architect.md +122 -0
  7. package/sections/opencode/agents/identity/docs-writer.md +53 -0
  8. package/sections/opencode/agents/identity/fullstack-dev.md +79 -0
  9. package/sections/opencode/agents/identity/memory-keeper.md +192 -0
  10. package/sections/opencode/agents/identity/po.md +102 -0
  11. package/sections/opencode/agents/identity/qa.md +90 -0
  12. package/sections/opencode/agents/identity/reviewer.md +84 -0
  13. package/sections/opencode/agents/identity/teamlead.md +101 -0
  14. package/sections/opencode/agents/identity/ux-ui.md +87 -0
  15. package/sections/opencode/agents/standards/generic.md +36 -0
  16. package/sections/opencode/agents/standards/nextjs.md +29 -0
  17. package/sections/opencode/agents/standards/python.md +217 -0
  18. package/sections/opencode/agents/standards/react.md +130 -0
  19. package/sections/opencode/agents/standards/typescript.md +30 -0
  20. package/sections/opencode/agents/workflow/context.md +24 -0
  21. package/sections/opencode/agents/workflow/memory.md +32 -0
  22. package/sections/opencode/agents/workflow/sessions.md +38 -0
  23. package/sections/opencode/agents/workflow/tasks.md +40 -0
  24. package/sections/opencode/config/agents.md +11 -0
  25. package/sections/opencode/context/nextjs/architecture.md +13 -0
  26. package/sections/opencode/context/nextjs/conventions.md +20 -0
  27. package/sections/opencode/context/nextjs/stack.md +14 -0
  28. package/sections/opencode/context/python/architecture.md +13 -0
  29. package/sections/opencode/context/python/conventions.md +19 -0
  30. package/sections/opencode/context/python/stack.md +14 -0
  31. package/sections/opencode/workflow/context.md +14 -0
  32. package/sections/opencode/workflow/memory.md +12 -0
  33. package/sections/opencode/workflow/sessions.md +20 -0
  34. package/sections/opencode/workflow/state.md +20 -0
  35. package/sections/opencode/workflow/tasks.md +13 -0
  36. package/sections/shared/frontmatter/adversarial-reviewer.yaml +7 -0
  37. package/sections/shared/frontmatter/architect.yaml +7 -0
  38. package/sections/shared/frontmatter/docs-writer.yaml +7 -0
  39. package/sections/shared/frontmatter/fullstack-dev.yaml +7 -0
  40. package/sections/shared/frontmatter/memory-keeper.yaml +7 -0
  41. package/sections/shared/frontmatter/po.yaml +7 -0
  42. package/sections/shared/frontmatter/qa.yaml +7 -0
  43. package/sections/shared/frontmatter/reviewer.yaml +7 -0
  44. package/sections/shared/frontmatter/teamlead.yaml +8 -0
  45. package/sections/shared/frontmatter/ux-ui.yaml +7 -0
  46. package/sections/shared/memory/conventions.md +10 -0
  47. package/sections/shared/memory/decisions.md +13 -0
  48. package/sections/shared/memory/patterns.md +12 -0
  49. 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"}
@@ -0,0 +1,2 @@
1
+
2
+ export { }