@orderful/droid 0.10.0 → 0.10.2

package/dist/lib/quotes.js

@@ -0,0 +1,24 @@
+/**
+ * Star Wars themed quotes for the TUI welcome screen.
+ * Some hint at specific skills available in droid.
+ */
+export const quotes = [
+    "I'm probably the droid you are looking for.",
+    "These are the skills you're looking for.",
+    "I have a bad feeling about this, we might be too efficient.",
+    "May the source be with you.",
+    "The Force is strong with this one.",
+    "This is the way.",
+    "I'm fluent in over six million forms of communication. - `/comments`",
+    "Much to learn, you still have. - `/coach`",
+    "If into the archives you go, only knowledge will you find. - `/project`",
+];
+/**
+ * Get a random quote from the list.
+ * Uses a simple random selection - each launch gets a fresh quote.
+ */
+export function getRandomQuote() {
+    const index = Math.floor(Math.random() * quotes.length);
+    return quotes[index];
+}
+//# sourceMappingURL=quotes.js.map

package/dist/lib/quotes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quotes.js","sourceRoot":"","sources":["../../src/lib/quotes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,6CAA6C;IAC7C,0CAA0C;IAC1C,6DAA6D;IAC7D,6BAA6B;IAC7B,oCAAoC;IACpC,kBAAkB;IAClB,sEAAsE;IACtE,2CAA2C;IAC3C,yEAAyE;CAC1E,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/skills/brain/SKILL.md

@@ -38,12 +38,13 @@ Ideas develop through iteration, not single prompts.
 
 **IMPORTANT:** Before using any default paths, ALWAYS read `~/.droid/skills/brain/overrides.yaml` first. If `brain_dir` is configured there, use that path. Only fall back to defaults if the file doesn't exist or lacks a `brain_dir` setting.
 
-| Setting | Default | Description |
-|---------|---------|-------------|
-| `brain_dir` | (see below) | Where docs are stored |
-| `inbox_folder` | (empty) | Optional subfolder for new docs (omit for flat structure) |
+| Setting        | Default     | Description                                               |
+| -------------- | ----------- | --------------------------------------------------------- |
+| `brain_dir`    | (see below) | Where docs are stored                                     |
+| `inbox_folder` | (empty)     | Optional subfolder for new docs (omit for flat structure) |
 
 Default `brain_dir` by AI tool (only if not configured):
+
 - **claude-code**: `~/.claude/brain`
 - **opencode**: `~/.config/opencode/brain`
 
@@ -52,28 +53,42 @@ Default `brain_dir` by AI tool (only if not configured):
 **Active doc:** Opening or creating a brain doc makes it "active" for the session. Subsequent `/brain add` commands append to it without specifying a path.
 
 **Doc types:**
