# Task Planning Skill

> Breaking down complex user requests into actionable, well-structured plans. Use when this capability is needed.

- Skill: `tomevault-io/task-planning-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/task-planning-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/task-planning-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/task-planning-skill

---


## Instructions
When planning a task:
1.  **Consult the Source of Truth**: Read `d:\Repos\Derot-my-brain\Docs\ANTIGRAVITY_INSTRUCTIONS.md` and `d:\Repos\Derot-my-brain\Docs\Planning\Project-Status.md`.
2.  **Analyze Technical Compliance**: Check relevant docs in `d:\Repos\Derot-my-brain\Docs\Technical\` to ensure the plan respects Clean Architecture.
3.  **Break Down by Layer**:
    - **Backend**: Core (Entities/Interfaces/Services), Infrastructure (Persistence/External), API (Controllers/DTOs).
    - **Frontend**: API Client, Stores, Hooks, Components, Pages.
    - **Testing**: Backend Unit/Integration, Frontend Vitest/RTL.
4.  **Adhere to Standards**:
    - Thin controllers, thick services (SOLID).
    - Dumb components (Presentation only), logic in Custom Hooks.
    - **Rich Aesthetics**: Ensure the plan includes polishing the UI for premium look and feel.
    - **Active Learning**: Plan for both the full cycle and direct entry points (Activity/Source).
- **De-mocking**: Ensure the plan includes replacing mocks with real service implementations (Wikipedia API, Ollama LLM).
- **Local-First**: Ensure AI and storage remain local (Ollama / SQLite).
5.  **Mock Data**: Always include a step to seed mock data for `TestUser` (`test-user-id-001`) in `d:\Repos\Derot-my-brain\src\backend\DerotMyBrain.Infrastructure\Data\DbInitializer.cs`.
6.  **Structure**: Present the plan with clear checkboxes and logical dependencies.

## Example Plan Structure
1. **Analysis**: Impact on existing entities and services.
2. **Backend**:
   - [ ] Core: Entity/Interface changes.
   - [ ] Infrastructure: Repository/External Service implementation.
   - [ ] API: DTOs, Controllers, DI registration.
3. **Frontend**:
   - [ ] Infrastructure: API Client/DTOs.
   - [ ] Application: Zustand store updates, Custom Hooks.
   - [ ] Presentation: UI components, Pages.
4. **Testing**:
   - [ ] Backend: Unit tests (Service) and Integration tests (Controller).
   - [ ] Frontend: Component/Hook tests.
5. **Validation**: Mock data seeding and manual verification.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/samgvann) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-16 -->