How does the worktree flag help with parallel development?

By using the --worktree flag, the skill creates an isolated git worktree, allowing you to work on multiple tasks simultaneously in different directories without the need to switch branches in your main working area.

Is a clean working tree required before running init?

Yes, the skill requires no uncommitted changes to tracked files to ensure that the new task branch starts from a clean, known state.

What happens if the git branch already exists?

The skill performs a collision check and will abort the process to prevent overwriting existing work, suggesting you delete the old branch or choose a new notebook name.

Can I customize the task requirements after initialization?

Yes, the skill generates a .target.md file specifically for human authoring. You can define objectives, requirements, and constraints there, which subsequent skills like 'plan' will use as context.

Task Lifecycle Initializer

Name: Task Lifecycle Initializer
Author: huacheng

byhuacheng

•

Productivity & Workflow

Initializes structured task working directories with automated git branch management and lifecycle tracking files.

The Task Lifecycle Initializer is the entry point for structured AI-driven development, setting up a standardized environment for new features, bug fixes, or refactoring tasks. It automates the creation of project and notebook directories, handles git branch creation or worktree isolation, and generates essential system files like .status.json and .target.md. By establishing a consistent directory structure and state machine from the start, it ensures that subsequent AI operations have the necessary context and tracking capabilities to manage the full software development lifecycle.

Key Features

011 GitHub stars

02Standardized directory structure for projects and notebooks

03Automated git branch and optional worktree management

04Built-in validation for naming conventions and git repository state

05Generates human-editable .target.md requirement templates

06Initializes .status.json for state machine and metadata tracking

Use Cases

01Setting up a structured bug fix environment with lifecycle tracking

02Starting a new feature development with an isolated git context

03Managing multiple parallel tasks using isolated git worktrees

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add huacheng/moonview init

For use in Claude.ai and ChatGPT

Download Skill