farmwork 1.4.0 → 1.4.5
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 +34 -11
- package/package.json +2 -2
- package/src/doctor.js +4 -1
- package/src/init.js +803 -431
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<img src="/init.png" alt="Farmwork - Developer Methodology" width="500" />
|
|
1
|
+
<img src="/images/init.png" alt="Farmwork - Developer Methodology" width="500" />
|
|
2
2
|
|
|
3
3
|
> A workflow framework for Claude Code by Wynter Jones
|
|
4
4
|
|
|
@@ -76,15 +76,21 @@ npx farmwork init
|
|
|
76
76
|
- **Aging** (15-30 days) - Consider refreshing for major decisions
|
|
77
77
|
- **Stale** (30+ days) - Recommend updating before using for plans
|
|
78
78
|
|
|
79
|
+
**Office Phrases** (Product Strategy & UX):
|
|
80
|
+
| Phrase | Action |
|
|
81
|
+
|--------|--------|
|
|
82
|
+
| `go to production` | UX production check: update `_OFFICE/` docs with audit trail |
|
|
83
|
+
|
|
79
84
|
### Slash Commands
|
|
80
85
|
|
|
81
86
|
| Command | Description |
|
|
82
87
|
|---------|-------------|
|
|
83
88
|
| `/push` | Clean, stage, lint, test, build, commit, push, update metrics (11 steps) |
|
|
89
|
+
| `/office` | Interactive strategy and UX command - updates CORE_LOOP, ONBOARDING, USER_GUIDE |
|
|
84
90
|
|
|
85
91
|
### Agents
|
|
86
92
|
|
|
87
|
-
|
|
93
|
+
15 specialized agents included:
|
|
88
94
|
|
|
89
95
|
| Agent | Purpose |
|
|
90
96
|
|-------|---------|
|
|
@@ -100,6 +106,9 @@ npx farmwork init
|
|
|
100
106
|
| `storybook-maintainer` | Create/update Storybook stories |
|
|
101
107
|
| `idea-gardener` | Manage Idea Garden and Compost |
|
|
102
108
|
| `researcher` | Systematic research before planning |
|
|
109
|
+
| `strategy-agent` | Core loop strategy (what/stopping/why) |
|
|
110
|
+
| `onboarding-agent` | Tours, tooltips, modals, empty states |
|
|
111
|
+
| `user-guide-agent` | Feature documentation for help docs |
|
|
103
112
|
|
|
104
113
|
### Recommended Workflow
|
|
105
114
|
|
|
@@ -119,7 +128,7 @@ You can `go to market` when you have a production-ready app with international u
|
|
|
119
128
|
your-project/
|
|
120
129
|
├── CLAUDE.md # Main instructions & phrase commands
|
|
121
130
|
├── .claude/ # Claude Code configuration
|
|
122
|
-
│ ├── agents/ #
|
|
131
|
+
│ ├── agents/ # 15 specialized subagents
|
|
123
132
|
│ │ ├── the-farmer.md
|
|
124
133
|
│ │ ├── code-reviewer.md
|
|
125
134
|
│ │ ├── security-auditor.md
|
|
@@ -131,9 +140,13 @@ your-project/
|
|
|
131
140
|
│ │ ├── i18n-locale-translator.md
|
|
132
141
|
│ │ ├── storybook-maintainer.md
|
|
133
142
|
│ │ ├── idea-gardener.md
|
|
134
|
-
│ │
|
|
143
|
+
│ │ ├── researcher.md
|
|
144
|
+
│ │ ├── strategy-agent.md # Core loop strategy
|
|
145
|
+
│ │ ├── onboarding-agent.md # UX onboarding
|
|
146
|
+
│ │ └── user-guide-agent.md # Feature documentation
|
|
135
147
|
│ └── commands/ # User-invocable skills
|
|
136
|
-
│
|
|
148
|
+
│ ├── push.md
|
|
149
|
+
│ └── office.md # Interactive strategy command
|
|
137
150
|
├── _AUDIT/ # Living audit documents
|
|
138
151
|
│ ├── FARMHOUSE.md # Framework command center
|
|
139
152
|
│ ├── SECURITY.md # Security posture
|
|
@@ -143,6 +156,10 @@ your-project/
|
|
|
143
156
|
│ ├── TESTS.md # Test coverage
|
|
144
157
|
│ ├── GARDEN.md # Idea nursery (pre-plan stage)
|
|
145
158
|
│ └── COMPOST.md # Rejected ideas archive
|
|
159
|
+
├── _OFFICE/ # Product strategy & UX docs
|
|
160
|
+
│ ├── CORE_LOOP.md # What/Stopping/Why strategy
|
|
161
|
+
│ ├── ONBOARDING.md # Tours, tooltips, modals
|
|
162
|
+
│ └── USER_GUIDE.md # Feature documentation
|
|
146
163
|
├── _PLANS/ # Implementation plans
|
|
147
164
|
│ └── FEATURE_NAME.md
|
|
148
165
|
├── _RESEARCH/ # Research documents (living docs)
|
|
@@ -151,7 +168,7 @@ your-project/
|
|
|
151
168
|
└── justfile # Navigation commands
|
|
152
169
|
```
|
|
153
170
|
|
|
154
|
-
<img src="/logo.png" alt="Farmwork - Developer Methodology" width="300" />
|
|
171
|
+
<img src="/images/logo.png" alt="Farmwork - Developer Methodology" width="300" />
|
|
155
172
|
|
|
156
173
|
## Commands
|
|
157
174
|
|
|
@@ -176,8 +193,8 @@ If you enable Storybook (for React/Vue projects), the wizard will also ask for:
|
|
|
176
193
|
**Creates:**
|
|
177
194
|
- `CLAUDE.md` - Main instructions and phrase commands
|
|
178
195
|
- `.claude/` - Claude Code configuration directory
|
|
179
|
-
- `agents/` -
|
|
180
|
-
- `commands/` -
|
|
196
|
+
- `agents/` - 15 specialized subagents
|
|
197
|
+
- `commands/` - 2 user-invocable skills (/push, /office)
|
|
181
198
|
- `_AUDIT/` - Living audit documents
|
|
182
199
|
- `FARMHOUSE.md` - Framework command center
|
|
183
200
|
- `SECURITY.md` - Security posture tracking
|
|
@@ -187,13 +204,17 @@ If you enable Storybook (for React/Vue projects), the wizard will also ask for:
|
|
|
187
204
|
- `TESTS.md` - Test coverage tracking
|
|
188
205
|
- `GARDEN.md` - Idea nursery (pre-plan stage)
|
|
189
206
|
- `COMPOST.md` - Rejected ideas archive
|
|
207
|
+
- `_OFFICE/` - Product strategy & UX documents
|
|
208
|
+
- `CORE_LOOP.md` - What/Stopping/Why strategy
|
|
209
|
+
- `ONBOARDING.md` - Tours, tooltips, modals
|
|
210
|
+
- `USER_GUIDE.md` - Feature documentation
|
|
190
211
|
- `_PLANS/` - Implementation plans directory
|
|
191
212
|
- `_RESEARCH/` - Research documents directory
|
|
192
213
|
- `justfile` - Navigation and task commands
|
|
193
214
|
|
|
194
215
|
### `farmwork status`
|
|
195
216
|
|
|
196
|
-
<img src="/status.png" alt="Farmwork Status" width="500" />
|
|
217
|
+
<img src="/images/status.png" alt="Farmwork Status" width="500" />
|
|
197
218
|
|
|
198
219
|
Display Farmwork status and metrics.
|
|
199
220
|
|
|
@@ -203,16 +224,17 @@ farmwork status
|
|
|
203
224
|
|
|
204
225
|
**Shows:**
|
|
205
226
|
- Component counts (agents, commands, audits, plans)
|
|
227
|
+
- Office documents status
|
|
206
228
|
- Issue tracking status (if beads is configured)
|
|
207
229
|
- FARMHOUSE score and open items
|
|
208
230
|
- Configuration file status
|
|
209
231
|
- Project metrics (tests, stories)
|
|
210
232
|
|
|
211
|
-
<img src="/status2.png" alt="Farmwork Status Details" width="500" />
|
|
233
|
+
<img src="/images/status2.png" alt="Farmwork Status Details" width="500" />
|
|
212
234
|
|
|
213
235
|
### `farmwork doctor`
|
|
214
236
|
|
|
215
|
-
<img src="/doctor.png" alt="Farmwork Doctor" width="500" />
|
|
237
|
+
<img src="/images/doctor.png" alt="Farmwork Doctor" width="500" />
|
|
216
238
|
|
|
217
239
|
Check your Farmwork setup and diagnose issues.
|
|
218
240
|
|
|
@@ -225,6 +247,7 @@ farmwork doctor
|
|
|
225
247
|
- Agents and commands configuration
|
|
226
248
|
- Audit system (_AUDIT/, FARMHOUSE.md, _PLANS/)
|
|
227
249
|
- Research system (_RESEARCH/)
|
|
250
|
+
- Office system (_OFFICE/, CORE_LOOP.md, ONBOARDING.md, USER_GUIDE.md)
|
|
228
251
|
- Navigation (justfile, just command)
|
|
229
252
|
- Issue tracking (beads)
|
|
230
253
|
- Security (.gitignore settings)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "farmwork",
|
|
3
|
-
"version": "1.4.
|
|
3
|
+
"version": "1.4.5",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Farmwork - A workflow framework for Claude Code by Wynter Jones",
|
|
6
6
|
"main": "src/index.js",
|
|
@@ -42,5 +42,5 @@
|
|
|
42
42
|
"type": "git",
|
|
43
43
|
"url": "https://github.com/wynterjones/farmwork"
|
|
44
44
|
},
|
|
45
|
-
"homepage": "https://farmwork.
|
|
45
|
+
"homepage": "https://farmwork.dev"
|
|
46
46
|
}
|
package/src/doctor.js
CHANGED
|
@@ -175,7 +175,10 @@ export async function doctor() {
|
|
|
175
175
|
checkExists(path.join(cwd, "_OFFICE"), "_OFFICE/ directory exists"),
|
|
176
176
|
);
|
|
177
177
|
checks[4].items.push(
|
|
178
|
-
checkExists(path.join(cwd, "_OFFICE", "
|
|
178
|
+
checkExists(path.join(cwd, "_OFFICE", "GREENFIELD.md"), "GREENFIELD.md exists"),
|
|
179
|
+
);
|
|
180
|
+
checks[4].items.push(
|
|
181
|
+
checkExists(path.join(cwd, "_OFFICE", "BROWNFIELD.md"), "BROWNFIELD.md exists"),
|
|
179
182
|
);
|
|
180
183
|
checks[4].items.push(
|
|
181
184
|
checkExists(path.join(cwd, "_OFFICE", "ONBOARDING.md"), "ONBOARDING.md exists"),
|