farmwork 1.1.0 → 1.4.1

package/README.md

@@ -1,4 +1,4 @@
-<img src="/init.png" alt="Farmwork - Developer Methodology" width="500" />
+<img src="/images/init.png" alt="Farmwork - Developer Methodology" width="500" />
 
 > A workflow framework for Claude Code by Wynter Jones
 
@@ -33,7 +33,7 @@ npx farmwork init
 4. **Autonomously Issue Tracking** - Using beads (`bd`) for full visibility
 5. **Living Audits** - Documents that track ongoing concerns
 6. **Plan & Implement** - You describe the outcome, the rest is handled, tracked and audited
-7. **Idea Garden & Compost** - Pre-plan creative stage for nurturing ideas or archiving rejected ones
+7. **Idea Garden & Compost** - Pre-plan creative stage with natural aging (ideas older than 60 days auto-compost)
 
 ### Phrase Commands
 
@@ -54,19 +54,43 @@ npx farmwork init
 **Idea Phrases** (Pre-Plan Stage):
 | Phrase | Action |
 |--------|--------|
-| `I have an idea for...` | Add new idea to `_AUDIT/GARDEN.md` |
+| `I have an idea for...` | Add new idea to `_AUDIT/GARDEN.md` with planted date |
 | `let's plan this idea...` | Graduate idea from GARDEN → create plan |
 | `compost this...` | Move rejected idea to `_AUDIT/COMPOST.md` |
+| `water the garden` | Generate 10 new ideas based on GARDEN and COMPOST |
+
+**Idea Lifecycle:**
+- **Fresh** (0-44 days) - New ideas ready to develop
+- **Wilting** (45-60 days) - Ideas aging, marked ⚠️ during audits
+- **Composted** (60+ days) - Auto-moved to COMPOST during "open the farm"
+
+**Research Phrases** (Pre-Plan Stage):
+| Phrase | Action |
+|--------|--------|
+| `let's research...` | Create or update research document in `_RESEARCH/` |
+| `update research on...` | Refresh existing research with new findings |
+| `show research on...` | Display research summary and staleness status |
+
+**Research Lifecycle:**
+- **Fresh** (0-14 days) - Research is current and reliable
+- **Aging** (15-30 days) - Consider refreshing for major decisions
+- **Stale** (30+ days) - Recommend updating before using for plans
+
+**Office Phrases** (Product Strategy & UX):
+| Phrase | Action |
+|--------|--------|
+| `go to production` | UX production check: update `_OFFICE/` docs with audit trail |
 
 ### Slash Commands
 
 | Command | Description |
 |---------|-------------|
 | `/push` | Clean, stage, lint, test, build, commit, push, update metrics (11 steps) |
+| `/office` | Interactive strategy and UX command - updates CORE_LOOP, ONBOARDING, USER_GUIDE |
 
 ### Agents
 
-11 specialized agents included:
+15 specialized agents included:
 
 | Agent | Purpose |
 |-------|---------|
@@ -81,14 +105,20 @@ npx farmwork init
 | `i18n-locale-translator` | Translate UI text to locales |
 | `storybook-maintainer` | Create/update Storybook stories |
 | `idea-gardener` | Manage Idea Garden and Compost |
+| `researcher` | Systematic research before planning |
+| `strategy-agent` | Core loop strategy (what/stopping/why) |
+| `onboarding-agent` | Tours, tooltips, modals, empty states |
+| `user-guide-agent` | Feature documentation for help docs |
 
 ### Recommended Workflow
 
 1. **Start Session**: Run `open the farm` to audit current state
