@dezkareid/osddt 1.10.1 → 1.11.1

package/AGENTS.md

@@ -82,7 +82,6 @@ Always prefer use exact versions for dependencies. Do not use `^` or `~`.
 
 #### Linting & Formatting
 - **ESLint**: `9.39.2`
-- **Prettier**: `3.8.1`
 
 #### Type Definitions
 - **@types/node**: `25.0.10`
@@ -112,7 +111,8 @@ osddt/
 │   │   ├── claude.ts              # Formats COMMAND_DEFINITIONS as Markdown (.claude/commands/osddt.<name>.md)
 │   │   └── gemini.ts              # Formats COMMAND_DEFINITIONS as TOML (.gemini/commands/osddt.<name>.toml)
 │   └── utils/
-│       └── prompt.ts              # Inquirer prompts: askAgents() (checkbox) and askRepoType() (select)
+│       ├── prompt.ts              # Inquirer prompts: askAgents() (checkbox), askRepoType() (select), askWorktreeUrl() (input)
+│       └── worktree.ts            # Shared worktree helpers: git version check, not-a-worktree check, writable check, state file init
 ├── dist/                          # Compiled output (single ESM bundle, gitignored)
 ├── rollup.config.js               # Bundles src/index.ts → dist/index.js (ESM, shebang injected)
 ├── tsconfig.json                  # TypeScript config
@@ -126,7 +126,7 @@ osddt/
 #### Key relationships
 
 - **`shared.ts` is the single source of truth** for all command template content. Both `claude.ts` and `gemini.ts` import `COMMAND_DEFINITIONS` from it and only differ in file format (Markdown vs TOML) and argument placeholder (`$ARGUMENTS` vs `{{args}}`).
-- **`setup.ts`** orchestrates setup: reads `--agents`/`--repo-type` flags when provided (non-interactive), otherwise calls `askAgents()` → `askRepoType()` → writes selected agent files → writes `.osddtrc`.
+- **`setup.ts`** orchestrates setup: reads `--agents`/`--repo-type`/`--worktree-repository` flags when provided (non-interactive), otherwise calls `askAgents()` → `askRepoType()` → `askWorktreeUrl()` → if URL provided, runs worktree environment checks via `worktree.ts` → writes selected agent files → writes `.osddtrc`.
 - **`meta-info.ts`** is referenced inside the generated templates so agents can fetch live branch/date at invocation time (not baked in at build time).
 - **Test files** (`.spec.ts`) live next to the source file they cover. Template tests are pure (no mocks); command tests mock `fs-extra` and `child_process`.
 
@@ -147,18 +147,28 @@ The selected agents are saved in `.osddtrc` alongside `repoType`. When `osddt up
 
 #### Available commands
 
-| Command                                                              | Context       | Description                                                   |
-| -------------------------------------------------------------------- | ------------- | ------------------------------------------------------------- |
-| `osddt setup`                                                        | Local dev     | Generate agent command files for Claude and Gemini            |
-| `osddt setup --agents <list> --repo-type <type>`                     | Local dev     | Non-interactive setup (for CI/scripted environments)          |
-| `npx @dezkareid/osddt setup`                                         | External      | Generate agent command files for Claude and Gemini            |
-| `npx @dezkareid/osddt setup --agents <list> --repo-type <type>`      | External      | Non-interactive setup (for CI/scripted environments)          |
-| `osddt meta-info`                                                    | Local dev     | Output current branch and date as JSON                        |
-| `npx @dezkareid/osddt meta-info`                                     | External      | Output current branch and date as JSON                        |
-| `osddt done <feature-name> --dir <project-path>`                     | Local dev     | Move `working-on/<feature>` to `done/<feature>`               |
-| `npx @dezkareid/osddt done <feature-name> --dir <project-path>`      | External      | Move `working-on/<feature>` to `done/<feature>`               |
-| `osddt update`                                                       | Local dev     | Regenerate agent command files from the existing `.osddtrc`   |
-| `npx @dezkareid/osddt update`                                        | External      | Regenerate agent command files from the existing `.osddtrc`   |
+| Command                                                                                        | Context       | Description                                                   |
+| ---------------------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------- |
+| `osddt setup`                                                                                  | Local dev     | Generate agent command files for Claude and Gemini            |
+| `osddt setup --agents <list> --repo-type <type>`                                               | Local dev     | Non-interactive setup (for CI/scripted environments)          |
+| `osddt setup --worktree-repository <url>`                                                      | Local dev     | Setup with worktree workflow enabled                          |
+| `npx @dezkareid/osddt setup`                                                                   | External      | Generate agent command files for Claude and Gemini            |
+| `npx @dezkareid/osddt setup --agents <list> --repo-type <type>`                                | External      | Non-interactive setup (for CI/scripted environments)          |
+| `npx @dezkareid/osddt setup --worktree-repository <url>`                                       | External      | Setup with worktree workflow enabled                          |
+| `osddt meta-info`                                                                              | Local dev     | Output current branch and date as JSON                        |
+| `npx @dezkareid/osddt meta-info`                                                               | External      | Output current branch and date as JSON                        |
+| `osddt done <feature-name> --dir <project-path>`                                               | Local dev     | Move `working-on/<feature>` to `done/<feature>`               |
+| `npx @dezkareid/osddt done <feature-name> --dir <project-path>`                                | External      | Move `working-on/<feature>` to `done/<feature>`               |
+| `osddt done <feature-name> --dir <project-path> --worktree`                                    | Local dev     | Archive feature, remove git worktree, and clean state file    |
+| `npx @dezkareid/osddt done <feature-name> --dir <project-path> --worktree`                     | External      | Archive feature, remove git worktree, and clean state file    |
+| `osddt update`                                                                                 | Local dev     | Regenerate agent command files from the existing `.osddtrc`   |
+| `npx @dezkareid/osddt update`                                                                  | External      | Regenerate agent command files from the existing `.osddtrc`   |
+| `osddt start-worktree <feature-name>`                                                          | Local dev     | Create a git worktree for a feature and scaffold working-on/  |
+| `npx @dezkareid/osddt start-worktree <feature-name>`                                           | External      | Create a git worktree for a feature and scaffold working-on/  |
+| `osddt start-worktree <feature-name> --dir <package-path>`                                     | Local dev     | Same, specifying the package path in a monorepo               |
+| `npx @dezkareid/osddt start-worktree <feature-name> --dir <package-path>`                      | External      | Same, specifying the package path in a monorepo               |
+| `osddt worktree-info <feature-name>`                                                           | Local dev     | Look up worktree paths for a feature (JSON output)            |
+| `npx @dezkareid/osddt worktree-info <feature-name>`                                            | External      | Look up worktree paths for a feature (JSON output)            |
 
 #### `osddt setup` options
 
@@ -166,26 +176,27 @@ The selected agents are saved in `.osddtrc` alongside `repoType`. When `osddt up
 | ---- | ------ | ----------- |
 | `--agents <list>` | `claude`, `gemini` (comma-separated) | Skip the agents prompt and use the provided value(s) |
 | `--repo-type <type>` | `single`, `monorepo` | Skip the repo type prompt and use the provided value |
