feature

Orchestrates new feature development in isolated git worktrees with TDD and verification gates.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/levori119/skyboard --skill feature-levori119
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature
Source: https://github.com/levori119/skyboard/tree/main/.claude/skills/feature
Command: npx skills add https://github.com/levori119/skyboard --skill feature-levori119

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When multiple developers or AI agents work on the same repository simultaneously, they overwrite each other's changes silently and break shared builds. This Skill enforces an isolated git worktree workflow so each feature is built on its own branch and directory without collisions. ## Core Features & Use Cases - Isolated Worktree Setup: Creates a dedicated git worktree and feature branch per feature, with automatic node_modules linking and .env copying. - Structured Development Pipeline: Guides planning (user stories, architecture, DRY checks), test-driven development (failing tests first, then implementation), and verification (tsc, tests, build, smoke tests). - Parallel Agent Coordination: Defines ownership boundaries, shared contracts, and merge sequencing so multiple agents can work concurrently on the same repo and shared database. - Use Case: You want to build a new 'transfer-eta-colors' feature while another agent works on a different feature. Run this workflow to spin up an isolated worktree, write tests first, implement, verify, and merge cleanly. ## Quick Start Start a new feature called transfer-eta-colors using the feature workflow to set up an isolated worktree and follow the TDD pipeline.

Frequently Asked Questions about feature

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

FAQPage Schema
How do I run multiple AI coding agents in parallel on one repo?

Assign each agent its own git worktree and feature branch so filesystem-level isolation prevents silent overwrites. Define shared contracts and ownership boundaries first, then merge one branch at a time with a build verification after each merge.

How do I create a git worktree for a new feature branch?

Run git worktree add with a new branch, for example git worktree add ../skyboard-name -b feature/name. Copy gitignored files like .env manually since they do not transfer automatically.

Why should tests be written before implementation in TDD?

Writing failing tests first confirms they actually test the intended behavior and creates a checkpoint commit as a safety net. If later code fixes a test instead of implementing the feature, the diff exposes the shortcut.

Can two agents share the same git worktree safely?

No. Two agents writing to the same working tree silently overwrite each other because git does not warn about concurrent edits, and the last write wins. Each agent must get its own worktree before writing any code.

How do I avoid port conflicts when running dev servers in parallel worktrees?

Change the PORT value in each worktree's .env file and update the dev server proxy configuration to match. If you only write code and run type checks or tests without launching the app, no port changes are needed.

What are the limits of parallel worktree development with a shared database?

A shared database means concurrent migrations can conflict, so schema changes must be coordinated and ALTER statements should not run simultaneously. Practical concurrency caps around four to eight worktrees before review throughput becomes the bottleneck.