memoria: Instructions file for Kiro

Goal-Driven Evolution + Plan Integration

Track goals, plans, progress, lessons, and user feedback across conversations. Integrates with plan panels (Kiro Shift+Tab, Cursor Composer, Claude multi-step).

Before Starting Any Multi-Step Task

Query memory first:

memory_search(query="GOAL [topic]")                    # existing related goals
memory_search(query="LESSON [topic]")                  # past learnings
memory_search(query="CORRECTION ANTIPATTERN [topic]") # what NOT to do

If an active goal exists, continue it instead of creating a new one.

Register Goal

For multi-session work (skip for trivial single-session tasks < 3 steps):

memory_search(query="GOAL [keywords]")
memory_store(
  content="🎯 GOAL: [description]\nSuccess Criteria: [measurable]\nStatus: ACTIVE\nCreated: [date]",
  memory_type="procedural"
)

Plan & Execute

Store the plan, then track each step:

memory_store(content="📋 PLAN for GOAL [name]\nSteps:\n1. [step] — ⏳\nRisks: [risks]\nIteration: #1", memory_type="procedural")

# After each step — use working type (will be cleaned up later)
memory_store(content="✅ STEP [N/total] for GOAL [name] (#X)\nAction: [done]\nResult: [outcome]\nInsight: [learned]", memory_type="working")
memory_store(content="❌ STEP [N/total] for GOAL [name] (#X)\nAction: [tried]\nError: [wrong]\nRoot Cause: [why]\nNext: [adjust]", memory_type="working")

Only store non-obvious insights. Don't store "ran tests, passed".

For high-risk iterations, isolate on a branch:

memory_branch(name="goal_[name]_iter_[N]")
memory_checkout(name="goal_[name]_iter_[N]")
# work on branch... then validate and merge (see Iteration Review)

Capture User Feedback (immediately)

User corrections are highest-value — always store as procedural:

# User corrects direction
memory_store(content="🔧 CORRECTION for GOAL [name]: [old approach] → [corrected approach]. Reason: [why]", memory_type="procedural")

# User confirms something works well
memory_store(content="👍 FEEDBACK for GOAL [name]: [what worked]. Reuse: [when to apply again]", memory_type="procedural")

# User is frustrated — record what NOT to do
memory_store(content="⚠️ ANTIPATTERN for GOAL [name]: [what went wrong]. Rule: NEVER [this] again.", memory_type="procedural")

# User changes direction entirely
memory_correct(query="GOAL: [name]", new_content="🎯 GOAL: [name]\n...\nPivot: [old] → [new]. Reason: [why]", reason="User changed direction")