@orderful/droid 0.2.0

package/.changeset/README.md

@@ -0,0 +1,30 @@
+# Changesets
+
+This project uses [changesets](https://github.com/changesets/changesets) for version management and changelog generation.
+
+## Adding a changeset
+
+When you make a change that should be released, run:
+
+```bash
+bun changeset
+```
+
+This will prompt you to:
+1. Select the package(s) affected
+2. Choose the semver bump type (major/minor/patch)
+3. Write a summary of the change
+
+The changeset file will be created in `.changeset/` and should be committed with your PR.
+
+## Versioning guide
+
+- **patch**: Bug fixes, documentation updates, internal refactors
+- **minor**: New features, new skills, non-breaking enhancements
+- **major**: Breaking changes to CLI interface or config format
+
+## Release process
+
+Releases happen automatically when PRs with changesets are merged to `main`:
+1. A "Version Packages" PR is created/updated
+2. Merging that PR publishes to npm and creates GitHub releases

package/.changeset/config.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": [
+    "@changesets/changelog-github",
+    { "repo": "orderful/droid" }
+  ],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "restricted",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/.eslintrc.json

@@ -0,0 +1,20 @@
+{
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "extends": [
+    "eslint:recommended"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint"],
+  "rules": {
+    "no-unused-vars": "off",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
+  },
+  "ignorePatterns": ["dist/", "node_modules/", "*.test.ts"]
+}

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,9 @@
+## Summary
+
+<!-- Brief description of changes -->
+
+## Test Plan
+
+<!-- How to test these changes -->
+
+---

package/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build
+        run: bun run build
+
+      - name: Test
+        run: bun test src/
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Lint
+        run: bun run lint

package/.github/workflows/release.yml

@@ -0,0 +1,45 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build
+        run: bun run build
+
+      - name: Test
+        run: bun test src/
+
+      - name: Create Release Pull Request or Publish
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          version: bun changeset version
+          publish: bun changeset publish
+          title: "chore: version packages"
+          commit: "chore: version packages"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.ORDERFUL_NPM_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @orderful/droid
+
+## 0.2.0
+
+### Minor Changes
+
+- [#1](https://github.com/Orderful/droid/pull/1) [`5deb7b2`](https://github.com/Orderful/droid/commit/5deb7b2aa3c4510940cfc2336e3600de071a40a1) Thanks [@frytyler](https://github.com/frytyler)! - Initial release of @orderful/droid - AI workflow toolkit
+  - CLI commands: `droid setup`, `droid config`, `droid skills`, `droid install`, `droid update`
+  - First skill: `comments` - inline conversation via `@droid`/`@user` markers
+  - Config system with global and per-skill overrides
+  - Support for Claude Code and OpenCode

package/README.md

@@ -0,0 +1,153 @@
+# @orderful/droid
+
+**"Teaching your droid new tricks"**
+
+AI workflow toolkit for sharing skills, commands, and agents across the engineering team.
+
+### Why Droid?
+
+- **Lower the barrier to entry** - Get started with AI coding tools (Claude Code, OpenCode) without configuring skills and commands from scratch
+- **Share what works** - Power users discover great workflows, everyone benefits
+- **Consistent experience** - Common patterns like `@droid`/`@user` comments work the same across the team
+
+## Installation
+
+```bash
+npm install -g @orderful/droid
+```
+
+## Quick Start
+
+```bash
+# Initial setup - configure your AI tool and preferences
+droid setup
+
+# Browse available skills
+droid skills
+
+# Install a skill
+droid install comments
+
+# View/edit your config
+droid config
+droid config -e  # Open in editor
+```
+
+## What is Droid?
+
+Droid is a CLI tool that helps you install and manage AI workflow extensions (skills, commands, agents) for tools like Claude Code and OpenCode.
+
+### Core Concepts
+
+- **Skills** - Teach your AI new capabilities (e.g., inline comments, PR workflows)
+- **Commands** - Slash commands that invoke skill functionality (e.g., `/comments check`)
+- **Config** - Global and per-skill configuration stored in `~/.droid/`
+
+### Directory Structure
+
+```
+~/.droid/
+├── config.yaml                    # Global config
+└── skills/
+    └── {skill}/
+        └── overrides.yaml         # Per-skill config overrides
+```
+
+Skills are installed to your AI tool's location:
+- **Claude Code**: `~/.claude/skills/` and `~/.claude/commands/`
+- **OpenCode**: `~/.config/opencode/skills/` and `~/.config/opencode/command/`
+
+## Available Skills
+
+### `comments` (v0.1.0 - beta)
+
+Inline conversation in any file via `@droid`/`@user` markers.
+
+```markdown
+> @droid What do you think of this approach?
+
+> @fry I think this approach is solid. One consideration...
+```
+
+**Commands:**
+- `/comments check` - Address all `@droid` comments
+- `/comments cleanup` - Remove resolved comment threads
+
+## Configuration
+
+### Global Config (`~/.droid/config.yaml`)
+
+```yaml
+ai_tool: claude-code    # claude-code | opencode
+user_mention: "@fry"    # Your @mention for responses
+output_preference: terminal  # terminal | editor | brain
+git_username: "frytyler"
+skills: {}              # Installed skills with versions
+```
+
+### Skill Overrides
+
+Each skill can have its own config in `~/.droid/skills/{skill}/overrides.yaml`:
+
+```yaml
+# ~/.droid/skills/comments/overrides.yaml
+preserve_comments: true
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `droid setup` | Interactive setup wizard |
+| `droid config` | View current config |
+| `droid config -e` | Edit config in $EDITOR |
+| `droid config --get <key>` | Get a config value |
+| `droid config --set <key=value>` | Set a config value |
+| `droid skills` | Interactive skill browser |
+| `droid install <skill>` | Install a skill |
+| `droid update` | Update droid and skills |
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/orderful/droid.git
+cd droid
+npm install
+
+# Build
+npm run build
+
+# Run locally
+node dist/bin/droid.js --help
+```
+
+## Roadmap
+
+### Phase 1: Foundation (Current)
+- [x] CLI structure
+- [x] Config management
+- [x] `comments` skill
+
+### Phase 2: Core Skills
+- [ ] `pr` - PR workflow with configurable output
+- [ ] `brain` - Collaborative thinking space (Obsidian vault)
+- [ ] `playwright` - UI testing with Playwright MCP
+
+### Phase 3: Polish
+- [ ] `droid update` with version checks
+- [ ] `droid feedback` - Slack the skill author
+- [ ] Contributor tooling
+
+## Contributing
+
+Skills are bundled with the package. To add a new skill:
+
+1. Create `src/skills/{name}/SKILL.yaml` (manifest)
+2. Create `src/skills/{name}/SKILL.md` (skill instructions)
+3. Create `src/skills/{name}/commands/*.md` (commands)
+4. Submit a PR
+
+## License
+
+MIT