create-theokit 2.0.0-next.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -12,6 +12,24 @@ layer (priority 60) — nothing else overrides it. That is what decides what bel
|
|
|
12
12
|
tone instruction in this file quietly makes `usePersonality` do nothing. Tone belongs in
|
|
13
13
|
`.theokit/personalities/`; instructions about specific files belong in `.theokit/rules/`.
|
|
14
14
|
|
|
15
|
+
## Why this file is here and not at the root
|
|
16
|
+
|
|
17
|
+
On the SDK this project installs (`^4.52.1`, which resolves to a 4.x), `.theokit/THEO.md` is the
|
|
18
|
+
**only** path a `THEO.md` is read from — a copy at the project root is read by nothing, silently.
|
|
19
|
+
|
|
20
|
+
`@theokit/sdk@5` adds a root `THEO.md` (`usetheokit/theokit-sdk#531`) at priority 55, so on that
|
|
21
|
+
version both locations work and `.theokit/THEO.md` still wins a conflict. 5.x is currently published
|
|
22
|
+
on the `next` channel only, so moving this file to the root would break it for anyone on the default
|
|
23
|
+
install — which is why the scaffold keeps it here.
|
|
24
|
+
|
|
25
|
+
Two more things worth knowing if you do move it once 5.x is stable:
|
|
26
|
+
|
|
27
|
+
- The root spec sets `followImports: true`, this one does not. `@file` references resolve there and
|
|
28
|
+
not here.
|
|
29
|
+
- Keep the pair. `AGENTS.md` is read by Cursor, Copilot and Claude Code as well as by TheoKit, and
|
|
30
|
+
it addresses a different audience — agents that write your code, rather than the agent that talks
|
|
31
|
+
to your users. That distinction survives whichever location this file ends up in.
|
|
32
|
+
|
|
15
33
|
Keep it short — every line costs tokens on every turn.
|
|
16
34
|
|
|
17
35
|
## What this app is
|