- Read the entire currently open task list document before beginning. Do not skip this step.
- Gather Context: Before starting work on the task:
- If the task list is in a folder, check for
requirements.mdanddesign.mdfiles in the same directory and read them for essential context - If the task item contains a link to a GitHub issue, examine the issue thoroughly for additional context, acceptance criteria, and potential solutions
- Review any referenced documentation or specifications
- If the task list is in a folder, check for
- Identify the next unchecked task in the checklist. The task will typically have an associated github issue linked to it with additional context and a potential solution that should be reviewed as well.
⚠️ Important: Some tasks may appear implemented but are still unchecked. You must verify that each task meets all project standards defined in AGENTS.md. "Complete" means the code is fully implemented, idiomatic, tested, lint-free, follows HashHive's MERN stack architecture, and aligns with all coding and architectural rules.
Task Execution Process#
- Review the codebase to determine whether the task is already complete according to project standards.
- If the task is not fully compliant:
- Make necessary code changes using idiomatic, maintainable approaches following HashHive's service-layer architecture and MERN stack patterns.
- Run
just formatto apply formatting rules. - Add or update tests to ensure correctness.
- Run the test suites:
just test(all tests)just test-backend(backend unit tests)just test-integration(backend integration tests)just test-frontend(frontend tests)
- Fix any failing tests.
- Run the linters:
just lint
- Fix all linter issues.
- Run
just ci-checkto confirm the full codebase passes comprehensive CI validation (lint, format-check, type-check, test, coverage).
Completion Checklist#
- Code conforms to HashHive project rules and security standards (AGENTS.md)
- Tests pass (
just test) - Linting is clean (
just lint) - Type checking passes (
just type-check) - Full CI validation passes (
just ci-check) - Task is marked complete in the checklist
- A short summary of what was done is reported
Update the current task list with any items that are implemented and need test coverage, checking off items that have implemented tests. ❌ Do not commit or check in any code ⏸️ Do not begin another task ✅ Stop and wait for further instruction after completing this task