mohammed-io/agentic-ai-tools
Overview
This skill enforces mandatory work tracking before any code changes and ensures 100% compliance with creating, updating, and completing work files. It prevents coding until a work file is created, requires progressive todo updates after each task, and mandates using provided scripts to manage work lifecycle. Use it for all coding tasks: features, fixes, refactors, and improvements.
How this skill works
The skill inspects the project for a work-tracking configuration and an agent-work directory, initializes scaffolding if missing, and checks for active work files before any new work starts. It requires running work-create.sh to generate a timestamped work file populated with context, value, alternatives, todos, and notes. During implementation it enforces updating the work file after each todo, and it uses work-complete.sh to mark and archive completed work.
When to use it
- Before starting any new feature implementation
- Before applying any bug fix or patch
- Before refactoring existing code or structure
- Before making optimizations or performance changes
- Whenever committing code changes to the repository
Best practices
- Always run the initialization checks the first time in a project
- Use descriptive, snake_case task names (no vague names like 'update')
- Create the work file with ./agent-work/bin/work-create.sh before writing code
- Update the work file immediately after completing each individual todo
- Run ./agent-work/bin/work-complete.sh only after all todos are checked
Example use cases
- Add a new PDF watermark feature: create work file, list todos, implement and update after each step, then complete
- Fix a date parsing bug: create task fix_date_parsing_bug, run the scripts, document context and acceptance criteria
- Refactor the authentication module: track alternatives, break refactor into todos, mark progress progressively
- Optimize image processing: record performance goals, implement one optimization per todo and update file after each
- Routine improvements: use the same sequence for small changes to maintain consistent audit trail
FAQ
The skill lists the active file and asks whether to continue it, complete it first, or create a new work file. You must respond before proceeding.
Can I update multiple todos at once?
No. You must update the work file after each todo completion to preserve progressive progress and allow reliable resumption.
