e89401e62b
Opus Markdown + Sonnet Markdown audit found that the 12 root kei-*.md files
each carried a "GENERATED by _assembler from _manifests/kei-<slug>.toml — DO
NOT EDIT" header pointing to manifests that DO NOT EXIST. The actual manifests
live at _manifests/<slug>.toml (no kei- prefix) and regenerate to
_generated/<slug>.md. Content had drifted (kei-architect.md had a "MODE — First
Principles" section absent from _generated/architect.md).
This was active confusion for any editor: the "DO NOT EDIT" header lied (no
manifest existed for regen), and editing the manifest at the implied path was
impossible.
Replaced each root kei-<slug>.md with a 14-LOC alias stub that:
- Tells readers the actual generated file lives at _generated/<slug>.md
- Tells readers the manifest source is _manifests/<slug>.toml (no kei- prefix)
- States explicitly: edit the manifest, never these aliases
- Preserves the root-level discoverability marker
Also fixes Group G's commit ddd13e6 follow-on damage: that commit appended
STATUS-TRUTH MARKER blocks to 5 of these root kei-*.md files thinking they
were generated outputs of real manifests. Those edits are now superseded by
the alias-stub form.
Net delta: +108 / -3787 (12 files shrink from full agent prompts to 14-LOC
stubs). Real prompts remain in _generated/ where they were generated from
the actual _manifests/<slug>.toml files.
Follow-up: add CI lint that root kei-*.md must match alias template byte-for-
byte. Prevents future drift back to the parallel-SSoT state.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
15 lines
673 B
Markdown
15 lines
673 B
Markdown
<!-- ALIAS DOC — actual content lives in _generated/researcher.md (GENERATED from _manifests/researcher.toml).
|
|
This file exists only as a top-level discovery marker. To edit the agent prompt,
|
|
edit _manifests/researcher.toml and re-run `_assembler`. Do not edit this file. -->
|
|
|
|
# kei-researcher
|
|
|
|
This is an alias for the **researcher** agent. The real agent prompt is at:
|
|
|
|
`_generated/researcher.md`
|
|
|
|
Manifest source:
|
|
|
|
`_manifests/researcher.toml`
|
|
|
|
Why two files: the `_generated/` form is what `_assembler` writes; the root `kei-researcher.md` form is a discoverability shortcut at repo root. Both reflect the same manifest. Edit the manifest, never these.
|