farmwork 1.1.0 → 1.4.0

package/README.md

@@ -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,9 +54,27 @@ 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
 
 ### Slash Commands
 
@@ -66,7 +84,7 @@ npx farmwork init
 
 ### Agents
 
-11 specialized agents included:
+12 specialized agents included:
 
 | Agent | Purpose |
 |-------|---------|
@@ -81,14 +99,17 @@ 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 |
 
 ### 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 +119,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/         # 12 specialized subagents
 │   │   ├── the-farmer.md
 │   │   ├── code-reviewer.md
 │   │   ├── security-auditor.md
@@ -109,7 +130,8 @@ your-project/
 │   │   ├── code-cleaner.md
 │   │   ├── i18n-locale-translator.md
 │   │   ├── storybook-maintainer.md
-│   │   └── idea-gardener.md
+│   │   ├── idea-gardener.md
+│   │   └── researcher.md
 │   └── commands/       # User-invocable skills
 │       └── push.md
 ├── _AUDIT/             # Living audit documents
@@ -123,6 +145,8 @@ your-project/
 │   └── COMPOST.md      # Rejected ideas archive
 ├── _PLANS/             # Implementation plans
 │   └── FEATURE_NAME.md
+├── _RESEARCH/          # Research documents (living docs)
+│   └── TOPIC_NAME.md
 ├── .beads/             # Issue tracking
 └── justfile            # Navigation commands
 ```
@@ -152,7 +176,7 @@ 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
+  - `agents/` - 12 specialized subagents
   - `commands/` - 1 user-invocable skill (/push)
 - `_AUDIT/` - Living audit documents
   - `FARMHOUSE.md` - Framework command center
@@ -164,6 +188,7 @@ If you enable Storybook (for React/Vue projects), the wizard will also ask for:
   - `GARDEN.md` - Idea nursery (pre-plan stage)
   - `COMPOST.md` - Rejected ideas archive
 - `_PLANS/` - Implementation plans directory
+- `_RESEARCH/` - Research documents directory
 - `justfile` - Navigation and task commands
 
 ### `farmwork status`
@@ -199,6 +224,7 @@ farmwork doctor
 - Core files (CLAUDE.md, .claude/, settings)
 - Agents and commands configuration
 - Audit system (_AUDIT/, FARMHOUSE.md, _PLANS/)
+- Research system (_RESEARCH/)
 - 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.0",
   "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;