task-spec
Create or update a task specification
When & Why to Use This Skill
This Claude skill automates the creation and refinement of comprehensive task specifications by synthesizing perspectives from Project Management, Architecture, and Quality Assurance. It ensures that every project task is backed by a detailed technical roadmap, clear architectural guidelines, and rigorous acceptance criteria, significantly reducing ambiguity during the development lifecycle.
Use Cases
- Task Initiation: Automatically generate a structured task specification file (.md) when starting a new feature to ensure the project owner's vision is clearly documented.
- Technical Architecture Planning: Update task specs with specific architectural details and design patterns to provide developers with a clear technical implementation path.
- QA & Testing Alignment: Define explicit acceptance criteria and required test cases within the task specification to ensure high-quality deliverables and successful project sign-off.
- Context Enrichment: Use the skill to gather and document necessary context before work begins, preventing scope creep and misalignment between stakeholders.
| name | task-spec |
|---|---|
| description | Create or update a task specification |
Task: create spec
When to use
- The user asks for to start working on a task
- You need more context before working on a task
Procedure
as a Project Manager Review the work plan documentation, check ./Plan.md. Prepare a detailed task specification from project owner POV. Write it to .specs/task-.md
as an Architect Review the work plan documentation, check ./Plan.md. Update the task specification with technical architecture details. Write it to .specs/task-.md
as QA Analyst Review the work plan documentation, check ./Plan.md. Update the task specification with requited contract details from QA perspective. List required tests and acceptance criteria. Write it to .specs/task-.md