+| `--worktree-repository <url>` | any git URL | Enable worktree workflow; saves URL as `"worktree-repository"` in `.osddtrc` |
 | `-d, --dir <directory>` | any path | Target directory (defaults to current working directory) |
 
-Both flags are optional. Providing neither runs the fully interactive mode. Providing both skips all prompts.
+All flags are optional. Providing neither runs the fully interactive mode. When `--worktree-repository` is provided, environment checks run and `.osddt-worktrees` is initialised.
 
 ### Command Templates
 
 Templates are generated by `npx @dezkareid/osddt setup` and placed in each agent's commands directory. Each template corresponds to a step in the spec-driven workflow.
 
-| Template           | Description                                                        |
-| ------------------ | ------------------------------------------------------------------ |
-| `osddt.continue`   | Detect the current workflow phase and prompt the next command      |
-| `osddt.research`   | Research a topic and write a research file to inform the spec      |
-| `osddt.start`      | Start a new feature by creating a branch and working-on folder     |
-| `osddt.spec`       | Analyze requirements and write a feature specification             |
-| `osddt.clarify`    | Resolve open questions in the spec and record decisions (optional) |
-| `osddt.plan`       | Create a technical implementation plan from a specification        |
-| `osddt.tasks`      | Generate actionable tasks from an implementation plan              |
-| `osddt.implement`  | Execute tasks from the task list one by one                        |
-| `osddt.fast`       | Bootstrap all planning artifacts (spec, plan, tasks) in one shot   |
-| `osddt.done`       | Resolve project path, verify tasks, and move the feature to done   |
+| Template         | Description                                                                              |
+| ---------------- | ---------------------------------------------------------------------------------------- |
+| `osddt.continue` | Detect the current workflow phase and prompt the next command                            |
+| `osddt.research` | Research a topic and write a research file to inform the spec                            |
+| `osddt.start`    | Start a new feature — uses standard or worktree workflow based on `.osddtrc`             |
+| `osddt.spec`     | Analyze requirements and write a feature specification                                   |
+| `osddt.clarify`  | Resolve open questions in the spec and record decisions (optional)                       |
+| `osddt.plan`     | Create a technical implementation plan from a specification                              |
+| `osddt.tasks`    | Generate actionable tasks from an implementation plan                                    |
+| `osddt.implement`| Execute tasks from the task list one by one                                              |
+| `osddt.fast`     | Bootstrap all planning artifacts (spec, plan, tasks) in one shot                         |
+| `osddt.done`     | Resolve project path, verify tasks, and move the feature to done                         |
 
 #### Template Workflow
 
