New Bean

Create a new bean directory, tasks subfolder, and backlog entry.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/beekeeper-lab/foundry --skill new-bean
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: New Bean
Source: https://github.com/beekeeper-lab/foundry/tree/main/.claude/skills/new-bean
Command: npx skills add https://github.com/beekeeper-lab/foundry --skill new-bean

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Backlog management for beans is manual and error-prone; this skill automates creating the next bean, its directory with a tasks subfolder, populating a bean document from the template, and updating the backlog index.

Core Features & Use Cases

  • Automates the creation of a new bean with a unique ID, prepares the bean directory and tasks subfolder, and fills bean.md from the bean template.
  • Updates the backlog index with the new bean entry to keep project tracking in sync.
  • Validates against duplicates and ensures readable slug generation for consistency across the backlog.

Quick Start

Invoke the /new-bean command with a title to create the bean, generate its ID, and update the backlog.

Frequently Asked Questions about New Bean

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate backlog item creation for project management?

Automating backlog item creation involves reading the backlog index to derive the next sequential ID, creating a dedicated directory with a tasks subfolder, populating a markdown template, and updating the index to eliminate manual tracking errors.

What is a bean in the context of project backlog management?

A bean is a project work item within a specific beans workflow. It consists of a unique BEAN-NNN identifier, a dedicated directory containing a tasks subfolder, and a populated markdown document tracking its progress in the backlog.

How do I generate the next sequential work item ID in my backlog?

To generate the next sequential work item ID, the system reads the existing backlog index to determine the latest number, automatically derives the next BEAN-NNN identifier, and validates it against duplicates for consistency.

Can I use a command to trigger automated project backlog updates?

Yes, you can trigger automated project backlog updates by invoking the /new-bean command with a title. This initiates the workflow to generate the ID, create directories, populate the template, and sync the backlog index.

Does the beans workflow support duplicate ID validation for backlog items?

Yes, the beans workflow supports duplicate ID validation. When creating a new bean, the system reads the backlog index and validates the generated slug and BEAN-NNN identifier against existing entries to ensure readable consistency.

What directories and files are created when establishing a new backlog work item?

Establishing a new backlog work item creates a dedicated bean directory containing a tasks subdirectory and a populated bean.md file generated from a template, while concurrently updating the main backlog index file.