Understand. Design. Build. Verify.
Why · Install · Start here · Guides
A small set of skills for coding agents. Use it when you do not know what to do next.
Agents need a clear outcome, the constraints that matter, and proof that the work is done. Engineering Compass turns that into nine focused skills.
npx skills add MHammad33/hammad-engineeringSetup and troubleshooting: docs/install.md
| You need to… | Open |
|---|---|
| Challenge a new idea | New idea |
| Start a new project | New project |
| See what clarity you have at each stage | From scratch |
| Add a new feature | New feature |
| Fix something broken | Debugging |
| Clean up working code | Improve |
Each guide is a step-by-step workflow. Skills are the tools inside those steps.
Skill name lookup: docs/choosing-a-skill.md
| Group | Skills |
|---|---|
| Learn | understand |
| Decide | idea · design · plan |
| Deliver | build |
| Check | test · review · debug · improve |
Instructions live in skills/. Agent policy lives in AGENTS.md.
| Guide | Open when |
|---|---|
| New idea | Rough own-product idea, not validated yet |
| New project | Idea validated, ready for PROJECT.md and repo |
| From scratch | You want clarity on how the process works stage by stage |
| New feature | Meaningful change in an existing project |
| Debugging | Something is broken |
| Improve | Code works but is hard to maintain |
| Choosing a skill | You need a skill name or handoff |
| Workflows | Short worked examples |
| Workflows — own product walkthrough | Full example from vague idea to v1 |
| Install | Skills missing or outdated |
New repos copy templates/PROJECT.md then templates/project-AGENTS.md.
Engineering Compass is a workflow, not an issue tracker, agent runtime, or stack cookbook. It is tool-neutral. Keep project facts in each project's PROJECT.md and AGENTS.md.