starting-the-task

Automate the bd issue kickoff with baseline tests, feature branch, draft PR, and tracker updates.

2|1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/lambdamechanic/skills --skill starting-the-task
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: starting-the-task
Source: https://github.com/lambdamechanic/skills/tree/main/starting-the-task
Command: npx skills add https://github.com/lambdamechanic/skills --skill starting-the-task

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Starting a new development task without proper planning, environment setup, or tracking can lead to wasted effort, conflicts, and delays. This Skill provides a concise checklist to ensure every task begins effectively, grounded, observable, and reversible, helping you automate the initial setup.

Core Features & Use Cases

  • Understand the Task: Guides on reading issue trackers, confirming acceptance criteria, and clarifying questions before touching code.
  • Environment Readiness: Ensures the baseline development environment is green by running tests on main before diverging.
  • Branch & Tracking: Standardizes creating fresh branches and updating issue trackers (bd) to reflect new ownership and status.
  • Open a Draft PR (immediately): Prompts for opening a draft PR early to enable CI runs and stakeholder tracking.
  • Sync & Tooling: Verifies git pull --rebase and GitHub CLI authentication for smooth workflow.
  • Plan Tests Early: Encourages deciding on validation methods (unit, integration, manual) upfront and capturing the plan.

Quick Start

I'm about to start working on bd issue #123. Guide me through the "starting the task" checklist.

Frequently Asked Questions about starting-the-task

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

FAQPage Schema
How do I start a development task with proper planning and tracking?

Starting a task involves understanding acceptance criteria, running baseline tests on main, creating a feature branch, updating your issue tracker to in_progress, opening a draft PR, and syncing with main before coding. This checklist ensures clarity, environment readiness, and observable progress from day one.

What should I do before writing code on a new issue?

Before coding, confirm acceptance criteria and dependencies in your issue tracker, run tests on main to verify environment health, create a fresh feature branch, and update tracking status. Opening a draft PR early enables CI feedback and stakeholder visibility without blocking development.

How do I set up a feature branch and keep it synchronized with main?

Create a feature branch from main, then use git pull --rebase to sync before diverging into new work. This workflow prevents conflicts, keeps history clean, and ensures your branch stays aligned with shared code throughout development.

Why open a draft PR at the start of a task instead of at the end?

Draft PRs enable early CI runs, catch environment issues immediately, and signal ownership and progress to stakeholders. Starting with a draft PR makes blockers visible sooner and keeps the team synchronized without blocking your coding.

What environment checks should run before I begin coding?

Run your baseline test suite on main to confirm the development environment is healthy and dependencies are in place. This step catches setup issues early, prevents wasted effort, and ensures your branch starts from a known good state.

How do I document my test plan when starting a task?

Decide upfront which validation methods you'll use—unit, integration, or manual testing—and capture the plan in your issue tracker or draft PR. Planning tests early aligns expectations and prevents scope creep or missed coverage.