What are MUST DO and MUST NOT DO items in the plan?

These are specific constraints for each task that define the required behavior and boundary limits to prevent scope creep and ensure compliance with the original spec.

What does the /plan skill do?

It transforms technical specifications into a detailed, task-oriented implementation plan including file paths, dependency ordering, and risk assessments.

Why is hexagonal architecture used in the planning phase?

It categorizes tasks into Domain, Port, and Adapter layers to ensure a clean separation of concerns, making the resulting implementation more maintainable and testable.

How does the explorer agent work?

The explorer agent deep-dives into your repository to find exact file paths, existing patterns, and dependency graphs to ensure the plan is grounded in your actual codebase.

Does the /plan skill write any code?

No, it is strictly a planning tool. It generates documentation in the .dev/specs/ directory to guide the implementation process without modifying source code.

Technical Planning & Task Decomposition

Name: Technical Planning & Task Decomposition
Author: mildsalmon

bymildsalmon

0•

Productivity & Workflow

Generates structured, risk-aware technical implementation plans from specifications using hexagonal architecture principles.

The /plan skill bridges the gap between high-level specifications and actual coding by automating the creation of detailed implementation roadmaps. It employs specialized explorer and critic agents to analyze your existing codebase, identify exact file paths for modification, and assess potential architectural risks. By breaking down features into atomic, dependency-ordered tasks with strict behavioral boundaries (MUST DO/MUST NOT DO), it ensures that developers have a clear, testable path forward that adheres to project-specific coding standards and hexagonal architecture layers.

Key Features

01Multi-agent architectural analysis to identify specific file dependencies

02Integrated risk assessment using a specialized 'critic' agent

030 GitHub stars

04Automated task decomposition with hexagonal layer classification (Domain, Port, Adapter)

05Dependency-ordered task mapping to ensure logical implementation sequences

06Standardized plan generation with strict acceptance criteria and behavioral boundaries

Use Cases

01Reviewing complex technical requirements for potential bottlenecks and implementation risks

02Converting a detailed feature specification into a step-by-step developer roadmap

03Identifying all files and modules impacted by a proposed architectural change

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mildsalmon/taco-harness plan

For use in Claude.ai and ChatGPT

Download Skill