farmwork 1.0.2 → 1.1.0

package/README.md

@@ -33,6 +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
 
 ### Phrase Commands
 
@@ -40,7 +41,7 @@ npx farmwork init
 | Phrase | Action |
 |--------|--------|
 | `open the farm` | Audit systems, update FARMHOUSE.md metrics |
-| `count the herd` | Full inspection + dry run (code review, performance, security, quality, accessibility) |
+| `count the herd` | Full inspection and audit |
 | `go to market` | i18n translation check + accessibility audit |
 | `close the farm` | Full push workflow (lint, test, build, commit, push) |
 
@@ -50,6 +51,13 @@ npx farmwork init
 | `make a plan for...` | Create implementation plan in `_PLANS/` |
 | `let's implement...` | Execute plan with issue tracking |
 
+**Idea Phrases** (Pre-Plan Stage):
+| Phrase | Action |
+|--------|--------|
+| `I have an idea for...` | Add new idea to `_AUDIT/GARDEN.md` |
+| `let's plan this idea...` | Graduate idea from GARDEN → create plan |
+| `compost this...` | Move rejected idea to `_AUDIT/COMPOST.md` |
+
 ### Slash Commands
 
 | Command | Description |
@@ -58,7 +66,7 @@ npx farmwork init
 
 ### Agents
 
-10 specialized agents included:
+11 specialized agents included:
 
 | Agent | Purpose |
 |-------|---------|
@@ -72,6 +80,7 @@ npx farmwork init
 | `code-cleaner` | Remove comments and console.logs |
 | `i18n-locale-translator` | Translate UI text to locales |
 | `storybook-maintainer` | Create/update Storybook stories |
+| `idea-gardener` | Manage Idea Garden and Compost |
 
 ### Recommended Workflow
 
@@ -89,7 +98,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/         # 10 specialized subagents
+│   ├── agents/         # 11 specialized subagents
 │   │   ├── the-farmer.md
 │   │   ├── code-reviewer.md
 │   │   ├── security-auditor.md
@@ -99,7 +108,8 @@ your-project/
 │   │   ├── unused-code-cleaner.md
 │   │   ├── code-cleaner.md
 │   │   ├── i18n-locale-translator.md
-│   │   └── storybook-maintainer.md
+│   │   ├── storybook-maintainer.md
+│   │   └── idea-gardener.md
 │   └── commands/       # User-invocable skills
 │       └── push.md
 ├── _AUDIT/             # Living audit documents
@@ -108,7 +118,9 @@ your-project/
 │   ├── PERFORMANCE.md  # Performance metrics
 │   ├── ACCESSIBILITY.md # WCAG 2.1 compliance
 │   ├── CODE_QUALITY.md # Code quality tracking
-│   └── TESTS.md        # Test coverage
+│   ├── TESTS.md        # Test coverage
+│   ├── GARDEN.md       # Idea nursery (pre-plan stage)
+│   └── COMPOST.md      # Rejected ideas archive
 ├── _PLANS/             # Implementation plans
 │   └── FEATURE_NAME.md
 ├── .beads/             # Issue tracking
