chief-clancy 0.4.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/README.md +32 -3
  2. package/dist/bundle/clancy-once.js +23 -23
  3. package/dist/installer/install.js +64 -12
  4. package/dist/installer/install.js.map +1 -1
  5. package/dist/schemas/env.d.ts +16 -0
  6. package/dist/schemas/env.d.ts.map +1 -1
  7. package/dist/schemas/env.js +4 -0
  8. package/dist/schemas/env.js.map +1 -1
  9. package/package.json +4 -1
  10. package/src/roles/planner/commands/approve.md +3 -6
  11. package/src/roles/planner/commands/plan.md +5 -6
  12. package/src/roles/planner/workflows/approve.md +236 -2
  13. package/src/roles/planner/workflows/plan.md +398 -2
  14. package/src/roles/reviewer/workflows/logs.md +14 -6
  15. package/src/roles/reviewer/workflows/review.md +7 -1
  16. package/src/roles/setup/commands/help.md +9 -0
  17. package/src/roles/setup/workflows/init.md +85 -41
  18. package/src/roles/setup/workflows/map-codebase.md +1 -1
  19. package/src/roles/setup/workflows/settings.md +137 -44
  20. package/src/roles/setup/workflows/update-docs.md +5 -2
  21. package/src/roles/setup/workflows/update.md +29 -25
  22. package/src/templates/.env.example.github +9 -0
  23. package/src/templates/.env.example.jira +9 -0
  24. package/src/templates/.env.example.linear +9 -0
  25. package/src/templates/CLAUDE.md +4 -1
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Autonomous, board-driven development for Claude Code.**
4
4
 
5
- [![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-162%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)
5
+ [![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-163%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)
6
6
 
7
7
  > [!WARNING]
8
8
  > 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,11 +25,12 @@ Named after Chief Clancy Wiggum (The Simpsons) — built on the [Ralph technique
25
25
 
26
26
  ## What it does
27
27
 
28
- Clancy does three things:
28
+ Clancy does four things:
29
29
 
30
30
  1. **Scaffolds itself** into a project — scripts, docs, CLAUDE.md, .clancy/.env
31
31
  2. **Scans your codebase** with 5 parallel specialist agents and writes 10 structured docs that Claude reads before every run
32
- 3. **Runs autonomously** — picking one ticket per loop from your Kanban board, implementing it, committing, squash-merging, and logging progress
32
+ 3. **Plans tickets** — fetches backlog tickets, explores the codebase, and generates structured implementation plans posted as comments for human review
33
+ 4. **Runs autonomously** — picking one ticket per loop from your Kanban board, implementing it, committing, squash-merging, and logging progress
33
34
 
34
35
  One ticket per run. Fresh context window every iteration. No context rot.
35
36
 
@@ -148,6 +149,9 @@ npx chief-clancy
148
149
 
149
150
  | Command | Description |
150
151
  | ---------------------- | ------------------------------------------------------------------------ |
152
+ | `/clancy:plan` ¹ | Refine backlog tickets into structured implementation plans |
153
+ | `/clancy:plan 3` ¹ | Plan up to 3 tickets in batch mode |
154
+ | `/clancy:approve` ¹ | Promote an approved plan to the ticket description |
151
155
  | `/clancy:init` | Wizard — choose board, collect config, scaffold everything |
152
156
  | `/clancy:run` | Loop mode — processes tickets until queue is empty or MAX_ITERATIONS hit |
153
157
  | `/clancy:run 20` | Same, override MAX_ITERATIONS to 20 for this session |
@@ -164,6 +168,31 @@ npx chief-clancy
164
168
  | `/clancy:uninstall` | Remove Clancy commands — optionally remove `.clancy/` too |
165
169
  | `/clancy:help` | Command reference |
166
170
 
171
+ ¹ Planner is an optional role — see [Roles](#roles) below.
172
+
173
+ ---
174
+
175
+ ## Roles
176
+
177
+ Clancy organises its commands into **roles** — each role handles a different stage of the development workflow.
178
+
179
+ | Role | Purpose | Commands |
180
+ | --- | --- | --- |
181
+ | **Implementer** | Plan → code. Picks up tickets, implements, commits, merges | `/clancy:once`, `/clancy:run`, `/clancy:dry-run` |
182
+ | **Reviewer** | Score ticket readiness and track progress | `/clancy:review`, `/clancy:status`, `/clancy:logs` |
183
+ | **Setup** | Configure and maintain Clancy | `/clancy:init`, `/clancy:settings`, `/clancy:doctor`, etc. |
184
+ | **Planner** *(optional)* | Refine backlog tickets into structured implementation plans | `/clancy:plan`, `/clancy:approve` |
185
+
186
+ **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:
187
+
188
+ ```bash
189
+ # Enable the Planner role
190
+ echo 'CLANCY_ROLES="planner"' >> .clancy/.env
191
+ npx chief-clancy@latest --local # or --global
192
+ ```
193
+
194
+ You can also toggle roles from within Claude Code using `/clancy:settings`.
195
+
167
196
  ---
168
197
 
169
198
  ## What gets created