@tyagoveras/node-mde/CLAUDE.md

Biblioteca para consultar notas destinadas e enviar evento de manifestação do destinatário

Developer: ## Workflow Orchestration

### 1. Plan Node Default

- Begin with a concise checklist (3-7 bullets) outlining the conceptual sub-tasks before proceeding with any non-trivial task (3+ steps or architectural decisions).
- Enter plan mode for these tasks; if issues arise, STOP and re-plan immediately rather than proceeding with uncertainty.
- Use plan mode also for verification steps, not just building phases.
- Write detailed specs upfront to reduce ambiguity and improve outcome reliability.

### 2. Subagent Strategy

- Use subagents liberally to keep the main context window focused and uncluttered.
- Offload research, exploration, and parallel analysis to subagents as needed.
- For complex problems, leverage increased compute resources via subagents to accelerate progress.
- Assign one task per subagent for focused execution and clarity of responsibilities.

### 3. Self-Improvement Loop

- After any user correction, immediately update 'tasks/lessons.md' with the lesson or pattern identified.
- Codify prevention rules for yourself based on these lessons to prevent repeat mistakes.
- Iterate on these lessons aggressively until repeated errors are eliminated.
- At the start of each project session, review relevant lessons to inform your current work.

### 4. Verification Before Done

- Never mark a task as complete without demonstrating its functionality and correctness.
- When relevant, diff the behavior between main and your changes to provide clear evidence of improvement.
- After each substantive change or tool invocation, validate results in 1-2 lines and determine if further action is needed or self-correction is required.
- Ask: "Would a staff engineer approve this?" and corroborate using tests, logs, and demonstrations of correctness.

### 5. Demand Elegance (Balanced)

- For non-trivial changes, pause to ask: "Is there a more elegant solution?"
- If an implementation seems hacky, consider whether a more refined approach is possible given new knowledge.
- Skip this for straightforward fixes—avoid unnecessary complexity.
- Challenge the elegance and clarity of your own work before presenting it for review.

### 6. Autonomous Bug Fixing

- When presented with a bug report, address it directly with no additional instruction required.
- Reference relevant logs, errors, and failing tests, then resolve the underlying issues.
- Require zero context switching from the user—own the debugging process end-to-end.
- Proactively fix any failing CI tests, taking initiative to maintain build stability.

## Task Management

1. **Plan First:** Write your conceptual plan to `tasks/todo.md` as a checklist of actionable items.
2. **Verify Plan:** Confirm the plan with stakeholders or yourself before implementing any solution.
3. **Track Progress:** Mark checklist items as complete as each sub-task ends.
4. **Explain Changes:** Summarize changes at a high level following each significant step or milestone.
5. **Document Results:** Add a review section in `tasks/todo.md` post-implementation to capture outcomes.
6. **Capture Lessons:** Update `tasks/lessons.md` promptly after any corrections to foster continuous improvement.

## Core Principles

Write your conceptual plan to `tasks/todo.md` as a checklist of actionable items. 2. **Verify Plan:** Confirm the plan with stakeholders or yourself before implementing any solution. 3. **Track Progress:** Mark checklist items as complete as each sub-task ends. 4. **Explain Changes:** Summarize changes at a high level following each significant step or milestone. 5. **Document Results:** Add a review section in `tasks/todo.md` post-implementation to capture outcomes. 6. **Capture Lessons:** Update `tasks/lessons.md` promptly after any corrections to foster continuous improvement.

## Core Principles

- **Simplicity First:** Make every change as simple as possible; minimize impacted code and avoid unnecessary complexity.
- **No Laziness:** Focus on identifying root causes and reject temporary or incomplete fixes. Uphold high standards consistent with those of a senior developer.
- **Minimal Impact:** Changes must be tightly scoped to only what's essential, minimizing risk and preventing the introduction of unintended bugs.