@winton979/task-cli 1.2.0 → 1.3.0

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.
 
 ---
 
@@ -127,6 +129,7 @@ BUG_READY
 ### Other
 
 * decision-log
+* decision-sweep-weekly
 
 ---
 
@@ -151,6 +154,18 @@ BUG_READY
 
 ---
 
+## Weekly Decision Sweep
+
+Calling `/decision-log` after every task is easy to forget. As a lower-friction alternative, run `decision-sweep-weekly` once per week (Friday is a natural fit):
+
+```
+/decision-sweep-weekly
+```
+
+The skill scans archived task and bug briefs from the past 7 days, judges which ones contain a decision worth keeping (cross-task impact, rejected alternatives, counter-intuitive choices, externally driven calls, or instructive cancellations), drafts the entries, and waits for confirmation before appending to `.ai/decisions/decisions.md`.
+
+Use `decision-log` for in-the-moment recording and `decision-sweep-weekly` for periodic cleanup. Either alone is enough; using both is fine.
+
 ## Philosophy
 
 Task CLI is intentionally lightweight.
@@ -221,7 +236,7 @@ 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`, `task-cancel`, `bug-explore`, `bug-fix`, `bug-review`, `bug-cancel`, `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`, `decision-sweep-weekly`
 * reinstall the latest versions of those skills
 
 This avoids touching unrelated custom skills in the same project.
@@ -237,4 +252,4 @@ task doctor
 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,6 +1,6 @@
 {
   "name": "@winton979/task-cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Lightweight task workflow CLI for AI-assisted development",
   "license": "MIT",
   "type": "module",

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
 
@@ -270,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
 
@@ -474,6 +485,79 @@ Requirements
 * Maximum 10 lines per decision
 * Append only
 * Keep concise
+`,
+  },
+
+  'decision-sweep-weekly': {
+    name: 'decision-sweep-weekly',
+    description: 'Weekly sweep of recent task and bug briefs to decide which deserve a decision-log entry. Proposes entries for confirmation before appending.',
+    content: `---
+name: decision-sweep-weekly
+description: Weekly sweep of recent task and bug briefs to decide which deserve a decision-log entry. Proposes entries for confirmation before appending.
+user-invocable: true
+---
+
+Purpose
+
+Batch-review the past week of work and sediment only the decisions that outlive a single task. Replaces per-task reminders with one weekly pass.
+
+When to Run
+
+Run once per week, ideally on Friday. May also run ad-hoc after a busy stretch.
+
+Workflow
+
+1. Scan briefs created in the last 7 days under .ai/tasks/archive/ and .ai/bugs/archive/. Filter by filename date prefix YYYY-MM-DD. If a brief lacks a date prefix, fall back to filesystem mtime.
+2. For cancelled briefs in either archive, treat the abandonment itself as potential decision material.
+3. Evaluate each brief against the Sediment Conditions below.
+4. For each candidate, draft a decision entry using the four-section format.
+5. Present a single review list: every scanned brief with a verdict (write / skip / insufficient info), then the proposed drafts grouped at the end.
+6. Do NOT append anything yet. Wait for the user to confirm which drafts to keep, edit, or drop.
+7. Only after confirmation, append the approved entries to .ai/decisions/decisions.md, oldest first, under the matching YYYY-MM-DD section heading.
+8. Report what was appended and what was skipped.
+
+Sediment Conditions
+
+A brief becomes a decision entry if it satisfies any of:
+
+* Cross-task impact: the choice constrains how future tasks must be written.
+* A concrete alternative was rejected and someone could plausibly pick it later.
+* Counter-intuitive choice: code reads like an anti-pattern but is intentional.
+* Externally driven: compliance, performance, compatibility, or a third-party API limit forced the call.
+* A cancelled attempt whose failure is itself a useful conclusion.
+
+Skip Conditions
+
+* Affects only the implementation detail of one task.
+* A temporary or unsettled conclusion.
+* A bare fact with no decision behind it.
+
+Entry Format
+
+## YYYY-MM-DD
+
+### Problem
+
+What issue was encountered.
+
+### Decision
+
+What was chosen.
+
+### Reason
+
+Why this choice was made.
+
+### Alternatives Considered
+
+What alternatives were rejected.
+
+Requirements
+
+* Maximum 10 lines per decision
+* Append only
+* One date section per day; multiple decisions on the same day stack under the same heading
+* Never edit or delete prior entries
 `,
   },
 };
@@ -484,6 +568,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}` : ''}`);
@@ -595,7 +722,8 @@ export function init(cwd, { fs, path, log }) {
   fast:  task-fast
   task:  task-explore -> task-implement -> task-review | task-cancel
   bug:   bug-explore -> bug-fix -> bug-review | bug-cancel
-  other: decision-log`);
+  other: decision-log
+  sweep: decision-sweep-weekly`);
 }
 
 export function refresh(cwd, { fs, path, log }) {
@@ -629,7 +757,8 @@ export function refresh(cwd, { fs, path, log }) {
   fast:  task-fast
   task:  task-explore -> task-implement -> task-review | task-cancel
   bug:   bug-explore -> bug-fix -> bug-review | bug-cancel
-  other: decision-log`);
+  other: decision-log
+  sweep: decision-sweep-weekly`);
 }
 
 export function doctor(cwd, { fs, path, log }) {
@@ -680,6 +809,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')