GAAI is not a library you contribute skills or features to. It is a design pattern expressed in files — a starting point you fork, clone, and adapt to your own project.
The right way to use GAAI:
- Fork or clone this repo
- Copy
.gaai/into your project with.gaai/core/scripts/install.sh - Adapt the rules, memory, and skills to your project's needs
- The fork is yours — you own it
New skills, agents, or rules belong in your fork — not upstream. That's by design.
Bug reports and documentation fixes are welcome.
Found something wrong in the framework files — a broken script, an incorrect reference, a malformed YAML template? Open an issue using the bug report template.
Typos, unclear wording, broken links in docs/ or .gaai/**/*.md? Open a PR with your fix. Keep it minimal.
If you're fixing bugs or improving docs, keep these constraints in mind:
- Never break
.gaai/integrity. The health check (core/scripts/health-check.sh) must always pass. - Never rename skill directories. Skill directory names are referenced in agent files.
- Never rename rule files. Rule filenames are referenced in agents and compat adapters.
- Keep compat adapters thin. Files in
core/compat/must reference canonical files — never duplicate content.
All code in this repository, including AI-assisted contributions, is the intellectual property of Frédéric Geens and licensed under ELv2. AI tools (such as Claude Code) are used as development tools — they do not hold authorship or rights over any part of this project.
Have thoughts about the framework's design? Open a feedback issue. We read everything.