@@ -249,6 +260,33 @@ Templates are generated by `npx @dezkareid/osddt setup` and placed in each agent
 /osddt.done
 ```
 
+##### Example D — Parallel feature workflow (git worktree)
+
+Enable worktree mode once during setup by providing the repository URL:
+
+```bash
+npx @dezkareid/osddt setup --agents claude --repo-type single --worktree-repository https://github.com/org/repo.git
+```
+
+From that point on, `/osddt.start` automatically uses the worktree workflow:
+
+```
+/osddt.start add-payment-gateway
+/osddt.spec
+/osddt.plan use Stripe SDK, REST endpoints
+/osddt.tasks
+/osddt.implement
+/osddt.done
+```
+
+The worktree is created as a sibling of the repo root (e.g. `../my-repo-add-payment-gateway`). Active worktrees are tracked in `.osddt-worktrees` (sibling to the repo root) — a JSON array with entries containing `featureName`, `branch`, `worktreePath`, `workingDir`, and `repoRoot`. `osddt.continue` and `osddt.done` read this file to resolve the correct paths. When `osddt.done` runs, it archives the planning folder **and** removes the worktree automatically.
+
+You can customise the worktree base directory via `worktreeBase` in `.osddtrc`:
+
+```json
+{ "repoType": "single", "worktree-repository": "https://github.com/org/repo.git", "worktreeBase": "/Users/me/worktrees" }
+```
+
 ---
 
 - Use **`osddt.research`** when you want to explore the codebase and gather findings before writing the spec. It creates the `working-on/<feature-name>/` folder and writes `osddt.research.md`.
@@ -276,13 +314,16 @@ Templates are generated by `npx @dezkareid/osddt setup` and placed in each agent
 
 - **Input**: Either a human-readable feature description (e.g. `"Add user authentication"`) or an existing branch name (e.g. `feat/add-user-auth`).
 - **Branch name resolution**: input is used as-is if it looks like a branch name; otherwise a name is derived (lowercased, hyphens, prefixed with `feat/`), subject to the 30-character feature name limit.
-- **Actions performed by the agent**:
+- **Workflow mode**: determined by reading `.osddtrc`. If `"worktree-repository"` is present, the worktree workflow is used; otherwise the standard branch workflow is used. The user is never prompted to choose.
+- **Standard workflow** (no `"worktree-repository"` in `.osddtrc`):
   1. Checks for an existing branch — offers **Resume** (`git checkout`) or **Abort** if found, otherwise runs `git checkout -b <branch-name>`.
-  2. Reads `.osddtrc` to resolve the project path (single vs monorepo).
-  3. Checks for an existing `working-on/<feature-name>/` folder — offers **Resume** or **Abort** if found, otherwise creates it.
-  4. Reports the branch and working directory, then shows a context-aware next step:
-     - If input was a **human-readable description**: informs the user their description will be used as the starting point for the spec and suggests running `/osddt.spec` (with an optional-context note).
-     - If input was a **branch name** (or no arguments): prompts the user to run `/osddt.spec` with an optional-context note.
+  2. Checks for an existing `working-on/<feature-name>/` folder — offers **Resume** or **Abort** if found, otherwise creates it.
+  3. Reports the branch and working directory.
+- **Worktree workflow** (`"worktree-repository"` present in `.osddtrc`):
+  1. Derives the branch and feature name.
+  2. Runs `npx @dezkareid/osddt start-worktree <feature-name> [--dir <package-path>]`.
+  3. Navigates into the created worktree directory to locate the project root.
+  4. Reports the branch, worktree path, project root, and working directory.
 
 #### osddt.research behaviour
 
@@ -311,7 +352,9 @@ Templates are generated by `npx @dezkareid/osddt setup` and placed in each agent
   1. Reads `.osddtrc` to resolve the project path (single vs monorepo). For monorepos, asks the user which package.
   2. Lists all folders under `working-on/`. If there is only one, uses it automatically; if there are multiple, asks the user to pick one.
   3. Confirms all tasks in `osddt.tasks.md` are checked off (`- [x]`).
-  4. Runs `npx @dezkareid/osddt done <feature-name> --dir <project-path>` to move the folder.
+  4. Runs `npx @dezkareid/osddt worktree-info <feature-name>` to check if this is a worktree feature.
+     - If found: runs `npx @dezkareid/osddt done <feature-name> --dir <project-path> --worktree` (archives folder, removes worktree, cleans state file).
+     - If not found: runs `npx @dezkareid/osddt done <feature-name> --dir <project-path>` (existing behaviour).
 
 Note: the `osddt done` CLI command does **not** read `.osddtrc` — project path resolution is the agent's responsibility, handled in step 1 above.
 

package/README.md

@@ -3,13 +3,18 @@ Other spec driven development tool but for monorepo
 
 ## CLI Commands
 
-| Command                                                              | Description                                                   |
-| -------------------------------------------------------------------- | ------------------------------------------------------------- |
-| `@dezkareid/osddt setup`                                             | Generate agent command files for Claude and Gemini            |
-| `@dezkareid/osddt setup --agents <list> --repo-type <type>`          | Non-interactive setup (for CI/scripted environments)          |
-| `@dezkareid/osddt meta-info`                                         | Output current branch and date as JSON                        |
-| `@dezkareid/osddt done <feature-name> --dir <project-path>`          | Move `working-on/<feature>` to `done/<feature>`               |
-| `@dezkareid/osddt update`                                            | Regenerate agent command files from the existing `.osddtrc`   |
+| Command                                                                          | Description                                                   |
+| -------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| `@dezkareid/osddt setup`                                                         | Generate agent command files for Claude and Gemini            |
+| `@dezkareid/osddt setup --agents <list> --repo-type <type>`                      | Non-interactive setup (for CI/scripted environments)          |
+| `@dezkareid/osddt setup --worktree-repository <url>`                             | Setup with worktree workflow enabled                          |
+| `@dezkareid/osddt meta-info`                                                     | Output current branch and date as JSON                        |
+| `@dezkareid/osddt done <feature-name> --dir <project-path>`                      | Move `working-on/<feature>` to `done/<feature>`               |
+| `@dezkareid/osddt done <feature-name> --dir <project-path> --worktree`           | Archive feature, remove git worktree, and clean state file    |
+| `@dezkareid/osddt update`                                                        | Regenerate agent command files from the existing `.osddtrc`   |
+| `@dezkareid/osddt start-worktree <feature-name>`                                 | Create a git worktree for a feature and scaffold working-on/  |
+| `@dezkareid/osddt start-worktree <feature-name> --dir <package-path>`            | Same, specifying the package path in a monorepo               |
+| `@dezkareid/osddt worktree-info <feature-name>`                                  | Look up worktree paths for a feature (JSON output)            |
 
 ### `osddt setup` options
 
@@ -17,11 +22,20 @@ Other spec driven development tool but for monorepo
 | ---- | ------ | ----------- |
 | `--agents <list>` | `claude`, `gemini` (comma-separated) | Skip the agents prompt and use the provided value(s) |
 | `--repo-type <type>` | `single`, `monorepo` | Skip the repo type prompt and use the provided value |
+| `--worktree-repository <url>` | any git URL | Enable worktree workflow and save the repository URL |
 | `-d, --dir <directory>` | any path | Target directory (defaults to current working directory) |
 
-Both flags are optional. Providing neither runs the fully interactive mode. Providing both skips all prompts.
+All flags are optional. Providing neither runs the fully interactive mode. Providing `--agents` and `--repo-type` together skips all standard prompts. Adding `--worktree-repository` also runs environment checks and initialises the worktree state file.
 
-The selected agents are saved in `.osddtrc` alongside `repoType` so that `osddt update` can regenerate the correct files without prompting.
+The selected agents and config are saved in `.osddtrc` so that `osddt update` can regenerate the correct files without prompting.
+
+```json
+// Standard mode
+{ "repoType": "single", "agents": ["claude"] }
+
+// Worktree mode — the "worktree-repository" field enables the worktree workflow
+{ "repoType": "single", "agents": ["claude"], "worktree-repository": "https://github.com/org/repo.git" }
+```
 
 ```bash
 # Interactive (default)
@@ -106,6 +120,41 @@ flowchart LR
 
 > Review the `## Assumptions` section of `osddt.plan.md` before implementing. Run `/osddt.clarify` if any Open Questions in the spec need resolving first.
 
+#### Parallel feature workflow (git worktree)
+
+Enable worktree mode by providing the repository URL during setup:
+
+```bash
+npx @dezkareid/osddt setup --agents claude --repo-type single --worktree-repository https://github.com/org/repo.git
+```
+
+This saves `"worktree-repository"` in `.osddtrc`, runs environment checks, and initialises the `.osddt-worktrees` state file. From that point on, `/osddt.start` automatically uses the worktree workflow:
+
+```
+/osddt.start add-payment-gateway
+/osddt.spec
+/osddt.plan use Stripe SDK, REST endpoints
+/osddt.tasks
+/osddt.implement
+/osddt.done
+```
+
+The worktree is created as a sibling of your repo (e.g. `../my-repo-add-payment-gateway`). The `working-on/` planning folder lives inside the worktree alongside the code. When `osddt.done` runs, it archives the planning folder **and** removes the worktree automatically.
+
+You can customise the worktree base directory by adding `worktreeBase` to `.osddtrc`:
+
+```json
+{
+  "repoType": "single",
+  "worktree-repository": "https://github.com/org/repo.git",
+  "worktreeBase": "/Users/me/worktrees"
+}
+```
+
+Active worktrees are tracked in `.osddt-worktrees` (sibling to the repo root), a JSON array with entries containing `featureName`, `branch`, `worktreePath`, `workingDir`, and `repoRoot`. This file is the single source of truth used by `osddt.continue` and `osddt.done` to resolve the correct paths.
+
+> **Migration note**: If you previously used `osddt setup-worktree` or `/osddt.start-worktree`, those commands have been removed. Re-run `osddt setup --worktree-repository <url>` to configure the new unified workflow. Manually delete any `osddt.start-worktree.*` files from your agent command directories — `osddt update` will not regenerate them.
+
 #### Resuming after closing a session
 
 ```
@@ -118,18 +167,18 @@ flowchart LR
 /osddt.done
 ```
 