-2. **Plan Work**: Use `make a plan for...` for new features
-3. **Implement**: Use `let's implement...` to execute with tracking
-4. **Quality Check**: Run `count the herd` for full audit + dry run
-5. **Ship**: Run `close the farm` or `/push` to push changes
+2. **Capture Ideas**: Use `I have an idea for...` to plant ideas in GARDEN
+3. **Research**: Use `let's research...` to gather information before planning
+4. **Plan Work**: Use `make a plan for...` for new features
+5. **Implement**: Use `let's implement...` to execute with tracking
+6. **Quality Check**: Run `count the herd` for full audit + dry run
+7. **Ship**: Run `close the farm` or `/push` to push changes
 
 You can `go to market` when you have a production-ready app with international users.
 
@@ -98,7 +128,7 @@ You can `go to market` when you have a production-ready app with international u
 your-project/
 ├── CLAUDE.md           # Main instructions & phrase commands
 ├── .claude/            # Claude Code configuration
-│   ├── agents/         # 11 specialized subagents
+│   ├── agents/         # 15 specialized subagents
 │   │   ├── the-farmer.md
 │   │   ├── code-reviewer.md
 │   │   ├── security-auditor.md
@@ -109,9 +139,14 @@ your-project/
 │   │   ├── code-cleaner.md
 │   │   ├── i18n-locale-translator.md
 │   │   ├── storybook-maintainer.md
-│   │   └── idea-gardener.md
+│   │   ├── idea-gardener.md
+│   │   ├── researcher.md
+│   │   ├── strategy-agent.md      # Core loop strategy
+│   │   ├── onboarding-agent.md    # UX onboarding
+│   │   └── user-guide-agent.md    # Feature documentation
 │   └── commands/       # User-invocable skills
-│       └── push.md
+│       ├── push.md
+│       └── office.md   # Interactive strategy command
 ├── _AUDIT/             # Living audit documents
 │   ├── FARMHOUSE.md    # Framework command center
 │   ├── SECURITY.md     # Security posture
@@ -121,13 +156,19 @@ your-project/
 │   ├── TESTS.md        # Test coverage
 │   ├── GARDEN.md       # Idea nursery (pre-plan stage)
 │   └── COMPOST.md      # Rejected ideas archive
+├── _OFFICE/            # Product strategy & UX docs
+│   ├── CORE_LOOP.md    # What/Stopping/Why strategy
+│   ├── ONBOARDING.md   # Tours, tooltips, modals
+│   └── USER_GUIDE.md   # Feature documentation
 ├── _PLANS/             # Implementation plans
 │   └── FEATURE_NAME.md
