rust-lib-template: Instructions file for Claude Code

{{ project-name }}

IMPORTANT: Never enter plan mode automatically!!! Never enter plan mode automatically!!!

Core Principles

Completion Discipline

• Do Not Stop Early: If the user's requested outcome is not fully complete, do not stop at a draft, partial pass, or "good enough" result. Continue reviewing and improving until the request is genuinely handled or a concrete blocker requires user input.
• Polish Bar: Before declaring work complete, ask whether the result is fully polished, concrete, correct, complete, and elegant. If there is doubt, review the work again and update it.
• Honest Status: Do not claim a task is finished when it is only a first pass, scaffold, or partial draft. State the remaining gaps and keep working unless the user explicitly asks to pause.

Code Quality

• SOLID and DRY Principles: Maintain clean, maintainable code following SOLID and DRY principles
• No Incomplete Code: Never write TODO comments or temporary solutions. If you encounter such a situation:
  1. Stop the current task
  2. Review the problem globally
  3. Rethink the design and identify the best alternative solutions
  4. Proceed with the complete solution
• Thorough Analysis: Always perform a comprehensive review and analysis of the problem before starting work
• Do not suppress dead code, remove them; Unless explicitly requested, do not go through deprecation process, just remove the code that is no longer needed.

Development Workflow

• Latest Dependencies: Always search the web for the latest dependencies or helm charts or resources and their current usage patterns. If doing a deep research, put the research doc under ./docs/research. You shall look into that directory before doing researches.
• Automation via Makefile:
  • Explore existing Makefile targets and use them accordingly
  • For new automation tasks, always add a Makefile target instead of creating shell scripts
  • Keep automation consistent and discoverable