+
 - `plan` - Structured: Context → Exploration → Decision → Next Steps
 - `research` - Open-ended exploration of a topic
 - `review` - Code review, document review, or any evaluation task
 - `note` - Quick capture (fire-and-forget, doesn't become active)
 
-**Comment conventions:** Use `@droid` / `@{user}` markers for async back-and-forth. If droid's `comments` skill is installed, use `/comments check` for full support.
+**Comment conventions:** In markdown files, ALWAYS use blockquote `>` prefix for @mention comments:
+
+- `> @droid` - User leaves comment for AI to address
+- `> @{user}` - AI leaves comment for user to address
+
+Example conversation:
+
+```markdown
+> @droid Should we add caching here?
+
+> @fry Yes, Redis would work well for this use case.
+```
+
+Read user's configured mention from `~/.droid/config.yaml` → `user_mention` (e.g., `@fry`). If droid's `comments` skill is installed, use `/comments check` for full support.
 
 **Status lifecycle:** `exploring` → `drafting` → `decided` → `done`
 
 ## Commands
 
-| Command | Action |
-|---------|--------|
-| `/brain` | List recent docs or create new |
-| `/brain {topic}` | **Search** for existing doc (fuzzy match) → becomes active |
-| `/brain plan {topic}` | Create planning doc (requires `plan` keyword) |
-| `/brain research {topic}` | Create research doc (requires `research` keyword) |
-| `/brain review {topic}` | Create review doc (requires `review` keyword) |
-| `/brain note {text}` | Quick capture (standalone, doesn't become active) |
-| `/brain add {text}` | Append to active doc |
-| `/brain check` | Address @droid comments in active doc |
-| `/brain done` | Finalize active doc, update status |
+| Command                   | Action                                                     |
+| ------------------------- | ---------------------------------------------------------- |
+| `/brain`                  | List recent docs or create new                             |
+| `/brain {topic}`          | **Search** for existing doc (fuzzy match) → becomes active |
+| `/brain plan {topic}`     | Create planning doc (requires `plan` keyword)              |
+| `/brain research {topic}` | Create research doc (requires `research` keyword)          |
+| `/brain review {topic}`   | Create review doc (requires `review` keyword)              |
+| `/brain note {text}`      | Quick capture (standalone, doesn't become active)          |
+| `/brain add {text}`       | Append to active doc                                       |
+| `/brain check`            | Address @droid comments in active doc                      |
+| `/brain done`             | Finalize active doc, update status                         |
 
 **IMPORTANT:** The default action for `/brain {topic}` is to **SEARCH** for existing docs, NOT create. Only use `/brain plan {topic}` or `/brain research {topic}` when the user explicitly wants to create a new doc.
 
@@ -115,7 +130,7 @@ Full procedure: `references/workflows.md` § Adding
 
 **Trigger:** `/brain check`
 
-**TLDR:** Find `> @droid` comments in active doc, address each one.
+**TLDR:** Find `> @droid` comments in active doc, address each one with `> @{user_mention}` response (always use blockquote `>`).
 
 Full procedure: `references/workflows.md` § Checking
 
@@ -132,11 +147,18 @@ Full procedure: `references/workflows.md` § Finalizing
 Before creating or modifying brain docs, check if any `brain-*` extension skills are installed:
 
 ```
+# Claude Code
 ~/.claude/skills/brain-*/SKILL.md
+
+# OpenCode
+~/.config/opencode/skills/brain-*/SKILL.md
+
+# Shared (droid config)
 ~/.droid/skills/brain-*/SKILL.md
 ```
 
 If found (e.g., `brain-obsidian`), **ALWAYS** use the extension's templates, workflows, and configuration instead of this skill's defaults. Extensions may provide:
+
 - Alternative template formats (YAML frontmatter, wikilinks)
 - Folder organization (PARA structure)
 - Additional commands or integrations

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

@@ -42,6 +42,7 @@ $ARGUMENTS
 ## Behavior
 
 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

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

@@ -42,6 +42,7 @@ $ARGUMENTS
 ## Behavior
 
 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

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

@@ -20,12 +20,12 @@ Simple and portable. Works anywhere markdown is supported.
 
 ## Fields
 
-| Field | Required | Description |
-|-------|----------|-------------|
-| `Type` | Yes | Doc type: `plan`, `research`, `review`, or `note` |
-| `Status` | Yes (except notes) | Current lifecycle stage |
-| `Created` | Yes | Creation date |
-| `Updated` | No | Last modification date (add when doc changes) |
+| Field     | Required           | Description                                       |
+| --------- | ------------------ | ------------------------------------------------- |
+| `Type`    | Yes                | Doc type: `plan`, `research`, `review`, or `note` |
+| `Status`  | Yes (except notes) | Current lifecycle stage                           |
+| `Created` | Yes                | Creation date                                     |
+| `Updated` | No                 | Last modification date (add when doc changes)     |
 
 ## Status Lifecycle
 
@@ -37,13 +37,13 @@ exploring → drafting → decided → done
 
 ### Status Definitions
 
-| Status | Meaning | Typical Actions |
-|--------|---------|-----------------|
-| `exploring` | Initial discovery, gathering information | Research, ask questions, explore options |
-| `drafting` | Forming opinions, narrowing options | Document trade-offs, propose approaches |
-| `decided` | Decision made, ready to act | Document decision rationale, plan implementation |
-| `done` | Work complete, doc is reference material | Archive or link from project |
-| `stale` | Abandoned or outdated | Review for archival or deletion |
+| Status      | Meaning                                  | Typical Actions                                  |
+| ----------- | ---------------------------------------- | ------------------------------------------------ |
+| `exploring` | Initial discovery, gathering information | Research, ask questions, explore options         |
+| `drafting`  | Forming opinions, narrowing options      | Document trade-offs, propose approaches          |
+| `decided`   | Decision made, ready to act              | Document decision rationale, plan implementation |
+| `done`      | Work complete, doc is reference material | Archive or link from project                     |
+| `stale`     | Abandoned or outdated                    | Review for archival or deletion                  |
 
 ### Transitions
 
@@ -55,5 +55,6 @@ exploring → drafting → decided → done
 ## Updating Metadata
 
 When modifying a doc:
+
 1. Add or update the `Updated` field to current date
 2. Update `Status` if the work has progressed

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

@@ -10,10 +10,10 @@ Conventions for naming brain docs.
 
 ## Components
 
-| Component | Description | Examples |
-|-----------|-------------|----------|
-| `{type}` | Doc type: `plan`, `research`, `note` | `plan`, `research`, `note` |
-| `{topic-slug}` | Lowercase, hyphen-separated topic | `auth-refactor`, `caching-strategies` |
+| Component      | Description                          | Examples                              |
+| -------------- | ------------------------------------ | ------------------------------------- |
+| `{type}`       | Doc type: `plan`, `research`, `note` | `plan`, `research`, `note`            |
+| `{topic-slug}` | Lowercase, hyphen-separated topic    | `auth-refactor`, `caching-strategies` |
 
 ## Slug Rules
 
@@ -25,16 +25,17 @@ 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                                        | 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` |
 
 ## Notes
 
 For notes, include the date in the filename:
+
 ```
 note-{YYYYMMDD}-{slug}.md
 ```
@@ -44,5 +45,6 @@ This prevents collisions and allows chronological sorting.
 ## 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`

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

@@ -94,9 +94,9 @@ Overall assessment.
 
 ## Template Variables
 
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `{Topic}` | Doc title from user input | "Auth Refactor" |
-| `{date}` | Current date (YYYY-MM-DD) | "2025-01-15" |
+| 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" |
-| `{content}` | User-provided text | (for notes) |
+| `{content}`           | User-provided text        | (for notes)                             |

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

@@ -13,9 +13,11 @@ Detailed procedures for each brain operation.
    - Use `brain_dir` if configured, otherwise use default for current AI tool
 
 2. **Search for matches**
+
    ```
    Glob: {brain_dir}/**/*{topic}*.md
    ```
+
    Fuzzy match the topic against doc filenames
 
 3. **Handle results:**
@@ -59,11 +61,16 @@ Detailed procedures for each brain operation.
    - Any constraints or requirements mentioned?
    - Related work or prior decisions?
 
-7. **Write the doc** with template structure and initial context
+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
 
-8. **Set as active doc**
+8. **Write the doc** with template structure and initial context
 
-9. **Confirm creation** and summarize what was captured
+9. **Set as active doc**
+
+10. **Confirm creation** and summarize what was captured
 
 ## Notes
 
@@ -105,8 +112,8 @@ Detailed procedures for each brain operation.
 2. **Read current content** of active doc
 
 3. **Append new section:**
-   ```markdown
 
+   ```markdown
    ---
 
    ## Update ({date})
@@ -139,8 +146,9 @@ Detailed procedures for each brain operation.
 4. **For each comment:**
    - Show the comment and surrounding context
    - Address the question/request
-   - Add response as `> @{user_mention}` reply
-   - Or resolve inline if it was a simple note
+   - 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
 
 5. **Update the doc** with responses
 
@@ -182,9 +190,11 @@ Detailed procedures for each brain operation.
    - Use `brain_dir` if configured, otherwise use default for current AI tool
 
 2. **Find recent docs:**
+
    ```
    Glob: {brain_dir}/**/*.md
    ```
+
    Sort by modification time, limit to 10-15
 
 3. **Present list** with:

package/dist/skills/comments/SKILL.md

@@ -98,8 +98,8 @@ user_mention: "@fry"
 # Additional AI mentions to recognize (e.g., if you're used to @claude)
 ai_mentions: "@claude"
 
-# Keep comments after addressing them (default: false)
-preserve_comments: false
+# Keep comments after addressing them (default: true)
+preserve_comments: true
 ```
 
 ## File Type Support

package/dist/skills/comments/SKILL.yaml

@@ -15,7 +15,7 @@ config_schema:
   preserve_comments:
     type: boolean
     description: Keep original comments after addressing (vs removing them)
-    default: false
+    default: true
 examples:
   - title: "Action request"
     code: |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {

package/src/bin/droid.ts

@@ -14,7 +14,7 @@ const version = getVersion();
 
 program
   .name('droid')
-  .description('AI workflow toolkit - teaching your droid new tricks')
+  .description('Droid, teaching your AI new tricks')
   .version(version);
 
 program

package/src/commands/install.ts

@@ -34,7 +34,11 @@ export async function installCommand(skillName: string): Promise<void> {
     // Check if skill has configurable options
     const manifest = loadSkillManifest(join(getBundledSkillsDir(), skillName));
     if (manifest?.config_schema && Object.keys(manifest.config_schema).length > 0) {
-      await promptForSkillConfig(skillName, manifest.config_schema, true);
+      // If any config option lacks a default, go straight to config (it's required)
+      const hasRequiredConfig = Object.values(manifest.config_schema).some(
+        (option) => option.default === undefined
+      );
+      await promptForSkillConfig(skillName, manifest.config_schema, !hasRequiredConfig);
     }
 
     // Show next steps

package/src/commands/skills.ts

@@ -127,7 +127,11 @@ export async function skillsCommand(): Promise<void> {
         // Prompt for config if skill has options
         const manifest = loadSkillManifest(join(getBundledSkillsDir(), skill.name));
         if (manifest?.config_schema && Object.keys(manifest.config_schema).length > 0) {
-          await promptForSkillConfig(skill.name, manifest.config_schema, true);
+          // If any config option lacks a default, go straight to config (it's required)
+          const hasRequiredConfig = Object.values(manifest.config_schema).some(
+            (option) => option.default === undefined
+          );
+          await promptForSkillConfig(skill.name, manifest.config_schema, !hasRequiredConfig);
         }
       } else {
         console.log(chalk.red(`\n✗ ${result.message}`));

package/src/commands/tui.tsx

@@ -19,6 +19,7 @@ import { configExists, loadConfig, saveConfig, loadSkillOverrides, saveSkillOver
 import { configureAIToolPermissions } from './setup.js';
 import { AITool, BuiltInOutput, ConfigOptionType, type DroidConfig, type OutputPreference, type SkillManifest, type ConfigOption, type SkillOverrides } from '../lib/types.js';
 import { getVersion, getUpdateInfo, runUpdate, type UpdateInfo } from '../lib/version.js';
+import { getRandomQuote } from '../lib/quotes.js';
 
 type Tab = 'skills' | 'commands' | 'agents' | 'settings';
 type View = 'welcome' | 'setup' | 'menu' | 'detail' | 'configure' | 'readme';
@@ -100,20 +101,28 @@ function getCommandsFromSkills(): Command[] {
   return commands;
 }
 
-function detectAITool(): AITool | null {
+function detectInstalledAITools(): Set<AITool> {
+  const installed = new Set<AITool>();
   try {
     execSync('claude --version', { stdio: 'ignore' });
-    return AITool.ClaudeCode;
+    installed.add(AITool.ClaudeCode);
   } catch {
     // Claude Code not found
   }
   try {
     execSync('opencode --version', { stdio: 'ignore' });
-    return AITool.OpenCode;
+    installed.add(AITool.OpenCode);
   } catch {
     // OpenCode not found
   }
-  return null;
+  return installed;
+}
+
+function getDefaultAITool(): AITool {
+  const installed = detectInstalledAITools();
+  if (installed.has(AITool.ClaudeCode)) return AITool.ClaudeCode;
+  if (installed.has(AITool.OpenCode)) return AITool.OpenCode;
+  return AITool.ClaudeCode;
 }
 
 function getOutputOptions(): Array<{ label: string; value: OutputPreference }> {
@@ -183,12 +192,14 @@ function findAgentSourcePath(agentName: string): string | null {
 interface WelcomeScreenProps {
   onContinue: () => void;
   onUpdate: () => void;
+  onExit: () => void;
   updateInfo: UpdateInfo;
   isUpdating: boolean;
 }
 
-function WelcomeScreen({ onContinue, onUpdate, updateInfo, isUpdating }: WelcomeScreenProps) {
+function WelcomeScreen({ onContinue, onUpdate, onExit, updateInfo, isUpdating }: WelcomeScreenProps) {
   const [selectedButton, setSelectedButton] = useState(0);
+  const welcomeQuote = useMemo(() => getRandomQuote(), []);
 
   useInput((input, key) => {
     if (isUpdating) return;
@@ -205,12 +216,15 @@ function WelcomeScreen({ onContinue, onUpdate, updateInfo, isUpdating }: Welcome
         }
       }
       if (input === 'q') {
-        onContinue();
+        onExit();
       }
     } else {
-      if (key.return || input === 'q') {
+      if (key.return) {
         onContinue();
       }
+      if (input === 'q') {
+        onExit();
+      }
     }
   });
 
@@ -238,7 +252,7 @@ function WelcomeScreen({ onContinue, onUpdate, updateInfo, isUpdating }: Welcome
             <Text color={colors.textDim}> </Text>
             <Text color={hasUpdate ? '#eab308' : colors.primary}>●</Text>
             <Text color={colors.textDim}> ║    </Text>
-            <Text color={colors.textMuted}>Teaching your droid new tricks</Text>
+            <Text color={colors.textMuted}>Droid, teaching your AI new tricks</Text>
           </Text>
           <Text>
             <Text color={colors.textDim}>╚═╦═╦═╝    </Text>
@@ -293,7 +307,7 @@ function WelcomeScreen({ onContinue, onUpdate, updateInfo, isUpdating }: Welcome
           <>
             <Box marginTop={2} marginBottom={1}>
               <Text backgroundColor={colors.primary} color="#ffffff" bold>
-                {' '}I'm probably the droid you are looking for.{' '}
+                {` ${welcomeQuote} `}
               </Text>
             </Box>
 
@@ -314,7 +328,7 @@ interface SetupScreenProps {
 function SetupScreen({ onComplete, onSkip, initialConfig }: SetupScreenProps) {
   const [step, setStep] = useState<SetupStep>('ai_tool');
   const [aiTool, setAITool] = useState<AITool>(
-    initialConfig?.ai_tool || detectAITool() || AITool.ClaudeCode
+    initialConfig?.ai_tool || getDefaultAITool()
   );
   const [userMention, setUserMention] = useState(initialConfig?.user_mention || '@user');
   const [outputPreference, setOutputPreference] = useState<OutputPreference>(
@@ -323,6 +337,8 @@ function SetupScreen({ onComplete, onSkip, initialConfig }: SetupScreenProps) {
   const [selectedIndex, setSelectedIndex] = useState(0);
   const [error, setError] = useState<string | null>(null);
 
+  // Cache detection results once on mount (avoids re-running execSync on every render)
+  const installedTools = useMemo(() => detectInstalledAITools(), []);
   const aiToolOptions = useMemo(() => [
     { label: 'Claude Code', value: AITool.ClaudeCode },
     { label: 'OpenCode', value: AITool.OpenCode },
@@ -418,7 +434,7 @@ function SetupScreen({ onComplete, onSkip, initialConfig }: SetupScreenProps) {
             <Text key={option.value}>
               <Text color={colors.textDim}>{index === selectedIndex ? '>' : ' '} </Text>
               <Text color={index === selectedIndex ? colors.text : colors.textMuted}>{option.label}</Text>
-              {option.value === detectAITool() && <Text color={colors.success}> (detected)</Text>}
+              {installedTools.has(option.value) && <Text color={colors.success}> (detected)</Text>}
             </Text>
           ))}
         </Box>
@@ -1358,7 +1374,8 @@ function App() {
     setTimeout(() => {
       const result = runUpdate();
       if (result.success) {
-        // Exit and let user restart with new version
+        // Print success message before exiting
+        console.log('\n✅ Update complete! Run `droid` to start the new version.\n');
         exit();
       } else {
         setIsUpdating(false);
@@ -1521,8 +1538,18 @@ function App() {
               type: result.success ? 'success' : 'error',
             });
             if (result.success) {
-              setView('menu');
-              setSelectedAction(0);
+              // Check if skill has required config (options without defaults)
+              const configSchema = skill.config_schema || {};
+              const hasRequiredConfig = Object.values(configSchema).some(
+                (option) => (option as ConfigOption).default === undefined
+              );
+              if (hasRequiredConfig) {
+                // Go to configure view for required setup
+                setView('configure');
+              } else {
+                setView('menu');
+                setSelectedAction(0);
+              }
             }
           }
         }
@@ -1595,6 +1622,7 @@ function App() {
         updateInfo={updateInfo}
         isUpdating={isUpdating}
         onUpdate={handleUpdate}
+        onExit={exit}
         onContinue={() => {
           // If no config exists, show setup first
           if (!configExists()) {

package/src/lib/quotes.ts

@@ -0,0 +1,24 @@
+/**
+ * Star Wars themed quotes for the TUI welcome screen.
+ * Some hint at specific skills available in droid.
+ */
+export const quotes = [
+  "I'm probably the droid you are looking for.",
+  "These are the skills you're looking for.",
+  "I have a bad feeling about this, we might be too efficient.",
+  "May the source be with you.",
+  "The Force is strong with this one.",
+  "This is the way.",
+  "I'm fluent in over six million forms of communication. - `/comments`",
+  "Much to learn, you still have. - `/coach`",
+  "If into the archives you go, only knowledge will you find. - `/project`",
+];
+
+/**
+ * Get a random quote from the list.
+ * Uses a simple random selection - each launch gets a fresh quote.
+ */
+export function getRandomQuote(): string {
+  const index = Math.floor(Math.random() * quotes.length);
+  return quotes[index];
+}