-| Template           | Description                                                        |
-| ------------------ | ------------------------------------------------------------------ |
-| `osddt.continue`   | Detect the current workflow phase and prompt the next command      |
-| `osddt.research`   | Research a topic and write a research file to inform the spec      |
-| `osddt.start`      | Start a new feature by creating a branch and working-on folder     |
-| `osddt.spec`       | Analyze requirements and write a feature specification             |
-| `osddt.clarify`    | Resolve open questions in the spec and record decisions (optional) |
-| `osddt.plan`       | Create a technical implementation plan from a specification        |
-| `osddt.tasks`      | Generate actionable tasks from an implementation plan              |
-| `osddt.implement`  | Execute tasks from the task list one by one                        |
-| `osddt.fast`       | Bootstrap all planning artifacts (spec, plan, tasks) in one shot   |
-| `osddt.done`       | Resolve project path, verify tasks, and move the feature to done   |
+| Template         | Description                                                        |
+| ---------------- | ------------------------------------------------------------------ |
+| `osddt.continue` | Detect the current workflow phase and prompt the next command      |
+| `osddt.research` | Research a topic and write a research file to inform the spec      |
+| `osddt.start`    | Start a new feature — uses standard or worktree workflow based on `.osddtrc` |
+| `osddt.spec`     | Analyze requirements and write a feature specification             |
+| `osddt.clarify`  | Resolve open questions in the spec and record decisions (optional) |
+| `osddt.plan`     | Create a technical implementation plan from a specification        |
+| `osddt.tasks`    | Generate actionable tasks from an implementation plan              |
+| `osddt.implement`| Execute tasks from the task list one by one                        |
+| `osddt.fast`     | Bootstrap all planning artifacts (spec, plan, tasks) in one shot   |
+| `osddt.done`     | Resolve project path, verify tasks, and move the feature to done   |
 
 Generated files are placed in:
 

package/dist/commands/start-worktree.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+export interface WorktreeEntry {
+    featureName: string;
+    branch: string;
+    worktreePath: string;
+    workingDir: string;
+    repoRoot: string;
+}
+export declare function startWorktreeCommand(): Command;

package/dist/commands/worktree-info.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function worktreeInfoCommand(): Command;

package/dist/index.js

@@ -5,7 +5,9 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 import select from '@inquirer/select';
 import checkbox from '@inquirer/checkbox';
+import input from '@inquirer/input';
 import { execSync } from 'child_process';
