chief-clancy 0.8.0 → 0.8.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chief-clancy",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Autonomous, board-driven development for Claude Code — scaffolds docs, integrates Kanban boards, runs tickets in a loop.",
   "keywords": [
     "claude",

package/src/roles/planner/workflows/plan.md

@@ -23,6 +23,10 @@ Fetch backlog tickets from the board, explore the codebase, and generate structu
    Stop.
 
 4. Check `.clancy/docs/` — if the directory is empty or missing:
+
+   **AFK mode** (`--afk` flag or `CLANCY_MODE=afk`): continue without prompting (log a warning).
+
+   **Interactive mode:**
    ```
    ⚠️  No codebase documentation found in .clancy/docs/
    Plans will be less accurate without codebase context.
@@ -33,6 +37,10 @@ Fetch backlog tickets from the board, explore the codebase, and generate structu
    If the user declines, stop. If they confirm, continue without docs context.
 
 5. Branch freshness check — run `git fetch origin` and compare the current HEAD with `origin/$CLANCY_BASE_BRANCH` (defaults to `main`). If the local branch is behind:
+
+   **AFK mode** (`--afk` flag or `CLANCY_MODE=afk`): auto-pull without prompting. Run `git pull origin $CLANCY_BASE_BRANCH` and continue.
+
+   **Interactive mode:**
    ```
    ⚠️  Your local branch is behind origin/{CLANCY_BASE_BRANCH} by {N} commit(s).
 

package/src/roles/setup/commands/update.md

@@ -4,6 +4,9 @@ Update Clancy itself to the latest version via npx and show what changed.
 
 This re-runs the installer, which copies the latest command files from the npm package into your .claude/commands/clancy/ directory. Your .clancy/ project folder (scripts, docs, progress log) is never touched.
 
+**Supported flags:**
+- `--afk` — skip the confirmation prompt and auto-approve the update (for autonomous setups)
+
 @.claude/clancy/workflows/update.md
 
-Run the update as documented in the workflow above.
+Run the update as documented in the workflow above. If `--afk` is passed, skip all confirmation prompts.

package/src/roles/setup/workflows/update.md

@@ -127,7 +127,9 @@ Note: `.clancy/clancy-once.js` and `.clancy/clancy-afk.js` **will be replaced**
 the latest bundled versions. The rest of `.clancy/` is untouched.
 ```
 
-Ask the user: **"Proceed with update?"** with options:
+**AFK mode check:** If `--afk` flag is passed OR `CLANCY_MODE=afk` in `.clancy/.env`, **skip the confirmation and proceed automatically.** Do not prompt — auto-approve the update.
+
+**Interactive mode:** Ask the user: **"Proceed with update?"** with options:
 - "Yes, update now"
 - "No, cancel"
 

package/src/roles/strategist/workflows/approve-brief.md

@@ -27,6 +27,10 @@ Approve a reviewed strategic brief by creating child tickets on the board, linki
    git fetch origin
    ```
    Compare HEAD with `origin/$CLANCY_BASE_BRANCH`. If behind:
+
+   **AFK mode** (`--afk` flag or `CLANCY_MODE=afk`): auto-pull without prompting.
+
+   **Interactive mode:**
    ```
    Behind by N commits. [1] Pull latest  [2] Continue  [3] Abort
    ```

package/src/roles/strategist/workflows/brief.md

@@ -23,6 +23,10 @@ Research an idea, interrogate it thoroughly, and generate a structured strategic
    Stop.
 
 4. Branch freshness check — run `git fetch origin` and compare the current HEAD with `origin/$CLANCY_BASE_BRANCH` (defaults to `main`). If the local branch is behind:
+
+   **AFK mode** (`--afk` flag or `CLANCY_MODE=afk`): auto-pull without prompting. Run `git pull origin $CLANCY_BASE_BRANCH` and continue.
+
+   **Interactive mode:**
    ```
    ⚠️  Your local branch is behind origin/{CLANCY_BASE_BRANCH} by {N} commit(s).
 

package/src/templates/.env.example.github

@@ -1,80 +0,0 @@
-# Clancy — GitHub Issues configuration
-# Copy this file to .env and fill in your values.
-# Never commit .env to version control.
-
-# ─── GitHub Issues ────────────────────────────────────────────────────────────
-GITHUB_TOKEN=ghp_your-personal-access-token
-GITHUB_REPO=owner/repo-name
-
-# Optional: only pick up issues with this label (in addition to 'clancy').
-# Useful for mixed backlogs where not every issue is suitable for autonomous implementation.
-# Create the label in GitHub first, then add it to any issue you want Clancy to pick up.
-# CLANCY_LABEL=clancy
-
-# ─── Git ──────────────────────────────────────────────────────────────────────
-# Base integration branch. Clancy branches from here when an issue has no milestone.
-# When an issue has a milestone, Clancy auto-creates milestone/{slug} from this branch.
-CLANCY_BASE_BRANCH=main
-
-# ─── Optional roles ─────────────────────────────────────────────────────────
-# Comma-separated list of optional roles to enable (e.g. planner)
-# Core roles (implementer, reviewer, setup) are always active.
-# CLANCY_ROLES=planner,strategist
-
-# ─── Loop ─────────────────────────────────────────────────────────────────────
-# Max tickets to process per /clancy:run session (default: 20)
-MAX_ITERATIONS=20
-
-# ─── Model ────────────────────────────────────────────────────────────────────
-# Claude model used for each ticket session. Leave unset to use the default.
-# Options: claude-opus-4-6 | claude-sonnet-4-6 | claude-haiku-4-5
-# CLANCY_MODEL=claude-sonnet-4-6
-
-# ─── Optional: Figma MCP ──────────────────────────────────────────────────────
-# Fetch design specs from Figma when a ticket has a Figma URL in its description
-# FIGMA_API_KEY=your-figma-api-key
-
-# ─── Optional: Playwright visual checks ───────────────────────────────────────
-# Run a visual check after implementing UI tickets
-# PLAYWRIGHT_ENABLED=true
-# PLAYWRIGHT_DEV_COMMAND="yarn dev"
-# PLAYWRIGHT_DEV_PORT=5173
-# PLAYWRIGHT_STORYBOOK_COMMAND="yarn storybook"
-# PLAYWRIGHT_STORYBOOK_PORT=6006
-# PLAYWRIGHT_STARTUP_WAIT=15
-
-# ─── Optional: Planner queue ─────────────────────────────────────────────────
-# Label for unrefined tickets that /clancy:plan should fetch (default: needs-refinement)
-# CLANCY_PLAN_LABEL=needs-refinement
-
-# ─── Optional: Notifications ──────────────────────────────────────────────────
-# Webhook URL for Slack or Teams notifications on ticket completion
-# CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url
-
-# ─── Optional: Strategist ──────────────────────────────────────────────────
-# Default parent issue for text/file-sourced briefs
-# CLANCY_BRIEF_EPIC=50
-# Auto-set component label on created tickets
-# CLANCY_COMPONENT=api
-# Grill mode: "interactive" (human grill) or "afk" (AI-grill). Default: interactive
-# CLANCY_MODE=interactive
-
-# ─── Optional: Pipeline labels ────────────────────────────────────────────────
-# Labels that control ticket flow through pipeline stages.
-# CLANCY_LABEL_BRIEF marks tickets that have been briefed (awaiting approval).
-# CLANCY_LABEL_PLAN marks tickets that need planning.
-# CLANCY_LABEL_BUILD marks tickets ready for implementation.
-# Deprecated: CLANCY_LABEL (use CLANCY_LABEL_BUILD), CLANCY_PLAN_LABEL (use CLANCY_LABEL_PLAN)
-# CLANCY_LABEL_BRIEF="clancy:brief"
-# CLANCY_LABEL_PLAN="clancy:plan"
-# CLANCY_LABEL_BUILD="clancy:build"
-
-# ─── Optional: Reliable autonomous mode ─────────────────────────────────────
-# Max self-healing fix attempts before delivering with warnings (default: 2, 0 to disable)
-# CLANCY_FIX_RETRIES=2
-# Per-ticket time limit in minutes (default: 30, 0 to disable)
-# CLANCY_TIME_LIMIT=30
-# Block force push, protected branch push, destructive resets (default: true)
-# CLANCY_BRANCH_GUARD=true
-# Token estimation rate for cost logging (tokens/min, default: 6600)
-# CLANCY_TOKEN_RATE=6600

package/src/templates/.env.example.jira

@@ -1,102 +0,0 @@
-# Clancy — Jira configuration
-# Copy this file to .env and fill in your values.
-# Never commit .env to version control.
-
-# ─── Jira ─────────────────────────────────────────────────────────────────────
-JIRA_BASE_URL=https://your-org.atlassian.net
-JIRA_USER=your-email@example.com
-JIRA_API_TOKEN=your-api-token-from-id.atlassian.com
-JIRA_PROJECT_KEY=PROJ
-
-# Status name for "ready to be picked up" (default: To Do)
-# Must be quoted if the status name contains spaces (e.g. "Selected for Development")
-CLANCY_JQL_STATUS="To Do"
-
-# Set to any non-empty value to filter by open sprints (requires Jira Software)
-# Remove or leave empty if your project doesn't use sprints
-# CLANCY_JQL_SPRINT=true
-
-# Optional: only pick up tickets with this label. Recommended for mixed backlogs
-# where not every ticket is suitable for autonomous implementation (e.g. non-code tasks).
-# Create the label in Jira first, then add it to any ticket you want Clancy to pick up.
-# CLANCY_LABEL="clancy"
-
-# ─── Git ──────────────────────────────────────────────────────────────────────
-# Base integration branch. Clancy branches from here when a ticket has no parent epic.
-# When a ticket has a parent epic, Clancy auto-creates epic/{key} from this branch.
-CLANCY_BASE_BRANCH=main
-
-# ─── Optional roles ─────────────────────────────────────────────────────────
-# Comma-separated list of optional roles to enable (e.g. planner)
-# Core roles (implementer, reviewer, setup) are always active.
-# CLANCY_ROLES=planner,strategist
-
-# ─── Loop ─────────────────────────────────────────────────────────────────────
-# Max tickets to process per /clancy:run session (default: 5)
-MAX_ITERATIONS=5
-
-# ─── Model ────────────────────────────────────────────────────────────────────
-# Claude model used for each ticket session. Leave unset to use the default.
-# Options: claude-opus-4-6 | claude-sonnet-4-6 | claude-haiku-4-5
-# CLANCY_MODEL=claude-sonnet-4-6
-
-# ─── Optional: Figma MCP ──────────────────────────────────────────────────────
-# Fetch design specs from Figma when a ticket has a Figma URL in its description
-# FIGMA_API_KEY=your-figma-api-key
-
-# ─── Optional: Playwright visual checks ───────────────────────────────────────
-# Run a visual check after implementing UI tickets
-# PLAYWRIGHT_ENABLED=true
-# PLAYWRIGHT_DEV_COMMAND="yarn dev"
-# PLAYWRIGHT_DEV_PORT=5173
-# PLAYWRIGHT_STORYBOOK_COMMAND="yarn storybook"
-# PLAYWRIGHT_STORYBOOK_PORT=6006
-# PLAYWRIGHT_STARTUP_WAIT=15
-
-# ─── Optional: Planner queue ─────────────────────────────────────────────────
-# Status name for backlog tickets that /clancy:plan should fetch (default: Backlog)
-# CLANCY_PLAN_STATUS="Backlog"
-
-# ─── Optional: Status transitions ────────────────────────────────────────────
-# Move tickets automatically when Clancy picks up or completes them.
-# Set to the exact status name shown in your Jira board column header.
-# CLANCY_STATUS_IN_PROGRESS="In Progress"
-# CLANCY_STATUS_DONE="Done"
-
-# ─── Optional: Notifications ──────────────────────────────────────────────────
-# Webhook URL for Slack or Teams notifications on ticket completion
-# CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url
-
-# ─── Optional: Strategist ──────────────────────────────────────────────────
-# Issue type for tickets created by /clancy:approve-brief (default: Task)
-# CLANCY_BRIEF_ISSUE_TYPE=Task
-# Default parent epic for text/file-sourced briefs
-# CLANCY_BRIEF_EPIC=PROJ-100
-# Auto-set component on created tickets
-# CLANCY_COMPONENT=api
-# Grill mode: "interactive" (human grill) or "afk" (AI-grill). Default: interactive
-# CLANCY_MODE=interactive
-
-# ─── Optional: Pipeline labels ────────────────────────────────────────────────
-# Labels that control ticket flow through pipeline stages.
-# CLANCY_LABEL_BRIEF marks tickets that have been briefed (awaiting approval).
-# CLANCY_LABEL_PLAN marks tickets that need planning.
-# CLANCY_LABEL_BUILD marks tickets ready for implementation.
-# Deprecated: CLANCY_LABEL (use CLANCY_LABEL_BUILD), CLANCY_PLAN_LABEL (use CLANCY_LABEL_PLAN)
-# CLANCY_LABEL_BRIEF="clancy:brief"
-# CLANCY_LABEL_PLAN="clancy:plan"
-# CLANCY_LABEL_BUILD="clancy:build"
-
-# ─── Optional: Reliable autonomous mode ─────────────────────────────────────
-# Max self-healing fix attempts before delivering with warnings (default: 2, 0 to disable)
-# CLANCY_FIX_RETRIES=2
-# Per-ticket time limit in minutes (default: 30, 0 to disable)
-# CLANCY_TIME_LIMIT=30
-# Block force push, protected branch push, destructive resets (default: true)
-# CLANCY_BRANCH_GUARD=true
-# Token estimation rate for cost logging (tokens/min, default: 6600)
-# CLANCY_TOKEN_RATE=6600
-
-# ─── Optional: Status transitions (continued) ──────────────────────────────
-# Status for PR review (falls back to CLANCY_STATUS_DONE if not set)
-# CLANCY_STATUS_REVIEW="In Review"

package/src/templates/.env.example.linear

@@ -1,86 +0,0 @@
-# Clancy — Linear configuration
-# Copy this file to .env and fill in your values.
-# Never commit .env to version control.
-
-# ─── Linear ───────────────────────────────────────────────────────────────────
-LINEAR_API_KEY=lin_api_your-personal-api-key
-LINEAR_TEAM_ID=your-team-uuid
-
-# Optional: only pick up issues with this label. Recommended for mixed backlogs
-# where not every issue is suitable for autonomous implementation (e.g. non-code tasks).
-# Create the label in Linear first, then add it to any issue you want Clancy to pick up.
-# CLANCY_LABEL=clancy
-
-# ─── Git ──────────────────────────────────────────────────────────────────────
-# Base integration branch. Clancy branches from here when an issue has no parent.
-# When an issue has a parent, Clancy auto-creates epic/{key} from this branch.
-CLANCY_BASE_BRANCH=main
-
-# ─── Optional roles ─────────────────────────────────────────────────────────
-# Comma-separated list of optional roles to enable (e.g. planner)
-# Core roles (implementer, reviewer, setup) are always active.
-# CLANCY_ROLES=planner,strategist
-
-# ─── Loop ─────────────────────────────────────────────────────────────────────
-# Max tickets to process per /clancy:run session (default: 20)
-MAX_ITERATIONS=20
-
-# ─── Model ────────────────────────────────────────────────────────────────────
-# Claude model used for each ticket session. Leave unset to use the default.
-# Options: claude-opus-4-6 | claude-sonnet-4-6 | claude-haiku-4-5
-# CLANCY_MODEL=claude-sonnet-4-6
-
-# ─── Optional: Figma MCP ──────────────────────────────────────────────────────
-# Fetch design specs from Figma when a ticket has a Figma URL in its description
-# FIGMA_API_KEY=your-figma-api-key
-
-# ─── Optional: Playwright visual checks ───────────────────────────────────────
-# Run a visual check after implementing UI tickets
-# PLAYWRIGHT_ENABLED=true
-# PLAYWRIGHT_DEV_COMMAND="yarn dev"
-# PLAYWRIGHT_DEV_PORT=5173
-# PLAYWRIGHT_STORYBOOK_COMMAND="yarn storybook"
-# PLAYWRIGHT_STORYBOOK_PORT=6006
-# PLAYWRIGHT_STARTUP_WAIT=15
-
-# ─── Optional: Planner queue ─────────────────────────────────────────────────
-# State type for backlog issues that /clancy:plan should fetch (default: backlog)
-# CLANCY_PLAN_STATE_TYPE=backlog
-
-# ─── Optional: Status transitions ────────────────────────────────────────────
-# Move issues automatically when Clancy picks up or completes them.
-# Set to the exact workflow state name shown in your Linear board column header.
-# CLANCY_STATUS_IN_PROGRESS="In Progress"
-# CLANCY_STATUS_DONE="Done"
-
-# ─── Optional: Notifications ──────────────────────────────────────────────────
-# Webhook URL for Slack or Teams notifications on ticket completion
-# CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url
-
-# ─── Optional: Strategist ──────────────────────────────────────────────────
-# Default parent issue for text/file-sourced briefs
-# CLANCY_BRIEF_EPIC=ENG-100
-# Auto-set component label on created tickets
-# CLANCY_COMPONENT=api
-# Grill mode: "interactive" (human grill) or "afk" (AI-grill). Default: interactive
-# CLANCY_MODE=interactive
-
-# ─── Optional: Pipeline labels ────────────────────────────────────────────────
-# Labels that control ticket flow through pipeline stages.
-# CLANCY_LABEL_BRIEF marks tickets that have been briefed (awaiting approval).
-# CLANCY_LABEL_PLAN marks tickets that need planning.
-# CLANCY_LABEL_BUILD marks tickets ready for implementation.
-# Deprecated: CLANCY_LABEL (use CLANCY_LABEL_BUILD), CLANCY_PLAN_LABEL (use CLANCY_LABEL_PLAN)
-# CLANCY_LABEL_BRIEF="clancy:brief"
-# CLANCY_LABEL_PLAN="clancy:plan"
-# CLANCY_LABEL_BUILD="clancy:build"
-
-# ─── Optional: Reliable autonomous mode ─────────────────────────────────────
-# Max self-healing fix attempts before delivering with warnings (default: 2, 0 to disable)
-# CLANCY_FIX_RETRIES=2
-# Per-ticket time limit in minutes (default: 30, 0 to disable)
-# CLANCY_TIME_LIMIT=30
-# Block force push, protected branch push, destructive resets (default: true)
-# CLANCY_BRANCH_GUARD=true
-# Token estimation rate for cost logging (tokens/min, default: 6600)
-# CLANCY_TOKEN_RATE=6600