@@ -140,7 +152,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/` - 10 specialized subagents
+  - `agents/` - 11 specialized subagents
   - `commands/` - 1 user-invocable skill (/push)
 - `_AUDIT/` - Living audit documents
   - `FARMHOUSE.md` - Framework command center
@@ -149,6 +161,8 @@ If you enable Storybook (for React/Vue projects), the wizard will also ask for:
   - `ACCESSIBILITY.md` - WCAG 2.1 compliance
   - `CODE_QUALITY.md` - Code quality tracking
   - `TESTS.md` - Test coverage tracking
+  - `GARDEN.md` - Idea nursery (pre-plan stage)
+  - `COMPOST.md` - Rejected ideas archive
 - `_PLANS/` - Implementation plans directory
 - `justfile` - Navigation and task commands
 

package/package.json

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

package/src/init.js

@@ -556,6 +556,18 @@ Run these in order for a complete development cycle:
 
 ---
 
+### Idea Phrases (Pre-Plan Stage)
+
+| Phrase | Action |
+|--------|--------|
+| **I have an idea for...** | Add new idea to \`_AUDIT/GARDEN.md\` (title, description, bullets) |
+| **let's plan this idea...** | Graduate idea from GARDEN → create plan in \`_PLANS/\` |
+| **I dont want to do this idea...** | Reject idea → move from GARDEN to COMPOST |
+| **remove this feature...** | Archive feature idea to COMPOST |
+| **compost this...** | Move idea from GARDEN to COMPOST |
+
+---
+
 ### Farmwork Phrase Details
 
 **open the farm**
@@ -585,6 +597,30 @@ Runs all inspection agents in parallel, then dry run quality gates. No push.
 
 ---
 
+### Idea Phrase Details
+
+**I have an idea for...**
+1. Launch \`idea-gardener\` agent
+2. Parse idea title from user input
+3. Ask for short description and bullet points
+4. Add to \`_AUDIT/GARDEN.md\` under ## Ideas section
+
+**let's plan this idea...**
+1. Launch \`idea-gardener\` agent
+2. Find the idea in GARDEN.md
+3. Create plan in \`_PLANS/\` using plan mode
+4. Move to "Graduated to Plans" table
+5. Remove from ## Ideas section
+
+**compost this...** / **I dont want to do this idea...**
+1. Launch \`idea-gardener\` agent
+2. Find idea in GARDEN.md (or accept new rejection)
+3. Ask for rejection reason
+4. Add to \`_AUDIT/COMPOST.md\` with reason
+5. Remove from GARDEN.md if it was there
+
+---
+
 ## Plan Mode Protocol
 
 **CRITICAL**: When Claude enters Plan Mode, ALL plans MUST:
@@ -651,7 +687,7 @@ async function createFarmhouseMd(cwd, answers) {
 | Metric | Count |
 |--------|-------|
 | Commands | 1 |
-| Agents | 10 |
+| Agents | 11 |
 | Justfile Recipes | 10 |
 | Unit Tests | 0 |
 | E2E Tests | 0 |
@@ -687,6 +723,7 @@ All Claude Code commands and agents are documented, phrase triggers are tested a
 | \`code-cleaner\` | Remove comments and console.logs |
 | \`i18n-locale-translator\` | Translate UI text to locales |
 | \`storybook-maintainer\` | Create/update Storybook stories |
+| \`idea-gardener\` | Manage Idea Garden and Compost |
 
 ---
 
@@ -708,6 +745,14 @@ All Claude Code commands and agents are documented, phrase triggers are tested a
 | \`make a plan for...\` | Create plan in _PLANS/ |
 | \`let's implement...\` | Load plan, create Epic |
 
+### Idea Phrases
+
+| Phrase | Action |
+|--------|--------|
+| \`I have an idea for...\` | Add idea to GARDEN.md |
+| \`let's plan this idea...\` | Graduate idea to _PLANS/ |
+| \`compost this...\` | Move idea to COMPOST.md |
+
 ---
 
 ## Issue Tracking (\`.beads/\`)
@@ -810,6 +855,67 @@ _None currently_
 
     await fs.writeFile(path.join(cwd, "_AUDIT", audit.name), content);
   }
+
+  // Create GARDEN.md (Idea nursery - custom format)
+  const gardenContent = `# Idea Garden
+
+> Nursery for new ideas and concepts. The pre-plan creative thinking stage.
+
+**Last Updated:** ${today}
+**Active Ideas:** 0
+
+---
+
+## How to Use
+
+| Phrase | Action |
+|--------|--------|
+| \`I have an idea for...\` | Plant a new idea here |
+| \`let's plan this idea...\` | Graduate idea to _PLANS/ |
+| \`compost this...\` | Reject idea, move to COMPOST |
+
+---
+
+## Ideas
+
+_No ideas planted yet. Start with "I have an idea for..."_
+
+---
+
+## Graduated to Plans
+
+| Idea | Plan | Date |
+|------|------|------|
+`;
+
+  await fs.writeFile(path.join(cwd, "_AUDIT", "GARDEN.md"), gardenContent);
+
+  // Create COMPOST.md (Rejected ideas archive - custom format)
+  const compostContent = `# Idea Compost
+
+> Archive of rejected ideas. Reference to avoid re-proposing and remember why we didn't pursue something.
+
+**Last Updated:** ${today}
+**Composted Ideas:** 0
+
+---
+
+## How to Use
+
+| Phrase | Action |
+|--------|--------|
+| \`I dont want to do this idea...\` | Reject an idea |
+| \`remove this feature...\` | Archive a feature idea |
+| \`compost this...\` | Move idea from GARDEN here |
+
+---
+
+## Composted Ideas
+
+_No composted ideas yet._
+`;
+
+  await fs.writeFile(path.join(cwd, "_AUDIT", "COMPOST.md"), compostContent);
 }
 
 async function createJustfile(cwd, answers) {
@@ -901,7 +1007,7 @@ async function createAgents(cwd, answers) {
 name: the-farmer
 description: Audit and update FARMHOUSE.md with current project metrics
 tools: Read, Grep, Glob, Edit, Bash
-model: haiku
+model: opus
 ---
 
 # The Farmer Agent
@@ -935,7 +1041,7 @@ Maintains \`_AUDIT/FARMHOUSE.md\` - the living document tracking all systems and
 name: code-reviewer
 description: Review code for quality, security, and maintainability
 tools: Read, Grep, Glob, Bash
-model: sonnet
+model: opus
 ---
 
 # Code Reviewer Agent
@@ -952,7 +1058,7 @@ Reports findings with severity (CRITICAL, HIGH, MEDIUM, LOW) and remediation ste
 name: security-auditor
 description: OWASP security vulnerability scanning
 tools: Read, Grep, Glob, Edit
-model: haiku
+model: opus
 ---
 
 # Security Auditor Agent
@@ -971,7 +1077,7 @@ Updates \`_AUDIT/SECURITY.md\` with results.
 name: performance-auditor
 description: Find memory leaks, unnecessary re-renders, and anti-patterns
 tools: Read, Grep, Glob, Edit
-model: haiku
+model: opus
 ---
 
 # Performance Auditor Agent
@@ -990,7 +1096,7 @@ Updates \`_AUDIT/PERFORMANCE.md\` with results.
 name: code-smell-auditor
 description: Detect DRY violations, complexity issues, naming problems, and technical debt
 tools: Read, Grep, Glob, Edit
-model: haiku
+model: opus
 ---
 
 # Code Smell Auditor Agent
@@ -1009,7 +1115,7 @@ Updates \`_AUDIT/CODE_QUALITY.md\` with results.
 name: accessibility-auditor
 description: WCAG 2.1 accessibility auditing for React/Next.js applications
 tools: Read, Grep, Glob, Edit
-model: haiku
+model: opus
 ---
 
 # Accessibility Auditor Agent
@@ -1029,7 +1135,7 @@ Updates \`_AUDIT/ACCESSIBILITY.md\` with results.
 name: unused-code-cleaner
 description: Detect and remove unused code (imports, functions, variables)
 tools: Read, Write, Edit, Bash, Grep, Glob
-model: haiku
+model: opus
 ---
 
 # Unused Code Cleaner Agent
@@ -1048,7 +1154,7 @@ Use after refactoring, when removing features, or before production deployment.
 name: code-cleaner
 description: Fast removal of comments, console.logs, and debug code while preserving JSDoc
 tools: Read, Edit, Glob, Grep
-model: haiku
+model: opus
 ---
 
 # Code Cleaner Agent
@@ -1068,7 +1174,7 @@ Fast cleanup of TypeScript/JavaScript files:
 name: i18n-locale-translator
 description: Translate UI text content into English (en) and Japanese (jp) using i18n locale system
 tools: Read, Write, Edit, Glob, Grep
-model: sonnet
+model: opus
 ---
 
 # i18n Locale Translator Agent
@@ -1085,7 +1191,7 @@ Use when adding new features or internationalizing existing hardcoded text.
 name: storybook-maintainer
 description: Create and update Storybook stories for UI components
 tools: Read, Write, Edit, Glob, Grep
-model: haiku
+model: opus
 ---
 
 # Storybook Maintainer Agent
@@ -1097,6 +1203,43 @@ Manages Storybook stories for UI components:
 - Add controls for interactive props
 
 Use when adding new components or when existing components change significantly.
+`,
+    "idea-gardener.md": `---
+name: idea-gardener
+description: Manage the Idea Garden and Compost - add, graduate, or reject ideas
+tools: Read, Edit, Glob, Grep
+model: opus
+---
+
+# Idea Gardener Agent
+
+Manages \`_AUDIT/GARDEN.md\` and \`_AUDIT/COMPOST.md\` for idea lifecycle tracking.
+
+## Commands
+
+### Plant an Idea (from "I have an idea for...")
+1. Parse the idea title from user input
+2. Ask user for short description and key bullet points
+3. Add to GARDEN.md under ## Ideas section with format:
+   ### [Idea Title]
+   [Short description]
+   - Bullet point 1
+   - Bullet point 2
+
+### Graduate an Idea (from "let's plan this idea...")
+1. Find idea in GARDEN.md
+2. Create plan file in _PLANS/ using plan mode
+3. Move idea to "Graduated to Plans" table with date and plan link
+4. Remove from ## Ideas section
+
+### Compost an Idea (from "compost this..." / "I dont want...")
+1. Find idea in GARDEN.md (or accept new rejection)
+2. Ask for rejection reason
+3. Add to COMPOST.md with reason and date
+4. Remove from GARDEN.md if it was there
+
+## Output Format
+Confirm action taken and show updated file section.
 `,
   };
 
@@ -1280,7 +1423,7 @@ async function createSettings(cwd, answers) {
 
 async function createProduceConfig(cwd, answers) {
   const config = {
-    version: "1.0.0",
+    version: "1.1.0",
     projectName: answers.projectName,
     commands: {
       test: answers.testCommand,
@@ -1291,7 +1434,7 @@ async function createProduceConfig(cwd, answers) {
       storybook: answers.includeStorybook || false,
       i18n: answers.includeI18n || false,
     },
-    audits: ["FARMHOUSE", "SECURITY", "PERFORMANCE", "ACCESSIBILITY", "CODE_QUALITY", "TESTS"],
+    audits: ["FARMHOUSE", "SECURITY", "PERFORMANCE", "ACCESSIBILITY", "CODE_QUALITY", "TESTS", "GARDEN", "COMPOST"],
   };
 
   if (answers.includeStorybook) {