@orderful/droid 0.10.2 → 0.10.4

package/dist/skills/brain/commands/brain.md

@@ -1,6 +1,6 @@
 ---
 description: Collaborative scratchpad for planning and research
-argument-hint: "[{topic} | plan|research|review {topic} | note|add {text} | check|done]"
+argument-hint: "[{topic} | plan|research|review {topic} | idea|add {text} | check|done]"
 allowed-tools: Read, Write, Edit, Glob, Grep, Bash(mkdir:*), Bash(ls:*)
 ---
 
@@ -23,10 +23,10 @@ $ARGUMENTS
 ```
 /brain                      # List recent docs or create new
 /brain {topic}              # SEARCH: Open existing doc (fuzzy match) → active
-/brain plan {topic}         # CREATE: New planning doc → active
-/brain research {topic}     # Create research doc → active
-/brain review {topic}       # Create review doc → active
-/brain note {text}          # Quick capture (fire-and-forget)
+/brain plan {topic}         # CREATE: New planning doc → plans/
+/brain research {topic}     # Create research doc → research/
+/brain review {topic}       # Create review doc → reviews/
+/brain idea {text}          # Quick capture → ideas/ (fire-and-forget)
 /brain add {text}           # Append to active doc
 /brain check                # Address @droid comments in active doc
 /brain done                 # Finalize active doc
@@ -37,7 +37,19 @@ $ARGUMENTS
 **ALWAYS read `~/.droid/skills/brain/overrides.yaml` first.** Use configured values if present, only fall back to defaults if missing.
 
 - `brain_dir` - Where docs live (default varies by AI tool)
-- `inbox_folder` - Subfolder for new docs (empty = flat)
+- `inbox_folder` - Root for type folders (e.g., `0-Inbox`)
+
+## Folder Structure
+
+Docs are organized by type:
+
+```
+{brain_dir}/{inbox_folder}/
+├── plans/
+├── research/
+├── reviews/
+└── ideas/
+```
 
 ## Behavior
 
@@ -45,7 +57,7 @@ Refer to the brain skill for:
 
 - **Opening**: How to fuzzy-match, handle multiple matches, set active
 - **Creating**: Template structure by preset, naming conventions
-- **Notes**: Quick capture workflow
+- **Ideas**: Quick capture workflow
 - **Adding**: Append to active doc with timestamp
 - **Checking**: Find and address @droid comments
 - **Finalizing**: Update status, suggest next steps

package/dist/skills/brain/commands/scratchpad.md

@@ -1,6 +1,6 @@
 ---
 description: Collaborative scratchpad for planning and research
-argument-hint: "[{topic} | plan|research|review {topic} | note|add {text} | check|done]"
+argument-hint: "[{topic} | plan|research|review {topic} | idea|add {text} | check|done]"
 allowed-tools: Read, Write, Edit, Glob, Grep, Bash(mkdir:*), Bash(ls:*)
 ---
 
@@ -23,10 +23,10 @@ $ARGUMENTS
 ```
 /scratchpad                      # List recent docs or create new
 /scratchpad {topic}              # SEARCH: Open existing doc (fuzzy match) → active
-/scratchpad plan {topic}         # CREATE: New planning doc → active
-/scratchpad research {topic}     # Create research doc → active
-/scratchpad review {topic}       # Create review doc → active
-/scratchpad note {text}          # Quick capture (fire-and-forget)
+/scratchpad plan {topic}         # CREATE: New planning doc → plans/
+/scratchpad research {topic}     # Create research doc → research/
+/scratchpad review {topic}       # Create review doc → reviews/
+/scratchpad idea {text}          # Quick capture → ideas/ (fire-and-forget)
 /scratchpad add {text}           # Append to active doc
 /scratchpad check                # Address @droid comments in active doc
 /scratchpad done                 # Finalize active doc
@@ -37,7 +37,19 @@ $ARGUMENTS
 **ALWAYS read `~/.droid/skills/brain/overrides.yaml` first.** Use configured values if present, only fall back to defaults if missing.
 
 - `brain_dir` - Where docs live (default varies by AI tool)
-- `inbox_folder` - Subfolder for new docs (empty = flat)
+- `inbox_folder` - Root for type folders (e.g., `0-Inbox`)
+
+## Folder Structure
+
+Docs are organized by type:
+
+```
+{brain_dir}/{inbox_folder}/
+├── plans/
+├── research/
+├── reviews/
+└── ideas/
+```
 
 ## Behavior
 
