@orderful/droid 0.15.0 → 0.16.1

package/.claude/CLAUDE.md

@@ -1,52 +1,30 @@
 # CLAUDE.md
 
-Project instructions for Claude Code when working in this repository.
+@../AGENTS.md
 
-## Project Overview
+## Claude-Specific Instructions
 
-Droid is a TUI dashboard for managing AI tools. Each tool bundles related skills, commands, and agents. Installs to Claude Code (`~/.claude/`) and OpenCode (`~/.config/opencode/`).
-
-## Build & Test
-
-```bash
-bun run build      # Compile TypeScript and copy tools to dist/
-bun run dev        # Watch mode
-bun run test       # Run tests
-bun run lint       # Run ESLint
-bun run start      # Run the TUI (bun dist/bin/droid.js)
-```
-
-## Git Rules
+### Git Rules
 
 - **NEVER push directly to main**. Always create a branch and PR, even for small changes. The only exception is if the user explicitly says "push to main" in their message.
 - Branch naming: `tf/<ticket-or-description>` (e.g., `tf/tools-architecture`)
-- Use changesets for version bumps: `npx changeset`
 - **Changeset package name must be `"@orderful/droid"`** (not `"droid"`)
 
-## Structure
+### Changesets (IMPORTANT)
 
-```
-src/
-├── bin/           # CLI entry point
-├── commands/      # CLI commands (tui.tsx is the main dashboard)
-├── lib/           # Core logic (tools.ts, skills.ts, agents.ts, config.ts)
-└── tools/         # Bundled tools
-    └── {tool}/
-        ├── TOOL.yaml               # Tool manifest (version, includes, config)
-        ├── skills/{skill}/
-        │   ├── SKILL.md            # Frontmatter + instructions
-        │   └── references/         # Optional context files
-        ├── commands/
-        │   └── {command}.md        # Frontmatter + instructions
-        └── agents/
-            └── {agent}.md          # Frontmatter + instructions
-```
+**Before creating a PR**, add a changeset describing the change:
 
-## Key Patterns
+```bash
+# Create .changeset/{name}.md manually (npx changeset is interactive)
+mkdir -p .changeset && cat > .changeset/descriptive-name.md << 'EOF'
+---
+"@orderful/droid": patch  # or minor/major
+---
+
+Brief description of the change
+EOF
+```
 
-- Tools are the user-facing abstraction over skills, commands, and agents
-- `TOOL.yaml` defines tool-level metadata and lists what's included (just names)
-- Each artifact (.md file) owns its metadata in YAML frontmatter
-- Skills use folders (can have `references/` subdir), commands/agents are flat files
-- Install targets: `~/.claude/skills/`, `~/.claude/commands/`, `~/.claude/agents/`
-- TUI uses Ink (React for CLI)
+- **patch**: Bug fixes, small improvements, internal refactors
+- **minor**: New features, new tools/skills/commands
+- **major**: Breaking changes

package/AGENTS.md

