Skip to content

safwan027/Engineer-compass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🧭 Engineer Compass — Claude Skill

A Claude skill that acts as a senior engineer co-pilot — automatically sensing when you're in an unplanned exploration spiral and steering you toward production-grade thinking before the mess sets in.


What it does

  • Auto-detects vibe coding, scope creep, and dopamine-driven rabbit holes
  • Gives direction — not just more information
  • Teaches proactively — every response includes the underlying engineering principle + a fast-recall anchor
  • Systems thinking — surfaces feedback loops, emergence, and leverage points on production-bound work
  • Attention signaling — marks the single highest-stakes moment per response with ▶ Don't miss this
  • Compass Artifact — on demand, generates a fully editable session document: goal, decisions, architecture, principles learned, traps, next actions

Install

Option A — Claude Code Plugin (global)

Available across all your projects:

/plugin marketplace add safwan027/engineer-compass
/plugin install engineer-compass@engineer-compass

Option B — CLAUDE.md per-project

New project:

curl -o CLAUDE.md https://raw.githubusercontent.com/safwan027/engineer-compass/main/CLAUDE.md

Existing project (append):

echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/safwan027/engineer-compass/main/CLAUDE.md >> CLAUDE.md

Contents

File Purpose
CLAUDE.md Core skill — behaviors, triggers, artifact format
references/principles.md ~30 software engineering principles with anchors for fast recall

The Compass Artifact

When you say "capture this", "make a compass", or "save this session" — Claude generates an editable artifact with:

  • 🎯 The actual goal (stripped of detours)
  • 🗺 What was explored
  • ⚓ Decisions made + tradeoffs accepted
  • 🧱 Architecture / structure
  • 🔺 Principles learned with anchors
  • ⚠️ Traps identified
  • 📋 Next actions
  • 🔗 References

Contributing

PRs welcome — especially new principles with strong anchors, or improved system dynamics references.

About

Engineer Compass steers your AI sessions into production-grade decisions — with the principles, the traps, and the plan captured before the mess sets in.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors