@winton979/task-cli 1.1.1 → 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 winton979
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,7 +10,7 @@ Designed for:
 
 Task CLI provides a lightweight alternative to heavyweight spec-driven workflows by combining:
 
-* Requirement clarification (via Grill Me)
+* Requirement clarification (prefer Grill Me, fallback built in)
 * Brief generation
 * Implementation
 * Review
@@ -34,7 +34,7 @@ task init
 
 ## Prerequisites
 
-Task CLI relies on a Grill Me compatible skill for requirement exploration.
+Task CLI can use a Grill Me compatible skill for requirement and bug exploration.
 
 Recommended:
 
@@ -44,6 +44,8 @@ npx add-skill PJ-SBN-593844/skill-grill-me
 
 Compatible Grill Me implementations may also work.
 
+If no Grill Me compatible skill is installed, `task-fast`, `task-explore`, and `bug-explore` fall back to built-in clarification prompts.
+
 ---
 
 ## Usage
@@ -59,7 +61,7 @@ After initialization, Task CLI creates the `.ai/` workspace and installs workflo
 
 Use `task refresh` in existing projects to remove and reinstall only the workflow skills managed by task-cli. It does not delete your `.ai` briefs, internal archives, or decision log.
 
-Use `task doctor` to check whether the required directories exist, whether managed skills are missing or outdated, and whether the `.gitignore` rules are present.
+Use `task doctor` to check whether the required directories exist, whether managed skills are missing or outdated, whether a local Grill Me companion was detected, and whether the `.gitignore` rules are present.
 
 ---
 
@@ -73,6 +75,8 @@ Use `task doctor` to check whether the required directories exist, whether manag
 clarify + brief + implement + validate
     ↓
 /task-review
+    or
+/task-cancel
 ```
 
 ### Larger Requirement
@@ -85,6 +89,8 @@ TASK_READY
 /task-implement
     ↓
 /task-review
+    or
+/task-cancel
 ```
 
 ### Bug Fix
@@ -97,6 +103,8 @@ BUG_READY
 /bug-fix
     ↓
 /bug-review