+├── _RESEARCH/          # Research documents (living docs)
+│   └── TOPIC_NAME.md
 ├── .beads/             # Issue tracking
 └── justfile            # Navigation commands
 ```
 
-<img src="/logo.png" alt="Farmwork - Developer Methodology" width="300" />
+<img src="/images/logo.png" alt="Farmwork - Developer Methodology" width="300" />
 
 ## Commands
 
@@ -152,8 +193,8 @@ If you enable Storybook (for React/Vue projects), the wizard will also ask for:
 **Creates:**
 - `CLAUDE.md` - Main instructions and phrase commands
 - `.claude/` - Claude Code configuration directory
-  - `agents/` - 11 specialized subagents
-  - `commands/` - 1 user-invocable skill (/push)
+  - `agents/` - 15 specialized subagents
+  - `commands/` - 2 user-invocable skills (/push, /office)
 - `_AUDIT/` - Living audit documents
   - `FARMHOUSE.md` - Framework command center
   - `SECURITY.md` - Security posture tracking
@@ -163,12 +204,17 @@ If you enable Storybook (for React/Vue projects), the wizard will also ask for:
   - `TESTS.md` - Test coverage tracking
   - `GARDEN.md` - Idea nursery (pre-plan stage)
   - `COMPOST.md` - Rejected ideas archive
+- `_OFFICE/` - Product strategy & UX documents
+  - `CORE_LOOP.md` - What/Stopping/Why strategy
+  - `ONBOARDING.md` - Tours, tooltips, modals
+  - `USER_GUIDE.md` - Feature documentation
 - `_PLANS/` - Implementation plans directory
+- `_RESEARCH/` - Research documents directory
 - `justfile` - Navigation and task commands
 
 ### `farmwork status`
 
-<img src="/status.png" alt="Farmwork Status" width="500" />
+<img src="/images/status.png" alt="Farmwork Status" width="500" />
 
 Display Farmwork status and metrics.
 
@@ -178,16 +224,17 @@ farmwork status
 
 **Shows:**
 - Component counts (agents, commands, audits, plans)
+- Office documents status
 - Issue tracking status (if beads is configured)
 - FARMHOUSE score and open items
 - Configuration file status
 - Project metrics (tests, stories)
 
-<img src="/status2.png" alt="Farmwork Status Details" width="500" />
+<img src="/images/status2.png" alt="Farmwork Status Details" width="500" />
 
 ### `farmwork doctor`
 
-<img src="/doctor.png" alt="Farmwork Doctor" width="500" />
+<img src="/images/doctor.png" alt="Farmwork Doctor" width="500" />
 
 Check your Farmwork setup and diagnose issues.
 
@@ -199,6 +246,8 @@ farmwork doctor
 - Core files (CLAUDE.md, .claude/, settings)
 - Agents and commands configuration
 - Audit system (_AUDIT/, FARMHOUSE.md, _PLANS/)
+- Research system (_RESEARCH/)
+- Office system (_OFFICE/, CORE_LOOP.md, ONBOARDING.md, USER_GUIDE.md)
 - Navigation (justfile, just command)
 - Issue tracking (beads)
 - Security (.gitignore settings)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "farmwork",
-  "version": "1.1.0",
+  "version": "1.4.1",
   "type": "module",
   "description": "Farmwork - A workflow framework for Claude Code by Wynter Jones",
   "main": "src/index.js",

package/src/doctor.js

@@ -163,23 +163,44 @@ export async function doctor() {
     checkExists(path.join(cwd, "_PLANS"), "_PLANS/ directory exists"),
   );
 
+  // Research System
+  checks.push({ category: "Research System", emoji: "🔬", items: [] });
+  checks[3].items.push(
+    checkExists(path.join(cwd, "_RESEARCH"), "_RESEARCH/ directory exists"),
+  );
+
+  // Office System
+  checks.push({ category: "Office System", emoji: "🏢", items: [] });
+  checks[4].items.push(
+    checkExists(path.join(cwd, "_OFFICE"), "_OFFICE/ directory exists"),
+  );
+  checks[4].items.push(
+    checkExists(path.join(cwd, "_OFFICE", "CORE_LOOP.md"), "CORE_LOOP.md exists"),
+  );
+  checks[4].items.push(
+    checkExists(path.join(cwd, "_OFFICE", "ONBOARDING.md"), "ONBOARDING.md exists"),
+  );
+  checks[4].items.push(
+    checkExists(path.join(cwd, "_OFFICE", "USER_GUIDE.md"), "USER_GUIDE.md exists"),
+  );
+
   // Navigation
   checks.push({ category: "Navigation", emoji: "🐓", items: [] });
-  checks[3].items.push(
+  checks[5].items.push(
     checkExists(path.join(cwd, "justfile"), "justfile exists"),
   );
-  checks[3].items.push(checkCommand("just", "just command available"));
+  checks[5].items.push(checkCommand("just", "just command available"));
 
   // Issue Tracking
   checks.push({ category: "Issue Tracking", emoji: "🐷", items: [] });
-  checks[4].items.push(
+  checks[6].items.push(
     checkExists(path.join(cwd, ".beads"), ".beads/ directory exists"),
   );
-  checks[4].items.push(checkCommand("bd", "bd (beads) command available"));
+  checks[6].items.push(checkCommand("bd", "bd (beads) command available"));
 
   // Security
   checks.push({ category: "Security", emoji: "🐕", items: [] });
-  checks[5].items.push(checkGitignore(cwd));
+  checks[7].items.push(checkGitignore(cwd));
 
   let totalPassed = 0;
   let totalFailed = 0;