alexbruno/dev-skills

planning-and-task-breakdown

Plan execution and break complex work into ordered, verifiable tasks aligned with spec-driven-workflow (workflow/SPEC.md, workflow/PLAN.md, and conditional workflow/TASKS.md).

Zobacz źródło

Jak używać

  1. Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
  2. W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
  3. Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/alexbruno/dev-skills --skill planning-and-task-breakdown

Przed rozpoczęciem

  • Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
  • Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

Planning & Task Breakdown

Decompose specifications into clear execution steps (workflow/PLAN.md) and, when warranted, small verifiable tasks (workflow/TASKS.md) before writing any implementation code.

Language & Architecture Agnostic: This skill applies to any technology stack, domain, or project structure. Reason in terms of deliverables, boundaries, dependencies, and verification—never assume specific languages, frameworks, or architectural patterns.

Core Rule

Plan in read-only mode. Explore the repository, map dependencies, and write the plan before modifying any deliverable files. Do not start implementing while planning.

When to Apply

  • Translating workflow/SPEC.md into an actionable execution plan (workflow/PLAN.md).
  • Work feels too large, ambiguous, or multi-faceted to execute in a single pass.
  • Multiple independent deliverables or parallel/asynchronous agent executions are possible.
  • Skip formal breakdown for trivial, single-step edits where planning adds no value.

Planning Process

1. Ground in workflow/SPEC.md

  1. Read workflow/SPEC.md (or workflow/<change-slug>/SPEC.md for scoped initiatives).
  • If SPEC.md does not exist yet for a non-trivial change, create and align on SPEC.md first.
  1. Confirm goals, non-goals, constraints, and acceptance criteria are unambiguous. Surface open questions before committing to a plan.

2. Explore & Map Dependencies (Read-Only)

  1. Inspect the relevant areas of the repository (preferring indexed context if codebase-indexing is active).
  2. Identify affected components, shared boundaries, and external constraints.
  3. Map the dependency graph: determine what blocks what, which steps must run sequentially, and which units are truly independent.

3. Author workflow/PLAN.md

Create or update workflow/PLAN.md (initializing workflow/ if missing):

  • Reference SPEC.md requirements rather than duplicating them.
  • Order steps logically—tackle high-risk or high-uncertainty unknowns early.
  • Define a concrete Verification Strategy (automated checks, validations, or manual verification) for each step and for the overall change.
  • Note risks and rollback considerations.

4. Shard into workflow/TASKS.md (Conditional)

Create workflow/TASKS.md only when at least one spec-driven-workflow trigger applies:

  1. PLAN.md is too large or comprehensive to execute cleanly in a single pass.
  2. PLAN.md spans two or more distinct scopes, task types (feature, bugfix, refactor, docs), or independent deliverables that benefit from separate tracking.
  3. Work can be split into independent units executed in parallel or asynchronously by different agents or contributors.

When creating TASKS.md, ensure every task has:

  • Unique ID & Type (e.g., T1, feature | bugfix | refactor | docs | chore).
  • Explicit Dependencies: Clearly state blocking task IDs (or None).
  • Disjoint Scope: Assign non-overlapping files or modules to parallel tasks to prevent merge conflicts.
  • Objective Done Criteria: Concrete, verifiable conditions that prove the task is complete.

Quality Checklist

Before handing off PLAN.md (and TASKS.md) for execution:

  1. Every requirement and acceptance criterion in workflow/SPEC.md is covered by at least one step or task.
  2. No circular dependencies exist, and parallel tasks have non-overlapping scopes.
  3. Every step/task is small enough to implement and verify in a single focused pass.
  4. No implementation code has been written prematurely during the planning phase.
z tego samego repozytorium

Więcej Skills

Wszystkie Skills
alexbruno
Społeczność

architect-worker

Role-based multi-agent software engineering pattern separating high-level architecture, specification, planning, and code review (Architect) from focused code implementation and verification (Worker). Use this skill whenever assigned the Architect or Worker role (in any language), or when coordinating work between planning/review agents and implementation agents via workflow/.

Instalacje / 1h
1
GitHub Stars
0
Aktualizacja
13 lis
alexbruno
Społeczność

changelog-management

Maintain and update a standardized root CHANGELOG.md following Keep a Changelog and Semantic Versioning. Use this skill to initialize or update changelog entries, categorize changes, prepare release cuts, and proactively prompt the user when notable changes warrant updating the changelog.

Instalacje / 1h
1
GitHub Stars
0
Aktualizacja
13 lis
alexbruno
Społeczność

code-review

Perform structured, multi-dimensional code reviews aligned with the spec-driven-workflow (workflow/SPEC.md, workflow/PLAN.md, workflow/REVIEW.md). Use this skill after implementing a feature or bug fix, before merging a PR, or when reviewing changes written by another agent or human.

Instalacje / 1h
1
GitHub Stars
0
Aktualizacja
13 lis
alexbruno
Społeczność

code-simplification

Simplify code for human readability, clarity, and directness without changing behavior. Use this skill after implementing a feature, during refactoring, or when addressing code review feedback—especially when code feels over-engineered, deeply nested, or takes unnecessary detours to do simple things.

Instalacje / 1h
1
GitHub Stars
0
Aktualizacja
13 lis