Instructions
When planning a task:
- Consult the Source of Truth: Read
d:\Repos\Derot-my-brain\Docs\ANTIGRAVITY_INSTRUCTIONS.mdandd:\Repos\Derot-my-brain\Docs\Planning\Project-Status.md. - Analyze Technical Compliance: Check relevant docs in
d:\Repos\Derot-my-brain\Docs\Technical\to ensure the plan respects Clean Architecture. - 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.
- 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).
- Mock Data: Always include a step to seed mock data for
TestUser(test-user-id-001) ind:\Repos\Derot-my-brain\src\backend\DerotMyBrain.Infrastructure\Data\DbInitializer.cs. - Structure: Present the plan with clear checkboxes and logical dependencies.
Example Plan Structure
- Analysis: Impact on existing entities and services.
- Backend:
- Core: Entity/Interface changes.
- Infrastructure: Repository/External Service implementation.
- API: DTOs, Controllers, DI registration.
- Frontend:
- Infrastructure: API Client/DTOs.
- Application: Zustand store updates, Custom Hooks.
- Presentation: UI components, Pages.
- Testing:
- Backend: Unit tests (Service) and Integration tests (Controller).
- Frontend: Component/Hook tests.
- Validation: Mock data seeding and manual verification.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.