+import readline from 'readline';
 
 function getRepoPreamble(npxCommand) {
     return `## Context
@@ -18,15 +20,22 @@ ${npxCommand} meta-info
 
 ## Repository Configuration
 
-Before proceeding, read the \`.osddtrc\` file in the root of the repository to determine the project path.
+Before proceeding, read the \`.osddtrc\` file in the root of the repository to determine the project path and workflow mode.
 
 \`\`\`json
-// .osddtrc example
-{ "repoType": "monorepo" | "single" }
+// standard mode
+{ "repoType": "monorepo" | "single", "agents": ["claude"] }
+
+// worktree mode — "worktree-repository" presence determines the workflow
+{ "repoType": "monorepo" | "single", "agents": ["claude"], "worktree-repository": "https://github.com/org/repo.git" }
 \`\`\`
 
 - If \`repoType\` is \`"single"\`: the project path is the repository root.
 - If \`repoType\` is \`"monorepo"\`: ask the user which package to work on (e.g. \`packages/my-package\`), then use \`<repo-root>/<package>\` as the project path.
+- If \`"worktree-repository"\` is **present**: once the feature name is known, run \`${npxCommand} worktree-info <feature-name>\` to resolve the working directory:
+  - exit code **0**: parse the JSON and use the returned \`workingDir\` as the working directory.
+  - exit code **1**: the feature is not yet in a worktree — proceed as standard.
+- If \`"worktree-repository"\` is **absent**: use the standard project path from \`.osddtrc\`.
 
 ## Working Directory
 
@@ -159,7 +168,9 @@ ${FEATURE_NAME_RULES}
 
 Once the feature name is determined:
 
-3. ${WORKING_DIR_STEP}
+3. Resolve the working directory:
+   - If \`"worktree-repository"\` is present in \`.osddtrc\`: run \`${npxCommand} worktree-info <feature-name>\` and use the returned \`workingDir\` if it exits with code 0; otherwise fall through to the standard path.
+   - Otherwise: ${WORKING_DIR_STEP}
 
 4. Research the topic thoroughly:
    - Explore the existing codebase for relevant patterns, conventions, and prior art
@@ -201,7 +212,37 @@ Apply the constraints below to the feature name (the segment after the last \`/\
 
 ${FEATURE_NAME_RULES}
 
-Once the branch name is determined:
+Once the branch name is determined, choose the workflow based on \`.osddtrc\`:
+
+---
+
+### If \`worktree-repository\` is **present** — Worktree workflow
+
+3. Run the following command to create the git worktree, scaffold the working directory, and register the feature in the state file:
+
+\`\`\`
+${npxCommand} start-worktree <feature-name>
+\`\`\`
+
+For monorepos, pass the package path:
+
+\`\`\`
+${npxCommand} start-worktree <feature-name> --dir <package-path>
+\`\`\`
+
+4. Parse the command output to extract \`worktreePath\` and \`workingDir\`.
+
+5. Navigate into the worktree directory to locate the project:
+   - Enter \`<worktreePath>\` — this is the isolated git worktree for this feature.
+   - If \`repoType\` is \`"single"\`: the project root is \`<worktreePath>\`.
+   - If \`repoType\` is \`"monorepo"\`: the project root is \`<worktreePath>/<package-path>\`.
+   - The planning files will live under \`<workingDir>\` (i.e. \`<project-root>/working-on/<feature-name>/\`).
+
+6. Report the branch name, worktree path, project root, and working directory.
+
+---
+
+### If \`worktree-repository\` is **absent** — Standard workflow
 
 3. Check whether the branch already exists locally or remotely:
    - If it **does not exist**, create and switch to it:
@@ -218,6 +259,8 @@ Where \`<feature-name>\` is the last segment of the branch name (after the last
 
 5. Report the branch name and working directory that were created or resumed.
 
+---
+
 ${getCustomContextStep(npxCommand, 'start')}## Arguments
 
 ${args}
@@ -436,6 +479,26 @@ ${FEATURE_NAME_RULES}
 
 ### Step 2 — Create branch and working directory
 
+Choose the workflow based on \`.osddtrc\`:
+
+#### If \`worktree-repository\` is **present** — Worktree workflow
+
+3. Run the following command to create the git worktree, scaffold the working directory, and register the feature in the state file:
+
+\`\`\`
+${npxCommand} start-worktree <feature-name>
+\`\`\`
+
+For monorepos, pass the package path:
+
+\`\`\`
+${npxCommand} start-worktree <feature-name> --dir <package-path>
+\`\`\`
+
+4. Parse the command output to extract \`worktreePath\` and \`workingDir\`. Navigate into \`<worktreePath>\` to locate the project root.
+
+#### If \`worktree-repository\` is **absent** — Standard workflow
+
 3. Check whether the branch already exists locally or remotely:
    - If it **does not exist**, create and switch to it:
      \`\`\`
@@ -502,16 +565,53 @@ ${args}
         body: ({ npxCommand }) => `## Instructions
 
 1. Confirm all tasks in \`osddt.tasks.md\` are checked off (\`- [x]\`)
-2. Run the following command to move the feature folder from \`working-on\` to \`done\`:
+2. Run the following command to check whether this feature uses a git worktree:
 
 \`\`\`
-${npxCommand} done <feature-name> --dir <project-path>
+${npxCommand} worktree-info <feature-name>
 \`\`\`
 
-   The command will automatically prefix the destination folder name with today's date in \`YYYY-MM-DD\` format.
+3. Based on the result:
+
+   **If it exits with code 1 (standard feature):** use the project path from \`.osddtrc\`, then run:
+   \`\`\`
+   ${npxCommand} done <feature-name> --dir <project-path>
+   \`\`\`
+   Skip to step 8.
+
+   **If it exits with code 0 (worktree feature):** parse the JSON to get \`worktreePath\` and \`branch\`, derive \`<project-path>\` from \`workingDir\`, then continue below.
+
+4. Check for uncommitted changes inside the worktree:
+
+   \`\`\`
+   git -C <worktreePath> status --porcelain
+   \`\`\`
+
+5. If there are **uncommitted changes**:
+   1. Run \`git -C <worktreePath> diff\` to inspect them.
+   2. Derive a concise commit message in **conventional commit** format (e.g. \`feat: add payment gateway integration\`) based on the diff.
+   3. Present the proposed message to the user: _"Use this commit message, or provide your own?"_
+   4. Once confirmed, commit:
+      \`\`\`
+      git -C <worktreePath> add -A
+      git -C <worktreePath> commit -m "<confirmed-message>"
+      \`\`\`
+
+6. Push the branch to remote (covers both first push and subsequent pushes):
+
+   \`\`\`
+   git -C <worktreePath> push --set-upstream origin <branch>
+   \`\`\`
+
+7. Run the done command with the \`--worktree\` flag:
+   \`\`\`
+   ${npxCommand} done <feature-name> --dir <project-path> --worktree
+   \`\`\`
+
+8. The command will automatically prefix the destination folder name with today's date in \`YYYY-MM-DD\` format.
    For example, \`working-on/feature-a\` will be moved to \`done/YYYY-MM-DD-feature-a\`.
 
-3. Report the result of the command, including the full destination path
+9. Report the result of the command, including the full destination path
 
 ${getCustomContextStep(npxCommand, 'done')}`,
     },
