@orderful/droid 0.10.3 → 0.10.5

package/src/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/src/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/src/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`.

package/src/skills/code-review/commands/code-review.md

@@ -17,29 +17,46 @@ Review target: $ARGUMENTS
 /code-review path/to/file   # Review specific file
 ```
 
+### Step 0: Check for Brain Integration
+
+**If the `brain` skill is installed** (check for `~/.claude/skills/brain/SKILL.md` or `~/.config/opencode/skills/brain/SKILL.md`):
+
+Ask the user: **"Would you like the review results saved to a `/brain review` doc?"**
+
+- If yes: Create a brain review doc at the start using `/brain review {PR title or branch name}`
+- The final report will be written to the brain doc instead of just displayed
+- This allows for async discussion via `@droid`/`@{user}` comments
+
+If brain skill is not installed or user declines, proceed with normal terminal output.
+
 ### Step 1: Determine Review Scope
 
 Parse the argument to determine what to review:
 
 **If argument starts with `#` or is a number (e.g., `#123` or `123`):**
+
 - This is a PR number
 - Fetch PR details: `gh pr view $PR_NUMBER --json title,body,baseRefName,headRefName,files`
 - Get the diff: `gh pr diff $PR_NUMBER`
 - Note the PR author and description for context
 
 **If argument is `staged` or empty:**
+
 - Review staged changes: `git diff --cached`
 
 **If argument is `branch`:**
+
 - Review current branch vs main: `git diff origin/main...HEAD`
 
 **If argument is a file path:**
+
 - Review specific file: `git diff HEAD -- $FILE_PATH`
 - If no changes, review the entire file for issues
 
 ### Step 2: Gather Context
 
 For PR reviews, also fetch:
+
 - PR description (may contain context about the change)
 - Linked issues: `gh pr view $PR_NUMBER --json body` and parse for #issue refs
 - Changed files list for targeted agent assignment
@@ -54,6 +71,7 @@ Launch these agents in parallel using the Task tool with `run_in_background: tru
 4. **type-reviewer**: Type design, interface contracts
 
 Pass each agent:
+
 1. The diff content
 2. The full file content for changed files (for context)
 3. PR description if available
@@ -70,15 +88,18 @@ Filter out issues with confidence < 80.
 Compile findings into a prioritized report:
 
 **PR #123: "Add partnership billing events"** (if reviewing a PR)
-*Author: @username*
+_Author: @username_
 
 **Critical** (security, data loss, billing errors)
+
 - `file.ts:42` - Issue description
 
 **Important** (bugs, missing tests, type issues)
+
 - `file.ts:67` - Issue description
 
 **Suggestions** (style, readability)
+
 - `file.ts:89` - Issue description
 
 **Summary**: X critical, Y important, Z suggestions across N files.
@@ -86,6 +107,7 @@ Compile findings into a prioritized report:
 ### Step 6: Offer Actions (for PRs)
 
 After presenting the report, offer:
+
 - "Would you like me to post this as a PR comment?"
 - "Should I suggest fixes for any of these issues?"
 - "Want me to check out this branch and fix the critical issues?"