doppelt.digital Application Platform Documentation
English Deutsch

Working on your project

Telling the AI how to work

AGENTS.md and editor rules: how to give all AI tools in your project your own working instructions.

On this page

All AI tools in your project – Cursor, Claude Code, Codex, Antigravity – read the same instruction files. They live centrally in the local-configuration repository and apply to the whole project via symlinks. Change them there and the AI works by the same rules for everyone on the team.

The instruction files

File Applies to
AGENTS.md All AI tools – the central place for your rules
.cursor/rules/*.mdc Cursor only (in addition to AGENTS.md)
CLAUDE.md Claude Code only (points to AGENTS.md by default)

What is preconfigured

The generated AGENTS.md contains the platform ground rules:

  • Always start applications via ap run-local.
  • Don’t change .gitlab-ci.yml files or env/*.generated.env – your own values belong in env/*.custom.env.
  • Never write secrets into documentation, logs, commits, or chat answers.
  • Work in the appropriate app repository, not in the local-configuration repo.

Adding your own rules

Open local-configuration/AGENTS.md and add your way of working as a section. A proven example – the AI should commit and push on its own:

## Git workflow

- Create a commit after every completed task and push it.
- Use conventional commits (feat, fix, chore, docs, refactor, test).
- Work on feature branches and never commit directly to main.

Commit and push the change in the local-configuration repository – on the next clone/update it applies to the whole team.

Warning
By default the AI tools do not commit and push automatically – you enable this deliberately with such a rule. Stay in control: rules like “feature branches only” prevent accidental changes to main.

Useful helpers

  • ap git auto-commit – stages, commits, and pushes in one step; handy as a command you hand to the AI in a rule.
  • Pre-commit hook – the setup app installs ap git pre-commit check as a hook; it blocks commits to protected files (e.g. generated configuration), even if the AI changes them accidentally.

See also