@@ -45,7 +57,7 @@ Refer to the brain skill for:
 
 - **Opening**: How to fuzzy-match, handle multiple matches, set active
 - **Creating**: Template structure by preset, naming conventions
-- **Notes**: Quick capture workflow
+- **Ideas**: Quick capture workflow
 - **Adding**: Append to active doc with timestamp
 - **Checking**: Find and address @droid comments
 - **Finalizing**: Update status, suggest next steps

package/dist/skills/brain/references/naming.md

@@ -4,17 +4,12 @@ Conventions for naming brain docs.
 
 ## Format
 
+Since docs are organized into type folders (`plans/`, `research/`, `reviews/`, `ideas/`), filenames no longer need a type prefix:
+
 ```
-{type}-{topic-slug}.md
+{topic-slug}.md
 ```
 
-## Components
-
-| Component      | Description                          | Examples                              |
-| -------------- | ------------------------------------ | ------------------------------------- |
-| `{type}`       | Doc type: `plan`, `research`, `note` | `plan`, `research`, `note`            |
-| `{topic-slug}` | Lowercase, hyphen-separated topic    | `auth-refactor`, `caching-strategies` |
-
 ## Slug Rules
 
 1. **Lowercase** all words
@@ -25,26 +20,26 @@ Conventions for naming brain docs.
 
 ## Examples
 
-| Input                                        | Filename                                  |
-| -------------------------------------------- | ----------------------------------------- |
-| `/brain plan Auth Refactor`                  | `plan-auth-refactor.md`                   |
-| `/brain research Caching Strategies`         | `research-caching-strategies.md`          |
-| `/brain plan Transaction Template Rendering` | `plan-transaction-template-rendering.md`  |
-| `/brain note Remember to check rate limits`  | `note-20250115-remember-to-check-rate.md` |
+| Input                                        | Path                                             |
+| -------------------------------------------- | ------------------------------------------------ |
+| `/brain plan Auth Refactor`                  | `plans/auth-refactor.md`                         |
+| `/brain research Caching Strategies`         | `research/caching-strategies.md`                 |
+| `/brain review PR 4530`                      | `reviews/pr-4530.md`                             |
+| `/brain idea Remember to check rate limits`  | `ideas/20250115-remember-to-check-rate.md`       |
 
-## Notes
+## Ideas (Quick Captures)
 
-For notes, include the date in the filename:
+For ideas, include the date in the filename to prevent collisions:
 
 ```
-note-{YYYYMMDD}-{slug}.md
+{YYYYMMDD}-{slug}.md
 ```
 
-This prevents collisions and allows chronological sorting.
+This allows chronological sorting within the `ideas/` folder.
 
 ## Uniqueness
 
 If a file with the generated name already exists:
 
 1. Check if user wants to open existing doc
-2. Or append a numeric suffix: `plan-auth-refactor-2.md`
+2. Or append a numeric suffix: `auth-refactor-2.md`

package/dist/skills/brain/references/templates.md

@@ -82,11 +82,12 @@ Suggested changes or actions.
 Overall assessment.
 ```
 
-## Note Template
+## Idea Template
 
 ```markdown
-# Note: {Brief Title}
+# {Brief Title}
 
+**Type:** idea
 **Created:** {date}
 
 {content}

package/dist/skills/brain/references/workflows.md

@@ -8,9 +8,11 @@ Detailed procedures for each brain operation.
 
 **Steps:**
 
-1. **Read config first**
-   - Read `~/.droid/skills/brain/overrides.yaml`
-   - Use `brain_dir` if configured, otherwise use default for current AI tool
+1. **Read config first (MANDATORY)**
+   - Use the Read tool on `~/.droid/skills/brain/overrides.yaml`
+   - If file exists and contains `brain_dir:`, use that path
+   - Only use defaults if the file doesn't exist or `brain_dir` is not set
+   - **Do NOT skip this step or assume defaults**
 
 2. **Search for matches**
 
@@ -35,24 +37,28 @@ Detailed procedures for each brain operation.
 
 ## Creating
 
-**Trigger:** `/brain plan {topic}` or `/brain research {topic}`
+**Trigger:** `/brain plan {topic}`, `/brain research {topic}`, or `/brain review {topic}`
 
 **Steps:**
 
