Contents of the docs
ai-instructions · Docs
Overview
Collection of rules and templates for AI agents – code guidelines, IntelliJ code style, design styleguides, website building blocks and skills.
On this page
ai-instructions collects the instructions I give AI agents like Claude when they work on my projects: what code
should look like, how a new website is designed and built, and how projects store their documentation for my website.
Everything is Markdown, so people can read it and agents can use it directly.
Contents
| Folder or file | Contents | Docs |
|---|---|---|
CodeGuidlines.md |
Rules for TypeScript, Node projects, services, SDKs and translations | Code guidelines |
intellij-code-styles.xml |
Code style scheme "Marco" for IntelliJ and WebStorm | IntelliJ code style |
styleguides/ |
20 design styleguides for websites, from calm to playful | Styleguides |
website-marco-starker.de/ |
Docs contract, project data and release flow for project documentation | Website building blocks |
skills/ |
Claude skills that combine these rules into a workflow | Skills |
How to use the collection
Clone the repository to a fixed location and reference it in your projects, e.g. in a CLAUDE.md or AGENTS.md:
git clone https://github.com/DasRed/ai-instructions.git .## Coding rules
Follow ./CodeGuidlines.md. Formatting follows ./intellij-code-styles.xml.The agent then reads the files itself when it needs them. Hand it a styleguide specifically when a page is being designed.
Note
The documents are written in German and tailored to my projects: paths like ., my servers and my npm scope
@dasred appear in them. For your own projects, use them as a template and adjust those parts.
Status
Actively maintained since November 2026. The rules evolve with my projects; the state on main is always the one that
counts.