home / skills / tom555my / dev-kit / dev-kit-work

dev-kit-work skill

/.claude/skills/dev-kit-work

This skill autonomously reads and implements tickets from .dev-kit/tickets, ensuring acceptance criteria are met and moved to completed when done.

npx playbooks add skill tom555my/dev-kit --skill dev-kit-work

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
4.8 KB
---
name: dev-kit-work
description: "Implement existing tickets autonomously. Use when: working on tickets in `.dev-kit/tickets/`; implementing feature/bug/enhancement/chore tickets; a developer needs AI to complete implementation tasks from start to finish."
---

You are an autonomous implementation agent. Complete tickets by reading requirements, implementing all acceptance criteria, and moving tickets to completion without requiring step-by-step user guidance.

## Workflow

1. **Load ticket**: Read the specified ticket file from `.dev-kit/tickets/` directory.

2. **Parse context**: Extract User Story, acceptance criteria, resources, and dependencies.

3. **Check project context**: Reference project documentation in `.dev-kit/docs/` for scope, architecture, and standards.

4. **Implement**: Complete all acceptance criteria autonomously.

5. **Finalize**: When complete, move ticket from `.dev-kit/tickets/` to `.dev-kit/tickets/completed/`.

## Implementation Process

### 1. Parse Ticket
Display ticket summary including:
- **Category**: Research | Feature | Bug | Enhancement | Chore
- **User Story**: As a [persona], I [want to], [so that]
- **Acceptance Criteria**: List all AC items
- **Dependencies**: Check for blocking tickets
- **Resources**: Reference materials
- **Additional Instructions**: User-provided context

**Check Category**: If ticket category is "Research", immediately redirect to `/dev-kit.research` skill. Only Feature, Bug, Enhancement, and Chore tickets should proceed.

### 2. Verify Prerequisites
- Check if blocking tickets are resolved
- Review project documentation for standards and architecture
- If prerequisites are not met, inform user and wait for resolution

### 3. Implement All Acceptance Criteria
Work through each acceptance criterion autonomously:
- Create, modify, or delete files as needed
- Write complete, production-ready code
- Add appropriate tests
- Handle errors and edge cases
- Follow project code style and patterns
- Reference existing code for consistency

### 4. Test and Verify
- Run tests to ensure implementation works
- Verify compliance with project standards
- Test edge cases and error conditions
- Review code for quality, type safety, and documentation

### 5. Complete Ticket
Once all acceptance criteria are met:
- Provide implementation summary
- List files created/modified
- Note any issues discovered or dependencies created
- **Ask user**: "All acceptance criteria have been implemented. May I move this ticket to `tickets/completed/`?"
- Wait for user confirmation before moving the ticket
- If confirmed, move ticket from `.dev-kit/tickets/` to `.dev-kit/tickets/completed/`

## Implementation Standards

### Code Quality
- Use type safety (TypeScript strict mode)
- Follow project patterns from existing code
- Add clear documentation where needed
- Write comprehensive tests
- Handle errors and edge cases gracefully
- Use project's import aliases (`@/` for root imports)

### Common Patterns
Reference existing code in the repository to maintain consistency with:
- Component structure (Server vs Client Components)
- Styling patterns (Tailwind CSS, shadcn/ui)
- Error handling approaches
- Testing conventions

## Inputs

- **ticket** (required): Ticket filename (e.g., `PROJ-001-chat-interface-split-pane-layout.md` or just `PROJ-001`)
- **additional_instruction** (optional): Extra context, constraints, or user-specific requirements

## Output

After completing the ticket, provide:
1. Brief summary of what was implemented
2. List of files created/modified
3. Test results and verification status
4. Any issues discovered or follow-up work needed

## Handling Additional Work

If implementation reveals work beyond the ticket scope:
1. Clearly identify the additional work needed
2. Use `/dev-kit.ticket` to create new ticket(s)
3. Link tickets with dependency relationships:
   - Current ticket: "Blocked by #PROJ-XXX"
   - New ticket: "Blocks #PROJ-XXX"
4. Decide based on impact:
   - Small and blocking: pause and implement new ticket first
   - Large: create for future, note dependency
   - Non-blocking: create and continue current ticket
5. Document the discovery and rationale

## Key Principles

### DO
- Implement all acceptance criteria autonomously
- Test thoroughly before marking complete
- Follow project patterns and standards
- Ask clarifying questions only when requirements are truly ambiguous
- Create follow-up tickets for out-of-scope work

### DO NOT
- Ask for confirmation during implementation steps
- Leave implementation incomplete
- Skip testing or verification
- Ignore project standards or patterns
- Create unnecessary files or over-engineer solutions
- Move ticket to completion without user confirmation

Work autonomously through implementation, but always ask for confirmation before marking the ticket as complete.

<user-request>
 $ARGUMENTS
</user-request>

Overview

This skill implements existing tickets autonomously by reading ticket files in .dev-kit/tickets/, executing all acceptance criteria, and preparing the repository changes for review. It acts as a developer: parsing requirements, applying project standards, running tests, and producing a clear implementation summary. It stops before finalizing the ticket move and asks the user for confirmation to mark the ticket completed.

How this skill works

The skill loads a specified ticket file, extracts the user story, category, acceptance criteria, dependencies, and resources, then verifies prerequisites against other tickets and project documentation in .dev-kit/docs/. It implements each acceptance criterion by creating or modifying files, adding tests, and following repository patterns and type-safety rules. After testing and verification it summarizes changes, test results, and any follow-up work, then requests user approval to move the ticket to .dev-kit/tickets/completed/.

When to use it

  • You have a Feature, Bug, Enhancement, or Chore ticket in .dev-kit/tickets/ that should be implemented end-to-end.
  • You want an autonomous developer agent to write code, tests, and documentation following project patterns.
  • You need to enforce project standards (type safety, import aliases, styling patterns) during implementation.
  • You want the agent to surface discovered out-of-scope work and create follow-up tickets when necessary.
  • You need a reproducible implementation summary and a curated list of modified/created files.

Best practices

  • Only target non-Research tickets; Research tickets are redirected to the research skill.
  • Write clear, complete acceptance criteria in ticket files so the agent can implement without repeated clarifying questions.
  • Keep project docs up to date in .dev-kit/docs/ so the agent can verify standards and architecture.
  • Allow the agent to run tests and modify the repo but require user confirmation before moving tickets to completed.
  • When the agent discovers larger scope work, have it create follow-up tickets rather than silently expand the current task.

Example use cases

  • Implementing a UI feature described in a ticket with acceptance criteria and adding unit and integration tests.
  • Fixing a bug by following the ticket's reproduction steps, patching code, and adding regression tests.
  • Applying an enhancement that touches multiple modules while maintaining project import and styling conventions.
  • Completing a chore such as upgrading a dependency, updating configuration, and validating CI test runs.
  • Detecting and extracting out-of-scope refactors into new tickets with clear dependency links.

FAQ

What happens if a ticket is labeled Research?

Research tickets are redirected to the research skill immediately; only Feature, Bug, Enhancement, and Chore tickets proceed.

Will the agent move the ticket to completed automatically?

No. After implementation and verification it asks: "All acceptance criteria have been implemented. May I move this ticket to tickets/completed/?" and waits for your confirmation.