-1. **Read config first**
-   - Read `~/.droid/skills/brain/overrides.yaml`
-   - Use `brain_dir` if configured, otherwise use default for current AI tool
-   - Use `inbox_folder` if configured
+1. **Read config first (MANDATORY)**
+   - Use the Read tool on `~/.droid/skills/brain/overrides.yaml`
+   - If file exists and contains `brain_dir:`, use that path
+   - Also check for `inbox_folder` setting (e.g., `0-Inbox`)
+   - Only use defaults if the file doesn't exist or `brain_dir` is not set
+   - **Do NOT skip this step or assume defaults**
 
 2. **Generate filename** using naming conventions (see `naming.md`):
-   - Format: `{type}-{topic-slug}.md`
-   - Example: `plan-auth-refactor.md` or `research-caching-strategies.md`
+   - Format: `{topic-slug}.md` (no type prefix - folder indicates type)
+   - Example: `auth-refactor.md` or `caching-strategies.md`
 
-3. **Determine target path:**
-   - If `inbox_folder` is set: `{brain_dir}/{inbox_folder}/{filename}`
-   - Otherwise: `{brain_dir}/{filename}`
+3. **Determine target path based on type:**
+   - Base: `{brain_dir}/{inbox_folder}` (or just `{brain_dir}` if no inbox_folder)
+   - `plan` → `{base}/plans/{filename}`
+   - `research` → `{base}/research/{filename}`
+   - `review` → `{base}/reviews/{filename}`
 
-4. **Create directory** if needed
+4. **Create directory** if needed (type folder may not exist yet)
 
 5. **Apply template** based on preset and type (see `templates.md`)
 
@@ -64,7 +70,7 @@ Detailed procedures for each brain operation.
 7. **Add placeholder comments** for sections needing user input:
    - Read user's mention from `~/.droid/config.yaml` → `user_mention`
    - Use `> @{user_mention}` for placeholders (e.g., `> @fry - Please provide requirements`)
-   - Do NOT use `> @droid` - that's for user-to-AI comments
+   - **CRITICAL:** NEVER use `@droid` - that's for user-to-AI comments, not AI-to-user
 
 8. **Write the doc** with template structure and initial context
 
@@ -72,33 +78,35 @@ Detailed procedures for each brain operation.
 
 10. **Confirm creation** and summarize what was captured
 
-## Notes
+## Ideas
 
-**Trigger:** `/brain note {text}`
+**Trigger:** `/brain idea {text}`
 
 **Steps:**
 
-1. **Read config first**
-   - Read `~/.droid/skills/brain/overrides.yaml`
-   - Use `brain_dir` if configured, otherwise use default for current AI tool
-   - Use `inbox_folder` if configured
+1. **Read config first (MANDATORY)**
+   - Use the Read tool on `~/.droid/skills/brain/overrides.yaml`
+   - If file exists and contains `brain_dir:`, use that path
+   - Also check for `inbox_folder` setting (e.g., `0-Inbox`)
+   - Only use defaults if the file doesn't exist or `brain_dir` is not set
+   - **Do NOT skip this step or assume defaults**
 
 2. **Generate filename:**
-   - Format: `note-{date}-{slug}.md` where date is `YYYYMMDD`
+   - Format: `{date}-{slug}.md` where date is `YYYYMMDD`
    - Slug from first few words of text
-   - Example: `note-20250115-remember-rate-limits.md`
+   - Example: `20250115-remember-rate-limits.md`
 
 3. **Determine target path:**
-   - If `inbox_folder` is set: `{brain_dir}/{inbox_folder}/{filename}`
-   - Otherwise: `{brain_dir}/{filename}`
+   - Base: `{brain_dir}/{inbox_folder}` (or just `{brain_dir}` if no inbox_folder)
+   - Path: `{base}/ideas/{filename}`
 
-4. **Create simple note:**
+4. **Create simple idea doc:**
    - Markdown preset: Just the text
-   - Obsidian preset: Add frontmatter with `type: note`, `created: {date}`
+   - Obsidian preset: Add frontmatter with `type: idea`, `created: {date}`
 
 5. **Write the file** - Do NOT set as active (fire-and-forget)
 
-6. **Confirm** briefly: "Captured note to {filename}"
+6. **Confirm** briefly: "Captured idea to ideas/{filename}"
 
 ## Adding
 
@@ -140,19 +148,25 @@ Detailed procedures for each brain operation.
 
 2. **Read active doc**
 
-3. **Find all `> @droid` comments**
+3. **Check preserve_comments setting:**
+   - Read `~/.droid/skills/comments/overrides.yaml` if it exists
+   - Look for `preserve_comments` (default: `true`)
+
+4. **Find all `> @droid` comments**
    - Pattern: Lines starting with `> @droid` (blockquote with mention)
 
