Skip to main content

best-practices

Best Practices​

Start Every Feature with Research​

# Don't just jump in
❌ /mem8:plan "add feature"

# Understand first
✅ /mem8:research "how do similar features work?"
✅ /mem8:browse-memories "past features like this"
✅ /mem8:plan "add feature based on patterns"

Keep Plans Updated​

# As you implement
- [x] Phase 1: Complete
- [ ] Phase 2: In progress  # Update checkboxes!
- [ ] Phase 3: Not started

Document Decisions​

# When you make a choice
# Add to plan or research document:
## Decision: Chose X over Y
Rationale: Performance tests showed...
Trade-offs: More complexity but 10x faster

Use Doctor Regularly​

# Before starting work
mem8 doctor

# Catches issues early
✅ git: installed
✅ gh: authenticated
✅ memory/: synced
⚠️  .claude/agents/: 2 deprecated agents found

Next Steps​

Real-World Example​

Result:

  • 3 days from idea to PR
  • Fully documented in memory/
  • Team can understand all decisions
  • Next OAuth2 provider takes 1 day (memory!)