@@ -527,7 +627,7 @@ ${body}`;
 }
 function getClaudeTemplates(cwd, npxCommand) {
     const dir = path.join(cwd, CLAUDE_COMMANDS_DIR);
-    return COMMAND_DEFINITIONS.map((cmd) => ({
+    return COMMAND_DEFINITIONS.map(cmd => ({
         filePath: path.join(dir, `${cmd.name}.md`),
         content: formatClaudeCommand(cmd.description, cmd.body({ args: '$ARGUMENTS', npxCommand })),
     }));
@@ -543,7 +643,7 @@ ${body}"""
 }
 function getGeminiTemplates(cwd, npxCommand) {
     const dir = path.join(cwd, GEMINI_COMMANDS_DIR);
-    return COMMAND_DEFINITIONS.map((cmd) => ({
+    return COMMAND_DEFINITIONS.map(cmd => ({
         filePath: path.join(dir, `${cmd.name}.toml`),
         content: formatGeminiCommand(cmd.description, cmd.body({ args: '{{args}}', npxCommand })),
     }));
@@ -566,6 +666,12 @@ async function askRepoType() {
         ],
     });
 }
+async function askWorktreeUrl() {
+    return input({
+        message: 'Remote repository URL for worktree workflow (leave blank to skip):',
+        default: '',
+    });
+}
 async function askAgents() {
     return checkbox({
         message: 'Which AI assistant tools do you want to set up?',
@@ -590,6 +696,102 @@ async function askAgents() {
     });
 }
 
+function checkGitVersion() {
+    try {
+        const output = execSync('git --version', { encoding: 'utf-8' }).trim();
+        const match = output.match(/git version (\d+)\.(\d+)/);
+        if (!match) {
+            return { label: 'Git version >= 2.5', passed: false, detail: `Could not parse git version: ${output}` };
+        }
+        const major = parseInt(match[1], 10);
+        const minor = parseInt(match[2], 10);
+        const ok = major > 2 || (major === 2 && minor >= 5);
+        return {
+            label: 'Git version >= 2.5',
+            passed: ok,
+            detail: ok ? output : `Found ${output} — git worktree requires >= 2.5`,
+        };
+    }
+    catch {
+        return { label: 'Git version >= 2.5', passed: false, detail: 'git not found or not executable' };
+    }
+}
+function checkNotAWorktree(cwd) {
+    try {
+        const gitCommonDir = execSync('git rev-parse --git-common-dir', { cwd, encoding: 'utf-8' }).trim();
+        const gitDir = execSync('git rev-parse --git-dir', { cwd, encoding: 'utf-8' }).trim();
+        const isWorktree = gitDir !== gitCommonDir && gitDir !== '.git';
+        return {
+            label: 'Current directory is not a worktree',
+            passed: !isWorktree,
+            detail: isWorktree
+                ? `This directory is itself a worktree (git-dir: ${gitDir}). Run setup from the main repository.`
+                : 'OK',
+        };
+    }
+    catch {
+        return { label: 'Current directory is not a worktree', passed: false, detail: 'Not inside a git repository' };
+    }
+}
+async function checkTargetWritable(cwd) {
+    let targetBase;
+    try {
+        const repoRoot = execSync('git rev-parse --show-toplevel', { cwd, encoding: 'utf-8' }).trim();
+        const rcPath = path.join(repoRoot, '.osddtrc');
+        if (await fs.pathExists(rcPath)) {
+            const rc = await fs.readJson(rcPath);
+            targetBase = rc.worktreeBase ?? path.dirname(repoRoot);
+        }
+        else {
+            targetBase = path.dirname(repoRoot);
+        }
+    }
+    catch {
+        return { label: 'Worktree target directory is writable', passed: false, detail: 'Could not resolve repo root' };
+    }
+    try {
+        await fs.access(targetBase, fs.constants.W_OK);
+        return { label: 'Worktree target directory is writable', passed: true, detail: `${targetBase} is writable` };
+    }
+    catch {
+        return { label: 'Worktree target directory is writable', passed: false, detail: `${targetBase} is not writable` };
+    }
+}
+async function initStateFile(cwd) {
+    try {
+        const repoRoot = execSync('git rev-parse --show-toplevel', { cwd, encoding: 'utf-8' }).trim();
+        const stateFile = path.join(path.dirname(repoRoot), '.osddt-worktrees');
+        if (!(await fs.pathExists(stateFile))) {
+            await fs.writeJson(stateFile, [], { spaces: 2 });
+            console.log(`  ✓ Initialized worktree state file: ${stateFile}`);
+        }
+        else {
+            console.log(`  ✓ Worktree state file already exists: ${stateFile}`);
+        }
+    }
+    catch {
+        console.log('  ✗ Could not initialize worktree state file');
+    }
+}
+function printCheckResult(result) {
+    const icon = result.passed ? '✓' : '✗';
+    console.log(`  ${icon} ${result.label}`);
+    if (!result.passed) {
+        console.log(`    → ${result.detail}`);
+    }
+}
+async function runWorktreeChecks(cwd) {
+    const results = [
+        checkGitVersion(),
+        checkNotAWorktree(cwd),
+        await checkTargetWritable(cwd),
+    ];
+    for (const result of results) {
+        printCheckResult(result);
+    }
+    return results.every(r => r.passed);
+}
+
 const CANONICAL_PACKAGE_NAME = '@dezkareid/osddt';
 const NPX_COMMAND = 'npx osddt';
 const NPX_COMMAND_FALLBACK = `npx ${CANONICAL_PACKAGE_NAME}`;
@@ -608,12 +810,12 @@ async function resolveNpxCommand(cwd) {
 const VALID_AGENTS = ['claude', 'gemini'];
 const VALID_REPO_TYPES = ['single', 'monorepo'];
 function parseAgents(raw) {
-    const values = raw.split(',').map((s) => s.trim());
+    const values = raw.split(',').map(s => s.trim());
     if (values.length === 0) {
         console.error('Error: --agents requires at least one value.');
         process.exit(1);
     }
-    const invalid = values.filter((v) => !VALID_AGENTS.includes(v));
+    const invalid = values.filter(v => !VALID_AGENTS.includes(v));
     if (invalid.length > 0) {
         console.error(`Error: Invalid agent(s): ${invalid.join(', ')}. Valid values: ${VALID_AGENTS.join(', ')}.`);
         process.exit(1);
@@ -637,15 +839,7 @@ async function writeConfig(cwd, config) {
     await fs.writeJson(configPath, config, { spaces: 2 });
     console.log(`\nSaved config: ${configPath}`);
 }
-async function runSetup(cwd, rawAgents, rawRepoType) {
-    const agents = rawAgents !== undefined ? parseAgents(rawAgents) : await askAgents();
-    if (rawAgents === undefined)
-        console.log('');
-    const repoType = rawRepoType !== undefined ? parseRepoType(rawRepoType) : await askRepoType();
-    if (rawRepoType === undefined)
-        console.log('');
-    const npxCommand = await resolveNpxCommand(cwd);
-    console.log('Setting up OSDDT command files...\n');
+async function writeAgentFiles(cwd, agents, npxCommand) {
     if (agents.includes('claude')) {
         const claudeFiles = getClaudeTemplates(cwd, npxCommand);
         console.log('Claude Code commands (.claude/commands/):');
@@ -662,7 +856,38 @@ async function runSetup(cwd, rawAgents, rawRepoType) {
         }
         console.log('');
     }
-    await writeConfig(cwd, { repoType, agents });
+}
+async function setupWorktreeEnvironment(cwd, _worktreeRepository) {
+    console.log('Checking environment for git worktree support...\n');
+    const allPassed = await runWorktreeChecks(cwd);
+    console.log('');
+    if (!allPassed) {
+        console.log('Some checks failed. Resolve the issues above before using the worktree workflow.');
+        process.exit(1);
+    }
+    await initStateFile(cwd);
+    console.log('');
+}
+async function runSetup(cwd, rawAgents, rawRepoType, rawWorktreeRepository) {
+    const agents = rawAgents !== undefined ? parseAgents(rawAgents) : await askAgents();
+    if (rawAgents === undefined)
+        console.log('');
+    const repoType = rawRepoType !== undefined ? parseRepoType(rawRepoType) : await askRepoType();
+    if (rawRepoType === undefined)
+        console.log('');
+    const worktreeRepository = rawWorktreeRepository !== undefined ? rawWorktreeRepository : (await askWorktreeUrl()) || undefined;
+    if (rawWorktreeRepository === undefined)
+        console.log('');
+    if (worktreeRepository) {
+        await setupWorktreeEnvironment(cwd);
+    }
+    const npxCommand = await resolveNpxCommand(cwd);
+    console.log('Setting up OSDDT command files...\n');
+    await writeAgentFiles(cwd, agents, npxCommand);
+    const config = { repoType, agents };
+    if (worktreeRepository)
+        config['worktree-repository'] = worktreeRepository;
+    await writeConfig(cwd, config);
     console.log('\nSetup complete!');
     console.log('Commands created: osddt.spec, osddt.plan, osddt.tasks, osddt.implement');
 }
@@ -673,9 +898,10 @@ function setupCommand() {
         .option('-d, --dir <directory>', 'target directory', process.cwd())
         .option('--agents <list>', 'comma-separated agents to set up (claude, gemini)')
         .option('--repo-type <type>', 'repository type (single, monorepo)')
+        .option('--worktree-repository <url>', 'remote repository URL to enable worktree workflow')
         .action(async (options) => {
         const targetDir = path.resolve(options.dir);
-        await runSetup(targetDir, options.agents, options.repoType);
+        await runSetup(targetDir, options.agents, options.repoType, options.worktreeRepository);
     });
     return cmd;
 }
@@ -712,7 +938,13 @@ function todayPrefix() {
     const dd = String(now.getDate()).padStart(2, '0');
     return `${yyyy}-${mm}-${dd}`;
 }
-async function runDone(featureName, cwd) {
+function resolveRepoRoot$2(cwd) {
+    return execSync('git rev-parse --show-toplevel', { cwd, encoding: 'utf-8' }).trim();
+}
+function stateFilePath$2(repoRoot) {
+    return path.join(path.dirname(repoRoot), '.osddt-worktrees');
+}
+async function runDone(featureName, cwd, worktree) {
     const src = path.join(cwd, 'working-on', featureName);
     const destName = `${todayPrefix()}-${featureName}`;
     const dest = path.join(cwd, 'done', destName);
@@ -723,6 +955,30 @@ async function runDone(featureName, cwd) {
     await fs.ensureDir(path.dirname(dest));
     await fs.move(src, dest);
     console.log(`Moved: working-on/${featureName} → done/${destName}`);
+    if (!worktree)
+        return;
+    const repoRoot = resolveRepoRoot$2(process.cwd());
+    const stateFile = stateFilePath$2(repoRoot);
+    if (!(await fs.pathExists(stateFile))) {
+        console.error(`Warning: .osddt-worktrees not found at ${stateFile}. Skipping worktree cleanup.`);
+        return;
+    }
+    const entries = await fs.readJson(stateFile);
+    const entry = entries.find(e => e.featureName === featureName);
+    if (!entry) {
+        console.error(`Warning: No worktree entry found for "${featureName}". Skipping worktree cleanup.`);
+        return;
+    }
+    if (await fs.pathExists(entry.worktreePath)) {
+        execSync(`git worktree remove "${entry.worktreePath}" --force`, { cwd: repoRoot, stdio: 'inherit' });
+        console.log(`Removed worktree: ${entry.worktreePath}`);
+    }
+    else {
+        console.log(`Worktree path not found on filesystem, skipping git worktree remove.`);
+    }
+    const updated = entries.filter(e => e.featureName !== featureName);
+    await fs.writeJson(stateFile, updated, { spaces: 2 });
+    console.log(`Removed state entry for "${featureName}" from .osddt-worktrees`);
 }
 function doneCommand() {
     const cmd = new Command('done');
@@ -730,9 +986,10 @@ function doneCommand() {
         .description('Move a feature from working-on/<feature-name> to done/<feature-name>')
         .argument('<feature-name>', 'name of the feature to mark as done')
         .option('-d, --dir <directory>', 'project directory', process.cwd())
+        .option('--worktree', 'also remove the git worktree and clean up the state file')
         .action(async (featureName, options) => {
         const targetDir = path.resolve(options.dir);
-        await runDone(featureName, targetDir);
+        await runDone(featureName, targetDir, options.worktree ?? false);
     });
     return cmd;
 }
@@ -745,7 +1002,7 @@ async function hasOsddtCommandFile(dir, pattern) {
     if (!(await fs.pathExists(dir)))
         return false;
     const entries = await fs.readdir(dir);
-    return entries.some((f) => pattern.test(f));
+    return entries.some(f => pattern.test(f));
 }
 async function inferAgents(cwd) {
     const detected = [];
@@ -868,6 +1125,169 @@ function contextCommand() {
     return cmd;
 }
 
+function resolveRepoRoot$1(cwd) {
+    return execSync('git rev-parse --show-toplevel', { cwd, encoding: 'utf-8' }).trim();
+}
+function repoName(repoRoot) {
+    return path.basename(repoRoot);
+}
+function stateFilePath$1(repoRoot) {
+    return path.join(path.dirname(repoRoot), '.osddt-worktrees');
+}
+async function readStateFile(stateFile) {
+    if (!(await fs.pathExists(stateFile)))
+        return [];
+    return fs.readJson(stateFile);
+}
+async function writeStateFile(stateFile, entries) {
+    await fs.writeJson(stateFile, entries, { spaces: 2 });
+}
+function branchExists(branch, cwd) {
+    try {
+        execSync(`git rev-parse --verify ${branch}`, { cwd, stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function remoteBranchExists(branch, cwd) {
+    try {
+        execSync(`git ls-remote --exit-code --heads origin ${branch}`, { cwd, stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function prompt(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function createWorktree(branch, worktreePath, repoRoot) {
+    if (await fs.pathExists(worktreePath)) {
+        console.log(`\nDirectory already exists at: ${worktreePath}`);
+        const answer = await prompt('Resume or Abort? [R/a] ');
+        if (answer.toLowerCase() === 'a') {
+            console.log('Aborted.');
+            process.exit(0);
+        }
+        return;
+    }
+    const localExists = branchExists(branch, repoRoot);
+    const remoteExists = !localExists && remoteBranchExists(branch, repoRoot);
+    if (localExists || remoteExists) {
+        console.log(`\nBranch "${branch}" already exists ${localExists ? 'locally' : 'on remote'}.`);
+        const answer = await prompt('Resume or Abort? [R/a] ');
+        if (answer.toLowerCase() === 'a') {
+            console.log('Aborted.');
+            process.exit(0);
+        }
+        execSync(`git worktree add "${worktreePath}" ${branch}`, { cwd: repoRoot, stdio: 'inherit' });
+    }
+    else {
+        execSync(`git worktree add "${worktreePath}" -b ${branch}`, { cwd: repoRoot, stdio: 'inherit' });
+    }
+}
+async function runStartWorktree(featureName, options) {
+    const cwd = process.cwd();
+    const repoRoot = resolveRepoRoot$1(cwd);
+    const branch = `feat/${featureName}`;
+    // Read .osddtrc
+    const rcPath = path.join(repoRoot, '.osddtrc');
+    let rc = { repoType: 'single' };
+    if (await fs.pathExists(rcPath)) {
+        rc = await fs.readJson(rcPath);
+    }
+    // Resolve worktree path
+    const base = rc.worktreeBase ?? path.dirname(repoRoot);
+    const worktreePath = path.join(base, `${repoName(repoRoot)}-${featureName}`);
+    // Check state file for existing entry
+    const stateFile = stateFilePath$1(repoRoot);
+    const entries = await readStateFile(stateFile);
+    const existing = entries.find(e => e.featureName === featureName);
+    if (existing) {
+        console.log(`\nWorktree for "${featureName}" already exists at: ${existing.worktreePath}`);
+        const answer = await prompt('Resume or Abort? [R/a] ');
+        if (answer.toLowerCase() === 'a') {
+            console.log('Aborted.');
+            process.exit(0);
+        }
+        console.log(`\nResuming existing worktree.`);
+        console.log(`  Branch:          ${existing.branch}`);
+        console.log(`  Worktree path:   ${existing.worktreePath}`);
+        console.log(`  Working dir:     ${existing.workingDir}`);
+        return;
+    }
+    await createWorktree(branch, worktreePath, repoRoot);
+    // Resolve working dir
+    let projectPath;
+    if (rc.repoType === 'monorepo') {
+        const pkg = options.dir ?? await prompt('Package path (e.g. packages/my-package): ');
+        projectPath = path.join(worktreePath, pkg);
+    }
+    else {
+        projectPath = worktreePath;
+    }
+    const workingDir = path.join(projectPath, 'working-on', featureName);
+    await fs.ensureDir(workingDir);
+    // Write state file entry
+    entries.push({ featureName, branch, worktreePath, workingDir, repoRoot });
+    await writeStateFile(stateFile, entries);
+    console.log(`\nWorktree feature started:`);
+    console.log(`  Branch:          ${branch}`);
+    console.log(`  Worktree path:   ${worktreePath}`);
+    console.log(`  Working dir:     ${workingDir}`);
+}
+function startWorktreeCommand() {
+    const cmd = new Command('start-worktree');
+    cmd
+        .description('Start a new feature using a git worktree')
+        .argument('<feature-name>', 'feature name (kebab-case, max 30 chars)')
+        .option('-d, --dir <package>', 'package path within monorepo (skips prompt)')
+        .action(async (featureName, options) => {
+        await runStartWorktree(featureName, options);
+    });
+    return cmd;
+}
+
+function resolveRepoRoot(cwd) {
+    return execSync('git rev-parse --show-toplevel', { cwd, encoding: 'utf-8' }).trim();
+}
+function stateFilePath(repoRoot) {
+    return path.join(path.dirname(repoRoot), '.osddt-worktrees');
+}
+async function runWorktreeInfo(featureName) {
+    const repoRoot = resolveRepoRoot(process.cwd());
+    const stateFile = stateFilePath(repoRoot);
+    if (!(await fs.pathExists(stateFile))) {
+        console.error(`No .osddt-worktrees file found at: ${stateFile}`);
+        process.exit(1);
+    }
+    const entries = await fs.readJson(stateFile);
+    const entry = entries.find(e => e.featureName === featureName);
+    if (!entry) {
+        console.error(`No worktree entry found for feature: ${featureName}`);
+        process.exit(1);
+    }
+    console.log(JSON.stringify({ worktreePath: entry.worktreePath, workingDir: entry.workingDir, branch: entry.branch }));
+}
+function worktreeInfoCommand() {
+    const cmd = new Command('worktree-info');
+    cmd
+        .description('Look up worktree paths for a feature from the state file')
+        .argument('<feature-name>', 'feature name to look up')
+        .action(async (featureName) => {
+        await runWorktreeInfo(featureName);
+    });
+    return cmd;
+}
+
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = path.dirname(__filename$1);
 const pkgPath = path.join(__dirname$1, '..', 'package.json');
@@ -882,4 +1302,6 @@ program.addCommand(metaInfoCommand());
 program.addCommand(doneCommand());
 program.addCommand(updateCommand());
 program.addCommand(contextCommand());
+program.addCommand(startWorktreeCommand());
+program.addCommand(worktreeInfoCommand());
 program.parse(process.argv);

package/dist/utils/prompt.d.ts

@@ -1,4 +1,5 @@
 export type RepoType = 'monorepo' | 'single';
 export type AgentType = 'claude' | 'gemini';
 export declare function askRepoType(): Promise<RepoType>;
+export declare function askWorktreeUrl(): Promise<string>;
 export declare function askAgents(): Promise<AgentType[]>;

package/dist/utils/worktree.d.ts

@@ -0,0 +1,11 @@
+export interface CheckResult {
+    label: string;
+    passed: boolean;
+    detail: string;
+}
+export declare function checkGitVersion(): CheckResult;
+export declare function checkNotAWorktree(cwd: string): CheckResult;
+export declare function checkTargetWritable(cwd: string): Promise<CheckResult>;
+export declare function initStateFile(cwd: string): Promise<void>;
+export declare function printCheckResult(result: CheckResult): void;
+export declare function runWorktreeChecks(cwd: string): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dezkareid/osddt",
-  "version": "1.10.1",
+  "version": "1.11.1",
   "description": "Package for Spec-Driven Development workflow",
   "keywords": [
     "spec-driven",
@@ -34,6 +34,7 @@
   "main": "./dist/index.js",
   "dependencies": {
     "@inquirer/checkbox": "5.0.7",
+    "@inquirer/input": "5.0.7",
     "@inquirer/select": "5.0.7",
     "commander": "12.0.0",
     "fs-extra": "11.2.0",
@@ -42,13 +43,12 @@
   "devDependencies": {
     "@commitlint/cli": "20.5.0",
     "@commitlint/config-conventional": "20.5.0",
-    "@dezkareid/eslint-config-ts-base": "1.0.0",
+    "@dezkareid/eslint-plugin-web": "1.0.0",
     "@rollup/plugin-typescript": "12.1.4",
     "@types/fs-extra": "11.0.4",
     "@types/node": "25.0.10",
     "eslint": "9.39.2",
     "husky": "9.1.7",
-    "prettier": "3.8.1",
     "rollup": "4.56.0",
     "typescript": "5.9.3",
     "vitest": "4.0.18"
@@ -59,7 +59,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src",
-    "format": "prettier --write src",
+    "lint:fix": "eslint src --fix",
     "setup-local": "pnpm run build && npx osddt setup --agents claude --repo-type single",
     "update-local": "pnpm run build && npx osddt update"
   }

package/dist/commands/context.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/commands/done.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/commands/meta-info.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/commands/setup.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/commands/update.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/templates/claude.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/templates/gemini.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/templates/shared.spec.d.ts

@@ -1 +0,0 @@
-export {};