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 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
- └── definition-of-done.md
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
- - **Agent definitions** -- PM, developer, and tester agents configured to follow your methodology from day one
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** -- three agents configured to work in parallel with file ownership boundaries
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
- - **Three pre-configured agents** (Sprint) or **per-epic agents** (Swarm) -- all with file ownership boundaries
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-tester
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,CA4CR;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"}
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"}
@@ -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
  ];
@@ -1 +1 @@
1
- {"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/cli/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,GAChB,MAAM,aAAa,CAAC;AAoBrB;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,YAA0B;IAE1B,MAAM,aAAa,GAAG;QACpB,WAAW;QACX,EAAE;QACF,+DAA+D;QAC/D,EAAE;QACF,kBAAkB;QAClB,WAAW;QACX,sEAAsE;QACtE,gFAAgF;QAChF,mEAAmE;QACnE,EAAE;QACF,yGAAyG;KAC1G,CAAC;IAEF,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,YAAY,GAAG;QACnB,GAAG,aAAa;QAChB,EAAE;QACF,uBAAuB;QACvB,EAAE;QACF,0FAA0F;QAC1F,EAAE;QACF,qBAAqB;QACrB,sLAAsL;QACtL,kIAAkI;QAClI,EAAE;QACF,kBAAkB;QAClB,WAAW;QACX,wEAAwE;QACxE,+FAA+F;QAC/F,uDAAuD;QACvD,EAAE;QACF,kDAAkD;QAClD,EAAE;QACF,kDAAkD;QAClD,EAAE;QACF,8EAA8E;KAC/E,CAAC;IAEF,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAmB,EACnB,SAA8B;IAE9B,MAAM,qBAAqB,GAAG,0BAA0B,CACtD,KAAK,CAAC,YAAY,IAAI,QAAQ,CAC/B,CAAC;IAEF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,YAAY,EAAE,KAAK,CAAC,WAAW;YAC/B,cAAc,EAAE,SAAS,CAAC,aAAa;YACvC,UAAU,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC;YACnE,YAAY,EAAE,KAAK,CAAC,WAAW;YAC/B,iBAAiB,EAAE,SAAS,CAAC,gBAAgB;YAC7C,gBAAgB,EAAE,SAAS,CAAC,eAAe;YAC3C,iBAAiB,EAAE,SAAS,CAAC,gBAAgB;YAC7C,YAAY,EAAE,SAAS,CAAC,UAAU;YAClC,gBAAgB,EAAE,KAAK,CAAC,eAAe;YACvC,kBAAkB,EAAE,SAAS,CAAC,gBAAgB;YAC9C,aAAa,EAAE,SAAS,CAAC,KAAK;YAC9B,aAAa,EAAE,SAAS,CAAC,YAAY;YACrC,uBAAuB,EAAE,qBAAqB;SAC/C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,WAAW;QAC/B,cAAc,EAAE,KAAK,CAAC,WAAW;QACjC,UAAU,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC;QACnE,YAAY,EAAE,KAAK,CAAC,WAAW;QAC/B,iBAAiB,EAAE,KAAK,CAAC,gBAAgB;QACzC,gBAAgB,EAAE,KAAK,CAAC,eAAe;QACvC,iBAAiB,EAAE,KAAK,CAAC,gBAAgB;QACzC,YAAY,EAAE,KAAK,CAAC,UAAU;QAC9B,gBAAgB,EAAE,KAAK,CAAC,eAAe;QACvC,kBAAkB,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC;QAC3E,aAAa,EAAE,eAAe,CAC5B,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,WAAW,CAClB;QACD,aAAa,EAAE,EAAE;QACjB,uBAAuB,EAAE,qBAAqB;KAC/C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,MAAgB;IAC7D,OAAO,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,SAAiB,EAAE,EAAE;QACxE,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,gBAAgB,GAA2B;IAC/C,SAAS,EAAE,YAAY;CACxB,CAAC;AAEF;;;GAGG;AACH,SAAS,oBAAoB,CAAC,YAAoB;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACpC,IAAI,IAAI,IAAI,gBAAgB,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,YAAY,CAAC,OAAe;IACzC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,UAAU,IAAI,CAAC,GAAW;QAC7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,6DAA6D;IAC7D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,gBAAgB,GAAG;IACvB,WAAW;IACX,gCAAgC;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,wBAAwB,GAAG,8BAA8B,CAAC;AAEhE;;GAEG;AACH,SAAS,eAAe,CAAC,YAAoB;IAC3C,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,YAAoB;IAC/C,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,UAAU,KAAK,wBAAwB,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAoB,EACpB,MAAgB,EAChB,eAA6B,QAAQ;IAErC,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,YAAY,IAAI,SAAS,EAAE,CAAC;QACrC,IAAI,mBAAmB,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QAED,IAAI,YAAY,KAAK,QAAQ,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/D,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,eAAe,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEvD,QAAQ,CAAC,IAAI,CAAC;YACZ,YAAY,EAAE,oBAAoB,CAAC,YAAY,CAAC;YAChD,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
1
+ {"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/cli/renderer.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "meto-cli",
3
- "version": "0.9.3",
3
+ "version": "0.10.0",
4
4
  "description": "Scaffold structured software projects with built-in methodology",
5
5
  "type": "module",
6
6
  "bin": {
@@ -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 3 files open before acting — note key info in memory
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. Start a new session for the next epic fresh context = better results."**
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 3 files open before acting — note key info in memory
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! Consider starting a new session for the next epic fresh context keeps agents sharp.
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 3 files open before acting — note key info in memory
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
@@ -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` early** — don't wait for context to degrade, compress proactively
30
- - **New session signs:** sluggish responses, repeated file reads, agent forgetting prior work
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 3-5 slices or when context feels sluggish
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 3 files open before acting
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
- - 3-5 slices completed since last fresh session
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