@jsedlak/ai

A CLI tool that installs AI Coding Agent files and commands for Task-based development workflows.

Overview

This package scaffolds template files that enable a structured, task-driven approach to AI-assisted software development. It installs prompt templates and commands that help AI coding agents (like Claude, Cursor, etc.) follow a consistent workflow:

1. Create a PRD - Generate a Product Requirements Document from a feature request
2. Generate Tasks - Break down the PRD into actionable, step-by-step tasks
3. Process Tasks - Execute tasks one at a time with proper tracking and version control

Installation

npx @jsedlak/ai init

This command copies the template files into your current project directory.

What Gets Installed

.ai/ Directory

Prompt templates for AI agents:

• create-prd.md - Instructions for generating a Product Requirements Document with clarifying questions
• generate-tasks.md - Instructions for breaking down requirements into parent tasks and sub-tasks
• process-tasks.md - Guidelines for executing tasks with proper completion tracking and git commits

.claude/commands/ Directory

Claude-specific slash commands that reference the .ai/ templates:

• create-prd.md - /create-prd command
• create-tasks.md - /create-tasks command
• process-tasks.md - /process-tasks command

Workflow

1. Create a PRD

Start by describing your feature. The AI will ask clarifying questions and generate a structured PRD saved to .prd/[feature-name]/prd.md.

2. Generate Tasks

Point the AI at your PRD to generate a task list. The AI first creates high-level parent tasks, waits for confirmation, then generates detailed sub-tasks. Output is saved to .prd/[feature-name]/tasks.md.

3. Process Tasks

Work through tasks one sub-task at a time. The AI:

• Marks completed sub-tasks with [x]
• Runs tests after completing all sub-tasks of a parent task
• Creates git commits with descriptive messages
• Waits for your approval before proceeding to the next task

CLI Commands

npx @jsedlak/ai init               # Initialize project with template files
npx @jsedlak/ai skill add <name>   # Add a skill to the current project
npx @jsedlak/ai skill remove <name> # Remove a skill from the current project
npx @jsedlak/ai skill list         # List all available skills
npx @jsedlak/ai -v                 # Show version
npx @jsedlak/ai -h                 # Show help

Skills

Skills are domain-specific knowledge packages that provide AI agents with specialized context for development tasks. Each skill contains documentation and examples that get installed into your project's .claude/skills/ directory.

Adding a Skill

npx @jsedlak/ai skill add dotnet/orleans

This copies the skill's files into .claude/skills/dotnet/orleans/, making them available as context for AI coding agents.

Removing a Skill

npx @jsedlak/ai skill remove dotnet/orleans

This removes the skill from .claude/skills/ and cleans up any empty parent directories.

Listing Available Skills

npx @jsedlak/ai skill list

Displays all built-in skills that can be added to your project.

Requirements

• Node.js 18 or higher

Acknowledgments

This project is based on the task-driven development workflow patterns from ai-dev-tasks by snarktank.

License

Apache-2.0