Eigene Regeln, Skills und Rollen

Das Projekt überschreibt immer das Template. Du bearbeitest nie etwas unter .act/; ein Wächter (template-write-guard) verweigert dort Schreibzugriffe. Alles, was dir gehört, kommt nach docs/ai/ und docs/project/ und übersteht jedes Update.

Regeln in docs/ai/rules.md

docs/ai/rules.md listet die Regeldateien auf, die der Assistent lädt, jeder Import gefolgt von seinen Regeln als Kontrollkästchen:

@../../.act/rules/shared/20-code.md
  - [x] `R-code-language`
  - [ ] `R-code-encoding`

• Eine Regel abschalten: Entferne ihr Kreuz. Die Datei wird weiterhin ganz geladen, aber eine nicht angekreuzte Regel gilt als aus.
• Einen ganzen Bereich abschalten: Lösche seine @-Importzeile.
• Den Wortlaut einer Regel ersetzen: Füge unter ## Overrides einen Listenpunkt der Form - replaces `R-...`: <your version> hinzu, der die Regel und deine Fassung nennt (Zeilen, die mit <!-- beginnen, werden übersprungen). Eine replaces-Zeile gewinnt gegenüber dem Text des Templates, egal ob die Regel angekreuzt ist oder nicht.
• Eigene Regeln hinzufügen: Lege unter ## Own rules einen Punkt pro Regel an, die im Template keine Entsprechung hat. Eine eingerückte Liste direkt unter einer eigenen Regel (oder einer replaces-Zeile) gehört zu ihr und wird als Teil ihres Textes gelesen.

Lass die Marken (<!-- act:overrides -->, <!-- act:own-rules -->) stehen, wo sie sind; die Mechanik findet die Abschnitte über sie. python .act/scripts/rules.py --imports zeigt, was tatsächlich geladen wird. Coding-Regelsätze funktionieren genauso in docs/project/coding_rules.md. Die Regel-IDs stehen in der Regelreferenz und der Coding-Regelreferenz.

Eine Datei überschreiben: docs/ai/local/

docs/ai/local/ spiegelt .act/: Eine Datei mit demselben relativen Pfad gewinnt gegenüber der Fassung des Templates. docs/ai/local/<path> wird vor .act/<path> gesucht. Um eine Skill-Datei des Templates zu ändern, kopiere sie nach docs/ai/local/skills/<name>/<file> und bearbeite die Kopie; die Projektkopie wird dann aus deinem Override erzeugt. Der Ordner gehört dir, und der Assistent schreibt dort nur, wenn du es ihm sagst.

Der Ordner enthält auch optionale eigene Dateien, zum Beispiel reminders.md (eine Zeile „erinnere mich” pro Zeile, mit optionalem Takt) und security-accepted.md (siehe Sicherheitsprüfung).

Eigene Skills

Ein Skill ist ein Verzeichnis mit einer SKILL.md, die mit YAML-Frontmatter (name, description) beginnt und werkzeugneutrale Anweisungen enthält. Lege deinen eigenen unter docs/ai/local/skills/<name>/SKILL.md ab; ein von Hand platzierter Skill bekommt nicht automatisch Werkzeugkopien: Kopien (.claude/skills/<name>/, und .agents/skills/<name>/ nur, wenn codex, copilot, gemini oder cursor eingerichtet ist) entstehen über act-load-settings oder die Übernahme. Der Skill ist in der Zwischenzeit über /act <name> erreichbar. Ein Skill-Name, den das Template schon mitliefert, ist ein Override dieses Skills, kein neuer. Die mitgelieferten Skills stehen in der Skill-Referenz.

Eigene Rollen

Eine eigene Rolle ist eine Datei docs/ai/local/agents/<name>.md mit ihren Regeln. Eine neue Rolle ist ihre eigene Brückenquelle und braucht Frontmatter (name, description, Tier/Reasoning, tools); nur ein Override einer Rolle des Templates ist reiner Text ohne Frontmatter. Tier und Reasoning (bei einem Skill: reasoning im Frontmatter, überschreibbar durch eine Zeile mit dem Namen des Skills) lassen sich auch in der Tabelle Roles von docs/ai/config.md setzen (siehe Tiers und Reasoning); die werkzeugspezifische Datei unter .claude/agents/ wird von init und update erzeugt, nicht bei jedem Sitzungsstart. Sobald eine solche Datei existiert, gehört ihr Text dir: Updates frischen nur ihre Zeilen model und effort auf. Die eingebauten Rollen sind unter Rollen beschrieben.

In ein anderes Projekt mitnehmen

Zwei Skills tragen deine Abweichungen vom Template in ein anderes Projekt.

act-export-settings schreibt, was du gegenüber dem Template geändert hast, in eine settings.md: deine eigenen Regeln, abgeschaltete Regeln und Gruppen, replaces-Overrides. Nichts über das Projekt selbst (Name, Arbeitsstand) kommt hinein. Optionen:

• --all listet auch die unveränderten Regeln auf.
• --with-scripts, --with-checklists, --with-agents, --with-skills fügen die Dateien aus docs/ai/local/ hinzu; jede davon erzeugt statt einer .md eine .zip.
• --with-topics fügt die Topic-Regeln unter docs/ai/local/rules/topics/ hinzu: ein eigenes Topic als [+] <name>.md, ein Override eines Topics des Templates als [~] <name>.md mit einem Fingerabdruck des überschriebenen Topics. Ganze Dateien, es erzeugt also ebenfalls eine .zip.
• --strict bricht ab, statt einen Platzhalter einzusetzen; nutze es, wenn die Datei deine Hände verlässt.
• --out PATH wählt den Ort; Standard ist .act-local/export/. --profile schreibt stattdessen in dein persönliches Profil.

Das Script durchsucht jeden Wert nach Zugangsdaten, Mailadressen, IP-Adressen, lokalen Pfaden und internen Hosts und ersetzt einen Treffer durch einen sichtbaren Platzhalter <setup:KIND>. Es meldet die Zahl der Funde; überfliege die Datei, bevor du sie irgendwohin schickst.

act-load-settings importiert eine solche Datei. python .act/scripts/settings_load.py plan zeigt, was passieren würde, und schreibt nichts; ohne genannte Datei nimmt es alles in .act-local/import/. apply schreibt dann, was eindeutig ist. Überschneidungen mit deinen eigenen Regeln werden beurteilt, nicht stillschweigend angewendet, und alles Ungeklärte landet in einem Inbox-Eintrag. Mitgelieferte Scripts, Skills und Rollen werden dir gezeigt, bevor sie geschrieben werden, und ein Skill oder eine Rolle, die denselben Namen wie einer des Templates trägt oder riskantes Frontmatter verlangt (Hooks, MCP-Server, Berechtigungsmodi), wird gemeldet und nie geschrieben. Eigene Topic-Regeln und Topic-Overrides gehen nach docs/ai/local/rules/topics/<name>.md: ein Topic, das dort mit anderem Inhalt schon liegt, wird als geändert gemeldet und nicht angetastet; ein Override, dessen Topic im Template nicht mehr existiert, wird als tot gemeldet und nicht geschrieben; einer, dessen Topic sich seit dem Export geändert hat, wird als „seit dem Export geändert“ gemeldet und von Hand geprüft.