Clancy

Autonomous development for Claude Code — driven by your Kanban board, or by local plan files.

npx chief-clancy

[!WARNING] Clancy is in early development. Expect breaking changes and rough edges.

Clancy scaffolds slash commands, hooks, and board integrations into your Claude Code project. It picks up tickets from your Kanban board (Jira, GitHub Issues, Linear, Shortcut, Notion, or Azure DevOps), implements them autonomously, and creates pull requests. Also supports local plan execution via --from — no board needed.

How it works

With a board:

1. Install: npx chief-clancy — choose global or local install
2. Configure: /clancy:init — connect your board, enter credentials
3. Scan: /clancy:map-codebase — 5 parallel agents document your codebase
4. Run: /clancy:implement — pick up one ticket, implement, create PR
5. Go AFK: /clancy:autopilot — loop through your backlog unattended

Without a board — local plan-driven flow:

1. Install: npx chief-clancy
2. Configure: /clancy:init — answer "No" when asked about a board. When prompted for optional roles, enable both Strategist and Planner — the local flow uses /clancy:brief and /clancy:plan, which only install when their roles are enabled.
3. Scan: /clancy:map-codebase
4. Draft: /clancy:brief --from outline.md → /clancy:plan --from <brief> → /clancy:approve-plan <plan> (writes a .approved marker file — a write-side contract; a future PR will wire a runtime gate that re-hashes the plan and refuses to run on mismatch)
5. Run one plan: /clancy:implement --from .clancy/plans/<plan>.md
6. Go AFK: /clancy:implement --from .clancy/plans/ --afk — batch-executes every plan in the directory that has a sibling .approved marker, naturally sorted. Unapproved plans are skipped with a warning. (Marker SHA-256 verification is deferred — only marker existence is currently checked.)

Packages

This is the CLI entry point for the Clancy monorepo. It delegates to:

• @chief-clancy/core — board integrations, schemas, shared utilities
• @chief-clancy/terminal — installer, slash commands, hooks, runners
• @chief-clancy/dev — standalone ticket executor
• @chief-clancy/scan — codebase scanning agents and workflows
• @chief-clancy/brief — strategic brief generator
• @chief-clancy/plan — implementation planner

Documentation

• Getting started
• Commands
• Configuration
• Security
• Troubleshooting

Credits

Built on the Ralph technique by Geoffrey Huntley. See CREDITS.md.

License

MIT — see LICENSE.