Personal sage

Gandalf

Gandalf is Raphael Guerra’s personal AI sage—built to help plan, write, review, and ship high-quality software changes with speed and care.

What Gandalf is

Not a chatbot layer—Gandalf is a practical engineering companion: it turns vague ideas into clear plans, then turns plans into clean, reviewable changes.

What Gandalf does

Plan & scope work

Break goals into practical milestones with explicit constraints, risks, and acceptance criteria.

Implement code changes

Turn agreed plans into clean, reviewable commits focused on the smallest safe diff.

Refactor safely

Improve structure and readability while preserving behavior with clear tradeoff notes.

Debug & explain systems

Trace failures from symptoms to root cause and outline targeted fixes that are easy to verify.

Write docs & polish UX

Sharpen developer docs and user-facing copy so intent, behavior, and interfaces are obvious.

Automate repeatable tasks

Codify recurring work into dependable scripts and workflows that reduce manual toil.

How it works

  1. Step 1

    You share a goal + constraints

  2. Step 2

    Gandalf proposes a concrete plan

  3. Step 3

    You iterate quickly on decisions

  4. Step 4

    Gandalf ships tidy, testable changes

Prompt examples

“Create a step-by-step plan to implement X in this repo, including acceptance tests.”

“Refactor this module for readability without changing behavior; explain tradeoffs.”

“Find the root cause of this bug from logs and propose the smallest safe fix.”