+    or
+/bug-cancel
 ```
 
 ---
@@ -109,12 +117,14 @@ BUG_READY
 * task-explore
 * task-implement
 * task-review
+* task-cancel
 
 ### Bug Workflow
 
 * bug-explore
 * bug-fix
 * bug-review
+* bug-cancel
 
 ### Other
 
@@ -157,21 +167,50 @@ Instead of maintaining large specifications, it focuses on:
 
 The goal is to improve quality without slowing down iteration speed.
 
+## Compared with OpenSpec-Style Workflows
+
+Task CLI is designed as a lightweight alternative to heavier spec-driven systems such as OpenSpec.
+
+Detailed specification workflows can improve alignment, traceability, and consistency. They are often the right choice for large initiatives, cross-team programs, and environments with strong process requirements.
+
+The difficulty is that the same level of ceremony does not always fit day-to-day engineering work. For frequent bug fixes, small features, and fast iteration, the process can become heavier than the change itself. When that happens, maintenance overhead increases, documentation quality starts to drift, and teams gradually stop using the workflow as originally intended.
+
+Task CLI takes a narrower and more pragmatic approach:
+
+* clarify the requirement
+* capture only the minimum useful brief
+* execute against acceptance criteria
+* review the result
+* keep a lightweight decision trail
+
+The goal is not to replace specification systems in every context. It is to provide a workflow that people will actually keep using during day-to-day engineering work.
+
+## Strengths and Tradeoffs
+
+Task CLI is optimized for execution speed and sustained adoption rather than full process coverage.
 
-## Can This Be Simpler?
+Strengths:
 
-Yes. The main simplification is to collapse the old 4-step paths:
+* much lower process overhead for bugs, small features, and short iterations
+* easier to adopt in mature codebases where engineers already know the product context
+* encourages real usage because the workflow is short enough to sustain
+* keeps enough structure to improve clarity without forcing large documents
 
-* `task-explore` now includes brief generation.
-* `bug-explore` now includes bug brief generation.
-* `task-implement` and `bug-fix` now validate the work and archive the brief automatically when complete.
+Tradeoffs:
 
-That leaves these practical flows:
+* less suitable for large cross-team initiatives that need formal design traceability
+* relies more on engineer judgment and review quality than a full specification process
+* stores less long-form historical context than a dedicated spec repository
 
-* Explore only: `/task-explore` or `/bug-explore`
-* Execute: `/task-implement` or `/bug-fix`
-* Review: `/task-review` or `/bug-review`
-* One-shot small work: `/task-fast`
+## Recommended Workflow Model
+
+Task CLI keeps the user-facing flow short:
+
+* `task-fast`
+* `task-explore -> task-implement -> task-review` or `task-cancel`
+* `bug-explore -> bug-fix -> bug-review` or `bug-cancel`
+
+The `archive/` directories remain as internal storage. They are not separate user steps in the recommended workflow.
 
 ## Upgrading Existing Projects
 
@@ -184,18 +223,20 @@ task refresh
 This will:
 
 * keep `.ai/tasks`, `.ai/bugs`, and `.ai/decisions`
-* remove only these managed skills from `.claude/skills/` and `.codex/skills/`: `task-fast`, `task-explore`, `task-implement`, `task-review`, `bug-explore`, `bug-fix`, `bug-review`, `decision-log`
+* remove only these managed skills from `.claude/skills/` and `.codex/skills/`: `task-fast`, `task-explore`, `task-implement`, `task-review`, `task-cancel`, `bug-explore`, `bug-fix`, `bug-review`, `bug-cancel`, `decision-log`
 * reinstall the latest versions of those skills
 
 This avoids touching unrelated custom skills in the same project.
 
-The `archive/` directories remain as internal storage. They are not separate user steps in the recommended workflow.
-
 Before refreshing, you can inspect the current setup with:
 
 ```bash
 task doctor
 ```
 
+## License
+
+MIT
+
 > Task CLI does not install Grill Me automatically.
-> Users remain free to choose any Grill Me compatible implementation.
+> Users remain free to choose any Grill Me compatible implementation, and the explore skills fall back to built-in clarification if none is installed.

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@winton979/task-cli",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "Lightweight task workflow CLI for AI-assisted development",
+  "license": "MIT",
   "type": "module",
   "bin": {
     "task": "./bin/task.js"

package/src/cli.js

@@ -26,8 +26,8 @@ Usage:
 
 Recommended flows after init:
   fast: task-fast
-  task: task-explore -> task-implement -> task-review
-  bug:  bug-explore -> bug-fix -> bug-review`);
+  task: task-explore -> task-implement -> task-review | task-cancel
+  bug:  bug-explore -> bug-fix -> bug-review | bug-cancel`);
 }
 
 switch (cmd) {

package/src/init.js

@@ -1,3 +1,5 @@
+import chalk from 'chalk';
+
 const TASK_ACTIVE_DIR = '.ai/tasks/active';
 const TASK_ARCHIVE_DIR = '.ai/tasks/archive';
 const BUG_ACTIVE_DIR = '.ai/bugs/active';
@@ -11,6 +13,12 @@ const GITIGNORE_BLOCK = [
   '.ai/bugs/active/*.md',
 ].join('\n');
 
+const GRILL_ME_HINTS = [
+  'grill-me',
+  'skill-grill-me',
+  'grill me',
+];
+
 const SKILLS = {
   'task-fast': {
     name: 'task-fast',
@@ -27,19 +35,20 @@ Handle a small requirement in one continuous workflow with minimal ceremony.
 
 Workflow
 
-1. Clarify the requirement just enough to remove ambiguity.
-2. Create a concise task brief and save it to:
+1. If a Grill Me compatible skill is available in the current environment, use it for requirement clarification.
+2. If no Grill Me compatible skill is available, clarify the requirement yourself with focused questions just far enough to remove ambiguity.
+3. Create a concise task brief and save it to:
 
 .ai/tasks/active/YYYY-MM-DD-task-name.md
 
-3. Show the brief before coding.
-4. If the user does not object, implement immediately.
-5. Verify the result against the acceptance criteria.
-6. Archive the brief automatically by moving it to:
+4. Show the brief before coding.
+5. If the user does not object, implement immediately.
+6. Verify the result against the acceptance criteria.
+7. Archive the brief automatically by moving it to:
 
 .ai/tasks/archive/YYYY-MM-DD-task-name.md
 
-7. Summarize the outcome and any follow-up risks.
+8. Summarize the outcome and any follow-up risks.
 
 Task Brief Format
 
@@ -91,15 +100,16 @@ Clarify requirements and leave behind a ready-to-execute brief.
 
 Workflow
 
-1. Explore the requirement through focused questions.
-2. Continue until the task is sufficiently understood.
-3. Do not write code.
-4. Do not create implementation details.
-5. Once the requirement is clear, generate a concise task brief and save it to:
+1. If a Grill Me compatible skill is available in the current environment, use it for requirement exploration.
+2. If no Grill Me compatible skill is available, explore the requirement yourself through focused questions.
+3. Continue until the task is sufficiently understood.
+4. Do not write code.
+5. Do not create implementation details.
+6. Once the requirement is clear, generate a concise task brief and save it to:
 
 .ai/tasks/active/YYYY-MM-DD-task-name.md
 
-6. Show the saved brief and stop.
+7. Show the saved brief and stop.
 
 Task Brief Format
 
@@ -225,6 +235,36 @@ Anything not fully implemented.
 `,
   },
 