-4. **For each comment:**
+5. **For each comment:**
    - Show the comment and surrounding context
    - Address the question/request
    - Add response as blockquote with user's mention: `> @{user_mention} Your response here`
    - Example: `> @fry Yes, the index covers that query pattern.`
-   - IMPORTANT: Always include the `>` prefix to maintain blockquote formatting
+   - **CRITICAL:** NEVER use `@droid` in your responses. Use `@{user_mention}` from config (e.g., `@fry`)
+   - **CRITICAL:** Always include the `>` prefix to maintain blockquote formatting
+   - **CRITICAL:** If `preserve_comments: true`, keep the original `@droid` comment and add your response below it. Do NOT remove the original comment.
 
-5. **Update the doc** with responses
+6. **Update the doc** with responses
 
-6. **Summarize** what was addressed
+7. **Summarize** what was addressed
 
 ## Finalizing
 
@@ -185,9 +199,11 @@ Detailed procedures for each brain operation.
 
 **Steps:**
 
-1. **Read config first**
-   - Read `~/.droid/skills/brain/overrides.yaml`
-   - Use `brain_dir` if configured, otherwise use default for current AI tool
+1. **Read config first (MANDATORY)**
+   - Use the Read tool on `~/.droid/skills/brain/overrides.yaml`
+   - If file exists and contains `brain_dir:`, use that path
+   - Only use defaults if the file doesn't exist or `brain_dir` is not set
+   - **Do NOT skip this step or assume defaults**
 
 2. **Find recent docs:**
 

package/dist/skills/brain-obsidian/SKILL.md

@@ -26,7 +26,7 @@ brain_dir: ~/path/to/your/vault
 **Optional:** Configure folders in `~/.droid/skills/brain-obsidian/overrides.yaml`:
 
 | Setting            | Default       | Description                     |
-|--------------------|---------------|---------------------------------|
+| ------------------ | ------------- | ------------------------------- |
 | `inbox_folder`     | `0-Inbox`     | Where new docs are created      |
 | `archive_folder`   | `4-Archives`  | Where stale/done docs go        |
 | `para_structure`   | `false`       | Enable full PARA organization   |
@@ -37,7 +37,7 @@ brain_dir: ~/path/to/your/vault
 ## What This Adds
 
 | Feature             | Description                                |
-|---------------------|--------------------------------------------|
+| ------------------- | ------------------------------------------ |
 | YAML frontmatter    | Type, status, dates, project links, tags   |
 | Wikilinks           | `[[note-name]]` syntax for linking         |
 | Folder organization | Inbox + Archive always; full PARA optional |
@@ -45,14 +45,26 @@ brain_dir: ~/path/to/your/vault
 
 ## Folder Organization
 
-**Always available:**
-- `inbox_folder` - New docs land here
-- `archive_folder` - Stale/completed docs
+**Docs are organized by type within the inbox:**
 
-**With `para_structure: true`:**
 ```
 vault/
-├── {inbox_folder}/      # New docs (default: 0-Inbox)
+└── {inbox_folder}/      # (default: 0-Inbox)
+    ├── plans/           # Planning docs
+    ├── research/        # Research docs
+    ├── reviews/         # Review docs
+    └── ideas/           # Quick captures
+```
+
+**With `para_structure: true`** (adds archive + organization folders):
+
+```
+vault/
+├── {inbox_folder}/      # New docs by type (default: 0-Inbox)
+│   ├── plans/
+│   ├── research/
+│   ├── reviews/
+│   └── ideas/
 ├── {projects_folder}/   # Active project docs (default: 1-Projects)
 ├── {areas_folder}/      # Area docs (default: 2-Areas)
 ├── {resources_folder}/  # Reference material (default: 3-Resources)
@@ -69,12 +81,12 @@ All docs get YAML frontmatter:
 
 ```yaml
 ---
-type: plan | research | review | note
+type: plan | research | review | idea
 status: exploring | drafting | decided | done
 created: YYYY-MM-DD
 updated: YYYY-MM-DD
