meto-cli 0.9.3 → 0.10.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 +40 -7
- package/dist/cli/renderer.d.ts.map +1 -1
- package/dist/cli/renderer.js +1 -0
- package/dist/cli/renderer.js.map +1 -1
- package/package.json +1 -1
- package/templates/.claude/agent-memory/meto-community/MEMORY.md +23 -0
- package/templates/.claude/agents/community-manager-agent.md +72 -0
- package/templates/.claude/agents/developer-agent.md +2 -2
- package/templates/.claude/agents/pm-agent.md +2 -2
- package/templates/.claude/agents/tester-agent.md +1 -1
- package/templates/CLAUDE.md +7 -6
- package/templates/ai/workflows/session-checkpoint.md +1 -2
package/README.md
CHANGED
|
@@ -65,10 +65,12 @@ Each preset populates your tech-stack description, definition of done (with stac
|
|
|
65
65
|
your-project/
|
|
66
66
|
├── .claude/
|
|
67
67
|
│ ├── agents/
|
|
68
|
+
│ │ ├── community-manager-agent.md
|
|
68
69
|
│ │ ├── developer-agent.md
|
|
69
70
|
│ │ ├── pm-agent.md
|
|
70
71
|
│ │ └── tester-agent.md
|
|
71
72
|
│ ├── agent-memory/
|
|
73
|
+
│ │ ├── meto-community/MEMORY.md
|
|
72
74
|
│ │ ├── meto-developer/MEMORY.md
|
|
73
75
|
│ │ ├── meto-pm/MEMORY.md
|
|
74
76
|
│ │ └── meto-tester/MEMORY.md
|
|
@@ -89,7 +91,8 @@ your-project/
|
|
|
89
91
|
│ │ └── tasks-todo.md
|
|
90
92
|
│ └── workflows/
|
|
91
93
|
│ ├── commit-conventions.md
|
|
92
|
-
│
|
|
94
|
+
│ ├── definition-of-done.md
|
|
95
|
+
│ └── session-checkpoint.md
|
|
93
96
|
├── src/
|
|
94
97
|
├── .gitignore
|
|
95
98
|
└── CLAUDE.md
|
|
@@ -116,15 +119,32 @@ your-project/
|
|
|
116
119
|
**What's inside:**
|
|
117
120
|
- **CLAUDE.md** -- project instructions that Claude Code reads every session, pre-filled with your vision, stack, and conventions
|
|
118
121
|
- **Kanban board** -- task pipeline (backlog, todo, in-progress, testing, done) ready for your first sprint
|
|
119
|
-
- **
|
|
122
|
+
- **4 agent definitions** -- PM, developer, tester, and community manager agents configured to follow your methodology from day one
|
|
120
123
|
- **Agent memory** -- persistent memory files so agents retain context across sessions
|
|
121
124
|
- **Product context** -- vision, tech stack, and decisions captured in structured files
|
|
122
|
-
- **Epics and workflows** -- definition of done, commit conventions, and an epic backlog to plan against
|
|
123
|
-
- **Agent Teams ready** --
|
|
125
|
+
- **Epics and workflows** -- definition of done, commit conventions, session checkpoints, and an epic backlog to plan against
|
|
126
|
+
- **Agent Teams ready** -- four agents configured to work in parallel with file ownership boundaries
|
|
124
127
|
- **Swarm mode** -- parallel epic agents with domain ownership, checkpoint rhythm, and a live status dashboard
|
|
125
128
|
|
|
126
129
|
---
|
|
127
130
|
|
|
131
|
+
## Agents
|
|
132
|
+
|
|
133
|
+
Every scaffolded project comes with 4 pre-configured agents:
|
|
134
|
+
|
|
135
|
+
| Agent | Role | Can write code? |
|
|
136
|
+
|---|---|---|
|
|
137
|
+
| `@meto-pm` | Planning, backlog management, epic definition, task slicing | No |
|
|
138
|
+
| `@meto-developer` | Code implementation -- picks tasks from todo, builds, tests | Yes |
|
|
139
|
+
| `@meto-tester` | Validates completed work against acceptance criteria | No |
|
|
140
|
+
| `@meto-community` | Community engagement, user communication, market awareness | No |
|
|
141
|
+
|
|
142
|
+
The **community manager** understands the product and its market. It reads product context files, drafts Reddit posts, changelog summaries, and feature announcements, and surfaces user feedback themes back to `@meto-pm`. It never writes code or edits source files -- read-only access to the codebase.
|
|
143
|
+
|
|
144
|
+
In **swarm mode**, additional `@meto-epic-[id]` agents are generated -- one per epic, each scoped to its own file domain.
|
|
145
|
+
|
|
146
|
+
---
|
|
147
|
+
|
|
128
148
|
## Workflow Modes
|
|
129
149
|
|
|
130
150
|
### Sprint (default)
|
|
@@ -152,18 +172,31 @@ Best for projects with multiple independent epics where parallelism speeds thing
|
|
|
152
172
|
|
|
153
173
|
---
|
|
154
174
|
|
|
175
|
+
## Context & Sessions
|
|
176
|
+
|
|
177
|
+
Meto is optimized for Claude Code's **1M token context window**. With 5x more room than before:
|
|
178
|
+
|
|
179
|
+
- **10-15 slices per session** before needing a fresh start
|
|
180
|
+
- **Agents can hold more files** in context without degrading
|
|
181
|
+
- **Less frequent `/compact`** -- use it when responses slow down, not proactively
|
|
182
|
+
- **Memory files still matter** -- they persist across sessions, not just within them
|
|
183
|
+
|
|
184
|
+
Each agent has a memory file in `.claude/agent-memory/` that it reads at session start and updates at session end. Session checkpoints (`ai/workflows/session-checkpoint.md`) help hand off between sessions when needed.
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
155
188
|
## Agent Teams
|
|
156
189
|
|
|
157
190
|
Agent Teams is a Claude Code feature where multiple AI agents work in parallel on the same codebase, each with a specialized role.
|
|
158
191
|
|
|
159
192
|
Meto scaffolds projects ready for Agent Teams out of the box:
|
|
160
193
|
|
|
161
|
-
- **
|
|
194
|
+
- **Four pre-configured agents** (Sprint) or **per-epic agents** (Swarm) -- all with file ownership boundaries
|
|
162
195
|
- **Feature enabled automatically** -- `.claude/settings.json` sets the experimental flag so Agent Teams works immediately
|
|
163
196
|
|
|
164
197
|
**To activate:** start `claude` in your project, then say:
|
|
165
198
|
|
|
166
|
-
> Sprint: "Create an agent team with @meto-pm for planning, @meto-developer for building, @meto-tester for validation"
|
|
199
|
+
> Sprint: "Create an agent team with @meto-pm for planning, @meto-developer for building, @meto-tester for validation, and @meto-community for community engagement"
|
|
167
200
|
|
|
168
201
|
> Swarm: "Launch @meto-epic-E1 to work on Epic 1"
|
|
169
202
|
|
|
@@ -174,7 +207,7 @@ Meto scaffolds projects ready for Agent Teams out of the box:
|
|
|
174
207
|
1. `cd your-project`
|
|
175
208
|
2. Open the project in your editor
|
|
176
209
|
3. Start a Claude Code session and call `@meto-pm` to populate your backlog
|
|
177
|
-
4. **Sprint:** spawn an agent team with @meto-pm, @meto-developer, and @meto-
|
|
210
|
+
4. **Sprint:** spawn an agent team with @meto-pm, @meto-developer, @meto-tester, and @meto-community
|
|
178
211
|
5. **Swarm:** launch epic agents in parallel, run `npx meto-cli status` to monitor
|
|
179
212
|
6. Pick your first task and start building
|
|
180
213
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/cli/renderer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,YAAY,GACzB,MAAM,
|
|
1
|
+
{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/cli/renderer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,YAAY,GACzB,MAAM,CA6CR;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,SAAS,CAAC,EAAE,kBAAkB,GAC7B,QAAQ,CA0CV;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,CAOvE;AAqDD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAK5C;AAiCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,QAAQ,EAChB,YAAY,GAAE,YAAuB,GACpC,OAAO,CAAC,YAAY,EAAE,CAAC,CAwBzB"}
|
package/dist/cli/renderer.js
CHANGED
|
@@ -17,6 +17,7 @@ export function buildWorkflowAgentsSection(workflowMode) {
|
|
|
17
17
|
"| `@meto-pm` | `/ai/backlog/`, `tasks-backlog.md`, `tasks-todo.md` |",
|
|
18
18
|
"| `@meto-developer` | `/src/`, `tasks-in-progress.md`, `tasks-in-testing.md` |",
|
|
19
19
|
"| `@meto-tester` | `tasks-in-testing.md` → done or back to todo |",
|
|
20
|
+
"| `@meto-community` | Community engagement, user communication, market awareness |",
|
|
20
21
|
"",
|
|
21
22
|
"Each agent has a memory file in `.claude/agent-memory/` — read at session start, update at session end.",
|
|
22
23
|
];
|
package/dist/cli/renderer.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/cli/renderer.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/cli/renderer.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Community Manager Memory — {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
*Read at session start. Update at session end.*
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Product Understanding
|
|
8
|
+
<!-- Key features, value props, and differentiators to highlight -->
|
|
9
|
+
|
|
10
|
+
## Community Channels
|
|
11
|
+
<!-- Where users hang out — Reddit, Discord, Twitter, etc. -->
|
|
12
|
+
|
|
13
|
+
## Content That Works
|
|
14
|
+
<!-- Post types, tones, and topics that resonated -->
|
|
15
|
+
|
|
16
|
+
## User Feedback Themes
|
|
17
|
+
<!-- Recurring requests, pain points, praise patterns -->
|
|
18
|
+
|
|
19
|
+
## Watch Out
|
|
20
|
+
<!-- Topics to avoid, past missteps, sensitive areas -->
|
|
21
|
+
|
|
22
|
+
## Session Log
|
|
23
|
+
<!-- Reverse-chronological: date, what was done, content drafted, feedback surfaced -->
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: meto-community
|
|
3
|
+
description: Community management, user communication, and market awareness. Understands the product and its users. Drafts posts, replies, and engagement strategies for Reddit, social media, and community channels.
|
|
4
|
+
tools: Read, Glob, Grep, WebSearch, WebFetch
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Community Manager Agent
|
|
8
|
+
|
|
9
|
+
## Session Start
|
|
10
|
+
1. Read `CLAUDE.md`
|
|
11
|
+
2. Read `.claude/agent-memory/meto-community/MEMORY.md`
|
|
12
|
+
3. Read `/ai/context/product-vision.md` — understand what the product does and who it serves
|
|
13
|
+
4. Read `/ai/context/tech-stack.md` — know the stack so community answers are accurate
|
|
14
|
+
5. Proceed with requested action
|
|
15
|
+
|
|
16
|
+
## Session End
|
|
17
|
+
Update `.claude/agent-memory/meto-community/MEMORY.md` with anything worth remembering — user feedback themes, content that resonated, community sentiment.
|
|
18
|
+
|
|
19
|
+
## What I Own
|
|
20
|
+
- `/ai/community/` — content drafts, engagement plans, community notes
|
|
21
|
+
- Community-facing content: Reddit posts, changelog summaries, feature announcements
|
|
22
|
+
|
|
23
|
+
## Core Responsibilities
|
|
24
|
+
|
|
25
|
+
### Product Understanding
|
|
26
|
+
- Know the product vision, features, and roadmap deeply
|
|
27
|
+
- Translate technical capabilities into user-facing language
|
|
28
|
+
- Identify which features solve which user pain points
|
|
29
|
+
|
|
30
|
+
### Market Awareness
|
|
31
|
+
- Track competitor positioning and community sentiment
|
|
32
|
+
- Identify trending topics relevant to the product
|
|
33
|
+
- Spot opportunities for organic engagement
|
|
34
|
+
|
|
35
|
+
### User Communication
|
|
36
|
+
- Draft Reddit posts, comments, and replies
|
|
37
|
+
- Write changelog summaries and feature announcements
|
|
38
|
+
- Respond to user questions with accurate, helpful answers
|
|
39
|
+
- Maintain a consistent, authentic voice — helpful, not salesy
|
|
40
|
+
|
|
41
|
+
### Feedback Loop
|
|
42
|
+
- Surface recurring user requests and pain points to `@meto-pm`
|
|
43
|
+
- Summarize community sentiment after launches
|
|
44
|
+
- Flag negative trends or misconceptions early
|
|
45
|
+
|
|
46
|
+
## Content Guidelines
|
|
47
|
+
- **Authentic voice:** Speak as a practitioner, not a marketer. Share genuine insights.
|
|
48
|
+
- **Value first:** Every post should teach, help, or inform — never just promote.
|
|
49
|
+
- **Accurate:** Never overstate capabilities. If unsure, check the codebase.
|
|
50
|
+
- **Context-aware:** Match the tone of the platform (Reddit is casual, docs are precise).
|
|
51
|
+
- **Concise:** Respect people's time. Lead with the point.
|
|
52
|
+
|
|
53
|
+
## NEVER DO
|
|
54
|
+
- Write or edit any code in `/src/` or `/templates/`
|
|
55
|
+
- Move tasks on the board
|
|
56
|
+
- Make product or technical architecture decisions
|
|
57
|
+
- Post anything without user approval — always draft first
|
|
58
|
+
- Misrepresent product capabilities
|
|
59
|
+
- Engage in arguments or flame wars
|
|
60
|
+
- Spam communities with promotional content
|
|
61
|
+
|
|
62
|
+
## Parallel Operation
|
|
63
|
+
When running as a teammate: you read CLAUDE.md and this file fresh — you do NOT have the lead's conversation history.
|
|
64
|
+
Only write files listed under "What I Own".
|
|
65
|
+
If you identify feature requests or bugs from community feedback, message `@meto-pm` directly.
|
|
66
|
+
Never write to `/src/`, `/ai/backlog/`, or board files.
|
|
67
|
+
|
|
68
|
+
## Context Budget
|
|
69
|
+
- Grep before reading — only open files you need
|
|
70
|
+
- Use targeted line ranges for long files
|
|
71
|
+
- Max 10 files open before acting — note key info in memory
|
|
72
|
+
- Read product-vision.md once, then work from memory
|
|
@@ -37,7 +37,7 @@ Never write to `/ai/backlog/`, `/ai/context/`, `tasks-backlog.md`, `tasks-todo.m
|
|
|
37
37
|
## Context Budget
|
|
38
38
|
- Grep before reading — only open files you need
|
|
39
39
|
- Use targeted line ranges for long files
|
|
40
|
-
- Max
|
|
40
|
+
- Max 10 files open before acting — note key info in memory
|
|
41
41
|
- Check Codebase Map in your memory file before reading files — it may already have what you need
|
|
42
42
|
|
|
43
43
|
## Task Pickup Protocol
|
|
@@ -80,4 +80,4 @@ When creating `package.json` for the first time, include `buildrack` in devDepen
|
|
|
80
80
|
When the last slice of an epic moves to done:
|
|
81
81
|
1. Commit and push all work
|
|
82
82
|
2. Update your memory file with patterns learned
|
|
83
|
-
3. Tell the user: **"Epic complete.
|
|
83
|
+
3. Tell the user: **"Epic complete. Consider starting a fresh session for the next epic if context is heavy."**
|
|
@@ -47,7 +47,7 @@ Never write to `/src/`, `tasks-in-progress.md`, `tasks-in-testing.md`, or `tasks
|
|
|
47
47
|
## Context Budget
|
|
48
48
|
- Grep before reading — only open files you need
|
|
49
49
|
- Use targeted line ranges for long files
|
|
50
|
-
- Max
|
|
50
|
+
- Max 10 files open before acting — note key info in memory
|
|
51
51
|
- Read each epic once, then work from memory — don't re-read `/ai/backlog/epics.md` every task
|
|
52
52
|
|
|
53
53
|
## Task Definition Format
|
|
@@ -85,4 +85,4 @@ Sprint [N] is ready. [X] tasks in tasks-todo.md.
|
|
|
85
85
|
|
|
86
86
|
When all slices of an epic are in `tasks-done.md`, tell the user:
|
|
87
87
|
|
|
88
|
-
Epic [N] complete!
|
|
88
|
+
Epic [N] complete! You can continue to the next epic or start a fresh session if context feels heavy.
|
|
@@ -38,7 +38,7 @@ Process items sequentially even when other agents run in parallel.
|
|
|
38
38
|
## Context Budget
|
|
39
39
|
- Grep before reading — only open files you need
|
|
40
40
|
- Use targeted line ranges for long files
|
|
41
|
-
- Max
|
|
41
|
+
- Max 10 files open before acting — note key info in memory
|
|
42
42
|
- Only read files listed in "Files changed" on the task block — don't explore the whole codebase
|
|
43
43
|
|
|
44
44
|
## Validation Protocol
|
package/templates/CLAUDE.md
CHANGED
|
@@ -24,10 +24,10 @@ cd your-project && claude # start a session
|
|
|
24
24
|
Esc Esc → /rewind # undo if something went wrong
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
- **One session per epic/feature** — start fresh when you finish an epic
|
|
27
|
+
- **One session per epic/feature** — start fresh when you finish an epic or context feels heavy
|
|
28
28
|
- **Commit frequently** — don't let work pile up uncommitted
|
|
29
|
-
- **`/compact`
|
|
30
|
-
- **New session signs:**
|
|
29
|
+
- **`/compact` when needed** — context is large (1M tokens), but compress if responses slow down
|
|
30
|
+
- **New session signs:** agent forgetting prior work, repeated file reads, sluggish responses
|
|
31
31
|
|
|
32
32
|
## Quick Reference
|
|
33
33
|
|
|
@@ -60,7 +60,7 @@ See `/ai/workflows/definition-of-done.md` for done criteria.
|
|
|
60
60
|
|
|
61
61
|
## Agent Teams
|
|
62
62
|
|
|
63
|
-
This project supports Agent Teams. The lead agent can spawn teammates using `@meto-pm`, `@meto-developer`, `@meto-tester`.
|
|
63
|
+
This project supports Agent Teams. The lead agent can spawn teammates using `@meto-pm`, `@meto-developer`, `@meto-tester`, `@meto-community`.
|
|
64
64
|
|
|
65
65
|
**Coordination model:** Agent Teams has its own task system, but this project uses the kanban board (`tasks-backlog` through `tasks-done`) as the single source of truth for task state. Teammates must read and update the board files, not rely on Agent Teams' internal task tracking.
|
|
66
66
|
|
|
@@ -71,6 +71,7 @@ This project supports Agent Teams. The lead agent can spawn teammates using `@me
|
|
|
71
71
|
| `@meto-pm` | `/ai/` files, `tasks-backlog.md`, `tasks-todo.md` |
|
|
72
72
|
| `@meto-developer` | `/src/`, config files, `tasks-in-progress.md`, `tasks-in-testing.md` |
|
|
73
73
|
| `@meto-tester` | `tasks-in-testing.md`, `tasks-done.md`, `tasks-todo.md` (failed items) |
|
|
74
|
+
| `@meto-community` | Read-only — reads product files, drafts community content in `/ai/community/` |
|
|
74
75
|
|
|
75
76
|
Each agent writes only its own memory file in `.claude/agent-memory/` -- never another agent's.
|
|
76
77
|
|
|
@@ -80,10 +81,10 @@ Teammates do NOT inherit the lead's conversation history. Each teammate reads CL
|
|
|
80
81
|
|
|
81
82
|
## Context Management
|
|
82
83
|
|
|
83
|
-
- **Session cadence:** Start a new session every
|
|
84
|
+
- **Session cadence:** Start a new session every 10-15 slices or when context feels sluggish
|
|
84
85
|
- **Session start:** Read CLAUDE.md, your agent memory file, and the board — then act
|
|
85
86
|
- **Session end:** Update your memory file with decisions, patterns, and what to pick up next
|
|
86
|
-
- **Context budget:** Grep before reading full files; read targeted line ranges; max
|
|
87
|
+
- **Context budget:** Grep before reading full files; read targeted line ranges; max 10 files open before acting
|
|
87
88
|
- **Red flag:** If you re-read a file you already read this session, note key info in memory instead
|
|
88
89
|
|
|
89
90
|
---
|
|
@@ -43,7 +43,6 @@ Write this at session end. Paste it into the next session's first message.
|
|
|
43
43
|
## When to Force a New Session
|
|
44
44
|
|
|
45
45
|
- Context feels sluggish (repeating yourself, forgetting earlier decisions)
|
|
46
|
-
-
|
|
47
|
-
- Switching between agents (PM → Developer → Tester)
|
|
46
|
+
- 10-15 slices completed since last fresh session
|
|
48
47
|
- After a major refactor or architecture change
|
|
49
48
|
- When the checkpoint itself exceeds 30 lines
|