@@ -0,0 +1,75 @@
+# AGENTS.md
+
+Project instructions for AI coding assistants.
+
+## Overview
+
+Droid is a TUI dashboard for managing AI tools. Each tool bundles related skills, commands, and agents. Installs to Claude Code (`~/.claude/`) and OpenCode (`~/.config/opencode/`).
+
+## Quick Start
+
+```bash
+bun install          # Install dependencies
+bun run build        # Compile TypeScript and copy tools to dist/
+bun run dev          # Watch mode
+bun run test         # Run tests
+bun run lint         # Run ESLint
+bun run start        # Run the TUI (bun dist/bin/droid.js)
+```
+
+## Structure
+
+```
+src/
+├── bin/           # CLI entry point
+├── commands/      # CLI commands
+│   ├── tui.tsx    # Main TUI dashboard (Ink/React)
+│   └── tui/       # TUI components, views, hooks
+├── lib/           # Core logic (tools.ts, skills.ts, agents.ts, config.ts)
+└── tools/         # Bundled tools
+    └── {tool}/
+        ├── TOOL.yaml               # Tool manifest (version, includes, config)
+        ├── skills/{skill}/
+        │   ├── SKILL.md            # Frontmatter + instructions
+        │   └── references/         # Optional context files
+        ├── commands/
+        │   └── {command}.md        # Frontmatter + instructions
+        └── agents/
+            └── {agent}.md          # Frontmatter + instructions
+```
+
+## Key Patterns
+
+- Tools are the user-facing abstraction over skills, commands, and agents
+- `TOOL.yaml` defines tool-level metadata and lists what's included (just names)
+- Each artifact (.md file) owns its metadata in YAML frontmatter
+- Skills use folders (can have `references/` subdir), commands/agents are flat files
+- Install targets: `~/.claude/skills/`, `~/.claude/commands/`, `~/.claude/agents/`
+
+## UI Libraries
+
+We use **two** terminal UI libraries for different purposes:
+
+| Library | Purpose | Used In |
+|---------|---------|---------|
+| **Ink** | Full React-based TUI dashboard | `tui.tsx`, `tui/components/`, `tui/views/` |
+| **Inquirer** | Simple CLI prompts (select, confirm, input) | `skills.ts`, `setup.ts`, `skill-config.ts` |
+
+**Why both?**
+- **Ink** is for the interactive dashboard—stateful, component-based, keyboard navigation
+- **Inquirer** is for quick sequential prompts ("Which tool?", "Configure now? y/n")
+
+Don't consolidate them. Using Ink for simple prompts would be overkill.
+
+## Do Not Touch
+
+- `.env` files and secrets
+- `node_modules/`, `dist/`
+- User config files (`~/.droid/`)
+
+## Code Style
+
+- TypeScript strict mode
+- Prefer `const` over `let`
+- Use Canadian/British spelling (behaviour, colour, favourite)
+- Use "allow list/deny list" not "whitelist/blacklist"

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @orderful/droid
 
+## 0.16.1
+
+### Patch Changes
+
+- [#83](https://github.com/Orderful/droid/pull/83) [`023660a`](https://github.com/Orderful/droid/commit/023660a951ae1674989ae69d16b29e432a198300) Thanks [@frytyler](https://github.com/frytyler)! - Add AGENTS.md standard for cross-AI-tool compatibility
+
+  Introduces AGENTS.md at repo root with shared project instructions that work across Claude Code, Cursor, Copilot, and other AI coding assistants. CLAUDE.md now imports AGENTS.md and only contains Claude-specific instructions (git rules, changesets).
+
+- [#85](https://github.com/Orderful/droid/pull/85) [`d5a1637`](https://github.com/Orderful/droid/commit/d5a1637974805ffb35d93726ec56db4580c556b5) Thanks [@frytyler](https://github.com/frytyler)! - Fix ESM module resolution for npm global installs
+
+  Switches build from tsc to esbuild bundling. This fixes the ERR_MODULE_NOT_FOUND error when running droid after npm install -g, caused by Node ESM requiring explicit .js extensions that TypeScript doesn't add.
+
+## 0.16.0
+
+### Minor Changes
+
+- [#81](https://github.com/Orderful/droid/pull/81) [`b857210`](https://github.com/Orderful/droid/commit/b85721091cb85c95c8ef7fa878de3358ced7952f) Thanks [@frytyler](https://github.com/frytyler)! - Refactor TUI into modular component architecture
+  - Extract constants, types, and presentational components (Phase 1)
+  - Extract view components: WelcomeScreen, ToolUpdatePrompt, SetupScreen, ReadmeViewer (Phase 2)
+  - Extract hooks: useAppUpdate, useToolUpdates (Phase 3)
+  - Extract detail components: ToolItem, ToolDetails, SettingsDetails, ToolExplorer, SkillConfigScreen (Phase 4)
+  - Consolidate settings UX into single edit flow
+  - Add ESLint checking for .tsx files
+  - Remove unnecessary .js extensions from imports
+
 ## 0.15.0
 
 ### Minor Changes