-project: "[[project-name]]"  # Optional
-tags: []                      # Optional
+project: "[[project-name]]" # Optional
+tags: [] # Optional
 ---
 ```
 
@@ -82,12 +94,17 @@ See `references/templates.md` for full templates.
 
 ### File Location
 
-Docs are created in your vault's inbox folder:
-- `{brain_dir}/{inbox_folder}/{filename}.md`
+Docs are created in type-specific folders within your vault's inbox:
+
+- `{brain_dir}/{inbox_folder}/plans/{filename}.md`
+- `{brain_dir}/{inbox_folder}/research/{filename}.md`
+- `{brain_dir}/{inbox_folder}/reviews/{filename}.md`
+- `{brain_dir}/{inbox_folder}/ideas/{filename}.md`
 
 ### Finalizing
 
 When running `/brain done`:
+
 1. Updates status to `done` in frontmatter
 2. Suggests moving to archive (or projects/resources if PARA enabled)
 3. Confirms before moving
@@ -96,10 +113,10 @@ When running `/brain done`:
 
 Same commands as brain skill, but with Obsidian output:
 
-| Command                   | Obsidian Behavior                          |
-|---------------------------|--------------------------------------------|
-| `/brain plan {topic}`     | Creates in inbox with frontmatter          |
-| `/brain research {topic}` | Creates in inbox with frontmatter          |
-| `/brain review {topic}`   | Creates in inbox with frontmatter          |
-| `/brain note {text}`      | Quick capture to inbox                     |
-| `/brain done`             | Updates status, suggests archive/PARA move |
+| Command                   | Obsidian Behavior                             |
+| ------------------------- | --------------------------------------------- |
+| `/brain plan {topic}`     | Creates in `plans/` with frontmatter          |
+| `/brain research {topic}` | Creates in `research/` with frontmatter       |
+| `/brain review {topic}`   | Creates in `reviews/` with frontmatter        |
+| `/brain idea {text}`      | Quick capture to `ideas/`                     |
+| `/brain done`             | Updates status, suggests archive/PARA move    |

package/dist/skills/brain-obsidian/references/templates.md

@@ -8,8 +8,8 @@ Templates with YAML frontmatter and wikilink support.
 ---
 type: plan
 status: exploring
-created: {date}
-updated: {date}
+created: { date }
+updated: { date }
 project: "[[{project}]]"
 tags: []
 ---
@@ -41,8 +41,8 @@ What we chose and why.
 ---
 type: research
 status: exploring
-created: {date}
-updated: {date}
+created: { date }
+updated: { date }
 project: "[[{project}]]"
 tags: []
 ---
@@ -75,8 +75,8 @@ Key takeaways.
 ---
 type: review
 status: exploring
-created: {date}
-updated: {date}
+created: { date }
+updated: { date }
 project: "[[{project}]]"
 tags: []
 ---
@@ -102,12 +102,12 @@ Suggested changes or actions.
 Overall assessment.
 ```
 
