Building with AI is fast. But fast without direction means rework, missed requirements, and products that don't land. Waypoint gives you the questions a senior engineer would ask — at every step, automatically.
14 guided tools take you from first idea to shipped product. Each one reads your workspace, asks the right questions, and writes a plain-language record of what was decided and why. For engineers and non-technical teams alike.
No setup or briefing required. Tools write structured artifacts to a .waypoint/ folder, building a shared record of decisions, designs, plans, and reviews as you work.
npx @waycraft/waypoint-mcpOr add permanently via Claude Code:
claude mcp add waypoint npx @waycraft/waypoint-mcpAdd to ~/.claude/mcp.json (global) or .claude/mcp.json (project-level):
{
"mcpServers": {
"waypoint": {
"command": "npx",
"args": ["@waycraft/waypoint-mcp"]
}
}
}Restart Claude Code after editing mcp.json.
Waypoint covers four phases. Each tool reads your workspace, asks the right questions, and writes a plain-language record of what was decided and why.
Every tool accepts workspacePath (required) — the absolute path to the project you're working on.
waypoint_goal — Start here. Clarifies what you're building, who it's for, and what success looks like. Prevents scope drift before a line of code is written. If a goal already exists for this project, it will ask you to confirm before archiving the current cycle and starting fresh — pass confirmArchive: true to proceed.
waypoint_research — Surfaces what you need to know before committing to an approach: prior art, constraints, risks, and open questions.
waypoint_compare — Lays out your options side by side with honest tradeoffs, so the choice you make is documented and defensible.
waypoint_plan — Turns your goal into a sequenced build plan: what gets built, in what order, and why. Plan = what to build.
waypoint_design — Sets the structural contract for how the code should be written: folder structure, patterns to follow, patterns to avoid. Design = how to build it. Run after waypoint_plan.
waypoint_build — Scaffolds the implementation against the design. Works best when waypoint_design has already run.
waypoint_test — Verifies the build does what it was supposed to. Surfaces gaps between spec and reality.
waypoint_fix — Takes a known bug or failure and walks through the fix systematically.
waypoint_debug — For when something is broken and you don't know why yet. Narrows root cause before touching code. Accepts an optional mode: troubleshoot (default — likely causes ranked by likelihood) or trace (follow the execution path step by step). Leave mode out if unsure — troubleshoot handles most problems.
waypoint_audit — Mid-cycle health check: reads the codebase and compares it against good practices for your project tier. Produces tiered findings: Must Fix, Should Fix, Consider. Run this anytime mid-cycle — after a milestone, before moving on.
waypoint_measure — Compares what you built against the original goal. Did you hit it? Where did you fall short?
waypoint_improve — Identifies what to make better — performance, reliability, experience — based on what's actually in the project.
waypoint_document — Writes documentation for the people who'll use or maintain this. Pulls from existing artifacts so it stays accurate.
waypoint_review — Pre-ship final checklist. Reads all .waypoint/*.md artifacts and produces a go/no-go summary — surfaces anything flagged but not addressed, missing artifacts, and open questions. Run this last, when you think you're ready to ship.
Define: waypoint_goal → waypoint_research → waypoint_compare
Plan: waypoint_plan → waypoint_design
Build: waypoint_build → waypoint_test → waypoint_fix → waypoint_debug → waypoint_audit
Ship: waypoint_measure → waypoint_improve → waypoint_document → waypoint_review
Tools are independent — call any one at any time. The order above is the natural progression, not a requirement.
Each tool writes a markdown file to .waypoint/ in your workspace:
your-project/
└── .waypoint/
├── goal.md
├── research.md
├── compare.md
├── plan.md
├── design.md
├── build.md
├── test.md
├── fix.md
├── debug.md
├── audit.md
├── measure.md
├── improve.md
├── docs.md
├── review.md
└── previous.md ← written when a new goal replaces an existing one
Artifacts are plain markdown — edit them directly. Later tools read earlier ones to stay in context. Commit .waypoint/ to version control to preserve the record.
When you start a new design cycle with waypoint_goal, it will ask for confirmation before archiving the existing cycle (confirmArchive: true). Once confirmed, the previous goal and artifact list are saved to previous.md. One file, always current — not an accumulating archive.
session-continuity — Waypoint tracks where you are in the build process. session-continuity tracks where you left off in the conversation. Together, Claude has full context — no re-explaining ever.
claude mcp add session-continuity npx session-continuity@waycraft/mcp-manager — if waypoint drops mid-cycle, mcp-manager restarts it without leaving the conversation.
claude mcp add mcp-manager npx @waycraft/mcp-managerIf something didn't click, felt missing, or you found a better way to use it — I'd love to hear it.
PolyForm Noncommercial License 1.0 — free for personal and non-commercial use.