chief-clancy 0.5.10 → 0.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 **Autonomous, board-driven development for Claude Code.**
 
-[![npm](https://img.shields.io/npm/v/chief-clancy?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/chief-clancy) [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](./LICENSE) [![Tests](https://img.shields.io/badge/tests-473%20passing-brightgreen?style=for-the-badge)](docs/TESTING.md) [![GitHub Stars](https://img.shields.io/github/stars/Pushedskydiver/clancy?style=for-the-badge)](https://github.com/Pushedskydiver/clancy/stargazers)
+[![npm](https://img.shields.io/npm/v/chief-clancy?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/chief-clancy) [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](./LICENSE) [![Tests](https://img.shields.io/badge/tests-579%20passing-brightgreen?style=for-the-badge)](docs/TESTING.md) [![GitHub Stars](https://img.shields.io/github/stars/Pushedskydiver/clancy?style=for-the-badge)](https://github.com/Pushedskydiver/clancy/stargazers)
 
 > [!WARNING]
 > Clancy is in early development. Expect bugs, breaking changes, and rough edges. If you hit an issue, please [open a bug report](https://github.com/Pushedskydiver/clancy/issues/new).
@@ -25,14 +25,15 @@ Named after Chief Clancy Wiggum (The Simpsons) — built on the [Ralph technique
 
 ## What it does
 
-Clancy does four things:
+Clancy does five things:
 
 1. **Scaffolds itself** into a project — scripts, docs, CLAUDE.md, .clancy/.env
 2. **Scans your codebase** with 5 parallel specialist agents and writes 10 structured docs that Claude reads before every run
-3. **Plans tickets** — fetches backlog tickets, explores the codebase, and generates structured implementation plans posted as comments for human review
-4. **Runs autonomously** — picking one ticket per loop from your Kanban board, implementing it, committing, and either squash-merging (epic flow) or pushing and creating a PR (standalone ticket flow)
+3. **Writes strategy briefs** — interviews you (or runs a devil's advocate AI-grill in AFK mode), decomposes work into vertical slices with HITL/AFK classification, and creates board tickets with blocking dependencies
+4. **Plans tickets** — fetches backlog tickets, explores the codebase, and generates structured implementation plans posted as comments for human review
+5. **Runs autonomously** — picking one ticket per loop from your Kanban board (skipping blocked candidates), implementing it, committing, and creating a PR (targeting an epic branch for parented tickets, or the base branch for standalone tickets)
 
-One ticket per run. Fresh context window every iteration. No context rot.
+Brief → approve → plan → implement. One ticket per run. Fresh context window every iteration. No context rot.
 
 ---
 
@@ -63,7 +64,7 @@ Clancy is powerful but not magic. Here's what to expect:
 
 **Ticket quality matters more than you think.** A vague ticket produces vague implementation. Clancy works best when tickets have a clear summary, a description that explains the _why_, and concrete acceptance criteria. Use `/clancy:review` to score a ticket before running — it'll tell you exactly what's missing.
 
-**You still own the code.** When a ticket has a parent epic, Clancy squash-merges locally — review the commit before pushing. When a ticket has no parent, Clancy pushes the feature branch and creates a pull request for you to review. Either way, treat it like code from a junior developer who works very fast — it needs a sanity check, not a full rewrite.
+**You still own the code.** Clancy pushes a feature branch and creates a pull request for every ticket — targeting an epic branch for parented tickets, or the base branch for standalone ones. When all children of an epic are done, Clancy creates a final PR from the epic branch to your base branch. Either way, treat it like code from a junior developer who works very fast — it needs a sanity check, not a full rewrite.
 
 **Some tickets will need a retry.** If Claude gets stuck or produces something obviously wrong, delete the branch and run `/clancy:once` again. Fresh context, fresh attempt. If it fails twice on the same ticket, the ticket probably needs more detail.
 
@@ -149,6 +150,8 @@ npx chief-clancy
 
 | Command                | Description                                                              |
 | ---------------------- | ------------------------------------------------------------------------ |
+| `/clancy:brief` ²      | Grill phase → strategy brief → vertical slice decomposition → tickets    |
+| `/clancy:approve-brief` ² | Review and approve a strategy brief, then create board tickets         |
 | `/clancy:plan` ¹       | Refine backlog tickets into structured implementation plans              |
 | `/clancy:plan 3` ¹     | Plan up to 3 tickets in batch mode                                       |
 | `/clancy:approve-plan` ¹ | Promote an approved plan to the ticket description                     |
@@ -169,6 +172,7 @@ npx chief-clancy
 | `/clancy:help`         | Command reference                                                        |
 
 ¹ Planner is an optional role — see [Roles](#roles) below.
+² Strategist is an optional role — see [Roles](#roles) below.
 
 ---
 
@@ -182,12 +186,13 @@ Clancy organises its commands into **roles** — each role handles a different s
 | **Reviewer** | Score ticket readiness and track progress | `/clancy:review`, `/clancy:status`, `/clancy:logs` |
 | **Setup** | Configure and maintain Clancy | `/clancy:init`, `/clancy:settings`, `/clancy:doctor`, etc. |
 | **Planner** *(optional)* | Refine backlog tickets into structured implementation plans | `/clancy:plan`, `/clancy:approve-plan` |
+| **Strategist** *(optional)* | Grill → brief → vertical slices → board tickets | `/clancy:brief`, `/clancy:approve-brief` |
 
-**Core roles** (Implementer, Reviewer, Setup) are always installed. **Optional roles** (Planner) are opt-in — add them to `CLANCY_ROLES` in `.clancy/.env` and re-run the installer:
+**Core roles** (Implementer, Reviewer, Setup) are always installed. **Optional roles** (Planner, Strategist) are opt-in — add them to `CLANCY_ROLES` in `.clancy/.env` and re-run the installer:
 
 ```bash
-# Enable the Planner role
-echo 'CLANCY_ROLES="planner"' >> .clancy/.env
+# Enable optional roles
+echo 'CLANCY_ROLES="planner,strategist"' >> .clancy/.env
 npx chief-clancy@latest --local   # or --global
 ```
 
@@ -199,6 +204,9 @@ Each role has detailed documentation:
 - [Reviewer](docs/roles/REVIEWER.md) — scores ticket readiness, tracks progress
 - [Setup & Maintenance](docs/roles/SETUP.md) — init wizard, settings, diagnostics, codebase mapping
 - [Planner](docs/roles/PLANNER.md) — refines backlog tickets into structured implementation plans
+- [Strategist](docs/roles/STRATEGIST.md) — grill phase, strategy briefs, vertical slice decomposition, board ticket creation
+
+For a visual overview of how roles, commands, and flows connect, see the [Visual Architecture](docs/VISUAL-ARCHITECTURE.md) diagrams.
 
 ---
 

package/dist/bundle/clancy-afk.js

@@ -1,2 +1,2 @@
-import{spawnSync as k}from"node:child_process";import{existsSync as h}from"node:fs";import{dirname as w,join as T,resolve as y}from"node:path";import{setTimeout as S}from"node:timers/promises";import{fileURLToPath as g}from"node:url";function c(o){let t=Math.floor(o/1e3);if(t<60)return`${t}s`;let r=Math.floor(t/60),s=t%60;return s>0?`${r}m ${s}s`:`${r}m`}var e=o=>`\x1B[2m${o}\x1B[0m`,a=o=>`\x1B[1m${o}\x1B[0m`;var u=o=>`\x1B[32m${o}\x1B[0m`,p=o=>`\x1B[31m${o}\x1B[0m`;var m={noTickets:/No tickets found|No issues found|All done/,skipped:/Ticket skipped/,preflightFail:/^✗ /m};function D(o){return m.noTickets.test(o)?{stop:!0,reason:"No more tickets \u2014 all done"}:m.skipped.test(o)?{stop:!0,reason:"Ticket was skipped \u2014 update the ticket and re-run"}:m.preflightFail.test(o)?{stop:!0,reason:"Preflight check failed"}:{stop:!1}}async function A(o,t=5){let r=T(o,"clancy-once.js");if(!h(r)){console.error(p("\u2717 clancy-once.js not found in"),o);return}console.log(e("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510")),console.log(e("\u2502")+a("  \u{1F916} Clancy \u2014 AFK mode                                  ")+e("\u2502")),console.log(e("\u2502")+e(`  "I'm on it. Proceed to the abandoned warehouse."       `)+e("\u2502")),console.log(e("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"));let s=Date.now();for(let n=1;n<=t;n++){let x=Date.now();console.log(""),console.log(a(`\u{1F501} Iteration ${n}/${t}`));let i=k("node",[r],{encoding:"utf8",stdio:["inherit","pipe","inherit"],cwd:process.cwd()}),l=i.stdout??"";l&&process.stdout.write(l);let d=c(Date.now()-x);if(i.error){console.error(p(`\u2717 Failed to run clancy-once: ${i.error.message}`));return}let f=D(l);if(f.stop){let b=c(Date.now()-s);console.log(""),console.log(e(`  Iteration ${n} took ${d}`)),console.log(`
-${f.reason}`),console.log(e(`  Total: ${n} iteration${n>1?"s":""} in ${b}`));return}console.log(e(`  Iteration ${n} took ${d}`)),n<t&&await S(2e3)}let $=c(Date.now()-s);console.log(""),console.log(u(`\u{1F3C1} Completed ${t} iterations`)+e(` (${$})`)),console.log(e(`  "That's some good police work."`)),console.log(e("  Run clancy-afk again to continue."))}if(process.argv[1]&&g(import.meta.url)===y(process.argv[1])){let o=w(g(import.meta.url)),t=parseInt(process.env.MAX_ITERATIONS??"5",10)||5;A(o,t)}export{D as checkStopCondition,A as runAfkLoop};
+import{spawnSync as k}from"node:child_process";import{existsSync as h}from"node:fs";import{dirname as w,join as T,resolve as y}from"node:path";import{setTimeout as S}from"node:timers/promises";import{fileURLToPath as g}from"node:url";function c(o){let t=Math.floor(o/1e3);if(t<60)return`${t}s`;let r=Math.floor(t/60),s=t%60;return s>0?`${r}m ${s}s`:`${r}m`}var e=o=>`\x1B[2m${o}\x1B[0m`,a=o=>`\x1B[1m${o}\x1B[0m`;var u=o=>`\x1B[32m${o}\x1B[0m`,p=o=>`\x1B[31m${o}\x1B[0m`;var m={noTickets:/No tickets found|No issues found|All done/,skipped:/Ticket skipped/,preflightFail:/^✗ /m};function A(o){return m.noTickets.test(o)?{stop:!0,reason:"No more tickets \u2014 all done"}:m.skipped.test(o)?{stop:!0,reason:"Ticket was skipped \u2014 update the ticket and re-run"}:m.preflightFail.test(o)?{stop:!0,reason:"Preflight check failed"}:{stop:!1}}async function D(o,t=5){let r=T(o,"clancy-once.js");if(!h(r)){console.error(p("\u2717 clancy-once.js not found in"),o);return}console.log(e("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510")),console.log(e("\u2502")+a("  \u{1F916} Clancy \u2014 AFK mode                                  ")+e("\u2502")),console.log(e("\u2502")+e(`  "I'm on it. Proceed to the abandoned warehouse."       `)+e("\u2502")),console.log(e("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"));let s=Date.now();for(let n=1;n<=t;n++){let x=Date.now();console.log(""),console.log(a(`\u{1F501} Iteration ${n}/${t}`));let i=k("node",[r],{encoding:"utf8",stdio:["inherit","pipe","inherit"],cwd:process.cwd(),env:{...process.env,CLANCY_AFK_MODE:"1"}}),l=i.stdout??"";l&&process.stdout.write(l);let d=c(Date.now()-x);if(i.error){console.error(p(`\u2717 Failed to run clancy-once: ${i.error.message}`));return}let f=A(l);if(f.stop){let b=c(Date.now()-s);console.log(""),console.log(e(`  Iteration ${n} took ${d}`)),console.log(`
+${f.reason}`),console.log(e(`  Total: ${n} iteration${n>1?"s":""} in ${b}`));return}console.log(e(`  Iteration ${n} took ${d}`)),n<t&&await S(2e3)}let $=c(Date.now()-s);console.log(""),console.log(u(`\u{1F3C1} Completed ${t} iterations`)+e(` (${$})`)),console.log(e(`  "That's some good police work."`)),console.log(e("  Run clancy-afk again to continue."))}if(process.argv[1]&&g(import.meta.url)===y(process.argv[1])){let o=w(g(import.meta.url)),t=parseInt(process.env.MAX_ITERATIONS??"5",10)||5;D(o,t)}export{A as checkStopCondition,D as runAfkLoop};