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.