+  'task-cancel': {
+    name: 'task-cancel',
+    description: 'Discard the current task analysis output and implementation changes for this attempt.',
+    content: `---
+name: task-cancel
+description: Discard the current task analysis output and implementation changes for this attempt.
+user-invocable: true
+---
+
+Purpose
+
+Abandon the current task attempt completely.
+
+Rules
+
+1. Target only the current task attempt.
+2. Discard the current task brief and any analysis artifacts created for this attempt.
+3. Discard code changes made for this attempt.
+4. Do not archive the task brief.
+5. Do not keep partial implementation.
+6. Do not preserve temporary conclusions from this attempt as accepted decisions.
+7. Do not touch unrelated historical archives, other active briefs, or user-authored changes outside this attempt.
+8. If the exact changed files are uncertain, stop and ask for confirmation before deleting or reverting anything.
+
+Output
+
+TASK_CANCELLED
+`,
+  },
+
   'bug-explore': {
     name: 'bug-explore',
     description: 'Investigate a bug and generate a fix brief in one step, without writing code.',
@@ -240,22 +280,23 @@ Investigate a bug and leave behind a ready-to-fix brief.
 
 Rules
 
-1. Do not write code.
-2. Do not suggest fixes before enough evidence exists.
-3. Identify root cause candidates.
-4. Ask focused questions.
-5. Request evidence whenever possible.
-6. Separate:
+1. If a Grill Me compatible skill is available in the current environment, use it for bug exploration.
+2. If no Grill Me compatible skill is available, ask focused questions and drive the investigation yourself.
+3. Do not write code.
+4. Do not suggest fixes before enough evidence exists.
+5. Identify root cause candidates.
+6. Request evidence whenever possible.
+7. Separate:
 
    * observed behavior
    * expected behavior
    * assumptions
 
-7. Once the bug is sufficiently understood, generate a brief and save it to:
+8. Once the bug is sufficiently understood, generate a brief and save it to:
 
 .ai/bugs/active/YYYY-MM-DD-bug-name.md
 
-8. Show the saved brief and stop.
+9. Show the saved brief and stop.
 
 Bug Brief Format
 
@@ -372,6 +413,36 @@ Further improvements.
 `,
   },
 
+  'bug-cancel': {
+    name: 'bug-cancel',
+    description: 'Discard the current bug analysis output and code changes for this attempt.',
+    content: `---
+name: bug-cancel
+description: Discard the current bug analysis output and code changes for this attempt.
+user-invocable: true
+---
+
+Purpose
+
+Abandon the current bug-fix attempt completely.
+
+Rules
+
+1. Target only the current bug-fix attempt.
+2. Discard the current bug brief and any analysis artifacts created for this attempt.
+3. Discard code changes made for this attempt.
+4. Do not archive the bug brief.
+5. Do not keep partial fixes.
+6. Do not preserve temporary conclusions from this attempt as accepted decisions.
+7. Do not touch unrelated historical archives, other active briefs, or user-authored changes outside this attempt.
+8. If the exact changed files are uncertain, stop and ask for confirmation before deleting or reverting anything.
+
+Output
+
+BUG_CANCELLED
+`,
+  },
+
   'decision-log': {
     name: 'decision-log',
     description: 'Record implementation decisions to .ai/decisions/decisions.md. Append-only, max 10 lines per entry.',
@@ -424,6 +495,49 @@ function skillFilePath(path, cwd, skillRoot, skillName) {
   return path.join(cwd, skillRoot, skillName, 'SKILL.md');
 }
 
+function hasGrillMeHint(value) {
+  const normalized = value.toLowerCase();
+  return GRILL_ME_HINTS.some((hint) => normalized.includes(hint));
+}
+
+function detectLocalGrillMeSkill(fs, path, cwd, skillRoot) {
+  const root = path.join(cwd, skillRoot);
+  if (!fs.existsSync(root)) {
+    return null;
+  }
+
+  for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+
+    if (MANAGED_SKILL_NAMES.includes(entry.name)) {
+      continue;
+    }
+
+    if (hasGrillMeHint(entry.name)) {
+      return entry.name;
+    }
+
+    const skillPath = path.join(root, entry.name, 'SKILL.md');
+    if (!fs.existsSync(skillPath)) {
+      continue;
+    }
+
+    const content = fs.readFileSync(skillPath, 'utf-8');
+    const metadata = content
+      .split('---')
+      .slice(1, 2)
+      .join('\n');
+
+    if (hasGrillMeHint(metadata)) {
+      return entry.name;
+    }
+  }
+
+  return null;
+}
+
 function logCheck(log, ok, label, detail) {
   if (ok) {
     log.chalk.green(`  OK   ${label}${detail ? ` - ${detail}` : ''}`);
@@ -533,8 +647,8 @@ export function init(cwd, { fs, path, log }) {
 
   log.info(`\nTask workflow initialized. Recommended flows:
   fast:  task-fast
-  task:  task-explore -> task-implement -> task-review
-  bug:   bug-explore -> bug-fix -> bug-review
+  task:  task-explore -> task-implement -> task-review | task-cancel
+  bug:   bug-explore -> bug-fix -> bug-review | bug-cancel
   other: decision-log`);
 }
 
@@ -567,8 +681,8 @@ export function refresh(cwd, { fs, path, log }) {
 
   log.info(`\nTask workflow refreshed. Managed skills reinstalled:
   fast:  task-fast
-  task:  task-explore -> task-implement -> task-review
-  bug:   bug-explore -> bug-fix -> bug-review
+  task:  task-explore -> task-implement -> task-review | task-cancel
+  bug:   bug-explore -> bug-fix -> bug-review | bug-cancel
   other: decision-log`);
 }
 
@@ -620,6 +734,22 @@ export function doctor(cwd, { fs, path, log }) {
     }
   }
 
+  const grillMeFindings = [
+    [CLAUDE_SKILLS_DIR, detectLocalGrillMeSkill(fs, path, cwd, CLAUDE_SKILLS_DIR)],
+    [CODEX_SKILLS_DIR, detectLocalGrillMeSkill(fs, path, cwd, CODEX_SKILLS_DIR)],
+  ];
+
+  for (const [skillRoot, skillName] of grillMeFindings) {
+    if (skillName) {
+      logCheck(log, true, `${skillRoot} Grill Me companion`, `detected ${skillName}`);
+      continue;
+    }
+
+    console.log(chalk.yellow(
+      `  WARN ${skillRoot} Grill Me companion - not detected locally; task-fast, task-explore, and bug-explore will use built-in clarification fallback`
+    ));
+  }
+
   const gitignorePath = path.join(cwd, '.gitignore');
   const gitignore = fs.existsSync(gitignorePath)
     ? fs.readFileSync(gitignorePath, 'utf-8')