Apothem vs raw Trae config
Hand-maintaining Trae's rules under .trae/rules/ versus rendering them from Apothem's shared profile.
Trae reads rules from a .trae/rules/ directory whose vendor anchors are
project_rules.md and user_rules.md. Apothem's trae adapter renders a
dedicated apothem-rules.md file in that directory from the shared profile.
This page contrasts hand-maintaining that config against managing it with
Apothem.
Effort comparison
| Task | Raw hand-config | Apothem-managed |
|---|---|---|
| Author rules | Hand-write each file under .trae/rules/ | Rendered from the shared corpus |
| Keep the Apothem surface separate | Remember not to overload project_rules.md | The adapter writes a dedicated apothem-rules.md |
| Keep rules aligned with other harnesses | Manual, per tool | Automatic on apothem update |
| Verify the config is correct | Manual inspection | apothem verify --harness trae |
What Apothem manages
The trae adapter renders the shared rules into a dedicated apothem-rules.md
file under .trae/rules/ and leaves the operator-owned project_rules.md and
user_rules.md anchors untouched. Trae has no PreToolUse hook, so guardrail
intent lives in the rule prose rather than a tool-call interception point.
Every change to the shared rules re-renders the file on the next
apothem update.
Migration path
- Run
apothem profile initto create the shared profile if you have not yet. - Move the rules from your existing
.trae/rules/files into the shared corpus. - Run
apothem install --harness traeto render theapothem-rules.mdfile. - Run
apothem verify --harness traeto confirm the config landed. - Use
apothem update --harness traefor every later change.