feature

Create an isolated git worktree and branch for TDD-driven feature development.

19|2|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/bjornjee/agent-dashboard --skill feature-bjornjee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature
Source: https://github.com/bjornjee/agent-dashboard/tree/main/adapters/claude-code/skills/feature
Command: npx skills add https://github.com/bjornjee/agent-dashboard --skill feature-bjornjee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents messy, unsafe feature development by creating an isolated git worktree from the latest main branch and enforcing a TDD-style workflow with explicit planning gates.

Core Features & Use Cases

  • Isolated feature worktree + branch: Creates a feat/<name> branch and a corresponding worktree under ../worktrees/<app>/<name>, based on the provided feature description.
  • Environment bootstrapping with safety sentinels: Runs a background environment setup agent that detects project type, installs dependencies, symlinks large source-content directories, and records success/failure via sentinel files.
  • Guarded implementation workflow: Forces a research-first planning process, collects required user decisions via structured questions, drafts the plan in plan mode, then implements using strict RED → GREEN → REFACTOR with make test.

Quick Start

Tell the assistant to start a feature named for what you want to build, and confirm the gated decisions when prompted.

Frequently Asked Questions about feature

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

FAQPage Schema
How do I start a new git feature branch without affecting my main working directory?

Git worktrees allow you to start a new feature branch in an isolated directory, keeping your main branch clean. This Skill automates creating that isolated worktree from the latest main and bootstraps the environment so you can develop safely.

How do I enforce test-driven development workflow when building a new feature?

To enforce test-driven development, this Skill applies a strict RED, GREEN, REFACTOR workflow gated by plan-mode. It forces a research-first planning phase and validates implementation using make test before proceeding.

Can I automate environment setup and dependency installation for isolated git worktrees?

Yes, you can automate environment setup for git worktrees. This Skill runs a background agent that detects the project type, installs dependencies, copies required env files, and symlinks large directories using safety sentinels.

What is the best way to manage large source directories when creating a feature worktree?

The best way to manage large directories in a feature worktree is through safe symlinking. This Skill automatically symlinks large source-content directories from the main repository to avoid duplication and reduce setup time.

Does this TDD worktree workflow require conventional commits or a specific test runner?

This TDD worktree workflow validates implementation specifically through the make test command. While it creates a structured feat/<name> branch, the metadata does not enforce conventional commits as a strict requirement.

Why do I need a planning gate before writing code in a TDD workflow?

A planning gate is needed in TDD to collect required user decisions and draft a structured plan before implementation. This prevents scope drift and ensures the RED, GREEN, REFACTOR cycles target the correct behavior from the start.