thesoftwarehouse/tsh-task-analysing

Task Analysis

This skill helps you gather and expand context about a specific task to be developed, looks for gaps in the task description and helps to understand the current state of the system.

Task analysis process

Use the checklist below and track your progress:

Analysis progress:
- [ ] Step 0: Determine input source
- [ ] Step 1: Look for available external sources of information
- [ ] Step 2: Gather information from all sources
- [ ] Step 3: Identify gaps and ask clarification questions
- [ ] Step 4: Based on the answers and gathered information finalize the research report

Step 0: Determine input source

Before gathering information, determine how the task context was provided:

• Research & plan files exist (*.research.md, *.plan.md): Read them as the primary source of requirements, acceptance criteria, scope, and definition of done.
• Jira ID / task ID provided: Use it to fetch task details from external tools (Step 1).
• Context provided directly in the prompt: When neither files nor a task ID are referenced, extract requirements, acceptance criteria, and scope from the user's message. Treat the prompt as the single source of truth. If critical information is missing, ask for clarification before proceeding.
• PDF files attached or referenced: Use the pdf-reader tool to extract content from PDF documents before analyzing them. Treat the extracted content as a primary source alongside research files and Jira tasks.

This determination affects how much of Steps 1–2 you need to execute — if the context is already fully provided inline or in files, skip redundant external lookups.

Step 1: Look for available external sources of information

Check what tools are available. Look for common task and knowledge management tools like:

• Atlassian Jira
• Atlassian Confluence
• Notion
• Linear
• Trello

Check if GitHub tools is available and look for Spaces matching task and project.

Step 2: Gather information

For each available tool look for task related information on it. Make sure to look for by ID if provided and in case it being absent look by task domain and jobs to be done. When having access to task management tools make sure to focus not only on a current task but also connected tasks, subtasks and epic.

In case of any external links, knowledge base link or designs, make sure to thoroughly check them through.

Analyse the code base based on task requirements. Look for areas that will be related to given task.

In case of any attached or referenced PDF files (requirements documents, client briefs, process descriptions, compliance documents), use the pdf-reader tool to extract their content and include relevant findings in the research report.

Find relevant information on knowledge base tools.

Step 3: Identify gaps and ask clarification questions

Based on the gathered information and task description, look for ambiguities or missing information. Create the questions and ask them to the user. Don't proceed until all questions are answered or you are directly told to continue.

Step 4: Based on the answers and gathered information finalize the research report

Generate a report following the ./research.example.md structure. Make sure to provide all necessary information that you gathered, all findings and all answered questions.

Don't add or remove any sections from the template. Follow the structure and naming conventions strictly to ensure clarity and consistency.

Connected Skills

• tsh-codebase-analysing - for analyzing the existing codebase in the context of task requirements
• tsh-implementation-gap-analysing - for understanding what already exists vs what needs to be built