I got tired of repeating engineering rules to AI on every project. So I built GEF.

Gnzikoune — Tue, 21 Jul 2026 02:23:41 +0000

For several months, I noticed the same problem with Cursor, Windsurf, and other AI assistants.

They're excellent…

but they quickly forget project rules.

At first:

clean architecture
conventional commits
documentation
tests

Then, after a few hours of development:

200-line functions
direct push to main
no ADR
forgotten documentation
ignored OWASP rules

End up, you end up repeating the same instructions:

"Use GitHub Flow"

"Don't forget the tests"

"Respect the complexity limits"

"Document this decision"

Again.

And again.

So I decided to reverse the problem.

Instead of reminding the AI of the rules…

...why not integrate them directly into the project?

This is exactly what Guardian Engineering Framework (GEF) does.

The idea

GEF is a project generator.

But unlike a simple scaffold, it also installs:

Engineering Playbook
AI prompts
Git Hooks
CI/CD
Cursor/Windsurf rules
ADR
Diátaxis documentation

right from project creation.

npx create-gef

A few minutes later, the project already has technical governance.

What is generated

GEF automatically configures:

GitHub Flow
Conventional Commits
Pull Request template
CI GitHub Actions
Docker
documentation
ADR
lint
security
AI prompts

The goal is for the project to enforce best practices, even when multiple developers or multiple AIs are involved.

An AI that acts as a Tech Lead

This is the point I find most interesting.

The framework pushes the AI to:

create ADRs
open Pull Requests
respect issues
run tests
follow a reproducible workflow

The AI is no longer just a code generator.

It follows a process.

Why it's open source

I wanted something usable with:

Cursor
Windsurf
GitHub Copilot
Claude Code

without depending on a specific IDE.

All the rules reside within the project.

Repository

GitHub:

https://github.com/Gnzikoune/GEF

NPM:

https://www.npmjs.com/package/create-gef

Feedback is welcome.

Need help!

Gnzikoune — Wed, 25 Oct 2023 14:07:36 +0000

Hello there, I have a problem with cypress. Currently I am testing an application that we are developing, it is called Business Plan. I'm carrying out tests on the financial part of our application and I'm having difficulty. My test must be carried out on the forecast financing budget at start-up. I have several fields in terms of needs such as: Total Business Creation Formalities, Total Computer Equipment, Total Furniture to name just a few. These fields must then be filled in with the amount that each requirement costs. In addition I would like to retrieve the values that the users will enter and check that the sum of these is equal to the total amount of requirements. How do I go about it since I've been running out for two days already?

DEV Community: Gnzikoune

I got tired of repeating engineering rules to AI on every project. So I built GEF.

Need help!