-## Note Template
+## Idea Template
 
 ```markdown
 ---
-type: note
-created: {date}
+type: idea
+created: { date }
 tags: []
 ---
 
@@ -118,24 +118,24 @@ tags: []
 
 ## Template Variables
 
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `{Topic}` | Doc title from user input | "Auth Refactor" |
-| `{date}` | Current date (YYYY-MM-DD) | "2025-01-15" |
-| `{brief description}` | Context from conversation | "refactoring the authentication system" |
-| `{project}` | Active project name (if any) | "transaction-templates" |
-| `{content}` | User-provided text | (for notes) |
+| Variable              | Description                  | Example                                 |
+| --------------------- | ---------------------------- | --------------------------------------- |
+| `{Topic}`             | Doc title from user input    | "Auth Refactor"                         |
+| `{date}`              | Current date (YYYY-MM-DD)    | "2025-01-15"                            |
+| `{brief description}` | Context from conversation    | "refactoring the authentication system" |
+| `{project}`           | Active project name (if any) | "transaction-templates"                 |
+| `{content}`           | User-provided text           | (for notes)                             |
 
 ## Frontmatter Fields
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `type` | string | Doc type: `plan`, `research`, `review`, `note` |
-| `status` | string | Lifecycle: `exploring`, `drafting`, `decided`, `done`, `stale` |
-| `created` | date | Creation date (YYYY-MM-DD) |
-| `updated` | date | Last modification date |
-| `project` | wikilink | Link to related project: `"[[project-name]]"` |
-| `tags` | list | Tags for filtering: `[tag1, tag2]` |
+| Field     | Type     | Description                                                    |
+| --------- | -------- | -------------------------------------------------------------- |
+| `type`    | string   | Doc type: `plan`, `research`, `review`, `idea`                 |
+| `status`  | string   | Lifecycle: `exploring`, `drafting`, `decided`, `done`, `stale` |
+| `created` | date     | Creation date (YYYY-MM-DD)                                     |
+| `updated` | date     | Last modification date                                         |
+| `project` | wikilink | Link to related project: `"[[project-name]]"`                  |
+| `tags`    | list     | Tags for filtering: `[tag1, tag2]`                             |
 
 ## Wikilink Conventions
 

package/dist/skills/brain-obsidian/references/workflows.md

@@ -12,10 +12,13 @@ Obsidian-specific procedures that override brain defaults.
    - `brain_dir` from brain skill (your vault path)
    - `inbox_folder` from brain-obsidian (default: `0-Inbox`)
 
-2. **Target folder:** `{brain_dir}/{inbox_folder}/`
+2. **Determine target folder based on type:**
+   - `plan` → `{brain_dir}/{inbox_folder}/plans/`
+   - `research` → `{brain_dir}/{inbox_folder}/research/`
+   - `review` → `{brain_dir}/{inbox_folder}/reviews/`
 
 3. **Generate filename** using brain's naming conventions:
-   - Format: `{type}-{topic-slug}.md`
+   - Format: `{topic-slug}.md` (no type prefix - folder indicates type)
 
 4. **Check for active project:**
    - If `/project` was loaded this session, use its name for `project` field
@@ -26,7 +29,7 @@ Obsidian-specific procedures that override brain defaults.
    - Set `created` and `updated` to today
    - Set `status: exploring`
 
-6. **Create the file** in vault
+6. **Create the file** in vault (create type folder if needed)
 
 7. **Set as active doc** (same as brain)
 
@@ -37,6 +40,7 @@ Obsidian-specific procedures that override brain defaults.
 **Steps:**
 
 1. **Search in brain_dir** (your vault):
+
    ```
    Glob: {brain_dir}/**/*{topic}*.md
    ```
@@ -82,25 +86,27 @@ When modifying any brain doc:
 4. **Confirm move with user** before relocating
 
 5. **Move the file** if confirmed:
+
    ```bash
    mv "{brain_dir}/{inbox_folder}/{file}" "{brain_dir}/{destination}/{file}"
    ```
 
 6. **Clear active doc** from session
 
-## Quick Notes
+## Quick Ideas
 
-**Overrides:** brain's Notes workflow
+**Overrides:** brain's Ideas workflow
 
 **Steps:**
 
-1. **Create in inbox:** `{brain_dir}/{inbox_folder}/note-{date}-{slug}.md`
+1. **Create in ideas folder:** `{brain_dir}/{inbox_folder}/ideas/{date}-{slug}.md`
+
+2. **Use idea template** with minimal frontmatter:
 
-2. **Use note template** with minimal frontmatter:
    ```yaml
    ---
-   type: note
-   created: {date}
+   type: idea
+   created: { date }
    tags: []
    ---
    ```
@@ -110,6 +116,7 @@ When modifying any brain doc:
 ## Project Integration (Optional)
 
 **Requires:** `project` skill. If not installed, suggest:
+
 > "Linking to projects requires the project skill. Install it with `droid` → Skills → project"
 
 When a project is loaded via `/project {name}`:
@@ -123,6 +130,7 @@ When a project is loaded via `/project {name}`:
 **Trigger:** User says "add this to the project", "link this to project", or "capture in project"
 
 **Requires:** `project` skill. If not installed, suggest:
+
 > "Linking to projects requires the project skill. Install it with `droid` → Skills → project"
 
 For linking a brain doc (research, notes, design) to an existing project.
@@ -150,6 +158,7 @@ For linking a brain doc (research, notes, design) to an existing project.
 **Trigger:** User says "promote to project", "make this a project", or "convert to project"
 
 **Requires:** `project` skill. If not installed, suggest:
+
 > "Promoting to project requires the project skill. Install it with `droid` → Skills → project"
 
 For graduating a full tech design or plan into its own project.
@@ -184,9 +193,10 @@ For graduating a full tech design or plan into its own project.
 
 **Overrides:** brain's Listing workflow
 
-Search in vault:
+Search in type folders within vault:
+
 ```
-Glob: {brain_dir}/**/*.md
+Glob: {brain_dir}/{inbox_folder}/{plans,research,reviews,ideas}/**/*.md
 ```
 
-Filter to brain doc types by checking frontmatter for `type: plan|research|review|note`.
+Filter to brain doc types by checking frontmatter for `type: plan|research|review|idea`.